pi-orchestrator-config 4.22.4 → 4.23.0

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+## [4.23.0] - 2026-11-02
+
+- Minimum pi version raised to 1.5.0 — the extension floor, the sidecar floor, and every manifest move together.
+- Interactive dialogs (ask_user and the pidash bridge) now report "blocked on user input" while they wait, so terminals that track program status show pi as waiting instead of busy.
+- This changelog ships with the package and pi reads it after `pi update --extensions`, so an update now tells you what changed.
+- The `subagent` tool keeps its `agentScope` values as a real enum after pi 1.5.0 changed how `StringEnum` types itself, so the parameter stays validated and documented.
+- Release workflow keeps this changelog current on every bump, and a changelog-only change now marks the package as affected.
+- Docs: MCP OAuth client registration (`auto` / `dcr` / `cimd`), `PI_SELF_UPDATE_COMMAND` for wrapper installs, and the billed-vs-estimated cost contract.
+
+## [4.22.4] - 2026-11-02
+
+- Minimum pi version raised to 1.5.0 (extension and sidecar floors, manifests).
+- Sidecar reports cost billed by the provider instead of only estimated cost.
+- Status reporting for interactive dialogs blocked waiting on user input.

package/README.md

@@ -210,6 +210,22 @@ After updating, run `/reload` in pi or restart pi to pick up changes.
 Refresh the global agent package after acpx-provider / cli-provider / settings
 changes so `~/.pi` is not a mixed checkout (see issue #651).
 
+### Custom update command
+
+`pi update` installs a new release with a global npm install. When a wrapper or another
+package manager provides pi — mise, pnpm, nix — point it at that manager's command instead:
+
+```bash
+export PI_SELF_UPDATE_COMMAND="mise use -g npm:{packageName}@{version}"
+```
+
+`pi update` runs the command only when pi.dev reports a newer release, replacing
+`{packageName}`, `{version}`, and `{installSpec}` (`{packageName}@{version}`) with that
+release. The value is split on spaces; for an argument that contains spaces, set the global
+`selfUpdateCommand` setting in `~/.pi/agent/settings.json` as an argv array such as
+`["nix", "profile", "upgrade", "pi"]`. It can only be set in the agent-directory settings,
+and `PI_SELF_UPDATE_COMMAND` takes precedence over it.
+
 ## Usage
 
 ### Automatic delegation
@@ -1076,7 +1092,7 @@ it also runs as a pre-commit hook when TypeScript files change.
 
 ## Prerequisites
 
-- [pi](https://github.com/badlogic/pi-mono) (minimum version: **1.4.0**). Pidash uses Pi's `ui_prompt_start` and `ui_prompt_end` events to show prompt wait separately from agent work.
+- [pi](https://github.com/badlogic/pi-mono) (minimum version: **1.5.0**). Pidash uses Pi's `ui_prompt_start` and `ui_prompt_end` events to show prompt wait separately from agent work.
 - `gh` CLI (for GitHub operations)
 - `uv` (for Python execution)
 - `myk-pi-tools` (optional, for `/pr-review` and `/release`)

package/extensions/orchestrator/ask-user.ts

@@ -14,6 +14,9 @@ import {
 } from "@earendil-works/pi-tui";
 import { DynamicBorder } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
+import { createLogger } from "../shared/logger.js";
+
+const log = createLogger("ask-user");
 
 export function registerAskUser(
   pi: ExtensionAPI,
@@ -78,6 +81,7 @@ export function registerAskUser(
         }
       });
 
+      log.debug("ask_user prompt opened with blocked status", { askId, mode: params.options?.length ? "select" : "input" });
       const result = await ctx.ui.custom<string | null>(
         (tui, theme, _kb, done) => {
           // Allow browser to resolve this dialog
@@ -260,7 +264,7 @@ export function registerAskUser(
             },
           };
         },
-
+        { blocked: { kind: "question", message: params.question } },
       );
 
       unsubscribe();

package/extensions/orchestrator/subagent-tool.ts

@@ -14,7 +14,6 @@ const require = createRequire(import.meta.url);
 
 import type { AgentToolResult } from "@earendil-works/pi-agent-core";
 import type { Message } from "@earendil-works/pi-ai";
-import { StringEnum } from "@earendil-works/pi-ai";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { createLogger } from "../shared/logger.js";
 import { createBridgedUi } from "../shared/ui-bridge.js";
@@ -107,7 +106,12 @@ const ChainItem = Type.Object({
   cwd: Type.String({ description: "Working directory" }),
   estimatedSeconds: Type.Number({ description: "Estimated step duration in seconds" }),
 });
-const AgentScopeSchema = StringEnum(["user", "project", "both"] as const, {
+// pi 1.5.0's StringEnum returns a pi-schema Schema, which TypeBox's Static cannot
+// read — params.agentScope degraded to `unknown`. Unsafe keeps the JSON-Schema
+// shape providers need while carrying the literal union in the static type.
+const AgentScopeSchema = Type.Unsafe<AgentScope>({
+  type: "string",
+  enum: ["user", "project", "both"],
   description: 'Agent directories to use. Default: "both".',
   default: "both",
 });

package/extensions/orchestrator/utils.ts

@@ -263,7 +263,7 @@ export function tryGetSystemPromptOptions(ctx: any): { contextFiles?: any[]; ski
  * read from ~/.pi/agent/mcp.json by pi itself), and the built-in MCP/codemode/
  * tool-search extensions become the ones we must not collide with.
  */
-export const MIN_PI_VERSION = "1.4.0";
+export const MIN_PI_VERSION = "1.5.0";
 
 /** Get the installed pi version from its package.json. */
 export function getPiVersion(): string | null {

package/extensions/shared/create-runtime-provider.ts

@@ -3,7 +3,7 @@
  *
  * Prefer this over legacy `pi.registerProvider(name, { streamSimple })` bags so
  * providers get /login auth, fetchModels refresh, filterModels, and native
- * ProviderStreams (requires pi >= 1.4.0).
+ * ProviderStreams (requires pi >= 1.5.0).
  */
 
 import { createLogger } from "./logger.js";

package/extensions/shared/ui-bridge.ts

@@ -110,6 +110,10 @@ export function createBridgedUi(pi: ExtensionAPI): BridgedUi {
       externalDone(resp.value);
     });
 
+    // Report "blocked on user input" (OSC 7501) while the dialog is visible.
+    const blocked = { kind: "question" as const, message: message ? `${title} — ${message}` : title };
+    log.debug("bridged prompt opened with blocked status", { id, method, kind: blocked.kind });
+
     try {
       const result = (await ctx.ui.custom((tui: any, theme: any, _kb: any, done: (v: any) => void) => {
         let resolved = false;
@@ -215,7 +219,7 @@ export function createBridgedUi(pi: ExtensionAPI): BridgedUi {
             tui.requestRender();
           },
         };
-      })) as T | undefined;
+      }, { blocked })) as T | undefined;
       return result;
     } finally {
       unsubscribe?.();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-orchestrator-config",
-  "version": "4.22.4",
+  "version": "4.23.0",
   "description": "Orchestrator pattern for pi: specialist subagents, enforcement, code review loop, workflow commands",
   "keywords": [
     "pi-package"
@@ -15,6 +15,7 @@
     "extensions/pidiff/pidiff-ui"
   ],
   "files": [
+    "CHANGELOG.md",
     "extensions/acpx-provider/",
     "extensions/cli-provider/",
     "extensions/providers/",
@@ -76,10 +77,10 @@
     "ws": "^8.0.0"
   },
   "devDependencies": {
-    "@earendil-works/pi-agent-core": "^1.4.0",
-    "@earendil-works/pi-ai": "^1.4.0",
-    "@earendil-works/pi-coding-agent": "^1.4.0",
-    "@earendil-works/pi-tui": "^1.4.0",
+    "@earendil-works/pi-agent-core": "^1.5.0",
+    "@earendil-works/pi-ai": "^1.5.0",
+    "@earendil-works/pi-coding-agent": "^1.5.0",
+    "@earendil-works/pi-tui": "^1.5.0",
     "@types/node": "^22.20.1",
     "jsdom": "^30.1.1",
     "tsx": "^4.0.0"
@@ -100,6 +101,7 @@
     "protobufjs": "7.6.5"
   },
   "pi": {
+    "changelogPath": "./CHANGELOG.md",
     "extensions": [
       "./extensions"
     ],

package/prompts/release.md

@@ -128,7 +128,12 @@ root only).
   stage ONLY the files in `updated[]` plus the refreshed lockfile
   (`lockfile.path` when `lockfile.refreshed` is true — `refreshed: false`
   is a warning: run `uv lock` yourself before committing); each entry in `packages[]`
-  carries its per-package `tag` (`<name>@<version>`). Bump PR, merge,
+  carries its per-package `tag` (`<name>@<version>`). When
+  `pi-orchestrator-config` is among the bumped packages, also prepend its entry
+  to `CHANGELOG.md` — `## [<its new version>] - <YYYY-MM-DD>` plus its S3
+  changelog entries, newest first — and stage `CHANGELOG.md` with the bump
+  files, so the npm tarball carries the notes pi shows under Extension
+  Updates. Bump PR, merge,
   and branch sync follow the standard Phase 5 delegation (git-expert /
   github-expert), with the bump PR message `chore: bump version to
   <name1>@<v1>[, <name2>@<v2>...]` (keep the `chore: bump version`
@@ -275,6 +280,14 @@ Parse the JSON output from bump-version. Only stage the files listed in the
 `updated[]` array. If `skipped[]` is non-empty, inform the user which files were
 skipped and why before proceeding.
 
+When `pi-orchestrator-config` (the root `package.json`) was bumped, also write
+its notes into `CHANGELOG.md`: prepend `## [<VERSION>] - <YYYY-MM-DD>` followed
+by that package's changelog entries from Phase 3 (newest first, same bullet
+style as the entries already there), and stage `CHANGELOG.md` with the version
+files. The npm tarball ships the file and pi shows it under Extension Updates on
+the next launch — leave it alone and users keep seeing the previous version's
+notes.
+
 **Delegate git and GitHub operations to specialist agents:**
 
 1. **Delegate to `git-expert`:** Create branch, stage files, sync lockfile, commit, push: