@herbertgao/pi-extensions 2026.9.17 → 2026.9.18

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

@@ -1,34 +0,0 @@
-export function throwIfAborted(signal?: AbortSignal): void {
-  if (!signal?.aborted) return;
-  throw signal.reason instanceof Error ? signal.reason : new Error(String(signal.reason ?? "MCP request aborted"));
-}
-
-export async function abortable<T>(promise: Promise<T>, signal?: AbortSignal): Promise<T> {
-  if (!signal) return promise;
-  throwIfAborted(signal);
-  return await new Promise<T>((resolve, reject) => {
-    let settled = false;
-    const cleanup = () => signal.removeEventListener("abort", onAbort);
-    const onAbort = () => {
-      if (settled) return;
-      settled = true;
-      cleanup();
-      reject(signal.reason instanceof Error ? signal.reason : new Error(String(signal.reason ?? "MCP request aborted")));
-    };
-    signal.addEventListener("abort", onAbort, { once: true });
-    promise.then(
-      value => {
-        if (settled) return;
-        settled = true;
-        cleanup();
-        resolve(value);
-      },
-      error => {
-        if (settled) return;
-        settled = true;
-        cleanup();
-        reject(error);
-      },
-    );
-  });
-}

package/node_modules/pi-mcp-adapter/agent-dir.ts

@@ -1,68 +0,0 @@
-import { readFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join, resolve } from "node:path";
-
-export function getConfigDirName(): string {
-  const configDir = readPiConfig()?.configDir;
-  return typeof configDir === "string" && configDir.trim() ? configDir.trim() : ".pi";
-}
-
-export function getAgentDir(): string {
-  const piConfig = readPiConfig();
-  const name = piConfig?.name;
-  const appName = typeof name === "string" && name.trim() ? name.trim() : "pi";
-  const configured = process.env[`${appName.toUpperCase()}_CODING_AGENT_DIR`]?.trim();
-  if (!configured) {
-    return join(homedir(), getConfigDirName(), "agent");
-  }
-  if (configured === "~") {
-    return homedir();
-  }
-  if (configured.startsWith("~/")) {
-    return resolve(homedir(), configured.slice(2));
-  }
-  return resolve(configured);
-}
-
-export function getAgentPath(...segments: string[]): string {
-  return join(getAgentDir(), ...segments);
-}
-
-/**
- * What the host calls itself.
- *
- * pi supports rebranding through `piConfig.name` in the package.json that its
- * `getPackageDir()` resolves, and distributions built on pi (arc, tau, …) point
- * `PI_PACKAGE_DIR` at their own manifest. Read that manifest directly rather
- * than importing pi: this package deliberately depends on pi-ai and pi-tui
- * only, and `getAgentDir()` above reads its env var the same self-contained way.
- *
- * Falls back to "pi", which is what pi's own APP_NAME resolves to.
- */
-function readPiConfig(): { name?: unknown; configDir?: unknown; clientUri?: unknown } | undefined {
-  const dir = process.env.PI_PACKAGE_DIR?.trim()
-  if (!dir) return undefined
-  try {
-    const manifest = JSON.parse(readFileSync(join(resolve(dir), "package.json"), "utf8")) as {
-      piConfig?: { name?: unknown; configDir?: unknown; clientUri?: unknown }
-    }
-    return manifest.piConfig
-  } catch {
-    return undefined
-  }
-}
-
-export function getAppName(): string {
-  const name = readPiConfig()?.name
-  return typeof name === "string" && name.trim() ? name.trim() : "pi"
-}
-
-/**
- * Home page the host declares for itself, via `piConfig.clientUri` in the same
- * manifest that carries `piConfig.name`. Only the distribution knows its own
- * URL, so this is the one place it can come from without guessing.
- */
-export function getAppClientUri(): string | undefined {
-  const uri = readPiConfig()?.clientUri
-  return typeof uri === "string" && uri.trim() ? uri.trim() : undefined
-}

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

