@oh-my-pi/pi-coding-agent 13.0.2 → 13.1.1

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 ## [Unreleased]
 
+## [13.1.1] - 2026-02-23
+
+### Fixed
+
+- Fixed bash internal URL expansion to resolve `local://` targets to concrete filesystem paths, including newly created destination files for commands like `mv src.json local://dest.json`
+- Fixed bash local URL resolution to create missing parent directories under the session local root before command execution, preventing `mv` destination failures for new paths
+## [13.1.0] - 2026-02-23
+### Breaking Changes
+
+- Renamed `file` parameter to `path` in replace, patch, and hashline edit operations
+
+### Added
+
+- Added clarification in hashline edit documentation that the `end` tag must include closing braces/brackets when replacing blocks to prevent syntax errors
+
+### Changed
+
+- Restructured task tool documentation for clarity, moving parameter definitions into a dedicated section and consolidating guidance on context, assignments, and parallelization
+- Reformatted system prompt template to use markdown headings instead of XML tags for skills, preloaded skills, and rules sections
+- Renamed `deviceScaleFactor` parameter to `device_scale_factor` in browser viewport configuration for consistency with snake_case naming convention
+- Moved intent field documentation from per-tool JSON schema descriptions into a single system prompt block, reducing token overhead proportional to tool count
+
 ## [13.0.1] - 2026-02-22
 ### Changed
 

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "13.0.2",
+	"version": "13.1.1",
 	"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.0.2",
-		"@oh-my-pi/pi-agent-core": "13.0.2",
-		"@oh-my-pi/pi-ai": "13.0.2",
-		"@oh-my-pi/pi-natives": "13.0.2",
-		"@oh-my-pi/pi-tui": "13.0.2",
-		"@oh-my-pi/pi-utils": "13.0.2",
+		"@oh-my-pi/omp-stats": "13.1.1",
+		"@oh-my-pi/pi-agent-core": "13.1.1",
+		"@oh-my-pi/pi-ai": "13.1.1",
+		"@oh-my-pi/pi-natives": "13.1.1",
+		"@oh-my-pi/pi-tui": "13.1.1",
+		"@oh-my-pi/pi-utils": "13.1.1",
 		"@sinclair/typebox": "^0.34",
 		"@xterm/headless": "^6.0",
 		"ajv": "^8.18",

package/src/patch/index.ts

