fix(sessions): clarify cross-agent visibility guidance

sahibzada-allahyar · sahibzada-allahyar · commit cdacc32b5245 · 2026-06-05T01:20:03.000+01:00
diff --git a/src/agents/tools/sessions-access.test.ts b/src/agents/tools/sessions-access.test.ts
@@ -278,7 +278,7 @@ describe("createSessionVisibilityGuard", () => {
       allowed: false,
       status: "forbidden",
       error:
-        "Session list visibility is restricted. Set tools.sessions.visibility=all to allow cross-agent access.",
+        "Session list visibility is restricted. Set tools.sessions.visibility=all and tools.agentToAgent.enabled=true (with allow list) to allow cross-agent access.",
     });
   });
 
@@ -340,7 +340,7 @@ describe("createSessionVisibilityGuard", () => {
       allowed: false,
       status: "forbidden",
       error:
-        "Session history visibility is restricted. Set tools.sessions.visibility=all to allow cross-agent access.",
+        "Session history visibility is restricted. Set tools.sessions.visibility=all and tools.agentToAgent.enabled=true (with allow list) to allow cross-agent access.",
     });
   });
 
diff --git a/src/plugin-sdk/session-visibility.ts b/src/plugin-sdk/session-visibility.ts
@@ -236,16 +236,18 @@ function a2aDeniedMessage(action: SessionAccessAction): string {
 }
 
 function crossVisibilityMessage(action: SessionAccessAction): string {
+  const suffix =
+    "Set tools.sessions.visibility=all and tools.agentToAgent.enabled=true (with allow list) to allow cross-agent access.";
   if (action === "history") {
-    return "Session history visibility is restricted. Set tools.sessions.visibility=all to allow cross-agent access.";
+    return `Session history visibility is restricted. ${suffix}`;
   }
   if (action === "send") {
-    return "Session send visibility is restricted. Set tools.sessions.visibility=all to allow cross-agent access.";
+    return `Session send visibility is restricted. ${suffix}`;
   }
   if (action === "status") {
-    return "Session status visibility is restricted. Set tools.sessions.visibility=all to allow cross-agent access.";
+    return `Session status visibility is restricted. ${suffix}`;
   }
-  return "Session list visibility is restricted. Set tools.sessions.visibility=all to allow cross-agent access.";
+  return `Session list visibility is restricted. ${suffix}`;
 }
 
 function selfVisibilityMessage(action: SessionAccessAction): string {

Original file line number	Diff line number	Diff line change
`@@ -236,16 +236,18 @@ function a2aDeniedMessage(action: SessionAccessAction): string {`
`236`	`236`	`}`
`237`	`237`
`238`	`238`	`function crossVisibilityMessage(action: SessionAccessAction): string {`
	`239`	`+ const suffix =`
	`240`	`+ "Set tools.sessions.visibility=all and tools.agentToAgent.enabled=true (with allow list) to allow cross-agent access.";`
`239`	`241`	`if (action === "history") {`
`240`		`- return "Session history visibility is restricted. Set tools.sessions.visibility=all to allow cross-agent access.";`
	`242`	+ return `Session history visibility is restricted. ${suffix}`;
`241`	`243`	`}`
`242`	`244`	`if (action === "send") {`
`243`		`- return "Session send visibility is restricted. Set tools.sessions.visibility=all to allow cross-agent access.";`
	`245`	+ return `Session send visibility is restricted. ${suffix}`;
`244`	`246`	`}`
`245`	`247`	`if (action === "status") {`
`246`		`- return "Session status visibility is restricted. Set tools.sessions.visibility=all to allow cross-agent access.";`
	`248`	+ return `Session status visibility is restricted. ${suffix}`;
`247`	`249`	`}`
`248`		`- return "Session list visibility is restricted. Set tools.sessions.visibility=all to allow cross-agent access.";`
	`250`	+ return `Session list visibility is restricted. ${suffix}`;
`249`	`251`	`}`
`250`	`252`
`251`	`253`	`function selfVisibilityMessage(action: SessionAccessAction): string {`