@oh-my-pi/pi-coding-agent 13.11.1 → 13.12.3

package/CHANGELOG.md

@@ -2,6 +2,100 @@
 
 ## [Unreleased]
 
+## [13.12.2] - 2026-03-15
+
+### Added
+
+- Added `compaction.thresholdTokens` setting as a fixed token limit alternative to percentage-based compaction threshold
+- Added more artifact spill threshold options (1 KB to 1 MB) with size descriptions
+- Added more artifact tail bytes and tail lines options with descriptions
+- Added `toExtensionId` capability method to enable granular disabling of individual capabilities by ID
+- Added support for disabling specific capabilities (skills, tools, hooks, rules, prompts, instructions, slash commands, MCP servers, extension modules, and context files) via `disabledExtensions` setting
+- Added `includeDisabled` and `disabledExtensions` options to `LoadOptions` for capability loading
+- Added plugin manifest support for `extensions` entry points to allow plugins to contribute extension modules
+- Added `extensions` field to plugin features for feature-specific extension entry points
+- Added automatic discovery of extension modules from installed plugins during extension loading
+- Added `disabledExtensions` setting to allow disabling specific extensions and skills by ID
+- Added support for filtering skills by disabled extension IDs with `skill:` prefix
+
+### Changed
+
+- Changed capability loading to filter out disabled items based on extension IDs before returning results
+- Changed plugin loader to support `extensions` as a manifest entry type alongside tools, hooks, and commands
+- Changed extension discovery to include extension entry points from all enabled plugins
+- Changed context file path handling to use `path.basename()` for consistent cross-platform filename extraction
+
+### Fixed
+
+- Fixed skill loading to properly respect disabled skill names when loading from custom directories
+
+## [13.12.1] - 2026-03-15
+### Added
+
+- Support for move-only operations that preserve exact bytes including binary files
+
+### Fixed
+
+- Fixed handling of file moves when no edits are specified, now correctly preserves binary content
+- Fixed validation to reject move operations where source and destination paths are identical
+
+## [13.12.0] - 2026-03-14
+
+### Added
+
+- Added per-rule TTSR interrupt mode override via `interruptMode` field in rule frontmatter to allow fine-grained control over when TTSR interrupts stream processing
+- Added `task` model role to allow configuring a dedicated model for subtask execution via `modelRoles.task` setting
+- Added `moveCursorToMessageEnd` and `moveCursorToMessageStart` prompt actions to navigate to the beginning and end of the entire message
+- Added support for provider-level `compat` configuration to apply OpenAI compatibility settings across all models from a provider
+- Added `reasoningEffortMap` configuration option to map reasoning effort levels to provider-specific values
+- Added support for `supportsUsageInStreaming`, `requiresToolResultName`, `requiresAssistantAfterToolResult`, `requiresThinkingAsText`, `thinkingFormat`, and `supportsStrictMode` OpenAI compatibility options
+- Added support for provider-configurable `OpenAICompat.extraBody` to inject request-body fields for custom gateway/proxy routing
+- Added `close()` method to SessionManager for properly closing persistent writers after flushing pending data
+- Added `omp config init-xdg` command to initialize XDG Base Directory structure on Linux
+- Added `getHistoryDbPath()`, `getModelDbPath()`, `getMemoriesDir()`, `getTerminalSessionsDir()` path helpers
+
+### Changed
+
+- Path resolution on Linux redirects to XDG locations when `XDG_DATA_HOME` / `XDG_STATE_HOME` / `XDG_CACHE_HOME` environment variables are set
+
+### Changed
+
+- Changed TTSR interrupt logic to respect per-rule `interruptMode` settings, falling back to global `ttsr.interruptMode` when rule-level override is not specified
+- Reorganized settings tabs from 12 tabs (display, agent, input, tools, config, services, bash, lsp, ttsr, status) to 8 focused tabs (appearance, model, interaction, context, editing, tools, tasks, providers) for improved discoverability
+- Consolidated status line settings into the Appearance tab instead of a separate Status tab
+- Reorganized sampling parameters (temperature, topP, topK, minP, presencePenalty, repetitionPenalty) into the Model tab
+- Moved edit tool settings (mode, fuzzyMatch, fuzzyThreshold, streamingAbort) to the Editing tab
+- Moved read tool settings (readLineNumbers, readHashLines, read.defaultLimit) to the Editing tab
+- Moved LSP settings (lsp.enabled, lsp.formatOnWrite, lsp.diagnosticsOnWrite, lsp.diagnosticsOnEdit) to the Editing tab
+- Moved bash interceptor settings to the Editing tab
+- Moved Python settings (python.toolMode, python.kernelMode, python.sharedGateway) to the Editing tab
+- Moved task delegation settings (task.isolation.*, task.eager, task.maxConcurrency, task.maxRecursionDepth) to the Tasks tab
+- Moved skill and command settings to the Tasks tab
+- Moved provider selection settings (providers.webSearch, providers.codeSearch, providers.image, etc.) to the Providers tab
+- Moved Exa settings to the Providers tab
+- Moved secret handling settings to the Providers tab
+- Moved speech-to-text settings to the Interaction tab
+- Moved context promotion, compaction, branch summary, memories, and TTSR settings to the Context tab
+- Updated tab icon symbols across unicode, nerd, and ASCII presets to match new tab structure
+- Changed default agent model from `default` to `pi/task` to enable independent model configuration for subtasks
+- Changed agent model resolution to support single-pattern inheritance fallback, allowing `pi/task` agents to inherit the active session model when the task role is unconfigured
+- Changed system prompt to use ISO 8601 date format (YYYY-MM-DD) instead of locale-specific formatting
+- Changed system prompt template to use `{{date}}` instead of `{{dateTime}}` for current date display
+- Changed tool download timeout from 15 seconds to 120 seconds to accommodate slower network conditions
+- Changed working directory paths in system prompt to use forward slashes for consistency across platforms
+- Modified bash executor to fall back to one-shot shell execution after a persistent session hard timeout, preventing subsequent commands from hanging
+
+### Removed
+
+- Removed bash executor hard timeout recovery test file (functionality already documented in existing entries)
+
+### Fixed
+
+- Fixed bash execution to fall back to one-shot shell runs after a persistent session hard timeout, preventing later commands from hanging until restart
+- Fixed timeout handling in RpcClient to properly clear timeouts and prevent resource leaks
+- Fixed AgentSession disposal to call SessionManager's `close()` method when available, ensuring proper cleanup of persistent writers
+- Removed redundant `path.join()` call wrapping `getHistoryDbPath()` in history-storage.ts
+
 ## [13.11.1] - 2026-03-13
 
 ### Added
