@fitchmultz/pi-subagents 0.49.1 → 0.51.0

package/dist/shared/status-format.js

@@ -1,171 +0,0 @@
-import { loadConfig } from "../extension/config.js";
-export function formatAgentProcessExit(exit) {
-    return exit
-        ? `Agent process exited (${exit.signal !== null ? `signal ${exit.signal}` : `code ${exit.code ?? "unrecorded"}`}). Command and descendant exit are not implied.`
-        : "Agent process exit not recorded. Command exit is unconfirmed.";
-}
-export function formatRunAction(action, id, fields = {}, childSafe = false) {
-    const legacyChild = childSafe && loadConfig().compactChildTools === false;
-    const name = legacyChild ? action : parentActionName(action);
-    const args = Object.entries({ action: name, ...(id !== undefined ? { id } : {}), ...fields })
-        .map(([key, value]) => `${key}: ${JSON.stringify(value)}`)
-        .join(", ");
-    const call = `${legacyChild || action === "extend" ? "subagent" : "agent_runs"}({ ${args} })`;
-    return action === "extend" && !legacyChild ? `load_subagent({}), then ${call}` : call;
-}
-function parentActionName(action) {
-    switch (action) {
-        case "status":
-            return "inspect";
-        case "resume":
-            return "continue";
-        case "interrupt":
-            return "stop";
-        case "answer":
-        case "extend":
-        case "nudge":
-        case "questions":
-        case "review":
-            return action;
-    }
-}
-function managementCapabilities(input) {
-    const capabilities = ["status"];
-    if (input.state === "live") {
-        if (input.canNudge === true) {
-            capabilities.push("nudge");
-        }
-        if (input.canResume === true) {
-            capabilities.push("resume");
-        }
-        if (input.canInterrupt === true) {
-            capabilities.push("interrupt");
-        }
-    }
-    else if (input.canResume === true) {
-        capabilities.push("resume");
-    }
-    if (input.state === "live" && input.canExtend === true) {
-        capabilities.push("extend");
-    }
-    if (input.canReview === true) {
-        capabilities.push("review");
-    }
-    return capabilities;
-}
-function managementNextAction(action, input) {
-    return {
-        action,
-        runId: input.runId,
-        ...(input.index !== undefined && (action === "nudge" || action === "resume")
-            ? { index: input.index }
-            : {}),
-        ...(input.intercomTarget !== undefined &&
-            input.intercomTarget !== "" &&
-            (action === "nudge" || action === "resume")
-            ? { intercomTarget: input.intercomTarget }
-            : {}),
-    };
-}
-export function buildManagementControl(input) {
-    const capabilities = managementCapabilities(input);
-    return {
-        state: input.state,
-        runId: input.runId,
-        capabilities,
-        nextActions: capabilities.map((action) => managementNextAction(action, input)),
-        ...(input.unavailableActions ? { unavailableActions: input.unavailableActions } : {}),
-        ...(input.revivedFromRunId !== undefined && input.revivedFromRunId !== ""
-            ? { revivedFromRunId: input.revivedFromRunId, pendingReplyContextValid: false }
-            : {}),
-    };
-}
-function formatActivityAge(ms) {
-    if (ms < 1000) {
-        return "now";
-    }
-    if (ms < 60000) {
-        return `${Math.floor(ms / 1000)}s`;
-    }
-    return `${Math.floor(ms / 60000)}m`;
-}
-export function formatActivityLabel(lastActivityAt, activityState, now = Date.now()) {
-    if (lastActivityAt === undefined) {
-        if (activityState === "needs_attention") {
-            return "needs attention";
-        }
-        return undefined;
-    }
-    const age = formatActivityAge(Math.max(0, now - lastActivityAt));
-    if (activityState === "needs_attention") {
-        return `no activity for ${age}`;
-    }
-    return age === "now" ? "active now" : `active ${age} ago`;
-}
-function isCompletedStepStatus(status) {
-    return status === "complete" || status === "completed";
-}
-export function aggregateStepStatus(steps) {
-    if (steps.some((step) => step.status === "running")) {
-        return "running";
-    }
-    if (steps.some((step) => step.status === "failed")) {
-        return "failed";
-    }
-    if (steps.some((step) => step.status === "blocked")) {
-        return "blocked";
-    }
-    if (steps.some((step) => step.status === "paused")) {
-        return "paused";
-    }
-    if (steps.length > 0 && steps.every((step) => isCompletedStepStatus(step.status))) {
-        return "complete";
-    }
-    return "pending";
-}
-export function formatAgentRunningLabel(count) {
-    return count === 1 ? "1 agent running" : `${count} agents running`;
-}
-function intercomHealth(health) {
-    if (!health) {
-        return "unknown";
-    }
-    if (health.status !== "registered") {
-        return health.status.replace(/_/g, " ");
-    }
-    return `registered${health.sessionStatus !== undefined && health.sessionStatus !== "" ? `, ${health.sessionStatus}` : ""}${health.acceptsAsks !== undefined ? `, accepts_asks:${health.acceptsAsks}` : ""}${health.pendingAsks !== undefined ? `, pending_asks:${health.pendingAsks}` : ""}`;
-}
-export function formatLiveIntercomActionLines(input) {
-    const fields = {
-        ...(input.index !== undefined ? { index: input.index } : {}),
-        message: "What are you blocked on?",
-    };
-    const healthText = intercomHealth(input.health);
-    const indent = input.indent ?? "";
-    return [
-        `${indent}Intercom: ${healthText} (${input.target})`,
-        `${indent}Nudge (preferred live coordination): ${formatRunAction("nudge", input.runId, fields, input.childSafe)}`,
-        `${indent}Ask (blocking wait only; parent must remain alive): intercom({ action: "ask", to: "${input.target}", delivery: "steer", message: "What are you blocked on?" })`,
-    ];
-}
-export function formatParallelOutcome(steps, total, options = {}) {
-    const running = steps.filter((step) => step.status === "running").length;
-    const succeeded = steps.filter((step) => isCompletedStepStatus(step.status)).length;
-    const failed = steps.filter((step) => step.status === "failed").length;
-    const paused = steps.filter((step) => step.status === "paused").length;
-    const blocked = steps.filter((step) => step.status === "blocked").length;
-    const parts = [`${succeeded}/${total} succeeded`];
-    if (options.showRunning !== false && running > 0) {
-        parts.unshift(formatAgentRunningLabel(running));
-    }
-    if (failed > 0) {
-        parts.push(`${failed} failed`);
-    }
-    if (paused > 0) {
-        parts.push(`${paused} paused`);
-    }
-    if (blocked > 0) {
-        parts.push(`${blocked} need human action`);
-    }
-    return parts.join(" · ");
-}

