@aeondave/pi-persona 1.16.0 → 1.16.1

package/AGENTS.md

@@ -198,6 +198,8 @@ the shared behavioral prompt layer: [`docs/SPINE.md`](docs/SPINE.md).
 
 ## Testing
 
+- Offline SDK harnesses must await `session_shutdown` before SDK `dispose()` and temporary-profile
+  deletion. `dispose()` disconnects SDK listeners; it does not join extension-owned writers.
 - TDD: write the failing test first for `core/*` and any behavior change; watch it fail, then fix.
 - Done = `npm run typecheck` clean **and** full suite green. The suite has **two** intentional skips,
   both Windows-only — the runner reports `skipped 2` on Windows and `skipped 0` elsewhere (see

package/CHANGELOG.md

@@ -6,6 +6,21 @@ used in its [GitHub releases](https://github.com/AeonDave/pi-persona/releases).
 
 ## [Unreleased]
 
+## [1.16.1](https://github.com/AeonDave/pi-persona/releases/tag/v1.16.1) - 2026-10-06
+
+### Fixed
+
+- Publish the real pending-supervisor-ask state as `agent.updated` telemetry for Flow. Refresh it on
+  ask delivery and reply/timeout/cancellation settlement, without duplicate events or text-based
+  guesses; queued and terminal state remain authoritative.
+- Make the native offline codemode harness await extension shutdown before deleting its temporary
+  profile; SDK `dispose()` alone does not flush the extension's telemetry writer.
+
+### Packaging
+
+- Add the npm author and focused Pi gallery keywords; align the banner preview and pinned install
+  examples with this release.
+
 ## [1.16.0](https://github.com/AeonDave/pi-persona/releases/tag/v1.16.0) - 2026-10-03
 
 ### Compatibility

package/README.md

@@ -39,9 +39,9 @@ your customizations.
 | Install option | Command |
 |---|---|
 | This project only | `pi install -l npm:@aeondave/pi-persona` |
-| Pin this release | `pi install npm:@aeondave/pi-persona@1.16.0` |
+| Pin this release | `pi install npm:@aeondave/pi-persona@1.16.1` |
 | Update an unpinned install | `pi update npm:@aeondave/pi-persona` |
-| Git alternative | `pi install git:github.com/AeonDave/pi-persona@v1.16.0` |
+| Git alternative | `pi install git:github.com/AeonDave/pi-persona@v1.16.1` |
 
 Restart Pi after updating. For a pinned install, install the new version or tag explicitly.
 If switching from a Git install, remove that source first with

package/docs/TELEMETRY.md

@@ -1,5 +1,11 @@
 # Telemetry wire contract
 
+Agent `waiting` is an explicit projection of a pending supervisor ask, read through the live
+engine steer handle. Ask delivery and settlement (reply, timeout or cancellation) refresh the
+projection; overlapping asks keep it waiting until the last one settles. Queued and terminal
+statuses retain precedence. The producer deduplicates unchanged projections and never infers
+waiting from tool arguments, output text or a quiet clock.
+
 Telemetry is a vendor-neutral v2 envelope. `producerId` and `producerVersion` identify the emitting plugin; `version` identifies the wire schema. `seq` is monotonic only within `(producerId, sessionId)`, and `id` is deduplicated within that same scope.
 
 The pi-persona producer writes semantic projections under `telemetry/v2/<workspace>/<producerId>/`. `<workspace>` always identifies the Pi process's actual cwd; joining another Exocom scope does not rewrite telemetry identity. It never persists task/prompt text, tool arguments/activity, model output, paths, secrets, or message bodies. Known pi-persona event payloads are allowlisted; an unreviewed producer event retains only its envelope/type (payload `{}`) at the producer and consumer boundary. Future producers must add a reviewed allowlist/schema before publishing data intended for a consumer.

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@aeondave/pi-persona",
-  "version": "1.16.0",
+  "version": "1.16.1",
   "private": false,
   "type": "module",
   "description": "Supervised multi-agent orchestration for Pi — async workers, live steering, cross-session collaboration, and switchable personas.",
+  "author": "AeonDave",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/AeonDave/pi-persona.git"
@@ -18,12 +19,16 @@
   "keywords": [
     "pi-package",
     "pi-extension",
+    "pi-coding-agent",
     "pi",
-    "persona",
     "subagents",
     "orchestration",
     "multi-agent",
-    "supervisor"
+    "supervisor",
+    "async-agents",
+    "live-steering",
+    "cross-session",
+    "persona"
   ],
   "license": "MIT",
   "files": [
@@ -99,7 +104,7 @@
     "typescript": "^7.0.2"
   },
   "pi": {
-    "image": "https://raw.githubusercontent.com/AeonDave/pi-persona/v1.16.0/assets/banner.png",
+    "image": "https://raw.githubusercontent.com/AeonDave/pi-persona/v1.16.1/assets/banner.png",
     "video": "https://cdn.jsdelivr.net/gh/AeonDave/pi-persona@6655d281ce7965a75303dd704bd29db73db04070/assets/demo1.mp4",
     "extensions": [
       "./src/extension.ts"

package/src/extension.ts

@@ -535,6 +535,8 @@ export default function piPersona(pi: ExtensionAPI, options: PiPersonaOptions =
 	// left hanging when Pi resolves a call as "immediate" and never reaches a result.
 	type PendingIntercomTelemetry = { kind: string; to: string; size: number; replyTo?: string };
 	const telemetryIntercomPending = new Map<string, PendingIntercomTelemetry>();
+	// node id → steer that one agent (in-process engine only): inject a live user message.
+	const steerRegistry = new Map<string, SteerFn>();
 	function telemetryKind(node: AgentNode): TelemetryAgentKind {
 		if (node.kind) return node.kind;
 		if (node.id.startsWith("flow:")) return "flow";
@@ -547,9 +549,10 @@ export default function piPersona(pi: ExtensionAPI, options: PiPersonaOptions =
 		// "queued" is a marker WE set (the seeded roster / a launched async run), so it is a real
 		// state. Nothing ever sets `detail` to a waiting state — it is a usage string, an error, or
 		// `toolActivity(name, args)`, which splices the tool's own argument text — so a substring
-		// test for "waiting" could only ever fire on a leg that is running normally.
+		// test for "waiting" could only ever fire on a leg that is running normally. A live in-process
+		// steer handle has the authoritative bus predicate for a supervisor ask.
 		if (isQueuedMarker(node.detail)) return "queued";
-		return "running";
+		return steerRegistry.get(node.id)?.isWaitingForSupervisor?.() === true ? "waiting" : "running";
 	}
 	function telemetryAgent(node: AgentNode): TelemetryAgentInput {
 		return {
@@ -585,6 +588,22 @@ export default function piPersona(pi: ExtensionAPI, options: PiPersonaOptions =
 	// unfiltered publish appends one byte-identical duplicate per chunk: a 5k-chunk leg writes
 	// ~1.5MB of them and evicts genuine history from the producer's file budget.
 	const lastAgentProjection = new Map<string, string>();
+	function publishAgentProjection(node: AgentNode): void {
+		const producer = telemetry;
+		if (!producer) return;
+		const agent = telemetryAgent(node);
+		const projection = JSON.stringify(agent);
+		if (lastAgentProjection.get(node.id) === projection) return;
+		lastAgentProjection.set(node.id, projection);
+		producer.publishAgentUpdated(node.id, agent);
+	}
+	function refreshSteeredAgentTelemetry(): void {
+		if (!telemetry || steerRegistry.size === 0) return;
+		const steeredIds = new Set(steerRegistry.keys());
+		for (const node of agentTree.snapshot()) {
+			if (steeredIds.has(node.id)) publishAgentProjection(node);
+		}
+	}
 	function publishAgentTreeChange(change: AgentTreeChange): void {
 		const producer = telemetry;
 		if (!producer) return;
@@ -594,10 +613,7 @@ export default function piPersona(pi: ExtensionAPI, options: PiPersonaOptions =
 			return;
 		}
 		if (change.type === "updated") {
-			const projection = JSON.stringify(telemetryAgent(change.node));
-			if (lastAgentProjection.get(change.node.id) === projection) return;
-			lastAgentProjection.set(change.node.id, projection);
-			producer.publishAgentUpdated(change.node.id, telemetryAgent(change.node));
+			publishAgentProjection(change.node);
 			return;
 		}
 		if (change.type === "removed") {
@@ -644,8 +660,6 @@ export default function piPersona(pi: ExtensionAPI, options: PiPersonaOptions =
 		return true;
 	}
 
-	// node id → steer that one agent (in-process engine only): inject a live user message.
-	const steerRegistry = new Map<string, SteerFn>();
 	function waitingTreeIds(nodes: readonly AgentNode[] = agentTree.snapshot()): Set<string> {
 		return deriveWaitingNodeIds(nodes, (id) => steerRegistry.get(id)?.isWaitingForSupervisor?.() === true);
 	}
@@ -1063,6 +1077,7 @@ export default function piPersona(pi: ExtensionAPI, options: PiPersonaOptions =
 	bus.onAskSettled(({ id }) => {
 		intercomNotifier.discard((ask) => ask.askId === id);
 		telemetryAskSenders.delete(id);
+		if (!disposed) refreshSteeredAgentTelemetry();
 	});
 	// Supervisor-armable alarms: when a timer expires it WAKES the session by routing the fire
 	// through the same idle-delivery path (an idle delivery starts a fresh turn, so the supervisor
@@ -1144,6 +1159,7 @@ export default function piPersona(pi: ExtensionAPI, options: PiPersonaOptions =
 			expectsReply: env.expectsReply,
 			size: Buffer.byteLength(env.text, "utf8"),
 		});
+		if (!disposed && env.expectsReply) refreshSteeredAgentTelemetry();
 		if (disposed || env.to !== SUPERVISOR || !env.expectsReply) return;
 		// Only an ask can be replied to, so only an ask needs its sender remembered. Oldest first
 		// out: a long session must not grow this without bound.

package/src/telemetry/contract.ts

@@ -4,7 +4,7 @@ export const TELEMETRY_EVENT_NAME = "pi:telemetry" as const;
 export const LEGACY_TELEMETRY_EVENT_NAME = "pi-persona:telemetry" as const;
 export const LEGACY_TELEMETRY_VERSION = 1 as const;
 export const TELEMETRY_PRODUCER_ID = "pi-persona" as const;
-export const TELEMETRY_PRODUCER_VERSION = "1.16.0" as const;
+export const TELEMETRY_PRODUCER_VERSION = "1.16.1" as const;
 
 export type InstanceStatus = "active" | "idle" | "stopped" | "stale" | (string & {});
 export type AgentKind = "subagent" | "delegate" | "council" | "flow" | "phase" | (string & {});