@pi-unipi/subagents 2.4.0 → 2.5.0

package/src/model-resolver.ts

@@ -1,79 +0,0 @@
-/**
- * @pi-unipi/subagents — Model resolver
- *
- * Resolves model strings like "haiku", "sonnet", "anthropic/claude-sonnet-4-6"
- * to actual Model instances using the registry.
- */
-
-import type { Model } from "@earendil-works/pi-ai";
-
-export interface ModelRegistry {
-  find(provider: string, modelId: string): Model<any> | undefined;
-  getAll(): Model<any>[];
-  getAvailable?(): Model<any>[];
-}
-
-/**
- * Resolve a model string to a Model instance.
- * Tries exact match first, then fuzzy match.
- * Returns Model on success, error string on failure.
- */
-export function resolveModel(
-  input: string,
-  registry: ModelRegistry,
-): Model<any> | string {
-  const all = (registry.getAvailable?.() ?? registry.getAll()) as Array<{
-    id: string;
-    name?: string;
-    provider: string;
-  }>;
-  const availableSet = new Set(all.map((m) => `${m.provider}/${m.id}`.toLowerCase()));
-
-  // 1. Exact match: "provider/modelId"
-  const slashIdx = input.indexOf("/");
-  if (slashIdx !== -1) {
-    const provider = input.slice(0, slashIdx);
-    const modelId = input.slice(slashIdx + 1);
-    if (availableSet.has(input.toLowerCase())) {
-      const found = registry.find(provider, modelId);
-      if (found) return found;
-    }
-  }
-
-  // 2. Fuzzy match
-  const query = input.toLowerCase();
-  let bestMatch: (typeof all)[number] | undefined;
-  let bestScore = 0;
-
-  for (const m of all) {
-    const id = m.id.toLowerCase();
-    const name = (m.name ?? m.id).toLowerCase();
-    const full = `${m.provider}/${m.id}`.toLowerCase();
-
-    let score = 0;
-    if (id === query || full === query) {
-      score = 100;
-    } else if (id.includes(query) || full.includes(query)) {
-      score = 60 + (query.length / id.length) * 30;
-    } else if (name.includes(query)) {
-      score = 40 + (query.length / name.length) * 20;
-    }
-
-    if (score > bestScore) {
-      bestScore = score;
-      bestMatch = m;
-    }
-  }
-
-  if (bestMatch && bestScore >= 20) {
-    const found = registry.find(bestMatch.provider, bestMatch.id);
-    if (found) return found;
-  }
-
-  // 3. No match — return error with available models
-  const modelList = all
-    .map((m) => `  ${m.provider}/${m.id}`)
-    .sort()
-    .join("\n");
-  return `Model not found: "${input}".\n\nAvailable models:\n${modelList}`;
-}

package/src/prompts.ts

@@ -1,39 +0,0 @@
-/**
- * @pi-unipi/subagents — System prompt builder
- */
-
-import type { AgentConfig } from "./types.js";
-
-/**
- * Build system prompt for an agent.
- */
-export function buildAgentPrompt(
-  config: AgentConfig,
-  cwd: string,
-  env: { isGitRepo: boolean; branch: string; platform: string },
-  parentSystemPrompt: string,
-): string {
-  if (config.promptMode === "append") {
-    // Append mode: parent prompt + agent additions
-    return [
-      parentSystemPrompt,
-      "",
-      "---",
-      "",
-      `## Agent Role: ${config.displayName ?? config.name}`,
-      config.systemPrompt,
-    ].join("\n");
-  }
-
-  // Replace mode: standalone prompt
-  return [
-    `# ${config.displayName ?? config.name}`,
-    "",
-    config.systemPrompt,
-    "",
-    "---",
-    "",
-    `Working directory: ${cwd}`,
-    `Git: ${env.isGitRepo ? `${env.branch} on ${env.platform}` : "not a git repo"}`,
-  ].join("\n");
-}

package/src/skills/explore/SKILL.md

@@ -1,32 +0,0 @@
----
-name: explore
-description: "Fast parallel codebase exploration"
----
-
-# Explore Helper
-
-Read-only agent for fast parallel codebase exploration.
-
-## Capabilities
-
-- Read files
-- Search with grep, find, ls
-- Run bash commands (read-only)
-
-## Constraints
-
-- Cannot write or edit files
-- Cannot modify the codebase
-- Report findings only
-
-## Usage
-
-Spawn multiple explore agents to read different parts of the codebase in parallel.
-
-```
-spawn_helper({
-  type: "explore",
-  prompt: "Find all files related to authentication",
-  description: "Find auth files"
-})
-```

package/src/skills/work/SKILL.md

@@ -1,40 +0,0 @@
----
-name: work
-description: "Parallel file writes with transparent locking"
----
-
-# Work Helper
-
-Read-write agent for parallel file modifications.
-
-## Capabilities
-
-- Read files
-- Write and edit files
-- Run bash commands
-- Search with grep, find, ls
-
-## File Locking
-
-When writing a file, the lock is acquired automatically. If another agent holds the lock, your write waits transparently — you won't see errors.
-
-- Per-file granularity: locking `src/auth.ts` doesn't block `src/login.ts`
-- Locks release automatically when the write completes
-- On abort, all locks are released
-
-## Constraints
-
-- Cannot spawn sub-agents (prevents nesting)
-- Cannot modify other agents' locked files (waits instead)
-
-## Usage
-
-Spawn work agents to modify different files in parallel.
-
-```
-spawn_helper({
-  type: "work",
-  prompt: "Refactor src/auth.ts to use async/await",
-  description: "Refactor auth module"
-})
-```

