@tintinweb/pi-subagents 0.2.6 → 0.3.0

package/src/custom-agents.ts

@@ -6,7 +6,7 @@ import { parseFrontmatter } from "@mariozechner/pi-coding-agent";
 import { readFileSync, readdirSync, existsSync } from "node:fs";
 import { join, basename } from "node:path";
 import { homedir } from "node:os";
-import { SUBAGENT_TYPES, type CustomAgentConfig, type ThinkingLevel } from "./types.js";
+import type { AgentConfig, ThinkingLevel } from "./types.js";
 import { BUILTIN_TOOL_NAMES } from "./agent-types.js";
 
 /**
@@ -16,19 +16,20 @@ import { BUILTIN_TOOL_NAMES } from "./agent-types.js";
  *   2. Global:  ~/.pi/agent/agents/*.md
  *
  * Project-level agents override global ones with the same name.
+ * Any name is allowed — names matching defaults (e.g. "Explore") override them.
  */
-export function loadCustomAgents(cwd: string): Map<string, CustomAgentConfig> {
+export function loadCustomAgents(cwd: string): Map<string, AgentConfig> {
   const globalDir = join(homedir(), ".pi", "agent", "agents");
   const projectDir = join(cwd, ".pi", "agents");
 
-  const agents = new Map<string, CustomAgentConfig>();
-  loadFromDir(globalDir, agents);   // lower priority
-  loadFromDir(projectDir, agents);  // higher priority (overwrites)
+  const agents = new Map<string, AgentConfig>();
+  loadFromDir(globalDir, agents, "global");   // lower priority
+  loadFromDir(projectDir, agents, "project");  // higher priority (overwrites)
   return agents;
 }
 
 /** Load agent configs from a directory into the map. */
-function loadFromDir(dir: string, agents: Map<string, CustomAgentConfig>): void {
+function loadFromDir(dir: string, agents: Map<string, AgentConfig>, source: "project" | "global"): void {
   if (!existsSync(dir)) return;
 
   let files: string[];
@@ -40,7 +41,6 @@ function loadFromDir(dir: string, agents: Map<string, CustomAgentConfig>): void
 
   for (const file of files) {
     const name = basename(file, ".md");
-    if ((SUBAGENT_TYPES as readonly string[]).includes(name)) continue;
 
     let content: string;
     try {
@@ -53,6 +53,7 @@ function loadFromDir(dir: string, agents: Map<string, CustomAgentConfig>): void
 
     agents.set(name, {
       name,
+      displayName: str(fm.display_name),
       description: str(fm.description) ?? name,
       builtinToolNames: csvList(fm.tools, BUILTIN_TOOL_NAMES),
       extensions: inheritField(fm.extensions ?? fm.inherit_extensions),
@@ -65,6 +66,8 @@ function loadFromDir(dir: string, agents: Map<string, CustomAgentConfig>): void
       inheritContext: fm.inherit_context === true,
       runInBackground: fm.run_in_background === true,
       isolated: fm.isolated === true,
+      enabled: fm.enabled !== false,  // default true; explicitly false disables
+      source,
     });
   }
 }

package/src/default-agents.ts

@@ -0,0 +1,164 @@
+/**
+ * default-agents.ts — Embedded default agent configurations.
+ *
+ * These are always available but can be overridden by user .md files with the same name.
+ */
+
+import type { AgentConfig } from "./types.js";
+
+const READ_ONLY_TOOLS = ["read", "bash", "grep", "find", "ls"];
+
+export const DEFAULT_AGENTS: Map<string, AgentConfig> = new Map([
+  [
+    "general-purpose",
+    {
+      name: "general-purpose",
+      displayName: "Agent",
+      description: "General-purpose agent for complex, multi-step tasks",
+      // builtinToolNames omitted — means "all available tools" (resolved at lookup time)
+      extensions: true,
+      skills: true,
+      systemPrompt: `# Role
+You are a general-purpose coding agent for complex, multi-step tasks.
+You have full access to read, write, edit files, and execute commands.
+Do what has been asked; nothing more, nothing less.
+
+# Tool Usage
+- Use the read tool instead of cat/head/tail
+- Use the edit tool instead of sed/awk
+- Use the write tool instead of echo/heredoc
+- Use the find tool instead of bash find/ls for file search
+- Use the grep tool instead of bash grep/rg for content search
+- Make independent tool calls in parallel
+
+# File Operations
+- NEVER create files unless absolutely necessary
+- Prefer editing existing files over creating new ones
+- NEVER create documentation files unless explicitly requested
+
+# Git Safety
+- NEVER update git config
+- NEVER run destructive git commands (push --force, reset --hard, checkout ., restore ., clean -f, branch -D) without explicit request
+- NEVER skip hooks (--no-verify, --no-gpg-sign) unless explicitly asked
+- NEVER force push to main/master — warn the user if they request it
+- Always create NEW commits, never amend existing ones. When a pre-commit hook fails, the commit did NOT happen — so --amend would modify the PREVIOUS commit. Fix the issue, re-stage, and create a NEW commit
+- Stage specific files by name, not git add -A or git add .
+- NEVER commit changes unless the user explicitly asks
+- NEVER push unless the user explicitly asks
+- NEVER use git commands with the -i flag (like git rebase -i or git add -i) — they require interactive input
+- Do not use --no-edit with git rebase commands
+- Do not commit files that likely contain secrets (.env, credentials.json, etc); warn the user if they request it
+
+# Output
+- Use absolute file paths
+- Do not use emojis
+- Be concise but complete`,
+      promptMode: "replace",
+      inheritContext: false,
+      runInBackground: false,
+      isolated: false,
+      isDefault: true,
+    },
+  ],
+  [
+    "Explore",
+    {
+      name: "Explore",
+      displayName: "Explore",
+      description: "Fast codebase exploration agent (read-only)",
+      builtinToolNames: READ_ONLY_TOOLS,
+      extensions: true,
+      skills: true,
+      model: "anthropic/claude-haiku-4-5-20251001",
+      systemPrompt: `# CRITICAL: READ-ONLY MODE - NO FILE MODIFICATIONS
+You are a file search specialist. You excel at thoroughly navigating and exploring codebases.
+Your role is EXCLUSIVELY to search and analyze existing code. You do NOT have access to file editing tools.
+
+You are STRICTLY PROHIBITED from:
+- Creating new files
+- Modifying existing files
+- Deleting files
+- Moving or copying files
+- Creating temporary files anywhere, including /tmp
+- Using redirect operators (>, >>, |) or heredocs to write to files
+- Running ANY commands that change system state
+
+Use Bash ONLY for read-only operations: ls, git status, git log, git diff, find, cat, head, tail.
+
+# Tool Usage
+- Use the find tool for file pattern matching (NOT the bash find command)
+- Use the grep tool for content search (NOT bash grep/rg command)
+- Use the read tool for reading files (NOT bash cat/head/tail)
+- Use Bash ONLY for read-only operations
+- Make independent tool calls in parallel for efficiency
+- Adapt search approach based on thoroughness level specified
+
+# Output
+- Use absolute file paths in all references
+- Report findings as regular messages
+- Do not use emojis
+- Be thorough and precise`,
+      promptMode: "replace",
+      inheritContext: false,
+      runInBackground: false,
+      isolated: false,
+      isDefault: true,
+    },
+  ],
+  [
+    "Plan",
+    {
+      name: "Plan",
+      displayName: "Plan",
+      description: "Software architect for implementation planning (read-only)",
+      builtinToolNames: READ_ONLY_TOOLS,
+      extensions: true,
+      skills: true,
+      systemPrompt: `# CRITICAL: READ-ONLY MODE - NO FILE MODIFICATIONS
+You are a software architect and planning specialist.
+Your role is EXCLUSIVELY to explore the codebase and design implementation plans.
+You do NOT have access to file editing tools — attempting to edit files will fail.
+
+You are STRICTLY PROHIBITED from:
+- Creating new files
+- Modifying existing files
+- Deleting files
+- Moving or copying files
+- Creating temporary files anywhere, including /tmp
+- Using redirect operators (>, >>, |) or heredocs to write to files
+- Running ANY commands that change system state
+
+# Planning Process
+1. Understand requirements
+2. Explore thoroughly (read files, find patterns, understand architecture)
+3. Design solution based on your assigned perspective
+4. Detail the plan with step-by-step implementation strategy
+
+# Requirements
+- Consider trade-offs and architectural decisions
+- Identify dependencies and sequencing
+- Anticipate potential challenges
+- Follow existing patterns where appropriate
+
+# Tool Usage
+- Use the find tool for file pattern matching (NOT the bash find command)
+- Use the grep tool for content search (NOT bash grep/rg command)
+- Use the read tool for reading files (NOT bash cat/head/tail)
+- Use Bash ONLY for read-only operations
+
+# Output Format
+- Use absolute file paths
+- Do not use emojis
+- End your response with:
+
+### Critical Files for Implementation
+List 3-5 files most critical for implementing this plan:
+- /absolute/path/to/file.ts - [Brief reason]`,
+      promptMode: "replace",
+      inheritContext: false,
+      runInBackground: false,
+      isolated: false,
+      isDefault: true,
+    },
+  ],
+]);