@johnnywu/pi-subagents 1.0.1 → 1.1.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [1.1.0](https://github.com/jwu/pi-subagents/compare/v1.0.1...v1.1.0) (2026-05-31)
+
+
+### Features
+
+* **subagent:** list available agents in system prompt Guidelines ([317ed58](https://github.com/jwu/pi-subagents/commit/317ed5845379d3edd535bc03dab8460b29a82164))
+
 ## [1.0.1](https://github.com/jwu/pi-subagents/compare/v1.0.0...v1.0.1) (2026-05-31)
 
 

package/extensions/env-utils.ts

@@ -0,0 +1,26 @@
+export type RecursionEnv = Partial<
+  Record<'PI_SUBAGENT_ALLOWED' | 'PI_SUBAGENT_DEPTH' | 'PI_SUBAGENT_MAX_DEPTH', string>
+>;
+
+export function parseEnvNumber(value: string | undefined): number | undefined {
+  if (value === undefined) return undefined;
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : undefined;
+}
+
+export function allowedAgentNames(env: RecursionEnv): Set<string> | undefined {
+  const raw = env?.PI_SUBAGENT_ALLOWED;
+  if (!raw) return undefined;
+  return new Set(
+    raw
+      .split(',')
+      .map((name) => name.trim())
+      .filter(Boolean),
+  );
+}
+
+export function isPastMaxDepth(env: RecursionEnv): boolean {
+  const depth = parseEnvNumber(env?.PI_SUBAGENT_DEPTH);
+  const maxDepth = parseEnvNumber(env?.PI_SUBAGENT_MAX_DEPTH);
+  return depth !== undefined && maxDepth !== undefined && depth > maxDepth;
+}

package/extensions/subagent-tool.ts

@@ -17,6 +17,7 @@ import {
   type SubagentResultLine,
 } from './subagent-render.ts';
 import { numberArg, preview, shortenPath, stringArg } from './tool-args.ts';
+import { allowedAgentNames, isPastMaxDepth, type RecursionEnv } from './env-utils.ts';
 
 const SubagentParams = {
   type: 'object',
@@ -36,10 +37,6 @@ type SubagentParamsType = {
 };
 
 type RegisterablePi = Pick<ExtensionAPI, 'registerTool'>;
-type RecursionEnv = Partial<
-  Record<'PI_SUBAGENT_ALLOWED' | 'PI_SUBAGENT_DEPTH' | 'PI_SUBAGENT_MAX_DEPTH', string>
->;
-
 export interface RegisterSubagentToolOptions {
   agents: AgentConfig[];
   run?: typeof runSubagent;
@@ -70,29 +67,6 @@ function toProgressResult(progress: AgentProgress) {
   };
 }
 
-function parseEnvNumber(value: string | undefined): number | undefined {
-  if (value === undefined) return undefined;
-  const parsed = Number(value);
-  return Number.isFinite(parsed) ? parsed : undefined;
-}
-
-function allowedAgentNames(env: RecursionEnv): Set<string> | undefined {
-  const raw = env?.PI_SUBAGENT_ALLOWED;
-  if (!raw) return undefined;
-  return new Set(
-    raw
-      .split(',')
-      .map((name) => name.trim())
-      .filter(Boolean),
-  );
-}
-
-function isPastMaxDepth(env: RecursionEnv): boolean {
-  const depth = parseEnvNumber(env?.PI_SUBAGENT_DEPTH);
-  const maxDepth = parseEnvNumber(env?.PI_SUBAGENT_MAX_DEPTH);
-  return depth !== undefined && maxDepth !== undefined && depth > maxDepth;
-}
-
 type CollapsedTheme = {
   fg: (name: ThemeColor, text: string) => string;
   bold: (text: string) => string;
@@ -243,11 +217,19 @@ export function registerSubagentTool(
     : options.agents;
   const runner = options.run ?? runSubagent;
 
+  const agentNames = agents
+    .map((a) => a.name)
+    .sort()
+    .join(', ');
+  const promptGuidelines =
+    agentNames.length > 0 ? [`Available subagents: ${agentNames}`] : undefined;
+
   pi.registerTool({
     name: 'subagent',
     label: 'Subagent',
     description: 'Delegate a task to a named sub-agent running in an isolated pi process.',
     promptSnippet: 'Delegate isolated tasks with subagent({ agent, task, cwd? }).',
+    promptGuidelines,
     parameters: SubagentParams,
 
     async execute(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@johnnywu/pi-subagents",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Sub-agents extension for pi coding agent.",
   "homepage": "https://github.com/jwu/pi-subagents#readme",
   "repository": {