package/src/types.ts

@@ -1,146 +0,0 @@
-/**
- * @pi-unipi/subagents — Type definitions
- */
-
-import type { ThinkingLevel } from "@earendil-works/pi-agent-core";
-import type { AgentSession } from "@earendil-works/pi-coding-agent";
-
-export type { ThinkingLevel };
-
-/** Agent type name: built-in or user-defined. */
-export type AgentType = string;
-
-/** Built-in agent type names. */
-export const BUILTIN_TYPES = ["explore", "work"] as const;
-
-/** Read-only tool names for explore agents. */
-const READ_ONLY_TOOLS = ["read", "bash", "grep", "find", "ls"];
-
-/** All write-capable tool names. */
-const ALL_TOOLS = ["read", "bash", "edit", "write", "grep", "find", "ls"];
-
-/** Built-in agent configurations. */
-export const BUILTIN_CONFIGS: Record<string, AgentConfig> = {
-  explore: {
-    name: "explore",
-    displayName: "Explore",
-    description: "Read-only exploration agent for parallel file reads and searches.",
-    builtinToolNames: READ_ONLY_TOOLS,
-    disallowedTools: ["edit", "write"],
-    extensions: false,
-    skills: false,
-    systemPrompt: "You are an explore agent. Read files, search code, and report findings. Do NOT modify any files.",
-    promptMode: "append",
-    source: "builtin",
-  },
-  work: {
-    name: "work",
-    displayName: "Worker",
-    description: "Write-capable worker agent with transparent file locking.",
-    builtinToolNames: ALL_TOOLS,
-    extensions: false,
-    skills: false,
-    systemPrompt: "You are a worker agent. Implement changes, write code, and complete tasks. Use the provided tools to make the requested modifications.",
-    promptMode: "append",
-    source: "builtin",
-  },
-  "name-gen": {
-    name: "name-gen",
-    displayName: "Name Generator",
-    description: "Minimal agent for generating session names from conversation context.",
-    builtinToolNames: [],
-    extensions: false,
-    skills: false,
-    systemPrompt: "You are a session name generator. Generate concise titles from conversation context. Reply with ONLY the title.",
-    promptMode: "replace",
-    source: "builtin",
-  },
-} as const;
-
-/** Memory scope for persistent agent memory. */
-export type MemoryScope = "user" | "project" | "local";
-
-/** Unified agent configuration. */
-export interface AgentConfig {
-  name: string;
-  displayName?: string;
-  description: string;
-  builtinToolNames?: string[];
-  disallowedTools?: string[];
-  extensions: true | string[] | false;
-  skills: true | string[] | false;
-  model?: string;
-  thinking?: ThinkingLevel;
-  maxTurns?: number;
-  systemPrompt: string;
-  promptMode: "replace" | "append";
-  inheritContext?: boolean;
-  runInBackground?: boolean;
-  isolated?: boolean;
-  memory?: MemoryScope;
-  isDefault?: boolean;
-  enabled?: boolean;
-  source?: "builtin" | "project" | "global";
-}
-
-/** Agent record — tracks a running agent. */
-export interface AgentRecord {
-  id: string;
-  type: AgentType;
-  description: string;
-  status: "queued" | "running" | "completed" | "aborted" | "stopped" | "error";
-  result?: string;
-  error?: string;
-  toolUses: number;
-  startedAt: number;
-  completedAt?: number;
-  session?: AgentSession;
-  abortController?: AbortController;
-  promise?: Promise<string>;
-  /** Set when result consumed via get_result — suppresses notification. */
-  resultConsumed?: boolean;
-  /** Files locked by this agent. */
-  lockedFiles: Set<string>;
-}
-
-/** File lock entry. */
-export interface FileLockEntry {
-  agentId: string;
-  filePath: string;
-  promise: Promise<void>;
-  release: () => void;
-}
-
-/** Extension config. */
-export interface SubagentsConfig {
-  maxConcurrent: number;
-  enabled: boolean;
-  types: Record<string, { enabled?: boolean }>;
-}
-
-/** Agent activity for widget display. */
-export interface AgentActivity {
-  activeTools: Map<string, string>;
-  toolUses: number;
-  turnCount: number;
-  maxTurns?: number;
-  tokens: string;
-  responseText: string;
-  session?: AgentSession;
-}
-
-/** Details attached to custom notification messages for visual rendering. */
-export interface NotificationDetails {
-  id: string;
-  description: string;
-  status: string;
-  toolUses: number;
-  turnCount: number;
-  maxTurns?: number;
-  totalTokens: number;
-  durationMs: number;
-  error?: string;
-  resultPreview: string;
-  /** Additional agents in a group notification. */
-  others?: NotificationDetails[];
-}