agents-pod 0.3.4 → 0.3.5

package/CHANGELOG.md

@@ -4,7 +4,19 @@ All notable changes to agents-pod. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.3.5] — 2026-11-04
+
+### Fixed
+
+- **A reload no longer leaves the extension inert** (issue #28). `/reload`,
+  `/new`, `/resume` and `/fork` replace the whole extension runtime: Pi
+  re-imports the module in the same process and rebuilds every command and tool
+  registry from scratch, while `globalThis` — and with it the `Symbol.for` guard
+  that keeps a second installed copy inert — survives. The reloaded copy saw a
+  claimed process, returned early, and `/pod`, `spawn_pod` and `pod_handoff`
+  vanished until Pi restarted. The guard is now released on `session_shutdown`,
+  so it claims a runtime instead of a process; a second copy in one runtime is
+  still kept out (ADR 0010).
 
 ## [0.3.4] — 2026-11-04
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-pod",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "Supervision for long-running coding agents: detached pods, heartbeat liveness, cron-ticked reconcile, and a Pi extension for spawning and handoff",
   "license": "AGPL-3.0-or-later",
   "type": "module",

package/src/extension/index.ts

@@ -12,7 +12,7 @@ import { registerSelf } from "./self.ts";
 export const POD_ID_ENV = "AGENTS_POD_POD_ID";
 
 /**
- * Set by whichever copy of this extension loads first in a process. `pi
+ * Set by whichever copy of this extension loads first in a runtime. `pi
  * install` and a project-local install can both resolve here, and pi would
  * then load two copies that fight over the same tool and command names;
  * `Symbol.for` is shared across module instances, so the second copy sees the
@@ -22,6 +22,20 @@ const LOADED_FLAG = Symbol.for("agents-pod.extension.loaded");
 
 export default function (pi: ExtensionAPI): void {
   const scope = globalThis as Record<symbol, boolean>;
+
+  // `/reload`, `/new`, `/resume` and `/fork` replace the whole extension
+  // runtime: pi re-imports this module in the same process (jiti runs with
+  // `moduleCache: false`) and rebuilds every extension's command and tool
+  // registry from scratch. globalThis survives that re-import while the
+  // registrations do not, so a flag left set would make the replacement copy
+  // load inert and /pod, spawn_pod and pod_handoff would vanish until the
+  // process restarts. Every runtime replacement is preceded by a
+  // `session_shutdown`, so clearing there keeps the flag meaning "claimed by
+  // this runtime" instead of "claimed by this process".
+  pi.on("session_shutdown", () => {
+    delete scope[LOADED_FLAG];
+  });
+
   if (scope[LOADED_FLAG]) return;
   scope[LOADED_FLAG] = true;