@herbertgao/pi-subagents 0.16.0 → 0.16.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.16.1
+
+### Patch Changes
+
+- [#116](https://github.com/HerbertGao/pi-extensions/pull/116) [`ecda398`](https://github.com/HerbertGao/pi-extensions/commit/ecda398b9a95212c512d53325c617e485e6ded8d) Thanks [@HerbertGao](https://github.com/HerbertGao)! - Port Ctrl+C conversation-viewer dismissal and cross-extension consumption of settled subagent results while preserving local spawn and ownership safeguards.
+
 ## 0.16.0
 
 ### Minor Changes
@@ -49,6 +55,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Fixed
 
+- **Ctrl+C closes the conversation viewer** when it is not composing a steering message.
+- **Cross-extension callers can consume settled RPC-spawned results** with `subagents:rpc:consume`, suppressing a duplicate completion notification after another extension has already shown the result.
 - **One malformed agent file no longer aborts extension activation** ([#212](https://github.com/tintinweb/pi-subagents/issues/212) — thanks [@daromaj](https://github.com/daromaj)). Unreadable and unparseable files are skipped with a path-specific warning, including the earlier source that remains active when a broken file was an override.
 
 ## [0.15.1] - 2026-08-10

package/README.md

@@ -32,7 +32,7 @@ Spawn specialized agents that run in isolated sessions — each with its own too
 - **Tool denylist** — block specific tools via `disallowed_tools` frontmatter
 - **Styled completion notifications** — background agent results render as themed, compact notification boxes (icon, stats, result preview) instead of raw XML. Expandable to show full output. Group completions render each agent individually
 - **Event bus** — lifecycle events (`subagents:created`, `started`, `completed`, `failed`, `steered`, `compacted`) emitted via `pi.events`, enabling other extensions to react to sub-agent activity
-- **Cross-extension RPC** — other pi extensions can spawn and stop subagents via the `pi.events` event bus (`subagents:rpc:ping`, `subagents:rpc:spawn`, `subagents:rpc:stop`). Standardized reply envelopes with protocol versioning. Emits `subagents:ready` on session start
+- **Cross-extension RPC** — other pi extensions can spawn, stop, and consume subagent results via the `pi.events` event bus (`subagents:rpc:ping`, `subagents:rpc:spawn`, `subagents:rpc:stop`, `subagents:rpc:consume`). Standardized reply envelopes with protocol versioning. Emits `subagents:ready` on session start
 - **Schedule subagents** — pass `schedule` to the `Agent` tool to fire on cron / interval / one-shot. Session-scoped jobs with PID-locked persistence; results land via the same `subagent-notification` followUp path as manual background completions; manage via `/agents → Scheduled jobs`
 - **Model scope enforcement** — opt-in validation that subagent model choices stay within your pi `enabledModels` allowlist (sourced from `/scoped-models`, with both global and project-local pi settings honored). Caller-supplied out-of-scope → hard error to orchestrator; frontmatter-pinned out-of-scope → warning + runs anyway (frontmatter authoritative). Toggle via `/agents → Settings → Scope models`
 
@@ -520,7 +520,7 @@ Listen for `subagents:ready` to know when RPC handlers are available:
 
 ```typescript
 pi.events.on("subagents:ready", () => {
-  // RPC handlers are registered — safe to call ping/spawn/stop
+  // RPC handlers are registered — safe to call ping/spawn/stop/consume
 })
 ```
 
@@ -581,6 +581,19 @@ const unsub = pi.events.on(`subagents:rpc:stop:reply:${requestId}`, (reply) => {
 pi.events.emit("subagents:rpc:stop", { requestId, agentId: "agent-id-here" })
 ```
 
+### Consume
+
+Mark a settled agent result as already shown so its completion notification is suppressed:
+
+```typescript
+pi.events.emit("subagents:rpc:consume", {
+  requestId: crypto.randomUUID(),
+  agentId: "agent-id-here",
+})
+```
+
+This is the event-bus equivalent of `get_subagent_result` consuming a result. Running, queued, unknown, and nested agents are refused; the channel is additive and remains outside the protocol-version handshake.
+
 Reply channels are scoped per `requestId`, so concurrent requests don't interfere.
 
 ## Persistent Agent Memory
@@ -677,7 +690,7 @@ src/
   agent-color.ts      # Claude Code/Agency Agents name color parsing and badge rendering
   agent-runner.ts     # Session creation, execution, graceful max_turns, steer/resume
   agent-manager.ts    # Agent lifecycle, concurrency queue, completion notifications
-  cross-extension-rpc.ts # RPC handlers for cross-extension spawn/ping via pi.events
+  cross-extension-rpc.ts # RPC handlers for cross-extension spawn/stop/consume via pi.events
   group-join.ts       # Group join manager: batched completion notifications with timeout
   custom-agents.ts    # Load user-defined agents from .pi/agents/, .agents/agents/, and global agents
   memory.ts           # Persistent agent memory (resolve, read, build prompt blocks)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herbertgao/pi-subagents",
-  "version": "0.16.0",
+  "version": "0.16.1",
   "description": "Claude Code-style autonomous subagents for Pi, with HerbertGao-maintained UI extensions.",
   "keywords": [
     "agent",

package/src/cross-extension-rpc.ts

@@ -1,7 +1,7 @@
 /**
  * Cross-extension RPC handlers for the subagents extension.
  *
- * Exposes ping, spawn, and stop RPCs over the pi.events event bus,
+ * Exposes ping, spawn, stop, and consume RPCs over the pi.events event bus,
  * using per-request scoped reply channels.
  *
  * Reply envelope follows pi-mono convention:
@@ -25,7 +25,7 @@ export type RpcReply<T = void> =
 /** RPC protocol version — bumped when the envelope or method contracts change. */
 export const PROTOCOL_VERSION = 2
 
-/** Minimal AgentManager interface needed by the spawn/stop RPCs. */
+/** Minimal AgentManager interface needed by the spawn/stop/consume RPCs. */
 export interface SpawnCapable {
   spawn(
     pi: unknown,
@@ -35,6 +35,7 @@ export interface SpawnCapable {
     options: any,
   ): string
   abort(id: string): boolean
+  consumeResult(id: string): boolean
 }
 
 export interface RpcDeps {
@@ -48,6 +49,7 @@ export interface RpcHandle {
   unsubPing: () => void
   unsubSpawn: () => void
   unsubStop: () => void
+  unsubConsume: () => void
 }
 
 /**
@@ -76,7 +78,7 @@ function handleRpc<P extends { requestId: string }>(
 }
 
 /**
- * Register ping, spawn, and stop RPC handlers on the event bus.
+ * Register ping, spawn, stop, and consume RPC handlers on the event bus.
  * Returns unsub functions for cleanup.
  */
 export function registerRpcHandlers(deps: RpcDeps): RpcHandle {
@@ -130,5 +132,14 @@ export function registerRpcHandlers(deps: RpcDeps): RpcHandle {
     },
   )
 
-  return { unsubPing, unsubSpawn, unsubStop }
+  const unsubConsume = handleRpc<{
+    requestId: string
+    agentId: string
+  }>(events, "subagents:rpc:consume", ({ agentId }) => {
+    if (!manager.consumeResult(agentId)) {
+      throw new Error("Agent not found or still running")
+    }
+  })
+
+  return { unsubPing, unsubSpawn, unsubStop, unsubConsume }
 }

package/src/index.ts

@@ -890,6 +890,20 @@ export default function (pi: ExtensionAPI) {
             const record = manager.getRecord(id)
             return !record?.parentAgentId && manager.abort(id)
           },
+          consumeResult: (id) => {
+            const record = manager.getRecord(id)
+            if (
+              !record ||
+              record.parentAgentId ||
+              record.status === "running" ||
+              record.status === "queued"
+            ) {
+              return false
+            }
+            record.resultConsumed = true
+            cancelNudge(record.id)
+            return true
+          },
         },
       })
       // Broadcast readiness so extensions loaded alongside us can discover us.
@@ -911,6 +925,7 @@ export default function (pi: ExtensionAPI) {
     rpcHandle?.unsubSpawn()
     rpcHandle?.unsubStop()
     rpcHandle?.unsubPing()
+    rpcHandle?.unsubConsume()
     rpcHandle = undefined
     currentCtx = undefined
     // Only release the global slot if this activation claimed it — a child
@@ -1068,6 +1083,7 @@ export default function (pi: ExtensionAPI) {
   // Grab UI context from first tool execution + clear lingering widget on new turn
   pi.on("tool_execution_start", async (_event, ctx) => {
     widget.setUICtx(ctx.ui as UICtx)
+    // SAFETY: both UI adapters receive the same Pi ExtensionContext UI surface.
     fleet.setUICtx(ctx.ui as unknown as FleetUICtx)
     widget.onTurnStart()
   })

package/src/ui/conversation-viewer.ts

@@ -94,7 +94,11 @@ export class ConversationViewer implements Component {
       return
     }
 
-    if (matchesKey(data, "escape") || matchesKey(data, "q")) {
+    if (
+      matchesKey(data, "escape") ||
+      matchesKey(data, "ctrl+c") ||
+      matchesKey(data, "q")
+    ) {
       this.closed = true
       this.done(undefined)
       return