@pi-unipi/unipi 2.1.2 → 2.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -24,7 +24,7 @@
   ],
   "scripts": {
     "typecheck": "npx tsc --noEmit --skipLibCheck",
-    "test": "node --test tests/*.test.js && npm test --workspaces --if-present",
+    "test": "npx tsx --test tests/*.test.js && npm test --workspaces --if-present",
     "publish:all": "npm publish --workspaces --access public"
   },
   "files": [
@@ -65,26 +65,26 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/ask-user": "2.1.2",
-    "@pi-unipi/btw": "2.1.2",
-    "@pi-unipi/compactor": "2.1.2",
-    "@pi-unipi/notify": "2.1.2",
-    "@pi-unipi/command-enchantment": "2.1.2",
-    "@pi-unipi/core": "2.1.2",
-    "@pi-unipi/info-screen": "2.1.2",
-    "@pi-unipi/mcp": "2.1.2",
-    "@pi-unipi/memory": "2.1.2",
-    "@pi-unipi/ralph": "2.1.2",
-    "@pi-unipi/subagents": "2.1.2",
-    "@pi-unipi/utility": "2.1.2",
-    "@pi-unipi/milestone": "2.1.2",
-    "@pi-unipi/kanboard": "2.1.2",
-    "@pi-unipi/web-api": "2.1.2",
-    "@pi-unipi/workflow": "2.1.2",
-    "@pi-unipi/footer": "2.1.2",
-    "@pi-unipi/updater": "2.1.2",
-    "@pi-unipi/input-shortcuts": "2.1.2",
-    "@pi-unipi/cocoindex": "2.1.2"
+    "@pi-unipi/ask-user": "2.1.3",
+    "@pi-unipi/btw": "2.1.3",
+    "@pi-unipi/compactor": "2.1.3",
+    "@pi-unipi/notify": "2.1.3",
+    "@pi-unipi/command-enchantment": "2.1.3",
+    "@pi-unipi/core": "2.1.3",
+    "@pi-unipi/info-screen": "2.1.3",
+    "@pi-unipi/mcp": "2.1.3",
+    "@pi-unipi/memory": "2.1.3",
+    "@pi-unipi/ralph": "2.1.3",
+    "@pi-unipi/subagents": "2.1.3",
+    "@pi-unipi/utility": "2.1.3",
+    "@pi-unipi/milestone": "2.1.3",
+    "@pi-unipi/kanboard": "2.1.3",
+    "@pi-unipi/web-api": "2.1.3",
+    "@pi-unipi/workflow": "2.1.3",
+    "@pi-unipi/footer": "2.1.3",
+    "@pi-unipi/updater": "2.1.3",
+    "@pi-unipi/input-shortcuts": "2.1.3",
+    "@pi-unipi/cocoindex": "2.1.3"
   },
   "devDependencies": {
     "@earendil-works/pi-agent-core": "^0.80.0",

package/packages/ask-user/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ask-user",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "description": "Structured user input tool for Pi coding agent — single-select, multi-select, freeform",
   "type": "module",
   "main": "index.ts",
@@ -34,13 +34,13 @@
     "README.md"
   ],
   "scripts": {
-    "test": "node --experimental-strip-types --test tests/**/*.test.ts"
+    "test": "npx tsx --test tests/**/*.test.ts"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.1.2"
+    "@pi-unipi/core": "2.1.3"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/autocomplete/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/command-enchantment",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "description": "Enhanced TUI autocomplete for /unipi:* commands — colored, sorted, and grouped by package",
   "type": "module",
   "main": "src/index.ts",

package/packages/btw/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/btw",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "description": "A pi extension for parallel side conversations with /unipi:btw — part of the Unipi suite",
   "type": "module",
   "main": "extensions/btw.ts",
@@ -37,7 +37,7 @@
     "@earendil-works/pi-tui": "^0.80.0"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.1.2"
+    "@pi-unipi/core": "2.1.3"
   },
   "pi": {
     "extensions": [],

package/packages/cocoindex/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/cocoindex",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "description": "CocoIndex integration for Pi — AST-aware content indexing, semantic vector search, and incremental pipeline management",
   "type": "module",
   "main": "index.ts",
@@ -25,7 +25,7 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.1.2"
+    "@pi-unipi/core": "2.1.3"
   },
   "optionalDependencies": {
     "@lancedb/lancedb": "^0.21.0"

package/packages/compactor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/compactor",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "description": "Context engine for Pi — zero-LLM compaction, session continuity, sandbox execution, and tool display optimization",
   "type": "module",
   "main": "src/index.ts",
@@ -22,7 +22,7 @@
     "fts5"
   ],
   "scripts": {
-    "test": "bun test tests"
+    "test": "npx bun test tests"
   },
   "files": [
     "index.ts",
@@ -34,8 +34,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.1.2",
-    "@pi-unipi/info-screen": "2.1.2",
+    "@pi-unipi/core": "2.1.3",
+    "@pi-unipi/info-screen": "2.1.3",
     "@earendil-works/pi-agent-core": "^0.80.0"
   },
   "peerDependencies": {

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/core",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "description": "Shared utilities, event types, and constants for Unipi extension suite",
   "type": "module",
   "license": "MIT",

package/packages/footer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/footer",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "description": "Persistent status bar for Unipi — subscribes to UNIPI_EVENTS and renders key stats from all unipi packages",
   "type": "module",
   "main": "src/index.ts",
@@ -26,13 +26,13 @@
     "README.md"
   ],
   "scripts": {
-    "test": "node --experimental-strip-types --test tests/**/*.test.ts"
+    "test": "npx tsx --test tests/**/*.test.ts"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.1.2"
+    "@pi-unipi/core": "2.1.3"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/info-screen/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/info-screen",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "description": "Dashboard and module registry for Unipi — configurable info overlay with tabbed groups",
   "type": "module",
   "main": "index.ts",
@@ -33,7 +33,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.1.2"
+    "@pi-unipi/core": "2.1.3"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/input-shortcuts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/input-shortcuts",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "description": "Keyboard shortcuts for stash/restore, undo/redo, clipboard, and thinking toggle — chord-based overlay system",
   "type": "module",
   "main": "src/index.ts",
@@ -27,13 +27,13 @@
     "README.md"
   ],
   "scripts": {
-    "test": "node --experimental-strip-types --test tests/**/*.test.ts"
+    "test": "npx tsx --test tests/**/*.test.ts"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.1.2"
+    "@pi-unipi/core": "2.1.3"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/kanboard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/kanboard",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "description": "Visualization layer for unipi workflow — HTTP server with htmx/Alpine.js UI, modular parsers, TUI overlay, and kanban board",
   "type": "module",
   "main": "index.ts",
@@ -39,7 +39,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.1.2"
+    "@pi-unipi/core": "2.1.3"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/mcp",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "description": "MCP server management extension for Pi coding agent — browse, add, configure, and use MCP servers",
   "type": "module",
   "main": "src/index.ts",
@@ -27,7 +27,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@pi-unipi/core": "2.1.2"
+    "@pi-unipi/core": "2.1.3"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/memory",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "description": "Persistent cross-session memory with MemPalace backend (auto-installed) and SQLite fallback for Pi coding agent",
   "type": "module",
   "main": "index.ts",
@@ -43,8 +43,8 @@
     "better-sqlite3": "^12.9.0",
     "sqlite-vec": "^0.1.9",
     "js-yaml": "^4.1.0",
-    "@pi-unipi/core": "2.1.2",
-    "@pi-unipi/info-screen": "2.1.2"
+    "@pi-unipi/core": "2.1.3",
+    "@pi-unipi/info-screen": "2.1.3"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/milestone/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/milestone",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "description": "Lifecycle layer for project-level goals — MILESTONES.md tracking, session hooks, auto-sync",
   "type": "module",
   "main": "index.ts",
@@ -29,7 +29,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.1.2"
+    "@pi-unipi/core": "2.1.3"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.80.0",

package/packages/notify/README.md

@@ -24,7 +24,8 @@ Notify subscribes to Pi lifecycle events and routes notifications based on your
 | `workflow_end` | On | Workflow command completes |
 | `ralph_loop_end` | On | Ralph loop completes |
 | `mcp_server_error` | On | MCP server error |
-| `agent_end` | Off | Agent finishes responding |
+| `agent_end` | Off | Low-level agent run ends (may fire again on retries) |
+| `agent_settled` | Off | Agent fully settles after retries, compaction, and queued continuations |
 | `memory_consolidated` | Off | Memory auto-saved |
 | `session_shutdown` | Off | Session ends |
 

package/packages/notify/events.ts

@@ -50,7 +50,8 @@ export const BUILTIN_EVENTS: Record<
   string,
   { hook: string; label: string }
 > = {
-  agent_end: { hook: "agent_end", label: "Agent Complete" },
+  agent_end: { hook: "agent_end", label: "Agent Run Complete" },
+  agent_settled: { hook: "agent_settled", label: "Agent Complete" },
   workflow_end: { hook: UNIPI_EVENTS.WORKFLOW_END, label: "Workflow Done" },
   ralph_loop_end: { hook: UNIPI_EVENTS.RALPH_LOOP_END, label: "Ralph Complete" },
   mcp_server_error: { hook: UNIPI_EVENTS.MCP_SERVER_ERROR, label: "MCP Error" },
@@ -63,7 +64,7 @@ export const BUILTIN_EVENTS: Record<
  * Pi lifecycle event types (dispatched by ExtensionRunner).
  * These must use pi.on() — not pi.events.on() — to receive events.
  */
-const LIFECYCLE_EVENTS = new Set(["agent_end", "session_shutdown"]);
+const LIFECYCLE_EVENTS = new Set(["agent_end", "agent_settled", "session_shutdown"]);
 
 /**
  * Register event listeners for all enabled notification events.
@@ -77,9 +78,9 @@ export function registerEventListeners(
   // Remove all previously registered EventBus listeners to prevent accumulation
   // across reloads (EventBus persists but module instances are replaced).
   unregisterAll();
-  // Register built-in events (except agent_end which has custom logic)
+  // Register built-in events (except agent lifecycle notifications which have custom logic)
   for (const [eventKey, def] of Object.entries(BUILTIN_EVENTS)) {
-    if (eventKey === "agent_end") continue; // handled separately below
+    if (isAgentNotificationEvent(eventKey)) continue; // handled separately below
 
     const eventConfig = config.events[eventKey];
     if (!eventConfig?.enabled) continue;
@@ -95,8 +96,8 @@ export function registerEventListeners(
       );
     };
 
-    // pi lifecycle events (agent_end, session_shutdown) are dispatched via
-    // ExtensionRunner — must use pi.on(). These are stored in
+    // Pi lifecycle events are dispatched via ExtensionRunner — must use
+    // pi.on(). These are stored in
     // extension.handlers and automatically replaced on reload, so they
     // do NOT accumulate like EventBus listeners.
     if (LIFECYCLE_EVENTS.has(eventKey)) {
@@ -120,55 +121,8 @@ export function registerEventListeners(
     }));
   }
 
-  // agent_end — custom handler with session name and recap support
-  const agentEndConfig = config.events["agent_end"];
-  if (agentEndConfig?.enabled) {
-    const handler = (payload: unknown) => {
-      // Fire-and-forget: build message and dispatch in background,
-      // don't block agent_end from completing
-      const sessionName = pi.getSessionName?.();
-      const title = `Pi — ${BUILTIN_EVENTS.agent_end.label}`;
-
-      if (config.recap.enabled) {
-        // Recap mode: summarize asynchronously, then dispatch
-        const lastText = extractLastAssistantText(payload);
-        if (lastText && sessionCtx?.modelRegistry) {
-          const provider = extractProvider(config.recap.model);
-          const modelId = extractModelId(config.recap.model);
-          const model = sessionCtx.modelRegistry.find(provider, modelId);
-          if (model) {
-            sessionCtx.modelRegistry.getApiKeyAndHeaders(model)
-              .then((apiKeyResult) => {
-                const apiKey = apiKeyResult.ok ? (apiKeyResult as { apiKey?: string }).apiKey : undefined;
-                if (apiKey) {
-                  return summarizeLastMessage(lastText, apiKey, model.baseUrl, model.api, modelId)
-                    .then((recap) => sessionName ? `${sessionName}: ${recap}` : recap);
-                }
-                return buildAgentEndMessage(sessionName);
-              })
-              .catch(() => buildAgentEndMessage(sessionName))
-              .then((message) =>
-                dispatchNotification(pi, title, message, agentEndConfig.platforms, "agent_end", config, cwd)
-              )
-              .catch(() => {
-                // Silently ignore — background agent_end notification failure is non-blocking.
-              });
-            return;
-          }
-        }
-      }
-
-      // No recap or recap unavailable: dispatch immediately in background
-      const message = buildAgentEndMessage(sessionName);
-      dispatchNotification(pi, title, message, agentEndConfig.platforms, "agent_end", config, cwd).catch(
-        () => {
-          // Silently ignore — background agent_end notification failure is non-blocking.
-        }
-      );
-    };
-
-    (pi as any).on("agent_end", handler);
-  }
+  registerAgentNotification(pi, "agent_end", config, cwd);
+  registerAgentNotification(pi, "agent_settled", config, cwd);
 
   // Listen for dynamic module events
   const moduleHandler = async (payload: unknown) => {
@@ -335,7 +289,9 @@ function buildEventMessage(eventKey: string, payload: unknown): string {
     case "mcp_server_error":
       return `Server "${String(p.name || "unknown")}" error: ${String(p.error || "unknown error")}`;
     case "agent_end":
-      return "Agent finished responding";
+      return "Agent run finished responding";
+    case "agent_settled":
+      return "Agent is complete";
     case "memory_consolidated":
       return `Memory consolidated (${p.count || 0} items)`;
     case "session_shutdown":
@@ -347,13 +303,93 @@ function buildEventMessage(eventKey: string, payload: unknown): string {
   }
 }
 
-/** Build agent_end message using session name */
-function buildAgentEndMessage(sessionName: string | undefined): string {
-  if (sessionName) return `${sessionName} - Agent is complete`;
-  return "Agent is complete";
+/** Register an agent lifecycle notification with session name and recap support. */
+function registerAgentNotification(
+  pi: ExtensionAPI,
+  eventKey: "agent_end" | "agent_settled",
+  config: NotifyConfig,
+  cwd: string
+): void {
+  const eventConfig = config.events[eventKey];
+  if (!eventConfig?.enabled) return;
+
+  const handler = (payload: unknown) => {
+    // Fire-and-forget: build message and dispatch in background,
+    // don't block agent lifecycle hooks from completing.
+    const sessionName = pi.getSessionName?.();
+    const title = `Pi — ${BUILTIN_EVENTS[eventKey].label}`;
+
+    if (config.recap.enabled) {
+      // Recap mode: summarize asynchronously, then dispatch.
+      // agent_settled does not currently include a messages payload, so fall
+      // back to the latest assistant message in the session.
+      const lastText = extractLastAssistantText(payload) ?? extractLastAssistantTextFromSession();
+      if (lastText && sessionCtx?.modelRegistry) {
+        const provider = extractProvider(config.recap.model);
+        const modelId = extractModelId(config.recap.model);
+        const model = sessionCtx.modelRegistry.find(provider, modelId);
+        if (model) {
+          sessionCtx.modelRegistry.getApiKeyAndHeaders(model)
+            .then((apiKeyResult) => {
+              const apiKey = apiKeyResult.ok ? (apiKeyResult as { apiKey?: string }).apiKey : undefined;
+              if (apiKey) {
+                return summarizeLastMessage(lastText, apiKey, model.baseUrl, model.api, modelId)
+                  .then((recap) => sessionName ? `${sessionName}: ${recap}` : recap);
+              }
+              return buildAgentLifecycleMessage(eventKey, sessionName);
+            })
+            .catch(() => buildAgentLifecycleMessage(eventKey, sessionName))
+            .then((message) =>
+              dispatchNotification(pi, title, message, eventConfig.platforms, eventKey, config, cwd)
+            )
+            .catch(() => {
+              // Silently ignore — background agent notification failure is non-blocking.
+            });
+          return;
+        }
+      }
+    }
+
+    // No recap or recap unavailable: dispatch immediately in background.
+    const message = buildAgentLifecycleMessage(eventKey, sessionName);
+    dispatchNotification(pi, title, message, eventConfig.platforms, eventKey, config, cwd).catch(
+      () => {
+        // Silently ignore — background agent notification failure is non-blocking.
+      }
+    );
+  };
+
+  (pi as any).on(eventKey, handler);
+}
+
+/** Whether an event key is an agent lifecycle notification with custom handling. */
+function isAgentNotificationEvent(eventKey: string): eventKey is "agent_end" | "agent_settled" {
+  return eventKey === "agent_end" || eventKey === "agent_settled";
+}
+
+/** Build agent lifecycle message using session name. */
+function buildAgentLifecycleMessage(
+  eventKey: "agent_end" | "agent_settled",
+  sessionName: string | undefined
+): string {
+  const status = eventKey === "agent_end" ? "Agent run is complete" : "Agent is complete";
+  if (sessionName) return `${sessionName} - ${status}`;
+  return status;
+}
+
+/** Extract text from the latest assistant message in the current session. */
+function extractLastAssistantTextFromSession(): string | null {
+  const entries = sessionCtx?.sessionManager.getEntries() ?? [];
+  for (let i = entries.length - 1; i >= 0; i--) {
+    const entry = entries[i];
+    if (entry?.type !== "message") continue;
+    const text = extractAssistantText(entry.message);
+    if (text) return text;
+  }
+  return null;
 }
 
-/** Extract text from the last assistant message in agent_end payload */
+/** Extract text from the last assistant message in an agent lifecycle payload. */
 function extractLastAssistantText(payload: unknown): string | null {
   const p = payload as { messages?: Array<{ role?: string; content?: unknown }> };
   if (!p?.messages || !Array.isArray(p.messages)) return null;
@@ -363,21 +399,31 @@ function extractLastAssistantText(payload: unknown): string | null {
     const msg = p.messages[i];
     if (msg?.role !== "assistant") continue;
 
-    const content = msg.content;
-    if (typeof content === "string") return content;
-    if (Array.isArray(content)) {
-      // Extract text blocks from content array
-      const textParts: string[] = [];
-      for (const block of content) {
-        if (typeof block === "object" && block !== null) {
-          const b = block as { type?: string; text?: string };
-          if (b.type === "text" && typeof b.text === "string") {
-            textParts.push(b.text);
-          }
+    const text = extractAssistantText(msg);
+    if (text) return text;
+  }
+
+  return null;
+}
+
+/** Extract text from an assistant message-like object. */
+function extractAssistantText(message: { role?: string; content?: unknown }): string | null {
+  if (message.role !== "assistant") return null;
+
+  const content = message.content;
+  if (typeof content === "string") return content;
+  if (Array.isArray(content)) {
+    // Extract text blocks from content array.
+    const textParts: string[] = [];
+    for (const block of content) {
+      if (typeof block === "object" && block !== null) {
+        const b = block as { type?: string; text?: string };
+        if (b.type === "text" && typeof b.text === "string") {
+          textParts.push(b.text);
         }
       }
-      if (textParts.length > 0) return textParts.join("\n");
     }
+    if (textParts.length > 0) return textParts.join("\n");
   }
 
   return null;
@@ -394,11 +440,3 @@ function extractModelId(modelRef: string): string {
   const slashIdx = modelRef.indexOf("/");
   return slashIdx > 0 ? modelRef.slice(slashIdx + 1) : modelRef;
 }
-
-/** Resolve API key for a provider from environment variables */
-function resolveApiKey(modelRef: string): string | undefined {
-  const provider = extractProvider(modelRef);
-  // Try standard env var patterns
-  const envKey = `${provider.toUpperCase().replace(/-/g, "_")}_API_KEY`;
-  return process.env[envKey];
-}

package/packages/notify/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/notify",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "description": "Cross-platform notification extension for Pi — native OS, Gotify, and Telegram notifications for agent lifecycle events",
   "type": "module",
   "main": "index.ts",
@@ -20,7 +20,7 @@
     "notifications"
   ],
   "scripts": {
-    "test": "tsc --noEmit && node --experimental-strip-types --test src/__tests__/*.test.ts",
+    "test": "tsc --noEmit && npx tsx --test src/__tests__/*.test.ts",
     "typecheck": "tsc --noEmit"
   },
   "files": [

package/packages/notify/settings.ts

@@ -24,6 +24,7 @@ export const DEFAULT_CONFIG: NotifyConfig = {
     ralph_loop_end: { enabled: true, platforms: [] },
     mcp_server_error: { enabled: true, platforms: [] },
     agent_end: { enabled: false, platforms: [] },
+    agent_settled: { enabled: false, platforms: [] },
     memory_consolidated: { enabled: false, platforms: [] },
     session_shutdown: { enabled: false, platforms: [] },
     ask_user_prompt: { enabled: false, platforms: [] },

package/packages/notify/skills/configure-notify/SKILL.md

@@ -34,6 +34,7 @@ Help users configure the `@pi-unipi/notify` notification system.
     "ralph_loop_end": { "enabled": true, "platforms": [] },
     "mcp_server_error": { "enabled": true, "platforms": [] },
     "agent_end": { "enabled": false, "platforms": [] },
+    "agent_settled": { "enabled": false, "platforms": [] },
     "memory_consolidated": { "enabled": false, "platforms": [] },
     "session_shutdown": { "enabled": false, "platforms": [] }
   },
@@ -150,7 +151,8 @@ ntfy uses dedicated `ntfy.json` files at both global and project scope, with ful
 | `workflow_end` | On | Workflow command completes |
 | `ralph_loop_end` | On | Ralph loop completes |
 | `mcp_server_error` | On | MCP server error |
-| `agent_end` | Off | Agent finishes responding |
+| `agent_end` | Off | Low-level agent run ends (may fire again on retries) |
+| `agent_settled` | Off | Agent fully settles after retries, compaction, and queued continuations |
 | `memory_consolidated` | Off | Memory auto-saved |
 | `session_shutdown` | Off | Session ends |
 

package/packages/notify/src/__tests__/event-bus.test.ts

@@ -27,6 +27,7 @@ function readSource(relativePath: string): string {
 
 const LIFECYCLE_EVENTS = new Set([
   "agent_end",
+  "agent_settled",
   "session_shutdown",
 ]);
 
@@ -47,7 +48,7 @@ describe("notify — event bus registration", () => {
     assert.deepStrictEqual(
       parsed.sort(),
       [...LIFECYCLE_EVENTS].sort(),
-      "LIFECYCLE_EVENTS should contain exactly agent_end and session_shutdown",
+      "LIFECYCLE_EVENTS should contain exactly agent_end, agent_settled, and session_shutdown",
     );
   });
 
@@ -67,7 +68,7 @@ describe("notify — event bus registration", () => {
     );
   });
 
-  it("lifecycle events (agent_end, session_shutdown) still use pi.on()", () => {
+  it("lifecycle events (agent_end, agent_settled, session_shutdown) still use pi.on()", () => {
     const src = readSource("packages/notify/events.ts");
 
     assert.ok(