@giladbarnea/pi-user-agents 0.0.10 → 0.0.12

package/INTERNALS.md

@@ -113,7 +113,7 @@ Type `/agent -` and the option menu opens immediately — no Tab is required. Sh
 
 The finite value menus are thinking levels, live providers, live models, and the session's live tool catalog. Models from the configured `enabledModels` scope lead the unfiltered model menu; once you type a query, Pi's fuzzy relevance controls the order and scope only breaks equal-score ties. `--provider` narrows the model menu for either `-m` or `--model`. A completed boolean, thinking level, provider, or model leaves exactly one trailing space.
 
-`--tools`/`-t` and `--exclude-tools`/`-xt` complete one comma-delimited segment at a time. Accepting `grep` produces `--tools grep│` — the menu closes without inserting a space or comma. Type `,` to open the next segment immediately; already selected tools are omitted. Type a normal space when the tool list is finished.
+`--tools`/`-t` and `--exclude-tools`/`-xt` complete one comma-delimited segment at a time. Accepting `grep` produces `--tools grep│` — the menu closes without inserting a space or comma. Type `,` to open the next segment immediately; already selected tools are omitted. Type a normal space when the tool list is finished. In `--tools`, a `+name`/`-name` entry keeps its sign: `+gr` completes to `+grep`.
 
 Free-form values are guarded instead of guessed. Selecting `--system-prompt` produces `/agent --system-prompt "│" `, with the cursor between the quotes and the trailing separator already preserved.
 

package/PARSER_SPEC.md

@@ -205,7 +205,8 @@ The finite value domains implemented today are:
 - tool names from the live public `pi.getAllTools()` catalog for `--tools`/`-t` and
   `--exclude-tools`/`-xt`.
 
-Tool completion is local to the active comma-delimited segment. Accepting a tool replaces only
+Tool completion is local to the active comma-delimited segment. In `--tools`, a leading `+` or
+`-` stays in place and completion replaces only the name after it. Accepting a tool replaces only
 that segment and closes the menu without adding a space or comma. Typing `,` immediately opens
 the next segment and excludes every tool already selected elsewhere in the value. The user
 types a normal space to finish the complete tool list. Other non-path value options remain
@@ -247,8 +248,9 @@ source spans:
 - `value` — the value consumed by a leading value-taking option. A quoted value's span
   includes its surrounding quotes;
 - `invalid-value` — a leading closed-set value rejected by the same validation used at
-  submission and session creation: Pi's argument parser for thinking levels, exact live model
-  IDs or user-defined aliases, and the live provider and tool catalogs;
+  submission and session creation: Pi's argument parser for thinking levels and tool-list
+  syntax (`+name`/`-name` entries cannot mix with plain names), exact live model IDs or
+  user-defined aliases, and the live provider and tool catalogs;
 - `blocked` — a blocked option in args mode, plus the value a blocked value-taking option
   would consume (`--theme ./theme.json` yields two `blocked` tokens). Unlike
   `parseAgentCommand`, the scan never throws: it records the first blocked token and keeps

package/README.md

@@ -61,9 +61,7 @@ The first preserves the session's knowledge before the context window fills, wit
 
 Every agent gets a row in a widget under the editor: status, task, model, turn count, tool uses, elapsed time, a one-cell context meter, and the last line of live activity.
 
