@bacnh85/pi-subagent 0.2.0 → 0.3.1

package/agents/general-purpose.md

@@ -0,0 +1,13 @@
+---
+name: general-purpose
+description: General-purpose sub-agent for any delegated task. Use when no specialized agent fits. Good for complex research, multi-step operations, and code modifications.
+tools: read, bash, edit, write, grep, find, ls
+---
+
+You are a capable coding assistant running as a sub-agent. Complete the delegated task efficiently and return a concise summary of your findings or changes.
+
+Guidelines:
+- Use available tools to investigate and act on the task.
+- If the task involves searching, use grep and find to locate relevant code.
+- If the task involves implementation, make focused changes following existing patterns.
+- Return a structured summary: what you found, what you changed, and any recommendations.

package/index.ts

@@ -164,6 +164,31 @@ export default function (pi: ExtensionAPI) {
 		if (event.reason === "reload") invalidateAgentCache();
 	});
 
+	// Proactively steer agents toward sub-agent delegation when users mention it
+	pi.on("before_agent_start", async (event) => {
+		const prompt = event.prompt.toLowerCase();
+		if (/\b(delegate to|use a subagent|run in parallel|spawn an agent|scout|review this|chain|worker agent)\b/.test(prompt)) {
+			return {
+				systemPrompt:
+					event.systemPrompt +
+					"\n\nThe subagent tool is available for delegating tasks to specialized agents with isolated context. Use /subagent to list available agents. Bundled: scout (fast recon), reviewer (code review), worker (implementation), general-purpose (fallback). Modes: single, parallel (max 8), chain.",
+			};
+		}
+	});
+
+	// Inject available agent list into system prompt on every session
+	pi.on("before_agent_start", async (event, ctx) => {
+		const discovery = discoverAgents(ctx.cwd, "both", bundledAgentsDir);
+		if (discovery.agents.length > 0) {
+			const names = discovery.agents.map(a => a.name).join(", ");
+			return {
+				systemPrompt:
+					event.systemPrompt +
+					`\n\nAvailable sub-agents: ${names}. Use /subagent for details.`,
+			};
+		}
+	});
+
 	// Resolve bundled agents directory relative to this extension file
 	const bundledAgentsDir = path.resolve(__dirname, "agents");
 
@@ -250,7 +275,13 @@ export default function (pi: ExtensionAPI) {
 			`To enable project-local agents in ${CONFIG_DIR_NAME}/agents, set agentScope: "both" or "project".`,
 		].join(" "),
 		parameters: SubagentParams,
-
+		promptSnippet: "Delegate tasks to specialized sub-agents (scout, reviewer, worker, general-purpose)",
+		promptGuidelines: [
+			"Use subagent to delegate work that would flood the main context with search results or file contents.",
+			"Modes: single {agent, task}, parallel {tasks: [...]} (max 8, 4 concurrent), chain {chain: [...]} (sequential with {previous}).",
+			"Bundled agents: scout (fast recon), reviewer (code review), worker (implementation), general-purpose (fallback).",
+			"Use /subagent to list all available agents or /subagent <name> for agent details.",
+		],
 		async execute(_toolCallId, params, signal, onUpdate, ctx) {
 			const agentScope: AgentScope = params.agentScope ?? "user";
 			const discovery = discoverAgents(ctx.cwd, agentScope, bundledAgentsDir);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bacnh85/pi-subagent",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Minimal-overhead sub-agent extension for pi. Delegate tasks to specialized agents with isolated context using the pi SDK in-process.",
   "type": "module",
   "license": "MIT",

package/runner.ts

@@ -66,6 +66,7 @@ export async function runSubAgent(options: {
 	modelRegistry: ModelRegistry;
 	signal?: AbortSignal;
 	agentName?: string;
+	onUpdate?: (text: string) => void;
 }): Promise<SubAgentResult> {
 	const {
 		cwd,
@@ -77,6 +78,7 @@ export async function runSubAgent(options: {
 		modelRegistry,
 		signal,
 		agentName = "subagent",
+		onUpdate,
 	} = options;
 
 	const result: SubAgentResult = {
@@ -121,9 +123,9 @@ export async function runSubAgent(options: {
 			settingsManager,
 		});
 
+		let cleanupAbort: (() => void) | undefined;
 		try {
 			// Wire abort signal
-			let cleanupAbort: (() => void) | undefined;
 			if (signal) {
 				const onAbort = () => session.abort();
 				if (signal.aborted) {