@pi-unipi/unipi 3.0.0-alpha.23 → 3.0.0-alpha.24

package/CHANGELOG.md

@@ -6,6 +6,13 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [3.0.0-alpha.24] — 2026-10-04
+
+### Added
+- `utility`: bundled **`summarize` skill** — the default shape for the agent's final reply after work: a one-sentence answer, numbered sections that open with a bold takeaway, optional mermaid diagram for 3+ step flows, "Problems and fixes", "Not verified", "Still open", and typed questions (`Q1 (pick one)` / `(pick any)` / `(your answer)`, a recommendation only when the work gives a reason). A level gate matches the user's technical depth. Skipped when the user asks for full detail or raw output. Tuned against `ds/deepseek-flash` in a blind A/B arena over 12 real long-session turns.
+- `utility`: **`/unipi:summarize [focus]`** — asks the agent for that summary of the session now (expands `/skill:summarize`, so the skill is always applied; waits for the turn in print mode).
+- `skill-registry`: bundled skills can be **must show by default** (`DEFAULT_MUST_SHOW`, currently `summarize`), with the proxy on or off. A scope can still clear **M** or **E** in `/unipi:skills`.
+
 ## [3.0.0-alpha.23] — 2026-10-04
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "3.0.0-alpha.23",
+  "version": "3.0.0-alpha.24",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -82,26 +82,26 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/ask-user": "3.0.0-alpha.23",
-    "@pi-unipi/background-tasks": "3.0.0-alpha.23",
-    "@pi-unipi/btw": "3.0.0-alpha.23",
-    "@pi-unipi/command-enchantment": "3.0.0-alpha.23",
-    "@pi-unipi/compactor": "3.0.0-alpha.23",
-    "@pi-unipi/core": "3.0.0-alpha.23",
-    "@pi-unipi/footer": "3.0.0-alpha.23",
-    "@pi-unipi/fusion": "3.0.0-alpha.23",
-    "@pi-unipi/info-screen": "3.0.0-alpha.23",
-    "@pi-unipi/input-shortcuts": "3.0.0-alpha.23",
-    "@pi-unipi/kanboard": "3.0.0-alpha.23",
-    "@pi-unipi/mcp": "3.0.0-alpha.23",
-    "@pi-unipi/memory": "3.0.0-alpha.23",
-    "@pi-unipi/notify": "3.0.0-alpha.23",
-    "@pi-unipi/skill-registry": "3.0.0-alpha.23",
-    "@pi-unipi/subagents": "3.0.0-alpha.23",
-    "@pi-unipi/updater": "3.0.0-alpha.23",
-    "@pi-unipi/utility": "3.0.0-alpha.23",
-    "@pi-unipi/web-api": "3.0.0-alpha.23",
-    "@pi-unipi/workflow": "3.0.0-alpha.23"
+    "@pi-unipi/ask-user": "3.0.0-alpha.24",
+    "@pi-unipi/background-tasks": "3.0.0-alpha.24",
+    "@pi-unipi/btw": "3.0.0-alpha.24",
+    "@pi-unipi/command-enchantment": "3.0.0-alpha.24",
+    "@pi-unipi/compactor": "3.0.0-alpha.24",
+    "@pi-unipi/core": "3.0.0-alpha.24",
+    "@pi-unipi/footer": "3.0.0-alpha.24",
+    "@pi-unipi/fusion": "3.0.0-alpha.24",
+    "@pi-unipi/info-screen": "3.0.0-alpha.24",
+    "@pi-unipi/input-shortcuts": "3.0.0-alpha.24",
+    "@pi-unipi/kanboard": "3.0.0-alpha.24",
+    "@pi-unipi/mcp": "3.0.0-alpha.24",
+    "@pi-unipi/memory": "3.0.0-alpha.24",
+    "@pi-unipi/notify": "3.0.0-alpha.24",
+    "@pi-unipi/skill-registry": "3.0.0-alpha.24",
+    "@pi-unipi/subagents": "3.0.0-alpha.24",
+    "@pi-unipi/updater": "3.0.0-alpha.24",
+    "@pi-unipi/utility": "3.0.0-alpha.24",
+    "@pi-unipi/web-api": "3.0.0-alpha.24",
+    "@pi-unipi/workflow": "3.0.0-alpha.24"
   },
   "devDependencies": {
     "@earendil-works/pi-agent-core": "^0.87.1",

package/packages/ask-user/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ask-user",
-  "version": "3.0.0-alpha.23",
+  "version": "3.0.0-alpha.24",
   "description": "Structured user input tool for Pi coding agent — single-select, multi-select, freeform",
   "type": "module",
   "main": "index.ts",
@@ -40,7 +40,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.23"
+    "@pi-unipi/core": "3.0.0-alpha.24"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/autocomplete/package.json

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

package/packages/autocomplete/src/constants.ts

@@ -74,6 +74,7 @@ export const COMMAND_REGISTRY: Record<string, string> = {
   "unipi:cleanup":    "utility",
   "unipi:doctor":     "utility",
   "unipi:answer":     "utility",
+  "unipi:summarize":  "utility",
 
   // skill-registry
   "unipi:skills":     "skill-registry",
@@ -160,6 +161,7 @@ export const COMMAND_DESCRIPTIONS: Record<string, string> = {
   "unipi:cleanup":    "Remove stale UniPi temp files and leftovers (preview first)",
   "unipi:doctor":     "Check UniPi's runtime: config, model cache, Decision Model, skills",
   "unipi:answer":     "Answer the last reply — fixed input under the scrollable reply, per question, or web form",
+  "unipi:summarize":  "Summarize this session — answer first, then findings, open items, questions; add text to set a focus",
   "unipi:skills":     "Manage skills — on/off per project, listed or not, the skill vault",
 
   "unipi:kanboard":        "Kanboard — capture tasks, run them, open the board",

package/packages/background-tasks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/background-tasks",
-  "version": "3.0.0-alpha.23",
+  "version": "3.0.0-alpha.24",
   "description": "Background tasks for UniPi — durable shell jobs and delegated background agents with a footer dock",
   "type": "module",
   "main": "src/index.ts",
@@ -10,7 +10,7 @@
   },
   "dependencies": {
     "@earendil-works/pi-ai": "^0.87.1",
-    "@pi-unipi/core": "3.0.0-alpha.23",
+    "@pi-unipi/core": "3.0.0-alpha.24",
     "turndown": "^7.2.4"
   },
   "devDependencies": {

package/packages/btw/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/btw",
-  "version": "3.0.0-alpha.23",
+  "version": "3.0.0-alpha.24",
   "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.87.1"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.23"
+    "@pi-unipi/core": "3.0.0-alpha.24"
   },
   "pi": {
     "extensions": [

package/packages/compactor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/compactor",
-  "version": "3.0.0-alpha.23",
+  "version": "3.0.0-alpha.24",
   "description": "Compaction for Pi — lossless zero-LLM or model summaries, rebuilt from full history, with session recall",
   "type": "module",
   "main": "src/index.ts",
@@ -33,8 +33,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.23",
-    "@pi-unipi/info-screen": "3.0.0-alpha.23",
+    "@pi-unipi/core": "3.0.0-alpha.24",
+    "@pi-unipi/info-screen": "3.0.0-alpha.24",
     "@earendil-works/pi-agent-core": "^0.87.1"
   },
   "peerDependencies": {

package/packages/core/constants.ts

@@ -108,6 +108,7 @@ export const UTILITY_COMMANDS = {
   CLEANUP: "cleanup",
   DOCTOR: "doctor",
   ANSWER: "answer",
+  SUMMARIZE: "summarize",
 } as const;
 
 /** Ask-user tool names */

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/core",
-  "version": "3.0.0-alpha.23",
+  "version": "3.0.0-alpha.24",
   "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": "3.0.0-alpha.23",
+  "version": "3.0.0-alpha.24",
   "description": "Persistent status bar for Unipi — subscribes to UNIPI_EVENTS and renders key stats from all unipi packages",
   "type": "module",
   "main": "index.ts",
@@ -32,8 +32,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.23",
-    "@pi-unipi/background-tasks": "3.0.0-alpha.23"
+    "@pi-unipi/core": "3.0.0-alpha.24",
+    "@pi-unipi/background-tasks": "3.0.0-alpha.24"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/fusion/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/fusion",
-  "version": "3.0.0-alpha.23",
+  "version": "3.0.0-alpha.24",
   "description": "Devin-style model picker, fusion presets (lead + sidekick), and Local Fusion runtime for UniPi",
   "type": "module",
   "main": "src/index.ts",
@@ -32,9 +32,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.23",
-    "@pi-unipi/subagents": "3.0.0-alpha.23",
-    "@pi-unipi/utility": "3.0.0-alpha.23"
+    "@pi-unipi/core": "3.0.0-alpha.24",
+    "@pi-unipi/subagents": "3.0.0-alpha.24",
+    "@pi-unipi/utility": "3.0.0-alpha.24"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.87.1",

package/packages/info-screen/package.json

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

package/packages/input-shortcuts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/input-shortcuts",
-  "version": "3.0.0-alpha.23",
+  "version": "3.0.0-alpha.24",
   "description": "Keyboard shortcuts for stash/restore, undo/redo, clipboard, and thinking toggle — chord-based overlay system",
   "type": "module",
   "main": "src/index.ts",
@@ -33,7 +33,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.23"
+    "@pi-unipi/core": "3.0.0-alpha.24"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/kanboard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/kanboard",
-  "version": "3.0.0-alpha.23",
+  "version": "3.0.0-alpha.24",
   "description": "Kanboard v3 — deferred-work board: CLI/daemon bridge, task runner and skill",
   "type": "module",
   "main": "index.ts",
@@ -31,7 +31,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.23"
+    "@pi-unipi/core": "3.0.0-alpha.24"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",
@@ -48,10 +48,10 @@
     "themes": []
   },
   "optionalDependencies": {
-    "@pi-unipi/kanboard-linux-x64": "3.0.0-alpha.23",
-    "@pi-unipi/kanboard-linux-arm64": "3.0.0-alpha.23",
-    "@pi-unipi/kanboard-darwin-x64": "3.0.0-alpha.23",
-    "@pi-unipi/kanboard-darwin-arm64": "3.0.0-alpha.23",
-    "@pi-unipi/kanboard-win32-x64": "3.0.0-alpha.23"
+    "@pi-unipi/kanboard-linux-x64": "3.0.0-alpha.24",
+    "@pi-unipi/kanboard-linux-arm64": "3.0.0-alpha.24",
+    "@pi-unipi/kanboard-darwin-x64": "3.0.0-alpha.24",
+    "@pi-unipi/kanboard-darwin-arm64": "3.0.0-alpha.24",
+    "@pi-unipi/kanboard-win32-x64": "3.0.0-alpha.24"
   }
 }

package/packages/long-horizon/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/long-horizon",
-  "version": "3.0.0-alpha.23",
+  "version": "3.0.0-alpha.24",
   "description": "Long-horizon execution for Pi — mode-gated /goal /ralph /swarm /graph orchestration with a TypeSafe prompt judge",
   "type": "module",
   "main": "index.ts",
@@ -37,7 +37,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.23"
+    "@pi-unipi/core": "3.0.0-alpha.24"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/mcp",
-  "version": "3.0.0-alpha.23",
+  "version": "3.0.0-alpha.24",
   "description": "MCP server management extension for Pi coding agent — browse, add, configure, and use MCP servers",
   "type": "module",
   "main": "src/index.ts",
@@ -30,7 +30,7 @@
     "test": "npx tsx --test tests/**/*.test.ts"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.23"
+    "@pi-unipi/core": "3.0.0-alpha.24"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/memory",
-  "version": "3.0.0-alpha.23",
+  "version": "3.0.0-alpha.24",
   "description": "Persistent cross-session memory on MemPalace (auto-installed): daemon-routed writes, shared palace with other agents, for Pi coding agent",
   "type": "module",
   "main": "index.ts",
@@ -42,8 +42,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.23",
-    "@pi-unipi/info-screen": "3.0.0-alpha.23",
+    "@pi-unipi/core": "3.0.0-alpha.24",
+    "@pi-unipi/info-screen": "3.0.0-alpha.24",
     "js-yaml": "^4.1.0"
   },
   "peerDependencies": {

package/packages/notify/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/notify",
-  "version": "3.0.0-alpha.23",
+  "version": "3.0.0-alpha.24",
   "description": "Cross-platform notification extension for Pi — native OS, Gotify, and Telegram notifications for agent lifecycle events",
   "type": "module",
   "main": "index.ts",
@@ -34,7 +34,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.23",
+    "@pi-unipi/core": "3.0.0-alpha.24",
     "node-notifier": "^10.0.1"
   },
   "peerDependencies": {

package/packages/skill-registry/README.md

@@ -39,7 +39,7 @@ Changes apply from the next prompt. You do not need `/reload`.
 **Skill settings…** shows each skill with its source (`vault`, `project`, `user`, `unipi` or `package`) and two columns:
 
 - **E** (enabled): the agent can see the skill. Off removes it from the session, and blocks `/skill:name`.
-- **M** (must show): the agent always sees the skill, also when exposure judging would hide it.
+- **M** (must show): the agent always sees the skill, also when exposure judging would hide it. The bundled `summarize` skill has **M** on by default.
 
 | Key | What it does |
 |---|---|

package/packages/skill-registry/index.ts

@@ -16,7 +16,7 @@ import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-a
 import { emitEvent, getPackageVersion, harnessMetadata, HUB_OVERLAY_OPTIONS, MODULES, openSettingsHub, registerCommandRunner, setSettings, UNIPI_EVENTS } from "@pi-unipi/core";
 import { dirname } from "node:path";
 import { fileURLToPath } from "node:url";
-import { applyRegistry, isBundledSkillLocation, isUnderDir, skillCommandName, skillDir, skillSource, type CatalogSkill } from "./src/registry.js";
+import { applyRegistry, defaultMustShow, isBundledSkillLocation, isUnderDir, skillCommandName, skillDir, skillSource, type CatalogSkill } from "./src/registry.js";
 import { readSkillsSettings, readStateLayers, writeStateLayers } from "./src/settings.js";
 import { SkillEditor, type EditorResult } from "./src/editor.js";
 import { listVaultSkills, vaultDir } from "./src/vault.js";
@@ -187,6 +187,8 @@ export default function skillRegistry(pi: ExtensionAPI) {
           if (inVault) disabled.add(s.name);
           return !inVault;
         });
+        // Proxy off: per-skill states are ignored, defaults still apply.
+        for (const s of pool) if (defaultMustShow(s.name, skillSource(s, cwd, vault))) mustShow.add(s.name);
       }
 
       const setSkills = (list: CatalogSkill[]) => {

package/packages/skill-registry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/skill-registry",
-  "version": "3.0.0-alpha.23",
+  "version": "3.0.0-alpha.24",
   "description": "Skill registry for pi — per-project skill on/off, a skill vault, and jev-judged skill exposure",
   "type": "module",
   "license": "MIT",
@@ -33,7 +33,7 @@
   },
   "main": "index.ts",
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.23"
+    "@pi-unipi/core": "3.0.0-alpha.24"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/skill-registry/src/editor.ts

