@herbertgao/pi-extensions 2026.8.14 → 2026.8.15

package/node_modules/pi-web-access/github-extract.ts

@@ -1,4 +1,4 @@
-import { closeSync, existsSync, lstatSync, mkdirSync, openSync, readFileSync, readSync, readdirSync, realpathSync, rmSync, statSync, unlinkSync } from "node:fs";
+import { chmodSync, closeSync, existsSync, lstatSync, mkdirSync, mkdtempSync, openSync, readFileSync, readSync, readdirSync, realpathSync, rmSync, statSync, unlinkSync } from "node:fs";
 import { execFile, spawn, type ChildProcess } from "node:child_process";
 import { createHash } from "node:crypto";
 import { basename, dirname, extname, join, resolve as resolvePath, sep as pathSep } from "node:path";
@@ -59,6 +59,7 @@ interface GitHubCloneConfig {
 const cloneCache = new Map<string, CachedClone>();
 
 let cachedConfig: GitHubCloneConfig | null = null;
+let cloneRuntime: { parentPath: string; rootPath: string } | null = null;
 
 function normalizeEnabled(value: unknown, fallback: boolean): boolean {
 	return typeof value === "boolean" ? value : fallback;
@@ -189,10 +190,48 @@ function cacheKey(owner: string, repo: string, ref?: string): string {
 	return ref ? `${owner}/${repo}@${ref}` : `${owner}/${repo}`;
 }
 
+function removeCloneRuntime(parentPath: string, runtimePath: string): void {
+	const normalizedParentPath = resolvePath(parentPath);
+	const normalizedRuntimePath = resolvePath(runtimePath);
+	if (dirname(normalizedRuntimePath) !== normalizedParentPath || !basename(normalizedRuntimePath).startsWith("runtime-")) return;
+
+	try {
+		const entry = lstatSync(normalizedRuntimePath);
+		if (entry.isSymbolicLink()) unlinkSync(normalizedRuntimePath);
+		else rmSync(normalizedRuntimePath, { recursive: true, force: true });
+	} catch {
+		// The runtime directory may already have been removed externally.
+	}
+}
+
+function getCloneRuntimeRoot(config: GitHubCloneConfig): string | null {
+	if (cloneRuntime) return cloneRuntime.rootPath;
+
+	let parentPath: string | null = null;
+	let runtimePath: string | null = null;
+	try {
+		const configuredPath = resolvePath(config.clonePath);
+		mkdirSync(configuredPath, { recursive: true });
+		parentPath = realpathSync(configuredPath);
+		runtimePath = mkdtempSync(join(parentPath, "runtime-"));
+		chmodSync(runtimePath, 0o700);
+		const rootPath = realpathSync(runtimePath);
+		if (dirname(rootPath) !== parentPath) {
+			removeCloneRuntime(parentPath, runtimePath);
+			return null;
+		}
+		cloneRuntime = { parentPath, rootPath };
+		return rootPath;
+	} catch {
+		if (parentPath && runtimePath) removeCloneRuntime(parentPath, runtimePath);
+		return null;
+	}
+}
+
 function cloneDestination(config: GitHubCloneConfig, owner: string, repo: string, ref?: string): CloneDestination | null {
 	try {
-		mkdirSync(resolvePath(config.clonePath), { recursive: true });
-		const rootPath = realpathSync(resolvePath(config.clonePath));
+		const rootPath = getCloneRuntimeRoot(config);
+		if (!rootPath) return null;
 		const digest = createHash("sha256").update(JSON.stringify([owner, repo, ref ?? null])).digest("hex");
 		const localPath = resolvePath(rootPath, digest);
 		if (dirname(localPath) !== rootPath) return null;
@@ -742,5 +781,10 @@ export function clearCloneCache(): void {
 		removeCloneDestination(entry.destination);
 	}
 	cloneCache.clear();
+
+	if (cloneRuntime) {
+		removeCloneRuntime(cloneRuntime.parentPath, cloneRuntime.rootPath);
+	}
+	cloneRuntime = null;
 	cachedConfig = null;
 }

package/node_modules/pi-web-access/index.ts

@@ -2443,7 +2443,7 @@ export default function (pi: ExtensionAPI) {
 				description: "Fetch mode: readable (default extraction), raw (exact textual HTTP body), or answer (answer prompt using only fetched content).",
 			})),
 			answerModel: Type.Optional(Type.String({
-				description: "Optional provider/model-id override for mode answer. Defaults to the current Pi model.",
+				description: "Optional provider/model-id override for mode answer. Defaults to fetch.answerProvider + fetch.answerModel when configured, otherwise the current Pi model.",
 			})),
 			timestamp: Type.Optional(Type.String({
 				description: "Extract video frame(s) at a timestamp or time range. Single: '1:23:45', '23:45', or '85' (seconds). Range: '23:41-25:00' extracts evenly-spaced frames across that span (default 6). Use frames with ranges to control density; single+frames uses a fixed 5s interval. YouTube requires yt-dlp + ffmpeg; local videos require ffmpeg. Use a range when you know the approximate area but not the exact moment — you'll get a contact sheet to visually identify the right frame.",

package/node_modules/pi-web-access/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-web-access",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "description": "Web search, URL fetching, GitHub repo cloning, PDF extraction, YouTube video understanding, and local video analysis for Pi coding agent. Supports OpenAI, Brave, Parallel, TinyFish, Search1API, Searchinfinity, Querit, Tavily, Firecrawl, Jina, SERPdive, Kagi, Ollama, AnySearch, Bright Data SERP, SerpBase, SearXNG, Exa, Perplexity, Gemini, and Kimi.",
   "type": "module",
   "scripts": {

package/node_modules/pi-web-access/page-query.ts

@@ -1,6 +1,8 @@
 import { complete, type Api, type Message, type Model } from "@earendil-works/pi-ai/compat";
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { loadEnabledModelPatterns, modelMatchesEnabledPatterns } from "./summary-model-scope.ts";
+import { existsSync, readFileSync } from "node:fs";
+import { findModelWithProviderRouting, loadEnabledModelPatterns, modelMatchesEnabledPatterns } from "./summary-model-scope.ts";
+import { getWebSearchConfigPath } from "./utils.ts";
 
 const OUTPUT_TOKENS = 2_000;
 const INPUT_CONTEXT_FRACTION = 0.6;
@@ -16,7 +18,48 @@ export interface PageAnswer {
 	truncated: boolean;
 }
 
-function parseModelSelector(value: string): { provider: string; id: string } {
+interface AnswerModelSelector {
+	provider: string;
+	id: string;
+}
+
+function loadConfiguredAnswerModel(): AnswerModelSelector | undefined {
+	const configPath = getWebSearchConfigPath();
+	if (!existsSync(configPath)) return undefined;
+
+	let raw: unknown;
+	try {
+		raw = JSON.parse(readFileSync(configPath, "utf8"));
+	} catch (err) {
+		const message = err instanceof Error ? err.message : String(err);
+		throw new Error(`Failed to parse ${configPath}: ${message}`);
+	}
+
+	const root = raw && typeof raw === "object" && !Array.isArray(raw)
+		? raw as Record<string, unknown>
+		: undefined;
+	const fetchConfig = root?.fetch;
+	if (!fetchConfig || typeof fetchConfig !== "object" || Array.isArray(fetchConfig)) return undefined;
+	const values = fetchConfig as Record<string, unknown>;
+	const hasProvider = Object.hasOwn(values, "answerProvider");
+	const hasModel = Object.hasOwn(values, "answerModel");
+	if (!hasProvider && !hasModel) return undefined;
+
+	const provider = values.answerProvider;
+	const model = values.answerModel;
+	if (hasProvider && (typeof provider !== "string" || provider.trim().length === 0)) {
+		throw new Error(`fetch.answerProvider in ${configPath} must be a non-empty string`);
+	}
+	if (hasModel && (typeof model !== "string" || model.trim().length === 0)) {
+		throw new Error(`fetch.answerModel in ${configPath} must be a non-empty string`);
+	}
+	if (!hasProvider || !hasModel) {
+		throw new Error(`fetch.answerProvider and fetch.answerModel must be configured together in ${configPath}`);
+	}
+	return { provider: (provider as string).trim(), id: (model as string).trim() };
+}
+
+function parseModelSelector(value: string): AnswerModelSelector {
 	const separator = value.indexOf("/");
 	if (separator <= 0 || separator === value.length - 1) {
 		throw new Error(`Invalid answerModel: ${value}. Use provider/model-id.`);
@@ -24,14 +67,20 @@ function parseModelSelector(value: string): { provider: string; id: string } {
 	return { provider: value.slice(0, separator), id: value.slice(separator + 1) };
 }
 
-function resolveModel(ctx: ExtensionContext, override?: string): Model<Api> {
-	const model = override
+function resolveModel(ctx: ExtensionContext, override?: string, configured?: AnswerModelSelector): Model<Api> {
+	const selector = override ? parseModelSelector(override) : configured;
+	const model = selector
 		? (() => {
-			const selector = parseModelSelector(override);
-			return ctx.modelRegistry.find(selector.provider, selector.id);
+			return findModelWithProviderRouting(ctx.modelRegistry, selector.provider, selector.id);
 		})()
 		: ctx.model;
-	if (!model) throw new Error(override ? `Answer model not found: ${override}` : "No current model available for page answering");
+	if (!model) {
+		if (override) throw new Error(`Answer model not found: ${override}`);
+		if (configured) {
+			throw new Error(`Answer model not found: ${configured.provider}/${configured.id} (from fetch.answerProvider/fetch.answerModel in ${getWebSearchConfigPath()})`);
+		}
+		throw new Error("No current model available for page answering");
+	}
 	if (!model.input.includes("text")) throw new Error(`Answer model does not support text input: ${model.provider}/${model.id}`);
 	if (!modelMatchesEnabledPatterns(model, loadEnabledModelPatterns(ctx))) {
 		throw new Error(`Answer model is not enabled: ${model.provider}/${model.id}`);
@@ -53,7 +102,11 @@ export async function answerFromPage(
 	ctx: ExtensionContext,
 	signal?: AbortSignal,
 ): Promise<PageAnswer> {
-	const model = resolveModel(ctx, input.model);
+	// Resolve an explicit per-call model first. In particular, do not read a
+	// malformed or partial config when the caller has supplied an override.
+	const model = input.model
+		? resolveModel(ctx, input.model)
+		: resolveModel(ctx, undefined, loadConfiguredAnswerModel());
 	const auth = await ctx.modelRegistry.getApiKeyAndHeaders(model);
 	if (!auth.ok || !auth.apiKey) throw new Error(`No API key available for answer model ${model.provider}/${model.id}`);
 	const registry = ctx.modelRegistry as typeof ctx.modelRegistry & { complete?: typeof complete };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herbertgao/pi-extensions",
-  "version": "2026.8.14",
+  "version": "2026.8.15",
   "description": "Aggregate installer for HerbertGao-maintained Pi extensions.",
   "keywords": [
     "extensions",
@@ -37,17 +37,18 @@
   "dependencies": {
     "@ast-grep/cli": "^0.45.0",
     "@ast-grep/napi": "^0.45.0",
-    "@czottmann/pi-automode": "1.14.0",
+    "@czottmann/pi-automode": "1.15.0",
     "@dietrichgebert/ponytail": "4.9.0",
-    "@earendil-works/pi-coding-agent": "^0.84.2",
-    "@earendil-works/pi-tui": "^0.84.2",
+    "@earendil-works/pi-coding-agent": "^0.84.4",
+    "@earendil-works/pi-tui": "^0.84.4",
     "@effect/platform-node": "4.0.0-beta.103",
     "@effect/platform-node-shared": "4.0.0-beta.103",
+    "@herbertgao/pi-bark": "0.1.0",
     "@herbertgao/pi-cc-extensions": "0.8.60",
     "@herbertgao/pi-subagents": "0.17.1",
     "@herbertgao/resume-from": "0.2.0",
-    "@juicesharp/rpiv-ask-user-question": "2.7.1",
-    "@juicesharp/rpiv-config": "^2.7.1",
+    "@juicesharp/rpiv-ask-user-question": "2.8.0",
+    "@juicesharp/rpiv-config": "^2.8.0",
     "@luxusai/pi-hindsight": "0.12.0",
     "@modelcontextprotocol/client": "2.0.0",
     "@modelcontextprotocol/core": "2.0.0",
@@ -55,20 +56,19 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@mozilla/readability": "^0.6.0",
     "@napi-rs/keyring": "^1.3.0",
-    "@narumitw/pi-btw": "0.55.4",
+    "@narumitw/pi-btw": "0.56.0",
     "@narumitw/pi-tui-kit": "^0.59.0",
     "@noble/ed25519": "^3.1.0",
     "@pi-plugins/fast-mode": "0.1.10",
     "@shikijs/cli": "^4.0.2",
     "@sinclair/typebox": "^0.34.49",
     "@tifan/pi-copy-response": "0.2.6",
-    "@tifan/pi-handoff": "2.0.1",
+    "@tifan/pi-handoff": "2.2.0",
     "@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.5",
-    "@tifan/pi-rename": "0.5.1",
-    "@tifan/pi-titlebar-spinner": "0.1.3",
+    "@tifan/pi-recap": "0.4.6",
+    "@tifan/pi-rename": "0.6.0",
     "@vectorize-io/hindsight-client": "^0.9.0",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
@@ -88,9 +88,9 @@
     "open": "^10.2.0",
     "p-limit": "^6.1.0",
     "pi-footer": "0.5.1",
-    "pi-lens": "4.1.2",
-    "pi-mcp-adapter": "2.30.0",
-    "pi-web-access": "0.26.0",
+    "pi-lens": "4.1.3",
+    "pi-mcp-adapter": "2.31.0",
+    "pi-web-access": "0.27.0",
     "pidusage": "^4.0.1",
     "promise.try": "^2.0.1",
     "qrcode-terminal": "^0.12.0",
@@ -113,6 +113,7 @@
   "bundledDependencies": [
     "@czottmann/pi-automode",
     "@dietrichgebert/ponytail",
+    "@herbertgao/pi-bark",
     "@herbertgao/pi-cc-extensions",
     "@herbertgao/pi-subagents",
     "@herbertgao/resume-from",
@@ -127,7 +128,6 @@
     "@tifan/pi-preferred-thinking",
     "@tifan/pi-recap",
     "@tifan/pi-rename",
-    "@tifan/pi-titlebar-spinner",
     "pi-footer",
     "pi-lens",
     "pi-mcp-adapter",
@@ -151,8 +151,8 @@
       "./node_modules/@tifan/pi-recap/src/index.ts",
       "./node_modules/@tifan/pi-rename/src/index.ts",
       "./node_modules/@herbertgao/pi-subagents/src/index.ts",
-      "./node_modules/@tifan/pi-titlebar-spinner/src/index.ts",
       "./node_modules/@juicesharp/rpiv-ask-user-question/index.ts",
+      "./node_modules/@herbertgao/pi-bark/src/index.ts",
       "./node_modules/@luxusai/pi-hindsight/extensions/index.ts",
       "./node_modules/@narumitw/pi-btw/dist/index.ts",
       "./node_modules/@pi-plugins/fast-mode/dist/index.mjs",

package/node_modules/@tifan/pi-titlebar-spinner/README.md

@@ -1,24 +0,0 @@
-# @tifan/pi-titlebar-spinner
-
-Show a braille spinner in the pi titlebar while the agent runs.
-
-The spinner starts on `agent_start` and stops when the agent settles or the session shuts down. When it stops, the extension restores the default `π - [session - ]cwd` title.
-
-[add image: titlebar spinner while agent runs]
-
-- The titlebar while the spinner is active.
-- The restored titlebar after the agent finishes.
-
-## Install
-
-```bash
-pi install npm:@tifan/pi-titlebar-spinner
-```
-
-## Release notes
-
-See [CHANGELOG.md](CHANGELOG.md)
-
-## License
-
-[MIT](LICENSE)

package/node_modules/@tifan/pi-titlebar-spinner/package.json

@@ -1,39 +0,0 @@
-{
-  "name": "@tifan/pi-titlebar-spinner",
-  "version": "0.1.3",
-  "description": "Show a spinner in the pi titlebar while the agent runs.",
-  "keywords": [
-    "pi",
-    "pi-extension",
-    "pi-package",
-    "spinner",
-    "titlebar"
-  ],
-  "homepage": "https://github.com/tifandotme/pi-extensions/tree/master/packages/pi-titlebar-spinner#readme",
-  "bugs": "https://github.com/tifandotme/pi-extensions/issues",
-  "license": "MIT",
-  "author": "Tifan Dwi Avianto <hi@tifan.me>",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/tifandotme/pi-extensions.git",
-    "directory": "packages/pi-titlebar-spinner"
-  },
-  "files": [
-    "src/**/*.ts",
-    "README.md",
-    "LICENSE"
-  ],
-  "type": "module",
-  "publishConfig": {
-    "access": "public",
-    "provenance": true
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "pi": {
-    "extensions": [
-      "./src/index.ts"
-    ]
-  }
-}

package/node_modules/@tifan/pi-titlebar-spinner/src/index.ts

@@ -1,49 +0,0 @@
-import path from "node:path"
-import type {
-  ExtensionAPI,
-  ExtensionContext,
-} from "@earendil-works/pi-coding-agent"
-
-const FRAMES = ["⡿", "⣟", "⣯", "⣷", "⣾", "⣽", "⣻", "⢿"]
-const INTERVAL_MS = 70
-
-function baseTitle(pi: ExtensionAPI, cwdPath: string): string {
-  const cwd = path.basename(cwdPath)
-  const session = pi.getSessionName()
-  return session ? `π - ${session} - ${cwd}` : `π - ${cwd}`
-}
-
-export default function (pi: ExtensionAPI): void {
-  let timer: ReturnType<typeof setInterval> | undefined
-  let frameIndex = 0
-
-  function stop(ctx: ExtensionContext): void {
-    if (timer) {
-      clearInterval(timer)
-      timer = undefined
-    }
-    frameIndex = 0
-    ctx.ui.setTitle(baseTitle(pi, ctx.cwd))
-  }
-
-  function start(ctx: ExtensionContext): void {
-    stop(ctx)
-    timer = setInterval(() => {
-      const frame = FRAMES[frameIndex % FRAMES.length]
-      ctx.ui.setTitle(`${frame} ${baseTitle(pi, ctx.cwd)}`)
-      frameIndex++
-    }, INTERVAL_MS)
-  }
-
-  pi.on("agent_start", async (_event, ctx) => {
-    start(ctx)
-  })
-
-  pi.on("agent_settled", async (_event, ctx) => {
-    stop(ctx)
-  })
-
-  pi.on("session_shutdown", async (_event, ctx) => {
-    stop(ctx)
-  })
-}