@herbertgao/pi-extensions 2026.9.17 → 2026.9.18

package/node_modules/pi-mcp-adapter/bearer-command-resolver.ts

@@ -1,193 +0,0 @@
-import { spawn } from "node:child_process";
-
-const DEFAULT_TTL_MS = 5 * 60_000;
-const ENV_TTL_MS = "PI_MCP_ADAPTER_BEARER_COMMAND_TTL_MS";
-const COMMAND_TIMEOUT_MS = 10_000;
-const COMMAND_MAX_OUTPUT_BYTES = 1024 * 1024;
-const USE_PROCESS_GROUP = process.platform !== "win32";
-
-function resolveDefaultTtlMs(): number {
-  const parsed = Number(process.env[ENV_TTL_MS] || DEFAULT_TTL_MS);
-  return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : DEFAULT_TTL_MS;
-}
-
-function abortReason(signal: AbortSignal): unknown {
-  return signal.reason ?? new DOMException("The operation was aborted", "AbortError");
-}
-
-function runCommand(command: string, context: string, signal: AbortSignal): Promise<string> {
-  return new Promise((resolve, reject) => {
-    let output = Buffer.alloc(0);
-    let settled = false;
-    let terminating = false;
-    const child = spawn(command.slice(1), {
-      shell: true,
-      stdio: ["ignore", "pipe", "ignore"],
-      windowsHide: true,
-      detached: USE_PROCESS_GROUP,
-    });
-
-    const kill = async (): Promise<void> => {
-      if (child.pid === undefined) return;
-      if (!USE_PROCESS_GROUP) {
-        await new Promise<void>((resolveKill, rejectKill) => {
-          const killer = spawn("taskkill", ["/pid", String(child.pid), "/T", "/F"], {
-            stdio: "ignore",
-            windowsHide: true,
-          });
-          killer.on("error", () => rejectKill(new Error("Failed to stop bearer token command")));
-          killer.on("close", code => {
-            if (code === 0 || code === 128) resolveKill();
-            else rejectKill(new Error(`Failed to stop bearer token command: taskkill exited with code ${code ?? "unknown"}`));
-          });
-        });
-        return;
-      }
-      try {
-        process.kill(-child.pid, "SIGKILL");
-      } catch (error) {
-        if ((error as NodeJS.ErrnoException).code !== "ESRCH") throw error;
-      }
-    };
-    const finish = (error: unknown, token?: string) => {
-      if (settled) return;
-      settled = true;
-      clearTimeout(timer);
-      signal.removeEventListener("abort", onAbort);
-      if (error !== undefined) reject(error);
-      else resolve(token!);
-    };
-    const terminate = async (error: unknown) => {
-      if (settled || terminating) return;
-      terminating = true;
-      clearTimeout(timer);
-      signal.removeEventListener("abort", onAbort);
-      try {
-        await kill();
-        finish(error);
-      } catch (cleanupError) {
-        finish(cleanupError);
-      }
-    };
-    const onAbort = () => {
-      void terminate(abortReason(signal));
-    };
-    const timer = setTimeout(() => {
-      void terminate(new Error(`Failed to resolve ${context}: command timed out after ${COMMAND_TIMEOUT_MS}ms`));
-    }, COMMAND_TIMEOUT_MS);
-
-    signal.addEventListener("abort", onAbort, { once: true });
-    if (signal.aborted) {
-      onAbort();
-      return;
-    }
-    child.on("error", () => {
-      if (!terminating) finish(new Error(`Failed to resolve ${context}: command failed to start`));
-    });
-    child.stdout.on("data", (chunk: Buffer | string) => {
-      if (settled || terminating) return;
-      output = Buffer.concat([output, Buffer.from(chunk)]);
-      if (output.byteLength > COMMAND_MAX_OUTPUT_BYTES) {
-        void terminate(new Error(`Failed to resolve ${context}: command output exceeded 1 MiB`));
-      }
-    });
-    child.on("close", code => {
-      if (settled || terminating) return;
-      if (code !== 0) {
-        finish(new Error(`Failed to resolve ${context}: command exited with code ${code ?? "unknown"}`));
-        return;
-      }
-      const token = output.toString("utf8").trim();
-      if (!token) {
-        finish(new Error(`Failed to resolve ${context}: command returned empty output`));
-        return;
-      }
-      finish(undefined, token);
-    });
-  });
-}
-
-type Inflight = {
-  controller: AbortController;
-  promise: Promise<string>;
-  waiters: number;
-};
-
-/** Resolve and periodically refresh one command-backed bearer token. */
-export class BearerCommandResolver {
-  readonly #command: string;
-  readonly #context: string;
-  readonly #ttlMs: number;
-  #cached: { token: string; expiresAt: number } | undefined;
-  #failure: { error: unknown; retryAt: number } | undefined;
-  #inflight: Inflight | undefined;
-
-  constructor(command: string, context: string, ttlMs: number = resolveDefaultTtlMs()) {
-    this.#command = command;
-    this.#context = context;
-    this.#ttlMs = ttlMs;
-  }
-
-  resolve(signal?: AbortSignal): Promise<string> {
-    if (signal?.aborted) return Promise.reject(abortReason(signal));
-    const now = Date.now();
-    if (this.#cached !== undefined && now < this.#cached.expiresAt) {
-      return Promise.resolve(this.#cached.token);
-    }
-    if (this.#failure !== undefined && now < this.#failure.retryAt) {
-      return this.#cached !== undefined
-        ? Promise.resolve(this.#cached.token)
-        : Promise.reject(this.#failure.error);
-    }
-
-    let inflight = this.#inflight;
-    if (inflight === undefined) {
-      const controller = new AbortController();
-      let current: Inflight;
-      const promise = runCommand(this.#command, this.#context, controller.signal)
-        .then(token => {
-          this.#cached = { token, expiresAt: Date.now() + this.#ttlMs };
-          this.#failure = undefined;
-          return token;
-        })
-        .catch(error => {
-          // Request cancellation is not a helper outage. Do not let one
-          // cancelled request suppress refresh attempts for the next caller.
-          if (!controller.signal.aborted) {
-            this.#failure = { error, retryAt: Date.now() + this.#ttlMs };
-          }
-          if (this.#cached !== undefined) return this.#cached.token;
-          throw error;
-        })
-        .finally(() => {
-          if (this.#inflight === current) this.#inflight = undefined;
-        });
-      current = { controller, promise, waiters: 0 };
-      this.#inflight = current;
-      inflight = current;
-    }
-    return this.#wait(inflight, signal);
-  }
-
-  #wait(inflight: Inflight, signal?: AbortSignal): Promise<string> {
-    inflight.waiters++;
-    let onAbort: (() => void) | undefined;
-    const result = signal === undefined
-      ? inflight.promise
-      : Promise.race([
-          inflight.promise,
-          new Promise<string>((_resolve, reject) => {
-            onAbort = () => reject(abortReason(signal));
-            signal.addEventListener("abort", onAbort, { once: true });
-          }),
-        ]);
-    return result.finally(() => {
-      if (onAbort) signal!.removeEventListener("abort", onAbort);
-      inflight.waiters--;
-      if (this.#inflight === inflight && inflight.waiters === 0) {
-        this.#inflight = undefined;
-        inflight.controller.abort(signal?.reason);
-      }
-    });
-  }
-}

package/node_modules/pi-mcp-adapter/claude-plugin-loader.ts

@@ -1,365 +0,0 @@
-import { closeSync, constants, existsSync, fstatSync, openSync, readFileSync, readdirSync, realpathSync, statSync, type Dirent, type Stats } from "node:fs";
-import { basename, isAbsolute, relative, resolve, sep } from "node:path";
-import { formatServerNamespace, type ClaudePluginConfig, type McpConfig, type ServerEntry } from "./types.ts";
-import { parseJsonWithComments } from "./utils.ts";
-
-interface ClaudePluginManifest {
-  name: string;
-}
-
-export interface ClaudePluginBundleResult {
-  mcpServers: Record<string, ServerEntry>;
-  skillPaths: string[];
-}
-
-export function loadClaudePluginBundles(
-  plugins: readonly ClaudePluginConfig[] | undefined,
-  cwd: string,
-  validateConfig: (raw: unknown) => McpConfig,
-  components: { mcp: boolean; skills: boolean },
-): ClaudePluginBundleResult {
-  const mcpServers: Record<string, ServerEntry> = {};
-  const skillPaths: string[] = [];
-  const seenRoots = new Set<string>();
-  const seenNames = new Map<string, string>();
-  const serverSources = new Map<string, string>();
-  const normalizedServerNames = new Map<string, string>();
-
-  for (const plugin of plugins ?? []) {
-    const configuredPath = resolvePluginPath(plugin.path, cwd);
-    const pluginRoot = resolvePluginRoot(configuredPath);
-    if (!pluginRoot) continue;
-    if (seenRoots.has(pluginRoot)) {
-      console.warn(`Claude plugin path is configured more than once: ${pluginRoot}`);
-      continue;
-    }
-    seenRoots.add(pluginRoot);
-
-    const manifest = readPluginManifest(pluginRoot);
-    if (manifest === false) continue;
-    const pluginName = manifest?.name ?? basename(pluginRoot);
-    const previousPluginRoot = seenNames.get(pluginName);
-    if (previousPluginRoot && previousPluginRoot !== pluginRoot) {
-      console.warn(`Claude plugin name conflict for "${pluginName}": ${previousPluginRoot} and ${pluginRoot}`);
-    } else {
-      seenNames.set(pluginName, pluginRoot);
-    }
-
-    if (components.mcp && plugin.mcp === true) {
-      const configPath = resolveContainedComponent(pluginRoot, ".mcp.json", "file", pluginName);
-      if (configPath) {
-        const config = readPluginMcpConfig(configPath, pluginName, pluginRoot, validateConfig);
-        for (const [serverName, server] of Object.entries(config.mcpServers)) {
-          const normalizedName = formatServerNamespace(serverName);
-          const previousName = normalizedServerNames.get(normalizedName);
-          const previousSource = previousName ? serverSources.get(previousName) : undefined;
-          if (previousName && previousSource) {
-            console.warn(`Claude plugin MCP server name conflict for "${serverName}": normalized name collides with "${previousName}" from ${previousSource}; the first plugin wins over ${configPath}`);
-            continue;
-          }
-          normalizedServerNames.set(normalizedName, serverName);
-          serverSources.set(serverName, configPath);
-          mcpServers[serverName] = server;
-        }
-      }
-    }
-
-    if (components.skills && plugin.skills === true) {
-      const skillsPath = resolveContainedComponent(pluginRoot, "skills", "directory", pluginName);
-      if (skillsPath) {
-        try {
-          for (const skillPath of discoverContainedSkillFiles(skillsPath, pluginName)) {
-            if (!skillPaths.includes(skillPath)) skillPaths.push(skillPath);
-          }
-        } catch (error) {
-          console.warn(`Claude plugin "${pluginName}" skills could not be read at ${skillsPath}: ${formatError(error)}`);
-        }
-      }
-    }
-  }
-
-  return { mcpServers, skillPaths };
-}
-
-function resolvePluginPath(path: string, cwd: string): string {
-  if (path === "~") return resolve(process.env.HOME ?? "", ".");
-  if (path.startsWith("~/")) return resolve(process.env.HOME ?? "", path.slice(2));
-  return isAbsolute(path) ? resolve(path) : resolve(cwd, path);
-}
-
-function resolvePluginRoot(path: string): string | null {
-  if (!existsSync(path)) {
-    console.warn(`Claude plugin path does not exist: ${path}`);
-    return null;
-  }
-  const stats = safeStat(path, "Claude plugin path");
-  if (!stats) return null;
-  if (!stats.isDirectory()) {
-    console.warn(`Claude plugin path is not a directory: ${path}`);
-    return null;
-  }
-  return safeRealpath(path, "Claude plugin path");
-}
-
-function readPluginManifest(pluginRoot: string): ClaudePluginManifest | null | false {
-  const configuredManifestPath = resolve(pluginRoot, ".claude-plugin", "plugin.json");
-  if (!existsSync(configuredManifestPath)) return null;
-  const stats = safeStat(configuredManifestPath, "Claude plugin manifest");
-  if (!stats) return null;
-  if (!stats.isFile()) {
-    console.warn(`Claude plugin manifest is not a regular file: ${configuredManifestPath}`);
-    return false;
-  }
-  const manifestPath = safeRealpath(configuredManifestPath, "Claude plugin manifest");
-  if (!manifestPath) return null;
-  if (!isContainedPath(pluginRoot, manifestPath)) {
-    console.warn(`Claude plugin manifest resolves outside the configured plugin directory: ${manifestPath}`);
-    return false;
-  }
-
-  const manifestText = safeReadFile(manifestPath, "Claude plugin manifest", pluginRoot);
-  if (manifestText === null) return null;
-
-  let raw: unknown;
-  try {
-    raw = parseJsonWithComments(manifestText);
-  } catch (error) {
-    console.warn(`Claude plugin manifest contains invalid JSON at ${manifestPath}: ${formatError(error)}`);
-    return false;
-  }
-  if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
-    console.warn(`Claude plugin manifest must be a JSON object: ${manifestPath}`);
-    return false;
-  }
-
-  const manifest = raw as Record<string, unknown>;
-  if (typeof manifest.name !== "string" || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(manifest.name)) {
-    console.warn(`Claude plugin manifest has an invalid name at ${manifestPath}: expected kebab-case`);
-    return false;
-  }
-  if (!hasValidManifestFieldTypes(manifest)) {
-    console.warn(`Claude plugin manifest has invalid field types at ${manifestPath}`);
-    return false;
-  }
-  return { name: manifest.name };
-}
-
-function hasValidManifestFieldTypes(manifest: Record<string, unknown>): boolean {
-  for (const field of ["$schema", "displayName", "version", "description", "homepage", "repository", "license"] as const) {
-    if (manifest[field] !== undefined && typeof manifest[field] !== "string") return false;
-  }
-  for (const field of ["commands", "agents", "skills", "hooks", "mcpServers", "lspServers", "outputStyles"] as const) {
-    const value = manifest[field];
-    if (value !== undefined && typeof value !== "string" && (!Array.isArray(value) || value.some(item => typeof item !== "string"))) return false;
-  }
-  if (manifest.defaultEnabled !== undefined && typeof manifest.defaultEnabled !== "boolean") return false;
-  if (manifest.keywords !== undefined && (!Array.isArray(manifest.keywords) || manifest.keywords.some(value => typeof value !== "string"))) return false;
-  if (manifest.author !== undefined) {
-    if (!manifest.author || typeof manifest.author !== "object" || Array.isArray(manifest.author)) return false;
-    const author = manifest.author as Record<string, unknown>;
-    if (typeof author.name !== "string") return false;
-    if (author.email !== undefined && typeof author.email !== "string") return false;
-    if (author.url !== undefined && typeof author.url !== "string") return false;
-  }
-  if (manifest.metadata !== undefined && (!manifest.metadata || typeof manifest.metadata !== "object" || Array.isArray(manifest.metadata))) return false;
-  return true;
-}
-
-function resolveContainedComponent(
-  pluginRoot: string,
-  component: string,
-  expected: "file" | "directory",
-  pluginName: string,
-): string | null {
-  const path = resolve(pluginRoot, component);
-  if (!existsSync(path)) {
-    console.warn(`Claude plugin "${pluginName}" is missing ${component}: ${path}`);
-    return null;
-  }
-  const stats = safeStat(path, `Claude plugin "${pluginName}" ${component}`);
-  if (!stats) return null;
-  if (expected === "file" ? !stats.isFile() : !stats.isDirectory()) {
-    console.warn(`Claude plugin "${pluginName}" ${component} is not a ${expected}: ${path}`);
-    return null;
-  }
-  const realPath = safeRealpath(path, `Claude plugin "${pluginName}" ${component}`);
-  if (!realPath) return null;
-  if (!isContainedPath(pluginRoot, realPath)) {
-    console.warn(`Claude plugin "${pluginName}" ${component} resolves outside the configured plugin directory: ${realPath}`);
-    return null;
-  }
-  return realPath;
-}
-
-function discoverContainedSkillFiles(skillsRoot: string, pluginName: string): string[] {
-  const skillFiles: string[] = [];
-  const visitedDirectories = new Set<string>();
-  const visit = (directory: string): void => {
-    const realDirectory = safeRealpath(directory, `Claude plugin "${pluginName}" skill directory`);
-    if (!realDirectory) return;
-    if (!isContainedPath(skillsRoot, realDirectory)) {
-      console.warn(`Claude plugin "${pluginName}" skill path resolves outside its skills directory: ${directory} -> ${realDirectory}`);
-      return;
-    }
-    if (visitedDirectories.has(realDirectory)) return;
-    visitedDirectories.add(realDirectory);
-    const entries = safeReadDir(realDirectory, `Claude plugin "${pluginName}" skill directory`);
-    if (!entries) return;
-    for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
-      const path = resolve(realDirectory, entry.name);
-      if (entry.isSymbolicLink()) {
-        const target = safeRealpath(path, `Claude plugin "${pluginName}" skill path`);
-        if (!target) continue;
-        if (!isContainedPath(skillsRoot, target)) {
-          console.warn(`Claude plugin "${pluginName}" skill path resolves outside its skills directory: ${path} -> ${target}`);
-          continue;
-        }
-        const targetStats = safeStat(target, `Claude plugin "${pluginName}" skill path`);
-        if (!targetStats) continue;
-        if (targetStats.isDirectory()) visit(target);
-        else if (targetStats.isFile() && entry.name === "SKILL.md") skillFiles.push(target);
-      } else if (entry.isDirectory()) {
-        visit(path);
-      } else if (entry.isFile() && entry.name === "SKILL.md") {
-        const realPath = safeRealpath(path, `Claude plugin "${pluginName}" skill path`);
-        if (!realPath) continue;
-        if (!isContainedPath(skillsRoot, realPath)) {
-          console.warn(`Claude plugin "${pluginName}" skill path resolves outside its skills directory: ${path} -> ${realPath}`);
-          continue;
-        }
-        skillFiles.push(realPath);
-      }
-    }
-  };
-  visit(skillsRoot);
-  return skillFiles;
-}
-
-function readPluginMcpConfig(
-  configPath: string,
-  pluginName: string,
-  pluginRoot: string,
-  validateConfig: (raw: unknown) => McpConfig,
-): McpConfig {
-  let raw: unknown;
-  try {
-    const configText = safeReadFile(configPath, `Claude plugin "${pluginName}" MCP config`, pluginRoot);
-    if (configText === null) return { mcpServers: {} };
-    raw = parseJsonWithComments(configText);
-  } catch (error) {
-    console.warn(`Claude plugin "${pluginName}" has invalid MCP config at ${configPath}: ${formatError(error)}`);
-    return { mcpServers: {} };
-  }
-  if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
-    console.warn(`Claude plugin "${pluginName}" MCP config must be a JSON object: ${configPath}`);
-    return { mcpServers: {} };
-  }
-
-  const servers = (raw as Record<string, unknown>).mcpServers;
-  if (!servers || typeof servers !== "object" || Array.isArray(servers)) {
-    console.warn(`Claude plugin "${pluginName}" MCP config must contain an mcpServers object: ${configPath}`);
-    return { mcpServers: {} };
-  }
-
-  const config = validateConfig(raw);
-  const validated: Record<string, ServerEntry> = {};
-  for (const serverName of Object.keys(servers)) {
-    if (serverName.trim().length === 0) {
-      console.warn(`Claude plugin "${pluginName}" has an empty MCP server name at ${configPath}`);
-      continue;
-    }
-    const parsed = config.mcpServers[serverName];
-    if (!parsed || !hasValidServerTransport(parsed)) {
-      console.warn(`Claude plugin "${pluginName}" has invalid MCP server "${serverName}" at ${configPath}: expected exactly one non-empty command, url, or socket transport`);
-      continue;
-    }
-    validated[serverName] = replacePluginRoot(parsed, pluginRoot);
-  }
-  return { mcpServers: validated };
-}
-
-function hasValidServerTransport(entry: ServerEntry): boolean {
-  return [entry.command, entry.url, entry.socket].filter(value => typeof value === "string" && value.trim().length > 0).length === 1;
-}
-
-function replacePluginRoot(entry: ServerEntry, pluginRoot: string): ServerEntry {
-  const replace = (value: string): string => value.replaceAll("${CLAUDE_PLUGIN_ROOT}", pluginRoot);
-  const replaced = replaceStrings(entry, replace) as ServerEntry;
-  if (typeof replaced.command === "string") {
-    replaced.env = { ...replaced.env, CLAUDE_PLUGIN_ROOT: pluginRoot };
-  }
-  return replaced;
-}
-
-function replaceStrings(value: unknown, replace: (value: string) => string): unknown {
-  if (typeof value === "string") return replace(value);
-  if (Array.isArray(value)) return value.map(item => replaceStrings(item, replace));
-  if (!value || typeof value !== "object") return value;
-  return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, replaceStrings(entry, replace)]));
-}
-
-function isContainedPath(root: string, path: string): boolean {
-  const rel = relative(root, path);
-  return rel === "" || (!rel.startsWith("..") && !rel.startsWith(sep) && !isAbsolute(rel));
-}
-
-function safeStat(path: string, description: string): Stats | null {
-  try {
-    return statSync(path);
-  } catch (error) {
-    console.warn(`${description} could not be read: ${path}: ${formatError(error)}`);
-    return null;
-  }
-}
-
-function safeRealpath(path: string, description: string): string | null {
-  try {
-    return realpathSync(path);
-  } catch (error) {
-    console.warn(`${description} could not be read: ${path}: ${formatError(error)}`);
-    return null;
-  }
-}
-
-function safeReadFile(path: string, description: string, containmentRoot: string): string | null {
-  let fd: number | undefined;
-  try {
-    fd = openSync(path, constants.O_RDONLY | constants.O_NOFOLLOW);
-    const openedStats = fstatSync(fd);
-    if (!openedStats.isFile()) {
-      console.warn(`${description} is not a regular file: ${path}`);
-      return null;
-    }
-    const resolvedPath = safeRealpath(path, description);
-    if (!resolvedPath) return null;
-    if (!isContainedPath(containmentRoot, resolvedPath)) {
-      console.warn(`${description} resolves outside the configured plugin directory: ${resolvedPath}`);
-      return null;
-    }
-    const currentStats = safeStat(resolvedPath, description);
-    if (!currentStats) return null;
-    if (openedStats.dev !== currentStats.dev || openedStats.ino !== currentStats.ino) {
-      console.warn(`${description} changed while being read: ${path}`);
-      return null;
-    }
-    return readFileSync(fd, "utf8");
-  } catch (error) {
-    console.warn(`${description} could not be read: ${path}: ${formatError(error)}`);
-    return null;
-  } finally {
-    if (fd !== undefined) closeSync(fd);
-  }
-}
-
-function safeReadDir(path: string, description: string): Dirent[] | null {
-  try {
-    return readdirSync(path, { withFileTypes: true });
-  } catch (error) {
-    console.warn(`${description} could not be read: ${path}: ${formatError(error)}`);
-    return null;
-  }
-}
-
-function formatError(error: unknown): string {
-  return error instanceof Error ? error.message : String(error);
-}