@fitchmultz/pi-subagents 0.49.0 → 0.50.0

package/dist/shared/message-output.js

@@ -1,116 +0,0 @@
-import { formatToolCall } from "./formatters.js";
-function assistantText(message) {
-    if ((message.errorMessage !== undefined && message.errorMessage.length > 0) ||
-        message.stopReason === "error") {
-        return "";
-    }
-    for (let j = message.content.length - 1; j >= 0; j--) {
-        const part = message.content[j];
-        if (part.type === "text" && part.text.trim().length > 0) {
-            return part.text;
-        }
-    }
-    return "";
-}
-/** Last non-error assistant text, accepting honest incomplete native observations. */
-export function getFinalOutput(messages) {
-    for (let i = messages.length - 1; i >= 0; i--) {
-        const message = messages[i];
-        if (message.role === "assistant") {
-            const text = assistantText(message);
-            if (text !== "") {
-                return text;
-            }
-        }
-    }
-    return "";
-}
-export function getSingleResultOutput(result) {
-    return result.finalOutput ?? getFinalOutput(result.messages ?? []);
-}
-export function formatResourceLimitExceeded(input) {
-    if (input.kind === "maxExecutionTimeMs") {
-        return `Resource limit exceeded for ${input.agent}: maxExecutionTimeMs ${input.limit}ms.`;
-    }
-    return `Resource limit exceeded for ${input.agent}: maxTokens ${input.limit}${input.observed !== undefined ? ` (observed ${input.observed})` : ""}.`;
-}
-function assistantItems(message) {
-    return message.content.flatMap((part) => {
-        if (part.type === "text") {
-            return [{ type: "text", text: part.text }];
-        }
-        return part.type === "toolCall"
-            ? [{ type: "tool", name: part.name, args: part.arguments }]
-            : [];
-    });
-}
-export function getDisplayItems(messages) {
-    return (messages ?? []).flatMap((message) => message.role === "assistant" ? assistantItems(message) : []);
-}
-function extractToolCallSummaries(messages) {
-    return (messages ?? []).flatMap((message) => {
-        if (message.role !== "assistant") {
-            return [];
-        }
-        return message.content.flatMap((part) => part.type === "toolCall"
-            ? [
-                {
-                    text: formatToolCall(part.name, part.arguments),
-                    expandedText: formatToolCall(part.name, part.arguments, true),
-                },
-            ]
-            : []);
-    });
-}
-export function compactForegroundResult(result) {
-    if (result.progress?.status === "running") {
-        return result;
-    }
-    const toolCalls = result.toolCalls !== undefined && result.toolCalls.length > 0
-        ? result.toolCalls
-        : extractToolCallSummaries(result.messages);
-    return {
-        ...result,
-        messages: undefined,
-        progress: undefined,
-        toolCalls: toolCalls.length > 0 ? toolCalls : undefined,
-    };
-}
-function lastAssistantText(messages) {
-    return messages.findLastIndex((message) => message.role === "assistant" &&
-        message.content.some((part) => part.type === "text" && part.text.trim().length > 0));
-}
-function toolExitCode(message, text) {
-    const match = text?.match(/exit(?:ed)?\s*(?:with\s*)?(?:code|status)?\s*[:\s]?\s*(\d+)/i);
-    return message.observedExitCode ?? (match ? parseInt(match[1], 10) : undefined);
-}
-function toolError(message) {
-    const text = message.content.find((part) => part.type === "text")?.text;
-    const code = toolExitCode(message, text);
-    if (message.isError === true) {
-        return {
-            hasError: true,
-            exitCode: code ?? 1,
-            errorType: message.toolName !== "" ? message.toolName : "tool",
-            details: text?.slice(0, 200),
-        };
-    }
-    if (message.toolName === "bash" && text !== undefined && code !== undefined && code !== 0) {
-        return { hasError: true, exitCode: code, errorType: "bash", details: text.slice(0, 200) };
-    }
-    return undefined;
-}
-/** Errors superseded by later assistant success do not fail the result. */
-export function detectSubagentError(messages) {
-    const start = lastAssistantText(messages) + 1;
-    for (let i = messages.length - 1; i >= start; i--) {
-        const message = messages[i];
-        if (message.role === "toolResult") {
-            const error = toolError(message);
-            if (error) {
-                return error;
-            }
-        }
-    }
-    return { hasError: false };
-}

package/dist/shared/model-info.js