@@ -18,7 +18,7 @@
 
 import { Key, matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import { frameOverlay } from "@pi-unipi/core";
-import type { SkillSource } from "./registry.js";
+import { defaultMustShow, type SkillSource } from "./registry.js";
 import type { SkillState } from "./settings.js";
 
 export type Column = "enabled" | "mustShow";
@@ -52,9 +52,9 @@ export interface EditorOptions {
   visibleRows?: number;
 }
 
-function defaultFor(column: Column, source: SkillSource): boolean {
-  if (column === "enabled") return source !== "vault";
-  return false;
+function defaultFor(column: Column, skill: EditorSkill): boolean {
+  if (column === "enabled") return skill.source !== "vault";
+  return defaultMustShow(skill.name, skill.source);
 }
 
 /** Effective value of one cell: project over global over the source default. */
@@ -63,7 +63,7 @@ export function cellValue(layers: Layers, skill: EditorSkill, column: Column): {
   if (typeof p === "boolean") return { value: p, from: "project" };
   const g = layers.global[skill.name]?.[column];
   if (typeof g === "boolean") return { value: g, from: "global" };
-  return { value: defaultFor(column, skill.source), from: "default" };
+  return { value: defaultFor(column, skill), from: "default" };
 }
 
 function printable(data: string): string | undefined {

package/packages/skill-registry/src/registry.ts

@@ -43,13 +43,25 @@ export function skillSource(s: CatalogSkill, cwd: string, vault: string): SkillS
   return "package";
 }
 
+/**
+ * Bundled UniPi skills that are listed by default ("Must show" on unless a
+ * scope turns it off). summarize sets the shape of the agent's final reply,
+ * so judging must not hide it on prompts that never mention a summary.
+ */
+export const DEFAULT_MUST_SHOW: ReadonlySet<string> = new Set(["summarize"]);
+
+/** The default "Must show" value of a skill from its name and source. */
+export function defaultMustShow(name: string, source: SkillSource): boolean {
+  return source === "unipi" && DEFAULT_MUST_SHOW.has(name);
+}
+
 export interface EffectiveState {
   enabled: boolean;
   mustShow: boolean;
 }
 
-export function effectiveState(state: SkillState | undefined, source: SkillSource): EffectiveState {
-  const mustShow = state?.mustShow === true;
+export function effectiveState(state: SkillState | undefined, source: SkillSource, name = ""): EffectiveState {
+  const mustShow = state?.mustShow ?? defaultMustShow(name, source);
   // Must show implies enabled and is always listed.
   return { enabled: mustShow || (state?.enabled ?? source !== "vault"), mustShow };
 }
@@ -73,7 +85,7 @@ export function applyRegistry<T extends CatalogSkill>(
   const disabled = new Set<string>();
   const mustShow = new Set<string>();
   for (const skill of catalog) {
-    const eff = effectiveState(states[skill.name], skillSource(skill, cwd, vault));
+    const eff = effectiveState(states[skill.name], skillSource(skill, cwd, vault), skill.name);
     if (eff.mustShow) mustShow.add(skill.name);
     if (!eff.enabled) disabled.add(skill.name);
     else listed.push(skill);

package/packages/subagents/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/subagents",
-  "version": "3.0.0-alpha.23",
+  "version": "3.0.0-alpha.24",
   "description": "Subagents for UniPi — Devin-model independent child agents",
   "type": "module",
   "main": "src/index.ts",
@@ -9,8 +9,8 @@
     "test": "npx tsx --test src/__tests__/*.test.ts"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.23",
-    "@pi-unipi/utility": "3.0.0-alpha.23",
+    "@pi-unipi/core": "3.0.0-alpha.24",
+    "@pi-unipi/utility": "3.0.0-alpha.24",
     "@earendil-works/pi-agent-core": "^0.87.1",
     "acorn": "8.18.0"
   },

package/packages/unipi/bundled.js

@@ -96,7 +96,8 @@ var init_constants = __esm({
       RETRY: "retry",
       CLEANUP: "cleanup",
       DOCTOR: "doctor",
-      ANSWER: "answer"
+      ANSWER: "answer",
+      SUMMARIZE: "summarize"
     };
     ASK_USER_TOOLS = {
       ASK: "ask_user"
@@ -9529,6 +9530,40 @@ function registerAnswerCommand(pi) {
   });
 }
 
+// packages/utility/src/summarize/index.ts
+init_core();
+var SUMMARIZE_SKILL = "summarize";
+function summarizePrompt(focus) {
+  const f = focus.trim();
+  const scope = f ? `Summarize this session for me, with the focus on: ${f}` : "Summarize this session for me: what we did, why, and where it stands now.";
+  return `/skill:${SUMMARIZE_SKILL} ${scope} Use only what happened in this session. Do not call tools.`;
+}
+function hasSummarizeSkill(pi) {
+  try {
+    return pi.getCommands().some((c2) => c2.name === `skill:${SUMMARIZE_SKILL}`);
+  } catch {
+    return false;
+  }
+}
+function registerSummarizeCommand(pi) {
+  pi.registerCommand(`${UNIPI_PREFIX}${UTILITY_COMMANDS.SUMMARIZE}`, {
+    description: "Summarize this session for you (answer first, then findings, open items, questions); add text to set a focus",
+    handler: async (args, ctx) => {
+      if (!ctx.isIdle()) {
+        if (ctx.hasUI) ctx.ui.notify("Agent is busy. Press ESC to interrupt, then try again.", "warning");
+        return;
+      }
+      if (!hasSummarizeSkill(pi)) {
+        if (ctx.hasUI) ctx.ui.notify("The summarize skill is off or missing. Turn it on in /unipi:skills.", "warning");
+        return;
+      }
+      pi.sendUserMessage(summarizePrompt(args ?? ""), { expandPromptTemplates: true });
+      await new Promise((r) => setTimeout(r, 0));
+      await ctx.waitForIdle?.();
+    }
+  });
+}
+
 // packages/utility/src/attach/index.ts
 import { readFileSync as readFileSync9 } from "node:fs";
 import { getCapabilities as getCapabilities2, Image, Key as Key7, matchesKey as matchesKey6, truncateToWidth as truncateToWidth8 } from "@earendil-works/pi-tui";
@@ -12562,6 +12597,7 @@ function src_default(pi) {
   registerUtilityCommands(pi);
   registerAutoRename(pi);
   registerAnswerCommand(pi);
+  registerSummarizeCommand(pi);
   registerAttachments(pi);
   registerImage(pi);
   const style = readUtilSettings().render.style;
@@ -30664,8 +30700,12 @@ function skillSource(s, cwd, vault) {
   if (isUnderDir(dir, `${home}/.agents/skills`) || isUnderDir(dir, `${home}/.pi/agent/skills`)) return "user";
   return "package";
 }
-function effectiveState(state2, source) {
-  const mustShow = state2?.mustShow === true;
+var DEFAULT_MUST_SHOW = /* @__PURE__ */ new Set(["summarize"]);
+function defaultMustShow(name, source) {
+  return source === "unipi" && DEFAULT_MUST_SHOW.has(name);
+}
+function effectiveState(state2, source, name = "") {
+  const mustShow = state2?.mustShow ?? defaultMustShow(name, source);
   return { enabled: mustShow || (state2?.enabled ?? source !== "vault"), mustShow };
 }
 function applyRegistry(catalog, states, cwd, vault) {
@@ -30673,7 +30713,7 @@ function applyRegistry(catalog, states, cwd, vault) {
   const disabled = /* @__PURE__ */ new Set();
   const mustShow = /* @__PURE__ */ new Set();
   for (const skill of catalog) {
-    const eff = effectiveState(states[skill.name], skillSource(skill, cwd, vault));
+    const eff = effectiveState(states[skill.name], skillSource(skill, cwd, vault), skill.name);
     if (eff.mustShow) mustShow.add(skill.name);
     if (!eff.enabled) disabled.add(skill.name);
     else listed.push(skill);
@@ -30864,16 +30904,16 @@ init_core();
 import { Key as Key13, matchesKey as matchesKey13, truncateToWidth as truncateToWidth22, visibleWidth as visibleWidth17 } from "@earendil-works/pi-tui";
 var COLUMNS = ["enabled", "mustShow"];
 var LETTER = { enabled: "E", mustShow: "M" };
-function defaultFor(column, source) {
-  if (column === "enabled") return source !== "vault";
-  return false;
+function defaultFor(column, skill) {
+  if (column === "enabled") return skill.source !== "vault";
+  return defaultMustShow(skill.name, skill.source);
 }
 function cellValue(layers, skill, column) {
   const p = layers.project[skill.name]?.[column];
   if (typeof p === "boolean") return { value: p, from: "project" };
   const g = layers.global[skill.name]?.[column];
   if (typeof g === "boolean") return { value: g, from: "global" };
-  return { value: defaultFor(column, skill.source), from: "default" };
+  return { value: defaultFor(column, skill), from: "default" };
 }
 function printable(data) {
   if (data.length !== 1) return void 0;
@@ -31401,6 +31441,7 @@ function skillRegistry(pi) {
           if (inVault) disabled.add(s.name);
           return !inVault;
         });
+        for (const s of pool) if (defaultMustShow(s.name, skillSource(s, cwd, vault))) mustShow.add(s.name);
       }
       const setSkills = (list) => {
         options.skills = list;
@@ -39665,6 +39706,7 @@ var COMMAND_REGISTRY = {
   "unipi:cleanup": "utility",
   "unipi:doctor": "utility",
   "unipi:answer": "utility",
+  "unipi:summarize": "utility",
   // skill-registry
   "unipi:skills": "skill-registry",
   // ask-user (1 command)
@@ -39727,6 +39769,7 @@ var COMMAND_DESCRIPTIONS = {
   "unipi:cleanup": "Remove stale UniPi temp files and leftovers (preview first)",
   "unipi:doctor": "Check UniPi's runtime: config, model cache, Decision Model, skills",
   "unipi:answer": "Answer the last reply \u2014 fixed input under the scrollable reply, per question, or web form",
+  "unipi:summarize": "Summarize this session \u2014 answer first, then findings, open items, questions; add text to set a focus",
   "unipi:skills": "Manage skills \u2014 on/off per project, listed or not, the skill vault",
   "unipi:kanboard": "Kanboard \u2014 capture tasks, run them, open the board",
   "unipi:kanboard-add": "Kanboard \u2014 capture a task into Backlog",

package/packages/updater/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/updater",
-  "version": "3.0.0-alpha.23",
+  "version": "3.0.0-alpha.24",
   "description": "Auto-updater, changelog browser, and readme browser for Unipi — checks npm registry, renders CHANGELOG.md and README.md files in TUI overlays",
   "type": "module",
   "main": "index.ts",
@@ -34,7 +34,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.23"
+    "@pi-unipi/core": "3.0.0-alpha.24"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/utility/README.md

@@ -35,9 +35,28 @@ pi install npm:@pi-unipi/utility
 | `/unipi:cleanup` | Lists stale UniPi files, then asks before it removes them. `--dry-run` only lists. `--yes` does not ask. |
 | `/unipi:doctor` | Checks folders, config files, Node, the model cache, the Decision Model and skill exposure. |
 | `/unipi:answer [reply\|questions\|web]` | Opens a screen to answer the last agent reply. |
+| `/unipi:summarize [focus]` | Asks the agent for a summary of the session. Add text to set a focus. |
 
 The skill manager is in [Skill Registry](../skill-registry/README.md) (`/unipi:skills`).
 
+## Summaries
+
+Utility ships the `summarize` skill. The skill sets the shape of the agent's
+final reply after work:
+
+1. One sentence with the answer or the result.
+2. Numbered sections. Each section starts with one bold sentence.
+3. Problems and fixes, when the work hit a problem.
+4. Not verified, then Still open.
+5. Questions for you. Each question has a type: pick one, pick any or your answer.
+
+The agent uses the skill for every final reply, unless you ask for full detail
+or raw output. `/unipi:summarize` asks for this summary at any time.
+
+The skill is "must show" by default, so exposure judging does not hide it. To
+turn this off, open `/unipi:skills` and clear **M** on `summarize`. Clear **E**
+to remove the skill.
+
 ## Agent tools
 
 | Tool | What it does |

package/packages/utility/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/utility",
-  "version": "3.0.0-alpha.23",
+  "version": "3.0.0-alpha.24",
   "description": "Utility commands and tools for Pi coding agent — lifecycle, diagnostics, cache, analytics, display, batch execution",
   "type": "module",
   "main": "src/index.ts",
@@ -36,7 +36,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.23"
+    "@pi-unipi/core": "3.0.0-alpha.24"
   },
   "devDependencies": {},
   "peerDependencies": {

package/packages/utility/skills/summarize/SKILL.md

@@ -0,0 +1,304 @@
+---
+name: summarize
+description: |
+  Use for every final reply that ends a piece of work (a task, a fix, an
+  investigation), and for /unipi:summarize, unless the user asked for full
+  detail, raw output, or exact text. Shape: one-sentence answer, numbered
+  sections, problems and fixes, not verified, still open, typed questions.
+---
+
+# Summarize for the user
+
+Use this skill for the final reply after work (a task, an investigation, a
+fix), and when the user runs /unipi:summarize. "The work" below means the
+session, or the part of it you are summarizing: the user's messages, your
+tool calls and their results, and your replies.
+
+## When not to use it
+
+- The user asked for full detail, raw output, a file, code, or exact text.
+  Give them that.
+- The reply is short by nature: a one-line answer, a yes or no, a command,
+  a question back to the user. Answer in plain sentences.
+- The reply is in the middle of the work, not at its end.
+
+Scale the shape to the work. A small task gets the answer sentence and one
+or two bullets. Use the full shape only when the work has several findings,
+changes, or open items.
+
+The reader is the user. They asked for the work but did not watch it. They
+read the summary once, quickly, top to bottom. Each line should tell them
+more than the line before. The answer comes first, then the reasons, then
+the details, then what is left for them.
+
+You did the work. Write as "I" and call the reader "you".
+
+## Step 1: pick the level
+
+Read the user's own messages in the work before you write. Pick one level.
+
+- Product level (the default). The user talks about features, screens,
+  customers, money, speed, or decisions. Describe what people see and why it
+  matters. Use at most three code names in total, and only ones the user needs
+  to act on (a file to open, a command to run, a setting to change).
+- Technical level. The user's messages use code names, file paths, commands,
+  or error text, or they ask how something works inside the code. Match them:
+  name the functions, files, and settings that carry the answer, and explain
+  the mechanism. Still start each point with the effect, then the mechanism.
+  Count your code names (anything in backticks, plus file, function, route,
+  and setting names). Use six or fewer in total. Describe the rest in words. Never give style values, line
+  numbers, or full lists of files or pages. Say "about 15 table pages".
+
+If the user mixes both, use product level for the answer and the findings.
+Put technical names only where the user must act.
+
+## Step 2: the shape
+
+```
+<Answer: one sentence. No heading above it.>
+
+## 1. <First topic>
+**<One-sentence takeaway of this section.>**
+<diagram, if one fits>
+- **<Label>**: <one or two sentences>
+- **<Label>**: <one or two sentences>
+
+## 2. <Next topic>
+...
+
+## Problems and fixes        (only if the work hit a real obstacle)
+- **<Problem>**: <what blocked the work>. **Fix**: <what I did about it>.
+
+## Not verified
+- **<Label>**: <one sentence>
+
+## Still open
+- **<Label>**: <one sentence>
+
+## Questions for you
+...
+```
+
+Read the shape as a report to a manager: what we achieved, how, what got in
+the way and how we solved it, what we did not check, what needs approval.
+
+The answer line:
+- Exactly one sentence, 25 words or fewer, with no semicolon. It gives the
+  answer, the result, or the main finding. Keep caveats out of it. The one
+  exception: a caveat that flips the answer ("the fix is not deployed yet").
+- It states what is true, never what you did. "I traced each issue and
+  wrote a plan" is wrong. "The filter count is right, but the list hides 4
+  of the 6 statuses" is right. If nothing changed yet, say that after the
+  finding, in the same sentence.
+- No label such as "Status:" or "Summary:". Do not restate the request.
+
+Topic sections:
+- Use two to four sections, numbered. A heading names its content in two to
+  six words: "1. Why wake got slow", "2. What I changed".
+- Put the most important section first. Build from the answer: what is true
+  now, then why, then what changed.
+- Every section starts with one bold sentence: the takeaway of that section.
+  The user can read only the bold sentences and still get the whole story.
+- Details follow as bullets. Each bullet starts with a bold label of one to
+  four words, a colon, then one or two sentences.
+- A section has four bullets or fewer, and the whole summary has 14 bullets
+  or fewer. If you have more, group them or keep the ones that matter to the
+  user. A bullet that only lists items ("chat, posts, captions, comments")
+  can usually merge into the bullet above it.
+
+## Step 3: plain words
+
+Jargon hides in plain text too, not only in backticks. Before you send, find
+every word a manager outside this project would not know: internal system
+names ("warm assignment", "supernode", "lane"), infrastructure names, and
+abbreviations.
+
+- Product level: replace each one with what it does ("the spare pod kept
+  ready for the user"). If it appears three times or more, explain it once
+  in eight words or fewer and keep it.
+- Technical level: keep it, but explain it once in eight words or fewer the
+  first time it appears, unless the user used it first.
+- Write a number with a unit the reader knows: "35 seconds", not "35s p50".
+
+## Step 4: break the text
+
+- No paragraph longer than three sentences or about 50 words. Break every
+  longer block into bullets.
+- Put the important word first in each sentence. Write "**8 of 12** checks
+  failed", not "Of the twelve checks that I ran, eight failed".
+- Bold only these: the section takeaway, the bullet labels, and at most one
+  key number or name inside a bullet.
+- Use a short paragraph only for one connected line of reasoning, three
+  sentences at most.
+
+## Step 5: add a diagram when it fits
+
+Add a mermaid diagram when the work has one of these:
+- a flow of three or more steps,
+- a chain of three or more causes,
+- three or more parts that send things to each other.
+
+Do not draw a diagram for a plain list.
+
+Diagram rules:
+- Use `flowchart TD` or `sequenceDiagram`. Never use `flowchart LR`: wide
+  diagrams break in a terminal.
+- The diagram shows the subject of its own section, nothing else.
+- Use 7 nodes or fewer. If you need more, split the diagram into two, each
+  with its own one-line caption.
+- Labels are one to four plain words. Node ids are single letters: A, B, C.
+  Put labels in square brackets. Do not put parentheses, quotes, or colons
+  inside a label. Edge labels are one to three words: `A -->|fails| B`.
+- Use the same names in the diagram and in the text.
+- Put the diagram right after the bold takeaway of its section.
+- Use two diagrams at most, and one when the summary is product level.
+
+## Step 6: problems and fixes
+
+Add this section only when the work hit a real obstacle: something failed,
+blocked progress, or forced a change of plan. Leave it out for normal work.
+
+- One bullet per obstacle, three or fewer. Format:
+  **<Problem in 2 to 4 words>**: what went wrong, in one sentence.
+  **Fix**: what I did about it, in one sentence.
+- If the obstacle is not solved, write **Fix**: none yet, and put the open
+  work under "Still open".
+- Do not repeat an obstacle that a topic section already explains.
+
+## Step 7: not verified, then still open
+
+Write two short sections. Leave out a section when it is empty. Never write
+a bullet that says there is nothing to report.
+
+- "Not verified": what the user should trust less. Numbers that came from
+  docs or estimates, tests that did not run, causes that are not confirmed.
+- "Still open": work that is not done yet, and risks.
+
+Use bullets with bold labels, three or fewer in each section. Include only
+items that bear on what the user asked.
+
+## Step 8: questions for you
+
+Ask only when the work is blocked on a user decision or on information that
+only the user has. If nothing is blocked, leave out this section.
+
+Ask two questions or fewer. Ask a third only when the work is blocked on it. Label each question with its type:
+
+```
+**Q1 (pick one)**: Which tier should I cut first?
+- a) Diff rendering, about 1,800 lines **(recommended: largest cut, no runtime risk)**
+- b) Memory fallback, about 800 lines
+- c) Compactor display code, about 900 lines
+
+**Q2 (pick any)**: Which tables should get translations in this pass?
+- a) Onboarding review
+- b) Users
+- c) Orders
+
+**Q3 (your answer)**: Which three slow users should I check?
+```
+
+- Use "pick one" for a single choice, "pick any" when several can apply, and
+  "your answer" when the user must type something: a name, a number, a
+  preference, or access.
+- Take the question and the options from the work. Never invent a question
+  the work did not raise. A question about a step you only propose is an
+  offer, so leave it out.
+- Give two or three options. Merge or drop the weakest.
+- Mark an option **(recommended: reason)** only when the work gives a reason.
+  Mark one at most. You can mark a risky option **(not recommended: reason)**.
+- A thing the user must do (not a choice) is one line: **To do**: Set the
+  search key on the server.
+- A step that waits for the user's permission is one line:
+  **Needs approval**: Deploy the fix to production.
+- Do not offer more work ("Do you want me to...", "I can also...").
+
+## Sentences
+
+- One idea per sentence, 20 words or fewer when you can. Active voice.
+- Simple verbs. No semicolons. One name for one thing, every time.
+- Keep the confidence of the work with one short word inline: "likely",
+  "about", "estimated". Put every longer caveat at the end (see Step 5):
+  where a number came from, what was not tested, what was not confirmed.
+  Never write a section or a bullet about what was measured versus claimed.
+- Copy cause and effect only as the work states it. Never add a fact, number,
+  cause, or opinion that is not in the work. This applies to diagram arrows
+  too: draw an arrow between two things only when the work says one leads to
+  the other.
+- Keep the certainty of the work in both directions. If the work states a
+  fact plainly, do not soften it to "likely". If the work guesses, do not
+  harden it.
+- Copy numbers exactly: "$26.60", not "about $27".
+- Put a baseline next to a number when the work has one that measures the
+  same thing: "3.2 s (was 11 s)".
+
+## Cut
+
+- Each fact or caveat appears once.
+- Three examples at most in any list inside a sentence.
+- No framing phrases ("The bigger finding is", "In short", "Overall").
+- No "not X but Y", no "X rather than Y", and no "X, not Y" ("mid-June, not months ago", "from a
+  test, not production"). State the positive claim. If the user believed
+  the wrong thing, say the right thing once.
+- No em dashes. No emoji. No opener, no closer, no offer of more help.
+- No inflated words: robust, seamless, comprehensive, crucial, leverage,
+  pivotal, significant, enhance, streamline.
+
+## Length
+
+- Product level: 120 to 240 words, not counting diagrams.
+- Technical level or very large work: 300 words at most.
+- If the draft is longer, cut the least important bullets first. Do not cut
+  the answer, the bold takeaways, or the questions.
+
+## Example
+
+The work: the user said "people keep getting logged out, fix it". The agent
+found a setting in seconds that the code read as minutes, fixed it, tested on
+staging, and found a second, unrelated bug.
+
+```
+Logins now last 24 hours again, after I fixed a setting that ended every session after 24 minutes.
+
+## 1. Why people were logged out
+**The session timer used the wrong unit since the 3 May release.**
+- **Cause**: the setting was written in minutes but read as seconds.
+- **Effect**: every session ended after **24 minutes** (should be 24 hours).
+
+## 2. What I changed
+**I fixed the unit and tested the fix on staging.**
+- **Fix**: the setting now states its unit, and the code reads it the same way.
+- **Test**: a staging login stayed active for 3 hours with no logout.
+
+## Problems and fixes
+- **Bug did not show locally**: my machine kept old sessions alive. **Fix**: I tested on staging with a fresh login.
+
+## Not verified
+- **Long sessions**: the staging test ran 3 hours, so a full 24-hour session is untested.
+
+## Still open
+- **Production**: the fix is not deployed yet.
+- **Second bug**: the "remember me" box does nothing. It is a separate problem.
+
+## Questions for you
+**Q1 (pick one)**: When should I deploy?
+- a) Now **(recommended: users are logged out every 24 minutes)**
+- b) With Friday's release
+```
+
+## Check before you send
+
+- Is the answer one sentence, with no label and no restated request?
+- Does every section start with a bold takeaway?
+- Is any paragraph longer than three sentences? Break it.
+- Did you match the user's level?
+- If there is a flow of three or more steps, is there a diagram?
+- Is each question labeled with its type, with a recommendation only where
+  the work gives a reason?
+- Does any fact, caveat, or number appear twice? Delete the second one.
+- Is there a caveat longer than one word in the answer, a takeaway, or a
+  bullet? Move it to the end.
+- Is the word count inside the limit for the level?
+- Would a manager outside this project understand every word? Replace or
+  explain the rest.
+- Does every diagram arrow match a cause or step the work states?

package/packages/utility/skills/utility/SKILL.md

@@ -4,7 +4,7 @@ scope: agent
 description: |
   What the @pi-unipi/utility extension does for the user: the /unipi:settings
   hub, /unipi:continue (/unipi:retry), /unipi:cleanup, /unipi:doctor,
-  and automatic session naming. It gives the agent no tools.
+  /unipi:summarize, and automatic session naming. It gives the agent no tools.
 ---
 
 # @pi-unipi/utility
@@ -17,6 +17,7 @@ description: |
 | `/unipi:continue` / `/unipi:retry` | Take another turn without new text |
 | `/unipi:cleanup` | Remove stale UniPi temp files (previews and asks first; `--dry-run`, `--yes`) |
 | `/unipi:doctor` | Check config, model cache, Decision Model key, skill exposure |
+| `/unipi:summarize [focus]` | Ask the agent for a session summary (uses the `summarize` skill) |
 
 ## Notes for the agent
 

package/packages/utility/src/index.ts

@@ -27,6 +27,7 @@ import {
 import { registerUtilityCommands } from "./commands.js";
 import { registerAutoRename } from "./rename/index.js";
 import { registerAnswerCommand } from "./answer/index.js";
+import { registerSummarizeCommand } from "./summarize/index.js";
 import { registerAttachments } from "./attach/index.js";
 import { imageCatalogEntries, loadImageConfig, refreshImageModelCache, registerImage } from "./image/index.js";
 import { registerToolRenderers } from "./render/tools.js";
@@ -66,6 +67,7 @@ export default function (pi: ExtensionAPI) {
   registerUtilityCommands(pi);
   registerAutoRename(pi);
   registerAnswerCommand(pi);
+  registerSummarizeCommand(pi);
   registerAttachments(pi);
   registerImage(pi);
   const style = readUtilSettings().render.style;

package/packages/utility/src/summarize/index.ts

@@ -0,0 +1,51 @@
+/**
+ * @pi-unipi/utility — /unipi:summarize [focus]
+ *
+ * Asks the agent for a summary of the session in the shape the bundled
+ * `summarize` skill sets. The command sends `/skill:summarize`, so pi
+ * inlines the skill file into the turn, and the agent cannot skip it.
+ */
+
+import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import { UNIPI_PREFIX, UTILITY_COMMANDS } from "@pi-unipi/core";
+
+export const SUMMARIZE_SKILL = "summarize";
+
+/** The prompt the command sends. `focus` narrows the summary; empty means the whole session. */
+export function summarizePrompt(focus: string): string {
+  const f = focus.trim();
+  const scope = f
+    ? `Summarize this session for me, with the focus on: ${f}`
+    : "Summarize this session for me: what we did, why, and where it stands now.";
+  return `/skill:${SUMMARIZE_SKILL} ${scope} Use only what happened in this session. Do not call tools.`;
+}
+
+/** True when pi can expand `/skill:summarize` (the skill is loaded and on). */
+export function hasSummarizeSkill(pi: ExtensionAPI): boolean {
+  try {
+    return pi.getCommands().some((c) => c.name === `skill:${SUMMARIZE_SKILL}`);
+  } catch {
+    return false;
+  }
+}
+
+export function registerSummarizeCommand(pi: ExtensionAPI): void {
+  pi.registerCommand(`${UNIPI_PREFIX}${UTILITY_COMMANDS.SUMMARIZE}`, {
+    description: "Summarize this session for you (answer first, then findings, open items, questions); add text to set a focus",
+    handler: async (args: string, ctx: ExtensionCommandContext) => {
+      if (!ctx.isIdle()) {
+        if (ctx.hasUI) ctx.ui.notify("Agent is busy. Press ESC to interrupt, then try again.", "warning");
+        return;
+      }
+      if (!hasSummarizeSkill(pi)) {
+        if (ctx.hasUI) ctx.ui.notify("The summarize skill is off or missing. Turn it on in /unipi:skills.", "warning");
+        return;
+      }
+      pi.sendUserMessage(summarizePrompt(args ?? ""), { expandPromptTemplates: true });
+      // sendUserMessage does not wait. Print mode (-p) exits when the handler
+      // returns, so wait for the summary turn to start and end.
+      await new Promise((r) => setTimeout(r, 0));
+      await ctx.waitForIdle?.();
+    },
+  });
+}

package/packages/watchdog/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/watchdog",
-  "version": "3.0.0-alpha.23",
+  "version": "3.0.0-alpha.24",
   "description": "Jev watchdog for long-running tool calls and background tasks — judges stuck work via TypeSafe System One and kills or warns",
   "type": "module",
   "main": "index.ts",
@@ -32,8 +32,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/background-tasks": "3.0.0-alpha.23",
-    "@pi-unipi/core": "3.0.0-alpha.23"
+    "@pi-unipi/background-tasks": "3.0.0-alpha.24",
+    "@pi-unipi/core": "3.0.0-alpha.24"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/web-api/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/web-api",
-  "version": "3.0.0-alpha.23",
+  "version": "3.0.0-alpha.24",
   "description": "Web search, read, and summarize tools with provider-based backend selection for Pi coding agent",
   "type": "module",
   "main": "src/index.ts",
@@ -31,7 +31,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.23",
+    "@pi-unipi/core": "3.0.0-alpha.24",
     "defuddle": "^0.18.1",
     "linkedom": "^0.18.12",
     "wreq-js": "^2.3.0"

package/packages/workflow/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/workflow",
-  "version": "3.0.0-alpha.23",
+  "version": "3.0.0-alpha.24",
   "description": "Plan mode and permission modes for the Pi coding agent",
   "type": "module",
   "main": "index.ts",
@@ -27,7 +27,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.23"
+    "@pi-unipi/core": "3.0.0-alpha.24"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.87.1",