@@ -1,416 +0,0 @@
-import { existsSync, readFileSync, realpathSync, statSync } from "node:fs";
-import { dirname, isAbsolute, resolve } from "node:path";
-import { getAgentPath } from "./agent-dir.ts";
-import { markBuiltInAgentPlugin } from "./agent-plugin-provenance.ts";
-import type { McpConfig, ServerEntry } from "./types.ts";
-import { resolveRealContainedPath } from "./utils.ts";
-
-const PLUGIN_SCHEMA = "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json";
-const MCP_SCHEMA = "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json";
-const PLUGIN_NAME_PATTERN = /^(?!.*(?:--|\.\.))[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?$/;
-const PLUGIN_MANIFEST_FIELDS = new Set([
-  "$schema",
-  "name",
-  "version",
-  "description",
-  "author",
-  "homepage",
-  "repository",
-  "license",
-  "keywords",
-  "extensions",
-]);
-const MCP_CONFIG_FIELDS = new Set(["$schema", "mcpServers"]);
-const STDIO_FIELDS = new Set(["type", "command", "args", "env", "cwd"]);
-const HTTP_FIELDS = new Set(["type", "url", "headers"]);
-const STRING_MANIFEST_FIELDS = ["version", "description", "homepage", "repository", "license"] as const;
-const AUTHOR_FIELDS = new Set(["name", "email", "url"]);
-
-interface AgentPluginManifest {
-  name: string;
-}
-
-export interface AgentPluginSummary {
-  path: string;
-  name?: string;
-  serverCount: number;
-}
-
-export function loadAgentPluginConfigs(paths: unknown, cwd = process.cwd()): McpConfig {
-  const mcpServers: Record<string, ServerEntry> = {};
-  for (const pluginPath of getPluginPaths(paths)) {
-    const loaded = loadAgentPluginMcpConfig(pluginPath, cwd);
-    if (!loaded) continue;
-    for (const [serverName, server] of Object.entries(loaded.mcpServers)) {
-      if (mcpServers[serverName]) {
-        console.warn(`Agent Plugin at ${resolvePluginPath(pluginPath, cwd)} skips duplicate normalized MCP server ${serverName}`);
-        continue;
-      }
-      mcpServers[serverName] = server;
-    }
-  }
-  return { mcpServers };
-}
-
-export function getAgentPluginSummaries(paths: unknown, cwd = process.cwd()): AgentPluginSummary[] {
-  return getPluginPaths(paths).map(path => {
-    const pluginRoot = resolvePluginRoot(path, cwd);
-    const loaded = loadAgentPluginMcpConfig(path, cwd);
-    const manifest = loaded ? readPluginManifest(pluginRoot, false) : null;
-    return {
-      path: pluginRoot,
-      ...(manifest?.name ? { name: manifest.name } : {}),
-      serverCount: loaded ? Object.keys(loaded.mcpServers).length : 0,
-    };
-  });
-}
-
-function getPluginPaths(paths: unknown): string[] {
-  return Array.isArray(paths) ? paths.filter((path): path is string => typeof path === "string") : [];
-}
-
-function loadAgentPluginMcpConfig(path: string, cwd: string): McpConfig | null {
-  const pluginRoot = resolvePluginRoot(path, cwd);
-  const manifest = readPluginManifest(pluginRoot, true);
-  if (!manifest) return null;
-
-  const mcpPath = resolve(pluginRoot, "mcp.json");
-  if (!existsSync(mcpPath)) return { mcpServers: {} };
-  if (!statSync(mcpPath).isFile()) {
-    console.warn(`Agent Plugin ${manifest.name} has invalid MCP config: mcp.json is not a regular file`);
-    return { mcpServers: {} };
-  }
-  const resolvedMcpPath = resolveRealContainedPath(pluginRoot, mcpPath);
-  if (!resolvedMcpPath) {
-    console.warn(`Agent Plugin ${manifest.name} has invalid MCP config: mcp.json must stay inside the plugin directory`);
-    return { mcpServers: {} };
-  }
-
-  let raw: unknown;
-  try {
-    raw = JSON.parse(readFileSync(resolvedMcpPath, "utf8"));
-  } catch (error) {
-    console.warn(`Agent Plugin ${manifest.name} has invalid MCP config: failed to parse mcp.json`, error);
-    return { mcpServers: {} };
-  }
-
-  return translateAgentPluginMcpConfig(raw, manifest, pluginRoot);
-}
-
-function readPluginManifest(pluginRoot: string, report: boolean): AgentPluginManifest | null {
-  const manifestPath = resolve(pluginRoot, "plugin.json");
-  if (!existsSync(manifestPath)) {
-    if (report) console.warn(`Agent Plugin at ${pluginRoot} is invalid: missing plugin.json`);
-    return null;
-  }
-  if (!statSync(manifestPath).isFile()) {
-    if (report) console.warn(`Agent Plugin at ${pluginRoot} is invalid: plugin.json is not a regular file`);
-    return null;
-  }
-  const resolvedManifestPath = resolveRealContainedPath(pluginRoot, manifestPath);
-  if (!resolvedManifestPath) {
-    if (report) console.warn(`Agent Plugin at ${pluginRoot} is invalid: plugin.json must stay inside the plugin directory`);
-    return null;
-  }
-
-  let raw: unknown;
-  try {
-    raw = JSON.parse(readFileSync(resolvedManifestPath, "utf8"));
-  } catch (error) {
-    if (report) console.warn(`Agent Plugin at ${pluginRoot} is invalid: failed to parse plugin.json`, error);
-    return null;
-  }
-  if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
-    if (report) console.warn(`Agent Plugin at ${pluginRoot} is invalid: plugin.json must be an object`);
-    return null;
-  }
-
-  const manifest = raw as Record<string, unknown>;
-  for (const key of Object.keys(manifest)) {
-    if (!PLUGIN_MANIFEST_FIELDS.has(key) && report) {
-      console.warn(`Agent Plugin at ${pluginRoot} ignores unknown plugin.json field: ${key}`);
-    }
-  }
-  if (manifest.$schema !== PLUGIN_SCHEMA) {
-    if (report) console.warn(`Agent Plugin at ${pluginRoot} is invalid: unsupported plugin.json $schema`);
-    return null;
-  }
-  if (typeof manifest.name !== "string" || manifest.name.length < 1 || manifest.name.length > 64 || !PLUGIN_NAME_PATTERN.test(manifest.name)) {
-    if (report) console.warn(`Agent Plugin at ${pluginRoot} is invalid: plugin.json name is invalid`);
-    return null;
-  }
-  for (const field of STRING_MANIFEST_FIELDS) {
-    if (manifest[field] !== undefined && typeof manifest[field] !== "string") {
-      if (report) console.warn(`Agent Plugin ${manifest.name} is invalid: plugin.json ${field} must be a string`);
-      return null;
-    }
-  }
-  if (manifest.keywords !== undefined && (!Array.isArray(manifest.keywords) || manifest.keywords.some(value => typeof value !== "string"))) {
-    if (report) console.warn(`Agent Plugin ${manifest.name} is invalid: plugin.json keywords must be an array of strings`);
-    return null;
-  }
-  if (manifest.author !== undefined && !isValidManifestAuthor(manifest.author)) {
-    if (report) console.warn(`Agent Plugin ${manifest.name} is invalid: plugin.json author is invalid`);
-    return null;
-  }
-  if (manifest.extensions !== undefined && (!manifest.extensions || typeof manifest.extensions !== "object" || Array.isArray(manifest.extensions))) {
-    if (report) console.warn(`Agent Plugin ${manifest.name} ignores non-object plugin.json extensions`);
-  }
-
-  return { name: manifest.name };
-}
-
-function translateAgentPluginMcpConfig(raw: unknown, manifest: AgentPluginManifest, pluginRoot: string): McpConfig {
-  if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
-    console.warn(`Agent Plugin ${manifest.name} has invalid MCP config: mcp.json must be an object`);
-    return { mcpServers: {} };
-  }
-
-  const mcpConfig = raw as Record<string, unknown>;
-  for (const key of Object.keys(mcpConfig)) {
-    if (!MCP_CONFIG_FIELDS.has(key)) {
-      console.warn(`Agent Plugin ${manifest.name} has invalid MCP config: unknown top-level field ${key}`);
-      return { mcpServers: {} };
-    }
-  }
-  if (mcpConfig.$schema !== MCP_SCHEMA) {
-    console.warn(`Agent Plugin ${manifest.name} has invalid MCP config: unsupported mcp.json $schema`);
-    return { mcpServers: {} };
-  }
-  if (!mcpConfig.mcpServers || typeof mcpConfig.mcpServers !== "object" || Array.isArray(mcpConfig.mcpServers)) {
-    console.warn(`Agent Plugin ${manifest.name} has invalid MCP config: mcpServers must be an object`);
-    return { mcpServers: {} };
-  }
-
-  const mcpServers: Record<string, ServerEntry> = {};
-  for (const [serverName, entry] of Object.entries(mcpConfig.mcpServers)) {
-    const translated = translateAgentPluginServer(manifest, pluginRoot, serverName, entry);
-    if (!translated) continue;
-
-    const normalizedName = formatAgentPluginServerName(manifest.name, serverName);
-    if (mcpServers[normalizedName]) {
-      console.warn(`Agent Plugin ${manifest.name} skips invalid MCP server ${serverName}: normalized server name ${normalizedName} already exists`);
-      continue;
-    }
-    mcpServers[normalizedName] = translated;
-  }
-  return { mcpServers };
-}
-
-function translateAgentPluginServer(
-  manifest: AgentPluginManifest,
-  pluginRoot: string,
-  serverName: string,
-  entry: unknown,
-): ServerEntry | null {
-  if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
-    console.warn(`Agent Plugin ${manifest.name} skips invalid MCP server ${serverName}: entry must be an object`);
-    return null;
-  }
-
-  const raw = entry as Record<string, unknown>;
-  if (raw.type === "stdio") return translateStdioServer(manifest, pluginRoot, serverName, raw);
-  if (raw.type === "streamable-http" || raw.type === "sse") return translateHttpServer(manifest, serverName, raw, raw.type);
-
-  console.warn(`Agent Plugin ${manifest.name} skips invalid MCP server ${serverName}: unsupported type`);
-  return null;
-}
-
-function translateStdioServer(
-  manifest: AgentPluginManifest,
-  pluginRoot: string,
-  serverName: string,
-  raw: Record<string, unknown>,
-): ServerEntry | null {
-  for (const key of Object.keys(raw)) {
-    if (!STDIO_FIELDS.has(key)) return skipServer(manifest, serverName, `unknown field ${key}`);
-  }
-  if (typeof raw.command !== "string" || raw.command.length === 0) return skipServer(manifest, serverName, "command must be a non-empty string");
-  if (!isBareCommand(raw.command) && !raw.command.startsWith("./")) return skipServer(manifest, serverName, "command must be bare or plugin-relative");
-
-  const args = translateStringArray(raw.args, manifest, serverName, "args");
-  if (args === null) return null;
-  const env = translateEnv(raw.env, manifest, serverName);
-  if (env === null) return null;
-
-  const command = raw.command.startsWith("./") ? resolveRealContainedPath(pluginRoot, resolve(pluginRoot, raw.command)) : raw.command;
-  if (command === null) return skipServer(manifest, serverName, "command must resolve to an accessible path inside the plugin directory");
-
-  const pluginDataDir = getAgentPath("agent-plugin-data", manifest.name);
-  const cwd = resolvePluginCwd(raw.cwd, pluginRoot, pluginDataDir);
-  if (cwd === null) return skipServer(manifest, serverName, "cwd must resolve from an allowed root and stay contained");
-
-  return markBuiltInAgentPlugin({
-    command,
-    args: args.map(value => expandPluginPlaceholders(value, pluginRoot, pluginDataDir)),
-    env: {
-      ...Object.fromEntries(Object.entries(env).map(([key, value]) => [key, expandPluginPlaceholders(value, pluginRoot, pluginDataDir)])),
-      PLUGIN_ROOT: pluginRoot,
-      PLUGIN_DATA: pluginDataDir,
-    },
-    cwd,
-    pluginDataDir,
-    literalEnv: true,
-  }, ["args", "env", "cwd"]);
-}
-
-function translateHttpServer(
-  manifest: AgentPluginManifest,
-  serverName: string,
-  raw: Record<string, unknown>,
-  type: "streamable-http" | "sse",
-): ServerEntry | null {
-  for (const key of Object.keys(raw)) {
-    if (!HTTP_FIELDS.has(key)) return skipServer(manifest, serverName, `unknown field ${key}`);
-  }
-  if (typeof raw.url !== "string" || raw.url.length === 0) return skipServer(manifest, serverName, "url must be a non-empty string");
-  if (!isValidAgentPluginUrl(raw.url)) return skipServer(manifest, serverName, "url must be an allowed absolute HTTP(S) URL");
-  const headers = translateHeaders(raw.headers, manifest, serverName);
-  if (headers === null) return null;
-
-  return markBuiltInAgentPlugin({
-    url: raw.url,
-    httpTransport: type,
-    ...(headers ? { headers } : {}),
-  }, headers ? ["headers"] : []);
-}
-
-function formatAgentPluginServerName(pluginName: string, serverName: string): string {
-  const pluginPart = pluginName.replace(/[^A-Za-z0-9_-]+/g, "_").replace(/^[_-]+|[_-]+$/g, "") || "plugin";
-  const serverPart = serverName.replace(/[^A-Za-z0-9_-]+/g, "_").replace(/^[_-]+|[_-]+$/g, "") || "server";
-  return `${pluginPart}__${serverPart}`;
-}
-
-function skipServer(manifest: AgentPluginManifest, serverName: string, reason: string): null {
-  console.warn(`Agent Plugin ${manifest.name} skips invalid MCP server ${serverName}: ${reason}`);
-  return null;
-}
-
-function translateStringArray(value: unknown, manifest: AgentPluginManifest, serverName: string, field: string): string[] | null {
-  if (value === undefined) return [];
-  if (!Array.isArray(value) || value.some(item => typeof item !== "string")) {
-    console.warn(`Agent Plugin ${manifest.name} skips invalid MCP server ${serverName}: ${field} must be an array of strings`);
-    return null;
-  }
-  return value;
-}
-
-function translateEnv(value: unknown, manifest: AgentPluginManifest, serverName: string): Record<string, string> | null {
-  if (value === undefined) return {};
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    console.warn(`Agent Plugin ${manifest.name} skips invalid MCP server ${serverName}: env must be an object of strings`);
-    return null;
-  }
-  const entries: Array<[string, string]> = [];
-  for (const [key, entry] of Object.entries(value)) {
-    if (key === "PLUGIN_ROOT" || key === "PLUGIN_DATA") {
-      console.warn(`Agent Plugin ${manifest.name} skips invalid MCP server ${serverName}: env must not define ${key}`);
-      return null;
-    }
-    if (typeof entry !== "string") {
-      console.warn(`Agent Plugin ${manifest.name} skips invalid MCP server ${serverName}: env values must be strings`);
-      return null;
-    }
-    entries.push([key, entry]);
-  }
-  return Object.fromEntries(entries);
-}
-
-function translateHeaders(value: unknown, manifest: AgentPluginManifest, serverName: string): Record<string, string> | undefined | null {
-  if (value === undefined) return undefined;
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    console.warn(`Agent Plugin ${manifest.name} skips invalid MCP server ${serverName}: headers must be an object of strings`);
-    return null;
-  }
-  const entries: Array<[string, string]> = [];
-  const seen = new Set<string>();
-  for (const [key, entry] of Object.entries(value)) {
-    if (typeof entry !== "string") {
-      console.warn(`Agent Plugin ${manifest.name} skips invalid MCP server ${serverName}: header values must be strings`);
-      return null;
-    }
-    const normalized = key.toLowerCase();
-    if (seen.has(normalized)) {
-      console.warn(`Agent Plugin ${manifest.name} skips invalid MCP server ${serverName}: duplicate header ${key}`);
-      return null;
-    }
-    seen.add(normalized);
-    entries.push([key, entry]);
-  }
-  const headers = Object.fromEntries(entries);
-  try {
-    new Headers(headers);
-  } catch {
-    console.warn(`Agent Plugin ${manifest.name} skips invalid MCP server ${serverName}: headers are not valid HTTP fields`);
-    return null;
-  }
-  return Object.keys(headers).length > 0 ? headers : undefined;
-}
-
-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, cwd: string): string {
-  const resolved = resolvePluginPath(path, cwd);
-  try {
-    return realpathSync(resolved);
-  } catch {
-    return resolved;
-  }
-}
-
-function isValidManifestAuthor(value: unknown): boolean {
-  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
-  return Object.entries(value).every(([key, entry]) => AUTHOR_FIELDS.has(key) && typeof entry === "string");
-}
-
-function isBareCommand(command: string): boolean {
-  return !command.includes("/") && !command.includes("\\") && !command.includes("${PLUGIN_ROOT}") && !command.includes("${PLUGIN_DATA}");
-}
-
-function resolvePluginCwd(value: unknown, pluginRoot: string, pluginDataDir: string): string | null {
-  if (value === undefined) return pluginRoot;
-  if (typeof value !== "string") return null;
-  const expanded = expandPluginPlaceholders(value, pluginRoot, pluginDataDir);
-  if (value.startsWith("./") || value === "${PLUGIN_ROOT}" || value.startsWith("${PLUGIN_ROOT}/")) {
-    return resolveRealContainedPath(pluginRoot, resolve(pluginRoot, expanded));
-  }
-  if (value === "${PLUGIN_DATA}" || value.startsWith("${PLUGIN_DATA}/")) {
-    return resolvePluginDataCwd(pluginDataDir, expanded);
-  }
-  return null;
-}
-
-function resolvePluginDataCwd(pluginDataDir: string, expanded: string): string | null {
-  if (existsSync(pluginDataDir) && !resolveRealContainedPath(dirname(pluginDataDir), pluginDataDir)) return null;
-  return resolveRealContainedPath(pluginDataDir, resolve(pluginDataDir, expanded), true);
-}
-
-function expandPluginPlaceholders(value: string, pluginRoot: string, pluginDataDir: string): string {
-  return value.replace(/\$\{PLUGIN_(ROOT|DATA)\}/g, (_, name: string) => name === "ROOT" ? pluginRoot : pluginDataDir);
-}
-
-function isValidAgentPluginUrl(value: string): boolean {
-  if (value.includes("${") || value.includes("$env:") || value.includes("{env:")) return false;
-
-  let url: URL;
-  try {
-    url = new URL(value);
-  } catch {
-    return false;
-  }
-  if (url.protocol !== "http:" && url.protocol !== "https:") return false;
-  if (url.username || url.password || url.hash) return false;
-  if (url.protocol === "https:") return true;
-  return isLoopbackHost(url.hostname);
-}
-
-function isLoopbackHost(hostname: string): boolean {
-  const host = hostname.toLowerCase();
-  if (host === "localhost" || host === "127.0.0.1" || host === "::1" || host === "[::1]") return true;
-  if (/^127(?:\.\d{1,3}){3}$/.test(host)) return true;
-  return false;
-}