@@ -1,85 +0,0 @@
-export const THINKING_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
-export function toModelInfo(model) {
-    return {
-        provider: model.provider,
-        id: model.id,
-        fullId: `${model.provider}/${model.id}`,
-        reasoning: model.reasoning,
-        thinkingLevelMap: model.thinkingLevelMap,
-    };
-}
-export function providerQualifiedModelId(provider, model) {
-    if (model === undefined || model.length === 0) {
-        return undefined;
-    }
-    return provider !== undefined && provider.length > 0 && !model.startsWith(`${provider}/`)
-        ? `${provider}/${model}`
-        : model;
-}
-/** Resolve the effective thinking level from a model string (which may contain a known suffix like `:high`)
- * and an explicit thinking config value. Returns `undefined` when no thinking is applicable
- * (e.g. no model was specified, or the model has no suffix and no config was provided). */
-export function resolveEffectiveThinking(model, configThinking) {
-    if (model === undefined || model.length === 0) {
-        return undefined;
-    }
-    const { thinkingSuffix } = splitKnownThinkingSuffix(model);
-    if (thinkingSuffix.length > 0) {
-        return thinkingSuffix.slice(1);
-    }
-    return THINKING_LEVELS.find((level) => level === configThinking);
-}
-export function splitKnownThinkingSuffix(model) {
-    const colonIdx = model.lastIndexOf(":");
-    if (colonIdx === -1) {
-        return { baseModel: model, thinkingSuffix: "" };
-    }
-    const suffix = THINKING_LEVELS.find((level) => level === model.substring(colonIdx + 1));
-    if (suffix === undefined) {
-        return { baseModel: model, thinkingSuffix: "" };
-    }
-    return {
-        baseModel: model.substring(0, colonIdx),
-        thinkingSuffix: `:${suffix}`,
-    };
-}
-export function findModelInfo(model, availableModels, preferredProvider) {
-    if (model === undefined ||
-        model.length === 0 ||
-        availableModels === undefined ||
-        availableModels.length === 0) {
-        return undefined;
-    }
-    const { baseModel } = splitKnownThinkingSuffix(model);
-    const exact = availableModels.find((entry) => entry.fullId === baseModel);
-    if (exact) {
-        return exact;
-    }
-    const matches = availableModels.filter((entry) => entry.id === baseModel);
-    if (preferredProvider !== undefined && preferredProvider.length > 0) {
-        const preferred = matches.find((entry) => entry.provider === preferredProvider);
-        if (preferred) {
-            return preferred;
-        }
-    }
-    return matches.length === 1 ? matches[0] : undefined;
-}
-export function getSupportedThinkingLevels(model) {
-    if (model === undefined) {
-        return [...THINKING_LEVELS];
-    }
-    if (model.reasoning === false) {
-        return ["off"];
-    }
-    const levels = THINKING_LEVELS.filter((level) => {
-        const mapped = model.thinkingLevelMap?.[level];
-        if (mapped === null) {
-            return false;
-        }
-        if (level === "xhigh" || level === "max") {
-            return mapped !== undefined;
-        }
-        return true;
-    });
-    return levels;
-}

package/dist/shared/native-import.js

@@ -1,20 +0,0 @@
-import { registerHooks } from "node:module";
-/** Resolve only this native Node importer's literal SDK import to the selected host. */
-// ponytail: Jiti rewrites callback imports and loses their originating parent URL.
-// Jiti adapters must use the approved declaration-typed selected URL import boundary.
-export async function importSelectedNative(parentURL, specifier, targetURL, load) {
-    const hooks = registerHooks({
-        resolve(request, context, nextResolve) {
-            if (request === specifier && context.parentURL === parentURL) {
-                return nextResolve(targetURL, context);
-            }
-            return nextResolve(request, context);
-        },
-    });
-    try {
-        return await load();
-    }
-    finally {
-        hooks.deregister();
-    }
-}

package/dist/shared/native-session-loader.js

@@ -1,17 +0,0 @@
-var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
-    if (typeof path === "string" && /^\.\.?\//.test(path)) {
-        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
-            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
-        });
-    }
-    return path;
-};
-import * as path from "node:path";
-import { pathToFileURL } from "node:url";
-export async function loadNativeSession(packageRoot) {
-    // The trusted selected Pi package supplies this exact SDK declaration contract.
-    // A computed URL is required: Jiti rewrites literal SDK imports to its own host graph.
-    // oxlint-disable-next-line typescript/no-unsafe-assignment
-    const sessionModule = await import(__rewriteRelativeImportExtension(pathToFileURL(path.join(packageRoot, "dist/index.js")).href));
-    return sessionModule;
-}

