pi-ui-extend 0.1.8 → 0.1.9

package/dist/app/{screen-styler.js → screen/screen-styler.js}

@@ -1,7 +1,7 @@
-import { ANSI_RESET, colorize } from "../theme.js";
-import { renderMarkdownLine } from "../markdown-format.js";
-import { syntaxHighlightSegmentsForLine } from "../syntax-highlight.js";
-import { padOrTrimPlain } from "./render-text.js";
+import { ANSI_RESET, colorize } from "../../theme.js";
+import { renderMarkdownLine } from "../../markdown-format.js";
+import { syntaxHighlightSegmentsForLine } from "../../syntax-highlight.js";
+import { padOrTrimPlain } from "../rendering/render-text.js";
 import { orderedSelection } from "./screen-selection.js";
 export class ScreenStyler {
     host;

package/dist/app/{scroll-controller.d.ts → screen/scroll-controller.d.ts}

@@ -1,6 +1,6 @@
-import type { ConversationViewport } from "./conversation-viewport.js";
-import type { EditorLayoutRenderer } from "./editor-layout-renderer.js";
-import type { RenderedLine } from "./types.js";
+import type { ConversationViewport } from "../rendering/conversation-viewport.js";
+import type { EditorLayoutRenderer } from "../rendering/editor-layout-renderer.js";
+import type { RenderedLine } from "../types.js";
 export type AppScrollMetrics = {
     bodyHeight: number;
     viewportColumns: number;

package/dist/app/{scroll-controller.js → screen/scroll-controller.js}

@@ -1,4 +1,4 @@
-import { sanitizeText } from "./render-text.js";
+import { sanitizeText } from "../rendering/render-text.js";
 export class AppScrollController {
     host;
     scrollFromBottom = 0;

package/dist/app/{status-controller.d.ts → screen/status-controller.d.ts}

@@ -1,7 +1,7 @@
 import type { AgentSession } from "@earendil-works/pi-coding-agent";
-import type { Theme } from "../theme.js";
+import type { Theme } from "../../theme.js";
 import type { AppBlinkController } from "./blink-controller.js";
-import type { SessionActivity } from "./types.js";
+import type { SessionActivity } from "../types.js";
 export type AppStatusControllerHost = {
     readonly cwd: string;
     readonly theme: Theme;

package/dist/app/{status-controller.js → screen/status-controller.js}

@@ -1,6 +1,6 @@
 import { spawnSync } from "node:child_process";
 import { basename } from "node:path";
-import { GIT_BRANCH_CACHE_MS } from "./constants.js";
+import { GIT_BRANCH_CACHE_MS } from "../constants.js";
 const STATUS_DOT_BLINK_KEY = "status-dot";
 export class AppStatusController {
     host;

package/dist/app/{queued-message-controller.d.ts → session/queued-message-controller.d.ts}

@@ -1,6 +1,6 @@
 import type { AgentSession, AgentSessionRuntime } from "@earendil-works/pi-coding-agent";
-import type { ImageContent } from "../input-editor.js";
-import type { Entry, SessionActivity, SubmittedUserMessage } from "./types.js";
+import type { ImageContent } from "../../input-editor.js";
+import type { Entry, SessionActivity, SubmittedUserMessage } from "../types.js";
 export type AppQueuedMessageControllerHost = {
     runtime(): AgentSessionRuntime | undefined;
     requireRuntime(): AgentSessionRuntime;

package/dist/app/{queued-message-controller.js → session/queued-message-controller.js}

@@ -1,5 +1,5 @@
-import { createId } from "./id.js";
-import { stringifyUnknown, submittedUserDisplayText } from "./message-content.js";
+import { createId } from "../id.js";
+import { stringifyUnknown, submittedUserDisplayText } from "../rendering/message-content.js";
 export class AppQueuedMessageController {
     host;
     deferredUserMessages = [];

package/dist/app/{request-history.js → session/request-history.js}

@@ -1,8 +1,8 @@
 import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { getAgentDir } from "@earendil-works/pi-coding-agent";
-import { REQUEST_HISTORY_MAX_BYTES, REQUEST_HISTORY_MAX_ENTRIES, REQUEST_HISTORY_MAX_ENTRY_BYTES, REQUEST_HISTORY_VERSION, } from "./constants.js";
-import { isRecord } from "./guards.js";
+import { REQUEST_HISTORY_MAX_BYTES, REQUEST_HISTORY_MAX_ENTRIES, REQUEST_HISTORY_MAX_ENTRY_BYTES, REQUEST_HISTORY_VERSION, } from "../constants.js";
+import { isRecord } from "../guards.js";
 export class AppRequestHistory {
     host;
     entries = [];

package/dist/app/{session-event-controller.d.ts → session/session-event-controller.d.ts}

@@ -1,7 +1,7 @@
 import type { AgentSessionEvent, AgentSessionRuntime } from "@earendil-works/pi-coding-agent";
-import type { ConversationViewport } from "./conversation-viewport.js";
-import type { Entry, SessionActivity } from "./types.js";
-import type { WorkspaceMutation, WorkspaceMutationPreparation } from "./workspace-undo.js";
+import type { ConversationViewport } from "../rendering/conversation-viewport.js";
+import type { Entry, SessionActivity } from "../types.js";
+import type { WorkspaceMutation, WorkspaceMutationPreparation } from "../workspace/workspace-undo.js";
 export type AppSessionEventControllerHost = {
     readonly entries: Entry[];
     runtime(): AgentSessionRuntime | undefined;

package/dist/app/{session-event-controller.js → session/session-event-controller.js}

@@ -1,7 +1,7 @@
-import { createId } from "./id.js";
-import { extractImageContents, renderContent, renderUserMessageContent, stringifyUnknown } from "./message-content.js";
+import { createId } from "../id.js";
+import { extractImageContents, renderContent, renderUserMessageContent, stringifyUnknown } from "../rendering/message-content.js";
 import { customMessageEntry, loadSessionHistoryEntries, loadSessionHistoryEntriesAsync } from "./session-history.js";
-import { isRecord } from "./guards.js";
+import { isRecord } from "../guards.js";
 export class AppSessionEventController {
     host;
     entryRenderVersions = new Map();

package/dist/app/{session-history.d.ts → session/session-history.d.ts}

@@ -1,4 +1,4 @@
-import type { Entry } from "./types.js";
+import type { Entry } from "../types.js";
 type SubagentsToolResultObserveOptions = {
     showSnapshot?: boolean;
 };

package/dist/app/{session-history.js → session/session-history.js}

@@ -1,6 +1,6 @@
-import { isRecord } from "./guards.js";
-import { createId } from "./id.js";
-import { extractImageContents, renderContent, renderUserMessageContent, stringifyUnknown } from "./message-content.js";
+import { isRecord } from "../guards.js";
+import { createId } from "../id.js";
+import { extractImageContents, renderContent, renderUserMessageContent, stringifyUnknown } from "../rendering/message-content.js";
 const SYSTEM_CUSTOM_MESSAGE_TYPE = "pix-system";
 const HISTORICAL_SUBAGENTS_OBSERVATION = { showSnapshot: false };
 const DEFAULT_HISTORY_CHUNK_SIZE = 50;

package/dist/app/{session-lifecycle-controller.d.ts → session/session-lifecycle-controller.d.ts}

@@ -1,6 +1,6 @@
 import type { AgentSession, AgentSessionEvent, AgentSessionRuntime, ExtensionCommandContextActions, ExtensionError } from "@earendil-works/pi-coding-agent";
-import type { InputEditor } from "../input-editor.js";
-import type { AppOptions, Entry, PixExtensionUIContext, SessionActivity } from "./types.js";
+import type { InputEditor } from "../../input-editor.js";
+import type { AppOptions, Entry, PixExtensionUIContext, SessionActivity } from "../types.js";
 export type AppSessionLifecycleHost = {
     options: AppOptions;
     createRuntime(): Promise<AgentSessionRuntime>;

package/dist/app/{session-lifecycle-controller.js → session/session-lifecycle-controller.js}

@@ -1,7 +1,7 @@
-import { createId } from "./id.js";
-import { stringifyUnknown } from "./message-content.js";
-import { collectStartupAvailabilityIssues } from "./startup-checks.js";
-import { createStartupInfoMessage, isEmptyStartupSession } from "./startup-info.js";
+import { createId } from "../id.js";
+import { stringifyUnknown } from "../rendering/message-content.js";
+import { collectStartupAvailabilityIssues } from "../cli/startup-checks.js";
+import { createStartupInfoMessage, isEmptyStartupSession } from "../cli/startup-info.js";
 export class AppSessionLifecycleController {
     host;
     unsubscribe;

package/dist/app/{session-search.d.ts → session/session-search.d.ts}

@@ -1,5 +1,5 @@
 import { type SessionInfo } from "@earendil-works/pi-coding-agent";
-import type { Entry, PixMenuItem } from "./types.js";
+import type { Entry, PixMenuItem } from "../types.js";
 export type SessionSearchMatch = {
     sessionEntryId?: string;
     role?: string;

package/dist/app/{session-search.js → session/session-search.js}

@@ -1,7 +1,7 @@
 import { SessionManager } from "@earendil-works/pi-coding-agent";
-import { isRecord } from "./guards.js";
-import { renderContent, renderUserMessageContent } from "./message-content.js";
-import { sanitizeText } from "./render-text.js";
+import { isRecord } from "../guards.js";
+import { renderContent, renderUserMessageContent } from "../rendering/message-content.js";
+import { sanitizeText } from "../rendering/render-text.js";
 const DEFAULT_MAX_SEARCH_RESULTS = 50;
 const DEFAULT_SNIPPET_LENGTH = 160;
 const DEFAULT_SCROLL_SAMPLE_LENGTH = 80;

package/dist/app/{tabs-controller.d.ts → session/tabs-controller.d.ts}

@@ -1,6 +1,6 @@
 import { type AgentSession, type AgentSessionRuntime } from "@earendil-works/pi-coding-agent";
-import type { AppBlinkController } from "./blink-controller.js";
-import type { AppOptions, Entry, SessionActivity, SessionTab } from "./types.js";
+import type { AppBlinkController } from "../screen/blink-controller.js";
+import type { AppOptions, Entry, SessionActivity, SessionTab } from "../types.js";
 export type TabInputState = {
     text: string;
     cursor: number;

package/dist/app/{tabs-controller.js → session/tabs-controller.js}

@@ -3,10 +3,10 @@ import { existsSync } from "node:fs";
 import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
 import { getAgentDir, SessionManager, } from "@earendil-works/pi-coding-agent";
-import { isRecord } from "./guards.js";
-import { createId } from "./id.js";
-import { createStartupInfoMessage, isEmptyStartupSession } from "./startup-info.js";
-import { tabPanelRows } from "./tab-line-renderer.js";
+import { isRecord } from "../guards.js";
+import { createId } from "../id.js";
+import { createStartupInfoMessage, isEmptyStartupSession } from "../cli/startup-info.js";
+import { tabPanelRows } from "../rendering/tab-line-renderer.js";
 const TAB_STATE_VERSION = 2;
 const MAX_RESTORED_TABS = 8;
 const TAB_ATTENTION_BLINK_KEY = "tab-attention";

package/dist/app/{subagents-files.d.ts → subagents/subagents-files.d.ts}

@@ -1,4 +1,4 @@
-import type { SubagentAgentState, SubagentRegistry } from "./types.js";
+import type { SubagentAgentState, SubagentRegistry } from "../types.js";
 export declare function subagentsRegistryPath(cwd: string): string;
 export declare function readSubagentRegistry(cwd: string): Promise<SubagentRegistry | undefined>;
 export declare function readSubagentRunStateFromFiles(runDir: string, options?: {

package/dist/app/{subagents-files.js → subagents/subagents-files.js}

@@ -1,6 +1,6 @@
 import { readFile, readdir, realpath, stat } from "node:fs/promises";
 import { join, resolve } from "node:path";
-import { SUBAGENT_PARENT_SESSION_FILE, SUBAGENTS_REGISTRY_FILE, SUBAGENTS_RUN_ROOT } from "./constants.js";
+import { SUBAGENT_PARENT_SESSION_FILE, SUBAGENTS_REGISTRY_FILE, SUBAGENTS_RUN_ROOT } from "../constants.js";
 import { isSubagentRegistry } from "./subagents-model.js";
 export function subagentsRegistryPath(cwd) {
     return join(cwd, SUBAGENTS_RUN_ROOT, SUBAGENTS_REGISTRY_FILE);

package/dist/app/{subagents-model.d.ts → subagents/subagents-model.d.ts}

@@ -1,4 +1,4 @@
-import type { SubagentActiveStatus, SubagentAgentState, SubagentsLiveStateEvent, SubagentRegistry, SubagentRegistryAgent, SubagentRegistryRun, SubagentRenderMode, SubagentRunRenderDetails, SubagentStatus, SubagentTaskPreview, SubagentTerminalStatus } from "./types.js";
+import type { SubagentActiveStatus, SubagentAgentState, SubagentsLiveStateEvent, SubagentRegistry, SubagentRegistryAgent, SubagentRegistryRun, SubagentRenderMode, SubagentRunRenderDetails, SubagentStatus, SubagentTaskPreview, SubagentTerminalStatus } from "../types.js";
 export declare function isSubagentsToolName(toolName: string): boolean;
 export declare function isSubagentStatus(value: unknown): value is SubagentStatus;
 export declare function isSubagentActiveStatus(value: SubagentStatus): value is SubagentActiveStatus;

package/dist/app/{subagents-model.js → subagents/subagents-model.js}

@@ -1,8 +1,8 @@
 import { basename, isAbsolute, join, resolve } from "node:path";
-import { SUBAGENT_ACTIVE_STATUSES, SUBAGENT_RENDER_MODES, SUBAGENT_STATUSES, SUBAGENT_TERMINAL_STATUSES, SUBAGENTS_TOOL_NAME, SUBAGENTS_TOOL_NAME_PREFIX, } from "./constants.js";
-import { isRecord, isStringArray } from "./guards.js";
-import { APP_ICONS } from "./icons.js";
-import { stripProviderFromModelRef } from "./model-ref.js";
+import { SUBAGENT_ACTIVE_STATUSES, SUBAGENT_RENDER_MODES, SUBAGENT_STATUSES, SUBAGENT_TERMINAL_STATUSES, SUBAGENTS_TOOL_NAME, SUBAGENTS_TOOL_NAME_PREFIX, } from "../constants.js";
+import { isRecord, isStringArray } from "../guards.js";
+import { APP_ICONS } from "../icons.js";
+import { stripProviderFromModelRef } from "../model/model-ref.js";
 export function isSubagentsToolName(toolName) {
     return toolName === SUBAGENTS_TOOL_NAME || toolName.startsWith(SUBAGENTS_TOOL_NAME_PREFIX);
 }

package/dist/app/{subagents-widget-controller.d.ts → subagents/subagents-widget-controller.d.ts}

@@ -1,4 +1,4 @@
-import type { SubagentsWidgetState } from "./types.js";
+import type { SubagentsWidgetState } from "../types.js";
 export type SubagentsToolResultObserveOptions = {
     showSnapshot?: boolean;
 };

package/dist/app/{subagents-widget-controller.js → subagents/subagents-widget-controller.js}

@@ -1,7 +1,7 @@
 import { watch } from "node:fs";
 import { join, resolve } from "node:path";
-import { SUBAGENTS_POLL_INTERVAL_MS, SUBAGENTS_RUN_ROOT } from "./constants.js";
-import { stringifyUnknown } from "./message-content.js";
+import { SUBAGENTS_POLL_INTERVAL_MS, SUBAGENTS_RUN_ROOT } from "../constants.js";
+import { stringifyUnknown } from "../rendering/message-content.js";
 import { readSubagentRegistry, readSubagentRunStateFromFiles, subagentRunHasParentSession } from "./subagents-files.js";
 import { activeSubagentStates, allSubagentStatesTerminal, isSubagentRunRenderDetails, isSubagentsLiveStateEvent, isSubagentsToolName, resolveSubagentRunDir, } from "./subagents-model.js";
 const SUBAGENTS_FILE_WATCH_DEBOUNCE_MS = 75;

package/dist/app/{terminal-bell-sound-controller.js → terminal/terminal-bell-sound-controller.js}

@@ -2,7 +2,7 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 import { applyEdits, modify, parse as parseJsonc } from "jsonc-parser";
-import { APP_ICONS } from "./icons.js";
+import { APP_ICONS } from "../icons.js";
 const TERMINAL_BELL_CONFIG_KEY = "terminalBell";
 const SOUND_CONFIG_KEY = "sound";
 export function getPiToolsSuiteUserConfigPath(homeDir = homedir()) {

package/dist/app/{terminal-controller.js → terminal/terminal-controller.js}

@@ -1,5 +1,5 @@
-import { ANSI_RESET } from "../theme.js";
-import { DISABLE_BRACKETED_PASTE, DISABLE_TERMINAL_KEY_REPORTING, DISABLE_TERMINAL_WRAP, CLEAR_TERMINAL, ENABLE_BRACKETED_PASTE, ENABLE_TERMINAL_KEY_REPORTING, ENABLE_TERMINAL_WRAP, HIDE_CURSOR, RUNTIME_DISPOSE_GRACE_MS, SHOW_CURSOR, } from "./constants.js";
+import { ANSI_RESET } from "../../theme.js";
+import { DISABLE_BRACKETED_PASTE, DISABLE_TERMINAL_KEY_REPORTING, DISABLE_TERMINAL_WRAP, CLEAR_TERMINAL, ENABLE_BRACKETED_PASTE, ENABLE_TERMINAL_KEY_REPORTING, ENABLE_TERMINAL_WRAP, HIDE_CURSOR, RUNTIME_DISPOSE_GRACE_MS, SHOW_CURSOR, } from "../constants.js";
 export class AppTerminalController {
     host;
     terminalEnabled = false;

package/dist/app/{todo-model.d.ts → todo/todo-model.d.ts}

@@ -1,4 +1,4 @@
-import type { StyledSegment, TodoAction, TodoDetails, TodoLiveStateEvent, TodoPriority, TodoStatus, TodoTask, TodoTaskLinePart, TodoTaskRow } from "./types.js";
+import type { StyledSegment, TodoAction, TodoDetails, TodoLiveStateEvent, TodoPriority, TodoStatus, TodoTask, TodoTaskLinePart, TodoTaskRow } from "../types.js";
 export declare function isTodoAction(value: unknown): value is TodoAction;
 export declare function isTodoStatus(value: unknown): value is TodoStatus;
 export declare function isTodoPriority(value: unknown): value is TodoPriority;

package/dist/app/{todo-model.js → todo/todo-model.js}

@@ -1,6 +1,6 @@
-import { TODO_ACTIONS, TODO_PRIORITIES, TODO_STATUSES } from "./constants.js";
-import { isNumberArray, isRecord, isStringArray } from "./guards.js";
-import { APP_ICONS } from "./icons.js";
+import { TODO_ACTIONS, TODO_PRIORITIES, TODO_STATUSES } from "../constants.js";
+import { isNumberArray, isRecord, isStringArray } from "../guards.js";
+import { APP_ICONS } from "../icons.js";
 export function isTodoAction(value) {
     return typeof value === "string" && TODO_ACTIONS.includes(value);
 }

package/dist/app/{todo-widget-controller.d.ts → todo/todo-widget-controller.d.ts}

@@ -1,4 +1,4 @@
-import type { TodoDetails } from "./types.js";
+import type { TodoDetails } from "../types.js";
 export type TodoWidgetControllerHost = {
     sessionFile?(): string | undefined;
     isRunning(): boolean;

package/dist/app/{todo-widget-controller.js → todo/todo-widget-controller.js}

@@ -1,6 +1,6 @@
 import { resolve } from "node:path";
-import { TODO_TOOL_NAME } from "./constants.js";
-import { stringifyUnknown } from "./message-content.js";
+import { TODO_TOOL_NAME } from "../constants.js";
+import { stringifyUnknown } from "../rendering/message-content.js";
 import { hasOpenTodoTasks, isTodoDetails, isTodoLiveStateEvent } from "./todo-model.js";
 export class AppTodoWidgetController {
     host;

package/dist/app/types.d.ts

@@ -3,8 +3,8 @@ import type { ImageContent } from "../input-editor.js";
 import type { SyntaxLineHighlight } from "../syntax-highlight.js";
 import type { ThemeName } from "../theme.js";
 import type { ToastKind, ToastNotifier } from "../ui.js";
-import type { RenderedLink } from "./file-links.js";
-import type { WorkspaceMutation } from "./workspace-undo.js";
+import type { RenderedLink } from "./screen/file-links.js";
+import type { WorkspaceMutation } from "./workspace/workspace-undo.js";
 import type { SUBAGENT_ACTIVE_STATUSES, SUBAGENT_RENDER_MODES, SUBAGENT_STATUSES, SUBAGENT_TERMINAL_STATUSES, THINKING_LEVELS, TODO_ACTIONS, TODO_PRIORITIES, TODO_STATUSES } from "./constants.js";
 export type ThinkingLevel = (typeof THINKING_LEVELS)[number];
 export type NativeModifierKey = "shift" | "command" | "control" | "option";

package/dist/app/{workspace-actions-controller.d.ts → workspace/workspace-actions-controller.d.ts}

@@ -1,5 +1,5 @@
 import { type AgentSessionRuntime } from "@earendil-works/pi-coding-agent";
-import type { Entry } from "./types.js";
+import type { Entry } from "../types.js";
 import { type WorkspaceMutation, type WorkspaceMutationFromToolInput, type WorkspaceMutationPreparation } from "./workspace-undo.js";
 export type AppWorkspaceActionsControllerHost = {
     readonly entries: Entry[];

package/dist/app/{workspace-actions-controller.js → workspace/workspace-actions-controller.js}

@@ -1,7 +1,7 @@
 import { getAgentDir } from "@earendil-works/pi-coding-agent";
-import { copyTextToClipboard } from "./clipboard.js";
-import { isRecord } from "./guards.js";
-import { createId } from "./id.js";
+import { copyTextToClipboard } from "../screen/clipboard.js";
+import { isRecord } from "../guards.js";
+import { createId } from "../id.js";
 import { loadWorkspaceUndoIndex, prepareWorkspaceMutation, revertWorkspaceMutations, saveWorkspaceUndoIndex, workspaceMutationFromToolExecution, workspaceUndoIndexKey, } from "./workspace-undo.js";
 export class AppWorkspaceActionsController {
     host;

package/dist/main.js

@@ -1,6 +1,6 @@
-import { parseArgs } from "./app/cli.js";
+import { parseArgs } from "./app/cli/cli.js";
 import { PiUiExtendApp } from "./app/app.js";
-import { stringifyUnknown } from "./app/message-content.js";
+import { stringifyUnknown } from "./app/rendering/message-content.js";
 async function main() {
     const options = parseArgs(process.argv.slice(2));
     const app = new PiUiExtendApp(options);

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

@@ -73,6 +73,84 @@ DCP settings are stored only under `dcp` in the user shared config file `~/.conf
 
 `minContextPercent` / `maxContextPercent` accept legacy fractions (`0.25`), percent strings (`"25%"`), or absolute token counts when Pi knows the current model context window. `minContextLimit` / `maxContextLimit` and `modelMinContextLimits` / `modelMaxContextLimits` are explicit absolute-or-percent aliases. If `compress.protectUserMessages` is enabled, range compression appends selected user messages verbatim instead of rejecting the range; individual message compression still skips protected raw user messages. Protected tool outputs are copied into summaries for tools protected by name or `protectedFilePatterns`; protected `subagents` result reads also try to include the saved `result.md` artifact when available.
 
+## LSP setup
+
+The LSP module reads language-server definitions from `lsp.servers` in the shared config file:
+
+```text
+~/.config/pi/pi-tools-suite.jsonc
+```
+
+Install the language servers used by the bundled example config. The commands below are written for macOS/Linux with a POSIX shell; most npm, `dotnet`, `pip`, and `rustup` commands also work on Windows, but paths and the GDScript wrapper differ.
+
+```bash
+# TypeScript / JavaScript
+npm install -g typescript typescript-language-server
+
+# Python
+python3 -m pip install --user python-lsp-server
+
+# C# / Unity
+dotnet tool install -g Microsoft.CodeAnalysis.LanguageServer
+
+# GDScript / Godot
+# Install Godot 4.x and make sure the `godot` command is on PATH.
+# macOS Homebrew example. On other OSes, use the official Godot installer/package.
+brew install --cask godot
+
+# Ruby
+brew install ruby-lsp
+# or, if using RubyGems directly:
+gem install ruby-lsp
+
+# Rust
+rustup component add rust-analyzer
+
+# Markdown
+npm install -g vscode-langservers-extracted
+```
+
+Extra runtime requirements:
+
+- The GDScript wrapper also needs `nc` and `python3`; both are available by default on most macOS/Linux setups. The wrapper starts Godot headless on a free localhost port and the LSP manager kills the whole process group on shutdown/abort.
+- C# expects `~/.dotnet/tools` on `PATH`, or an explicit `bin` path such as `~/.dotnet/tools/roslyn-language-server` in the config.
+- Rust diagnostics require a Rust project root such as `Cargo.toml`.
+- C#/Unity diagnostics require a project root such as `*.csproj`, `*.sln`, or Unity `ProjectSettings/ProjectVersion.txt`.
+- Markdown link diagnostics are provided by `vscode-markdown-language-server` when validation is enabled; Mermaid fence checks are supplemented locally by pi-tools-suite, so no separate Mermaid LSP is required for the default diagnostics.
+
+OS notes:
+
+- macOS/Linux: the sample commands and default GDScript wrapper are intended to work as-is once the binaries are on `PATH`.
+- Windows: npm, Python, .NET, Ruby, Rust, and Markdown servers can be installed natively, but adjust executable paths, for example `%USERPROFILE%\.dotnet\tools\roslyn-language-server.exe`. The bundled GDScript wrapper uses `bash`, `nc`, POSIX signals, and process groups, so use WSL/Git Bash or replace that server command with a Windows-specific wrapper.
+- Package-manager commands vary by distro. Replace `brew install ...` with your OS package manager or the official installer where appropriate.
+
+Minimal shared config shape:
+
+```jsonc
+{
+  "lsp": {
+    "servers": [
+      {
+        "id": "typescript",
+        "include": ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx", "**/*.mjs"],
+        "rootMarkers": ["tsconfig.json", "package.json"],
+        "bin": "typescript-language-server",
+        "args": ["--stdio"],
+        "languageIdByExtension": {
+          ".ts": "typescript",
+          ".tsx": "typescriptreact",
+          ".js": "javascript",
+          ".jsx": "javascriptreact",
+          ".mjs": "javascript"
+        }
+      }
+    ]
+  }
+}
+```
+
+Project-local overrides can be added in `.pi/pi-tools-suite.jsonc`; pi-tools-suite asks for trust before using project-local LSP binaries.
+
 ## Async sub-agents
 
 Sub-agent model routing normally follows task overrides, subagent type config, then `ASYNC_SUBAGENTS_MODEL` / `PI_SUBAGENTS_MODEL` fallbacks. Set `ASYNC_SUBAGENTS_FORCE_CURRENT_MODEL=1` (or `PI_SUBAGENTS_FORCE_CURRENT_MODEL=1`) to ignore task/config/env model choices and launch every sub-agent with the current parent session model. When this flag is enabled, any `--model` entries in sub-agent extra args are stripped so they cannot override the current model.

package/external/pi-tools-suite/src/async-subagents/core/agent-strategy.ts

@@ -16,6 +16,8 @@ This is an orchestration hint for Pi, not a replacement for the user's instructi
 
 Default posture: orchestration-first for non-GPT models. For broad, multi-file, ambiguous, review/audit, frontend, test-strategy, architecture, or root-cause work, prefer ultrawork mode: split independent tracks and spawn focused async subagents with the configured roles. Keep the parent context lean, collect compact results only when needed, synthesize the findings, then verify before finishing.
 
+Before DCP/compress while work is unfinished, keep one in_progress todo with objective + next step; compression summaries must preserve Active objective and Next step.
+
 Do not over-delegate trivial work. For a simple question, one known file, exact lookup, typo, or narrow edit, solve directly with the cheapest suitable tool.
 </agent_strategy>`;
 
@@ -24,6 +26,8 @@ This is a GPT-compatible execution hint for Pi, not a replacement for the user's
 
 Default posture: autonomous deep worker. Build context directly, make concrete progress, edit and verify end-to-end. Use async subagents and ultrawork mode when the user asks for parallel/delegated work or when independent tracks will clearly reduce risk, but do not force orchestration onto narrow tasks.
 
+Before DCP/compress while work is unfinished, keep one in_progress todo with objective + next step; compression summaries must preserve Active objective and Next step.
+
 For broad work, keep delegation explicit and bounded: spawn focused review/research/tests/frontend/deep tracks, read compact results, make the final decisions in the parent session, and report only what matters.
 </agent_strategy>`;
 

package/external/pi-tools-suite/src/async-subagents/core/spawn.ts

@@ -375,7 +375,12 @@ export function spawnAgent(
 			...(promptImages ? { images: promptImages } : {}),
 		}),
 	].join(""));
-	proc.stdin.end();
+	// Keep stdin open while the RPC prompt is running. pi RPC mode treats stdin
+	// EOF as a shutdown request, while the prompt command itself is handled
+	// asynchronously after preflight. Closing stdin here can therefore terminate
+	// the child before message_end/agent_end events are emitted, producing exit 0
+	// with no result.md. The child is terminated explicitly after agent_end,
+	// timeout, stop, or process error.
 
 	const pid = proc.pid!;
 	fs.writeFileSync(path.join(agentDir, "pid"), String(pid), "utf-8");

package/external/pi-tools-suite/src/dcp/prompts.ts

@@ -28,6 +28,8 @@ Summaries should be proportional to future usefulness, not proportional to the a
 
 Use \`compress\` as steady housekeeping while you work. After any completed implementation + verification slice, compress that closed slice before replying or starting a new task unless the next step needs exact raw logs/diffs. Do not carry large stale tool outputs across task boundaries.
 
+Before compressing while work is unfinished, ensure one \`todo in_progress\` captures the active objective and next step.
+
 When a \`<dcp-system-reminder>\` appears, treat it as an active instruction for the next safe action, not as background advice. Before making another exploratory tool call or starting a new subtask, check whether any earlier slice is closed; if yes, call \`compress\` first. Do not merely acknowledge the reminder or postpone it across multiple tool calls.
 
 CADENCE, SIGNALS, AND LATENCY
@@ -83,6 +85,8 @@ If a \`<dcp-system-reminder>\` is present in context, treat it as a direct instr
 THE SUMMARY
 Your summary must be COMPLETE FOR CONTINUATION, not a transcript rewrite. Preserve only information that will plausibly matter later: user intent, accepted constraints, decisions, files/symbols changed or inspected, exact errors that are still actionable, verification status, and next steps.
 
+If active unfinished work exists, start with \`Active objective\` and \`Next step\`.
+
 Default to a compact structured summary (roughly 5-15 bullets for a normal completed work slice). Grow beyond that only when the compressed range contains multiple independent decisions, unresolved blockers, or precise state that is genuinely required to continue.
 
 Do not copy long raw code, JSON, diffs, logs, or tool output into summaries. Prefer semantic descriptions such as “updated foo.json so scene_assets_1.zai-svg has maxConcurrentRuns set to 5.” Include exact snippets only when the literal text is required for safe continuation, and keep them short and single-line.