@shanepadgett/tau-agent 0.10.0 → 0.11.1

package/docs/subagents.md

@@ -52,6 +52,7 @@ Named tools and configured models must exist in the normally loaded child Pi env
 
 ## Built-ins
 
+- `generalist` — focused analysis, review, implementation, or mixed work when no narrower agent fits
 - `scout` — local exploration with `read`, `grep`, `find`, `ls`
 - `web-research` — `websearch`, `codesearch`, `webfetch`
 

package/extensions/explore/read.ts

@@ -271,7 +271,7 @@ export function createExploreReadTool(
 		) {
 			rowState.watch(context.toolCallId, context.invalidate);
 			const text = (context.lastComponent as Text | undefined) ?? new Text("", 0, 0);
-			if (context.executionStarted) {
+			if (context.executionStarted || !context.isPartial) {
 				text.setText("");
 				return text;
 			}

package/extensions/subagent/README.md

@@ -6,6 +6,7 @@ Agent definitions can override the parent model and thinking level. If an overri
 
 Tau includes three built-in agents:
 
+- `generalist` handles focused analysis, review, implementation, or mixed work when no narrower agent fits. Delegated tasks should state their scope and desired depth.
 - `scout` explores local files and code with `read`, `grep`, `find`, and `ls`.
 - `web-research` researches web and code sources with `websearch`, `codesearch`, and `webfetch`.
 

package/extensions/subagent/agents/generalist.md

@@ -0,0 +1,27 @@
+---
+name: generalist
+description: Handle focused analysis, review, implementation, or mixed tasks when no narrower agent fits; specify scope and depth
+tools:
+   - read
+   - patch
+   - grep
+   - find
+   - ls
+model: openai-codex/gpt-5.6-sol
+thinking: high
+---
+
+Delegated task is the contract. Complete it exactly. Do not expand scope, add features, or answer adjacent questions.
+
+Match effort to requested depth and consequences:
+
+- Quick opinion, lookup, or small review: inspect named inputs and minimum evidence needed for a reliable answer.
+- Normal work: inspect direct dependencies, callers, data flow, and relevant checks.
+- Deep, feature-wide, or maximum effort: investigate systematically, verify material assumptions, test important branches, and report unresolved risks.
+- Unclear depth: use the smallest scope that can produce a reliable result. Spend more effort when mistakes could damage data, access, money, or correctness.
+
+Start from paths, symbols, and constraints named in the task. Follow related code or documentation only when evidence requires it. Resolve minor ambiguity from available context. State blocking unknowns instead of inventing facts.
+
+Change files or run mutating commands only when the task explicitly requests implementation or mutation. Reviews, analysis, and opinions are read-only. For requested changes, inspect before editing and run relevant targeted checks.
+
+Return only the requested result. Follow any requested format. Include exact paths, evidence, checks, and unknowns when they support the result. Keep small answers small. Give deep tasks enough detail to justify conclusions.

package/extensions/subagent/index.ts

@@ -178,6 +178,7 @@ export default function subagentExtension(pi: ExtensionAPI): void {
 			renderCall(args, theme, context) {
 				return renderSubagentCall(args, theme, {
 					executionStarted: context.executionStarted,
+					isPartial: context.isPartial,
 					lastComponent: context.lastComponent,
 					rowState,
 					rowId: context.toolCallId,

package/extensions/subagent/render.ts

@@ -1,29 +1,11 @@
 import type { Theme } from "@earendil-works/pi-coding-agent";
-import { Text, truncateToWidth, type Component } from "@earendil-works/pi-tui";
+import { Text, type Component } from "@earendil-works/pi-tui";
 import { formatToolRowTitle, type ToolRowStateStore } from "../../shared/tool-row-state.js";
 import type { SubagentDetails } from "./run.ts";
 
 const cap = (text: string | undefined, length = 240) =>
 	!text ? "" : text.length <= length ? text : `${text.slice(0, length - 1)}…`;
-class SubagentText implements Component {
-	private readonly text = new Text("", 0, 0);
-	private value = "";
-	private truncate = false;
-	setText(value: string, truncate = false): void {
-		this.value = value;
-		this.text.setText(value);
-		this.truncate = truncate;
-	}
-	render(width: number): string[] {
-		return this.truncate
-			? this.value.split("\n").map((line) => truncateToWidth(line, width))
-			: this.text.render(width);
-	}
-	invalidate(): void {
-		this.text.invalidate();
-	}
-}
-const component = (last: unknown) => (last as SubagentText | undefined) ?? new SubagentText();
+const component = (last: unknown) => (last as Text | undefined) ?? new Text("", 0, 0);
 const title = (theme: Theme, rowState: ToolRowStateStore, rowId: string, invalidate: () => void) => {
 	rowState.watch(rowId, invalidate);
 	return formatToolRowTitle(rowState, rowId, "subagent", theme);
@@ -34,6 +16,7 @@ export function renderSubagentCall(
 	theme: Theme,
 	context: {
 		executionStarted: boolean;
+		isPartial: boolean;
 		lastComponent?: unknown;
 		rowState: ToolRowStateStore;
 		rowId: string;
@@ -41,14 +24,14 @@ export function renderSubagentCall(
 	},
 ): Component {
 	const text = component(context.lastComponent);
-	if (context.executionStarted) {
+	if (context.executionStarted || !context.isPartial) {
 		text.setText("");
 		return text;
 	}
-	text.setText(
-		`${title(theme, context.rowState, context.rowId, context.invalidate)}  ${theme.fg("accent", args.agent ?? "")} ${theme.fg("muted", args.task ?? "")}`.trimEnd(),
-		true,
-	);
+	const prefix =
+		`${title(theme, context.rowState, context.rowId, context.invalidate)}  ${theme.fg("accent", args.agent ?? "")}`.trimEnd();
+	const task = args.task?.replace(/\s+/g, " ").trim();
+	text.setText(task ? `${prefix}  ${theme.fg("muted", task)}` : prefix);
 	return text;
 }
 
@@ -66,7 +49,7 @@ export function renderSubagentResult(
 	}
 	const header = `${title(theme, context.rowState, context.rowId, context.invalidate)}  ${theme.fg("accent", details.agent)}  ${theme.fg("muted", `$${details.usage.cost.toFixed(4)} · ${(details.durationMs / 1000).toFixed(1)}s · ${details.toolCalls} tools`)}`;
 	if (!expanded) {
-		text.setText(`${header}\n${theme.fg("muted", details.task)}`, true);
+		text.setText(`${header}  ${theme.fg("muted", details.task.replace(/\s+/g, " ").trim())}`);
 		return text;
 	}
 	const lines = [header, theme.fg("muted", `Task: ${cap(details.task, 1000)}`)];

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@shanepadgett/tau-agent",
-	"version": "0.10.0",
+	"version": "0.11.1",
 	"description": "Tau is a custom agentic harness built with pi extensions",
 	"type": "module",
 	"license": "MIT",
@@ -28,7 +28,7 @@
 		"README.md"
 	],
 	"dependencies": {
-		"@shanepadgett/tau-tui": "0.10.0",
+		"@shanepadgett/tau-tui": "0.11.1",
 		"@toon-format/toon": "2.3.0",
 		"smol-toml": "1.7.0"
 	},