@fitchmultz/pi-subagents 0.49.1 → 0.50.0

package/src/agents/agents.ts

@@ -1,214 +0,0 @@
-/** Agent and saved-chain discovery entry points. */
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import { fileURLToPath } from "node:url";
-import type { AgentConfig, AgentScope, ChainConfig } from "../shared/types/config.ts";
-export type {
-  AgentConfig,
-  AgentScope,
-  AgentSource,
-  AgentDefaultContext,
-  ChainConfig,
-  ChainStepConfig,
-} from "../shared/types/config.ts";
-import { getAgentDir } from "../shared/agent-dir.ts";
-import {
-  getUserAgentSettingsPath,
-  getProjectAgentSettingsPath,
-  resolveNearestProjectAgentDirs,
-  resolveNearestProjectChainDirs,
-  listFilesRecursive,
-  type ChainDiscoveryDiagnostic,
-  type AgentDiscoveryDiagnostic,
-  type DiscoveryOptions as AgentDiscoveryOptions,
-} from "./discovery-paths.ts";
-export type {
-  ChainDiscoveryDiagnostic,
-  AgentDiscoveryDiagnostic,
-  DiscoveryOptions as AgentDiscoveryOptions,
-} from "./discovery-paths.ts";
-import {
-  loadAgentsFromDir,
-  clearAgentDiagnosticsForDirs,
-  agentDiagnosticsForDir,
-} from "./agent-definition.ts";
-import {
-  EMPTY_SUBAGENT_SETTINGS,
-  readSubagentSettings,
-  applyBuiltinOverrides,
-} from "./builtin-overrides.ts";
-import { loadConfiguredPackageAgents } from "./package-agents.ts";
-import { parseChain, parseJsonChain } from "./chain-serializer.ts";
-import { mergeAgents } from "./agent-selection.ts";
-import { errorMessage } from "./config-values.ts";
-export { buildRuntimeName, frontmatterNameForConfig, parsePackageName } from "./identity.ts";
-
-export {
-  defaultSystemPromptMode,
-  defaultInheritProjectContext,
-  defaultInheritSkills,
-} from "./agent-defaults.ts";
-
-const BUILTIN_AGENTS_DIR = path.resolve(
-  path.dirname(fileURLToPath(import.meta.url)),
-  "..",
-  "..",
-  "agents",
-);
-interface ProfilePaths {
-  readonly userDirs: readonly string[];
-  readonly projectDirs: readonly string[];
-  readonly projectDir: string | null;
-  readonly userSettingsPath: string;
-  readonly projectSettingsPath: string | null;
-}
-function profilePaths(cwd: string, options: AgentDiscoveryOptions): ProfilePaths {
-  const project = resolveNearestProjectAgentDirs(cwd, options);
-  return {
-    userDirs: [path.join(getAgentDir(), "agents"), path.join(os.homedir(), ".agents")],
-    projectDirs: project.readDirs,
-    projectDir: project.preferredDir,
-    userSettingsPath: getUserAgentSettingsPath(),
-    projectSettingsPath: getProjectAgentSettingsPath(cwd, options),
-  };
-}
-function discoverLocalProfiles(
-  paths: ProfilePaths,
-  scope: AgentScope,
-): { builtin: AgentConfig[]; user: AgentConfig[]; project: AgentConfig[] } {
-  const userSettings =
-    scope === "project" ? EMPTY_SUBAGENT_SETTINGS : readSubagentSettings(paths.userSettingsPath);
-  const projectSettings =
-    scope === "user" ? EMPTY_SUBAGENT_SETTINGS : readSubagentSettings(paths.projectSettingsPath);
-  const userDirs = scope === "project" ? [] : paths.userDirs;
-  const projectDirs = scope === "user" ? [] : paths.projectDirs;
-  clearAgentDiagnosticsForDirs([...userDirs, ...projectDirs]);
-  const builtin = applyBuiltinOverrides(
-    loadAgentsFromDir(BUILTIN_AGENTS_DIR, "builtin"),
-    userSettings,
-    projectSettings,
-    paths.projectSettingsPath,
-  );
-  return {
-    builtin,
-    user: userDirs.flatMap((dir) => loadAgentsFromDir(dir, "user")),
-    project: projectDirs.flatMap((dir) => loadAgentsFromDir(dir, "project")),
-  };
-}
-function loadChainsFromDir(
-  dir: string,
-  source: "user" | "project",
-): { chains: ChainConfig[]; diagnostics: ChainDiscoveryDiagnostic[] } {
-  const chains: ChainConfig[] = [];
-  const diagnostics: ChainDiscoveryDiagnostic[] = [];
-  for (const filePath of listFilesRecursive(
-    dir,
-    (name) => name.endsWith(".chain.md") || name.endsWith(".chain.json"),
-  )) {
-    let content: string;
-    try {
-      content = fs.readFileSync(filePath, "utf-8");
-    } catch {
-      continue;
-    }
-    try {
-      chains.push(
-        filePath.endsWith(".chain.json")
-          ? parseJsonChain(content, source, filePath)
-          : parseChain(content, source, filePath),
-      );
-    } catch (error) {
-      diagnostics.push({ source, filePath, error: errorMessage(error) });
-    }
-  }
-  return { chains, diagnostics };
-}
-export function discoverChains(
-  cwd: string,
-  options: AgentDiscoveryOptions = {},
-  scope: AgentScope = "both",
-): {
-  chains: ChainConfig[];
-  chainDiagnostics: ChainDiscoveryDiagnostic[];
-  userChainDir: string;
-  projectChainDir: string | null;
-} {
-  const userChainDir = path.join(getAgentDir(), "chains");
-  const project = resolveNearestProjectChainDirs(cwd, options);
-  const projectChains = (scope === "user" ? [] : project.readDirs).map((dir) =>
-    loadChainsFromDir(dir, "project"),
-  );
-  const userChains =
-    scope === "project" ? { chains: [], diagnostics: [] } : loadChainsFromDir(userChainDir, "user");
-  return {
-    userChainDir,
-    projectChainDir: project.preferredDir,
-    chains: [...userChains.chains, ...projectChains.flatMap((entry) => entry.chains)],
-    chainDiagnostics: [
-      ...userChains.diagnostics,
-      ...projectChains.flatMap((entry) => entry.diagnostics),
-    ],
-  };
-}
-function localDiagnostics(paths: ProfilePaths, scope: AgentScope): AgentDiscoveryDiagnostic[] {
-  return [
-    ...(scope === "project" ? [] : paths.userDirs).flatMap((dir) =>
-      agentDiagnosticsForDir(dir, "user"),
-    ),
-    ...(scope === "user" ? [] : paths.projectDirs).flatMap((dir) =>
-      agentDiagnosticsForDir(dir, "project"),
-    ),
-  ];
-}
-export function discoverAgents(
-  cwd: string,
-  scope: AgentScope,
-  options: AgentDiscoveryOptions = {},
-): { agents: AgentConfig[]; projectAgentsDir: string | null } {
-  const paths = profilePaths(cwd, options);
-  const profiles = discoverLocalProfiles(paths, scope);
-  const packages = loadConfiguredPackageAgents(cwd, scope, options);
-  const agents = mergeAgents(profiles.user, profiles.project, [
-    ...profiles.builtin,
-    ...packages.agents,
-  ]).filter((agent) => agent.disabled !== true);
-  return { agents, projectAgentsDir: paths.projectDir };
-}
-export function discoverAgentsAll(
-  cwd: string,
-  options: AgentDiscoveryOptions = {},
-  scope: AgentScope = "both",
-): {
-  builtin: AgentConfig[];
-  package: AgentConfig[];
-  user: AgentConfig[];
-  project: AgentConfig[];
-  chains: ChainConfig[];
-  chainDiagnostics: ChainDiscoveryDiagnostic[];
-  agentDiagnostics: AgentDiscoveryDiagnostic[];
-  userDir: string;
-  projectDir: string | null;
-  userChainDir: string;
-  projectChainDir: string | null;
-  userSettingsPath: string;
-  projectSettingsPath: string | null;
-} {
-  const paths = profilePaths(cwd, options);
-  const profiles = discoverLocalProfiles(paths, scope);
-  const chains = discoverChains(cwd, options, scope);
-  const packages = loadConfiguredPackageAgents(cwd, scope, options);
-  return {
-    ...profiles,
-    package: packages.agents,
-    ...chains,
-    agentDiagnostics: [
-      ...localDiagnostics(paths, scope),
-      ...packages.dirs.flatMap((dir) => agentDiagnosticsForDir(dir, "package")),
-    ],
-    userDir: paths.userDirs.at(0) ?? path.join(getAgentDir(), "agents"),
-    projectDir: paths.projectDir,
-    userSettingsPath: paths.userSettingsPath,
-    projectSettingsPath: paths.projectSettingsPath,
-  };
-}