package/dist/shared/native-session.js

@@ -1,4 +0,0 @@
-import { requirePiPackageRoot } from "../runs/shared/pi-spawn.js";
-import { loadNativeSession } from "./native-session-loader.js";
-// Detached Node runners do not get Pi's extension-loader package aliases.
-export const { buildSessionContext, parseSessionEntries, migrateSessionEntries, SessionManager } = await loadNativeSession(requirePiPackageRoot());

package/dist/shared/native-tui.js

@@ -1,23 +0,0 @@
-var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
-    if (typeof path === "string" && /^\.\.?\//.test(path)) {
-        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
-            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
-        });
-    }
-    return path;
-};
-import { findPackageJSON } from "node:module";
-import * as path from "node:path";
-import { pathToFileURL } from "node:url";
-import { requirePiPackageRoot } from "../runs/shared/pi-spawn.js";
-// Detached Node workers use the selected host's TUI, without extension-loader aliases.
-const manifest = findPackageJSON("@earendil-works/pi-tui", pathToFileURL(path.join(requirePiPackageRoot(), "dist/index.js")));
-if (manifest === undefined || manifest === "") {
-    throw new Error("Could not locate the selected Pi TUI package.");
-}
-const selectedTuiURL = new URL("./dist/utils.js", pathToFileURL(manifest)).href;
-// The trusted selected TUI export implements this exact native string-transform contract.
-// Jiti aliases literal TUI imports to its host, so this selected dependency URL is required.
-// oxlint-disable-next-line typescript/no-unsafe-assignment
-const tui = await import(__rewriteRelativeImportExtension(selectedTuiURL));
-export const { stripTerminalSequences } = tui;

package/dist/shared/native-typebox.js

@@ -1,32 +0,0 @@
-var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
-    if (typeof path === "string" && /^\.\.?\//.test(path)) {
-        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
-            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
-        });
-    }
-    return path;
-};
-import { createRequire } from "node:module";
-import * as path from "node:path";
-import { pathToFileURL } from "node:url";
-import { requirePiPackageRoot } from "../runs/shared/pi-spawn.js";
-// Detached Node runners do not get Pi's extension-loader package aliases.
-const require = createRequire(path.join(requirePiPackageRoot(), "dist/index.js"));
-const typeboxURL = pathToFileURL(require.resolve("typebox")).href;
-const compileURL = pathToFileURL(require.resolve("typebox/compile")).href;
-const valueURL = pathToFileURL(require.resolve("typebox/value")).href;
-// This trusted selected-host dependency supplies the actual TypeBox declarations.
-// Jiti aliases literal imports to its own graph, so the resolved URL must remain authoritative.
-// oxlint-disable-next-line typescript/no-unsafe-assignment
-const typebox = await import(__rewriteRelativeImportExtension(typeboxURL));
-// The selected host's TypeBox compiler implements this exact native compile contract.
-// A computed URL prevents Jiti from substituting another host's compiler graph.
-// oxlint-disable-next-line typescript/no-unsafe-assignment
-const compile = await import(__rewriteRelativeImportExtension(compileURL));
-// The selected host's value module implements these native Check/Errors signatures.
-// A computed URL preserves its real dependency graph under Jiti and detached Node.
-// oxlint-disable-next-line typescript/no-unsafe-assignment
-const value = await import(__rewriteRelativeImportExtension(valueURL));
-export const { Type } = typebox;
-export const { Compile } = compile;
-export const { Check, Errors } = value;

package/dist/shared/prompt-sections.js

@@ -1,10 +0,0 @@
-export function setPromptSection(options, name, content) {
-    // Pi owns this mutable prompt-building options object. This SDK hook updates
-    // sections and its legacy exact override in place; callers observe the same object.
-    options.sections[name] = content;
-    // Pi projects an earlier exact override instead of sections. Preserve its content;
-    // this compatibility path replaces the leading prompt and cannot preserve its cache prefix.
-    if (options.forceSystemPrompt !== undefined) {
-        options.forceSystemPrompt += `\n\n<${name}>\n${content}\n</${name}>`;
-    }
-}

package/dist/shared/session-entries.js