-<a href="screenshots/below-editor-widget.png">
-  <img src="screenshots/below-editor-widget.png" width="100%" alt="The user agents widget under the editor, showing one finished agent and its latest output">
-</a>
+[![The user agents widget under the editor, showing one finished agent and its latest output](https://raw.githubusercontent.com/giladbarnea/pi-user-agents/main/screenshots/below-editor-widget.png)](https://raw.githubusercontent.com/giladbarnea/pi-user-agents/main/screenshots/below-editor-widget.png)
 
 <div align="center"><em>The widget sits under the editor and stays out of your way.</em></div>
 
@@ -71,9 +69,7 @@ Every agent gets a row in a widget under the editor: status, task, model, turn c
 
 Press `←` or `↓` from the editor to focus the widget. The selected row shows a short session ID and offers the same agent actions as the overlay. Press `Enter` to open the full conversation, streaming live and following the tail as it grows. Tool calls render as proper views — `read`, `edit`, `write`, `grep`, `find`, `ls`, and `bash` each get a dedicated format, everything else a readable generic one.
 
-<a href="screenshots/overlay.png">
-  <img src="screenshots/overlay.png" width="100%" alt="The agent overlay: a rendered bash call, its output, a todo update, and the final response, over the dimmed main conversation">
-</a>
+[![The agent overlay: a rendered bash call, its output, a todo update, and the final response, over the dimmed main conversation](https://raw.githubusercontent.com/giladbarnea/pi-user-agents/main/screenshots/overlay.png)](https://raw.githubusercontent.com/giladbarnea/pi-user-agents/main/screenshots/overlay.png)
 
 <div align="center"><em>The overlay, over a main conversation that never paused.</em></div>
 

package/autocomplete.ts

@@ -322,13 +322,20 @@ function getToolSegment(
 ): ToolSegment {
 	const value = line.slice(expectation.replacementStart, expectation.replacementEnd);
 	const cursorOffset = cursorCol - expectation.replacementStart;
-	const segmentStart = value.lastIndexOf(",", cursorOffset - 1) + 1;
+	const commaEnd = value.lastIndexOf(",", cursorOffset - 1) + 1;
+	// Pi's --tools takes +name/-name entries; completion replaces only the name after the sign.
+	const signLength =
+		expectation.option.semanticId === "tools" && /^[+-]/.test(value.slice(commaEnd, cursorOffset))
+			? 1
+			: 0;
+	const segmentStart = commaEnd + signLength;
 	const nextComma = value.indexOf(",", cursorOffset);
 	const segmentEnd = nextComma === -1 ? value.length : nextComma;
 	const selectedNames = new Set(
 		value
 			.split(",")
-			.filter((_name, index) => index !== value.slice(0, segmentStart).split(",").length - 1),
+			.filter((_name, index) => index !== value.slice(0, commaEnd).split(",").length - 1)
+			.map((name) => name.replace(/^[+-]/, "")),
 	);
 	return {
 		fragment: value.slice(segmentStart, cursorOffset),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@giladbarnea/pi-user-agents",
-  "version": "0.0.10",
+  "version": "0.0.12",
   "description": "Run, view, and control background Pi agents.",
   "keywords": [
     "pi-package",

package/runner.ts

@@ -422,7 +422,12 @@ export function createAgentValueValidator(
 		}
 		if (option.completionDomain === "tool") {
 			const parsed = parseArgs([option.names[0]!, value]);
-			const requestedNames = option.semanticId === "tools" ? parsed.tools : parsed.excludeTools;
+			if (parsed.diagnostics.some((diagnostic) => diagnostic.type === "error")) return false;
+			// A --tools list of +name/-name entries names its tools after the sign.
+			const requestedNames =
+				option.semanticId === "tools"
+					? parsed.tools?.map((entry) => entry.replace(/^[+-]/, ""))
+					: parsed.excludeTools;
 			const knownNames = new Set(getToolNames());
 			return (requestedNames ?? []).every((name) => knownNames.has(name));
 		}

package/tool-render/FORK.md

@@ -1,6 +1,6 @@
 ---
 description: Provenance and boundary for the overlay's vendored historical tool renderer
-last_updated: 2026-07-31
+last_updated: 2026-11-01T23-46
 ---
 # The overlay renders tool history itself
 
@@ -14,7 +14,7 @@ longer be registered.
 
 ## Sources
 
-- `../rich-tool-diff/` — `read`, `edit`, `write`, `grep`, `find`, `ls`.
+- [V-Stack, now Kendex](https://github.com/vanillagreencom/kendex/tree/main/pi-extensions/pi-tool-renderer/extensions/tool-renderer) — `read`, `edit`, `write`, `grep`, `find`, `ls`, originally copied through the former local curated extension. The local fork has been removed; this link identifies the upstream source, not a runtime dependency.
 - `/Users/giladbarnea/.pi/agent/extensions/bash-rich-highlight/index.ts` — `bash`.
 
 Both are **disabled** in committed `agent/settings.json`, while `pi-user-agents` is enabled.