@herbertgao/pi-extensions 2026.9.16 → 2026.9.18

package/README.md

@@ -10,6 +10,14 @@ pi install npm:@herbertgao/pi-extensions
 
 Requires Node.js 24 or newer and Pi 0.85.1 or newer.
 
+## Native MCP
+
+MCP is provided by Pi 0.99.0+, not by a bundled extension. Configure servers in `~/.pi/agent/mcp.json` and use `/mcp` to manage them. Older Pi versions need an upgrade to retain MCP support.
+
+When migrating from `pi-mcp-adapter`, remove any standalone adapter install as well. Native MCP uses `exposure: "direct"` instead of `directTools: true`; tools default to `codemode` exposure. Adapter-only settings such as `lifecycle`, `mcpFooterStatus`, and `showStatusIcon` are not native settings. OAuth servers may require signing in again with `pi mcp login <server>`. See Pi's [MCP documentation](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/mcp.md).
+
+## Bundled extensions
+
 The package bundles 6 active `@herbertgao/*` child packages—`pi-bark`, `pi-cc-extensions`, `resume-from`, `pi-subagents`, `sol-pi`, and the maintained Antigravity provider mirror—plus the following upstream packages under their original names:
 
 - `pi-antigravity@0.7.2`
@@ -20,14 +28,13 @@ The package bundles 6 active `@herbertgao/*` child packages—`pi-bark`, `pi-cc-
 - `@narumitw/pi-caffeinate@0.49.7`
 - `@pi-plugins/fast-mode@0.1.10`
 - `@tifan/pi-copy-response@0.2.6`
-- `@tifan/pi-handoff@2.2.0`
+- `@tifan/pi-handoff@2.2.2`
 - `@tifan/pi-inline-skills@1.0.5`
 - `@tifan/pi-mermaid-open@0.2.0`
 - `@tifan/pi-preferred-thinking@1.0.1`
 - `@tifan/pi-recap@0.4.6`
 - `@tifan/pi-rename@0.6.0`
-- `pi-mcp-adapter@2.31.0`
-- `pi-typesafe@0.7.1`
+- `pi-typesafe@0.8.0`
 - `pi-multi-account@1.23.2`
 - `pi-next-cue@1.0.7`
 - `pi-footer@0.5.1`
@@ -44,7 +51,7 @@ Pi loads their extensions and skills through `node_modules/` paths inside one pa
 
 `@narumitw/pi-caffeinate@0.49.7` uses the host platform's sleep inhibitor during each Pi agent run. On macOS, `/caffeinate sleep` keeps the system awake while allowing the display to sleep; `/caffeinate display` also keeps the display awake. It releases the inhibitor when the run or session ends.
 
-`pi-jev-auto-mode@0.5.0` adds fail-closed Jev safety gates for shell commands and file changes. `pi-typesafe@0.7.1` adds the `/typesafe` command and `typesafe_evaluate` tool for explicit structured decisions; both use the TypeSafe API after login.
+`pi-jev-auto-mode@0.5.0` adds fail-closed Jev safety gates for shell commands and file changes. `pi-typesafe@0.8.0` adds the `/typesafe` command and `typesafe_evaluate` tool for explicit structured decisions; both use the TypeSafe API after login.
 
 `@herbertgao/resume-from@0.2.0` keeps Claude Code sessions associated with their original repository when the active transcript later moves into a nested cwd. `@herbertgao/sol-pi@0.1.0` adds opt-in Action Fusion, ObservationPack, Evidence-Preserving Reducer, and Online Context Compact; see its [configuration guide](../sol-pi/docs/configuration.md). `pi-lens@4.2.1` expands language routing and bounds retained diagnostic facts across multi-root sessions. `pi-web-access@0.27.0` adds configurable fetch deadlines and answer models plus isolated GitHub clone runtimes. Preferred Thinking 1.0.1 preserves an explicit subagent `--thinking` choice. Deprecated `@tifan/pi-titlebar-spinner` is no longer bundled; Rename remains the single owner of Herdr tab naming.
 
@@ -64,22 +71,14 @@ pi remove npm:pi-footer@0.5.1
 
 `pi-footer` is enabled by the aggregate. It preserves the native path, Git branch, session, token/context, model, and thinking information. Configure it in `$PI_CODING_AGENT_DIR/extensions/pi-footer.json`; use `/footer` for interactive changes. Only one footer-replacement extension should be enabled at a time.
 
-For the intended compact status text, merge these optional companion settings into existing files rather than replacing the files:
+For the intended compact status text, merge the optional pi-lens widget setting into its existing file rather than replacing the file:
 
 ```jsonc
