@cr1ms0n/pi-subagent 0.8.1 → 0.8.2

package/CHANGELOG.md

@@ -12,7 +12,15 @@
 The entries below are retained upstream history from @parke.dev/pi-subagent.
 
 
-## Unreleased
+## 0.8.2 — 2026-09-10
+
+### Background completion delivery
+
+- Automatic terminal notifications for `async: true` runs now use Pi's `steer`
+  delivery queue with `triggerTurn: true`, making completion messages available
+  before the parent's next LLM call. Foreground runs, explicit management
+  actions, message content, batching, persistence, and usage accounting are
+  unchanged.
 
 ### Machine-wide worktree GC
 

package/docs/UI-OVERHAUL.md

@@ -5,9 +5,9 @@
 > the plan: the inline spinner uses a wall-clock frame (Pi's working indicator
 > drives repaints, so no timer is owned); the ledger command landed as
 > `/subagent-cost` via `ctx.ui.notify`. Phase 4 shipped as the background-only
-> ambient widget plus batched `followUp` completion notifications with
-> flush-time wait-suppression (see docs/UX.md). The `description` param is the
-> task label across all surfaces. This document is retained as design rationale.
+> ambient widget plus batched `steer` completion notifications with flush-time
+> wait-suppression (see docs/UX.md). The `description` param is the task label
+> across all surfaces. This document is retained as design rationale.
 
 Goal: remove the duplicated cost footer, make inline chat rendering clean and
 smooth, and align every surface with Pi's native conventions. Informed by a
@@ -137,7 +137,7 @@ Files: `src/extension.ts`, new `src/notifications.ts`.
   ```
 
   Cleared when no background runs. Config: `widget: "background" | "off"`.
-- **Completion notifications** via `pi.sendMessage(…, { deliverAs: "followUp",
+- **Completion notifications** via `pi.sendMessage(…, { deliverAs: "steer",
   triggerTurn: true })` + `registerMessageRenderer`: themed compact box for the
   human (state, stats, first-line preview, artifact/session pointers),
   structured payload for the model. Replaces the bare `ctx.ui.notify` toast.

package/docs/UX.md

@@ -66,11 +66,11 @@ Cleared when the last background run settles. Spinner and elapsed animate on
 a 250ms interval that exists only while background runs are live.
 
 ### Completion notifications (background runs only)
-When an async run reaches a terminal state, a `followUp` message (custom type
-`subagent-completion`) notifies the parent LLM so it reacts without polling.
-The human sees a themed compact box (state glyph, label, stats, one-line
-preview, artifact pointers); the LLM sees plain text with run ids and a
-`wait { id }` pointer.
+When an async run reaches a terminal state, a `steer` message (custom type
+`subagent-completion`) is queued for the parent LLM before its next LLM call,
+so it can react without polling. The human sees a themed compact box (state
+glyph, label, stats, one-line preview, artifact pointers); the LLM sees plain
+text with run ids and a `wait { id }` pointer.
 
 - Successes within a short window batch into one message (no fanout spam);
   failures bypass batching and flush immediately, carrying held successes.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cr1ms0n/pi-subagent",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "Community fork of Luke Parke's pi-subagent with explicit model policy and model visibility for Pi",
   "type": "module",
   "license": "MIT",

package/src/config.ts

@@ -83,7 +83,7 @@ export interface SubagentConfig {
    */
   widget: WidgetMode;
   /**
-   * Batched completion followUp messages for async runs. `"off"` disables the
+   * Batched completion messages for async runs. `"off"` disables the
    * CompletionBatcher so the parent is not notified on finish.
    */
   notifications: NotificationMode;

package/src/extension.ts

@@ -763,7 +763,7 @@ export default function registerSubagent(pi: ExtensionAPI): void {
     runtime.unsubscribeLedger = runtime.registry.subscribe((event) => {
       if (event.sessionKey === runtime.key) runtime.ledgerDirty = true;
     });
-    // Background-run completion notifications: batched followUp messages so
+    // Background-run completion notifications: batched steer messages so
     // the parent LLM reacts without polling. Foreground runs deliver inline.
     // `notifications: "off"` skips construction; subscribe still uses optional chain.
     if (runtime.config.notifications !== "off") {
@@ -806,7 +806,7 @@ export default function registerSubagent(pi: ExtensionAPI): void {
           ].join("\n"),
           display: true,
           details,
-        }, { deliverAs: "followUp", triggerTurn: true });
+        }, { deliverAs: "steer", triggerTurn: true });
       });
     }
 

package/src/notifications.ts

@@ -2,8 +2,8 @@
  * Background-run completion notifications.
  *
  * When an async run reaches a terminal state, the parent LLM is notified with
- * a followUp message (delivered when the agent is idle / between turns) so it
- * can react without polling status/wait. Matches the notification-as-delivery
+ * a steer message (queued for delivery before the next LLM call) so it can
+ * react without polling status/wait. Matches the notification-as-delivery
  * semantics of `wait`: whichever path delivers first wins via markDelivered.
  *
  * Batching: successes completing within a short window group into a single