package/src/agents/builtin-overrides.ts

@@ -1,297 +0,0 @@
-import type { Writable } from "type-fest";
-import type { AgentConfig } from "../shared/types/config.ts";
-import {
-  isConfigObject,
-  readSettingsFileStrict,
-  splitToolList,
-  type ConfigObject,
-} from "./config-values.ts";
-
-interface BuiltinAgentOverrideConfig {
-  readonly model?: string | false;
-  readonly fallbackModels?: readonly string[] | false;
-  readonly thinking?: string | false;
-  readonly systemPromptMode?: "append" | "replace";
-  readonly inheritProjectContext?: boolean;
-  readonly inheritSkills?: boolean;
-  readonly defaultContext?: "fresh" | "fork" | false;
-  readonly disabled?: boolean;
-  readonly systemPrompt?: string;
-  readonly skills?: readonly string[] | false;
-  readonly tools?: readonly string[] | false;
-  readonly allowSubagents?: boolean;
-  readonly maxExecutionTimeMs?: number | false;
-  readonly maxTokens?: number | false;
-  readonly completionGuard?: boolean;
-}
-
-interface SubagentSettings {
-  readonly overrides: Readonly<Partial<Record<string, BuiltinAgentOverrideConfig>>>;
-  readonly disableBuiltins?: boolean;
-}
-
-export const EMPTY_SUBAGENT_SETTINGS: SubagentSettings = { overrides: {} };
-
-type OverrideMeta = { readonly name: string; readonly filePath: string };
-
-function invalidField(meta: OverrideMeta, field: string, expected: string): never {
-  throw new Error(
-    `Builtin override '${meta.name}' in '${meta.filePath}' has invalid '${field}'; expected ${expected}.`,
-  );
-}
-
-function stringOrFalse(
-  input: ConfigObject,
-  field: string,
-  meta: OverrideMeta,
-): string | false | undefined {
-  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: ConfigObject, field: string, meta: OverrideMeta): boolean | undefined {
-  if (!(field in input)) {
-    return undefined;
-  }
-  const value = input[field];
-  return typeof value === "boolean" ? value : invalidField(meta, field, "a boolean");
-}
-
-function limitField(
-  input: ConfigObject,
-  field: string,
-  meta: OverrideMeta,
-): number | false | undefined {
-  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: ConfigObject,
-  field: string,
-  meta: OverrideMeta,
-): string[] | false | undefined {
-  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: string[] = [];
-  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: ConfigObject, meta: OverrideMeta): "append" | "replace" | undefined {
-  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: ConfigObject,
-  meta: OverrideMeta,
-): "fresh" | "fork" | false | undefined {
-  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: ConfigObject, meta: OverrideMeta): string | undefined {
-  if (!("systemPrompt" in input)) {
-    return undefined;
-  }
-  const value = input.systemPrompt;
-  return typeof value === "string" ? value : invalidField(meta, "systemPrompt", "a string");
-}
-
-function parseOverride(
-  name: string,
-  value: unknown,
-  filePath: string,
-): BuiltinAgentOverrideConfig | undefined {
-  if (!isConfigObject(value)) {
-    throw new Error(`Builtin override '${name}' in '${filePath}' must be an object.`);
-  }
-  const meta = { name, filePath };
-  const override: BuiltinAgentOverrideConfig = {
-    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: string | null): SubagentSettings {
-  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: Record<string, BuiltinAgentOverrideConfig> = {};
-  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<T>(value: T | false): T | undefined {
-  return value === false ? undefined : value;
-}
-
-function modelOverrides(override: BuiltinAgentOverrideConfig): Partial<Writable<AgentConfig>> {
-  const patch: Partial<Writable<AgentConfig>> = {};
-  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: BuiltinAgentOverrideConfig): Partial<Writable<AgentConfig>> {
-  const patch: Partial<Writable<AgentConfig>> = {};
-  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: BuiltinAgentOverrideConfig): Partial<Writable<AgentConfig>> {
-  const patch: Partial<Writable<AgentConfig>> = {};
-  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: AgentConfig,
-  override: BuiltinAgentOverrideConfig,
-): AgentConfig {
-  return {
-    ...agent,
-    ...modelOverrides(override),
-    ...promptOverrides(override),
-    ...resourceOverrides(override),
-  };
-}
-
-export function applyBuiltinOverrides(
-  builtinAgents: readonly AgentConfig[],
-  userSettings: SubagentSettings,
-  projectSettings: SubagentSettings,
-  projectSettingsPath: string | null,
-): AgentConfig[] {
-  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/src/agents/chain-serializer.ts

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

package/src/agents/config-values.ts

@@ -1,57 +0,0 @@
-import * as fs from "node:fs";
-
-import { errorMessage, isRecord as isConfigObject, type UnknownRecord } from "../shared/unknown.ts";
-export { errorMessage, isRecord as isConfigObject } from "../shared/unknown.ts";
-export type ConfigObject = UnknownRecord;
-
-export function readSettingsFileStrict(filePath: string): ConfigObject {
-  if (!fs.existsSync(filePath)) {
-    return {};
-  }
-  let raw: string;
-  try {
-    raw = fs.readFileSync(filePath, "utf-8");
-  } catch (error) {
-    throw new Error(`Failed to read settings file '${filePath}': ${errorMessage(error)}`, {
-      cause: error,
-    });
-  }
-  let parsed: unknown;
-  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: string): string[] {
-  return value
-    .split(",")
-    .map((item) => item.trim())
-    .filter((item) => item.length > 0);
-}
-
-export function splitToolList(rawTools: readonly string[] | undefined): {
-  tools?: string[];
-  mcpDirectTools?: string[];
-} {
-  const mcpDirectTools: string[] = [];
-  const tools: string[] = [];
-  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/src/agents/discovery-paths.ts

@@ -1,134 +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.ts";
-
-export interface ChainDiscoveryDiagnostic {
-  readonly source: "user" | "project";
-  readonly filePath: string;
-  readonly error: string;
-}
-export interface AgentDiscoveryDiagnostic extends Omit<ChainDiscoveryDiagnostic, "source"> {
-  readonly source: "user" | "project" | "package";
-}
-export interface DiscoveryOptions {
-  readonly projectTrusted?: boolean;
-}
-
-export function isDirectory(filePath: string): boolean {
-  try {
-    return fs.statSync(filePath).isDirectory();
-  } catch {
-    return false;
-  }
-}
-
-function hasProjectResources(dir: string): boolean {
-  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: string): string | null {
-  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(): string {
-  return path.join(getAgentDir(), "settings.json");
-}
-
-export function getProjectAgentSettingsPath(
-  cwd: string,
-  options: DiscoveryOptions = {},
-): string | null {
-  if (options.projectTrusted === false) {
-    return null;
-  }
-  const root = findNearestProjectRoot(cwd);
-  return root === null ? null : path.join(root, ".pi", "settings.json");
-}
-
-export function resolveNearestProjectAgentDirs(
-  cwd: string,
-  options: DiscoveryOptions = {},
-): {
-  readDirs: string[];
-  preferredDir: string | null;
-} {
-  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: string,
-  options: DiscoveryOptions = {},
-): {
-  readDirs: string[];
-  preferredDir: string | null;
-} {
-  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: string, filePath: string): boolean {
-  const relative = path.relative(dir, filePath);
-  return (
-    relative !== "" &&
-    relative !== ".." &&
-    !relative.startsWith(`..${path.sep}`) &&
-    !path.isAbsolute(relative)
-  );
-}
-
-export function listFilesRecursive(
-  dir: string,
-  predicate: (fileName: string) => boolean,
-): string[] {
-  let entries: fs.Dirent[];
-  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] : [];
-  });
-}