@mastra/code-sdk 1.7.3-alpha.0 → 1.8.0-alpha.11

package/dist/agent-connections/ownership.d.ts

@@ -4,6 +4,7 @@ export interface ThreadOwnershipClaim {
 }
 export declare function createThreadOwnershipManager(claimThread: (threadId: string) => Promise<ThreadOwnershipClaim>): {
     claim(threadId?: string | null): Promise<boolean>;
+    release(threadId: string): void;
     close(): void;
 };
 //# sourceMappingURL=ownership.d.ts.map

package/dist/agent-connections/ownership.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ownership.d.ts","sourceRoot":"","sources":["../../src/agent-connections/ownership.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,IAAI,IAAI,CAAC;CACrB;AAKD,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,GAAG;IAC9G,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,KAAK,IAAI,IAAI,CAAC;CACf,CA4DA"}
+{"version":3,"file":"ownership.d.ts","sourceRoot":"","sources":["../../src/agent-connections/ownership.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,IAAI,IAAI,CAAC;CACrB;AAkBD,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,GAAG;IAC9G,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,IAAI,IAAI,CAAC;CACf,CA0FA"}

package/dist/agent-connections/ownership.js

@@ -2,28 +2,29 @@
 const OWNERSHIP_RETRY_INITIAL_DELAY_MS = 250;
 const OWNERSHIP_RETRY_MAX_DELAY_MS = 5e3;
 function createThreadOwnershipManager(claimThread) {
-	let generation = 0;
-	let currentClaim;
-	let retryTimer;
-	let retryDelayMs = OWNERSHIP_RETRY_INITIAL_DELAY_MS;
-	const clearRetry = () => {
-		if (retryTimer) clearTimeout(retryTimer);
-		retryTimer = void 0;
+	const states = /* @__PURE__ */ new Map();
+	let nextGeneration = 0;
+	let closed = false;
+	const clearRetry = (state) => {
+		if (state.retryTimer) clearTimeout(state.retryTimer);
+		state.retryTimer = void 0;
 	};
 	const scheduleRetry = (threadId, claimGeneration) => {
-		if (claimGeneration !== generation || retryTimer) return;
-		const delayMs = retryDelayMs;
-		retryDelayMs = Math.min(retryDelayMs * 2, OWNERSHIP_RETRY_MAX_DELAY_MS);
-		retryTimer = setTimeout(() => {
-			retryTimer = void 0;
+		const state = states.get(threadId);
+		if (closed || !state || state.generation !== claimGeneration || state.retryTimer) return;
+		const delayMs = state.retryDelayMs;
+		state.retryDelayMs = Math.min(state.retryDelayMs * 2, OWNERSHIP_RETRY_MAX_DELAY_MS);
+		state.retryTimer = setTimeout(() => {
+			state.retryTimer = void 0;
 			attemptClaim(threadId, claimGeneration, false);
 		}, delayMs);
-		retryTimer.unref?.();
+		state.retryTimer.unref?.();
 	};
 	const attemptClaim = async (threadId, claimGeneration, propagateError) => {
 		try {
 			const nextClaim = await claimThread(threadId);
-			if (claimGeneration !== generation) {
+			const state = states.get(threadId);
+			if (closed || !state || state.generation !== claimGeneration) {
 				nextClaim.unsubscribe();
 				return false;
 			}
@@ -31,8 +32,8 @@ function createThreadOwnershipManager(claimThread) {
 				scheduleRetry(threadId, claimGeneration);
 				return false;
 			}
-			retryDelayMs = OWNERSHIP_RETRY_INITIAL_DELAY_MS;
-			currentClaim = nextClaim;
+			state.retryDelayMs = OWNERSHIP_RETRY_INITIAL_DELAY_MS;
+			state.claim = nextClaim;
 			return true;
 		} catch (error) {
 			scheduleRetry(threadId, claimGeneration);
@@ -42,19 +43,34 @@ function createThreadOwnershipManager(claimThread) {
 	};
 	return {
 		async claim(threadId) {
-			const claimGeneration = ++generation;
-			clearRetry();
-			retryDelayMs = OWNERSHIP_RETRY_INITIAL_DELAY_MS;
-			currentClaim?.unsubscribe();
-			currentClaim = void 0;
+			if (closed) return false;
 			if (!threadId) return false;
-			return attemptClaim(threadId, claimGeneration, true);
+			const existing = states.get(threadId);
+			if (existing) {
+				clearRetry(existing);
+				existing.claim?.unsubscribe();
+			}
+			const state = {
+				generation: ++nextGeneration,
+				retryDelayMs: OWNERSHIP_RETRY_INITIAL_DELAY_MS
+			};
+			states.set(threadId, state);
+			return attemptClaim(threadId, state.generation, true);
+		},
+		release(threadId) {
+			const state = states.get(threadId);
+			if (!state) return;
+			clearRetry(state);
+			state.claim?.unsubscribe();
+			states.delete(threadId);
 		},
 		close() {
-			generation++;
-			clearRetry();
-			currentClaim?.unsubscribe();
-			currentClaim = void 0;
+			closed = true;
+			for (const state of states.values()) {
+				clearRetry(state);
+				state.claim?.unsubscribe();
+			}
+			states.clear();
 		}
 	};
 }

package/dist/agent-connections/ownership.js.map

@@ -1 +1 @@
-{"version":3,"file":"ownership.js","names":[],"sources":["../../src/agent-connections/ownership.ts"],"sourcesContent":["export interface ThreadOwnershipClaim {\n  claimed: boolean;\n  unsubscribe(): void;\n}\n\nconst OWNERSHIP_RETRY_INITIAL_DELAY_MS = 250;\nconst OWNERSHIP_RETRY_MAX_DELAY_MS = 5_000;\n\nexport function createThreadOwnershipManager(claimThread: (threadId: string) => Promise<ThreadOwnershipClaim>): {\n  claim(threadId?: string | null): Promise<boolean>;\n  close(): void;\n} {\n  let generation = 0;\n  let currentClaim: ThreadOwnershipClaim | undefined;\n  let retryTimer: ReturnType<typeof setTimeout> | undefined;\n  let retryDelayMs = OWNERSHIP_RETRY_INITIAL_DELAY_MS;\n\n  const clearRetry = () => {\n    if (retryTimer) clearTimeout(retryTimer);\n    retryTimer = undefined;\n  };\n\n  const scheduleRetry = (threadId: string, claimGeneration: number) => {\n    if (claimGeneration !== generation || retryTimer) return;\n    const delayMs = retryDelayMs;\n    retryDelayMs = Math.min(retryDelayMs * 2, OWNERSHIP_RETRY_MAX_DELAY_MS);\n    retryTimer = setTimeout(() => {\n      retryTimer = undefined;\n      void attemptClaim(threadId, claimGeneration, false);\n    }, delayMs);\n    retryTimer.unref?.();\n  };\n\n  const attemptClaim = async (threadId: string, claimGeneration: number, propagateError: boolean): Promise<boolean> => {\n    try {\n      const nextClaim = await claimThread(threadId);\n      if (claimGeneration !== generation) {\n        nextClaim.unsubscribe();\n        return false;\n      }\n      if (!nextClaim.claimed) {\n        scheduleRetry(threadId, claimGeneration);\n        return false;\n      }\n      retryDelayMs = OWNERSHIP_RETRY_INITIAL_DELAY_MS;\n      currentClaim = nextClaim;\n      return true;\n    } catch (error) {\n      scheduleRetry(threadId, claimGeneration);\n      if (propagateError) throw error;\n      return false;\n    }\n  };\n\n  return {\n    async claim(threadId) {\n      const claimGeneration = ++generation;\n      clearRetry();\n      retryDelayMs = OWNERSHIP_RETRY_INITIAL_DELAY_MS;\n      currentClaim?.unsubscribe();\n      currentClaim = undefined;\n      if (!threadId) return false;\n      return attemptClaim(threadId, claimGeneration, true);\n    },\n    close() {\n      generation++;\n      clearRetry();\n      currentClaim?.unsubscribe();\n      currentClaim = undefined;\n    },\n  };\n}\n"],"mappings":";AAKA,MAAM,mCAAmC;AACzC,MAAM,+BAA+B;AAErC,SAAgB,6BAA6B,aAG3C;CACA,IAAI,aAAa;CACjB,IAAI;CACJ,IAAI;CACJ,IAAI,eAAe;CAEnB,MAAM,mBAAmB;EACvB,IAAI,YAAY,aAAa,UAAU;EACvC,aAAa,KAAA;CACf;CAEA,MAAM,iBAAiB,UAAkB,oBAA4B;EACnE,IAAI,oBAAoB,cAAc,YAAY;EAClD,MAAM,UAAU;EAChB,eAAe,KAAK,IAAI,eAAe,GAAG,4BAA4B;EACtE,aAAa,iBAAiB;GAC5B,aAAa,KAAA;GACb,aAAkB,UAAU,iBAAiB,KAAK;EACpD,GAAG,OAAO;EACV,WAAW,QAAQ;CACrB;CAEA,MAAM,eAAe,OAAO,UAAkB,iBAAyB,mBAA8C;EACnH,IAAI;GACF,MAAM,YAAY,MAAM,YAAY,QAAQ;GAC5C,IAAI,oBAAoB,YAAY;IAClC,UAAU,YAAY;IACtB,OAAO;GACT;GACA,IAAI,CAAC,UAAU,SAAS;IACtB,cAAc,UAAU,eAAe;IACvC,OAAO;GACT;GACA,eAAe;GACf,eAAe;GACf,OAAO;EACT,SAAS,OAAO;GACd,cAAc,UAAU,eAAe;GACvC,IAAI,gBAAgB,MAAM;GAC1B,OAAO;EACT;CACF;CAEA,OAAO;EACL,MAAM,MAAM,UAAU;GACpB,MAAM,kBAAkB,EAAE;GAC1B,WAAW;GACX,eAAe;GACf,cAAc,YAAY;GAC1B,eAAe,KAAA;GACf,IAAI,CAAC,UAAU,OAAO;GACtB,OAAO,aAAa,UAAU,iBAAiB,IAAI;EACrD;EACA,QAAQ;GACN;GACA,WAAW;GACX,cAAc,YAAY;GAC1B,eAAe,KAAA;EACjB;CACF;AACF"}
+{"version":3,"file":"ownership.js","names":[],"sources":["../../src/agent-connections/ownership.ts"],"sourcesContent":["export interface ThreadOwnershipClaim {\n  claimed: boolean;\n  unsubscribe(): void;\n}\n\nconst OWNERSHIP_RETRY_INITIAL_DELAY_MS = 250;\nconst OWNERSHIP_RETRY_MAX_DELAY_MS = 5_000;\n\n/**\n * Per-thread claim bookkeeping. One entry per thread this session has bound, so\n * a thread the user has navigated away from stays claimed — and therefore stays\n * addressable by peers — until the session itself is torn down.\n */\ntype ThreadClaimState = {\n  /** Bumped on every new attempt for this thread; late resolutions are dropped. */\n  generation: number;\n  claim?: ThreadOwnershipClaim;\n  retryTimer?: ReturnType<typeof setTimeout>;\n  retryDelayMs: number;\n};\n\nexport function createThreadOwnershipManager(claimThread: (threadId: string) => Promise<ThreadOwnershipClaim>): {\n  claim(threadId?: string | null): Promise<boolean>;\n  release(threadId: string): void;\n  close(): void;\n} {\n  const states = new Map<string, ThreadClaimState>();\n  // Manager-scoped so the counter keeps climbing across `release`/re-claim of the\n  // same thread id: a per-thread counter restarts at 1 after a release, letting a\n  // pre-release attempt match the new state and be retained.\n  let nextGeneration = 0;\n  let closed = false;\n\n  const clearRetry = (state: ThreadClaimState) => {\n    if (state.retryTimer) clearTimeout(state.retryTimer);\n    state.retryTimer = undefined;\n  };\n\n  const scheduleRetry = (threadId: string, claimGeneration: number) => {\n    const state = states.get(threadId);\n    if (closed || !state || state.generation !== claimGeneration || state.retryTimer) return;\n    const delayMs = state.retryDelayMs;\n    state.retryDelayMs = Math.min(state.retryDelayMs * 2, OWNERSHIP_RETRY_MAX_DELAY_MS);\n    state.retryTimer = setTimeout(() => {\n      state.retryTimer = undefined;\n      void attemptClaim(threadId, claimGeneration, false);\n    }, delayMs);\n    state.retryTimer.unref?.();\n  };\n\n  const attemptClaim = async (threadId: string, claimGeneration: number, propagateError: boolean): Promise<boolean> => {\n    try {\n      const nextClaim = await claimThread(threadId);\n      const state = states.get(threadId);\n      // The session closed, or a newer attempt superseded this one while the\n      // ownership request was in flight — the late claim must not be retained.\n      if (closed || !state || state.generation !== claimGeneration) {\n        nextClaim.unsubscribe();\n        return false;\n      }\n      if (!nextClaim.claimed) {\n        scheduleRetry(threadId, claimGeneration);\n        return false;\n      }\n      state.retryDelayMs = OWNERSHIP_RETRY_INITIAL_DELAY_MS;\n      state.claim = nextClaim;\n      return true;\n    } catch (error) {\n      scheduleRetry(threadId, claimGeneration);\n      if (propagateError) throw error;\n      return false;\n    }\n  };\n\n  return {\n    async claim(threadId) {\n      if (closed) return false;\n      // A thread-less transition has no claim to make. Threads already claimed\n      // stay claimed: being handed no thread is not a reason to drop them.\n      if (!threadId) return false;\n\n      // Re-claiming the thread supersedes only that thread's previous attempt —\n      // the core claim is re-published so title/metadata changes made while the\n      // session was away are picked up. Other threads' claims are untouched.\n      const existing = states.get(threadId);\n      if (existing) {\n        clearRetry(existing);\n        existing.claim?.unsubscribe();\n      }\n      const state: ThreadClaimState = {\n        generation: ++nextGeneration,\n        retryDelayMs: OWNERSHIP_RETRY_INITIAL_DELAY_MS,\n      };\n      states.set(threadId, state);\n      return attemptClaim(threadId, state.generation, true);\n    },\n    release(threadId) {\n      // The thread no longer exists, so its claim has nothing left to answer for.\n      // Dropping the state also makes any in-flight attempt for it unsubscribe\n      // itself instead of retaining a claim for a deleted thread.\n      const state = states.get(threadId);\n      if (!state) return;\n      clearRetry(state);\n      state.claim?.unsubscribe();\n      states.delete(threadId);\n    },\n    close() {\n      closed = true;\n      for (const state of states.values()) {\n        clearRetry(state);\n        state.claim?.unsubscribe();\n      }\n      states.clear();\n    },\n  };\n}\n"],"mappings":";AAKA,MAAM,mCAAmC;AACzC,MAAM,+BAA+B;AAerC,SAAgB,6BAA6B,aAI3C;CACA,MAAM,yBAAS,IAAI,IAA8B;CAIjD,IAAI,iBAAiB;CACrB,IAAI,SAAS;CAEb,MAAM,cAAc,UAA4B;EAC9C,IAAI,MAAM,YAAY,aAAa,MAAM,UAAU;EACnD,MAAM,aAAa,KAAA;CACrB;CAEA,MAAM,iBAAiB,UAAkB,oBAA4B;EACnE,MAAM,QAAQ,OAAO,IAAI,QAAQ;EACjC,IAAI,UAAU,CAAC,SAAS,MAAM,eAAe,mBAAmB,MAAM,YAAY;EAClF,MAAM,UAAU,MAAM;EACtB,MAAM,eAAe,KAAK,IAAI,MAAM,eAAe,GAAG,4BAA4B;EAClF,MAAM,aAAa,iBAAiB;GAClC,MAAM,aAAa,KAAA;GACnB,aAAkB,UAAU,iBAAiB,KAAK;EACpD,GAAG,OAAO;EACV,MAAM,WAAW,QAAQ;CAC3B;CAEA,MAAM,eAAe,OAAO,UAAkB,iBAAyB,mBAA8C;EACnH,IAAI;GACF,MAAM,YAAY,MAAM,YAAY,QAAQ;GAC5C,MAAM,QAAQ,OAAO,IAAI,QAAQ;GAGjC,IAAI,UAAU,CAAC,SAAS,MAAM,eAAe,iBAAiB;IAC5D,UAAU,YAAY;IACtB,OAAO;GACT;GACA,IAAI,CAAC,UAAU,SAAS;IACtB,cAAc,UAAU,eAAe;IACvC,OAAO;GACT;GACA,MAAM,eAAe;GACrB,MAAM,QAAQ;GACd,OAAO;EACT,SAAS,OAAO;GACd,cAAc,UAAU,eAAe;GACvC,IAAI,gBAAgB,MAAM;GAC1B,OAAO;EACT;CACF;CAEA,OAAO;EACL,MAAM,MAAM,UAAU;GACpB,IAAI,QAAQ,OAAO;GAGnB,IAAI,CAAC,UAAU,OAAO;GAKtB,MAAM,WAAW,OAAO,IAAI,QAAQ;GACpC,IAAI,UAAU;IACZ,WAAW,QAAQ;IACnB,SAAS,OAAO,YAAY;GAC9B;GACA,MAAM,QAA0B;IAC9B,YAAY,EAAE;IACd,cAAc;GAChB;GACA,OAAO,IAAI,UAAU,KAAK;GAC1B,OAAO,aAAa,UAAU,MAAM,YAAY,IAAI;EACtD;EACA,QAAQ,UAAU;GAIhB,MAAM,QAAQ,OAAO,IAAI,QAAQ;GACjC,IAAI,CAAC,OAAO;GACZ,WAAW,KAAK;GAChB,MAAM,OAAO,YAAY;GACzB,OAAO,OAAO,QAAQ;EACxB;EACA,QAAQ;GACN,SAAS;GACT,KAAK,MAAM,SAAS,OAAO,OAAO,GAAG;IACnC,WAAW,KAAK;IAChB,MAAM,OAAO,YAAY;GAC3B;GACA,OAAO,MAAM;EACf;CACF;AACF"}

package/dist/agent-connections/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/agent-connections/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAEhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIvF,eAAO,MAAM,uCAAuC,oCAAoC,CAAC;AAEzF,KAAK,mBAAmB,GAAG,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,iBAAiB,EAAE,CAAC,GAAG,iBAAiB,EAAE,CAAC;AAEnH,MAAM,WAAW,8BAA8B;IAC7C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC;AAED,qBAAa,uBAAuB;;gBAItB,OAAO,GAAE,8BAAmC;IAKlD,aAAa,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAQxE,SAAS,CAAC,OAAO,EAAE,sBAAsB,EAAE,UAAU,CAAC,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAwBvG,cAAc,CAAC,OAAO,EAAE,sBAAsB,EAAE,UAAU,CAAC,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;CA8BnH;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE1F"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/agent-connections/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAEhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AASvF,eAAO,MAAM,uCAAuC,oCAAoC,CAAC;AAEzF,KAAK,mBAAmB,GAAG,CAAC,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,iBAAiB,EAAE,CAAC,GAAG,iBAAiB,EAAE,CAAC;AAEnH,MAAM,WAAW,8BAA8B;IAC7C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC;AAED,qBAAa,uBAAuB;;gBAItB,OAAO,GAAE,8BAAmC;IAKlD,aAAa,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAQxE,SAAS,CAAC,OAAO,EAAE,sBAAsB,EAAE,UAAU,CAAC,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAwBvG,cAAc,CAAC,OAAO,EAAE,sBAAsB,EAAE,UAAU,CAAC,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;CA8BnH;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE1F"}

package/dist/agent-connections/registry.js

@@ -85,12 +85,14 @@ function normalizePeerIdentity(peer, now) {
 		title: candidate.title,
 		mode: candidate.mode,
 		pid: candidate.pid,
-		lastSeenAt: typeof candidate.lastSeenAt === "number" ? candidate.lastSeenAt : now
+		lastSeenAt: typeof candidate.lastSeenAt === "number" ? candidate.lastSeenAt : now,
+		...peer.selfAdvertised === true ? { selfAdvertised: true } : {}
 	};
 }
 function discoveredPeerToView(peer) {
+	const { selfAdvertised: _selfAdvertised, ...identity } = peer;
 	return {
-		...peer,
+		...identity,
 		relationship: "none",
 		presence: "advertised",
 		displayStatus: "discovered",
@@ -156,6 +158,7 @@ function isPeerLike(value) {
 	return !!value && typeof value === "object" && typeof value.resourceId === "string" && typeof value.threadId === "string";
 }
 function isSelf(peer, context) {
+	if (peer.selfAdvertised) return true;
 	return (peer.agentId ?? "code-agent") === (context.agent?.agentId ?? "code-agent") && peer.resourceId === context.agent?.resourceId && peer.threadId === context.agent?.threadId;
 }
 function comparePeers(a, b) {

package/dist/agent-connections/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","names":["#now","#listPeers","#discover","#discoverFromInjectedSource"],"sources":["../../src/agent-connections/registry.ts"],"sourcesContent":["import type { RequestContext } from '@mastra/core/request-context';\nimport type { AgentConnectionContext } from './thread-state.js';\nimport { readAgentConnections } from './thread-state.js';\nimport type { AgentPeerIdentity, AgentPeerView, ConnectedAgentPeer } from './types.js';\n\ntype NormalizedAgentPeerIdentity = Omit<AgentPeerIdentity, 'id' | 'agentId'> & { id: string; agentId: string };\n\nexport const AGENT_CONNECTIONS_DISCOVERY_CONTEXT_KEY = 'mastracode.agentConnectionPeers';\n\ntype PeerDiscoverySource = (context: AgentConnectionContext) => Promise<AgentPeerIdentity[]> | AgentPeerIdentity[];\n\nexport interface AgentConnectionRegistryOptions {\n  now?: () => number;\n  listPeers?: PeerDiscoverySource;\n}\n\nexport class AgentConnectionRegistry {\n  readonly #now: () => number;\n  readonly #listPeers?: PeerDiscoverySource;\n\n  constructor(options: AgentConnectionRegistryOptions = {}) {\n    this.#now = options.now ?? Date.now;\n    this.#listPeers = options.listPeers;\n  }\n\n  async discoverPeers(context: AgentConnectionContext): Promise<AgentPeerView[]> {\n    const discovered = await this.#discover(context);\n    return discovered\n      .filter(peer => !isSelf(peer, context))\n      .map(peer => discoveredPeerToView(peer))\n      .sort(comparePeers);\n  }\n\n  async listPeers(context: AgentConnectionContext, savedPeers?: ConnectedAgentPeer[]): Promise<AgentPeerView[]> {\n    const saved = savedPeers ?? (await readAgentConnections(context));\n    const discovered = await this.discoverPeers(context);\n    const byId = new Map<string, AgentPeerView>(discovered.map(peer => [peer.id, peer]));\n\n    for (const peer of saved) {\n      const canonicalId = stablePeerId(peer);\n      const discoveredPeer = peer.id === canonicalId ? byId.get(peer.id) : undefined;\n      if (discoveredPeer && sameEndpoint(peer, discoveredPeer)) {\n        byId.set(peer.id, {\n          ...discoveredPeer,\n          relationship: 'saved',\n          displayStatus: 'connected',\n          canAttemptSend: true,\n          connectedAt: peer.connectedAt,\n        });\n      } else {\n        byId.set(peer.id, savedPeerToAbsentView(peer));\n      }\n    }\n\n    return [...byId.values()].sort(comparePeers);\n  }\n\n  async connectedPeers(context: AgentConnectionContext, savedPeers?: ConnectedAgentPeer[]): Promise<AgentPeerView[]> {\n    return (await this.listPeers(context, savedPeers)).filter(peer => peer.relationship === 'saved');\n  }\n\n  async #discover(context: AgentConnectionContext): Promise<NormalizedAgentPeerIdentity[]> {\n    const sources = await Promise.allSettled([\n      Promise.resolve().then(() => this.#discoverFromInjectedSource(context)),\n      Promise.resolve().then(() => discoverFromCoreAgent(context)),\n      Promise.resolve().then(() => discoverFromRequestContext(context.requestContext)),\n      Promise.resolve().then(() => discoverFromEnv()),\n    ]);\n    const byId = new Map<string, NormalizedAgentPeerIdentity>();\n    for (const source of sources) {\n      if (source.status === 'rejected') continue;\n      for (const peer of source.value) {\n        const normalized = normalizePeerIdentity(peer, this.#now());\n        if (normalized) byId.set(normalized.id, normalized);\n      }\n    }\n    if (byId.size === 0) {\n      const rejected = sources.find(source => source.status === 'rejected');\n      if (rejected) throw rejected.reason;\n    }\n    return [...byId.values()].sort(comparePeers);\n  }\n\n  async #discoverFromInjectedSource(context: AgentConnectionContext): Promise<AgentPeerIdentity[]> {\n    if (!this.#listPeers) return [];\n    return this.#listPeers(context);\n  }\n}\n\nexport function stablePeerId(peer: Omit<AgentPeerIdentity, 'id'> & { id?: string }): string {\n  return [peer.agentId ?? 'code-agent', peer.resourceId, peer.threadId].map(part => encodeURIComponent(part)).join(':');\n}\n\nfunction normalizePeerIdentity(peer: unknown, now: number): NormalizedAgentPeerIdentity | undefined {\n  if (!peer || typeof peer !== 'object') return;\n  const candidate = peer as Partial<AgentPeerIdentity>;\n  if (!candidate.resourceId || !candidate.threadId) return;\n  const agentId = candidate.agentId ?? 'code-agent';\n  const id = stablePeerId({ agentId, resourceId: candidate.resourceId, threadId: candidate.threadId });\n  if (candidate.id && candidate.id !== id) return;\n  return {\n    id,\n    agentId,\n    resourceId: candidate.resourceId,\n    threadId: candidate.threadId,\n    label: candidate.label,\n    title: candidate.title,\n    mode: candidate.mode,\n    pid: candidate.pid,\n    lastSeenAt: typeof candidate.lastSeenAt === 'number' ? candidate.lastSeenAt : now,\n  };\n}\n\nfunction discoveredPeerToView(peer: NormalizedAgentPeerIdentity): AgentPeerView {\n  return {\n    ...peer,\n    relationship: 'none',\n    presence: 'advertised',\n    displayStatus: 'discovered',\n    canAttemptSend: false,\n  };\n}\n\nfunction savedPeerToAbsentView(peer: ConnectedAgentPeer): AgentPeerView {\n  return {\n    id: peer.id,\n    agentId: peer.agentId ?? 'code-agent',\n    resourceId: peer.resourceId,\n    threadId: peer.threadId,\n    label: peer.label,\n    title: peer.title,\n    mode: peer.mode,\n    relationship: 'saved',\n    presence: 'absent',\n    displayStatus: 'saved',\n    canAttemptSend: false,\n    pid: peer.pid,\n    connectedAt: peer.connectedAt,\n    lastSeenAt: peer.lastSeenAt,\n  };\n}\n\nfunction sameEndpoint(a: AgentPeerIdentity, b: AgentPeerIdentity): boolean {\n  return (\n    (a.agentId ?? 'code-agent') === (b.agentId ?? 'code-agent') &&\n    a.resourceId === b.resourceId &&\n    a.threadId === b.threadId\n  );\n}\n\nasync function discoverFromCoreAgent(context: AgentConnectionContext): Promise<AgentPeerIdentity[]> {\n  if (!context.runtimeAgent?.discoverThreadPeers) return [];\n  const peers = await context.runtimeAgent.discoverThreadPeers({ timeoutMs: 100 });\n  if (!Array.isArray(peers)) return [];\n  return peers.filter(isPeerLike).map(peer => {\n    const candidate = peer as AgentPeerIdentity & { metadata?: { mode?: unknown } };\n    const metadata = (peer as { metadata?: unknown }).metadata;\n    const mode =\n      metadata && typeof metadata === 'object' && typeof (metadata as { mode?: unknown }).mode === 'string'\n        ? (metadata as { mode: string }).mode\n        : candidate.mode;\n    return { ...candidate, mode };\n  });\n}\n\nfunction discoverFromRequestContext(requestContext: RequestContext | undefined): AgentPeerIdentity[] {\n  const value = requestContext?.get(AGENT_CONNECTIONS_DISCOVERY_CONTEXT_KEY);\n  if (Array.isArray(value)) return value.filter(isPeerLike) as AgentPeerIdentity[];\n  if (value && typeof value === 'object') {\n    const peers = (value as { peers?: unknown }).peers;\n    if (Array.isArray(peers)) return peers.filter(isPeerLike) as AgentPeerIdentity[];\n  }\n  return [];\n}\n\nfunction discoverFromEnv(): AgentPeerIdentity[] {\n  const raw = process.env.MASTRACODE_AGENT_CONNECTION_PEERS;\n  if (!raw) return [];\n  try {\n    const parsed = JSON.parse(raw) as unknown;\n    const peers = Array.isArray(parsed) ? parsed : (parsed as { peers?: unknown })?.peers;\n    return Array.isArray(peers) ? (peers.filter(isPeerLike) as AgentPeerIdentity[]) : [];\n  } catch {\n    return [];\n  }\n}\n\nfunction isPeerLike(value: unknown): boolean {\n  return (\n    !!value &&\n    typeof value === 'object' &&\n    typeof (value as AgentPeerIdentity).resourceId === 'string' &&\n    typeof (value as AgentPeerIdentity).threadId === 'string'\n  );\n}\n\nfunction isSelf(peer: AgentPeerIdentity, context: AgentConnectionContext): boolean {\n  return (\n    (peer.agentId ?? 'code-agent') === (context.agent?.agentId ?? 'code-agent') &&\n    peer.resourceId === context.agent?.resourceId &&\n    peer.threadId === context.agent?.threadId\n  );\n}\n\nfunction comparePeers(a: { id: string }, b: { id: string }): number {\n  return a.id.localeCompare(b.id);\n}\n"],"mappings":"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"}
+{"version":3,"file":"registry.js","names":["#now","#listPeers","#discover","#discoverFromInjectedSource"],"sources":["../../src/agent-connections/registry.ts"],"sourcesContent":["import type { RequestContext } from '@mastra/core/request-context';\nimport type { AgentConnectionContext } from './thread-state.js';\nimport { readAgentConnections } from './thread-state.js';\nimport type { AgentPeerIdentity, AgentPeerView, ConnectedAgentPeer } from './types.js';\n\ntype NormalizedAgentPeerIdentity = Omit<AgentPeerIdentity, 'id' | 'agentId'> & {\n  id: string;\n  agentId: string;\n  /** Carried through normalization so {@link isSelf} can drop our own advertisements. */\n  selfAdvertised?: boolean;\n};\n\nexport const AGENT_CONNECTIONS_DISCOVERY_CONTEXT_KEY = 'mastracode.agentConnectionPeers';\n\ntype PeerDiscoverySource = (context: AgentConnectionContext) => Promise<AgentPeerIdentity[]> | AgentPeerIdentity[];\n\nexport interface AgentConnectionRegistryOptions {\n  now?: () => number;\n  listPeers?: PeerDiscoverySource;\n}\n\nexport class AgentConnectionRegistry {\n  readonly #now: () => number;\n  readonly #listPeers?: PeerDiscoverySource;\n\n  constructor(options: AgentConnectionRegistryOptions = {}) {\n    this.#now = options.now ?? Date.now;\n    this.#listPeers = options.listPeers;\n  }\n\n  async discoverPeers(context: AgentConnectionContext): Promise<AgentPeerView[]> {\n    const discovered = await this.#discover(context);\n    return discovered\n      .filter(peer => !isSelf(peer, context))\n      .map(peer => discoveredPeerToView(peer))\n      .sort(comparePeers);\n  }\n\n  async listPeers(context: AgentConnectionContext, savedPeers?: ConnectedAgentPeer[]): Promise<AgentPeerView[]> {\n    const saved = savedPeers ?? (await readAgentConnections(context));\n    const discovered = await this.discoverPeers(context);\n    const byId = new Map<string, AgentPeerView>(discovered.map(peer => [peer.id, peer]));\n\n    for (const peer of saved) {\n      const canonicalId = stablePeerId(peer);\n      const discoveredPeer = peer.id === canonicalId ? byId.get(peer.id) : undefined;\n      if (discoveredPeer && sameEndpoint(peer, discoveredPeer)) {\n        byId.set(peer.id, {\n          ...discoveredPeer,\n          relationship: 'saved',\n          displayStatus: 'connected',\n          canAttemptSend: true,\n          connectedAt: peer.connectedAt,\n        });\n      } else {\n        byId.set(peer.id, savedPeerToAbsentView(peer));\n      }\n    }\n\n    return [...byId.values()].sort(comparePeers);\n  }\n\n  async connectedPeers(context: AgentConnectionContext, savedPeers?: ConnectedAgentPeer[]): Promise<AgentPeerView[]> {\n    return (await this.listPeers(context, savedPeers)).filter(peer => peer.relationship === 'saved');\n  }\n\n  async #discover(context: AgentConnectionContext): Promise<NormalizedAgentPeerIdentity[]> {\n    const sources = await Promise.allSettled([\n      Promise.resolve().then(() => this.#discoverFromInjectedSource(context)),\n      Promise.resolve().then(() => discoverFromCoreAgent(context)),\n      Promise.resolve().then(() => discoverFromRequestContext(context.requestContext)),\n      Promise.resolve().then(() => discoverFromEnv()),\n    ]);\n    const byId = new Map<string, NormalizedAgentPeerIdentity>();\n    for (const source of sources) {\n      if (source.status === 'rejected') continue;\n      for (const peer of source.value) {\n        const normalized = normalizePeerIdentity(peer, this.#now());\n        if (normalized) byId.set(normalized.id, normalized);\n      }\n    }\n    if (byId.size === 0) {\n      const rejected = sources.find(source => source.status === 'rejected');\n      if (rejected) throw rejected.reason;\n    }\n    return [...byId.values()].sort(comparePeers);\n  }\n\n  async #discoverFromInjectedSource(context: AgentConnectionContext): Promise<AgentPeerIdentity[]> {\n    if (!this.#listPeers) return [];\n    return this.#listPeers(context);\n  }\n}\n\nexport function stablePeerId(peer: Omit<AgentPeerIdentity, 'id'> & { id?: string }): string {\n  return [peer.agentId ?? 'code-agent', peer.resourceId, peer.threadId].map(part => encodeURIComponent(part)).join(':');\n}\n\nfunction normalizePeerIdentity(peer: unknown, now: number): NormalizedAgentPeerIdentity | undefined {\n  if (!peer || typeof peer !== 'object') return;\n  const candidate = peer as Partial<AgentPeerIdentity>;\n  if (!candidate.resourceId || !candidate.threadId) return;\n  const agentId = candidate.agentId ?? 'code-agent';\n  const id = stablePeerId({ agentId, resourceId: candidate.resourceId, threadId: candidate.threadId });\n  if (candidate.id && candidate.id !== id) return;\n  return {\n    id,\n    agentId,\n    resourceId: candidate.resourceId,\n    threadId: candidate.threadId,\n    label: candidate.label,\n    title: candidate.title,\n    mode: candidate.mode,\n    pid: candidate.pid,\n    lastSeenAt: typeof candidate.lastSeenAt === 'number' ? candidate.lastSeenAt : now,\n    ...((peer as { selfAdvertised?: unknown }).selfAdvertised === true ? { selfAdvertised: true } : {}),\n  };\n}\n\nfunction discoveredPeerToView(peer: NormalizedAgentPeerIdentity): AgentPeerView {\n  const { selfAdvertised: _selfAdvertised, ...identity } = peer;\n  return {\n    ...identity,\n    relationship: 'none',\n    presence: 'advertised',\n    displayStatus: 'discovered',\n    canAttemptSend: false,\n  };\n}\n\nfunction savedPeerToAbsentView(peer: ConnectedAgentPeer): AgentPeerView {\n  return {\n    id: peer.id,\n    agentId: peer.agentId ?? 'code-agent',\n    resourceId: peer.resourceId,\n    threadId: peer.threadId,\n    label: peer.label,\n    title: peer.title,\n    mode: peer.mode,\n    relationship: 'saved',\n    presence: 'absent',\n    displayStatus: 'saved',\n    canAttemptSend: false,\n    pid: peer.pid,\n    connectedAt: peer.connectedAt,\n    lastSeenAt: peer.lastSeenAt,\n  };\n}\n\nfunction sameEndpoint(a: AgentPeerIdentity, b: AgentPeerIdentity): boolean {\n  return (\n    (a.agentId ?? 'code-agent') === (b.agentId ?? 'code-agent') &&\n    a.resourceId === b.resourceId &&\n    a.threadId === b.threadId\n  );\n}\n\nasync function discoverFromCoreAgent(context: AgentConnectionContext): Promise<AgentPeerIdentity[]> {\n  if (!context.runtimeAgent?.discoverThreadPeers) return [];\n  const peers = await context.runtimeAgent.discoverThreadPeers({ timeoutMs: 100 });\n  if (!Array.isArray(peers)) return [];\n  return peers.filter(isPeerLike).map(peer => {\n    const candidate = peer as AgentPeerIdentity & { metadata?: { mode?: unknown } };\n    const metadata = (peer as { metadata?: unknown }).metadata;\n    const mode =\n      metadata && typeof metadata === 'object' && typeof (metadata as { mode?: unknown }).mode === 'string'\n        ? (metadata as { mode: string }).mode\n        : candidate.mode;\n    return { ...candidate, mode };\n  });\n}\n\nfunction discoverFromRequestContext(requestContext: RequestContext | undefined): AgentPeerIdentity[] {\n  const value = requestContext?.get(AGENT_CONNECTIONS_DISCOVERY_CONTEXT_KEY);\n  if (Array.isArray(value)) return value.filter(isPeerLike) as AgentPeerIdentity[];\n  if (value && typeof value === 'object') {\n    const peers = (value as { peers?: unknown }).peers;\n    if (Array.isArray(peers)) return peers.filter(isPeerLike) as AgentPeerIdentity[];\n  }\n  return [];\n}\n\nfunction discoverFromEnv(): AgentPeerIdentity[] {\n  const raw = process.env.MASTRACODE_AGENT_CONNECTION_PEERS;\n  if (!raw) return [];\n  try {\n    const parsed = JSON.parse(raw) as unknown;\n    const peers = Array.isArray(parsed) ? parsed : (parsed as { peers?: unknown })?.peers;\n    return Array.isArray(peers) ? (peers.filter(isPeerLike) as AgentPeerIdentity[]) : [];\n  } catch {\n    return [];\n  }\n}\n\nfunction isPeerLike(value: unknown): boolean {\n  return (\n    !!value &&\n    typeof value === 'object' &&\n    typeof (value as AgentPeerIdentity).resourceId === 'string' &&\n    typeof (value as AgentPeerIdentity).threadId === 'string'\n  );\n}\n\nfunction isSelf(peer: NormalizedAgentPeerIdentity, context: AgentConnectionContext): boolean {\n  // A session keeps every thread it has loaded advertised, so a thread of ours\n  // that is no longer current still comes back from discovery — tagged as our own\n  // by the agent that published it. Comparing only the current thread would\n  // surface the others as peers a user could \"connect\" to.\n  if (peer.selfAdvertised) return true;\n  return (\n    (peer.agentId ?? 'code-agent') === (context.agent?.agentId ?? 'code-agent') &&\n    peer.resourceId === context.agent?.resourceId &&\n    peer.threadId === context.agent?.threadId\n  );\n}\n\nfunction comparePeers(a: { id: string }, b: { id: string }): number {\n  return a.id.localeCompare(b.id);\n}\n"],"mappings":";;AAYA,MAAa,0CAA0C;AASvD,IAAa,0BAAb,MAAqC;CACnC;CACA;CAEA,YAAY,UAA0C,CAAC,GAAG;EACxD,KAAKA,OAAO,QAAQ,OAAO,KAAK;EAChC,KAAKC,aAAa,QAAQ;CAC5B;CAEA,MAAM,cAAc,SAA2D;EAE7E,QAAO,MADkB,KAAKC,UAAU,OAAO,EAAA,CAE5C,QAAO,SAAQ,CAAC,OAAO,MAAM,OAAO,CAAC,CAAC,CACtC,KAAI,SAAQ,qBAAqB,IAAI,CAAC,CAAC,CACvC,KAAK,YAAY;CACtB;CAEA,MAAM,UAAU,SAAiC,YAA6D;EAC5G,MAAM,QAAQ,cAAe,MAAM,qBAAqB,OAAO;EAC/D,MAAM,aAAa,MAAM,KAAK,cAAc,OAAO;EACnD,MAAM,OAAO,IAAI,IAA2B,WAAW,KAAI,SAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;EAEnF,KAAK,MAAM,QAAQ,OAAO;GACxB,MAAM,cAAc,aAAa,IAAI;GACrC,MAAM,iBAAiB,KAAK,OAAO,cAAc,KAAK,IAAI,KAAK,EAAE,IAAI,KAAA;GACrE,IAAI,kBAAkB,aAAa,MAAM,cAAc,GACrD,KAAK,IAAI,KAAK,IAAI;IAChB,GAAG;IACH,cAAc;IACd,eAAe;IACf,gBAAgB;IAChB,aAAa,KAAK;GACpB,CAAC;QAED,KAAK,IAAI,KAAK,IAAI,sBAAsB,IAAI,CAAC;EAEjD;EAEA,OAAO,CAAC,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,YAAY;CAC7C;CAEA,MAAM,eAAe,SAAiC,YAA6D;EACjH,QAAQ,MAAM,KAAK,UAAU,SAAS,UAAU,EAAA,CAAG,QAAO,SAAQ,KAAK,iBAAiB,OAAO;CACjG;CAEA,MAAMA,UAAU,SAAyE;EACvF,MAAM,UAAU,MAAM,QAAQ,WAAW;GACvC,QAAQ,QAAQ,CAAC,CAAC,WAAW,KAAKC,4BAA4B,OAAO,CAAC;GACtE,QAAQ,QAAQ,CAAC,CAAC,WAAW,sBAAsB,OAAO,CAAC;GAC3D,QAAQ,QAAQ,CAAC,CAAC,WAAW,2BAA2B,QAAQ,cAAc,CAAC;GAC/E,QAAQ,QAAQ,CAAC,CAAC,WAAW,gBAAgB,CAAC;EAChD,CAAC;EACD,MAAM,uBAAO,IAAI,IAAyC;EAC1D,KAAK,MAAM,UAAU,SAAS;GAC5B,IAAI,OAAO,WAAW,YAAY;GAClC,KAAK,MAAM,QAAQ,OAAO,OAAO;IAC/B,MAAM,aAAa,sBAAsB,MAAM,KAAKH,KAAK,CAAC;IAC1D,IAAI,YAAY,KAAK,IAAI,WAAW,IAAI,UAAU;GACpD;EACF;EACA,IAAI,KAAK,SAAS,GAAG;GACnB,MAAM,WAAW,QAAQ,MAAK,WAAU,OAAO,WAAW,UAAU;GACpE,IAAI,UAAU,MAAM,SAAS;EAC/B;EACA,OAAO,CAAC,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,YAAY;CAC7C;CAEA,MAAMG,4BAA4B,SAA+D;EAC/F,IAAI,CAAC,KAAKF,YAAY,OAAO,CAAC;EAC9B,OAAO,KAAKA,WAAW,OAAO;CAChC;AACF;AAEA,SAAgB,aAAa,MAA+D;CAC1F,OAAO;EAAC,KAAK,WAAW;EAAc,KAAK;EAAY,KAAK;CAAQ,CAAC,CAAC,KAAI,SAAQ,mBAAmB,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG;AACtH;AAEA,SAAS,sBAAsB,MAAe,KAAsD;CAClG,IAAI,CAAC,QAAQ,OAAO,SAAS,UAAU;CACvC,MAAM,YAAY;CAClB,IAAI,CAAC,UAAU,cAAc,CAAC,UAAU,UAAU;CAClD,MAAM,UAAU,UAAU,WAAW;CACrC,MAAM,KAAK,aAAa;EAAE;EAAS,YAAY,UAAU;EAAY,UAAU,UAAU;CAAS,CAAC;CACnG,IAAI,UAAU,MAAM,UAAU,OAAO,IAAI;CACzC,OAAO;EACL;EACA;EACA,YAAY,UAAU;EACtB,UAAU,UAAU;EACpB,OAAO,UAAU;EACjB,OAAO,UAAU;EACjB,MAAM,UAAU;EAChB,KAAK,UAAU;EACf,YAAY,OAAO,UAAU,eAAe,WAAW,UAAU,aAAa;EAC9E,GAAK,KAAsC,mBAAmB,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACnG;AACF;AAEA,SAAS,qBAAqB,MAAkD;CAC9E,MAAM,EAAE,gBAAgB,iBAAiB,GAAG,aAAa;CACzD,OAAO;EACL,GAAG;EACH,cAAc;EACd,UAAU;EACV,eAAe;EACf,gBAAgB;CAClB;AACF;AAEA,SAAS,sBAAsB,MAAyC;CACtE,OAAO;EACL,IAAI,KAAK;EACT,SAAS,KAAK,WAAW;EACzB,YAAY,KAAK;EACjB,UAAU,KAAK;EACf,OAAO,KAAK;EACZ,OAAO,KAAK;EACZ,MAAM,KAAK;EACX,cAAc;EACd,UAAU;EACV,eAAe;EACf,gBAAgB;EAChB,KAAK,KAAK;EACV,aAAa,KAAK;EAClB,YAAY,KAAK;CACnB;AACF;AAEA,SAAS,aAAa,GAAsB,GAA+B;CACzE,QACG,EAAE,WAAW,mBAAmB,EAAE,WAAW,iBAC9C,EAAE,eAAe,EAAE,cACnB,EAAE,aAAa,EAAE;AAErB;AAEA,eAAe,sBAAsB,SAA+D;CAClG,IAAI,CAAC,QAAQ,cAAc,qBAAqB,OAAO,CAAC;CACxD,MAAM,QAAQ,MAAM,QAAQ,aAAa,oBAAoB,EAAE,WAAW,IAAI,CAAC;CAC/E,IAAI,CAAC,MAAM,QAAQ,KAAK,GAAG,OAAO,CAAC;CACnC,OAAO,MAAM,OAAO,UAAU,CAAC,CAAC,KAAI,SAAQ;EAC1C,MAAM,YAAY;EAClB,MAAM,WAAY,KAAgC;EAClD,MAAM,OACJ,YAAY,OAAO,aAAa,YAAY,OAAQ,SAAgC,SAAS,WACxF,SAA8B,OAC/B,UAAU;EAChB,OAAO;GAAE,GAAG;GAAW;EAAK;CAC9B,CAAC;AACH;AAEA,SAAS,2BAA2B,gBAAiE;CACnG,MAAM,QAAQ,gBAAgB,IAAI,uCAAuC;CACzE,IAAI,MAAM,QAAQ,KAAK,GAAG,OAAO,MAAM,OAAO,UAAU;CACxD,IAAI,SAAS,OAAO,UAAU,UAAU;EACtC,MAAM,QAAS,MAA8B;EAC7C,IAAI,MAAM,QAAQ,KAAK,GAAG,OAAO,MAAM,OAAO,UAAU;CAC1D;CACA,OAAO,CAAC;AACV;AAEA,SAAS,kBAAuC;CAC9C,MAAM,MAAM,QAAQ,IAAI;CACxB,IAAI,CAAC,KAAK,OAAO,CAAC;CAClB,IAAI;EACF,MAAM,SAAS,KAAK,MAAM,GAAG;EAC7B,MAAM,QAAQ,MAAM,QAAQ,MAAM,IAAI,SAAU,QAAgC;EAChF,OAAO,MAAM,QAAQ,KAAK,IAAK,MAAM,OAAO,UAAU,IAA4B,CAAC;CACrF,QAAQ;EACN,OAAO,CAAC;CACV;AACF;AAEA,SAAS,WAAW,OAAyB;CAC3C,OACE,CAAC,CAAC,SACF,OAAO,UAAU,YACjB,OAAQ,MAA4B,eAAe,YACnD,OAAQ,MAA4B,aAAa;AAErD;AAEA,SAAS,OAAO,MAAmC,SAA0C;CAK3F,IAAI,KAAK,gBAAgB,OAAO;CAChC,QACG,KAAK,WAAW,mBAAmB,QAAQ,OAAO,WAAW,iBAC9D,KAAK,eAAe,QAAQ,OAAO,cACnC,KAAK,aAAa,QAAQ,OAAO;AAErC;AAEA,SAAS,aAAa,GAAmB,GAA2B;CAClE,OAAO,EAAE,GAAG,cAAc,EAAE,EAAE;AAChC"}

package/dist/agent-connections/session-advertisement.d.ts

@@ -0,0 +1,20 @@
+import type { AgentController, Session } from '@mastra/core/agent-controller';
+/**
+ * Advertise a session's threads to peer agents and keep them advertised.
+ *
+ * Cross-agent communication addresses peers by `(agentId, resourceId, threadId)`,
+ * so every thread the user has loaded has to stay claimed for as long as the
+ * session lives — a thread that is silently released becomes unreachable, and a
+ * peer that saved it can no longer send to it. Claims are therefore keyed per
+ * thread and only released when this session is torn down.
+ */
+export declare function createSessionThreadAdvertisement<TState>(options: {
+    session: Session<TState>;
+    controller: AgentController<TState>;
+    /** Human-readable peer label for every thread this session advertises. */
+    projectName: string;
+}): {
+    claim(threadId: string): Promise<void>;
+    close(): void;
+};
+//# sourceMappingURL=session-advertisement.d.ts.map

package/dist/agent-connections/session-advertisement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-advertisement.d.ts","sourceRoot":"","sources":["../../src/agent-connections/session-advertisement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAI9E;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,OAAO,EAAE;IAChE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,UAAU,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IACpC,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG;IAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,KAAK,IAAI,IAAI,CAAA;CAAE,CA2E5D"}

package/dist/agent-connections/session-advertisement.js

@@ -0,0 +1,79 @@
+import { createThreadOwnershipManager } from "./ownership.js";
+//#region src/agent-connections/session-advertisement.ts
+/**
+* Advertise a session's threads to peer agents and keep them advertised.
+*
+* Cross-agent communication addresses peers by `(agentId, resourceId, threadId)`,
+* so every thread the user has loaded has to stay claimed for as long as the
+* session lives — a thread that is silently released becomes unreachable, and a
+* peer that saved it can no longer send to it. Claims are therefore keyed per
+* thread and only released when this session is torn down.
+*/
+function createSessionThreadAdvertisement(options) {
+	const { session, controller, projectName } = options;
+	const latestObservedTitles = /* @__PURE__ */ new Map();
+	const threadOwnership = createThreadOwnershipManager(async (threadId) => {
+		const revisionAtStart = latestObservedTitles.get(threadId)?.revision ?? 0;
+		const thread = await session.thread.getById({ threadId });
+		const agent = controller.getCurrentAgent(session);
+		const claim = await agent.claimThreadOwnership({
+			threadId,
+			resourceId: session.identity.getResourceId(),
+			streamOptions: () => session.machinery.buildStreamOptions({ threadId }),
+			peer: {
+				label: projectName,
+				...thread?.title ? { title: thread.title } : {}
+			}
+		});
+		const observedTitle = latestObservedTitles.get(threadId);
+		if (claim.claimed && observedTitle && observedTitle.revision !== revisionAtStart) agent.updateThreadPeerAdvertisement({
+			resourceId: session.identity.getResourceId(),
+			threadId,
+			peer: { title: observedTitle.title }
+		});
+		return claim;
+	});
+	const claimThreadOwnership = async (threadId) => {
+		try {
+			await threadOwnership.claim(threadId);
+		} catch (error) {
+			console.error(`Failed to claim cross-agent thread ownership for ${threadId}`, error);
+		}
+	};
+	const unsubscribeSession = session.subscribe((event) => {
+		if (event.type === "thread_changed") claimThreadOwnership(event.threadId);
+		else if (event.type === "thread_created") claimThreadOwnership(event.thread.id);
+		else if (event.type === "thread_deleted") {
+			latestObservedTitles.delete(event.threadId);
+			threadOwnership.release(event.threadId);
+		} else if (event.type === "thread_title_updated" || event.type === "om_thread_title_updated") {
+			const title = event.type === "thread_title_updated" ? event.title : event.newTitle;
+			const revision = (latestObservedTitles.get(event.threadId)?.revision ?? 0) + 1;
+			latestObservedTitles.set(event.threadId, {
+				revision,
+				title
+			});
+			controller.getCurrentAgent(session).updateThreadPeerAdvertisement({
+				resourceId: session.identity.getResourceId(),
+				threadId: event.threadId,
+				peer: { title }
+			});
+		}
+	});
+	return {
+		/**
+		* Claim (and start advertising) a thread. Errors are logged, not thrown:
+		* the caller often cannot await the result, and a failed claim is retried
+		* by the ownership manager.
+		*/
+		claim: claimThreadOwnership,
+		close() {
+			unsubscribeSession();
+			threadOwnership.close();
+		}
+	};
+}
+//#endregion
+export { createSessionThreadAdvertisement };
+
+//# sourceMappingURL=session-advertisement.js.map

package/dist/agent-connections/session-advertisement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-advertisement.js","names":[],"sources":["../../src/agent-connections/session-advertisement.ts"],"sourcesContent":["import type { AgentController, Session } from '@mastra/core/agent-controller';\n\nimport { createThreadOwnershipManager } from './ownership.js';\n\n/**\n * Advertise a session's threads to peer agents and keep them advertised.\n *\n * Cross-agent communication addresses peers by `(agentId, resourceId, threadId)`,\n * so every thread the user has loaded has to stay claimed for as long as the\n * session lives — a thread that is silently released becomes unreachable, and a\n * peer that saved it can no longer send to it. Claims are therefore keyed per\n * thread and only released when this session is torn down.\n */\nexport function createSessionThreadAdvertisement<TState>(options: {\n  session: Session<TState>;\n  controller: AgentController<TState>;\n  /** Human-readable peer label for every thread this session advertises. */\n  projectName: string;\n}): { claim(threadId: string): Promise<void>; close(): void } {\n  const { session, controller, projectName } = options;\n  // Title updates can land while a thread's ownership request is still in\n  // flight, when there is no advertisement to update yet. Remembering the\n  // latest title (with a revision) lets the claim apply it afterwards instead\n  // of losing the rename.\n  const latestObservedTitles = new Map<string, { revision: number; title: string | undefined }>();\n\n  const threadOwnership = createThreadOwnershipManager(async threadId => {\n    const revisionAtStart = latestObservedTitles.get(threadId)?.revision ?? 0;\n    const thread = await session.thread.getById({ threadId });\n    const agent = controller.getCurrentAgent(session);\n    const claim = await agent.claimThreadOwnership({\n      threadId,\n      resourceId: session.identity.getResourceId(),\n      // The claim answers for `threadId`, which is not necessarily the session's\n      // current thread once the user has moved on — so the woken run must bind\n      // its memory and request context to the claimed thread, not the current one.\n      streamOptions: () => session.machinery.buildStreamOptions({ threadId }),\n      peer: {\n        label: projectName,\n        ...(thread?.title ? { title: thread.title } : {}),\n      },\n    });\n    const observedTitle = latestObservedTitles.get(threadId);\n    if (claim.claimed && observedTitle && observedTitle.revision !== revisionAtStart) {\n      agent.updateThreadPeerAdvertisement({\n        resourceId: session.identity.getResourceId(),\n        threadId,\n        peer: { title: observedTitle.title },\n      });\n    }\n    return claim;\n  });\n\n  const claimThreadOwnership = async (threadId: string) => {\n    try {\n      await threadOwnership.claim(threadId);\n    } catch (error) {\n      console.error(`Failed to claim cross-agent thread ownership for ${threadId}`, error);\n    }\n  };\n\n  const unsubscribeSession = session.subscribe(event => {\n    if (event.type === 'thread_changed') void claimThreadOwnership(event.threadId);\n    else if (event.type === 'thread_created') void claimThreadOwnership(event.thread.id);\n    else if (event.type === 'thread_deleted') {\n      // Claims outlive the session's current thread, so a deleted thread has to be\n      // released explicitly or it stays advertised and a peer keeps sending to it.\n      latestObservedTitles.delete(event.threadId);\n      threadOwnership.release(event.threadId);\n    } else if (event.type === 'thread_title_updated' || event.type === 'om_thread_title_updated') {\n      const title = event.type === 'thread_title_updated' ? event.title : event.newTitle;\n      const revision = (latestObservedTitles.get(event.threadId)?.revision ?? 0) + 1;\n      latestObservedTitles.set(event.threadId, { revision, title });\n      controller.getCurrentAgent(session).updateThreadPeerAdvertisement({\n        resourceId: session.identity.getResourceId(),\n        threadId: event.threadId,\n        peer: { title },\n      });\n    }\n  });\n\n  return {\n    /**\n     * Claim (and start advertising) a thread. Errors are logged, not thrown:\n     * the caller often cannot await the result, and a failed claim is retried\n     * by the ownership manager.\n     */\n    claim: claimThreadOwnership,\n    close() {\n      unsubscribeSession();\n      threadOwnership.close();\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;AAaA,SAAgB,iCAAyC,SAKK;CAC5D,MAAM,EAAE,SAAS,YAAY,gBAAgB;CAK7C,MAAM,uCAAuB,IAAI,IAA6D;CAE9F,MAAM,kBAAkB,6BAA6B,OAAM,aAAY;EACrE,MAAM,kBAAkB,qBAAqB,IAAI,QAAQ,CAAC,EAAE,YAAY;EACxE,MAAM,SAAS,MAAM,QAAQ,OAAO,QAAQ,EAAE,SAAS,CAAC;EACxD,MAAM,QAAQ,WAAW,gBAAgB,OAAO;EAChD,MAAM,QAAQ,MAAM,MAAM,qBAAqB;GAC7C;GACA,YAAY,QAAQ,SAAS,cAAc;GAI3C,qBAAqB,QAAQ,UAAU,mBAAmB,EAAE,SAAS,CAAC;GACtE,MAAM;IACJ,OAAO;IACP,GAAI,QAAQ,QAAQ,EAAE,OAAO,OAAO,MAAM,IAAI,CAAC;GACjD;EACF,CAAC;EACD,MAAM,gBAAgB,qBAAqB,IAAI,QAAQ;EACvD,IAAI,MAAM,WAAW,iBAAiB,cAAc,aAAa,iBAC/D,MAAM,8BAA8B;GAClC,YAAY,QAAQ,SAAS,cAAc;GAC3C;GACA,MAAM,EAAE,OAAO,cAAc,MAAM;EACrC,CAAC;EAEH,OAAO;CACT,CAAC;CAED,MAAM,uBAAuB,OAAO,aAAqB;EACvD,IAAI;GACF,MAAM,gBAAgB,MAAM,QAAQ;EACtC,SAAS,OAAO;GACd,QAAQ,MAAM,oDAAoD,YAAY,KAAK;EACrF;CACF;CAEA,MAAM,qBAAqB,QAAQ,WAAU,UAAS;EACpD,IAAI,MAAM,SAAS,kBAAkB,qBAA0B,MAAM,QAAQ;OACxE,IAAI,MAAM,SAAS,kBAAkB,qBAA0B,MAAM,OAAO,EAAE;OAC9E,IAAI,MAAM,SAAS,kBAAkB;GAGxC,qBAAqB,OAAO,MAAM,QAAQ;GAC1C,gBAAgB,QAAQ,MAAM,QAAQ;EACxC,OAAO,IAAI,MAAM,SAAS,0BAA0B,MAAM,SAAS,2BAA2B;GAC5F,MAAM,QAAQ,MAAM,SAAS,yBAAyB,MAAM,QAAQ,MAAM;GAC1E,MAAM,YAAY,qBAAqB,IAAI,MAAM,QAAQ,CAAC,EAAE,YAAY,KAAK;GAC7E,qBAAqB,IAAI,MAAM,UAAU;IAAE;IAAU;GAAM,CAAC;GAC5D,WAAW,gBAAgB,OAAO,CAAC,CAAC,8BAA8B;IAChE,YAAY,QAAQ,SAAS,cAAc;IAC3C,UAAU,MAAM;IAChB,MAAM,EAAE,MAAM;GAChB,CAAC;EACH;CACF,CAAC;CAED,OAAO;;;;;;EAML,OAAO;EACP,QAAQ;GACN,mBAAmB;GACnB,gBAAgB,MAAM;EACxB;CACF;AACF"}

package/dist/agent-connections/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/agent-connections/tools.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,uBAAuB,EAAgB,MAAM,eAAe,CAAC;AA8GtE,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,QAAQ,CAAC,EAAE,MACP;QACE,sBAAsB,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9D,mBAAmB,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KAC5D,GACD,SAAS,CAAC;CACf;AAED,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,2BAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyXnF"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/agent-connections/tools.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,uBAAuB,EAAgB,MAAM,eAAe,CAAC;AA8GtE,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,QAAQ,CAAC,EAAE,MACP;QACE,sBAAsB,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9D,mBAAmB,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KAC5D,GACD,SAAS,CAAC;CACf;AAED,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,2BAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwZnF"}

package/dist/agent-connections/tools.js

@@ -252,12 +252,12 @@ The peer does not need to be currently advertised. Disconnecting is idempotent a
 			id: "agent_signal_send",
 			description: `Send a prioritized notification signal to a connected peer agent.
 
-The target must already be saved and freshly advertise the same exact thread endpoint at send time. Use expectsReply to declare whether the peer should send one signal back to this thread. Reuse messageId when retrying the same logical send, and set replyTo to the request messageId when replying. Use priority to indicate urgency: low, medium, high, or urgent.`,
+The target must already be saved and freshly advertise the same exact thread endpoint at send time. Use expectsReply to declare whether the peer owes one signal back to this thread; false removes that obligation but does not prevent or forbid a reply. Signals routed to a notification summary cannot establish a reply obligation until the recipient opens the full notification, so use a priority that routes directly when a reply is required. Reuse messageId when retrying the same logical send, and set replyTo to the request messageId when replying. Use priority to indicate urgency: low, medium, high, or urgent.`,
 			inputSchema: z.object({
 				targetId: z.string().min(1).describe("Connected peer id."),
 				summary: z.string().min(1).describe("Short summary to deliver to the peer."),
 				priority: prioritySchema.default("medium"),
-				expectsReply: z.boolean().describe("Whether the peer is expected to send one signal back to this thread."),
+				expectsReply: z.boolean().describe("Whether the peer owes one signal back. False means no obligation, not no permission to reply."),
 				messageId: z.string().min(1).optional().describe("Stable logical message id. Reuse the same id for a sequential retry; receiver-side notification coalescing also uses it."),
 				replyTo: z.string().min(1).optional().describe("Message id of the peer request this signal replies to."),
 				payload: z.unknown().optional().describe("Optional structured payload for the peer.")
@@ -339,7 +339,7 @@ The target must already be saved and freshly advertise the same exact thread end
 						expectsReply,
 						messageId,
 						...replyTo ? { replyTo } : {},
-						returnPeerId,
+						...expectsReply ? { returnPeerId } : {},
 						from: {
 							resourceId: currentAgent.resourceId,
 							threadId: currentAgent.threadId
@@ -356,6 +356,7 @@ The target must already be saved and freshly advertise the same exact thread end
 						attributes: {
 							expectsReply,
 							messageId,
+							sourcePeerId: returnPeerId,
 							...replyTo ? { replyTo } : {},
 							...expectsReply ? { returnPeerId } : {}
 						},
@@ -372,8 +373,25 @@ The target must already be saved and freshly advertise the same exact thread end
 							requireClaimedOwner: true
 						}
 					});
-					const accepted = notification.accepted ? await notification.accepted : void 0;
-					if (!accepted) return {
+					let accepted = notification.accepted ? await notification.accepted : void 0;
+					if (!accepted) if (notification.decision.action === "persist" || notification.decision.action === "defer" || notification.decision.action === "summarize") {
+						if (expectsReply) {
+							await notification.persisted;
+							return {
+								content: `Failed to establish a reply obligation: the signal was queued for a notification summary instead of being delivered directly to ${untrustedPeerLabel(target)}. Send a new signal at a priority that routes directly when a reply is required.`,
+								target,
+								priority,
+								expectsReply,
+								messageId,
+								replyTo,
+								returnPeerId,
+								routingAction: "persist",
+								isError: true
+							};
+						}
+						accepted = { action: "persist" };
+					} else if (notification.decision.action === "discard") accepted = { action: "discard" };
+					else return {
 						content: `Failed to send agent signal: ${notification.record.lastDeliveryError ?? "delivery was not acknowledged by the target thread owner"}`,
 						target,
 						priority,
@@ -383,15 +401,15 @@ The target must already be saved and freshly advertise the same exact thread end
 						returnPeerId,
 						isError: true
 					};
-					if (accepted.action === "blocked") return {
-						content: `Failed to send agent signal: target thread ${untrustedThreadId(target)} is suspended and did not accept the signal. Retry with the same messageId once it resumes.`,
+					if (accepted.action === "blocked" || accepted.action === "discard") return {
+						content: accepted.action === "blocked" ? `Failed to send agent signal: target thread ${untrustedThreadId(target)} is suspended and did not accept the signal. Retry with the same messageId once it resumes.` : `Failed to send agent signal: delivery policy discarded the signal before it reached ${untrustedPeerLabel(target)}. Retry with the same messageId if the delivery policy changes.`,
 						target,
 						priority,
 						expectsReply,
 						messageId,
 						replyTo,
 						returnPeerId,
-						routingAction: "blocked",
+						routingAction: accepted.action,
 						isError: true
 					};
 					if (accepted.action === "persist") await notification.persisted;