-// ~/.pi/agent/mcp.json
-{
-  "settings": {
-    "mcpFooterStatus": "compact",
-    "showStatusIcon": false
-  }
-}
-
 // ~/.pi-lens/config.json
 {
   "widget": {
-    "visible": false
-  }
+    "visible": false,
+  },
 }
 ```
 

package/node_modules/@herbertgao/pi-bark/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herbertgao/pi-bark",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Send Bark notifications when Pi finishes or needs user input.",
   "keywords": [
     "bark",
@@ -39,7 +39,7 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "^0.87.1"
+    "@earendil-works/pi-coding-agent": "*"
   },
   "engines": {
     "node": ">=24"

package/node_modules/@herbertgao/pi-cc-extensions/README.en.md

@@ -87,13 +87,16 @@ bun run typecheck
 
 - Node.js `>=24`, Pi `^0.84.0 || ^0.85.0` (loaded through `pi.extensions` and `pi.themes` in the root `package.json`)
 
+## Built-in capabilities
+
+Pi 0.99+ provides native MCP tools and `/mcp` management; do not install another MCP extension that registers `/mcp`.
+
 ## Recommended companions
 
 | Extension                                | Purpose                                                      |
 | ------------------------------------------ | -------------------------------------------------------------- |
 | `npm:@tintinweb/pi-subagents`            | Parallel SubAgents, background tasks, and worktree isolation |
 | `npm:@tintinweb/pi-tasks`                | Claude Code-style task tracking and coordination             |
-| `npm:pi-mcp-adapter`                     | On-demand MCP tool discovery with lower context usage        |
 | `npm:@ff-labs/pi-fff`                    | FFF-powered fuzzy file and content search (fffind / ffgrep)  |
 | `npm:pi-web-access`                      | Web search, URL fetching, GitHub cloning, PDF/video parsing  |
 | `npm:pi-theme-picker`                    | Theme search and live preview                                |

package/node_modules/@herbertgao/pi-cc-extensions/README.md

@@ -87,13 +87,16 @@ bun run typecheck
 
 - Node.js `>=24`，Pi `^0.84.0 || ^0.85.0`（通过根目录 `package.json` 的 `pi.extensions` 和 `pi.themes` 加载）
 
+## 内置能力
+
+Pi 0.99+ 的内置 MCP 负责 MCP 工具与 `/mcp` 管理；不要再安装会注册 `/mcp` 的第三方 MCP 扩展。
+
 ## 推荐搭配
 
 | 扩展                                     | 用途                                             |
 | ------------------------------------------ | -------------------------------------------------- |
 | `npm:@tintinweb/pi-subagents`            | 并行 SubAgent、后台任务与工作树隔离              |
 | `npm:@tintinweb/pi-tasks`                | Claude Code 风格任务跟踪与协调                   |
-| `npm:pi-mcp-adapter`                     | 按需发现 MCP 工具，减少上下文占用                |
 | `npm:@ff-labs/pi-fff`                    | 模糊文件与内容检索（fffind / ffgrep）            |
 | `npm:pi-web-access`                      | 网页搜索、URL 抓取、GitHub 克隆、PDF/视频解析    |
 | `npm:pi-theme-picker`                    | 主题搜索和实时预览                               |

package/node_modules/@herbertgao/pi-cc-extensions/package.json

@@ -1,77 +1,77 @@
 {
-	"name": "@herbertgao/pi-cc-extensions",
-	"version": "0.9.5",
-	"license": "MIT",
-	"description": "A Pi productivity suite with Claude Code-style UI, context inspection, and agent/session references",
-	"type": "module",
-	"keywords": [
-		"pi-package",
-		"pi-extension",
-		"pi-coding-agent",
-		"claude-code"
-	],
-	"homepage": "https://github.com/HerbertGao/pi-extensions/tree/master/packages/pi-cc-extensions#readme",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/HerbertGao/pi-extensions.git",
-		"directory": "packages/pi-cc-extensions"
-	},
-	"bugs": {
-		"url": "https://github.com/HerbertGao/pi-extensions/issues"
-	},
-	"author": "Herbert Gao",
-	"files": [
-		"extensions",
-		"assets/readme",
-		"themes",
-		"README.md",
-		"README.en.md",
-		"LICENSE"
-	],
-	"pi": {
-		"extensions": [
-			"./extensions/index.ts"
-		],
-		"themes": [
-			"./themes/cc-dark.json",
-			"./themes/cc-light.json"
-		],
-		"image": "https://raw.githubusercontent.com/HerbertGao/pi-extensions/master/packages/pi-cc-extensions/assets/readme/welcome.webp",
-		"video": "https://github.com/user-attachments/assets/debf76ea-a9dc-4f34-977f-aae344a9a7f8"
-	},
-	"scripts": {
-		"test": "node --test tests/**/*.test.ts",
-		"typecheck": "node scripts/typecheck.mjs",
-		"format": "biome format --write .",
-		"format:check": "biome format ."
-	},
-	"dependencies": {
-		"@shikijs/cli": "^4.0.2",
-		"grok-mermaid": "^0.2.2",
-		"jiti": "^2.7.0"
-	},
-	"peerDependencies": {
-		"@earendil-works/pi-ai": "^0.87.1",
-		"@earendil-works/pi-coding-agent": "^0.87.1",
-		"@earendil-works/pi-tui": "^0.87.1"
-	},
-	"engines": {
-		"node": ">=24"
-	},
-	"publishConfig": {
-		"access": "public",
-		"provenance": true
-	},
-	"devDependencies": {
-		"@biomejs/biome": "2.5.5",
-		"@types/node": "^26.1.1",
-		"typescript": "^5.9.3"
-	},
-	"x-upstream": {
-		"package": "pi-cc-extensions",
-		"version": "0.8.71",
-		"reviewedVersion": "0.9.5",
-		"repository": "https://github.com/minuque/pi-cc-extensions",
-		"commit": "e43e0041b59f5d7f03be9b9d103a5f9e954e4c11"
-	}
+  "name": "@herbertgao/pi-cc-extensions",
+  "version": "0.9.6",
+  "license": "MIT",
+  "description": "A Pi productivity suite with Claude Code-style UI, context inspection, and agent/session references",
+  "type": "module",
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "pi-coding-agent",
+    "claude-code"
+  ],
+  "homepage": "https://github.com/HerbertGao/pi-extensions/tree/master/packages/pi-cc-extensions#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HerbertGao/pi-extensions.git",
+    "directory": "packages/pi-cc-extensions"
+  },
+  "bugs": {
+    "url": "https://github.com/HerbertGao/pi-extensions/issues"
+  },
+  "author": "Herbert Gao",
+  "files": [
+    "extensions",
+    "assets/readme",
+    "themes",
+    "README.md",
+    "README.en.md",
+    "LICENSE"
+  ],
+  "pi": {
+    "extensions": [
+      "./extensions/index.ts"
+    ],
+    "themes": [
+      "./themes/cc-dark.json",
+      "./themes/cc-light.json"
+    ],
+    "image": "https://raw.githubusercontent.com/HerbertGao/pi-extensions/master/packages/pi-cc-extensions/assets/readme/welcome.webp",
+    "video": "https://github.com/user-attachments/assets/debf76ea-a9dc-4f34-977f-aae344a9a7f8"
+  },
+  "scripts": {
+    "test": "node --test tests/**/*.test.ts",
+    "typecheck": "node scripts/typecheck.mjs",
+    "format": "biome format --write .",
+    "format:check": "biome format ."
+  },
+  "dependencies": {
+    "@shikijs/cli": "^4.0.2",
+    "grok-mermaid": "^0.2.2",
+    "jiti": "^2.7.0"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.5",
+    "@types/node": "^26.1.1",
+    "typescript": "^5.9.3"
+  },
+  "x-upstream": {
+    "package": "pi-cc-extensions",
+    "version": "0.8.71",
+    "reviewedVersion": "0.9.5",
+    "repository": "https://github.com/minuque/pi-cc-extensions",
+    "commit": "e43e0041b59f5d7f03be9b9d103a5f9e954e4c11"
+  }
 }

package/node_modules/@herbertgao/pi-subagents/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.18.4
+
+### Patch Changes
+
+- [#248](https://github.com/HerbertGao/pi-extensions/pull/248) [`c14c004`](https://github.com/HerbertGao/pi-extensions/commit/c14c0042a8e02862cd6718dd60e4ffb22314165c) Thanks [@HerbertGao](https://github.com/HerbertGao)! - Use Pi 0.99+'s native MCP implementation instead of registering the removed `pi-mcp-adapter`, declare Pi-hosted packages as wildcard peers, update `@tifan/pi-handoff` to 2.2.2 for its Herdr startup retry fix, and pin `pi-typesafe` to 0.8.0.
+
 ## 0.18.3
 
 ### Patch Changes

package/node_modules/@herbertgao/pi-subagents/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herbertgao/pi-subagents",
-  "version": "0.18.3",
+  "version": "0.18.4",
   "description": "Claude Code-style autonomous subagents and workflow orchestration for Pi, with HerbertGao-maintained UI extensions.",
   "keywords": [
     "agent",
@@ -45,18 +45,18 @@
     "test:coverage": "vitest run --coverage"
   },
   "dependencies": {
-    "@sinclair/typebox": "^0.34.49",
     "croner": "^10.0.1",
-    "nanoid": "^5.1.16",
-    "typebox": "^1.3.7"
+    "nanoid": "^5.1.16"
   },
   "devDependencies": {
     "@vitest/coverage-istanbul": "^4.1.10"
   },
   "peerDependencies": {
-    "@earendil-works/pi-ai": "^0.87.1",
-    "@earendil-works/pi-coding-agent": "^0.87.1",
-    "@earendil-works/pi-tui": "^0.87.1"
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "@sinclair/typebox": "*",
+    "typebox": "*"
   },
   "engines": {
     "node": ">=24"

package/node_modules/@herbertgao/resume-from/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herbertgao/resume-from",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Continue a coding session in a different agent, or a different profile.",
   "keywords": [
     "pi-package",
@@ -63,9 +63,11 @@
     "vitest": "^4.1.10"
   },
   "dependencies": {
-    "@earendil-works/pi-tui": "^0.87.1",
     "gpt-tokenizer": "^3.4.0"
   },
+  "peerDependencies": {
+    "@earendil-works/pi-tui": "*"
+  },
   "pi": {
     "extensions": [
       "./shims/pi/extensions/resume-from.js"

package/node_modules/@herbertgao/sol-pi/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herbertgao/sol-pi",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Token-efficient context and tool extensions for Pi, maintained from NVlabs/SoL-Pi.",
   "keywords": [
     "pi-package",
@@ -47,11 +47,11 @@
     "check": "npm run typecheck && npm test && npm pack --dry-run"
   },
   "peerDependencies": {
-    "@earendil-works/pi-agent-core": "^0.87.1",
-    "@earendil-works/pi-ai": "^0.87.1",
-    "@earendil-works/pi-coding-agent": "^0.87.1",
-    "@earendil-works/pi-tui": "^0.87.1",
-    "typebox": ">=1.3.7"
+    "@earendil-works/pi-agent-core": "*",
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "typebox": "*"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

package/node_modules/@herbertgao/sol-pi/src/sol-pi/extensions/online-context-compact/extension.ts

@@ -49,7 +49,6 @@ export type OnlineContextCompactOptions = {
 type PendingBoundary = { readonly toolCallId: string };
 type SelectedCompaction = { readonly decision: CompactionDecision };
 type CacheDebt = { readonly debtTokens: number; readonly repaymentTokens: number };
-type PendingContinuation = { readonly promise: Promise<void>; readonly resolve: () => void };
 
 const SUBAGENTS_MANAGER_KEY = Symbol.for("pi-subagents:manager");
 
@@ -197,10 +196,6 @@ function restoreCompactionThinking(pi: ExtensionAPI, override: CompactionThinkin
 	}
 }
 
-function releaseParentContinuation(continuation: PendingContinuation | undefined): void {
-	if (continuation) setTimeout(continuation.resolve, 0);
-}
-
 export function createOnlineContextCompactExtension(options: OnlineContextCompactOptions = {}): ExtensionFactory {
 	const keepRecentTokens = resolveKeepRecentTokens(options.keepRecentTokens);
 	const cacheWriteReadRatio = resolveCacheWriteReadRatio(options.cacheWriteReadRatio);
@@ -212,17 +207,10 @@ export function createOnlineContextCompactExtension(options: OnlineContextCompac
 		let pendingBoundary: PendingBoundary | undefined;
 		let selected: SelectedCompaction | undefined;
 		let activeDebt: CacheDebt | undefined;
-		let nextContinuation: PendingContinuation | undefined;
 		let compactionInFlight = false;
 		let compactionThinkingOverride: CompactionThinkingOverride | undefined;
 
-		const releaseContinuation = (): void => {
-			const continuation = nextContinuation;
-			nextContinuation = undefined;
-			continuation?.resolve();
-		};
 		const restore = (context: ExtensionContext): void => {
-			releaseContinuation();
 			state = restoreOnlineState(context.sessionManager.getBranch());
 			restored = true;
 			observedMessages = buildSessionContext(
@@ -358,21 +346,13 @@ export function createOnlineContextCompactExtension(options: OnlineContextCompac
 		});
 
 		pi.on("agent_settled", async (_event, context) => {
-			// sendMessage() starts a turn without returning its promise. Capture the
-			// child settlement so print/JSON mode cannot dispose while it is running.
-			const parentContinuation = nextContinuation;
-			nextContinuation = undefined;
 			const pending = selected;
 			selected = undefined;
 			if (!context.isIdle()) {
 				selected = pending;
-				nextContinuation = parentContinuation;
-				return;
-			}
-			if (!pending || hasRunningSubagents()) {
-				releaseParentContinuation(parentContinuation);
 				return;
 			}
+			if (!pending || hasRunningSubagents()) return;
 
 			activeDebt = {
 				debtTokens: pending.decision.writeTokens * (pending.decision.incrementalCacheCostRatio ?? 0),
@@ -428,43 +408,22 @@ export function createOnlineContextCompactExtension(options: OnlineContextCompac
 				}
 
 				if (compacted) {
-					let resolveContinuation!: () => void;
-					const continuation: PendingContinuation = {
-						promise: new Promise<void>((resolve) => {
-							resolveContinuation = resolve;
-						}),
-						resolve: () => resolveContinuation(),
-					};
-					nextContinuation = continuation;
-					try {
-						pi.sendMessage(
-							{
-								customType: "sol-pi-online-context-compact",
-								content: POST_COMPACTION_PLAN_REMINDER,
-								display: false,
-							},
-							{ triggerTurn: true },
-						);
-					} catch (error) {
-						if (nextContinuation === continuation) nextContinuation = undefined;
-						continuation.resolve();
-						throw error;
-					}
-					// triggerTurn starts on the next event-loop turn; checking immediately is racy.
-					await new Promise<void>((resolve) => setTimeout(resolve, 0));
-					if (context.isIdle() && nextContinuation === continuation) {
-						nextContinuation = undefined;
-						continuation.resolve();
-						throw new Error("Online context compact continuation did not start");
-					}
-					await continuation.promise;
+					// Pi >=0.87 defers this turn until agent_settled handlers finish and
+					// awaits it before prompt() resolves, so print/JSON mode stays alive.
+					pi.sendMessage(
+						{
+							customType: "sol-pi-online-context-compact",
+							content: POST_COMPACTION_PLAN_REMINDER,
+							display: false,
+						},
+						{ triggerTurn: true },
+					);
 				}
 			} finally {
 				restoreCompactionThinking(pi, compactionThinkingOverride);
 				compactionThinkingOverride = undefined;
 				compactionInFlight = false;
 				activeDebt = undefined;
-				releaseParentContinuation(parentContinuation);
 			}
 		});
 
@@ -487,7 +446,6 @@ export function createOnlineContextCompactExtension(options: OnlineContextCompac
 		pi.on("session_shutdown", () => {
 			restoreCompactionThinking(pi, compactionThinkingOverride);
 			compactionThinkingOverride = undefined;
-			releaseContinuation();
 			pendingBoundary = undefined;
 			selected = undefined;
 			activeDebt = undefined;