@@ -1,87 +0,0 @@
-/** Follow append-only parent links; rescan after replacement or append off the active branch. */
-export class SessionEntryCursor {
-    manager;
-    sessionId;
-    file;
-    known = new Map();
-    anchor;
-    reset() {
-        this.manager = undefined;
-        this.known.clear();
-        this.anchor = undefined;
-    }
-    changed(snapshot) {
-        if (this.manager !== snapshot.manager ||
-            this.sessionId !== snapshot.sessionId ||
-            this.file !== snapshot.file) {
-            return true;
-        }
-        if (snapshot.count !== undefined && snapshot.count < this.known.size) {
-            return true;
-        }
-        return (this.anchor !== undefined &&
-            snapshot.manager.getEntry !== undefined &&
-            snapshot.manager.getEntry(this.anchor.id) !== this.known.get(this.anchor.id));
-    }
-    appendedBranch(manager) {
-        if (manager.getEntry === undefined || manager.getLeafId === undefined) {
-            return undefined;
-        }
-        const entries = [];
-        const visited = new Set();
-        let id = manager.getLeafId();
-        while (id !== null && id !== "" && !this.known.has(id) && !visited.has(id)) {
-            visited.add(id);
-            const entry = manager.getEntry(id);
-            if (!entry) {
-                break;
-            }
-            entries.push(entry);
-            id = entry.parentId;
-        }
-        return { entries, tail: id };
-    }
-    appended(snapshot) {
-        if (snapshot.count === undefined) {
-            return undefined;
-        }
-        const branch = this.appendedBranch(snapshot.manager);
-        if (!branch) {
-            return undefined;
-        }
-        const { entries, tail } = branch;
-        const connects = tail === null || tail === "" || this.known.has(tail);
-        return snapshot.count === this.known.size + entries.length && connects
-            ? entries.reverse()
-            : undefined;
-    }
-    rescan(manager, reset) {
-        const all = manager.getEntries();
-        const added = all.filter((entry) => !this.known.has(entry.id));
-        const replaced = all.length !== this.known.size + added.length ||
-            all.some((entry) => this.known.has(entry.id) && this.known.get(entry.id) !== entry);
-        return { entries: reset || replaced ? all : added, reset: reset || replaced };
-    }
-    read(manager) {
-        const snapshot = {
-            manager,
-            sessionId: manager.getSessionId(),
-            file: manager.getSessionFile?.(),
-            count: manager.getEntryCount?.(),
-        };
-        const changed = this.changed(snapshot);
-        const appended = changed ? undefined : this.appended(snapshot);
-        const result = appended ? { entries: appended, reset: false } : this.rescan(manager, changed);
-        if (result.reset) {
-            this.known.clear();
-        }
-        for (const entry of result.entries) {
-            this.known.set(entry.id, entry);
-        }
-        this.anchor = result.entries.at(-1) ?? (result.reset ? undefined : this.anchor);
-        this.manager = manager;
-        this.sessionId = snapshot.sessionId;
-        this.file = snapshot.file;
-        return result;
-    }
-}

package/dist/shared/session-identity.js

@@ -1,16 +0,0 @@
-// Only delegation supplies this identity; Pi's ordinary fork/clone ancestry does not.
-export function resolveRootSessionId(sessionManager, env = process.env) {
-    const rootId = env.PI_SUBAGENT_CHILD === "1" ? env.PI_SUBAGENT_ROOT_SESSION_ID : undefined;
-    const sessionId = rootId !== undefined && rootId !== "" ? rootId : sessionManager.getSessionId();
-    if (sessionId === null || sessionId === undefined || sessionId === "") {
-        throw new Error("Root session identity is unavailable.");
-    }
-    return sessionId;
-}
-export function resolveCurrentSessionId(sessionManager) {
-    const sessionId = sessionManager.getSessionId();
-    if (sessionId === null || sessionId === undefined || sessionId === "") {
-        throw new Error("Current session identity is unavailable.");
-    }
-    return sessionId;
-}

package/dist/shared/settings.js

