@fitchmultz/pi-subagents 0.49.0 → 0.50.0

package/dist/agents/builtin-overrides.js

@@ -1,218 +0,0 @@
-import { isConfigObject, readSettingsFileStrict, splitToolList, } from "./config-values.js";
-export const EMPTY_SUBAGENT_SETTINGS = { overrides: {} };
-function invalidField(meta, field, expected) {
-    throw new Error(`Builtin override '${meta.name}' in '${meta.filePath}' has invalid '${field}'; expected ${expected}.`);
-}
-function stringOrFalse(input, field, meta) {
-    if (!(field in input)) {
-        return undefined;
-    }
-    const value = input[field];
-    if (typeof value === "string" || value === false) {
-        return value;
-    }
-    return invalidField(meta, field, "a string or false");
-}
-function booleanField(input, field, meta) {
-    if (!(field in input)) {
-        return undefined;
-    }
-    const value = input[field];
-    return typeof value === "boolean" ? value : invalidField(meta, field, "a boolean");
-}
-function limitField(input, field, meta) {
-    if (!(field in input)) {
-        return undefined;
-    }
-    const value = input[field];
-    if (value === false || (typeof value === "number" && Number.isInteger(value) && value >= 1)) {
-        return value;
-    }
-    return invalidField(meta, field, "an integer >= 1 or false");
-}
-function arrayField(input, field, meta) {
-    const value = input[field];
-    if (value === undefined || value === false) {
-        return value;
-    }
-    if (!Array.isArray(value)) {
-        return invalidField(meta, field, "an array of strings or false");
-    }
-    const items = [];
-    for (const item of value) {
-        if (typeof item !== "string") {
-            return invalidField(meta, field, "an array of strings or false");
-        }
-        const trimmed = item.trim();
-        if (trimmed.length > 0) {
-            items.push(trimmed);
-        }
-    }
-    return items;
-}
-function promptMode(input, meta) {
-    if (!("systemPromptMode" in input)) {
-        return undefined;
-    }
-    const value = input.systemPromptMode;
-    return value === "append" || value === "replace"
-        ? value
-        : invalidField(meta, "systemPromptMode", "'append' or 'replace'");
-}
-function defaultContext(input, meta) {
-    if (!("defaultContext" in input)) {
-        return undefined;
-    }
-    const value = input.defaultContext;
-    if (value === "fresh" || value === "fork" || value === false) {
-        return value;
-    }
-    return invalidField(meta, "defaultContext", "'fresh', 'fork', or false");
-}
-function systemPrompt(input, meta) {
-    if (!("systemPrompt" in input)) {
-        return undefined;
-    }
-    const value = input.systemPrompt;
-    return typeof value === "string" ? value : invalidField(meta, "systemPrompt", "a string");
-}
-function parseOverride(name, value, filePath) {
-    if (!isConfigObject(value)) {
-        throw new Error(`Builtin override '${name}' in '${filePath}' must be an object.`);
-    }
-    const meta = { name, filePath };
-    const override = {
-        model: stringOrFalse(value, "model", meta),
-        thinking: stringOrFalse(value, "thinking", meta),
-        systemPromptMode: promptMode(value, meta),
-        inheritProjectContext: booleanField(value, "inheritProjectContext", meta),
-        inheritSkills: booleanField(value, "inheritSkills", meta),
-        defaultContext: defaultContext(value, meta),
-        disabled: booleanField(value, "disabled", meta),
-        allowSubagents: booleanField(value, "allowSubagents", meta),
-        maxExecutionTimeMs: limitField(value, "maxExecutionTimeMs", meta),
-        maxTokens: limitField(value, "maxTokens", meta),
-        completionGuard: booleanField(value, "completionGuard", meta),
-        systemPrompt: systemPrompt(value, meta),
-        fallbackModels: arrayField(value, "fallbackModels", meta),
-        skills: arrayField(value, "skills", meta),
-        tools: arrayField(value, "tools", meta),
-    };
-    return Object.values(override).some((entry) => entry !== undefined) ? override : undefined;
-}
-export function readSubagentSettings(filePath) {
-    if (filePath === null) {
-        return EMPTY_SUBAGENT_SETTINGS;
-    }
-    const subagents = readSettingsFileStrict(filePath).subagents;
-    if (!isConfigObject(subagents)) {
-        return EMPTY_SUBAGENT_SETTINGS;
-    }
-    if ("disableBuiltins" in subagents && typeof subagents.disableBuiltins !== "boolean") {
-        throw new Error(`Subagent settings in '${filePath}' have invalid 'disableBuiltins'; expected a boolean.`);
-    }
-    const disableBuiltins = typeof subagents.disableBuiltins === "boolean" ? subagents.disableBuiltins : undefined;
-    const overrides = {};
-    if (isConfigObject(subagents.agentOverrides)) {
-        for (const [name, value] of Object.entries(subagents.agentOverrides)) {
-            const override = parseOverride(name, value, filePath);
-            if (override !== undefined) {
-                overrides[name] = override;
-            }
-        }
-    }
-    return { overrides, disableBuiltins };
-}
-function cleared(value) {
-    return value === false ? undefined : value;
-}
-function modelOverrides(override) {
-    const patch = {};
-    if (override.model !== undefined) {
-        patch.model = cleared(override.model);
-    }
-    if (override.fallbackModels !== undefined) {
-        patch.fallbackModels =
-            override.fallbackModels === false ? undefined : [...override.fallbackModels];
-    }
-    if (override.thinking !== undefined) {
-        patch.thinking = cleared(override.thinking);
-    }
-    return patch;
-}
-function promptOverrides(override) {
-    const patch = {};
-    if (override.systemPromptMode !== undefined) {
-        patch.systemPromptMode = override.systemPromptMode;
-    }
-    if (override.inheritProjectContext !== undefined) {
-        patch.inheritProjectContext = override.inheritProjectContext;
-    }
-    if (override.inheritSkills !== undefined) {
-        patch.inheritSkills = override.inheritSkills;
-    }
-    if (override.defaultContext !== undefined) {
-        patch.defaultContext = cleared(override.defaultContext);
-    }
-    if (override.systemPrompt !== undefined) {
-        patch.systemPrompt = override.systemPrompt;
-    }
-    return patch;
-}
-function resourceOverrides(override) {
-    const patch = {};
-    if (override.disabled !== undefined) {
-        patch.disabled = override.disabled;
-    }
-    if (override.skills !== undefined) {
-        patch.skills = override.skills === false ? undefined : [...override.skills];
-    }
-    if (override.tools !== undefined) {
-        const { tools, mcpDirectTools } = splitToolList(override.tools === false ? [] : override.tools);
-        patch.tools = tools;
-        patch.mcpDirectTools = mcpDirectTools;
-    }
-    if (override.allowSubagents !== undefined) {
-        patch.allowSubagents = override.allowSubagents;
-    }
-    if (override.maxExecutionTimeMs !== undefined) {
-        patch.maxExecutionTimeMs = cleared(override.maxExecutionTimeMs);
-    }
-    if (override.maxTokens !== undefined) {
-        patch.maxTokens = cleared(override.maxTokens);
-    }
-    if (override.completionGuard !== undefined) {
-        patch.completionGuard = override.completionGuard;
-    }
-    return patch;
-}
-function applyBuiltinOverride(agent, override) {
-    return {
-        ...agent,
-        ...modelOverrides(override),
-        ...promptOverrides(override),
-        ...resourceOverrides(override),
-    };
-}
-export function applyBuiltinOverrides(builtinAgents, userSettings, projectSettings, projectSettingsPath) {
-    return builtinAgents.map((agent) => {
-        const userOverride = userSettings.overrides[agent.name];
-        let next = agent;
-        if (userOverride !== undefined) {
-            next = applyBuiltinOverride(agent, userOverride);
-        }
-        else if (userSettings.disableBuiltins === true) {
-            next = { ...agent, disabled: true };
-        }
-        if (projectSettingsPath !== null) {
-            const projectOverride = projectSettings.overrides[agent.name];
-            if (projectOverride !== undefined) {
-                next = applyBuiltinOverride({ ...next, disabled: false }, projectOverride);
-            }
-            else if (projectSettings.disableBuiltins !== undefined) {
-                next = { ...next, disabled: projectSettings.disableBuiltins };
-            }
-        }
-        return next;
-    });
-}

