@oh-my-pi/pi-coding-agent 9.2.4 → 9.3.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## [Unreleased]
 
+## [9.2.5] - 2026-01-31
+### Changed
+
+- Clarified that user instructions about delegation override tool-use defaults
+- Updated coordinator guidance to emphasize Task tool preference for substantial work with improved emphasis on context window limitations
+- Enhanced `context` parameter documentation to require self-contained information for subagents, including file contents and user requirements
+
 ## [9.2.4] - 2026-01-31
 ### Fixed
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "9.2.4",
+	"version": "9.3.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"ompConfig": {
@@ -79,12 +79,12 @@
 		"test": "bun test"
 	},
 	"dependencies": {
-		"@oh-my-pi/omp-stats": "9.2.4",
-		"@oh-my-pi/pi-agent-core": "9.2.4",
-		"@oh-my-pi/pi-ai": "9.2.4",
-		"@oh-my-pi/pi-natives": "9.2.4",
-		"@oh-my-pi/pi-tui": "9.2.4",
-		"@oh-my-pi/pi-utils": "9.2.4",
+		"@oh-my-pi/omp-stats": "9.3.0",
+		"@oh-my-pi/pi-agent-core": "9.3.0",
+		"@oh-my-pi/pi-ai": "9.3.0",
+		"@oh-my-pi/pi-natives": "9.3.0",
+		"@oh-my-pi/pi-tui": "9.3.0",
+		"@oh-my-pi/pi-utils": "9.3.0",
 		"@openai/agents": "^0.4.4",
 		"@sinclair/typebox": "^0.34.48",
 		"ajv": "^8.17.1",

package/src/prompts/system/system-prompt.md

@@ -51,6 +51,8 @@ Say what is true. Omit what is filler.
 No apologies. No comfort where clarity belongs.
 
 Quote only what illuminates. The rest is noise.
+
+User instructions about _how_ to work (directly vs. delegation) override tool-use defaults.
 </stance>
 
 {{#if systemPromptCustomization}}
@@ -328,8 +330,8 @@ Write what you can defend.
 {{#if isCoordinator}}
 {{#has tools "task"}}
 <critical id="coordinator">
-As the coordinator, default to the Task tool for all substantial work.
-**ALWAYS use Task tool.** Your context window is limited—especially the output. Work in discrete steps and run each step using Task tool. Avoid putting substantial work in the main context when possible. Run multiple tasks in parallel whenever possible.
+As the coordinator, **ALWAYS prefer** delegation via Task tool for all SUBSTANTIAL work.
+Your context window is limited—especially the output. Work in discrete steps and run each step using Task tool. Avoid putting substantial work in the main context when possible. Run multiple tasks in parallel whenever possible.
 
 ## Triggers requiring Task tool
 - Editing 4+ files with no dependencies → `Task`

package/src/prompts/tools/task.md

@@ -35,11 +35,12 @@ This matters. Be thorough.
 4. **Always provide a `schema`** with typed properties. Avoid `{ "type": "string" }`—if data has any structure (list, fields, categories), model it. Plain text is almost never the right choice.
 5. Assign distinct file scopes per task to avoid conflicts.
 6. Trust the returned data, then verify with tools when correctness matters.
+7. The `context` must be self-contained. Paste relevant file contents, quote user requirements verbatim, include data from prior tool results. "The output user showed" means nothing to a subagent.
 </instruction>
 
 <parameters>
 - `agent`: Agent type to use for all tasks
-- `context`: Template with `\{{placeholders}}` for multi-task. Each placeholder is filled from task args. `\{{id}}` and `\{{description}}` are always available.
+- `context`: Template with `\{{placeholders}}` for multi-task. Must be self-contained—include all information the subagent needs. Subagents cannot see conversation history, images, or prior tool results. Reproduce relevant content directly: paste file snippets, quote user requirements, embed data. Each placeholder is filled from task args. `\{{id}}` and `\{{description}}` are always available.
 - `isolated`: (optional) Run each task in its own git worktree and return patches; patches are applied only if all apply cleanly.
 - `tasks`: Array of `{id, description, args}` - tasks to run in parallel
 		- `id`: Short CamelCase identifier (max 32 chars, e.g., "SessionStore", "LspRefactor")

package/src/system-prompt.ts

@@ -11,7 +11,7 @@ import chalk from "chalk";
 import { contextFileCapability } from "./capability/context-file";
 import { systemPromptCapability } from "./capability/system-prompt";
 import { renderPromptTemplate } from "./config/prompt-templates";
-import type { SkillsSettings } from "./config/settings-manager";
+import { SettingsManager, type SkillsSettings } from "./config/settings-manager";
 import { type ContextFile, loadCapability, type SystemPrompt as SystemPromptFile } from "./discovery";
 import { loadSkills, type Skill } from "./extensibility/skills";
 import customSystemPromptTemplate from "./prompts/system/custom-system-prompt.md" with { type: "text" };
@@ -573,11 +573,6 @@ async function getGpuModel(): Promise<string | null> {
 	}
 }
 
-function getShellName(): string {
-	const shell = firstNonEmpty([process.env.SHELL, process.env.ComSpec]);
-	return shell ?? "unknown";
-}
-
 function getTerminalName(): string {
 	const termProgram = process.env.TERM_PROGRAM;
 	const termProgramVersion = process.env.TERM_PROGRAM_VERSION;
@@ -765,6 +760,9 @@ async function getEnvironmentInfo(): Promise<Array<{ label: string; value: strin
 		await saveSystemInfoCache(sysInfo);
 	}
 
+	// Get the actual shell used for command execution (not $SHELL)
+	const shellConfig = await SettingsManager.getGlobalShellConfig();
+
 	return [
 		{ label: "OS", value: sysInfo.os },
 		{ label: "Distro", value: sysInfo.distro },
@@ -773,7 +771,7 @@ async function getEnvironmentInfo(): Promise<Array<{ label: string; value: strin
 		{ label: "CPU", value: sysInfo.cpu },
 		{ label: "GPU", value: sysInfo.gpu },
 		{ label: "Disk", value: sysInfo.disk },
-		{ label: "Shell", value: getShellName() },
+		{ label: "Shell", value: shellConfig.shell },
 		{ label: "Terminal", value: getTerminalName() },
 		{ label: "DE", value: getDesktopEnvironment() },
 		{ label: "WM", value: getWindowManager() },