@herbertgao/pi-extensions 2026.9.17 → 2026.9.18

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

@@ -1,156 +0,0 @@
-import { existsSync, readFileSync, statSync } from "node:fs";
-import { isAbsolute, join, resolve } from "node:path";
-import { getAgentDir, getConfigDirName } from "./agent-dir.ts";
-import type { McpConfig, ServerEntry } from "./types.ts";
-import { parseJsonWithComments, resolveContainedPath, resolveRealContainedPath } from "./utils.ts";
-
-interface PackageSetting {
-  source: string;
-}
-
-interface PackageManifest {
-  name?: unknown;
-  pi?: { mcp?: unknown };
-}
-
-export function loadPackageMcpConfigs(cwd = process.cwd()): McpConfig {
-  const mcpServers: Record<string, ServerEntry> = {};
-  const seen = new Set<string>();
-
-  for (const packageRoot of getConfiguredPackageRoots(cwd)) {
-    const manifest = readPackageManifest(packageRoot);
-    if (!manifest || typeof manifest.name !== "string" || !manifest.name) continue;
-    const paths = getManifestMcpPaths(manifest.pi?.mcp, manifest.name);
-    if (!paths) continue;
-
-    const packagePrefix = formatPackageName(manifest.name);
-    const packageServers = new Set<string>();
-    for (const path of paths) {
-      const configPath = resolvePackageConfigPath(packageRoot, path);
-      if (!configPath) {
-        console.warn(`Pi package ${manifest.name} skips MCP config ${path}: file must stay inside the package`);
-        continue;
-      }
-
-      const config = readMcpConfig(configPath, manifest.name);
-      if (!config) continue;
-      for (const [serverName, server] of Object.entries(config.mcpServers)) {
-        const normalizedName = `${packagePrefix}__${formatServerName(serverName)}`;
-        if (packageServers.has(normalizedName) || seen.has(normalizedName)) {
-          console.warn(`Pi package ${manifest.name} skips duplicate normalized MCP server ${normalizedName}`);
-          continue;
-        }
-        packageServers.add(normalizedName);
-        seen.add(normalizedName);
-        mcpServers[normalizedName] = server;
-      }
-    }
-  }
-
-  return { mcpServers };
-}
-
-function getConfiguredPackageRoots(cwd: string): string[] {
-  const roots: string[] = [];
-  for (const [settingsPath, scope] of [
-    [join(cwd, getConfigDirName(), "settings.json"), "project"],
-    [join(getAgentDir(), "settings.json"), "user"],
-  ] as const) {
-    const settings = readOptionalJson(settingsPath, `${scope} Pi settings`);
-    if (settings === undefined) continue;
-    if (typeof settings !== "object" || settings === null || Array.isArray(settings)) {
-      throw new Error(`${scope} Pi settings ${settingsPath} must be a JSON object`);
-    }
-    const packages = (settings as { packages?: unknown }).packages;
-    if (packages === undefined) continue;
-    if (!Array.isArray(packages)) throw new Error(`${scope} Pi settings ${settingsPath} packages must be an array`);
-    for (const entry of packages) {
-      const source = typeof entry === "string"
-        ? entry
-        : entry && typeof entry === "object" && !Array.isArray(entry) && typeof (entry as PackageSetting).source === "string"
-          ? (entry as PackageSetting).source
-          : undefined;
-      if (!source) throw new Error(`${scope} Pi settings ${settingsPath} package entries must be strings or objects with a string source`);
-      const root = resolvePackageRoot(source, scope, cwd);
-      if (root && !roots.includes(root)) roots.push(root);
-    }
-  }
-  return roots;
-}
-
-function resolvePackageRoot(source: string, scope: "user" | "project", cwd: string): string | null {
-  const baseDir = scope === "user" ? getAgentDir() : join(cwd, getConfigDirName());
-  if (source.startsWith("npm:")) {
-    const name = source.slice(4).trim().match(/^(@?[^@]+(?:\/[^@]+)?)/)?.[1];
-    return name ? resolveContainedPath(join(baseDir, "npm", "node_modules"), name) : null;
-  }
-  const gitSource = source.startsWith("git:")
-    ? source.slice(4).trim()
-    : /^(?:(?:https?|ssh):\/\/|git@[^:]+:)/.test(source) ? source : null;
-  if (gitSource) {
-    const value = gitSource
-      .replace(/^ssh:\/\/git@/, "")
-      .replace(/^git@([^:]+):/, "$1/")
-      .replace(/^[a-z]+:\/\//i, "");
-    const path = value.replace(/@[^/]+$/, "").replace(/\.git$/, "");
-    return path && !path.startsWith("/") ? resolveContainedPath(join(baseDir, "git"), path) : null;
-  }
-  return isAbsolute(source) ? resolve(source) : resolve(baseDir, source);
-}
-
-function readPackageManifest(packageRoot: string): PackageManifest | null {
-  const manifest = readOptionalJson(join(packageRoot, "package.json"), `Pi package manifest ${packageRoot}`);
-  return manifest && typeof manifest === "object" && !Array.isArray(manifest) ? manifest as PackageManifest : null;
-}
-
-function getManifestMcpPaths(value: unknown, packageName: string): string[] | null {
-  const paths = typeof value === "string" ? [value] : Array.isArray(value) && value.every((path): path is string => typeof path === "string") ? value : null;
-  if (value !== undefined && !paths) console.warn(`Pi package ${packageName} ignores invalid pi.mcp manifest entry`);
-  return paths;
-}
-
-function readMcpConfig(path: string, packageName: string): McpConfig | null {
-  const config = readRequiredJson(path, `Pi package ${packageName} MCP config`);
-  if (!config || typeof config !== "object" || Array.isArray(config)) {
-    throw new Error(`Pi package ${packageName} MCP config ${path} must be a JSON object`);
-  }
-  const servers = (config as { mcpServers?: unknown }).mcpServers;
-  if (!servers || typeof servers !== "object" || Array.isArray(servers)) {
-    throw new Error(`Pi package ${packageName} MCP config ${path} must contain a JSON object mcpServers field`);
-  }
-  const mcpServers: Record<string, ServerEntry> = {};
-  for (const [name, server] of Object.entries(servers)) {
-    if (!server || typeof server !== "object" || Array.isArray(server)) {
-      throw new Error(`Pi package ${packageName} MCP config ${path} server ${name} must be a JSON object`);
-    }
-    mcpServers[name] = server as ServerEntry;
-  }
-  return { mcpServers };
-}
-
-function readRequiredJson(path: string, description: string): unknown {
-  try {
-    return parseJsonWithComments(readFileSync(path, "utf8"));
-  } catch (error) {
-    throw new Error(`${description} ${path} contains invalid JSON: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
-  }
-}
-
-function readOptionalJson(path: string, description: string): unknown | undefined {
-  if (!existsSync(path)) return undefined;
-  return readRequiredJson(path, description);
-}
-
-function resolvePackageConfigPath(packageRoot: string, path: string): string | null {
-  const lexicalPath = resolveContainedPath(packageRoot, path);
-  if (!lexicalPath || !existsSync(lexicalPath) || !statSync(lexicalPath).isFile()) return null;
-  return resolveRealContainedPath(packageRoot, lexicalPath);
-}
-
-function formatPackageName(name: string): string {
-  return name.replace(/[^A-Za-z0-9_-]+/g, "_").replace(/^[_-]+|[_-]+$/g, "") || "package";
-}
-
-function formatServerName(name: string): string {
-  return name.replace(/[^A-Za-z0-9_-]+/g, "_").replace(/^[_-]+|[_-]+$/g, "") || "server";
-}

package/node_modules/pi-mcp-adapter/package.json

@@ -1,219 +0,0 @@
-{
-  "name": "pi-mcp-adapter",
-  "version": "2.38.0",
-  "description": "MCP (Model Context Protocol) adapter extension for Pi coding agent",
-  "type": "module",
-  "types": "./index.ts",
-  "exports": {
-    ".": {
-      "types": "./index.ts",
-      "import": "./index.ts",
-      "default": "./index.ts"
-    },
-    "./types": {
-      "types": "./dist/types.d.ts",
-      "import": "./dist/types.js",
-      "default": "./dist/types.js"
-    },
-    "./oauth": {
-      "types": "./oauth.ts",
-      "import": "./oauth.ts",
-      "default": "./oauth.ts"
-    },
-    "./config": {
-      "types": "./dist/config.d.ts",
-      "import": "./dist/config.js",
-      "default": "./dist/config.js"
-    },
-    "./metadata-cache": {
-      "types": "./dist/metadata-cache.d.ts",
-      "import": "./dist/metadata-cache.js",
-      "default": "./dist/metadata-cache.js"
-    }
-  },
-  "license": "MIT",
-  "author": "Nico Bailon",
-  "engines": {
-    "node": ">=20"
-  },
-  "bin": {
-    "pi-mcp-adapter": "cli.js"
-  },
-  "scripts": {
-    "build:public": "tsc -p tsconfig.public.json",
-    "prepack": "npm run build:public",
-    "typecheck": "tsc --noEmit",
-    "test": "node test-runner.mjs",
-    "test:vitest": "vitest run",
-    "test:public-exports": "npm run build:public && node --test public-exports.test.mjs",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "test:oauth": "PI_MCP_ADAPTER_TEST_AUTH_STORE=memory PI_MCP_ADAPTER_DISABLE_AUTH_CACHE=1 node --import tsx --test --test-concurrency=1 oauth-public-api.test.ts mcp-auth.test.ts mcp-auth-flow.test.ts mcp-auth-flow-timeout.test.ts mcp-auth-fetch.test.ts mcp-callback-server.test.ts mcp-oauth-provider.test.ts mcp-local-oauth-flow.test.ts",
-    "test:oauth-provider": "PI_MCP_ADAPTER_TEST_AUTH_STORE=memory PI_MCP_ADAPTER_DISABLE_AUTH_CACHE=1 node --import tsx --test mcp-oauth-provider.test.ts",
-    "test:conformance": "bash conformance/run.sh"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/nicobailon/pi-mcp-adapter.git"
-  },
-  "keywords": [
-    "pi-package",
-    "pi",
-    "mcp",
-    "model-context-protocol",
-    "ai",
-    "coding-agent",
-    "extension",
-    "claude",
-    "llm"
-  ],
-  "pi": {
-    "extensions": [
-      "./index.ts"
-    ],
-    "video": "https://github.com/nicobailon/pi-mcp-adapter/raw/refs/heads/main/pi-mcp.mp4"
-  },
-  "files": [
-    "cli.js",
-    "agent-dir.ts",
-    "index.ts",
-    "error-signal.ts",
-    "state.ts",
-    "utils.ts",
-    "abort.ts",
-    "runtime-owner.ts",
-    "tool-metadata.ts",
-    "ts-shape.ts",
-    "search-ranking.ts",
-    "tool-approval.ts",
-    "session-approvals.ts",
-    "init.ts",
-    "failure-backoff.ts",
-    "ui-session.ts",
-    "proxy-modes.ts",
-    "direct-tools.ts",
-    "direct-tool-surface.ts",
-    "lazy-loader.ts",
-    "namespace-tools.ts",
-    "mcp-references.ts",
-    "commands.ts",
-    "prompts.ts",
-    "onboarding-state.ts",
-    "mcp-setup-panel.ts",
-    "types.ts",
-    "ui-stream-types.ts",
-    "ui-tool-visibility.ts",
-    "ui-app-bridge-helpers.ts",
-    "config.ts",
-    "claude-plugin-loader.ts",
-    "package-mcp-loader.ts",
-    "server-manager.ts",
-    "bearer-command-resolver.ts",
-    "http-ca.ts",
-    "request-headers-command.ts",
-    "unix-socket-transport.ts",
-    "json-schema-validator.ts",
-    "session-recovery.ts",
-    "sampling-handler.ts",
-    "elicitation-handler.ts",
-    "tool-registrar.ts",
-    "tool-result-renderer.ts",
-    "mcp-output-guard.ts",
-    "mcp-code.ts",
-    "mcp-script-worker.mjs",
-    "mcp-probe.ts",
-    "mcp-install.ts",
-    "agent-plugin-loader.ts",
-    "agent-plugin-provenance.ts",
-    "resource-tools.ts",
-    "lifecycle.ts",
-    "mcp-status.ts",
-    "metadata-cache.ts",
-    "host-html-template.ts",
-    "sandbox-proxy-template.ts",
-    "ui-resource-handler.ts",
-    "consent-manager.ts",
-    "ui-server.ts",
-    "glimpse-ui.ts",
-    "npx-resolver.ts",
-    "oauth-handler.ts",
-    "oauth.ts",
-    "mcp-auth.ts",
-    "mcp-bearer-store.ts",
-    "secure-keyring.ts",
-    "jev-contracts.ts",
-    "jev-key-store.ts",
-    "jev-client.ts",
-    "semantic-search.ts",
-    "examples/jev-semantic-filter.mjs",
-    "examples/jev-accessibility-loop.mjs",
-    "mcp-keyring-helper.cjs",
-    "mcp-oauth-provider.ts",
-    "mcp-callback-server.ts",
-    "mcp-auth-flow.ts",
-    "mcp-auth-fetch.ts",
-    "mcp-panel.ts",
-    "mcp-panel-theme.ts",
-    "panel-keys.ts",
-    "mcp-tasks.ts",
-    "mcp-trace.ts",
-    "logger.ts",
-    "errors.ts",
-    "app-bridge.bundle.js",
-    "banner.png",
-    "skills",
-    "README.md",
-    "OAUTH.md",
-    "CHANGELOG.md",
-    "LICENSE",
-    "dist"
-  ],
-  "dependencies": {
-    "@modelcontextprotocol/client": "2.0.0",
-    "@modelcontextprotocol/core": "2.0.0",
-    "@modelcontextprotocol/ext-apps": "^1.2.2",
-    "@modelcontextprotocol/ext-tasks": "^0.1.0",
-    "@napi-rs/keyring": "^2.1.0",
-    "@typesafe-ai/sdk": "0.6.0",
-    "ajv": "^8.17.1",
-    "ajv-formats": "^3.0.1",
-    "cross-spawn": "^7.0.6",
-    "open": "^10.2.0",
-    "recheck": "4.6.0-beta.3",
-    "smol-toml": "^1.6.1",
-    "strip-json-comments": "^5.0.3",
-    "undici": "^6.28.1",
-    "zod": "^3.25.0 || ^4.0.0"
-  },
-  "peerDependencies": {
-    "@earendil-works/pi-ai": "^0.84.1 || ^0.85.0 || ^0.86.0 || ^0.87.0",
-    "@earendil-works/pi-tui": "*",
-    "typebox": "*",
-    "zod": "^3.25.0 || ^4.0.0"
-  },
-  "peerDependenciesMeta": {
-    "@earendil-works/pi-ai": {
-      "optional": true
-    },
-    "@earendil-works/pi-tui": {
-      "optional": true
-    },
-    "typebox": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@earendil-works/pi-ai": "0.87.0",
-    "@earendil-works/pi-coding-agent": "0.87.0",
-    "@earendil-works/pi-tui": "0.87.0",
-    "@modelcontextprotocol/conformance": "0.1.16",
-    "@types/bun": "^1.0.0",
-    "@types/cross-spawn": "6.0.6",
-    "@types/node": "20.19.43",
-    "@types/open": "^6.2.1",
-    "tsx": "^4.21.0",
-    "typebox": "1.3.3",
-    "typescript": "5.9.3",
-    "vitest": "^3.0.0"
-  }
-}

package/node_modules/pi-mcp-adapter/panel-keys.ts

@@ -1,53 +0,0 @@
-import { matchesKey, type KeyId } from "@earendil-works/pi-tui";
-
-/** The panel keybinding ids the adapter panels resolve through pi-tui. */
-export type PanelSelectKeybinding =
-  | "tui.select.up"
-  | "tui.select.down"
-  | "tui.select.confirm";
-
-/** Structural subset of pi-tui's `KeybindingsManager` (which satisfies it). */
-export interface PanelKeybindings {
-  matches(data: string, keybinding: PanelSelectKeybinding): boolean;
-  getUserBindings?(): Record<string, KeyId | KeyId[] | undefined>;
-}
-
-/**
- * Key matchers for panel actions: user bindings when a manager is provided,
- * otherwise the previous hardcoded defaults.
- */
-export interface PanelKeys {
-  selectUp(data: string): boolean;
-  selectDown(data: string): boolean;
-  selectConfirm(data: string): boolean;
-  save(data: string): boolean;
-  saveLabel(): string | null;
-}
-
-function configuredSaveKeys(keybindings?: PanelKeybindings): { keys: KeyId[]; configured: boolean } {
-  const explicit = keybindings?.getUserBindings?.()["mcp.panel.save"];
-  if (explicit !== undefined) return { keys: Array.isArray(explicit) ? explicit : [explicit], configured: true };
-  return { keys: [], configured: false };
-}
-
-export function createPanelKeys(keybindings?: PanelKeybindings): PanelKeys {
-  const saveBinding = configuredSaveKeys(keybindings);
-  if (keybindings) {
-    return {
-      selectUp: (data) => keybindings.matches(data, "tui.select.up"),
-      selectDown: (data) => keybindings.matches(data, "tui.select.down"),
-      selectConfirm: (data) => keybindings.matches(data, "tui.select.confirm"),
-      save: (data) => saveBinding.keys.length > 0
-        ? saveBinding.keys.some((key) => matchesKey(data, key))
-        : !saveBinding.configured && matchesKey(data, "ctrl+s"),
-      saveLabel: () => saveBinding.keys[0] ?? (saveBinding.configured ? null : "ctrl+s"),
-    };
-  }
-  return {
-    selectUp: (data) => matchesKey(data, "up"),
-    selectDown: (data) => matchesKey(data, "down"),
-    selectConfirm: (data) => matchesKey(data, "return"),
-    save: (data) => matchesKey(data, "ctrl+s"),
-    saveLabel: () => "ctrl+s",
-  };
-}