@@ -46,6 +140,7 @@
 - Added `buildNamedToolChoice` utility function to build provider-aware tool choice constraints for named tools
 - Support for comma/space-separated path lists in `find`, `grep`, `ast_grep`, and `ast_edit` tools (e.g., `apps/,packages/,phases/` or `apps/ packages/ phases/`)
 - New `resolveMultiSearchPath` and `resolveMultiFindPattern` functions to handle multi-path search inputs with automatic common base path detection
+- Added `display.showTokenUsage` setting to show per-turn token usage (input, output, cache) on assistant messages
 
 ### Changed
 

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "13.11.1",
+	"version": "13.12.3",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/can1357/oh-my-pi",
 	"author": "Can Boluk",
@@ -41,12 +41,12 @@
 	},
 	"dependencies": {
 		"@mozilla/readability": "^0.6",
-		"@oh-my-pi/omp-stats": "13.11.1",
-		"@oh-my-pi/pi-agent-core": "13.11.1",
-		"@oh-my-pi/pi-ai": "13.11.1",
-		"@oh-my-pi/pi-natives": "13.11.1",
-		"@oh-my-pi/pi-tui": "13.11.1",
-		"@oh-my-pi/pi-utils": "13.11.1",
+		"@oh-my-pi/omp-stats": "13.12.3",
+		"@oh-my-pi/pi-agent-core": "13.12.3",
+		"@oh-my-pi/pi-ai": "13.12.3",
+		"@oh-my-pi/pi-natives": "13.12.3",
+		"@oh-my-pi/pi-tui": "13.12.3",
+		"@oh-my-pi/pi-utils": "13.12.3",
 		"@sinclair/typebox": "^0.34",
 		"@xterm/headless": "^6.0",
 		"ajv": "^8.18",

package/src/capability/context-file.ts

@@ -4,6 +4,7 @@
  * System instruction files (CLAUDE.md, AGENTS.md, GEMINI.md, etc.) that provide
  * persistent guidance to the agent.
  */
+import * as path from "node:path";
 import { defineCapability } from ".";
 import type { SourceMeta } from "./types";
 
@@ -33,6 +34,7 @@ export const contextFileCapability = defineCapability<ContextFile>({
 	// Clamp depth >= 0: files inside config subdirectories of an ancestor (e.g. .claude/, .github/)
 	// are same-scope as the ancestor itself.
 	key: file => (file.level === "user" ? "user" : `project:${Math.max(0, file.depth ?? 0)}`),
+	toExtensionId: file => `context-file:${file.level}:${path.basename(file.path)}`,
 	validate: file => {
 		if (!file.path) return "Missing path";
 		if (file.content === undefined) return "Missing content";

package/src/capability/extension-module.ts

@@ -25,6 +25,7 @@ export const extensionModuleCapability = defineCapability<ExtensionModule>({
 	displayName: "Extension Modules",
 	description: "TypeScript/JavaScript extension modules loaded by the extension system",
 	key: ext => ext.name,
+	toExtensionId: ext => `extension-module:${ext.name}`,
 	validate: ext => {
 		if (!ext.name) return "Missing name";
 		if (!ext.path) return "Missing path";

package/src/capability/hook.ts

@@ -29,6 +29,7 @@ export const hookCapability = defineCapability<Hook>({
 	displayName: "Hooks",
 	description: "Pre/post tool execution hooks",
 	key: hook => `${hook.type}:${hook.tool}:${hook.name}`,
+	toExtensionId: hook => `hook:${hook.type}:${hook.tool}:${hook.name}`,
 	validate: hook => {
 		if (!hook.name) return "Missing name";
 		if (!hook.path) return "Missing path";

package/src/capability/index.ts

@@ -107,6 +107,9 @@ async function loadImpl<T>(
 	const allItems: Array<T & { _source: SourceMeta; _shadowed?: boolean }> = [];
 	const allWarnings: string[] = [];
 	const contributingProviders: string[] = [];
+	const disabledExtensionIds = options.includeDisabled
+		? new Set<string>()
+		: new Set<string>(options.disabledExtensions ?? settings?.get("disabledExtensions") ?? []);
 
 	const results = await Promise.all(
 		providers.map(async provider => {
@@ -136,18 +139,26 @@ async function loadImpl<T>(
 			allWarnings.push(...result.warnings.map(w => `[${provider.displayName}] ${w}`));
 		}
 
-		if (result.items.length > 0) {
-			contributingProviders.push(provider.id);
+		let contributedItemCount = 0;
+		for (const item of result.items) {
+			const itemWithSource = item as T & { _source: SourceMeta };
+			if (!itemWithSource._source) {
+				allWarnings.push(`[${provider.displayName}] Item missing _source metadata, skipping`);
+				continue;
+			}
 
-			for (const item of result.items) {
-				const itemWithSource = item as T & { _source: SourceMeta };
-				if (itemWithSource._source) {
-					itemWithSource._source.providerName = provider.displayName;
-					allItems.push(itemWithSource as T & { _source: SourceMeta; _shadowed?: boolean });
-				} else {
-					allWarnings.push(`[${provider.displayName}] Item missing _source metadata, skipping`);
-				}
+			const extensionId = capability.toExtensionId?.(itemWithSource);
+			if (extensionId && disabledExtensionIds.has(extensionId)) {
+				continue;
 			}
+
+			itemWithSource._source.providerName = provider.displayName;
+			allItems.push(itemWithSource as T & { _source: SourceMeta; _shadowed?: boolean });
+			contributedItemCount += 1;
+		}
+
+		if (contributedItemCount > 0) {
+			contributingProviders.push(provider.id);
 		}
 	}
 

package/src/capability/instruction.ts

@@ -27,6 +27,7 @@ export const instructionCapability = defineCapability<Instruction>({
 	displayName: "Instructions",
 	description: "File-specific instructions with glob pattern matching (GitHub Copilot format)",
 	key: inst => inst.name,
+	toExtensionId: inst => `instruction:${inst.name}`,
 	validate: inst => {
 		if (!inst.name) return "Missing name";
 		if (!inst.path) return "Missing path";

package/src/capability/mcp.ts

@@ -48,6 +48,7 @@ export const mcpCapability = defineCapability<MCPServer>({
 	displayName: "MCP Servers",
 	description: "Model Context Protocol server configurations for external tool integrations",
 	key: server => server.name,
+	toExtensionId: server => `mcp:${server.name}`,
 	validate: server => {
 		if (!server.name) return "Missing server name";
 		if (!server.command && !server.url) return "Must have command or url";

package/src/capability/prompt.ts

@@ -25,6 +25,7 @@ export const promptCapability = defineCapability<Prompt>({
 	displayName: "Prompts",
 	description: "Reusable prompt templates available via /prompts: menu",
 	key: prompt => prompt.name,
+	toExtensionId: prompt => `prompt:${prompt.name}`,
 	validate: prompt => {
 		if (!prompt.name) return "Missing name";
 		if (!prompt.path) return "Missing path";

package/src/capability/rule.ts

@@ -20,6 +20,8 @@ export interface RuleFrontmatter {
 	condition?: string | string[];
 	/** New key for TTSR stream scope. */
 	scope?: string | string[];
+	/** Per-rule TTSR interrupt mode override. */
+	interruptMode?: "never" | "prose-only" | "tool-only" | "always";
 	[key: string]: unknown;
 }
 
@@ -43,6 +45,8 @@ export interface Rule {
 	condition?: string[];
 	/** Optional stream scope tokens (for example: text, thinking, tool:edit(*.ts)). */
 	scope?: string[];
+	/** Per-rule TTSR interrupt mode override (falls back to global ttsr.interruptMode). */
+	interruptMode?: "never" | "prose-only" | "tool-only" | "always";
 	/** Source metadata */
 	_source: SourceMeta;
 }
@@ -210,6 +214,7 @@ export const ruleCapability = defineCapability<Rule>({
 	displayName: "Rules",
 	description: "Project-specific rules and constraints (Cursor MDC, Windsurf, Cline formats)",
 	key: rule => rule.name,
+	toExtensionId: rule => `rule:${rule.name}`,
 	validate: rule => {
 		if (!rule.name) return "Missing rule name";
 		if (!rule.path) return "Missing rule path";

package/src/capability/skill.ts

@@ -40,6 +40,7 @@ export const skillCapability = defineCapability<Skill>({
 	displayName: "Skills",
 	description: "Specialized knowledge and workflow files that extend agent capabilities",
 	key: skill => skill.name,
+	toExtensionId: skill => `skill:${skill.name}`,
 	validate: skill => {
 		if (!skill.name) return "Missing skill name";
 		if (!skill.path) return "Missing skill path";

package/src/capability/slash-command.ts

@@ -27,6 +27,7 @@ export const slashCommandCapability = defineCapability<SlashCommand>({
 	displayName: "Slash Commands",
 	description: "Custom slash commands defined as markdown files",
 	key: cmd => cmd.name,
+	toExtensionId: cmd => `slash-command:${cmd.name}`,
 	validate: cmd => {
 		if (!cmd.name) return "Missing name";
 		if (!cmd.path) return "Missing path";

package/src/capability/tool.ts

@@ -29,6 +29,7 @@ export const toolCapability = defineCapability<CustomTool>({
 	displayName: "Custom Tools",
 	description: "User-defined tools that extend agent capabilities",
 	key: tool => tool.name,
+	toExtensionId: tool => `tool:${tool.name}`,
 	validate: tool => {
 		if (!tool.name) return "Missing name";
 		if (!tool.path) return "Missing path";

package/src/capability/types.ts

@@ -68,6 +68,10 @@ export interface LoadOptions {
 	cwd?: string;
 	/** Include items even if they fail validation. Default: false */
 	includeInvalid?: boolean;
+	/** Include items disabled via settings. Default: false */
+	includeDisabled?: boolean;
+	/** Explicit disabled extension IDs to apply instead of settings. */
+	disabledExtensions?: string[];
 }
 
 /**
@@ -123,6 +127,12 @@ export interface Capability<T> {
 	 */
 	validate?(item: T): string | undefined;
 
+	/**
+	 * Optional disabledExtensions ID for this item.
+	 * When present, loadCapability() can hide items disabled via settings.
+	 */
+	toExtensionId?(item: T): string | undefined;
+
 	/** Registered providers, sorted by priority (highest first) */
 	providers: Provider<T>[];
 }

package/src/cli/commands/init-xdg.ts

@@ -0,0 +1,27 @@
+import * as fs from "node:fs/promises";
+import * as os from "node:os";
+import * as path from "node:path";
+
+const APP_NAME = "omp";
+
+export async function initXdg(): Promise<void> {
+	if (process.platform !== "linux" && process.platform !== "darwin") {
+		console.error("XDG directory setup is only supported on Linux and macOS.");
+		process.exit(1);
+	}
+
+	const dataHome = process.env.XDG_DATA_HOME || path.join(os.homedir(), ".local/share");
+	const stateHome = process.env.XDG_STATE_HOME || path.join(os.homedir(), ".local/state");
+	const cacheHome = process.env.XDG_CACHE_HOME || path.join(os.homedir(), ".cache");
+
+	const dirs = [path.join(dataHome, APP_NAME), path.join(stateHome, APP_NAME), path.join(cacheHome, APP_NAME)];
+
+	for (const dir of dirs) {
+		await fs.mkdir(dir, { recursive: true });
+		console.log(`Created ${dir.replace(os.homedir(), "~")}`);
+	}
+
+	console.log("\nXDG directories initialized.");
+	console.log("Ensure XDG_DATA_HOME, XDG_STATE_HOME, and XDG_CACHE_HOME");
+	console.log("are set in your shell profile for omp to use them.");
+}

package/src/cli/config-cli.ts

@@ -19,12 +19,13 @@ import {
 } from "../config/settings";
 import { SETTINGS_SCHEMA } from "../config/settings-schema";
 import { theme } from "../modes/theme/theme";
+import { initXdg } from "./commands/init-xdg";
 
 // =============================================================================
 // Types
 // =============================================================================
 
-export type ConfigAction = "list" | "get" | "set" | "reset" | "path";
+export type ConfigAction = "list" | "get" | "set" | "reset" | "path" | "init-xdg";
 
 export interface ConfigCommandArgs {
 	action: ConfigAction;
@@ -34,7 +35,6 @@ export interface ConfigCommandArgs {
 		json?: boolean;
 	};
 }
-
 // =============================================================================
 // Setting Filtering
 // =============================================================================
@@ -73,7 +73,7 @@ function getSettingValues(def: CliSettingDef): readonly string[] | undefined {
 // Argument Parser
 // =============================================================================
 
-const VALID_ACTIONS: ConfigAction[] = ["list", "get", "set", "reset", "path"];
+const VALID_ACTIONS: ConfigAction[] = ["list", "get", "set", "reset", "path", "init-xdg"];
 
 /**
  * Parse config subcommand arguments.
@@ -251,6 +251,9 @@ export async function runConfigCommand(cmd: ConfigCommandArgs): Promise<void> {
 		case "path":
 			handlePath();
 			break;
+		case "init-xdg":
+			await initXdg();
+			break;
 	}
 }
 
@@ -394,6 +397,7 @@ ${chalk.bold("Commands:")}
   set <key> <value>  Set a setting value
   reset <key>        Reset a setting to its default value
   path               Print the config directory path
+  init-xdg           Initialize XDG Base Directory structure
 
 ${chalk.bold("Options:")}
   --json             Output as JSON
@@ -406,6 +410,7 @@ ${chalk.bold("Examples:")}
   ${APP_NAME} config set defaultThinkingLevel medium
   ${APP_NAME} config reset steeringMode
   ${APP_NAME} config list --json
+  ${APP_NAME} config init-xdg
 
 ${chalk.bold("Boolean Values:")}
   true, false, yes, no, on, off, 1, 0

package/src/cli/shell-cli.ts

@@ -85,7 +85,7 @@ export async function runShellCommand(cmd: ShellCommandArgs): Promise<void> {
 
 	const interruptHandler = () => {
 		if (active) {
-			shellSession.abort();
+			void shellSession.abort();
 			return;
 		}
 		rl.close();

package/src/commands/config.ts

@@ -5,7 +5,7 @@ import { Args, Command, Flags } from "@oh-my-pi/pi-utils/cli";
 import { type ConfigAction, type ConfigCommandArgs, runConfigCommand } from "../cli/config-cli";
 import { initTheme } from "../modes/theme/theme";
 
-const ACTIONS: ConfigAction[] = ["list", "get", "set", "reset", "path"];
+const ACTIONS: ConfigAction[] = ["list", "get", "set", "reset", "path", "init-xdg"];
 
 export default class Config extends Command {
 	static description = "Manage configuration settings";