@@ -108,14 +108,14 @@ export { ApplyPatchError, EditMatchError, ParseError } from "./types";
 // ═══════════════════════════════════════════════════════════════════════════
 
 const replaceEditSchema = Type.Object({
-	file: Type.String({ description: "File path (relative or absolute)" }),
+	path: Type.String({ description: "File path (relative or absolute)" }),
 	old_text: Type.String({ description: "Text to find (fuzzy whitespace matching enabled)" }),
 	new_text: Type.String({ description: "Replacement text" }),
 	all: Type.Optional(Type.Boolean({ description: "Replace all occurrences (default: unique match required)" })),
 });
 
 const patchEditSchema = Type.Object({
-	file: Type.String({ description: "File path" }),
+	path: Type.String({ description: "File path" }),
 	op: Type.Optional(
 		StringEnum(["create", "delete", "update"], {
 			description: "Operation (default: update)",
@@ -192,10 +192,10 @@ const hashlineEditSchema = Type.Object(
 
 const hashlineEditParamsSchema = Type.Object(
 	{
-		file: Type.String({ description: "path" }),
-		edits: Type.Array(hashlineEditSchema, { description: "edits over $file" }),
-		delete: Type.Optional(Type.Boolean({ description: "If true, delete $file" })),
-		move: Type.Optional(Type.String({ description: "If set, move $file to $move" })),
+		path: Type.String({ description: "path" }),
+		edits: Type.Array(hashlineEditSchema, { description: "edits over $path" }),
+		delete: Type.Optional(Type.Boolean({ description: "If true, delete $path" })),
+		move: Type.Optional(Type.String({ description: "If set, move $path to $move" })),
 	},
 	{ additionalProperties: false },
 );
@@ -489,7 +489,7 @@ export class EditTool implements AgentTool<TInput> {
 		// Hashline mode execution
 		// ─────────────────────────────────────────────────────────────────
 		if (this.mode === "hashline") {
-			const { file: path, edits, delete: deleteFile, move } = params as HashlineParams;
+			const { path, edits, delete: deleteFile, move } = params as HashlineParams;
 
 			enforcePlanModeWrite(this.session, path, { op: deleteFile ? "delete" : "update", move });
 
@@ -659,7 +659,7 @@ export class EditTool implements AgentTool<TInput> {
 		// Patch mode execution
 		// ─────────────────────────────────────────────────────────────────
 		if (this.mode === "patch") {
-			const { file: path, op: rawOp, rename, diff } = params as PatchParams;
+			const { path, op: rawOp, rename, diff } = params as PatchParams;
 
 			// Normalize unrecognized operations to "update"
 			const op: Operation = rawOp === "create" || rawOp === "delete" ? rawOp : "update";
@@ -741,7 +741,7 @@ export class EditTool implements AgentTool<TInput> {
 		// ─────────────────────────────────────────────────────────────────
 		// Replace mode execution
 		// ─────────────────────────────────────────────────────────────────
-		const { file: path, old_text, new_text, all } = params as ReplaceParams;
+		const { path, old_text, new_text, all } = params as ReplaceParams;
 
 		enforcePlanModeWrite(this.session, path);
 

package/src/patch/shared.ts

@@ -71,7 +71,6 @@ export interface EditToolDetails {
 interface EditRenderArgs {
 	path?: string;
 	file_path?: string;
-	file?: string;
 	oldText?: string;
 	newText?: string;
 	patch?: string;
@@ -220,7 +219,7 @@ export const editToolRenderer = {
 	mergeCallAndResult: true,
 
 	renderCall(args: EditRenderArgs, options: RenderResultOptions, uiTheme: Theme): Component {
-		const rawPath = args.file_path || args.path || args.file || "";
+		const rawPath = args.file_path || args.path || "";
 		const filePath = shortenPath(rawPath);
 		const editLanguage = getLanguageFromPath(rawPath) ?? "text";
 		const editIcon = uiTheme.fg("muted", uiTheme.getLangIcon(editLanguage));
@@ -275,7 +274,7 @@ export const editToolRenderer = {
 		uiTheme: Theme,
 		args?: EditRenderArgs,
 	): Component {
-		const rawPath = args?.file_path || args?.path || args?.file || "";
+		const rawPath = args?.file_path || args?.path || "";
 		const filePath = shortenPath(rawPath);
 		const editLanguage = getLanguageFromPath(rawPath) ?? "text";
 		const editIcon = uiTheme.fg("muted", uiTheme.getLangIcon(editLanguage));

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

@@ -100,6 +100,10 @@ You MUST NOT open a file hoping. Hope is not a strategy.
 {{#has tools "grep"}}- Known territory → `grep` to locate target{{/has}}
 {{#has tools "read"}}- Known location → `read` with offset/limit, not whole file{{/has}}
 {{/ifAny}}
+
+{{#if intentTracing}}
+Every tool has a required `{{intentField}}` parameter. Describe intent as one sentence in present participle form (e.g., Inserting comment before the function) with no trailing period.
+{{/if}}
 </tools>
 
 <procedure>
@@ -215,30 +219,26 @@ Match skill descriptions to the task domain. If a skill is relevant, you MUST re
 Relative paths in skill files resolve against the skill directory.
 
 {{#list skills join="\n"}}
-<skill name="{{name}}">
+### {{name}}
 {{description}}
-</skill>
 {{/list}}
 </skills>
 {{/if}}
 {{#if preloadedSkills.length}}
-<preloaded-skills>
+<skills>
 {{#list preloadedSkills join="\n"}}
 <skill name="{{name}}">
 {{content}}
 </skill>
 {{/list}}
-</preloaded-skills>
+</skills>
 {{/if}}
 {{#if rules.length}}
 <rules>
 Read `rule://<name>` when working in matching domain.
-
 {{#list rules join="\n"}}
-<rule name="{{name}}">
+### {{name}} (Glob: {{#list globs join=", "}}{{this}}{{/list}})
 {{description}}
-{{#list globs join="\n"}}<glob>{{this}}</glob>{{/list}}
-</rule>
 {{/list}}
 </rules>
 {{/if}}

package/src/prompts/tools/ask.md

@@ -12,33 +12,18 @@ Ask user when you need clarification or input during task execution.
 - Set `multi: true` on question to allow multiple selections
 </instruction>
 
-<output>
-Returns selected option(s) as text. For multi-part questions, returns map of question IDs to selected values.
-</output>
-
 <caution>
 - Provide 2-5 concise, distinct options
 </caution>
 
 <critical>
-**Default to action. You MUST NOT ask unless you are genuinely blocked and user preference is required to avoid a wrong outcome.**
-1. You MUST **resolve ambiguity yourself** using repo conventions, existing patterns, and reasonable defaults.
-2. You MUST **exhaust existing sources** (code, configs, docs, history) before asking anything.
-3. **If multiple choices are acceptable**, you MUST pick the most conservative/standard option and proceed; state the choice.
-4. You MUST **only ask when options have materially different tradeoffs and the user must decide.**
-**You MUST NOT include "Other" option in your options array.** UI automatically adds "Other (type your own)" to every question; adding your own creates duplicates.
+- **Default to action.** Resolve ambiguity yourself using repo conventions, existing patterns, and reasonable defaults. Exhaust existing sources (code, configs, docs, history) before asking. Only ask when options have materially different tradeoffs the user must decide.
+- **If multiple choices are acceptable**, pick the most conservative/standard option and proceed; state the choice.
+- **Do NOT include "Other" option** — UI automatically adds "Other (type your own)" to every question.
 </critical>
 
 <example name="single">
 question: "Which authentication method should this API use?"
 options: [{"label": "JWT"}, {"label": "OAuth2"}, {"label": "Session cookies"}]
 recommended: 0
-</example>
-
-<example name="multi-part">
-questions: [
-  {"id": "auth", "question": "Which auth method?", "options": [{"label": "JWT"}, {"label": "OAuth2"}], "recommended": 0},
-  {"id": "cache", "question": "Enable caching?", "options": [{"label": "Yes"}, {"label": "No"}]},
-  {"id": "features", "question": "Which features to include?", "options": [{"label": "Logging"}, {"label": "Metrics"}, {"label": "Tracing"}], "multi": true}
-]
 </example>

package/src/prompts/tools/{poll-jobs.md → await.md}

@@ -1,4 +1,4 @@
-# Poll Jobs
+# Await
 
 Block until one or more background jobs complete, fail, or are cancelled.
 

package/src/prompts/tools/bash.md

@@ -13,17 +13,18 @@ Executes bash command in shell session for terminal operations like git, bun, ca
 {{#if asyncEnabled}}
 - Use `async: true` for long-running commands when you don't need immediate output; the call returns a background job ID and the result is delivered automatically as a follow-up.
 - Use `read jobs://` to inspect all background jobs and `read jobs://<job-id>` for detailed status/output when needed.
-- When you need to wait for async results before continuing, you MUST call `poll_jobs` — it blocks until jobs complete. You MUST NOT poll `read jobs://` in a loop or yield and hope for delivery.
+- When you need to wait for async results before continuing, call `await` — it blocks until jobs complete. Do NOT poll `read jobs://` in a loop or yield and hope for delivery.
 {{/if}}
 </instruction>
 
 <output>
 Returns the output, and an exit code from command execution.
+- If output truncated, full output can be retrieved from `artifact://<id>`, linked in metadata
 - Exit codes shown on non-zero exit
 </output>
 
 <critical>
 - You MUST NOT use Bash for these operations like read, grep, find, edit, write, where specialized tools exist.
-- You MUST NOT use `2>&1` | `2>/dev/null` pattern, stdout and stderr are already merged.
+- You MUST NOT use `2>&1` pattern, stdout and stderr are already merged.
 - You MUST NOT use `| head -n 50` or `| tail -n 100` pattern, use `head` and `tail` parameters instead.
 </critical>

package/src/prompts/tools/browser.md

@@ -1,24 +1,17 @@
 # Browser
 
-Use this tool to navigate, click, type, scroll, drag, query DOM content, and capture screenshots.
+Navigate, click, type, scroll, drag, query DOM content, and capture screenshots.
 
 <instruction>
-- Use `action: "open"` to start a new headless browser session (or implicitly launch on first action)
-- Use `action: "goto"` with `url` to navigate
-- Use `action: "observe"` to capture a numbered accessibility snapshot with URL/title/viewport/scroll info
-	- You SHOULD prefer `click_id`, `type_id`, or `fill_id` actions using the returned `element_id` values
-	- Optional flags: `include_all` to include non-interactive nodes, `viewport_only` to limit to visible elements
-- Use `action: "click"`, `"type"`, `"fill"`, `"press"`, `"scroll"`, or `"drag"` for selector-based interactions
-	- You SHOULD prefer ARIA or text selectors (e.g. `p-aria/[name="Sign in"]`, `p-text/Continue`) over brittle CSS
-- Use `action: "click_id"`, `"type_id"`, or `"fill_id"` to interact with observed elements without selectors
-- Use `action: "wait_for_selector"` before interacting when the page is dynamic
-- Use `action: "evaluate"` with `script` to run a JavaScript expression in the page context
-- Use `action: "get_text"`, `"get_html"`, or `"get_attribute"` for DOM queries
-	- For batch queries, pass `args: [{ selector, attribute? }]` to get an array of results (attribute required for `get_attribute`)
-- Use `action: "extract_readable"` to return reader-mode content (title/byline/excerpt/text or markdown)
-	- Set `format` to `"markdown"` (default) or `"text"`
-- Use `action: "screenshot"` to capture images (optionally with `selector` to capture a single element)
-- Use `action: "close"` to release the browser when done
+- `"open"` starts a headless session (or implicitly on first action); `"goto"` navigates to `url`; `"close"` releases the browser
+- `"observe"` captures a numbered accessibility snapshot — prefer `click_id`/`type_id`/`fill_id` using returned `element_id` values; flags: `include_all`, `viewport_only`
+- `"click"`, `"type"`, `"fill"`, `"press"`, `"scroll"`, `"drag"` for selector-based interactions — prefer ARIA/text selectors (`p-aria/[name="Sign in"]`, `p-text/Continue`) over brittle CSS
+- `"click_id"`, `"type_id"`, `"fill_id"` to interact with observed elements without selectors
+- `"wait_for_selector"` before interacting when the page is dynamic
+- `"evaluate"` runs a JS expression in page context
+- `"get_text"`, `"get_html"`, `"get_attribute"` for DOM queries — batch via `args: [{ selector, attribute? }]`
+- `"extract_readable"` returns reader-mode content; `format`: `"markdown"` (default) or `"text"`
+- `"screenshot"` captures images (optionally with `selector`); can save to disk via `path`
 </instruction>
 
 <critical>
@@ -29,5 +22,5 @@ Use this tool to navigate, click, type, scroll, drag, query DOM content, and cap
 </critical>
 
 <output>
-Returns text output for navigation and DOM queries, and image output for screenshots. Screenshots can optionally be saved to disk via the `path` parameter.
+Text for navigation/DOM queries, images for screenshots.
 </output>

package/src/prompts/tools/fetch.md

@@ -3,14 +3,11 @@
 Retrieves content from a URL and returns it in a clean, readable format.
 
 <instruction>
-- Extract information from web pages (documentation, articles, API references)
-- Analyze GitHub issues, PRs, or repository content
-- Retrieve from Stack Overflow, Wikipedia, Reddit, NPM, arXiv, technical blogs
-- Access RSS/Atom feeds or JSON endpoints
+- Extract information from web pages, GitHub issues/PRs, Stack Overflow, Wikipedia, Reddit, NPM, arXiv, technical blogs, RSS/Atom feeds, JSON endpoints
 - Read PDF or DOCX files hosted at a URL
 - Use `raw: true` for untouched HTML or debugging
 </instruction>
 
 <output>
-Returns processed, readable content extracted from the URL. HTML is transformed to remove navigation, ads, and boilerplate. PDF and DOCX files are converted to text. JSON endpoints return formatted JSON. With `raw: true`, returns untransformed HTML.
+Returns processed, readable content. HTML transformed to remove boilerplate. PDF/DOCX converted to text. JSON returned formatted. With `raw: true`, returns untransformed HTML.
 </output>

package/src/prompts/tools/find.md

@@ -10,7 +10,7 @@ Fast file pattern matching that works with any codebase size.
 </instruction>
 
 <output>
-Matching file paths sorted by modification time (most recent first). Results truncated at 1000 entries or 50KB (configurable via `limit`).
+Matching file paths sorted by modification time (most recent first). Truncated at 1000 entries or 50KB (configurable via `limit`).
 </output>
 
 <example name="find files">

package/src/prompts/tools/grep.md

@@ -3,16 +3,13 @@
 Powerful search tool built on ripgrep.
 
 <instruction>
-- Supports full regex syntax (e.g., `log.*Error`, `function\\s+\\w+`)
+- Supports full regex syntax (e.g., `log.*Error`, `function\\s+\\w+`); literal braces need escaping (`interface\\{\\}` for `interface{}` in Go)
 - Filter files with `glob` (e.g., `*.js`, `**/*.tsx`) or `type` (e.g., `js`, `py`, `rust`)
-- Pattern syntax uses ripgrep—literal braces need escaping (`interface\\{\\}` to find `interface{}` in Go)
 - For cross-line patterns like `struct \\{[\\s\\S]*?field`, set `multiline: true` if needed
 - If the pattern contains a literal `\n`, multiline defaults to true
 </instruction>
 
 <output>
-- Results are always content mode.
-- Results grouped by directory (`# dir`) and file (`## └─ file`) headings
 {{#if IS_HASHLINE_MODE}}
 - Text output is CID prefixed: `LINE#ID:content`
 {{else}}

package/src/prompts/tools/hashline.md

@@ -22,20 +22,20 @@ Every edit has `op`, `pos`, and `lines`. Range replaces also have `end`. Both `p
 - `null` or `[]` — **delete** the line(s) entirely
 
 ### Line or range replace/delete
-- `{ file: "…", edits: [{ op: "replace", pos: "N#ID", lines: null }] }` — delete one line
-- `{ file: "…", edits: [{ op: "replace", pos: "N#ID", end: "M#ID", lines: null }] }` — delete a range
-- `{ file: "…", edits: [{ op: "replace", pos: "N#ID", lines: […] }] }` — replace one line
-- `{ file: "…", edits: [{ op: "replace", pos: "N#ID", end: "M#ID", lines: […] }] }` — replace a range
+- `{ path: "…", edits: [{ op: "replace", pos: "N#ID", lines: null }] }` — delete one line
+- `{ path: "…", edits: [{ op: "replace", pos: "N#ID", end: "M#ID", lines: null }] }` — delete a range
+- `{ path: "…", edits: [{ op: "replace", pos: "N#ID", lines: […] }] }` — replace one line
+- `{ path: "…", edits: [{ op: "replace", pos: "N#ID", end: "M#ID", lines: […] }] }` — replace a range
 
 ### Insert new lines
-- `{ file: "…", edits: [{ op: "prepend", pos: "N#ID", lines: […] }] }` — insert before tagged line
-- `{ file: "…", edits: [{ op: "prepend", lines: […] }] }` — insert at beginning of file (no tag)
-- `{ file: "…", edits: [{ op: "append", pos: "N#ID", lines: […] }] }` — insert after tagged line
-- `{ file: "…", edits: [{ op: "append", lines: […] }] }` — insert at end of file (no tag)
+- `{ path: "…", edits: [{ op: "prepend", pos: "N#ID", lines: […] }] }` — insert before tagged line
+- `{ path: "…", edits: [{ op: "prepend", lines: […] }] }` — insert at beginning of file (no tag)
+- `{ path: "…", edits: [{ op: "append", pos: "N#ID", lines: […] }] }` — insert after tagged line
+- `{ path: "…", edits: [{ op: "append", lines: […] }] }` — insert at end of file (no tag)
 
 ### File-level controls
-- `{ file: "…", delete: true, edits: [] }` — delete the file
-- `{ file: "…", move: "new/path.ts", edits: […] }` — move file to new path (edits applied first)
+- `{ path: "…", delete: true, edits: [] }` — delete the file
+- `{ path: "…", move: "new/path.ts", edits: […] }` — move file to new path (edits applied first)
 **Atomicity:** all ops in one call validate against the same pre-edit snapshot; tags reference the last `read`. Edits are applied bottom-up, so earlier tags stay valid even when later ops add or remove lines.
 </operations>
 
@@ -44,6 +44,7 @@ Every edit has `op`, `pos`, and `lines`. Range replaces also have `end`. Both `p
 2. **No no-ops:** replacement MUST differ from current.
 3. **Prefer insertion over neighbor rewrites:** You SHOULD anchor on structural boundaries (`}`, `]`, `},`), not interior lines.
 4. **For swaps/moves:** You SHOULD prefer one range op over multiple single-line ops.
+5. **Range end tag:** When replacing a block (e.g., an `if` body), the `end` tag MUST include the block's closing brace/bracket — not just the last interior line. Verify the `end` tag covers all lines being logically removed, including trailing `}`, `]`, or `)`. An off-by-one on `end` orphans a brace and breaks syntax.
 </rules>
 
 <recovery>
@@ -57,7 +58,7 @@ Every edit has `op`, `pos`, and `lines`. Range replaces also have `end`. Both `p
 ```
 ```
 {
-  file: "…",
+  path: "…",
   edits: [{
     op: "replace",
     pos: "{{hlineref 23 "  const timeout: number = 5000;"}}",
@@ -71,7 +72,7 @@ Every edit has `op`, `pos`, and `lines`. Range replaces also have `end`. Both `p
 Single line — `lines: null` deletes entirely:
 ```
 {
-  file: "…",
+  path: "…",
   edits: [{
     op: "replace",
     pos: "{{hlineref 7 "// @ts-ignore"}}",
@@ -82,7 +83,7 @@ Single line — `lines: null` deletes entirely:
 Range — add `end`:
 ```
 {
-  file: "…",
+  path: "…",
   edits: [{
     op: "replace",
     pos: "{{hlineref 80 "  // TODO: remove after migration"}}",
@@ -99,7 +100,7 @@ Range — add `end`:
 ```
 ```
 {
-  file: "…",
+  path: "…",
   edits: [{
     op: "replace",
     pos: "{{hlineref 14 "  placeholder: \"DO NOT SHIP\","}}",
@@ -118,7 +119,7 @@ Range — add `end`:
 ```
 ```
 {
-  file: "…",
+  path: "…",
   edits: [{
     op: "replace",
     pos: "{{hlineref 60 "    } catch (err) {"}}",
@@ -141,7 +142,7 @@ Range — add `end`:
 ```
 ```
 {
-  file: "…",
+  path: "…",
   edits: [{
     op: "prepend",
     pos: "{{hlineref 45 "  \"test\": \"bun test\""}}",
@@ -168,7 +169,7 @@ Bad — append after "}"
 Good — anchors to structural line:
 ```
 {
-  file: "…",
+  path: "…",
   edits: [{
     op: "prepend",
     pos: "{{hlineref 103 "export function serialize(data: unknown): string {"}}",
@@ -184,7 +185,7 @@ Good — anchors to structural line:
 </example>
 
 <critical>
-- Edit payload: `{ file, edits[] }`. Each entry: `op`, `lines`, optional `pos`/`end`. No extra keys.
+- Edit payload: `{ path, edits[] }`. Each entry: `op`, `lines`, optional `pos`/`end`. No extra keys.
 - Every tag MUST be copied exactly from fresh tool result as `N#ID`.
 - You MUST re-read after each edit call before issuing another on same file.
 </critical>

package/src/prompts/tools/lsp.md

@@ -3,25 +3,15 @@
 Interact with Language Server Protocol servers for code intelligence.
 
 <operations>
-- `definition`: Go to symbol definition
-- `references`: Find all references to symbol
-- `hover`: Get type info and documentation
-- `symbols`: List symbols in file, or search workspace (with query, no file)
-- `rename`: Rename symbol across codebase
-- `diagnostics`: Get errors/warnings for file, or check entire project (no file)
+- `definition`: Go to symbol definition → file path + position
+- `references`: Find all references → list of locations (file + position)
+- `hover`: Get type info and documentation → type signature + docs
+- `symbols`: List symbols in file, or search workspace (with query, no file) → names, kinds, locations
+- `rename`: Rename symbol across codebase → confirmation of changes
+- `diagnostics`: Get errors/warnings for file, or check entire project (no file) → list with severity + message
 - `reload`: Restart the language server
 </operations>
 
-<output>
-- `definition`: File path and position of definition
-- `references`: List of locations (file + position) where symbol used
-- `hover`: Type signature and documentation text
-- `symbols`: List of symbol names, kinds, locations
-- `rename`: Confirmation of changes made across files
-- `diagnostics`: List of errors/warnings with file, line, severity, message
-- `reload`: Confirmation of server restart
-</output>
-
 <caution>
 - Requires running LSP server for target language
 - Some operations require file to be saved to disk

package/src/prompts/tools/read.md

@@ -1,6 +1,6 @@
 # Read
 
-Reads files from local filesystem or harness URLs.
+Reads files from local filesystem or internal URLs.
 
 <instruction>
 - Reads up to {{DEFAULT_MAX_LINES}} lines default
@@ -14,13 +14,10 @@ Reads files from local filesystem or harness URLs.
 {{/if}}
 - Supports images (PNG, JPG) and PDFs
 - For directories, returns formatted listing with modification times
-- You SHOULD parallelize reads when exploring related files
+- Parallelize reads when exploring related files
 </instruction>
 
 <output>
-- Returns file content as text
-- Images: returns visual content for analysis
-- PDFs: returns extracted text
+- Returns file content as text; images return visual content; PDFs return extracted text
 - Missing files: returns closest filename matches for correction
-- Internal URLs: returns resolved content with pagination support
 </output>