@@ -1,121 +0,0 @@
-/** Chain step traversal, behavior resolution, and instruction composition. */
-import * as path from "node:path";
-import { normalizeSkillInput } from "../agents/skills.js";
-export { createChainDir, removeChainDir, cleanupOldChainDirs, writeInitialProgressFile, } from "./chain-files.js";
-export { resolveTaskTextForFileUpdatePolicy, taskDisallowsFileUpdates, suppressProgressForReadOnlyTask, } from "./task-file-policy.js";
-export function isParallelStep(step) {
-    return "parallel" in step && Array.isArray(step.parallel);
-}
-export function isDynamicParallelStep(step) {
-    return ("expand" in step && "collect" in step && "parallel" in step && !Array.isArray(step.parallel));
-}
-export function getStepAgents(step) {
-    if (isParallelStep(step)) {
-        return step.parallel.map((task) => task.agent);
-    }
-    if (isDynamicParallelStep(step)) {
-        return [step.parallel.agent];
-    }
-    return [step.agent];
-}
-export function collectInvocationAgentNames(params) {
-    const names = [];
-    if (params.agent !== undefined && params.agent.length > 0) {
-        names.push(params.agent);
-    }
-    for (const task of params.tasks ?? []) {
-        names.push(task.agent);
-    }
-    for (const step of params.chain ?? []) {
-        names.push(...getStepAgents(step));
-    }
-    return names;
-}
-export function resolveChainTemplates(steps) {
-    return steps.map((step, index) => {
-        if (isParallelStep(step)) {
-            return step.parallel.map((task) => task.task !== undefined && task.task.length > 0 ? task.task : "{previous}");
-        }
-        if (isDynamicParallelStep(step)) {
-            return step.parallel.task ?? "{previous}";
-        }
-        if (step.task !== undefined && step.task.length > 0) {
-            return step.task;
-        }
-        return index === 0 ? "{task}" : "{previous}";
-    });
-}
-function normalizeOutputOverride(output) {
-    return output === "false" ? false : output;
-}
-function resolveStepSkills(agentSkills, overrideSkills, chainSkills) {
-    if (chainSkills === false || overrideSkills === false) {
-        return false;
-    }
-    const skills = [...(overrideSkills ?? agentSkills ?? [])];
-    return chainSkills !== undefined && chainSkills.length > 0
-        ? [...new Set([...skills, ...chainSkills])]
-        : skills;
-}
-/** Per-field precedence: step override, agent defaults, then disabled/unset. */
-export function resolveStepBehavior(agentConfig, stepOverrides, chainSkills) {
-    return {
-        output: normalizeOutputOverride(stepOverrides.output) ??
-            normalizeOutputOverride(agentConfig.output) ??
-            false,
-        outputMode: stepOverrides.outputMode ?? "inline",
-        reads: stepOverrides.reads ?? agentConfig.defaultReads ?? false,
-        progress: stepOverrides.progress ?? agentConfig.defaultProgress ?? false,
-        skills: resolveStepSkills(agentConfig.skills, stepOverrides.skills, chainSkills),
-        model: stepOverrides.model ?? agentConfig.model,
-    };
-}
-function resolveChainPath(filePath, chainDir) {
-    return path.isAbsolute(filePath) ? filePath : path.join(chainDir, filePath);
-}
-/** Compose read paths and progress instructions for a chain child. */
-export function buildChainInstructions(behavior, chainDir, isFirstProgressAgent) {
-    const prefixParts = [];
-    const suffixParts = [];
-    if (behavior.reads !== false && behavior.reads.length > 0) {
-        prefixParts.push(`[Read from: ${behavior.reads.map((file) => resolveChainPath(file, chainDir)).join(", ")}]`);
-    }
-    if (behavior.progress) {
-        const progressPath = path.join(chainDir, "progress.md");
-        suffixParts.push(isFirstProgressAgent
-            ? `Create and maintain progress at: ${progressPath}`
-            : `Update progress at: ${progressPath}`);
-    }
-    return {
-        prefix: prefixParts.length > 0 ? `${prefixParts.join("\n")}\n\n` : "",
-        suffix: suffixParts.length > 0 ? `\n\n---\n${suffixParts.join("\n")}` : "",
-    };
-}
-export function resolveParallelBehaviors(tasks, agentConfigs, stepIndex, chainSkills) {
-    return tasks.map((task, taskIndex) => {
-        const config = agentConfigs.find((agent) => agent.name === task.agent);
-        if (config === undefined) {
-            throw new Error(`Unknown agent: ${task.agent}`);
-        }
-        const behavior = resolveStepBehavior(config, {
-            output: task.output,
-            outputMode: task.outputMode,
-            reads: task.reads,
-            progress: task.progress,
-            skills: normalizeSkillInput(task.skill),
-            model: task.model,
-        }, chainSkills);
-        return {
-            ...behavior,
-            output: namespaceParallelOutput(behavior.output, task.agent, stepIndex, taskIndex),
-        };
-    });
-}
-export function namespaceParallelOutput(output, agent, stepIndex, taskIndex) {
-    if (output === undefined || output === false || output.length === 0) {
-        return false;
-    }
-    return path.isAbsolute(output)
-        ? output
-        : path.join(`parallel-${stepIndex}`, `${taskIndex}-${agent}`, output);
-}