@pi-unipi/subagents 0.1.0

package/dist/config.js

@@ -0,0 +1,115 @@
+/**
+ * @pi-unipi/subagents — Config management
+ *
+ * Loads config from ~/.unipc/config/subagents.json (global)
+ * and <workspace>/.unipi/config/subagents.json (override).
+ * Auto-generates on first run. Repairs corrupted files.
+ */
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const DEFAULT_CONFIG = {
+    maxConcurrent: 4,
+    enabled: true,
+    types: {
+        explore: { enabled: true },
+        work: { enabled: true },
+    },
+};
+/** Get global config path: ~/.unipi/config/subagents.json */
+function getGlobalConfigPath() {
+    return join(homedir(), ".unipi", "config", "subagents.json");
+}
+/** Get workspace config path: <cwd>/.unipi/config/subagents.json */
+function getWorkspaceConfigPath(cwd) {
+    return join(cwd, ".unipi", "config", "subagents.json");
+}
+/** Ensure directory exists. */
+function ensureDir(filePath) {
+    const dir = filePath.substring(0, filePath.lastIndexOf("/"));
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+/** Write config atomically (write then rename). */
+function writeConfigAtomic(filePath, config) {
+    const tmpPath = filePath + ".tmp";
+    writeFileSync(tmpPath, JSON.stringify(config, null, 2), "utf-8");
+    renameSync(tmpPath, filePath);
+}
+/** Load and parse config from a path. Returns null on failure. */
+function loadConfigFromPath(filePath) {
+    if (!existsSync(filePath))
+        return null;
+    try {
+        const content = readFileSync(filePath, "utf-8");
+        const parsed = JSON.parse(content);
+        // Basic validation
+        if (typeof parsed !== "object" || parsed === null)
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/** Repair corrupted config: rename to .bak and generate fresh. */
+function repairCorrupted(filePath) {
+    const backupPath = filePath + ".bak";
+    try {
+        renameSync(filePath, backupPath);
+    }
+    catch {
+        // If rename fails, just overwrite
+    }
+    writeConfigAtomic(filePath, DEFAULT_CONFIG);
+    return DEFAULT_CONFIG;
+}
+/**
+ * Initialize config on extension start.
+ * - If missing: generate with defaults
+ * - If corrupted: rename to .bak, generate fresh
+ * - If valid: load
+ */
+export function initConfig(cwd) {
+    const globalPath = getGlobalConfigPath();
+    // Ensure global config dir exists
+    ensureDir(globalPath);
+    // Load or create global config
+    let globalConfig = loadConfigFromPath(globalPath);
+    if (globalConfig === null) {
+        globalConfig = repairCorrupted(globalPath);
+    }
+    // Load workspace override if exists
+    const workspacePath = getWorkspaceConfigPath(cwd);
+    const workspaceConfig = loadConfigFromPath(workspacePath);
+    if (workspaceConfig) {
+        // Merge: workspace overrides global on any field present
+        return {
+            ...globalConfig,
+            ...workspaceConfig,
+            types: {
+                ...globalConfig.types,
+                ...workspaceConfig.types,
+            },
+        };
+    }
+    return globalConfig;
+}
+/**
+ * Save global config.
+ */
+export function saveGlobalConfig(config) {
+    const globalPath = getGlobalConfigPath();
+    ensureDir(globalPath);
+    writeConfigAtomic(globalPath, config);
+}
+/**
+ * Save workspace config.
+ */
+export function saveWorkspaceConfig(cwd, config) {
+    const workspacePath = getWorkspaceConfigPath(cwd);
+    ensureDir(workspacePath);
+    writeConfigAtomic(workspacePath, config);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/custom-agents.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @pi-unipi/subagents — Custom agent loader
+ *
+ * Discovers agent types from:
+ * - <workspace>/.unipc/config/agents/*.md (project, highest priority)
+ * - ~/.unipc/config/agents/*.md (global)
+ */
+import type { AgentConfig } from "./types.js";
+/**
+ * Load all custom agents from project and global directories.
+ * Project agents override global agents with the same name.
+ */
+export declare function loadCustomAgents(cwd: string): Map<string, AgentConfig>;
+//# sourceMappingURL=custom-agents.d.ts.map

package/dist/custom-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-agents.d.ts","sourceRoot":"","sources":["../src/custom-agents.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA6D9C;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CA4BtE"}

package/dist/custom-agents.js

@@ -0,0 +1,94 @@
+/**
+ * @pi-unipi/subagents — Custom agent loader
+ *
+ * Discovers agent types from:
+ * - <workspace>/.unipc/config/agents/*.md (project, highest priority)
+ * - ~/.unipc/config/agents/*.md (global)
+ */
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { parseFrontmatter } from "@mariozechner/pi-coding-agent";
+/** Get project agents directory. */
+function getProjectAgentsDir(cwd) {
+    return join(cwd, ".unipc", "config", "agents");
+}
+/** Get global agents directory. */
+function getGlobalAgentsDir() {
+    return join(homedir(), ".unipc", "config", "agents");
+}
+/** All known built-in tool names. */
+const BUILTIN_TOOL_NAMES = ["read", "bash", "edit", "write", "grep", "find", "ls"];
+/**
+ * Load a single agent from a .md file.
+ */
+function loadAgentFromFile(filePath, source) {
+    try {
+        const content = readFileSync(filePath, "utf-8");
+        const { frontmatter, body } = parseFrontmatter(content);
+        if (!frontmatter || typeof frontmatter !== "object") {
+            return null;
+        }
+        const name = filePath.split("/").pop()?.replace(/\.md$/, "") ?? "unknown";
+        // Parse tools from comma-separated string
+        const toolsStr = frontmatter.tools;
+        const builtinToolNames = toolsStr
+            ? toolsStr.split(",").map((t) => t.trim()).filter((t) => BUILTIN_TOOL_NAMES.includes(t))
+            : [...BUILTIN_TOOL_NAMES];
+        return {
+            name,
+            displayName: frontmatter.display_name,
+            description: frontmatter.description ?? `${name} agent`,
+            builtinToolNames,
+            disallowedTools: frontmatter.disallowed_tools
+                ?.split(",")
+                .map((t) => t.trim()),
+            extensions: frontmatter.extensions !== false,
+            skills: frontmatter.skills !== false,
+            model: frontmatter.model,
+            thinking: frontmatter.thinking,
+            maxTurns: frontmatter.max_turns,
+            systemPrompt: body.trim(),
+            promptMode: frontmatter.prompt_mode ?? "replace",
+            inheritContext: frontmatter.inherit_context,
+            runInBackground: frontmatter.run_in_background,
+            isolated: frontmatter.isolated,
+            enabled: frontmatter.enabled !== false,
+            source,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Load all custom agents from project and global directories.
+ * Project agents override global agents with the same name.
+ */
+export function loadCustomAgents(cwd) {
+    const agents = new Map();
+    // Load global agents first
+    const globalDir = getGlobalAgentsDir();
+    if (existsSync(globalDir)) {
+        const files = readdirSync(globalDir).filter((f) => f.endsWith(".md"));
+        for (const file of files) {
+            const agent = loadAgentFromFile(join(globalDir, file), "global");
+            if (agent) {
+                agents.set(agent.name, agent);
+            }
+        }
+    }
+    // Load project agents (overrides global)
+    const projectDir = getProjectAgentsDir(cwd);
+    if (existsSync(projectDir)) {
+        const files = readdirSync(projectDir).filter((f) => f.endsWith(".md"));
+        for (const file of files) {
+            const agent = loadAgentFromFile(join(projectDir, file), "project");
+            if (agent) {
+                agents.set(agent.name, agent);
+            }
+        }
+    }
+    return agents;
+}
+//# sourceMappingURL=custom-agents.js.map

package/dist/custom-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-agents.js","sourceRoot":"","sources":["../src/custom-agents.ts"],"names":[],"mappings":"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"}

package/dist/file-lock.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @pi-unipi/subagents — Per-file transparent locking
+ *
+ * Agents never see lock errors. Write tool queues internally.
+ * Per-file granularity: locking src/auth.ts doesn't block src/login.ts.
+ */
+export declare class FileLock {
+    /** Active locks by file path. */
+    private locks;
+    /** Queue of waiting acquires per file path. */
+    private queues;
+    /**
+     * Acquire a lock on a file. Blocks until available.
+     * Returns a release function.
+     *
+     * @param filePath - Absolute path to the file
+     * @param agentId - ID of the agent requesting the lock
+     * @returns Release function — call when done writing
+     */
+    acquire(filePath: string, agentId: string): Promise<() => void>;
+    /**
+     * Check if a file is currently locked.
+     */
+    isLocked(filePath: string): boolean;
+    /**
+     * Get the agent that holds a lock on a file.
+     */
+    getHolder(filePath: string): string | undefined;
+    /**
+     * Get count of locked files.
+     */
+    get lockCount(): number;
+    /**
+     * Release all locks held by an agent (on abort).
+     */
+    releaseAll(agentId: string): void;
+    /**
+     * Clear all locks (on shutdown).
+     */
+    clear(): void;
+}
+//# sourceMappingURL=file-lock.d.ts.map

package/dist/file-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-lock.d.ts","sourceRoot":"","sources":["../src/file-lock.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,qBAAa,QAAQ;IACnB,iCAAiC;IACjC,OAAO,CAAC,KAAK,CAAoC;IACjD,+CAA+C;IAC/C,OAAO,CAAC,MAAM,CAAwC;IAEtD;;;;;;;OAOG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC;IAoCrE;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAInC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI/C;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQjC;;OAEG;IACH,KAAK,IAAI,IAAI;CAOd"}

package/dist/file-lock.js

@@ -0,0 +1,91 @@
+/**
+ * @pi-unipi/subagents — Per-file transparent locking
+ *
+ * Agents never see lock errors. Write tool queues internally.
+ * Per-file granularity: locking src/auth.ts doesn't block src/login.ts.
+ */
+export class FileLock {
+    /** Active locks by file path. */
+    locks = new Map();
+    /** Queue of waiting acquires per file path. */
+    queues = new Map();
+    /**
+     * Acquire a lock on a file. Blocks until available.
+     * Returns a release function.
+     *
+     * @param filePath - Absolute path to the file
+     * @param agentId - ID of the agent requesting the lock
+     * @returns Release function — call when done writing
+     */
+    async acquire(filePath, agentId) {
+        // Wait for existing lock
+        while (this.locks.has(filePath)) {
+            await new Promise((resolve) => {
+                const queue = this.queues.get(filePath) ?? [];
+                queue.push(resolve);
+                this.queues.set(filePath, queue);
+            });
+        }
+        // Create lock entry
+        let releaseFn;
+        const promise = new Promise((resolve) => {
+            releaseFn = () => {
+                this.locks.delete(filePath);
+                resolve();
+                // Wake next waiter
+                const queue = this.queues.get(filePath);
+                if (queue && queue.length > 0) {
+                    const next = queue.shift();
+                    next();
+                }
+            };
+        });
+        const entry = {
+            agentId,
+            filePath,
+            promise,
+            release: releaseFn,
+        };
+        this.locks.set(filePath, entry);
+        return releaseFn;
+    }
+    /**
+     * Check if a file is currently locked.
+     */
+    isLocked(filePath) {
+        return this.locks.has(filePath);
+    }
+    /**
+     * Get the agent that holds a lock on a file.
+     */
+    getHolder(filePath) {
+        return this.locks.get(filePath)?.agentId;
+    }
+    /**
+     * Get count of locked files.
+     */
+    get lockCount() {
+        return this.locks.size;
+    }
+    /**
+     * Release all locks held by an agent (on abort).
+     */
+    releaseAll(agentId) {
+        for (const [filePath, entry] of this.locks) {
+            if (entry.agentId === agentId) {
+                entry.release();
+            }
+        }
+    }
+    /**
+     * Clear all locks (on shutdown).
+     */
+    clear() {
+        for (const entry of this.locks.values()) {
+            entry.release();
+        }
+        this.locks.clear();
+        this.queues.clear();
+    }
+}
+//# sourceMappingURL=file-lock.js.map

package/dist/file-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-lock.js","sourceRoot":"","sources":["../src/file-lock.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,OAAO,QAAQ;IACnB,iCAAiC;IACzB,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IACjD,+CAA+C;IACvC,MAAM,GAAG,IAAI,GAAG,EAA6B,CAAC;IAEtD;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CAAC,QAAgB,EAAE,OAAe;QAC7C,yBAAyB;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAC9C,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACpB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC;QACL,CAAC;QAED,oBAAoB;QACpB,IAAI,SAAqB,CAAC;QAC1B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC5C,SAAS,GAAG,GAAG,EAAE;gBACf,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC5B,OAAO,EAAE,CAAC;gBACV,mBAAmB;gBACnB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACxC,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;oBAC5B,IAAI,EAAE,CAAC;gBACT,CAAC;YACH,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAkB;YAC3B,OAAO;YACP,QAAQ;YACR,OAAO;YACP,OAAO,EAAE,SAAU;SACpB,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAChC,OAAO,SAAU,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,QAAgB;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,QAAgB;QACxB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAAe;QACxB,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3C,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;gBAC9B,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACxC,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @pi-unipi/subagents — Extension entry
+ *
+ * Tools: Agent, get_result
+ * ESC propagation: all children abort on parent ESC
+ */
+import { type ExtensionAPI } from "@mariozechner/pi-coding-agent";
+export default function (pi: ExtensionAPI): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAc,KAAK,YAAY,EAAyB,MAAM,+BAA+B,CAAC;AA2BrG,MAAM,CAAC,OAAO,WAAW,EAAE,EAAE,YAAY,QAgSxC"}

package/dist/index.js

@@ -0,0 +1,270 @@
+/**
+ * @pi-unipi/subagents — Extension entry
+ *
+ * Tools: Agent, get_result
+ * ESC propagation: all children abort on parent ESC
+ */
+import { defineTool } from "@mariozechner/pi-coding-agent";
+import { Type } from "@sinclair/typebox";
+import { AgentManager } from "./agent-manager.js";
+import { initConfig } from "./config.js";
+import { BUILTIN_TYPES } from "./types.js";
+import { AgentWidget } from "./widget.js";
+/** Format tokens safely. */
+function safeFormatTokens(session) {
+    if (!session)
+        return "";
+    try {
+        const stats = session.getSessionStats();
+        const total = stats.tokens?.total ?? 0;
+        if (total >= 1_000_000)
+            return `${(total / 1_000_000).toFixed(1)}M`;
+        if (total >= 1_000)
+            return `${(total / 1_000).toFixed(1)}k`;
+        return `${total}`;
+    }
+    catch {
+        return "";
+    }
+}
+/** Build result text. */
+function textResult(msg, details) {
+    return { content: [{ type: "text", text: msg }], details };
+}
+export default function (pi) {
+    // Initialize config
+    const config = initConfig(process.cwd());
+    if (!config.enabled)
+        return;
+    // Activity tracking for widget
+    const agentActivity = new Map();
+    // Create manager with completion callback
+    const manager = new AgentManager((record) => {
+        // On complete: clean up activity, emit event
+        agentActivity.delete(record.id);
+        widget.markFinished(record.id);
+        widget.update();
+        pi.events.emit("subagents:completed", {
+            id: record.id,
+            type: record.type,
+            description: record.description,
+            status: record.status,
+            result: record.result,
+            error: record.error,
+        });
+    }, config.maxConcurrent, (record) => {
+        // On start: emit event
+        pi.events.emit("subagents:started", {
+            id: record.id,
+            type: record.type,
+            description: record.description,
+        });
+    });
+    // Create widget
+    const widget = new AgentWidget(manager, agentActivity);
+    // ESC propagation: abort all agents on session shutdown
+    pi.on("session_shutdown", async () => {
+        manager.abortAll();
+        manager.dispose();
+    });
+    // Wire UI context for widget
+    pi.on("tool_execution_start", async (_event, ctx) => {
+        widget.setUICtx(ctx.ui);
+        widget.update();
+    });
+    // Create activity tracker
+    function createActivityTracker(maxTurns) {
+        const state = {
+            activeTools: new Map(),
+            toolUses: 0,
+            turnCount: 1,
+            maxTurns,
+            tokens: "",
+            responseText: "",
+        };
+        const callbacks = {
+            onToolActivity: (activity) => {
+                if (activity.type === "start") {
+                    state.activeTools.set(activity.toolName + "_" + Date.now(), activity.toolName);
+                }
+                else {
+                    for (const [key, name] of state.activeTools) {
+                        if (name === activity.toolName) {
+                            state.activeTools.delete(key);
+                            break;
+                        }
+                    }
+                    state.toolUses++;
+                }
+                widget.update();
+            },
+            onTextDelta: (_delta, fullText) => {
+                state.responseText = fullText;
+                widget.update();
+            },
+            onTurnEnd: (turnCount) => {
+                state.turnCount = turnCount;
+                widget.update();
+            },
+            onSessionCreated: (session) => {
+                state.session = session;
+                state.tokens = safeFormatTokens(session);
+                widget.update();
+            },
+        };
+        return { state, callbacks };
+    }
+    // ---- Agent tool ----
+    const builtinTypes = BUILTIN_TYPES.join(", ");
+    pi.registerTool(defineTool({
+        name: "Agent",
+        label: "Agent",
+        description: `Launch a sub-agent for parallel work.
+
+Available agent types: ${builtinTypes}
+Custom types can be defined in .unipi/config/agents/<name>.md
+
+Guidelines:
+- Use "explore" for parallel file reads
+- Use "work" for parallel file writes (transparent locking)
+- Use run_in_background for work you don't need immediately
+- ESC kills all running agents immediately
+- Agents inherit the parent model by default`,
+        parameters: Type.Object({
+            type: Type.String({
+                description: `Agent type: ${builtinTypes}, or custom type from .unipc/config/agents/*.md`,
+            }),
+            prompt: Type.String({
+                description: "The task for the agent to perform.",
+            }),
+            description: Type.String({
+                description: "A short (3-5 word) description of the task.",
+            }),
+            run_in_background: Type.Optional(Type.Boolean({
+                description: "Run in background. Returns agent ID immediately.",
+            })),
+            max_turns: Type.Optional(Type.Number({
+                description: "Max agentic turns before stopping.",
+                minimum: 1,
+            })),
+        }),
+        execute: async (toolCallId, params, signal, onUpdate, ctx) => {
+            widget.setUICtx(ctx.ui);
+            const type = params.type;
+            const prompt = params.prompt;
+            const description = params.description;
+            const runInBackground = params.run_in_background;
+            const maxTurns = params.max_turns;
+            // Create activity tracker
+            const { state: bgState, callbacks: bgCallbacks } = createActivityTracker(maxTurns);
+            if (runInBackground) {
+                // Background execution
+                const id = manager.spawn(pi, ctx, type, prompt, {
+                    description,
+                    maxTurns,
+                    isBackground: true,
+                    ...bgCallbacks,
+                });
+                agentActivity.set(id, bgState);
+                widget.ensureTimer();
+                widget.update();
+                const record = manager.getRecord(id);
+                const isQueued = record?.status === "queued";
+                return textResult(`Agent ${isQueued ? "queued" : "started"} in background.\n` +
+                    `ID: ${id}\n` +
+                    `Type: ${type}\n` +
+                    `Description: ${description}\n` +
+                    (isQueued ? `Position: queued (max ${manager.getMaxConcurrent()} concurrent)\n` : "") +
+                    `\nYou will be notified when this agent completes.\n` +
+                    `Use get_result to retrieve full results.`, { status: "background", agentId: id });
+            }
+            // Foreground execution
+            let spinnerFrame = 0;
+            const startedAt = Date.now();
+            let fgId;
+            const streamUpdate = () => {
+                onUpdate?.({
+                    content: [{ type: "text", text: `${bgState.toolUses} tool uses...` }],
+                    details: {
+                        status: "running",
+                        toolUses: bgState.toolUses,
+                        tokens: bgState.tokens,
+                        turnCount: bgState.turnCount,
+                        maxTurns: bgState.maxTurns,
+                        durationMs: Date.now() - startedAt,
+                        activity: bgState.responseText
+                            ? bgState.responseText.split("\n").pop()?.trim().slice(0, 60)
+                            : "thinking…",
+                        spinnerFrame: spinnerFrame % 10,
+                    },
+                });
+            };
+            const spinnerInterval = setInterval(() => {
+                spinnerFrame++;
+                streamUpdate();
+            }, 80);
+            streamUpdate();
+            const record = await manager.spawnAndWait(pi, ctx, type, prompt, {
+                description,
+                maxTurns,
+                ...bgCallbacks,
+            });
+            clearInterval(spinnerInterval);
+            if (fgId) {
+                agentActivity.delete(fgId);
+                widget.markFinished(fgId);
+            }
+            const tokenText = safeFormatTokens(bgState.session);
+            const durationMs = (record.completedAt ?? Date.now()) - record.startedAt;
+            if (record.status === "error") {
+                return textResult(`Agent failed: ${record.error}`);
+            }
+            return textResult(`Agent completed in ${(durationMs / 1000).toFixed(1)}s (${record.toolUses} tool uses${tokenText ? `, ${tokenText} tokens` : ""}).\n\n` +
+                (record.result?.trim() || "No output."));
+        },
+    }));
+    // ---- get_result tool ----
+    pi.registerTool(defineTool({
+        name: "get_result",
+        label: "Get Agent Result",
+        description: "Check status and retrieve results from a background agent.",
+        parameters: Type.Object({
+            agent_id: Type.String({
+                description: "The agent ID to check.",
+            }),
+            wait: Type.Optional(Type.Boolean({
+                description: "Wait for completion. Default: false.",
+            })),
+        }),
+        execute: async (_toolCallId, params) => {
+            const record = manager.getRecord(params.agent_id);
+            if (!record) {
+                return textResult(`Agent not found: "${params.agent_id}". It may have been cleaned up.`);
+            }
+            if (params.wait && record.status === "running" && record.promise) {
+                record.resultConsumed = true;
+                await record.promise;
+            }
+            const duration = record.completedAt
+                ? `${((record.completedAt - record.startedAt) / 1000).toFixed(1)}s`
+                : "running";
+            let output = `Agent: ${record.id}\n` +
+                `Type: ${record.type} | Status: ${record.status} | Tool uses: ${record.toolUses} | Duration: ${duration}\n` +
+                `Description: ${record.description}\n\n`;
+            if (record.status === "running") {
+                output += "Agent is still running. Use wait: true or check back later.";
+            }
+            else if (record.status === "error") {
+                output += `Error: ${record.error}`;
+            }
+            else {
+                output += record.result?.trim() || "No output.";
+            }
+            if (record.status !== "running" && record.status !== "queued") {
+                record.resultConsumed = true;
+            }
+            return textResult(output);
+        },
+    }));
+}
+//# sourceMappingURL=index.js.map