@bastani/atomic 0.9.47 → 0.9.48-alpha.1

package/dist/builtin/intercom/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to the `pi-intercom` extension will be documented in this fi
 
 ## [Unreleased]
 
+## [0.9.48-alpha.1] - 2026-10-27
+
+### Fixed
+
+- A session restored after Atomic restarts now rejoins the Intercom groups it had joined, so it can still reach its restored subagents in those groups without joining again. Each `join` and `leave` is saved with the session, and a restored session rejoins exactly the groups its own last record lists before it first connects. A group it left before the restart is not rejoined, a forked session does not inherit the record, and a session restored under a different home group keeps only its home group. The same holds for a resumed workflow stage, in process or on a replacement local worker: it comes back in its invocation group or subgroup and in every group it joined, so the launcher reaches it by path and its teammates by name ([#4079](https://github.com/bastani-inc/atomic/issues/4079))
+- A send to a session that is not in any of the sender's groups, but is live in a group the sender's read-only `intercom list` peek can show, now fails with `<name> is live in group <group>; join it to send` instead of `Session not found`. Workflow groups keep their own rules: a workflow stage never gets the hint, no sender is told to join a `workflow:` group, and a session visible only in a group the peek refuses still gets `Session not found` ([#4079](https://github.com/bastani-inc/atomic/issues/4079))
+
 ## [0.9.46] - 2026-10-27
 
 ### Fixed

package/dist/builtin/intercom/README.md

@@ -191,6 +191,11 @@ startup identity. An ordinary host can therefore control several joined workflow
 invocations, while a workflow worker cannot gain another invocation's parent-control
 authority by joining its group and reconnecting.
 
+Joined memberships are also saved with the session: a session restored after
+Atomic restarts rejoins the groups its last `join`/`leave` left it in, and a group
+it left is not rejoined. A `send` to a session that is live only in a group your
+read-only `list` peek can show fails with `<name> is live in group <group>; join it to send`.
+
 **Worker finds something unexpected — escalates and waits:**
 ```typescript
 intercom({

package/dist/builtin/intercom/broker/broker.ts

@@ -2259,6 +2259,7 @@ class IntercomBroker {
       this.holdForRestoringRecipient,
       this.receipts,
       this.routeRemote,
+      (sender, group) => this.canInspectSelectedGroup(sender, group),
     );
   }
 

package/dist/builtin/intercom/broker/send-handler.ts

@@ -169,6 +169,8 @@ export function handleBrokerSend(
 	holdForRestoringRecipient?: RestoringRecipientHold,
 	receipts?: RecipientReceipts<BrokerConnectedSession>,
 	routeRemote?: RemoteSendRouter,
+	/** #4079: whether the sender's read-only `list` peek may inspect a group; names a hidden target's group. */
+	canPeekGroup?: (sender: BrokerConnectedSession, group: string) => boolean,
 ): void {
   const message = clientMessage.message;
   const messageId = wireMessageId(message);
@@ -406,6 +408,8 @@ export function handleBrokerSend(
           isNonAgentWorkflowTarget,
           holdForRestoringRecipient,
           receipts,
+          undefined,
+          canPeekGroup,
         ),
     });
     return;
@@ -473,6 +477,7 @@ export function handleBrokerSend(
 					holdForRestoringRecipient,
 					receipts,
 					routeRemote,
+					canPeekGroup,
 				);
 			},
 		});
@@ -820,13 +825,47 @@ export function handleBrokerSend(
 	) {
 		return;
 	}
+  const peekHint =
+    resolution.kind === "not_found" && !supervisorSend && !requirePendingReply && expectedRecipientId === undefined &&
+    message.replyTo === undefined && workflowTarget === undefined && canPeekGroup !== undefined
+      ? liveInPeekableGroupReason(sessions, fromSession, trimmedTo, canPeekGroup)
+      : undefined;
   write(socket, {
     type: "delivery_failed",
     messageId: message.id,
     attemptId,
-    reason: sessionTargetFailureReason(clientMessage.to, resolution),
+    reason: peekHint ?? sessionTargetFailureReason(clientMessage.to, resolution),
 		...(requirePendingReply && resolution.kind === "not_found"
 			? { reasonCode: "session_not_found" as const }
 			: {}),
   });
 }
+
+/**
+ * #4079: a target outside every group the sender shares that is live in a group the sender's read-only `list`
+ * peek already shows. Names one such group so the sender knows to join it. A target visible only in groups the
+ * peek refuses, or matching more than one peekable session, gets no hint, so this reveals nothing `list` hides.
+ * Workflow groups keep their own ownership rules: a workflow stage is never told to join a group outside its run,
+ * and no sender is told to join a `workflow:` group, since joining one is how a host takes control of a run.
+ */
+function liveInPeekableGroupReason(
+  sessions: Map<string, BrokerConnectedSession>,
+  sender: BrokerConnectedSession,
+  target: string,
+  canPeekGroup: (sender: BrokerConnectedSession, group: string) => boolean,
+): string | undefined {
+  if (normalizeGroup(sender.registrationGroup ?? sender.info.group).startsWith("workflow:")) return undefined;
+  const peekable = new Map<string, string>();
+  for (const { info } of sessions.values()) {
+    if (info.id === sender.info.id || !isAgentRecipient(info) || sessionsShareGroup(info, sender.info)) continue;
+    const group = [...sessionGroups(info)].find(
+      (candidate) => !candidate.startsWith("workflow:") && canPeekGroup(sender, candidate),
+    );
+    if (group !== undefined) peekable.set(info.id, group);
+  }
+  const candidates = Array.from(peekable.keys(), (id) => sessions.get(id)!.info);
+  const resolution = resolveSessionTarget(candidates, target);
+  if (resolution.kind !== "resolved") return undefined;
+  const group = peekable.get(resolution.session.id)!;
+  return `${resolution.session.name ?? resolution.session.id} is live in group ${group}; join it to send`;
+}

package/dist/builtin/intercom/index.bundle.mjs

@@ -552,6 +552,26 @@ function readIntercomSessionIdentity(entries, sessionId) {
 }
 var INTERCOM_SESSION_IDENTITY_ENTRY = "intercom_session_identity";
 
+// dist/builtin/intercom/session-memberships.ts
+function isMemberships(record) {
+  return record !== undefined && record !== null && typeof record.sessionId === "string" && typeof record.homeGroup === "string" && (record.groups === null || Array.isArray(record.groups) && record.groups.every((group) => typeof group === "string"));
+}
+function readIntercomSessionMemberships(entries, sessionId, homeGroup) {
+  for (let index = entries.length - 1;index >= 0; index -= 1) {
+    const entry = entries[index];
+    if (entry?.type !== "custom" || entry.customType !== INTERCOM_SESSION_MEMBERSHIPS_ENTRY)
+      continue;
+    const data = entry.data;
+    if (!isMemberships(data) || data.sessionId !== sessionId)
+      continue;
+    if (data.homeGroup !== homeGroup || data.groups === null)
+      return;
+    return data.groups;
+  }
+  return;
+}
+var INTERCOM_SESSION_MEMBERSHIPS_ENTRY = "intercom_session_memberships";
+
 // dist/builtin/intercom/broker/framing.ts
 function writeMessage(socket, msg, callback) {
   const json = JSON.stringify(msg);
@@ -4363,7 +4383,7 @@ one shared membership; contact_supervisor remains the only cross-group path.`,
             }
             try {
               const groups = await connectedClient.joinGroup(targetGroup);
-              deps.setJoinedGroups(groups);
+              await deps.setJoinedGroups(groups);
               return {
                 content: [{ type: "text", text: `Joined intercom group "${targetGroup}". Memberships: ${groups.join(", ")}.` }],
                 isError: false,
@@ -4398,10 +4418,10 @@ one shared membership; contact_supervisor remains the only cross-group path.`,
                   throw new Error("Intercom home group is unavailable");
                 await connectedClient.updatePresenceAcked({ groups: [homeGroup] });
                 groups = connectedClient.groups;
-                deps.clearJoinedGroups();
+                await deps.clearJoinedGroups();
               } else {
                 groups = await connectedClient.leaveGroup(targetGroup);
-                deps.setJoinedGroups(groups);
+                await deps.setJoinedGroups(groups);
               }
               const text = targetGroup === undefined ? `Returned to home intercom membership. Memberships: ${groups.join(", ")}.` : `Left intercom group "${targetGroup}". Memberships: ${groups.join(", ")}.`;
               return {
@@ -7873,6 +7893,25 @@ function piIntercomExtension(pi, testOverrides = {}) {
       sessionMemberships.delete(currentSessionId);
     releaseJoinedGroups();
   }
+  async function persistJoinedGroups(groups) {
+    const sessionId = currentSessionId;
+    if (!sessionId)
+      return;
+    try {
+      await pi.appendEntry(INTERCOM_SESSION_MEMBERSHIPS_ENTRY, {
+        sessionId,
+        homeGroup: resolveSessionHomeGroup(),
+        groups: groups === null ? null : [...normalizeGroups(groups)]
+      });
+    } catch {}
+  }
+  function persistedJoinedGroups(ctx) {
+    try {
+      return readIntercomSessionMemberships(ctx.sessionManager.getEntries(), ctx.sessionManager.getSessionId(), resolveSessionHomeGroup());
+    } catch {
+      return;
+    }
+  }
   function releaseJoinedGroups() {
     joinedGroups = null;
     const sessionId = currentSessionId;
@@ -8930,7 +8969,7 @@ function piIntercomExtension(pi, testOverrides = {}) {
     currentStatus
   });
   pi.on("session_start", async (event, ctx) => {
-    const retainedMemberships = event.reason === "reload" ? sessionMemberships.get(ctx.sessionManager.getSessionId()) : undefined;
+    const retainedMemberships = event.reason === "reload" ? sessionMemberships.get(ctx.sessionManager.getSessionId()) : persistedJoinedGroups(ctx);
     if (retainedMemberships)
       setJoinedGroups(retainedMemberships);
     const pendingStageDelivery = ctx.orchestrationContext?.kind === "workflow-stage" ? ctx.orchestrationContext.pendingStageDelivery : undefined;
@@ -8990,8 +9029,14 @@ function piIntercomExtension(pi, testOverrides = {}) {
     beginReplyWait: (from, replyTo, signal) => replyWaiters.begin(from, replyTo, signal),
     confirmSend: config.confirmSend,
     homeGroup: resolveSessionHomeGroup,
-    setJoinedGroups,
-    clearJoinedGroups,
+    setJoinedGroups: async (groups) => {
+      setJoinedGroups(groups);
+      await persistJoinedGroups(groups);
+    },
+    clearJoinedGroups: async () => {
+      clearJoinedGroups();
+      await persistJoinedGroups(null);
+    },
     replyTracker: () => replyTracker
   });
   registerIntercomOverlay(pi, {

package/dist/builtin/intercom/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/intercom",
-  "version": "0.9.47",
+  "version": "0.9.48-alpha.1",
   "private": true,
   "description": "Atomic extension providing a private coordination channel between parent and child agent sessions. Fork of: https://github.com/nicobailon/pi-intercom",
   "contributors": [

package/dist/builtin/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/mcp",
-  "version": "0.9.47",
+  "version": "0.9.48-alpha.1",
   "private": true,
   "description": "Atomic's pi-compatible MCP integration for server connections, OAuth, tools, resources, and terminal management.",
   "contributors": [

package/dist/builtin/subagents/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/subagents",
-  "version": "0.9.47",
+  "version": "0.9.48-alpha.1",
   "private": true,
   "description": "Atomic extension for delegating tasks to subagents with parallel execution. Fork of: https://github.com/nicobailon/pi-subagents",
   "contributors": [

package/dist/builtin/web-access/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/web-access",
-  "version": "0.9.47",
+  "version": "0.9.48-alpha.1",
   "private": true,
   "description": "Atomic extension for web search, URL fetching, GitHub repo cloning, PDF/video extraction. Fork of: https://github.com/nicobailon/pi-web-access",
   "contributors": [

package/dist/builtin/workflows/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/workflows",
-  "version": "0.9.47",
+  "version": "0.9.48-alpha.1",
   "private": true,
   "description": "Atomic extension for multi-stage workflow authoring and execution.",
   "contributors": [

package/npm-shrinkwrap.json

@@ -1,16 +1,16 @@
 {
 	"name": "@bastani/atomic",
-	"version": "0.9.47",
+	"version": "0.9.48-alpha.1",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "@bastani/atomic",
-			"version": "0.9.47",
+			"version": "0.9.48-alpha.1",
 			"license": "MIT",
 			"dependencies": {
-				"@bastani/atomic-natives": "0.9.47",
-				"@bastani/pi-ai": "0.9.47",
+				"@bastani/atomic-natives": "0.9.48-alpha.1",
+				"@bastani/pi-ai": "0.9.48-alpha.1",
 				"@earendil-works/pi-agent-core": "1.4.0",
 				"@earendil-works/pi-codemode": "1.4.0",
 				"@earendil-works/pi-tui": "1.4.0",
@@ -427,18 +427,18 @@
 			}
 		},
 		"node_modules/@bastani/atomic-natives": {
-			"version": "0.9.47",
-			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives/-/atomic-natives-0.9.47.tgz",
+			"version": "0.9.48-alpha.1",
+			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives/-/atomic-natives-0.9.48-alpha.1.tgz",
 			"license": "MIT",
 			"optionalDependencies": {
-				"@bastani/atomic-natives-darwin-arm64": "0.9.47",
-				"@bastani/atomic-natives-darwin-x64": "0.9.47",
-				"@bastani/atomic-natives-linux-arm64-gnu": "0.9.47",
-				"@bastani/atomic-natives-linux-arm64-musl": "0.9.47",
-				"@bastani/atomic-natives-linux-x64-gnu": "0.9.47",
-				"@bastani/atomic-natives-linux-x64-musl": "0.9.47",
-				"@bastani/atomic-natives-win32-arm64-msvc": "0.9.47",
-				"@bastani/atomic-natives-win32-x64-msvc": "0.9.47"
+				"@bastani/atomic-natives-darwin-arm64": "0.9.48-alpha.1",
+				"@bastani/atomic-natives-darwin-x64": "0.9.48-alpha.1",
+				"@bastani/atomic-natives-linux-arm64-gnu": "0.9.48-alpha.1",
+				"@bastani/atomic-natives-linux-arm64-musl": "0.9.48-alpha.1",
+				"@bastani/atomic-natives-linux-x64-gnu": "0.9.48-alpha.1",
+				"@bastani/atomic-natives-linux-x64-musl": "0.9.48-alpha.1",
+				"@bastani/atomic-natives-win32-arm64-msvc": "0.9.48-alpha.1",
+				"@bastani/atomic-natives-win32-x64-msvc": "0.9.48-alpha.1"
 			},
 			"engines": {
 				"bun": ">=1.4.2",
@@ -446,8 +446,8 @@
 			}
 		},
 		"node_modules/@bastani/atomic-natives-darwin-arm64": {
-			"version": "0.9.47",
-			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-darwin-arm64/-/atomic-natives-darwin-arm64-0.9.47.tgz",
+			"version": "0.9.48-alpha.1",
+			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-darwin-arm64/-/atomic-natives-darwin-arm64-0.9.48-alpha.1.tgz",
 			"license": "MIT",
 			"os": [
 				"darwin"
@@ -458,8 +458,8 @@
 			"optional": true
 		},
 		"node_modules/@bastani/atomic-natives-darwin-x64": {
-			"version": "0.9.47",
-			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-darwin-x64/-/atomic-natives-darwin-x64-0.9.47.tgz",
+			"version": "0.9.48-alpha.1",
+			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-darwin-x64/-/atomic-natives-darwin-x64-0.9.48-alpha.1.tgz",
 			"license": "MIT",
 			"os": [
 				"darwin"
@@ -470,8 +470,8 @@
 			"optional": true
 		},
 		"node_modules/@bastani/atomic-natives-linux-arm64-gnu": {
-			"version": "0.9.47",
-			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-linux-arm64-gnu/-/atomic-natives-linux-arm64-gnu-0.9.47.tgz",
+			"version": "0.9.48-alpha.1",
+			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-linux-arm64-gnu/-/atomic-natives-linux-arm64-gnu-0.9.48-alpha.1.tgz",
 			"license": "MIT",
 			"os": [
 				"linux"
@@ -485,8 +485,8 @@
 			"optional": true
 		},
 		"node_modules/@bastani/atomic-natives-linux-arm64-musl": {
-			"version": "0.9.47",
-			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-linux-arm64-musl/-/atomic-natives-linux-arm64-musl-0.9.47.tgz",
+			"version": "0.9.48-alpha.1",
+			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-linux-arm64-musl/-/atomic-natives-linux-arm64-musl-0.9.48-alpha.1.tgz",
 			"license": "MIT",
 			"os": [
 				"linux"
@@ -500,8 +500,8 @@
 			"optional": true
 		},
 		"node_modules/@bastani/atomic-natives-linux-x64-gnu": {
-			"version": "0.9.47",
-			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-linux-x64-gnu/-/atomic-natives-linux-x64-gnu-0.9.47.tgz",
+			"version": "0.9.48-alpha.1",
+			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-linux-x64-gnu/-/atomic-natives-linux-x64-gnu-0.9.48-alpha.1.tgz",
 			"license": "MIT",
 			"os": [
 				"linux"
@@ -515,8 +515,8 @@
 			"optional": true
 		},
 		"node_modules/@bastani/atomic-natives-linux-x64-musl": {
-			"version": "0.9.47",
-			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-linux-x64-musl/-/atomic-natives-linux-x64-musl-0.9.47.tgz",
+			"version": "0.9.48-alpha.1",
+			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-linux-x64-musl/-/atomic-natives-linux-x64-musl-0.9.48-alpha.1.tgz",
 			"license": "MIT",
 			"os": [
 				"linux"
@@ -530,8 +530,8 @@
 			"optional": true
 		},
 		"node_modules/@bastani/atomic-natives-win32-arm64-msvc": {
-			"version": "0.9.47",
-			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-win32-arm64-msvc/-/atomic-natives-win32-arm64-msvc-0.9.47.tgz",
+			"version": "0.9.48-alpha.1",
+			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-win32-arm64-msvc/-/atomic-natives-win32-arm64-msvc-0.9.48-alpha.1.tgz",
 			"license": "MIT",
 			"os": [
 				"win32"
@@ -542,8 +542,8 @@
 			"optional": true
 		},
 		"node_modules/@bastani/atomic-natives-win32-x64-msvc": {
-			"version": "0.9.47",
-			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-win32-x64-msvc/-/atomic-natives-win32-x64-msvc-0.9.47.tgz",
+			"version": "0.9.48-alpha.1",
+			"resolved": "https://registry.npmjs.org/@bastani/atomic-natives-win32-x64-msvc/-/atomic-natives-win32-x64-msvc-0.9.48-alpha.1.tgz",
 			"license": "MIT",
 			"os": [
 				"win32"
@@ -554,8 +554,8 @@
 			"optional": true
 		},
 		"node_modules/@bastani/pi-ai": {
-			"version": "0.9.47",
-			"resolved": "https://registry.npmjs.org/@bastani/pi-ai/-/pi-ai-0.9.47.tgz",
+			"version": "0.9.48-alpha.1",
+			"resolved": "https://registry.npmjs.org/@bastani/pi-ai/-/pi-ai-0.9.48-alpha.1.tgz",
 			"license": "MIT",
 			"dependencies": {
 				"@anthropic-ai/sdk": "0.129.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/atomic",
-  "version": "0.9.47",
+  "version": "0.9.48-alpha.1",
   "description": "Atomic coding agent CLI with read, bash, edit, write tools and session management",
   "type": "module",
   "atomicConfig": {
@@ -89,8 +89,8 @@
     "prepublishOnly": "bun run clean && bun run build && bun run shrinkwrap"
   },
   "dependencies": {
-    "@bastani/atomic-natives": "0.9.47",
-    "@bastani/pi-ai": "0.9.47",
+    "@bastani/atomic-natives": "0.9.48-alpha.1",
+    "@bastani/pi-ai": "0.9.48-alpha.1",
     "@earendil-works/pi-agent-core": "1.4.0",
     "@earendil-works/pi-codemode": "1.4.0",
     "@earendil-works/pi-tui": "1.4.0",