package/dist/shared/task-file-policy.js

@@ -1,24 +0,0 @@
-export function resolveTaskTextForFileUpdatePolicy(task, originalTask) {
-    if (task === undefined || task.length === 0) {
-        return originalTask;
-    }
-    return originalTask !== undefined && originalTask.length > 0
-        ? task.replaceAll("{task}", () => originalTask)
-        : task;
-}
-export function taskDisallowsFileUpdates(task) {
-    if (task === undefined || task.length === 0) {
-        return false;
-    }
-    return (/\breview[- ]only\b/i.test(task) ||
-        /\bread[- ]only\s+(?:review|audit|inspection|pass)\b/i.test(task) ||
-        /\b(?:no|without)\s+(?:file\s+)?edits?\b/i.test(task) ||
-        /\b(?:do not|don't|must not)\s+(?:edit|modify|write|touch)\b/i.test(task) ||
-        /\bleave\s+files?\s+unchanged\b/i.test(task));
-}
-export function suppressProgressForReadOnlyTask(behavior, task, originalTask) {
-    const policyTask = resolveTaskTextForFileUpdatePolicy(task, originalTask);
-    return behavior.progress && taskDisallowsFileUpdates(policyTask)
-        ? { ...behavior, progress: false }
-        : behavior;
-}

package/dist/shared/temp-root.js

@@ -1,143 +0,0 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { isSafeNestedPathId } from "../runs/shared/nested-path.js";
-import { ASYNC_DIR, RESULTS_DIR, TEMP_ROOT_DIR } from "./types.js";
-import { hasErrorCode, isRecord } from "./unknown.js";
-import { listRunQuestions, LEGACY_QUESTIONS_DIR, QUESTIONS_DIR, } from "../runs/shared/supervisor-questions.js";
-const MAX_RUN_AGE_MS = 7 * 24 * 60 * 60 * 1000;
-export function ensureTempRoot() {
-    fs.mkdirSync(TEMP_ROOT_DIR, { recursive: true, mode: 0o700 });
-    const stat = fs.lstatSync(TEMP_ROOT_DIR);
-    if (!stat.isDirectory() || stat.isSymbolicLink()) {
-        throw new Error(`Unsafe pi-subagents temp root: ${TEMP_ROOT_DIR}`);
-    }
-    const uid = process.getuid?.();
-    if (uid !== undefined && stat.uid !== uid) {
-        throw new Error(`pi-subagents temp root is owned by another user: ${TEMP_ROOT_DIR}`);
-    }
-    fs.chmodSync(TEMP_ROOT_DIR, 0o700);
-}
-export function ensureSafeTempPath(candidate) {
-    const root = path.resolve(TEMP_ROOT_DIR);
-    const resolved = path.resolve(candidate);
-    const relative = path.relative(root, resolved);
-    if (relative === ".." || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
-        return;
-    }
-    ensureTempRoot();
-    let current = root;
-    for (const segment of relative.split(path.sep).filter(Boolean)) {
-        current = path.join(current, segment);
-        try {
-            const stat = fs.lstatSync(current);
-            if (stat.isSymbolicLink()) {
-                throw new Error(`Unsafe symlink in pi-subagents temp path: ${current}`);
-            }
-        }
-        catch (error) {
-            if (hasErrorCode(error, "ENOENT")) {
-                return;
-            }
-            throw error;
-        }
-    }
-}
-// Missing, malformed, or non-object JSON means the entry is incomplete garbage and safe
-// to remove. Operational read failures throw so callers fail closed instead of deleting.
-async function readJsonObject(file) {
-    try {
-        const parsed = JSON.parse(await fs.promises.readFile(file, "utf-8"));
-        return isRecord(parsed) ? parsed : undefined;
-    }
-    catch (error) {
-        if (hasErrorCode(error, "ENOENT") || error instanceof SyntaxError) {
-            return undefined;
-        }
-        throw error;
-    }
-}
-async function activeStatus(statusFile) {
-    const status = await readJsonObject(statusFile);
-    return status?.state === "running" || status?.state === "queued";
-}
-async function removeOldEntries(root, now, keepActive) {
-    let entries;
-    try {
-        entries = await fs.promises.readdir(root, { withFileTypes: true });
-    }
-    catch {
-        return;
-    }
-    for (const entry of entries) {
-        const entryPath = path.join(root, entry.name);
-        try {
-            // Sequential retention bounds filesystem work and observes each entry before deletion.
-            // oxlint-disable-next-line no-await-in-loop
-            const stat = await fs.promises.lstat(entryPath);
-            if (now - stat.mtimeMs <= MAX_RUN_AGE_MS) {
-                continue;
-            }
-            // Finish the entry's activity decision before deleting it or considering another entry.
-            // oxlint-disable-next-line no-await-in-loop
-            if (keepActive && entry.isDirectory() && (await keepActive(entryPath))) {
-                continue;
-            }
-            // Only remove entries whose preceding activity check completed; keep I/O bounded.
-            // oxlint-disable-next-line no-await-in-loop
-            await fs.promises.rm(entryPath, { recursive: entry.isDirectory(), force: true });
-        }
-        catch {
-            // Startup retention cleanup is best effort; entries that fail closed are skipped.
-        }
-    }
-}
-// A route is live while anything still writes into it (nested descendants can outlive a
-// terminal root, and foreground roots have no async status at all) or while its root run
-// reports an active state. Child writes land in the events/ and controls/ subdirs without
-// bumping the route-root mtime; registry projection renames into routeRoot, which the
-// caller's mtime gate already covers.
-async function nestedRouteActive(routeRoot, now) {
-    for (const name of ["events", "controls"]) {
-        try {
-            // Inspect the two writer directories in order, short-circuiting on live activity.
-            // oxlint-disable-next-line no-await-in-loop
-            if (now - (await fs.promises.stat(path.join(routeRoot, name))).mtimeMs <= MAX_RUN_AGE_MS) {
-                return true;
-            }
-        }
-        catch (error) {
-            if (!hasErrorCode(error, "ENOENT")) {
-                throw error;
-            }
-        }
-    }
-    const metadata = await readJsonObject(path.join(routeRoot, "route.json"));
-    if (!metadata || !isSafeNestedPathId(metadata.rootRunId)) {
-        return false;
-    }
-    return activeStatus(path.join(ASYNC_DIR, metadata.rootRunId, "status.json"));
-}
-function pendingQuestion(runDir) {
-    return listRunQuestions(runDir).some((question) => question.state === "awaiting_input" || question.state === "answer_pending");
-}
-export async function cleanupOldRunStorage(now = Date.now()) {
-    for (const [dir, keepActive] of [
-        [
-            ASYNC_DIR,
-            async (entryPath) => (await activeStatus(path.join(entryPath, "status.json"))) ||
-                pendingQuestion(path.join(QUESTIONS_DIR, path.basename(entryPath))),
-        ],
-        [LEGACY_QUESTIONS_DIR, pendingQuestion],
-        [RESULTS_DIR, undefined],
-        [path.join(TEMP_ROOT_DIR, "nested-subagent-runs"), undefined],
-        [
-            path.join(TEMP_ROOT_DIR, "nested-subagent-events"),
-            (entryPath) => nestedRouteActive(entryPath, now),
-        ],
-    ]) {
-        ensureSafeTempPath(dir);
-        // Finish one storage root's retention scan before opening another.
-        // oxlint-disable-next-line no-await-in-loop
-        await removeOldEntries(dir, now, keepActive);
-    }
-}

package/dist/shared/types/acceptance.js

@@ -1 +0,0 @@
-export {};

package/dist/shared/types/async.js

@@ -1 +0,0 @@
-export {};

package/dist/shared/types/config.js

@@ -1 +0,0 @@
-export {};

package/dist/shared/types/details.js

@@ -1 +0,0 @@
-export {};

package/dist/shared/types/history.js

@@ -1 +0,0 @@
-export {};

package/dist/shared/types/inputs.js

@@ -1 +0,0 @@
-export {};

package/dist/shared/types/intercom.js

@@ -1 +0,0 @@
-export {};

package/dist/shared/types/launch.js

@@ -1 +0,0 @@
-export {};

package/dist/shared/types/messages.js

@@ -1 +0,0 @@
-export {};

package/dist/shared/types/nested.js

@@ -1 +0,0 @@
-export {};

package/dist/shared/types/owned-runs.js

@@ -1 +0,0 @@
-export {};

package/dist/shared/types/progress.js

@@ -1 +0,0 @@
-export {};

package/dist/shared/types/questions.js

@@ -1 +0,0 @@
-export {};

package/dist/shared/types/results.js

@@ -1 +0,0 @@
-export {};

package/dist/shared/types/state.js

@@ -1 +0,0 @@
-export {};

package/dist/shared/types/usage.js

@@ -1 +0,0 @@
-export {};

package/dist/shared/types/workflow.js

@@ -1 +0,0 @@
-export {};

package/dist/shared/ui-mode.js

@@ -1,3 +0,0 @@
-export function isTuiContext(ctx) {
-    return ctx.mode === "tui";
-}

package/dist/shared/utils.js

@@ -1,128 +0,0 @@
-/**
- * General utility functions for the subagent extension
- */
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { errorMessage, hasErrorCode, isRecord } from "./unknown.js";
-import { parseAsyncStatus } from "../runs/background/run-schemas.js";
-import { normalizeLegacyStatusAcceptance } from "../runs/background/legacy-status-acceptance.js";
-// ============================================================================
-// File System Utilities
-// ============================================================================
-export { getAgentDir } from "./agent-dir.js";
-const statusCache = new Map();
-function rememberStatus(statusPath, version, status) {
-    statusCache.set(statusPath, { version, status });
-    if (statusCache.size > 50) {
-        const firstKey = statusCache.keys().next().value;
-        if (firstKey !== undefined) {
-            statusCache.delete(firstKey);
-        }
-    }
-}
-export function resolveChildCwd(baseCwd, childCwd) {
-    if (childCwd === undefined || childCwd === "") {
-        return baseCwd;
-    }
-    return path.isAbsolute(childCwd) ? childCwd : path.resolve(baseCwd, childCwd);
-}
-function isNotFoundError(error) {
-    return hasErrorCode(error, "ENOENT");
-}
-function parseStatusForDisplay(value) {
-    try {
-        return parseAsyncStatus(value);
-    }
-    catch (error) {
-        if (!isRecord(value)) {
-            throw error;
-        }
-        // Legacy display metadata may be corrupt; every other persisted field must validate.
-        const { parallelGroups, ...remaining } = value;
-        if (parallelGroups === undefined) {
-            throw error;
-        }
-        try {
-            return parseAsyncStatus(remaining);
-        }
-        catch {
-            throw error;
-        }
-    }
-}
-/**
- * Read async job status from disk, invalidating on replacement and in-place updates.
- */
-export function readStatus(asyncDir) {
-    const statusPath = path.join(asyncDir, "status.json");
-    let stat;
-    try {
-        stat = fs.statSync(statusPath, { bigint: true });
-    }
-    catch (error) {
-        if (isNotFoundError(error)) {
-            statusCache.delete(statusPath);
-            return null;
-        }
-        throw new Error(`Failed to inspect async status file '${statusPath}': ${errorMessage(error)}`, {
-            cause: error,
-        });
-    }
-    const cached = statusCache.get(statusPath);
-    const version = `${stat.dev}:${stat.ino}:${stat.size}:${stat.mtimeNs}:${stat.ctimeNs}`;
-    if (cached && cached.version === version) {
-        return cached.status;
-    }
-    let content;
-    try {
-        content = fs.readFileSync(statusPath, "utf-8");
-    }
-    catch (error) {
-        if (isNotFoundError(error)) {
-            return null;
-        }
-        throw new Error(`Failed to read async status file '${statusPath}': ${errorMessage(error)}`, {
-            cause: error,
-        });
-    }
-    let status;
-    try {
-        const parsed = JSON.parse(content);
-        status = parseStatusForDisplay(normalizeLegacyStatusAcceptance(parsed));
-    }
-    catch (error) {
-        throw new Error(`Failed to parse async status file '${statusPath}': ${errorMessage(error)}`, {
-            cause: error,
-        });
-    }
-    rememberStatus(statusPath, version, status);
-    return status;
-}
-/**
- * Find the latest session file in a directory
- */
-export function findLatestSessionFile(sessionDir) {
-    try {
-        let latest;
-        for (const file of fs.readdirSync(sessionDir)) {
-            if (!file.endsWith(".jsonl")) {
-                continue;
-            }
-            const filePath = path.join(sessionDir, file);
-            const mtime = fs.statSync(filePath).mtimeMs;
-            if (!latest || mtime > latest.mtime) {
-                latest = { path: filePath, mtime };
-            }
-        }
-        return latest?.path ?? null;
-    }
-    catch {
-        return null;
-    }
-}
-export { getFinalOutput, getSingleResultOutput, formatResourceLimitExceeded, getDisplayItems, compactForegroundResult, detectSubagentError, } from "./message-output.js";
-export { extractToolArgsPreview, extractTextFromContent } from "./content-preview.js";
-// ============================================================================
-// Concurrency Utilities
-// ============================================================================
-export { mapConcurrent } from "./concurrency.js";

package/dist/slash/command-discovery.js

@@ -1,83 +0,0 @@
-import { discoverAgents, discoverChains } from "../agents/agents.js";
-import { resolveExecutionCwd } from "../shared/execution-cwd.js";
-function projectTrusted(state) {
-    return state.lastUiContext ? state.lastUiContext.isProjectTrusted() : true;
-}
-function completionCwd(pi, state) {
-    try {
-        return state.lastUiContext ? resolveExecutionCwd(pi, state.lastUiContext) : state.baseCwd;
-    }
-    catch {
-        return null;
-    }
-}
-export function assertKnownAgents(cwd, names, trusted) {
-    const agents = discoverAgents(cwd, "both", { projectTrusted: trusted }).agents;
-    for (const name of names) {
-        if (!agents.some((agent) => agent.name === name)) {
-            throw new Error(`Unknown agent: ${name}`);
-        }
-    }
-}
-function completionPosition(prefix) {
-    const lastArrow = prefix.lastIndexOf(" -> ");
-    const segment = lastArrow !== -1 ? prefix.slice(lastArrow + 4) : prefix;
-    if (segment.includes(" -- ") || segment.includes('"') || segment.includes("'")) {
-        return undefined;
-    }
-    const word = prefix.match(/(\S*)$/)?.at(1) ?? "";
-    return { word, before: prefix.slice(0, prefix.length - word.length) };
-}
-export function makeAgentCompletions(pi, state, multiAgent) {
-    return (prefix) => {
-        const position = multiAgent ? completionPosition(prefix) : { word: prefix, before: "" };
-        if (!position || (!multiAgent && prefix.includes(" "))) {
-            return null;
-        }
-        const cwd = completionCwd(pi, state);
-        if (cwd === null || cwd.length === 0) {
-            return null;
-        }
-        const agents = discoverAgents(cwd, "both", { projectTrusted: projectTrusted(state) }).agents;
-        if (!multiAgent) {
-            return agents
-                .filter((agent) => agent.name.startsWith(prefix))
-                .map((agent) => ({ value: agent.name, label: agent.name }));
-        }
-        const { word: lastWord, before: beforeLastWord } = position;
-        if (lastWord === "->") {
-            return agents.map((agent) => ({ value: `${prefix} ${agent.name}`, label: agent.name }));
-        }
-        return agents
-            .filter((agent) => agent.name.startsWith(lastWord))
-            .map((agent) => ({ value: `${beforeLastWord}${agent.name}`, label: agent.name }));
-    };
-}
-export function discoverSavedChains(cwd, trusted) {
-    const chains = new Map();
-    for (const chain of discoverChains(cwd, { projectTrusted: trusted }).chains) {
-        const existing = chains.get(chain.name);
-        const projectOverride = existing?.source === "user" && chain.source === "project";
-        const jsonOverride = existing?.source === chain.source &&
-            chain.filePath.endsWith(".chain.json") &&
-            !existing.filePath.endsWith(".chain.json");
-        if (!existing || projectOverride || jsonOverride) {
-            chains.set(chain.name, chain);
-        }
-    }
-    return [...chains.values()];
-}
-export function makeChainCompletions(pi, state) {
-    return (prefix) => {
-        if (prefix.includes(" ")) {
-            return null;
-        }
-        const cwd = completionCwd(pi, state);
-        if (cwd === null || cwd.length === 0) {
-            return null;
-        }
-        return discoverSavedChains(cwd, projectTrusted(state))
-            .filter((chain) => chain.name.startsWith(prefix))
-            .map((chain) => ({ value: chain.name, label: chain.name }));
-    };
-}