@herbertgao/pi-extensions 2026.9.20 → 2026.10.0

package/node_modules/@herbertgao/pi-cc-extensions/extensions/renderer/tool/result.ts

@@ -1,6 +1,7 @@
 import { Text, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
 import { inspect } from "node:util";
 import { config } from "../../config/config.ts";
+import { createCodeBlockHighlighter } from "./diff/diff-highlight.ts";
 import { showMoreHintText } from "./show-more-hint.ts";
 import { TOOL_LOADING_INTERVAL_MS, toolLoadingIcon } from "../../utils/tool-loading-icon.ts";
 import { getToolMouseTui } from "../mouse/scroll.ts";
@@ -231,7 +232,7 @@ export class ExpandedToolResultText {
 }
 
 /** 截断体末行 `… +N more lines` 旁的展开提示，点击打开全量预览。 */
-export const SHOW_MORE_LABEL = "• click to show more";
+export const SHOW_MORE_LABEL = "· click to show more";
 
 export type ToolIoSection = "input" | "output";
 
@@ -268,6 +269,17 @@ export class ExpandedToolIoView {
 	private truncated: { input: boolean; output: boolean } = { input: false, output: false };
 	/** 0-based header line indexes that carry show-more after last render. */
 	private showMoreHeaderRows: { input?: number; output?: number } = {};
+	/** Input 里的代码块（codemode 的 `code`）：着色行覆盖默认 dim/muted 样式。 */
+	private inputCode?:
+		| {
+				startLine: number;
+				language: string;
+				standalone: boolean;
+				code: string;
+				theme: unknown;
+				rows: () => string[];
+		  }
+		| undefined;
 
 	/** flushLeft：贴左渲染（mode=on 展开卡）；默认 false 保留前导空格（compact 等共用路径）。 */
 	private flushLeft: boolean;
@@ -325,6 +337,57 @@ export class ExpandedToolIoView {
 		return this.inputBody;
 	}
 
+	/**
+	 * 登记 Input 里的代码块：同步 cli-highlight 打底，shiki 异步升级，落地后
+	 * 经 invalidate 重画。同一份代码与主题只建一次（视图按宽度缓存行）。
+	 */
+	setInputCode(block: InputCodeBlock | undefined): void {
+		if (!block) {
+			if (this.inputCode) {
+				this.inputCode = undefined;
+				this.invalidate();
+			}
+			return;
+		}
+		if (this.inputCode?.code === block.code && this.inputCode.theme === this.theme) {
+			this.inputCode.startLine = block.startLine;
+			this.inputCode.standalone = block.standalone;
+			return;
+		}
+		this.inputCode = {
+			startLine: block.startLine,
+			language: block.language,
+			standalone: block.standalone,
+			code: block.code,
+			theme: this.theme,
+			rows: createCodeBlockHighlighter(block.code, block.language, this.theme, () => {
+				// 视图自己的行缓存 + 外层工具卡（清 paint 缓存并 requestRender）
+				this.invalidate();
+				invalidateIoView(this);
+			}),
+		};
+		this.invalidate();
+	}
+
+	/**
+	 * 整段 Input 就是代码块时给出语言与代码，供全量预览包一层围栏（弹框按 Markdown
+	 * 渲染，围栏代码块由 pi 的 highlightCode 着色）。混了别的字段时返回 undefined。
+	 */
+	getInputCodeFence(): { language: string; code: string } | undefined {
+		const block = this.inputCode;
+		return block?.standalone ? { language: block.language, code: block.code } : undefined;
+	}
+
+	/** 代码块里某一源行的着色内容（已剥掉行首缩进）；不在块内时为 undefined。 */
+	private inputCodeLine(sourceIndex: number): string | undefined {
+		const block = this.inputCode;
+		if (!block) return undefined;
+		const offset = sourceIndex - block.startLine;
+		if (offset < 0) return undefined;
+		const rows = block.rows();
+		return offset < rows.length ? rows[offset] : undefined;
+	}
+
 	getOutputBody(): string {
 		return this.outputBody.trim() ? this.outputBody : "Done";
 	}
@@ -342,7 +405,7 @@ export class ExpandedToolIoView {
 	/** True when the plain truncation footer carries show-more. Input 续行带 │，Output 不带。 */
 	matchShowMoreLine(plainLine: string): ToolIoSection | null {
 		const line = plainLine.replace(/\x1b\[[0-9;]*m/g, "");
-		if (!line.includes(` • ${showMoreHintText()}`) || !/\+\d+ more lines/.test(line)) return null;
+		if (!line.includes(` · ${showMoreHintText()}`) || !/\+\d+ more lines/.test(line)) return null;
 		if (this.truncated.input && line.includes("│")) return "input";
 		if (this.truncated.output) return "output";
 		return null;
@@ -363,7 +426,7 @@ export class ExpandedToolIoView {
 	/** Column range (1-based, visible cells) of show-more on a rendered header, if present. */
 	showMoreHitbox(plainLine: string): { startCol: number; endCol: number } | null {
 		const line = plainLine.replace(/\x1b\[[0-9;]*m/g, "");
-		const label = ` • ${showMoreHintText()}`;
+		const label = ` · ${showMoreHintText()}`;
 		const idx = line.lastIndexOf(label);
 		if (idx < 0) return null;
 		const before = line.slice(0, idx);
@@ -409,14 +472,6 @@ export class ExpandedToolIoView {
 			lines.push(truncateToWidth(theme.fg("dim", `${lead}│`), safeWidth, ""));
 		};
 
-		/** Style `key: value` input rows — dim keys, readable values. */
-		const styleInputLine = (rawLine: string): string => {
-			const match = rawLine.match(/^([A-Za-z_][\w.-]*)(:\s*)(.*)$/);
-			if (!match) return theme.fg("muted", rawLine);
-			const [, key, sep, rest] = match;
-			return theme.fg("dim", key + sep) + theme.fg("muted", rest ?? "");
-		};
-
 		const pushBody = (
 			body: string,
 			opts: { input?: boolean; limit: number; continued?: boolean; section: ToolIoSection },
@@ -428,8 +483,13 @@ export class ExpandedToolIoView {
 			}
 			const sourceLines = raw.split("\n");
 			const wrapped: string[] = [];
-			for (const source of sourceLines) {
-				const styled = opts.input ? styleInputLine(source) : theme.fg(bodyColor, source);
+			for (const [index, source] of sourceLines.entries()) {
+				if (opts.input) {
+					// 代码块的行用着色版本（已剥缩进），其余走默认 dim/muted
+					wrapped.push(...wrapInputLine(source, contentWidth, theme, this.inputCodeLine(index)));
+					continue;
+				}
+				const styled = theme.fg(bodyColor, source);
 				const parts = wrapTextWithAnsi(styled, contentWidth);
 				if (parts.length === 0) wrapped.push(styled);
 				else wrapped.push(...parts);
@@ -444,7 +504,7 @@ export class ExpandedToolIoView {
 				if (hidden > 0) {
 					// hover 只高亮文字，圆点保持 dim（与 group hint 一致）。
 					const more =
-						theme.fg("dim", " •") +
+						theme.fg("dim", " ·") +
 						theme.fg(
 							this.hoveredSection === opts.section ? "text" : "dim",
 							` ${showMoreHintText()}`,
@@ -462,7 +522,15 @@ export class ExpandedToolIoView {
 		// Decide show-more from the same truncation rules as pushBody.
 		const inputWouldTruncate =
 			hasInput &&
-			bodyExceedsLineLimit(this.inputBody, this.maxInputLines, contentWidth, true, theme);
+			bodyExceedsLineLimit(
+				this.inputBody,
+				this.maxInputLines,
+				contentWidth,
+				true,
+				theme,
+				bodyColor,
+				(inputIndex: number) => this.inputCodeLine(inputIndex),
+			);
 		const outputWouldTruncate = bodyExceedsLineLimit(
 			outputText,
 			this.maxOutputLines,
@@ -522,6 +590,40 @@ export function isExpandedToolIoView(value: unknown): value is ExpandedToolIoVie
 	);
 }
 
+/** Input 行着色：`key: value` 拆成 dim 键 + muted 值，其余整行 muted。 */
+function styleInputSourceLine(line: string, theme: any): string {
+	const match = line.match(/^([A-Za-z_][\w.-]*)(:\s*)(.*)$/);
+	if (!match) return theme.fg("muted", line);
+	const [, key, sep, rest] = match;
+	return theme.fg("dim", key + sep) + theme.fg("muted", rest ?? "");
+}
+
+/**
+ * 折一行 Input 源码。不带 styledBody 时与改动前完全一致（其他工具不受影响）；
+ * 代码块（styledBody = 已着色且已剥缩进的行）续行跟着源码前导缩进：顶到 rail
+ * 会被读成新的一行，所以缩进先剥掉、折行宽度相应扣减，再给每一行加回去。
+ * 行数判断（bodyExceedsLineLimit）与实际渲染共用这一套，展开提示才对得上。
+ */
+function wrapInputLine(
+	source: string,
+	contentWidth: number,
+	theme: any,
+	styledBody?: string,
+): string[] {
+	if (styledBody === undefined) {
+		const styled = styleInputSourceLine(source, theme);
+		const parts = wrapTextWithAnsi(styled, contentWidth);
+		return parts.length ? parts : [styled];
+	}
+	const lead = /^[ \t]*/.exec(source)?.[0] ?? "";
+	const leadWidth = visibleWidth(lead);
+	const parts = wrapTextWithAnsi(styledBody, Math.max(1, contentWidth - leadWidth));
+	const rows = parts.length ? parts : [styledBody];
+	if (!leadWidth) return rows;
+	const prefix = theme.fg("muted", lead);
+	return rows.map((row) => prefix + row);
+}
+
 /** True when body needs truncation at the given line limit (source lines or wrapped rows). */
 function bodyExceedsLineLimit(
 	body: string,
@@ -530,23 +632,18 @@ function bodyExceedsLineLimit(
 	asInput: boolean,
 	theme: any,
 	bodyColor = "toolOutput",
+	/** 代码块的源行取着色内容，行数判断与实际渲染保持同一套规则。 */
+	codeLine?: (sourceIndex: number) => string | undefined,
 ): boolean {
 	const raw = body.replace(/\t/g, "   ").replace(/\n+$/, "");
 	if (!raw.trim()) return false;
 	const sourceLines = raw.split("\n");
 	if (sourceLines.length > limit) return true;
 	let total = 0;
-	for (const source of sourceLines) {
-		let styled: string;
-		if (asInput) {
-			const match = source.match(/^([A-Za-z_][\w.-]*)(:\s*)(.*)$/);
-			styled = match
-				? theme.fg("dim", match[1] + match[2]) + theme.fg("muted", match[3] ?? "")
-				: theme.fg("muted", source);
-		} else {
-			styled = theme.fg(bodyColor, source);
-		}
-		const parts = wrapTextWithAnsi(styled, contentWidth);
+	for (const [index, source] of sourceLines.entries()) {
+		const parts = asInput
+			? wrapInputLine(source, contentWidth, theme, codeLine?.(index))
+			: wrapTextWithAnsi(theme.fg(bodyColor, source), contentWidth);
 		total += Math.max(1, parts.length);
 		if (total > limit) return true;
 	}
@@ -603,26 +700,42 @@ export function middleTruncateToWidth(text: string, width: number): string {
 	return `${left}…${right}`;
 }
 
+/**
+ * 展开卡 Input 的代码块：源行起始下标（相对 text）+ 语言 + 剥掉行首缩进的代码。
+ * standalone = 整段 Input 就是这块代码（没有 `code:` 标签），全量预览可以整段包围栏。
+ */
+export type InputCodeBlock = {
+	startLine: number;
+	language: string;
+	code: string;
+	standalone: boolean;
+};
+
+export type ToolInputBody = { text: string; codeBlock?: InputCodeBlock };
+
+/** 按字段名判定可着色的入参：codemode / mcpscript 的 `code` 都是 JS 脚本。 */
+const INPUT_CODE_LANGUAGES: Record<string, string> = { code: "javascript" };
+
 /** Pretty-print tool call args for the expanded Input section. */
-export function formatToolInputArgs(args: unknown, maxChars = 8_000): string {
-	if (args === undefined || args === null) return "";
+export function formatToolInputBody(args: unknown, maxChars = 8_000): ToolInputBody {
+	if (args === undefined || args === null) return { text: "" };
 	if (typeof args !== "object") {
 		const text = sanitizeToolResultText(String(args));
-		return text.length > maxChars ? `${text.slice(0, maxChars)}…` : text;
+		return { text: text.length > maxChars ? `${text.slice(0, maxChars)}…` : text };
 	}
 	if (Array.isArray(args)) {
 		try {
 			const json = JSON.stringify(args, null, 2);
-			return json.length > maxChars ? `${json.slice(0, maxChars)}…` : json;
+			return { text: json.length > maxChars ? `${json.slice(0, maxChars)}…` : json };
 		} catch {
-			return sanitizeToolResultText(String(args));
+			return { text: sanitizeToolResultText(String(args)) };
 		}
 	}
 
 	const entries = Object.entries(args as Record<string, unknown>).filter(
 		([, value]) => value !== undefined,
 	);
-	if (entries.length === 0) return "";
+	if (entries.length === 0) return { text: "" };
 
 	// Stable, human-first field order for common tools.
 	const preferred = [
@@ -648,13 +761,30 @@ export function formatToolInputArgs(args: unknown, maxChars = 8_000): string {
 	});
 
 	const lines: string[] = [];
+	let codeBlock: InputCodeBlock | undefined;
 	for (const [rawKey, value] of entries) {
 		const key = sanitizeToolResultText(rawKey);
 		if (typeof value === "string") {
 			const safeValue = sanitizeToolResultText(value);
 			if (safeValue.includes("\n")) {
-				lines.push(`${key}:`);
-				for (const line of safeValue.replace(/\t/g, "   ").split("\n")) {
+				const expanded = safeValue.replace(/\t/g, "   ");
+				const language = INPUT_CODE_LANGUAGES[key];
+				// 只有一个 code 字段时（codemode 等）整块 Input 就是脚本，`code:` 标签是噪音
+				const standaloneCode = Boolean(language) && entries.length === 1;
+				if (!standaloneCode) lines.push(`${key}:`);
+				if (language) {
+					// 缩进由 wrapInputLine 负责，着色只喂剥掉行首缩进的正文
+					codeBlock = {
+						startLine: lines.length,
+						language,
+						code: expanded
+							.split("\n")
+							.map((line) => line.replace(/^[ \t]*/, ""))
+							.join("\n"),
+						standalone: standaloneCode,
+					};
+				}
+				for (const line of expanded.split("\n")) {
 					lines.push(`  ${line}`);
 				}
 			} else {
@@ -679,7 +809,13 @@ export function formatToolInputArgs(args: unknown, maxChars = 8_000): string {
 		}
 	}
 	const text = lines.join("\n");
-	return text.length > maxChars ? `${text.slice(0, maxChars)}…` : text;
+	// 截断后的行号与着色行不再对齐，这时只给纯文本
+	if (text.length > maxChars) return { text: `${text.slice(0, maxChars)}…` };
+	return codeBlock ? { text, codeBlock } : { text };
+}
+
+export function formatToolInputArgs(args: unknown, maxChars = 8_000): string {
+	return formatToolInputBody(args, maxChars).text;
 }
 
 export function hasExpandableDetail(outputText: string, args: unknown): boolean {
@@ -697,7 +833,7 @@ export function renderExpandedToolResult(
 	/** mode=on 展开卡贴左；compact 等保持默认前导空格 */
 	flushLeft = false,
 ): ExpandedToolIoView | ExpandedToolResultText | Text {
-	const inputBody = formatToolInputArgs(args);
+	const { text: inputBody, codeBlock } = formatToolInputBody(args);
 	const outputBody = body;
 	const maxOutputLines = config.expandedOutputMaxLines;
 	const maxInputLines = config.expandedInputMaxLines;
@@ -726,6 +862,7 @@ export function renderExpandedToolResult(
 				flushLeft,
 			);
 		}
+		view.setInputCode(codeBlock);
 		if (context) rememberIoView(context, view);
 		return view;
 	}

package/node_modules/@herbertgao/pi-cc-extensions/extensions/utils/ansi-text.ts

@@ -41,6 +41,7 @@ export function stripBackgroundAnsi(line: string): string {
 /** 剥离行首状态图标（展开组内工具首行复用）。 */
 export function stripLeadingStatusIcon(line: string): string {
 	return line.replace(
+		// 行首图标：ccstyle 用 `·`，pi 原生输出里还有 `•`，两种都要剥
 		/^((?:\x1b\[[0-9;]*m|[ \t]|[├└│─])*)(?:\x1b\[[0-9;]*m)*(?:[✓✗●○■⬤•·])(?:\x1b\[[0-9;]*m)*\s+/,
 		"$1",
 	);

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

@@ -1,6 +1,6 @@
 {
   "name": "@herbertgao/pi-cc-extensions",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "license": "MIT",
   "description": "A Pi productivity suite with Claude Code-style UI, context inspection, and agent/session references",
   "type": "module",
@@ -41,6 +41,8 @@
   },
   "scripts": {
     "test": "node scripts/test.mjs",
+    "coverage": "node scripts/test.mjs --experimental-test-coverage --test-coverage-include=extensions/**/*.ts",
+    "docs:tool-render": "node --experimental-strip-types scripts/generate-tool-render-examples.ts",
     "typecheck": "tsc --noEmit",
     "format": "biome format --write .",
     "format:check": "biome format ."
@@ -69,9 +71,9 @@
   },
   "x-upstream": {
     "package": "pi-cc-extensions",
-    "version": "0.9.9",
-    "reviewedVersion": "0.9.9",
+    "version": "0.9.10",
+    "reviewedVersion": "0.9.10",
     "repository": "https://github.com/minuque/pi-cc-extensions",
-    "commit": "17d294bcdc5e9a7e68771f0c550440ed22738457"
+    "commit": "2b72669cafefe0771b2e3e63b0db5c478314d2d4"
   }
 }

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

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.18.5
+
+### Patch Changes
+
+- [#258](https://github.com/HerbertGao/pi-extensions/pull/258) [`4f505b1`](https://github.com/HerbertGao/pi-extensions/commit/4f505b1456c5ea766121ee915f14ad29e48973e7) Thanks [@HerbertGao](https://github.com/HerbertGao)! - Keep Pi 1.x tool-call capabilities when starting a mentioned agent through a conversation clone, while preserving attribution to the main session.
+
 ## 0.18.4
 
 ### Patch Changes

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

@@ -1,6 +1,6 @@
 {
   "name": "@herbertgao/pi-subagents",
-  "version": "0.18.4",
+  "version": "0.18.5",
   "description": "Claude Code-style autonomous subagents and workflow orchestration for Pi, with HerbertGao-maintained UI extensions.",
   "keywords": [
     "agent",

package/node_modules/@herbertgao/pi-subagents/src/mention-clone.ts

@@ -108,7 +108,7 @@ export async function runMentionClone(
   let spawned = false
   const cloneAgentTool: ToolDefinition = {
     ...agentTool,
-    execute: (_cloneToolCallId, params, signal, onUpdate, _cloneCtx) => {
+    execute: (_cloneToolCallId, params, signal, onUpdate, cloneCtx) => {
       // One spawn per mention. The clone has a single tool and every reason to
       // stop after using it, but a model that decides to "also" launch a second
       // agent would do it where nobody can see and nobody asked.
@@ -138,7 +138,8 @@ export async function runMentionClone(
         } as typeof params,
         signal,
         onUpdate,
-        ctx,
+        // Keep Pi's tool-call capabilities, but attribute the spawn to the main session.
+        { ...ctx, tools: cloneCtx.tools, executeTool: cloneCtx.executeTool },
       )
     },
   }

package/node_modules/@herbertgao/sol-pi/CONTRIBUTING.md

@@ -0,0 +1,22 @@
+# Contributing
+
+We welcome external pull requests that improve token efficiency and reduce token cost through Pi-compatible extensions.
+
+## Pull Request Requirements
+
+Your PR should:
+
+- Implement a Pi-compatible extension using Pi's public extension APIs, without modifying Pi's core.
+- Be tested before submission, with relevant automated tests and reproducible validation steps.
+- Clearly explain how the extension reduces token cost or improves token efficiency, including local measurements where available.
+- Document its configuration, expected behavior, and any trade-offs. Efficiency improvements will be evaluated alongside correctness and task performance.
+
+## Benchmarking and Reports
+
+Our team will help benchmark submitted extensions to evaluate token usage, model cost, and task performance.
+
+We will publish updated benchmark reports on a regular reporting cycle, sharing evaluated changes, results, and any observed trade-offs.
+
+## Contributor Recognition
+
+Authors of accepted PRs will be credited as Contributors in the project documentation and the relevant benchmark reports.

package/node_modules/@herbertgao/sol-pi/README.md

@@ -1,10 +1,11 @@
 <p align="center">
-  <img src="assets/sol-pi-hero.png" width="100%" alt="SoL-Pi: Scaling Auto-Research Loops for Efficient Agent Harnesses" />
+  <img src="https://raw.githubusercontent.com/HerbertGao/pi-extensions/refs/heads/master/packages/sol-pi/assets/sol-pi-hero.png" width="100%" alt="SoL-Pi: Scaling Auto-Research Loops for Efficient Agent Harnesses" />
 </p>
 
 # ⚡ SoL-Pi: Scaling Auto-Research Loops for Efficient Agent Harnesses
 
 <p align="center">
+  <a href="https://arxiv.org/abs/2609.20519"><img src="https://img.shields.io/badge/arXiv-2609.20519-B31B1B?logo=arxiv&amp;logoColor=white" alt="arXiv: 2609.20519" /></a>
   <a href="#getting-started"><img src="https://img.shields.io/badge/Getting%20Started-Install-76B900" alt="Getting Started" /></a>
   <a href="docs/configuration.md"><img src="https://img.shields.io/badge/Docs-Configuration-555555" alt="Configuration" /></a>
   <a href="https://nvlabs.github.io/SoL-Pi/"><img src="https://img.shields.io/badge/Blog-SoL--Pi-76B900" alt="SoL-Pi Blog" /></a>
@@ -52,32 +53,36 @@ The mechanisms share four rules:
 
 Read the [SoL-Pi blog](https://nvlabs.github.io/SoL-Pi/) for a deeper look at the technical details, design rationale, and core insights behind SoL-Pi, including how auto-research led to the four efficiency mechanisms and how they work.
 
+## Paper
+
+Read our paper: [SoL-Pi: Recursively Scaling Auto-Research Loops for Efficient Agent Harness](https://arxiv.org/abs/2609.20519).
+
 ## Getting Started
 
 ### Requirements
 
 - Node.js 24 or newer
 - npm
-- `@earendil-works/pi-coding-agent` 0.85.1
+- `@earendil-works/pi-coding-agent` 1.0.4 (the monorepo's tested host; runtime peers remain `*`)
 
 ### Install
 
 Install the tested Pi release:
 
 ```bash
-npm install --global @earendil-works/pi-coding-agent@0.85.1
+npm install --global @earendil-works/pi-coding-agent@1.0.4
 ```
 
-Then install SoL-Pi directly from [NVlabs/SoL-Pi](https://github.com/NVlabs/SoL-Pi):
+Install this independently maintained package, or use `@herbertgao/pi-extensions` for the collection:
 
 ```bash
-pi install git:github.com/NVlabs/SoL-Pi
+pi install npm:@herbertgao/sol-pi
 ```
 
 To install it only for the current project, use the project-local scope:
 
 ```bash
-pi install git:github.com/NVlabs/SoL-Pi --local --approve
+pi install npm:@herbertgao/sol-pi --local --approve
 ```
 
 ### Configure
@@ -102,9 +107,9 @@ The following conservative configuration enables only the two local mechanisms t
 }
 ```
 
-Enable additional mechanisms only after reviewing their configuration and security implications. SoL-Pi uses no dedicated environment variables; feature flags, the reducer provider/model route, and the compaction ratio are configured in `sol-pi.json`.
+Enable additional mechanisms only after reviewing their configuration and security implications. SoL-Pi uses no dedicated environment variables; feature flags, the reducer provider/model route, and the compaction ratio are configured in `sol-pi.json`. See [sol-pi.example.json](sol-pi.example.json) for a template listing every key.
 
-For the complete schema, see [Configuration](docs/configuration.md). Coding agents and automated environments should follow the canonical [agent installation and configuration protocol](agents-install.md). Its all-enabled profile is checked with `scripts/check-sol-pi-config.mjs --require-all-enabled`.
+For the complete schema, see [Configuration](docs/configuration.md). Coding agents and automated environments should follow the canonical [agent installation and configuration protocol](agents-install.md), which describes an all-enabled configuration checked with `scripts/check-sol-pi-config.mjs --require-all-enabled`.
 
 ## Storage and Security
 
@@ -118,7 +123,9 @@ ObservationPack and Evidence-Preserving Reducer store session-specific archives
 
 They archive eligible source material in this directory. The archived copies remain local and are not automatically deleted when the Pi session ends.
 
-Online Context Compact stores its state in Pi's session log. After a successful compaction, it starts a new turn and automatically continues the active task. Cancelling the run or exiting Pi does not trigger automatic continuation.
+With `pi --no-session` or `SessionManager.inMemory()`, Pi provides no session directory. SoL-Pi instead creates a private directory named `sol-pi-<session-id>-<random>/` under the operating system's temporary directory. ObservationPack and Evidence-Preserving Reducer share this directory for the lifetime of the loaded extension. These modes disable Pi's session-log persistence; SoL-Pi still writes archive files for exact recall. Temporary archives are also retained after the session or worker exits so callers can read referenced evidence. Their eventual cleanup follows the host's temporary-file policy or the caller's cleanup, and they are not guaranteed to survive system cleanup or support session recovery.
+
+Online Context Compact stores its state in Pi's session log. After a successful compaction, or a recoverable native refusal (session too small, already compacted, or an incomplete summary at the token cap), it automatically continues the active task. A refused attempt retains the existing context and adds no cache debt; plan-only turns cannot repeatedly retry it. Cancelling the run or exiting Pi does not trigger automatic continuation.
 
 Evidence-Preserving Reducer may send eligible diagnostic-log content to its configured reducer model using Pi-managed authentication. Review [SECURITY.md](SECURITY.md) before enabling it. Do not enable remote reduction for logs that must remain local.
 
@@ -133,22 +140,22 @@ Evidence-Preserving Reducer may send eligible diagnostic-log content to its conf
 
 ## Development
 
-Install from the lockfile and run the complete source checks:
+From the monorepo root, install from its Bun lockfile and run the complete source checks:
 
 ```bash
-npm ci --ignore-scripts
-npm run check
-npm audit --audit-level=high
-node scripts/check-pi-compat.mjs
+bun install --frozen-lockfile
+bun run check
+bun audit
+node packages/sol-pi/scripts/check-pi-compat.mjs
 ```
 
-`npm run check` covers TypeScript, the complete test suite, and package inspection. The development dependency set is pinned to Pi 0.84.2; runtime Pi packages remain peer dependencies so Pi owns their installation and upgrades.
+For package-only checks, run `bun run --cwd packages/sol-pi typecheck` and `bun run --cwd packages/sol-pi test`, then inspect the package with `npm pack --dry-run` from `packages/sol-pi`. Root development dependencies provide Pi 1.0.4; runtime Pi packages remain peer dependencies so Pi owns their installation and upgrades.
 
 ## Project Status
 
-SoL-Pi is developed and maintained by NVIDIA as a standalone extension for Pi.
+The original SoL-Pi project is developed by NVIDIA as a standalone extension for Pi. This package is independently maintained in HerbertGao/pi-extensions.
 
-External code contributions are not accepted at this time. Bug reports and private security reports remain welcome through the channels described in [CONTRIBUTING.md](CONTRIBUTING.md) and [SECURITY.md](SECURITY.md).
+For upstream contributions, see [CONTRIBUTING.md](CONTRIBUTING.md). Report collection-specific issues to [HerbertGao/pi-extensions](https://github.com/HerbertGao/pi-extensions/issues); upstream private security channels remain described in [SECURITY.md](SECURITY.md).
 
 ## Acknowledgements
 
@@ -157,3 +164,15 @@ SoL-Pi builds on the public extension interfaces provided by [Pi](https://github
 ## License
 
 SoL-Pi is released under the [MIT License](LICENSE).
+
+## Star History
+
+This chart tracks the original NVIDIA project. Its generator and tests are retained as development-only references; publication stays in the [upstream workflow](docs/star-history.md), not this monorepo.
+
+<a href="https://www.star-history.com/?repos=NVlabs%2FSoL-Pi&amp;type=date">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/NVlabs/SoL-Pi/star-history/star-history-dark.svg" />
+    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/NVlabs/SoL-Pi/star-history/star-history-light.svg" />
+    <img alt="SoL-Pi star history chart" src="https://raw.githubusercontent.com/NVlabs/SoL-Pi/star-history/star-history-light.svg" width="100%" />
+  </picture>
+</a>

package/node_modules/@herbertgao/sol-pi/THIRD_PARTY_NOTICES.md

@@ -1,6 +1,6 @@
 # Third-Party Notices
 
-SoL-Pi does not vendor third-party source code. Its npm tarball contains only SoL-Pi source, documentation, tests-excluded assets, and project metadata.
+This independently maintained package imports the MIT-licensed SoL-Pi source from [NVlabs/SoL-Pi](https://github.com/NVlabs/SoL-Pi). Original NVIDIA copyright and MIT notices are preserved; `package.json` records the imported baseline in `x-upstream`. Its npm tarball contains only SoL-Pi source, documentation, assets, and project metadata, without vendored Pi or Star History source.
 
 ## Runtime peer dependencies
 
@@ -8,12 +8,16 @@ The following packages are supplied by the user's Pi installation and retain the
 
 | Package | Development-tested version | License | Source |
 | --- | ---: | --- | --- |
-| `@earendil-works/pi-agent-core` | 0.85.1 | MIT | <https://github.com/earendil-works/pi> |
-| `@earendil-works/pi-ai` | 0.85.1 | MIT | <https://github.com/earendil-works/pi> |
-| `@earendil-works/pi-coding-agent` | 0.85.1 | MIT | <https://github.com/earendil-works/pi> |
-| `@earendil-works/pi-tui` | 0.85.1 | MIT | <https://github.com/earendil-works/pi> |
+| `@earendil-works/pi-agent-core` | 1.0.4 | MIT | <https://github.com/earendil-works/pi> |
+| `@earendil-works/pi-ai` | 1.0.4 | MIT | <https://github.com/earendil-works/pi> |
+| `@earendil-works/pi-coding-agent` | 1.0.4 | MIT | <https://github.com/earendil-works/pi> |
+| `@earendil-works/pi-tui` | 1.0.4 | MIT | <https://github.com/earendil-works/pi> |
 | `typebox` | 1.3.7 | MIT | <https://github.com/sinclairzx81/typebox> |
 
 ## Development-only dependencies
 
-`@types/node` (MIT), TypeScript (Apache-2.0), and Vitest (MIT) are used to type-check and test the repository. They are not included in the SoL-Pi npm tarball. Exact versions and transitive dependency metadata are recorded in `package-lock.json`.
+`@types/node` (MIT), TypeScript (Apache-2.0), and Vitest (MIT) are used to type-check and test the repository. They are not included in the SoL-Pi npm tarball. Exact versions and transitive dependency metadata are recorded in the monorepo root's `bun.lock`.
+
+## Star history chart generation
+
+The upstream documentation workflow (not enabled in this monorepo) checks out the MIT-licensed [Star History renderer](https://github.com/star-history/star-history/tree/c326eac651bc5afb4cd40d354223dd419e1e2ae6) to preserve its chart design. Its source and dependencies are installed only for chart generation and are not included in the SoL-Pi npm tarball. The generated chart branch includes the upstream MIT license as `LICENSE-star-history.txt`.