package/dist/agents/chain-serializer.js

@@ -1,3 +0,0 @@
-/** Saved chain format compatibility entry points. */
-export { parseChain, serializeChain } from "./markdown-chain.js";
-export { parseJsonChain, serializeJsonChain } from "./json-chain.js";

package/dist/agents/config-values.js

@@ -1,52 +0,0 @@
-import * as fs from "node:fs";
-import { errorMessage, isRecord as isConfigObject } from "../shared/unknown.js";
-export { errorMessage, isRecord as isConfigObject } from "../shared/unknown.js";
-export function readSettingsFileStrict(filePath) {
-    if (!fs.existsSync(filePath)) {
-        return {};
-    }
-    let raw;
-    try {
-        raw = fs.readFileSync(filePath, "utf-8");
-    }
-    catch (error) {
-        throw new Error(`Failed to read settings file '${filePath}': ${errorMessage(error)}`, {
-            cause: error,
-        });
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch (error) {
-        throw new Error(`Failed to parse settings file '${filePath}': ${errorMessage(error)}`, {
-            cause: error,
-        });
-    }
-    if (!isConfigObject(parsed)) {
-        throw new Error(`Settings file '${filePath}' must contain a JSON object.`);
-    }
-    return parsed;
-}
-export function csvItems(value) {
-    return value
-        .split(",")
-        .map((item) => item.trim())
-        .filter((item) => item.length > 0);
-}
-export function splitToolList(rawTools) {
-    const mcpDirectTools = [];
-    const tools = [];
-    for (const tool of rawTools ?? []) {
-        if (tool.startsWith("mcp:")) {
-            mcpDirectTools.push(tool.slice(4));
-        }
-        else {
-            tools.push(tool);
-        }
-    }
-    return {
-        ...(tools.length > 0 ? { tools } : {}),
-        ...(mcpDirectTools.length > 0 ? { mcpDirectTools } : {}),
-    };
-}

package/dist/agents/discovery-paths.js

@@ -1,91 +0,0 @@
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import { getAgentDir } from "../shared/agent-dir.js";
-export function isDirectory(filePath) {
-    try {
-        return fs.statSync(filePath).isDirectory();
-    }
-    catch {
-        return false;
-    }
-}
-function hasProjectResources(dir) {
-    const piDir = path.join(dir, ".pi");
-    return (fs.existsSync(path.join(piDir, "settings.json")) ||
-        isDirectory(path.join(piDir, "agents")) ||
-        isDirectory(path.join(piDir, "chains")));
-}
-export function findNearestProjectRoot(cwd) {
-    let currentDir = cwd;
-    const homeDir = path.resolve(os.homedir());
-    const startedAtHome = path.resolve(cwd) === homeDir;
-    while (true) {
-        const resolvedCurrent = path.resolve(currentDir);
-        // Home configuration is project input only when discovery starts at home.
-        if (resolvedCurrent === homeDir && !startedAtHome) {
-            return null;
-        }
-        if (hasProjectResources(currentDir) ||
-            (resolvedCurrent !== homeDir && isDirectory(path.join(currentDir, ".agents")))) {
-            return currentDir;
-        }
-        const parentDir = path.dirname(currentDir);
-        if (parentDir === currentDir) {
-            return null;
-        }
-        currentDir = parentDir;
-    }
-}
-export function getUserAgentSettingsPath() {
-    return path.join(getAgentDir(), "settings.json");
-}
-export function getProjectAgentSettingsPath(cwd, options = {}) {
-    if (options.projectTrusted === false) {
-        return null;
-    }
-    const root = findNearestProjectRoot(cwd);
-    return root === null ? null : path.join(root, ".pi", "settings.json");
-}
-export function resolveNearestProjectAgentDirs(cwd, options = {}) {
-    const root = options.projectTrusted === false ? null : findNearestProjectRoot(cwd);
-    if (root === null) {
-        return { readDirs: [], preferredDir: null };
-    }
-    const legacyDir = path.join(root, ".agents");
-    const preferredDir = path.join(root, ".pi", "agents");
-    return { readDirs: [legacyDir, preferredDir].filter(isDirectory), preferredDir };
-}
-export function resolveNearestProjectChainDirs(cwd, options = {}) {
-    const root = options.projectTrusted === false ? null : findNearestProjectRoot(cwd);
-    if (root === null) {
-        return { readDirs: [], preferredDir: null };
-    }
-    const preferredDir = path.join(root, ".pi", "chains");
-    return { readDirs: isDirectory(preferredDir) ? [preferredDir] : [], preferredDir };
-}
-export function pathIsInside(dir, filePath) {
-    const relative = path.relative(dir, filePath);
-    return (relative !== "" &&
-        relative !== ".." &&
-        !relative.startsWith(`..${path.sep}`) &&
-        !path.isAbsolute(relative));
-}
-export function listFilesRecursive(dir, predicate) {
-    let entries;
-    try {
-        entries = fs
-            .readdirSync(dir, { withFileTypes: true })
-            .sort((a, b) => a.name.localeCompare(b.name));
-    }
-    catch {
-        return [];
-    }
-    return entries.flatMap((entry) => {
-        const filePath = path.join(dir, entry.name);
-        if (entry.isDirectory()) {
-            return entry.name.startsWith(".") ? [] : listFilesRecursive(filePath, predicate);
-        }
-        return (entry.isFile() || entry.isSymbolicLink()) && predicate(entry.name) ? [filePath] : [];
-    });
-}

package/dist/agents/frontmatter.js

@@ -1,31 +0,0 @@
-export function parseFrontmatter(content) {
-    const frontmatter = {};
-    const normalized = content.replace(/\r\n/g, "\n");
-    const lines = normalized.split("\n");
-    if (!/^---\s*$/.test(lines[0] ?? "")) {
-        return { frontmatter, body: normalized };
-    }
-    const endIndex = lines.findIndex((line, index) => index > 0 && /^---\s*$/.test(line));
-    if (endIndex === -1) {
-        return { frontmatter, body: normalized };
-    }
-    for (const line of lines.slice(1, endIndex)) {
-        const match = line.match(/^([\w-]+):\s*(.*)$/);
-        if (!match) {
-            continue;
-        }
-        let value = match[2].trim();
-        if ((value.startsWith('"') && value.endsWith('"')) ||
-            (value.startsWith("'") && value.endsWith("'"))) {
-            value = value.slice(1, -1);
-        }
-        frontmatter[match[1]] = value;
-    }
-    return {
-        frontmatter,
-        body: lines
-            .slice(endIndex + 1)
-            .join("\n")
-            .trim(),
-    };
-}

package/dist/agents/identity.js

@@ -1,46 +0,0 @@
-const IDENTIFIER_PATTERN = /^[a-z0-9][a-z0-9-]*(?:\.[a-z0-9][a-z0-9-]*)*$/;
-function normalizePackageName(value) {
-    const trimmed = value?.trim();
-    if (trimmed === undefined || trimmed.length === 0) {
-        return undefined;
-    }
-    return trimmed
-        .toLowerCase()
-        .replace(/\s+/g, "-")
-        .replace(/[^a-z0-9.-]/g, "")
-        .replace(/-+/g, "-")
-        .replace(/\.+/g, ".")
-        .replace(/(?:^[-.]+|[-.]+$)/g, "");
-}
-export function parsePackageName(value, label = "package") {
-    if (value === undefined || value === false || value === "") {
-        return { packageName: undefined };
-    }
-    if (typeof value !== "string") {
-        return { error: `${label} must be a string or false when provided.` };
-    }
-    const packageName = normalizePackageName(value);
-    if (packageName === undefined ||
-        packageName.length === 0 ||
-        !IDENTIFIER_PATTERN.test(packageName)) {
-        return { error: `${label} is invalid after sanitization.` };
-    }
-    return { packageName };
-}
-export function buildRuntimeName(localName, packageName) {
-    const trimmedPackage = packageName?.trim();
-    return trimmedPackage !== undefined && trimmedPackage.length > 0
-        ? `${trimmedPackage}.${localName}`
-        : localName;
-}
-export function frontmatterNameForConfig(config) {
-    if (config.localName !== undefined && config.localName.length > 0) {
-        return config.localName;
-    }
-    if (config.packageName !== undefined &&
-        config.packageName.length > 0 &&
-        config.name.startsWith(`${config.packageName}.`)) {
-        return config.name.slice(config.packageName.length + 1);
-    }
-    return config.name;
-}