package/node_modules/pi-mcp-adapter/agent-plugin-provenance.ts

@@ -1,36 +0,0 @@
-import type { ServerEntry } from "./types.ts";
-
-const LITERAL_PLUGIN_FIELDS = ["args", "env", "cwd", "headers"] as const;
-type LiteralPluginField = typeof LITERAL_PLUGIN_FIELDS[number];
-const BUILT_IN_AGENT_PLUGIN = Symbol("built-in-agent-plugin");
-type BuiltInAgentPluginEntry = ServerEntry & { [BUILT_IN_AGENT_PLUGIN]?: ReadonlySet<LiteralPluginField> };
-
-/** @internal */
-export function markBuiltInAgentPlugin(definition: ServerEntry, fields: LiteralPluginField[]): ServerEntry {
-  (definition as BuiltInAgentPluginEntry)[BUILT_IN_AGENT_PLUGIN] = new Set(fields);
-  return definition;
-}
-
-/** @internal */
-export function isBuiltInAgentPlugin(definition: ServerEntry, field: LiteralPluginField): boolean {
-  return (definition as BuiltInAgentPluginEntry)[BUILT_IN_AGENT_PLUGIN]?.has(field) === true;
-}
-
-/** @internal */
-export function cloneBuiltInAgentPluginEntry(source: ServerEntry): ServerEntry | undefined {
-  const fields = LITERAL_PLUGIN_FIELDS.filter(field => Object.hasOwn(source, field) && isBuiltInAgentPlugin(source, field));
-  if (fields.length === 0) return undefined;
-  return markBuiltInAgentPlugin(structuredClone(source), fields);
-}
-
-/** @internal */
-export function mergeBuiltInAgentPluginEntries(base: ServerEntry, next: ServerEntry): ServerEntry {
-  const merged = { ...base, ...next };
-  delete (merged as BuiltInAgentPluginEntry)[BUILT_IN_AGENT_PLUGIN];
-  const fields = LITERAL_PLUGIN_FIELDS.filter(field => {
-    const owner = Object.hasOwn(next, field) ? next : base;
-    return Object.hasOwn(owner, field) && isBuiltInAgentPlugin(owner, field);
-  });
-  if (fields.length > 0) markBuiltInAgentPlugin(merged, fields);
-  return merged;
-}