pi-ui-extend 0.1.3 → 0.1.5

package/dist/app/app.d.ts

@@ -19,7 +19,6 @@ export declare class PiUiExtendApp {
     private readonly extensionActions;
     private readonly pixConfig;
     private readonly outputFilters;
-    private readonly suppressPendingDcpIdMetadata;
     private readonly commandController;
     private readonly inputActions;
     private readonly inputController;
@@ -57,6 +56,7 @@ export declare class PiUiExtendApp {
     private resumeLoading;
     constructor(options: AppOptions);
     start(): Promise<void>;
+    private checkPixUpdateOnStartup;
     private bindCurrentSession;
     private activateRuntime;
     private createExtensionEventBus;

package/dist/app/app.js

@@ -1,6 +1,6 @@
 import { THEMES } from "../theme.js";
 import { InputEditor } from "../input-editor.js";
-import { compileOutputFilterPatterns, loadPixConfig, outputFiltersRemoveDcpIdMetadataLine, resolveToolRule, } from "../config.js";
+import { compileOutputFilterPatterns, loadPixConfig, resolveToolRule, } from "../config.js";
 import { AppCommandController } from "./command-controller.js";
 import { ConversationViewport } from "./conversation-viewport.js";
 import { EditorLayoutRenderer } from "./editor-layout-renderer.js";
@@ -38,6 +38,7 @@ import { AppTabsController } from "./tabs-controller.js";
 import { TabLineRenderer } from "./tab-line-renderer.js";
 import { AppTerminalController } from "./terminal-controller.js";
 import { AppToastController } from "./toast-controller.js";
+import { checkPixUpdate, formatPixStartupUpdateDialog } from "./update.js";
 import { AppVoiceController } from "./voice-controller.js";
 import { createIsolatedExtensionEventBus } from "./extension-event-bus.js";
 import { setAppIconTheme } from "./icons.js";
@@ -64,7 +65,6 @@ export class PiUiExtendApp {
     extensionActions;
     pixConfig;
     outputFilters;
-    suppressPendingDcpIdMetadata;
     commandController;
     inputActions;
     inputController;
@@ -367,7 +367,6 @@ export class PiUiExtendApp {
             suppressExtensionWidget: (key) => this.extensionUiController.suppressWidget(key),
         });
         this.outputFilters = compileOutputFilterPatterns(this.pixConfig.outputFilters.patterns);
-        this.suppressPendingDcpIdMetadata = outputFiltersRemoveDcpIdMetadataLine(this.outputFilters);
         this.conversationViewport = new ConversationViewport({
             get entries() { return app.entries; },
             get session() { return app.runtime?.session; },
@@ -379,7 +378,6 @@ export class PiUiExtendApp {
             colors: this.theme.colors,
             pixConfig: this.pixConfig,
             outputFilters: this.outputFilters,
-            suppressPendingDcpIdMetadata: this.suppressPendingDcpIdMetadata,
             hasDynamicConversationBlock: () => this.popupMenus.hasDynamicConversationBlock(),
             isDynamicConversationBlock: (entry) => this.popupMenus.isDynamicConversationBlock(entry),
             renderInlineUserMessageMenu: (entry, context) => this.popupMenus.renderInlineUserMessageMenu(entry, context),
@@ -677,6 +675,18 @@ export class PiUiExtendApp {
         await this.sessionLifecycle.start();
         this.modelUsageController.startPolling();
         this.nerdFontController.ensureInstalledOnStartup();
+        void this.checkPixUpdateOnStartup();
+    }
+    async checkPixUpdateOnStartup() {
+        try {
+            const result = await checkPixUpdate();
+            if (result.status !== "newer")
+                return;
+            this.showToast(formatPixStartupUpdateDialog(result), "warning", { variant: "dialog" });
+        }
+        catch {
+            // Startup update checks should never interrupt the TUI.
+        }
     }
     async bindCurrentSession() {
         await this.sessionLifecycle.bindCurrentSession();

package/dist/app/clipboard.d.ts

@@ -1,3 +1,4 @@
 export declare function copyTextToClipboard(text: string): void;
 export declare function clipboardSupportAvailable(env?: NodeJS.ProcessEnv): boolean;
 export declare function clipboardInstallHint(): string;
+export declare function osc52ClipboardSequence(text: string, env?: NodeJS.ProcessEnv): string;

package/dist/app/clipboard.js

@@ -10,6 +10,8 @@ export function copyTextToClipboard(text) {
     }
     if (copyWithNativeClipboard(text))
         return;
+    if (copyWithOsc52(text))
+        return;
     throw new Error(`No clipboard command found. ${clipboardInstallHint()}`);
 }
 export function clipboardSupportAvailable(env = process.env) {
@@ -60,6 +62,20 @@ function copyWithNativeClipboard(text) {
     });
     return !result.error && result.status === 0;
 }
+function copyWithOsc52(text) {
+    if (process.stdout.destroyed || (!process.stdout.isTTY && !process.env.TMUX && !process.env.STY))
+        return false;
+    process.stdout.write(osc52ClipboardSequence(text));
+    return true;
+}
+export function osc52ClipboardSequence(text, env = process.env) {
+    const sequence = `\x1b]52;c;${Buffer.from(text, "utf8").toString("base64")}\x07`;
+    if (env.TMUX)
+        return `\x1bPtmux;${sequence.replaceAll("\x1b", "\x1b\x1b")}\x1b\\`;
+    if (env.STY)
+        return `\x1bP${sequence}\x1b\\`;
+    return sequence;
+}
 function resolveNativeClipboardEntrypoint() {
     try {
         return require.resolve("@mariozechner/clipboard");

package/dist/app/conversation-entry-renderer.d.ts

@@ -11,7 +11,6 @@ export type ConversationEntryRenderOptions = {
     colors: Theme["colors"];
     pixConfig: PixConfig;
     outputFilters: readonly RegExp[];
-    suppressPendingDcpIdMetadata: boolean;
     superCompactTools?: boolean;
     allThinkingExpanded?: boolean;
     renderInlineUserMessageMenu: (entry: Extract<Entry, {

package/dist/app/conversation-entry-renderer.js

@@ -1,4 +1,4 @@
-import { applyOutputFilters, stripDcpDisplayMetadata, suppressPendingDcpIdMetadataLine } from "../config.js";
+import { applyOutputFilters } from "../config.js";
 import { renderMarkdownTextLines } from "../markdown-format.js";
 import { attachImageClickTargets } from "./image-click-targets.js";
 import { horizontalPaddingLayout, padHorizontalText, wrapText } from "./render-text.js";
@@ -65,7 +65,7 @@ function renderCustomEntry(entry, width) {
     }));
 }
 function renderAssistantLines(text, width, options) {
-    const displayText = displayAssistantText(text, options.outputFilters, options.suppressPendingDcpIdMetadata);
+    const displayText = applyOutputFilters(text, options.outputFilters).trimEnd();
     if (!displayText)
         return [];
     return renderMarkdownTextLines(displayText, width).map((line) => ({
@@ -75,7 +75,3 @@ function renderAssistantLines(text, width, options) {
         ...(line.syntaxHighlight ? { syntaxHighlight: line.syntaxHighlight } : {}),
     }));
 }
-function displayAssistantText(text, outputFilters, suppressPendingDcpIdMetadata) {
-    const filtered = stripDcpDisplayMetadata(applyOutputFilters(text, outputFilters)).trimEnd();
-    return suppressPendingDcpIdMetadata ? suppressPendingDcpIdMetadataLine(filtered) : filtered;
-}

package/dist/app/conversation-tool-renderer.js

@@ -1,4 +1,4 @@
-import { resolveColor, resolveToolRule, stripDcpDisplayMetadata } from "../config.js";
+import { resolveColor, resolveToolRule } from "../config.js";
 import { formatMarkdownTables, markdownSyntaxHighlightsForText } from "../markdown-format.js";
 import { renderToolDisplay } from "../tool-renderers/index.js";
 import { DEFAULT_THINKING_TOOL_RULE, SUBAGENT_STATUSES, THINKING_TOOL_NAME, TODO_TOOL_NAME } from "./constants.js";
@@ -47,8 +47,7 @@ export function renderConversationToolEntry(entry, width, options) {
 }
 export function renderThinkingEntry(entry, width, options) {
     const rule = resolveThinkingToolRule(options.pixConfig);
-    const displayText = stripDcpDisplayMetadata(entry.text);
-    const markdownText = displayText ? formatMarkdownTables(displayText, Math.max(1, width - 2)) : "";
+    const markdownText = entry.text ? formatMarkdownTables(entry.text, Math.max(1, width - 2)) : "";
     const expandedText = trimTrailingBlankLines(markdownText);
     const compactExpandedText = options.superCompactTools ? removeBlankLines(expandedText) : expandedText;
     const forceExpanded = Boolean(options.allThinkingExpanded);

package/dist/app/conversation-viewport.d.ts

@@ -12,7 +12,6 @@ export type ConversationViewportHost = {
     readonly colors: Theme["colors"];
     readonly pixConfig: PixConfig;
     readonly outputFilters: readonly RegExp[];
-    readonly suppressPendingDcpIdMetadata: boolean;
     readonly superCompactTools?: boolean;
     readonly allThinkingExpanded?: boolean;
     hasDynamicConversationBlock?(): boolean;

package/dist/app/conversation-viewport.js

@@ -65,7 +65,6 @@ export class ConversationViewport {
             colors: this.host.colors,
             pixConfig: this.host.pixConfig,
             outputFilters: this.host.outputFilters,
-            suppressPendingDcpIdMetadata: this.host.suppressPendingDcpIdMetadata,
             superCompactTools: Boolean(this.host.superCompactTools),
             allThinkingExpanded: Boolean(this.host.allThinkingExpanded),
             renderInlineUserMessageMenu: (userEntry, context) => this.host.renderInlineUserMessageMenu(userEntry, context),

package/dist/app/startup-info.d.ts

@@ -1,3 +1,3 @@
-import { type AgentSessionRuntime } from "@earendil-works/pi-coding-agent";
+import type { AgentSessionRuntime } from "@earendil-works/pi-coding-agent";
 export declare function createStartupInfoMessage(runtime: AgentSessionRuntime): string;
 export declare function isEmptyStartupSession(runtime: AgentSessionRuntime): boolean;

package/dist/app/startup-info.js

@@ -1,11 +1,12 @@
 import { homedir } from "node:os";
 import { basename, isAbsolute, relative, sep } from "node:path";
-import { VERSION } from "@earendil-works/pi-coding-agent";
+import { getPixPackageVersion } from "./update.js";
 export function createStartupInfoMessage(runtime) {
     const sections = startupSections(runtime);
     return [
         formatModelLine(runtime),
-        `pix · pi-sdk v${VERSION}`,
+        "",
+        `pix v${getPixPackageVersion()}`,
         "escape interrupt · ctrl+c/ctrl+d clear/exit · / commands",
         "",
         ...sections.flatMap(formatSection),

package/dist/app/update.d.ts

@@ -30,7 +30,9 @@ export type PixUpdateCheckOptions = {
 };
 export declare function pixUpdateUsage(): string;
 export declare function parsePixUpdateArgs(argv: readonly string[]): PixUpdateCliOptions;
+export declare function getPixPackageVersion(packageRoot?: string): string;
 export declare function checkPixUpdate(options?: PixUpdateCheckOptions): Promise<PixUpdateCheckResult>;
 export declare function formatPixUpdateCheck(result: PixUpdateCheckResult): string;
+export declare function formatPixStartupUpdateDialog(result: PixUpdateCheckResult): string;
 export declare function getPixSelfUpdateCommand(packageName: string, latestVersion?: string, packageRoot?: string): PixSelfUpdateCommand | undefined;
 export declare function runPixUpdateCli(argv?: readonly string[]): Promise<number>;

package/dist/app/update.js

@@ -40,6 +40,9 @@ export function parsePixUpdateArgs(argv) {
     }
     return { checkOnly, force, help };
 }
+export function getPixPackageVersion(packageRoot) {
+    return readPixPackageInfo(packageRoot).version;
+}
 export async function checkPixUpdate(options = {}) {
     const packageInfo = readPixPackageInfo(options.packageRoot);
     const base = {
@@ -107,6 +110,19 @@ export function formatPixUpdateCheck(result) {
     lines.push("scope: Pix package, renderer extensions, bundled skills copied into ~/.agents/skills, and the pi-tools-suite payload linked into ~/.pi/agent/extensions");
     return lines.join("\n");
 }
+export function formatPixStartupUpdateDialog(result) {
+    const lines = [
+        "A new Pix version is available.",
+        `current: ${result.packageName} v${result.currentVersion}`,
+        ...(result.latestVersion ? [`latest: ${result.latestVersion}`] : []),
+        "",
+        "To update:",
+        "1. Exit Pix.",
+        "2. Run `pix update` in your shell.",
+        "3. Start Pix again after the update completes.",
+    ];
+    return lines.join("\n");
+}
 export function getPixSelfUpdateCommand(packageName, latestVersion, packageRoot = readPixPackageInfo().packageRoot) {
     if (!packageRootLooksPackageManaged(packageRoot))
         return undefined;

package/dist/config.d.ts

@@ -54,9 +54,6 @@ export declare function savePixDictationLanguage(language: string): void;
 export declare function upsertPixDictationLanguageInJsonc(source: string, language: string): string;
 export declare function resolveModelColor(modelRef: string, config: ModelColorsConfig): string | undefined;
 export declare function compileOutputFilterPatterns(patterns: readonly string[]): RegExp[];
-export declare function stripDcpDisplayMetadata(text: string): string;
 export declare function applyOutputFilters(text: string, filters: readonly RegExp[]): string;
-export declare function outputFiltersRemoveDcpIdMetadataLine(filters: readonly RegExp[]): boolean;
-export declare function suppressPendingDcpIdMetadataLine(text: string): string;
 export declare function resolveToolRule(toolName: string, config: ToolRendererConfig): ResolvedToolRule;
 export declare function resolveColor(colorRef: string, themeColors: Record<string, string>): string;

package/dist/config.js

@@ -77,17 +77,6 @@ const DEFAULT_DICTATION = {
         },
     },
 };
-const DCP_ID_METADATA_SAMPLE = "<dcp-id>m001</dcp-id>";
-const DCP_ID_METADATA_PREFIX = "<dcp-id>m";
-const DCP_ID_METADATA_SUFFIX = "</dcp-id>";
-const DCP_XML_PAIRED_TAG_RE = /<dcp[^>]*>[\s\S]*?<\/dcp[^>]*>/gi;
-const DCP_XML_OPEN_TAG_TO_END_RE = /<dcp[^>]*>[\s\S]*$/gi;
-const DCP_XML_UNPAIRED_TAG_RE = /<\/?dcp[^>]*>/gi;
-const DCP_MARKDOWN_REFERENCE_RE = /[ \t]*\[dcp(?:-[a-z0-9-]+)?\]:[ \t]*#(?:[ \t]+\([^\n]*\))?[ \t]*/gi;
-const DCP_MARKDOWN_REFERENCE_LINE_RE = /^[ \t]*\[dcp(?:-[a-z0-9-]+)?\]:[ \t]*#(?:[ \t]+\([^\n]*\))?[ \t]*$/i;
-const DCP_MARKDOWN_REFERENCE_PENDING_RE = /^\[d(?:c(?:p(?:-[a-z0-9-]*)?)?)?(?:\]?(?::[ \t]*#?(?:[ \t]*\([^\)\n]*)?)?)?$/i;
-const DCP_XML_METADATA_LINE_RE = /^[ \t]*<dcp[^>]*>(?:[\s\S]*?<\/dcp[^>]*>)?[ \t]*$/i;
-const DCP_DISPLAY_QUICK_CHECK_RE = /<\/?d(?:c(?:p)?)?|\[d(?:c(?:p)?)?/i;
 function parseJsonc(text) {
     return parse(text, undefined, { allowTrailingComma: true });
 }
@@ -322,37 +311,6 @@ export function resolveModelColor(modelRef, config) {
 export function compileOutputFilterPatterns(patterns) {
     return patterns.flatMap((pattern) => compileOutputFilterPattern(pattern));
 }
-export function stripDcpDisplayMetadata(text) {
-    if (text.length === 0 || !DCP_DISPLAY_QUICK_CHECK_RE.test(text))
-        return text;
-    let cleaned = stripDcpDisplayMetadataLines(text);
-    // Strip fully paired XML-style DCP tags first. During streaming, strip an
-    // unterminated opening XML tag and everything after it before removing
-    // orphan tags, otherwise `<dcp-id>m123` would leave `m123` behind.
-    cleaned = cleaned
-        .replace(DCP_XML_PAIRED_TAG_RE, "")
-        .replace(DCP_XML_OPEN_TAG_TO_END_RE, "")
-        .replace(DCP_XML_UNPAIRED_TAG_RE, "");
-    // Hide a partially streamed markdown reference line before the complete-line
-    // regex can strip the prefix and strand the `(m123` payload.
-    cleaned = suppressPendingDcpIdMetadataLine(cleaned).replace(DCP_MARKDOWN_REFERENCE_RE, "");
-    cleaned = suppressPendingDcpIdMetadataLine(cleaned);
-    cleaned = stripDcpDisplayMetadataLines(cleaned);
-    return cleaned.replace(/\n{3,}/g, "\n\n").trimEnd();
-}
-function stripDcpDisplayMetadataLines(text) {
-    if (text.length === 0)
-        return text;
-    let removed = false;
-    const keptLines = text.split("\n").filter((line) => {
-        const normalizedLine = line.replace(/\r$/u, "");
-        const isMetadataLine = DCP_MARKDOWN_REFERENCE_LINE_RE.test(normalizedLine) || DCP_XML_METADATA_LINE_RE.test(normalizedLine);
-        if (isMetadataLine)
-            removed = true;
-        return !isMetadataLine;
-    });
-    return removed ? keptLines.join("\n") : text;
-}
 export function applyOutputFilters(text, filters) {
     if (filters.length === 0 || text.length === 0)
         return text;
@@ -374,43 +332,6 @@ export function applyOutputFilters(text, filters) {
     }
     return filteredLines.join("\n");
 }
-export function outputFiltersRemoveDcpIdMetadataLine(filters) {
-    return filters.length > 0 && applyOutputFilters(DCP_ID_METADATA_SAMPLE, filters).length === 0;
-}
-export function suppressPendingDcpIdMetadataLine(text) {
-    if (text.length === 0)
-        return text;
-    const lineStart = text.lastIndexOf("\n") + 1;
-    const line = text.slice(lineStart);
-    if (!isPendingDcpIdMetadataLine(line))
-        return text;
-    // Hide the still-streaming metadata line and its line break until it either
-    // becomes a complete filtered line or diverges from the metadata prefix.
-    return lineStart > 0 ? text.slice(0, lineStart - 1) : "";
-}
-function isPendingDcpIdMetadataLine(line) {
-    const candidate = line.trimStart();
-    if (candidate.length === 0)
-        return false;
-    return isPendingXmlDcpIdMetadataLine(candidate) || isPendingMarkdownDcpMetadataLine(candidate);
-}
-function isPendingXmlDcpIdMetadataLine(candidate) {
-    if (DCP_ID_METADATA_PREFIX.startsWith(candidate))
-        return true;
-    if (!candidate.startsWith(DCP_ID_METADATA_PREFIX))
-        return false;
-    const afterPrefix = candidate.slice(DCP_ID_METADATA_PREFIX.length);
-    const digits = afterPrefix.match(/^\d*/)?.[0] ?? "";
-    const afterDigits = afterPrefix.slice(digits.length);
-    if (afterDigits.length === 0)
-        return true;
-    return DCP_ID_METADATA_SUFFIX.startsWith(afterDigits) && afterDigits.length < DCP_ID_METADATA_SUFFIX.length;
-}
-function isPendingMarkdownDcpMetadataLine(candidate) {
-    if (DCP_MARKDOWN_REFERENCE_LINE_RE.test(candidate))
-        return false;
-    return DCP_MARKDOWN_REFERENCE_PENDING_RE.test(candidate);
-}
 function applyOutputFiltersToLine(line, filters) {
     let filtered = line;
     for (const filter of filters) {

package/dist/default-pix-config.js

@@ -169,10 +169,10 @@ export const DEFAULT_PIX_CONFIG_JSONC = String.raw `{
   },
 
   // Output filters applied to assistant text in the renderer.
-  // Supports glob-style * wildcards, or regex literals like "/<dcp-id>m\\d+<\\/dcp-id>/".
+  // Supports glob-style * wildcards, or regex literals like "/token=\\w+/".
   // "outputFilters": {
   //   "patterns": [
-  //     "<dcp-id>m*</dcp-id>"
+  //     "secret-*"
   //   ]
   // },
 

package/dist/markdown-format.js

@@ -4,6 +4,7 @@ export function formatMarkdownTables(text, maxWidth) {
     const lines = text.split("\n");
     const formatted = [];
     let fence;
+    let skipBlankAfterHiddenReference = false;
     for (let index = 0; index < lines.length;) {
         const line = lines[index] ?? "";
         const nextFence = markdownFence(line);
@@ -16,6 +17,16 @@ export function formatMarkdownTables(text, maxWidth) {
             index += 1;
             continue;
         }
+        if (!fence && isMarkdownReferenceDefinition(line)) {
+            skipBlankAfterHiddenReference = formatted.length === 0 || (formatted.at(-1) ?? "").trim().length === 0;
+            index += 1;
+            continue;
+        }
+        if (!fence && skipBlankAfterHiddenReference && line.trim().length === 0) {
+            index += 1;
+            continue;
+        }
+        skipBlankAfterHiddenReference = false;
         if (!fence) {
             const table = parseMarkdownTableBlock(lines, index);
             if (table) {
@@ -61,7 +72,10 @@ export function renderMarkdownLine(text, start = 0) {
 export function renderMarkdownTextLines(text, width, start = 0) {
     const lines = [];
     let fence;
-    for (const rawLine of formatMarkdownTables(sanitizeMarkdownText(text), width).split("\n")) {
+    const formattedText = formatMarkdownTables(sanitizeMarkdownText(text), width);
+    if (formattedText.length === 0)
+        return [];
+    for (const rawLine of formattedText.split("\n")) {
         const nextFence = markdownFence(rawLine);
         const closesFence = Boolean(fence && nextFence && fence.marker === nextFence.marker && nextFence.length >= fence.length);
         const opensFence = !fence && nextFence !== undefined;
@@ -533,6 +547,9 @@ function markdownLineSyntaxHighlight(fence, fenceDelimiterLine, start) {
 function sanitizeMarkdownText(text) {
     return expandTabs(text.replace(/\x1b/g, "␛").replace(/\r/g, ""));
 }
+function isMarkdownReferenceDefinition(line) {
+    return /^ {0,3}\[[^\]\n]+\]:[ \t]*\S.*$/u.test(line);
+}
 function markdownFence(line) {
     const match = /^\s{0,3}(`{3,}|~{3,})(.*)$/.exec(line);
     const marker = match?.[1];

package/external/pi-tools-suite/README.md

@@ -14,12 +14,12 @@ This package keeps the former standalone extensions as ordinary source folders u
 - `src/model-tools` — model-specific tool aliases such as Claude/GLM-style `Read` / `Edit` / `Write` / `Bash` / `Grep` / `Glob` / `LS`, GPT/Codex-style `shell`, and model-gated `apply_patch`
 - `src/usage` — `/usage` command and startup hint for read-only AI quota checks across OpenAI, Zhipu AI, Z.ai, and Google Antigravity, including Antigravity quota by model
 - `src/web-search` — `web_search` and `web_fetch` tools migrated from `@ollama/pi-web-search`; calls the local Ollama experimental web search/fetch APIs, honors `OLLAMA_HOST`, supports request timeouts via `timeout_ms` / `PI_WEB_SEARCH_TIMEOUT_MS`, and reports targeted `ollama signin`, unsupported-endpoint, invalid-response, timeout, DNS, and Ollama-not-running errors
-- `src/compress` — Dynamic Context Pruning: explicit `compress` tool with range and message modes, `/dcp` commands (context, stats, sweep, manual, decompress, recompress, compress), same-call overlap validation, recoverable compressed-block rollups, grouped message-mode skip diagnostics, stable raw-message anchors when available, protected user/tool preservation, deduplication, error purging, context nudges, and footer status visualization
+- `src/dcp` — headless Dynamic Context Pruning ported from `opencode-dynamic-context-pruning` for the Pi SDK: explicit `compress` tool with range and message modes, `/dcp` commands (context, stats, sweep, manual, decompress, recompress, compress), same-call overlap validation, recoverable compressed-block rollups, grouped message-mode skip diagnostics, stable raw-message anchors when available, protected user/tool preservation, deduplication, error purging, and context nudges; visualization is left to `compress` tool responses and the renderer-owned context-percent click dialog
 - `src/prompt-commands` — user slash-command builder: `/prompt-commands` opens a CRUD menu for saved prompt-backed slash commands, stores them under `promptCommands` in `~/.config/pi/pi-tools-suite.jsonc`, reloads after edits, and runs each saved prompt as a normal user message
 
 `index.ts` is intentionally only a thin auto-discovery shim that re-exports `src/index.ts`. There is no `pi.extensions` manifest here, so local Pi auto-discovery loads the suite once via `~/.pi/agent/extensions/pi-tools-suite/index.ts` and does not double-register tools.
 
-Registration order is preserved in `src/index.ts`: ast-grep, async-subagents, terminal-bell, lsp, repo-discovery command/tool gate, antigravity-auth provider, todo, model-tools, usage, web-search, compress, then prompt-commands. Tool metadata and active model-specific tool sets have two modes: standard and repo-aware. When `.indexer-cli` enables `repo_*`, those tools stay active ahead of overlapping lower-level aliases so the indexed discovery surface has priority.
+Registration order is preserved in `src/index.ts`: ast-grep, async-subagents, terminal-bell, lsp, repo-discovery command/tool gate, antigravity-auth provider, todo, model-tools, usage, web-search, dcp, then prompt-commands. Tool metadata and active model-specific tool sets have two modes: standard and repo-aware. When `.indexer-cli` enables `repo_*`, those tools stay active ahead of overlapping lower-level aliases so the indexed discovery surface has priority.
 
 ## Disabling modules
 
@@ -55,7 +55,7 @@ Saved prompt slash commands are stored under `promptCommands`. Use `/prompt-comm
 }
 ```
 
-DCP/compress settings are stored under `dcp` in the same shared config files. Legacy standalone `dcp.jsonc` files are still read for compatibility, but the `dcp` section in `pi-tools-suite.jsonc` wins at the same global/env/project layer.
+DCP settings are stored only under `dcp` in the user shared config file `~/.config/pi/pi-tools-suite.jsonc`. Legacy standalone `dcp.jsonc`, `$PI_CONFIG_DIR`, and project-local `.pi/pi-tools-suite.jsonc` DCP settings are intentionally ignored by the ported headless DCP module.
 
 ```jsonc
 {
@@ -214,7 +214,7 @@ pi-tools-suite/
     model-tools/
     usage/
     web-search/
-    compress/
+    dcp/
     prompt-commands/
   docs/
   licenses/