@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/pi-mcp-adapter/metadata-cache.js

@@ -0,0 +1,160 @@
+// @ts-nocheck
+// metadata-cache.ts - Persistent MCP metadata cache
+import { existsSync, readFileSync, writeFileSync, renameSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { getAgentPath } from "./agent-dir.js";
+import { createHash } from "node:crypto";
+import { getToolUiResourceUri } from "@modelcontextprotocol/ext-apps/app-bridge";
+import { formatToolName, isToolExcluded } from "./types.js";
+import { resourceNameToToolName } from "./resource-tools.js";
+import { extractToolUiStreamMode, interpolateEnvRecord, resolveBearerToken, resolveConfigPath } from "./utils.js";
+const CACHE_VERSION = 1;
+const CACHE_MAX_AGE_MS = 7 * 24 * 60 * 60 * 1000;
+export function getMetadataCachePath() {
+    return getAgentPath("mcp-cache.json");
+}
+export function loadMetadataCache() {
+    const cachePath = getMetadataCachePath();
+    if (!existsSync(cachePath))
+        return null;
+    try {
+        const raw = JSON.parse(readFileSync(cachePath, "utf-8"));
+        if (!raw || typeof raw !== "object")
+            return null;
+        if (raw.version !== CACHE_VERSION)
+            return null;
+        if (!raw.servers || typeof raw.servers !== "object")
+            return null;
+        return raw;
+    }
+    catch {
+        return null;
+    }
+}
+export function saveMetadataCache(cache) {
+    const cachePath = getMetadataCachePath();
+    const dir = dirname(cachePath);
+    mkdirSync(dir, { recursive: true });
+    let merged = { version: CACHE_VERSION, servers: {} };
+    try {
+        if (existsSync(cachePath)) {
+            const existing = JSON.parse(readFileSync(cachePath, "utf-8"));
+            if (existing && existing.version === CACHE_VERSION && existing.servers) {
+                merged.servers = { ...existing.servers };
+            }
+        }
+    }
+    catch {
+        // Ignore parse errors and proceed with empty cache
+    }
+    merged.version = CACHE_VERSION;
+    merged.servers = { ...merged.servers, ...cache.servers };
+    const tmpPath = `${cachePath}.${process.pid}.tmp`;
+    writeFileSync(tmpPath, JSON.stringify(merged, null, 2), "utf-8");
+    renameSync(tmpPath, cachePath);
+}
+export function computeServerHash(definition) {
+    // Hash only fields that affect server identity and tool/resource output.
+    // Exclude lifecycle, idleTimeout, requestTimeoutMs, debug — those are runtime behavior settings
+    // that don't change which tools a server exposes.
+    const identity = {
+        command: definition.command,
+        args: definition.args,
+        env: interpolateEnvRecord(definition.env),
+        cwd: resolveConfigPath(definition.cwd),
+        url: definition.url,
+        headers: interpolateEnvRecord(definition.headers),
+        auth: definition.auth,
+        bearerToken: resolveBearerToken(definition),
+        bearerTokenEnv: definition.bearerTokenEnv,
+        exposeResources: definition.exposeResources,
+        excludeTools: definition.excludeTools,
+    };
+    const normalized = stableStringify(identity);
+    return createHash("sha256").update(normalized).digest("hex");
+}
+export function isServerCacheValid(entry, definition, maxAgeMs = CACHE_MAX_AGE_MS) {
+    if (!entry || entry.configHash !== computeServerHash(definition))
+        return false;
+    if (!entry.cachedAt || typeof entry.cachedAt !== "number")
+        return false;
+    if (maxAgeMs > 0 && Date.now() - entry.cachedAt > maxAgeMs)
+        return false;
+    return true;
+}
+export function reconstructToolMetadata(serverName, entry, prefix, definition) {
+    const metadata = [];
+    for (const tool of entry.tools ?? []) {
+        if (!tool?.name)
+            continue;
+        if (isToolExcluded(tool.name, serverName, prefix, definition.excludeTools)) {
+            continue;
+        }
+        metadata.push({
+            name: formatToolName(tool.name, serverName, prefix),
+            originalName: tool.name,
+            description: tool.description ?? "",
+            inputSchema: tool.inputSchema,
+            uiResourceUri: tool.uiResourceUri,
+            uiStreamMode: tool.uiStreamMode,
+        });
+    }
+    if (definition.exposeResources !== false) {
+        for (const resource of entry.resources ?? []) {
+            if (!resource?.name || !resource?.uri)
+                continue;
+            const baseName = `get_${resourceNameToToolName(resource.name)}`;
+            if (isToolExcluded(baseName, serverName, prefix, definition.excludeTools)) {
+                continue;
+            }
+            metadata.push({
+                name: formatToolName(baseName, serverName, prefix),
+                originalName: baseName,
+                description: resource.description ?? `Read resource: ${resource.uri}`,
+                resourceUri: resource.uri,
+            });
+        }
+    }
+    return metadata;
+}
+export function serializeTools(tools) {
+    return tools
+        .filter(t => t?.name)
+        .map(t => ({
+        name: t.name,
+        description: t.description,
+        inputSchema: t.inputSchema,
+        uiResourceUri: tryGetToolUiResourceUri(t),
+        uiStreamMode: extractToolUiStreamMode(t._meta),
+    }));
+}
+export function serializeResources(resources) {
+    return resources
+        .filter(r => r?.name && r?.uri)
+        .map(r => ({
+        uri: r.uri,
+        name: r.name,
+        description: r.description,
+    }));
+}
+function stableStringify(value) {
+    if (value === null || value === undefined || typeof value !== "object") {
+        const serialized = JSON.stringify(value);
+        return serialized === undefined ? "undefined" : serialized;
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map(v => stableStringify(v)).join(",")}]`;
+    }
+    const obj = value;
+    const keys = Object.keys(obj).sort();
+    return `{${keys.map(k => `${JSON.stringify(k)}:${stableStringify(obj[k])}`).join(",")}}`;
+}
+function tryGetToolUiResourceUri(tool) {
+    try {
+        return getToolUiResourceUri({ _meta: tool._meta });
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=metadata-cache.js.map

package/dist/builtin-extensions/pi-mcp-adapter/metadata-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-cache.js","sourceRoot":"","sources":["../../../src/builtin-extensions/pi-mcp-adapter/metadata-cache.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,oDAAoD;AACpD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAElH,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AA4BjD,MAAM,UAAU,oBAAoB,GAAW;IAC7C,OAAO,YAAY,CAAC,gBAAgB,CAAC,CAAC;AAAA,CACvC;AAED,MAAM,UAAU,iBAAiB,GAAyB;IACxD,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;IACzC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;QACzD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACjD,IAAI,GAAG,CAAC,OAAO,KAAK,aAAa;YAAE,OAAO,IAAI,CAAC;QAC/C,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACjE,OAAO,GAAoB,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AAAA,CACF;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAoB,EAAQ;IAC5D,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;IACzC,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/B,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpC,IAAI,MAAM,GAAkB,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACpE,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAkB,CAAC;YAC/E,IAAI,QAAQ,IAAI,QAAQ,CAAC,OAAO,KAAK,aAAa,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACvE,MAAM,CAAC,OAAO,GAAG,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,mDAAmD;IACrD,CAAC;IAED,MAAM,CAAC,OAAO,GAAG,aAAa,CAAC;IAC/B,MAAM,CAAC,OAAO,GAAG,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;IAEzD,MAAM,OAAO,GAAG,GAAG,SAAS,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;IAClD,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACjE,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AAAA,CAChC;AAED,MAAM,UAAU,iBAAiB,CAAC,UAAuB,EAAU;IACjE,yEAAyE;IACzE,kGAAgG;IAChG,kDAAkD;IAClD,MAAM,QAAQ,GAA4B;QACxC,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,GAAG,EAAE,oBAAoB,CAAC,UAAU,CAAC,GAAG,CAAC;QACzC,GAAG,EAAE,iBAAiB,CAAC,UAAU,CAAC,GAAG,CAAC;QACtC,GAAG,EAAE,UAAU,CAAC,GAAG;QACnB,OAAO,EAAE,oBAAoB,CAAC,UAAU,CAAC,OAAO,CAAC;QACjD,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,WAAW,EAAE,kBAAkB,CAAC,UAAU,CAAC;QAC3C,cAAc,EAAE,UAAU,CAAC,cAAc;QACzC,eAAe,EAAE,UAAU,CAAC,eAAe;QAC3C,YAAY,EAAE,UAAU,CAAC,YAAY;KACtC,CAAC;IACF,MAAM,UAAU,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC7C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAAA,CAC9D;AAED,MAAM,UAAU,kBAAkB,CAChC,KAAuB,EACvB,UAAuB,EACvB,QAAQ,GAAW,gBAAgB,EAC1B;IACT,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,KAAK,iBAAiB,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/E,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACxE,IAAI,QAAQ,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,QAAQ,GAAG,QAAQ;QAAE,OAAO,KAAK,CAAC;IACzE,OAAO,IAAI,CAAC;AAAA,CACb;AAED,MAAM,UAAU,uBAAuB,CACrC,UAAkB,EAClB,KAAuB,EACvB,MAAmC,EACnC,UAAiE,EACjD;IAChB,MAAM,QAAQ,GAAmB,EAAE,CAAC;IAEpC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QACrC,IAAI,CAAC,IAAI,EAAE,IAAI;YAAE,SAAS;QAC1B,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC3E,SAAS;QACX,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC;YACnD,YAAY,EAAE,IAAI,CAAC,IAAI;YACvB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;YACnC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,UAAU,CAAC,eAAe,KAAK,KAAK,EAAE,CAAC;QACzC,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;YAC7C,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE,GAAG;gBAAE,SAAS;YAChD,MAAM,QAAQ,GAAG,OAAO,sBAAsB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAChE,IAAI,cAAc,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC1E,SAAS;YACX,CAAC;YAED,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,cAAc,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC;gBAClD,YAAY,EAAE,QAAQ;gBACtB,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,kBAAkB,QAAQ,CAAC,GAAG,EAAE;gBACrE,WAAW,EAAE,QAAQ,CAAC,GAAG;aAC1B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAAA,CACjB;AAED,MAAM,UAAU,cAAc,CAAC,KAAgB,EAAgB;IAC7D,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC;SACpB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACT,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,aAAa,EAAE,uBAAuB,CAAC,CAAC,CAAC;QACzC,YAAY,EAAE,uBAAuB,CAAC,CAAC,CAAC,KAAK,CAAC;KAC/C,CAAC,CAAC,CAAC;AAAA,CACP;AAED,MAAM,UAAU,kBAAkB,CAAC,SAAwB,EAAoB;IAC7E,OAAO,SAAS;SACb,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,GAAG,CAAC;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACT,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,WAAW,EAAE,CAAC,CAAC,WAAW;KAC3B,CAAC,CAAC,CAAC;AAAA,CACP;AAED,SAAS,eAAe,CAAC,KAAc,EAAU;IAC/C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvE,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACzC,OAAO,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC;IAC7D,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAC7D,CAAC;IACD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAAA,CAC1F;AAED,SAAS,uBAAuB,CAAC,IAAa,EAAsB;IAClE,IAAI,CAAC;QACH,OAAO,oBAAoB,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AAAA,CACF","sourcesContent":["// @ts-nocheck\n// metadata-cache.ts - Persistent MCP metadata cache\nimport { existsSync, readFileSync, writeFileSync, renameSync, mkdirSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\nimport { getAgentPath } from \"./agent-dir.ts\";\nimport { createHash } from \"node:crypto\";\nimport { getToolUiResourceUri } from \"@modelcontextprotocol/ext-apps/app-bridge\";\nimport type { McpTool, McpResource, ServerEntry, ToolMetadata } from \"./types.ts\";\nimport { formatToolName, isToolExcluded } from \"./types.ts\";\nimport { resourceNameToToolName } from \"./resource-tools.ts\";\nimport { extractToolUiStreamMode, interpolateEnvRecord, resolveBearerToken, resolveConfigPath } from \"./utils.ts\";\n\nconst CACHE_VERSION = 1;\nconst CACHE_MAX_AGE_MS = 7 * 24 * 60 * 60 * 1000;\n\nexport interface CachedTool {\n  name: string;\n  description?: string;\n  inputSchema?: unknown;\n  uiResourceUri?: string;\n  uiStreamMode?: \"eager\" | \"stream-first\";\n}\n\nexport interface CachedResource {\n  uri: string;\n  name: string;\n  description?: string;\n}\n\nexport interface ServerCacheEntry {\n  configHash: string;\n  tools: CachedTool[];\n  resources: CachedResource[];\n  cachedAt: number;\n}\n\nexport interface MetadataCache {\n  version: number;\n  servers: Record<string, ServerCacheEntry>;\n}\n\nexport function getMetadataCachePath(): string {\n  return getAgentPath(\"mcp-cache.json\");\n}\n\nexport function loadMetadataCache(): MetadataCache | null {\n  const cachePath = getMetadataCachePath();\n  if (!existsSync(cachePath)) return null;\n  try {\n    const raw = JSON.parse(readFileSync(cachePath, \"utf-8\"));\n    if (!raw || typeof raw !== \"object\") return null;\n    if (raw.version !== CACHE_VERSION) return null;\n    if (!raw.servers || typeof raw.servers !== \"object\") return null;\n    return raw as MetadataCache;\n  } catch {\n    return null;\n  }\n}\n\nexport function saveMetadataCache(cache: MetadataCache): void {\n  const cachePath = getMetadataCachePath();\n  const dir = dirname(cachePath);\n  mkdirSync(dir, { recursive: true });\n\n  let merged: MetadataCache = { version: CACHE_VERSION, servers: {} };\n  try {\n    if (existsSync(cachePath)) {\n      const existing = JSON.parse(readFileSync(cachePath, \"utf-8\")) as MetadataCache;\n      if (existing && existing.version === CACHE_VERSION && existing.servers) {\n        merged.servers = { ...existing.servers };\n      }\n    }\n  } catch {\n    // Ignore parse errors and proceed with empty cache\n  }\n\n  merged.version = CACHE_VERSION;\n  merged.servers = { ...merged.servers, ...cache.servers };\n\n  const tmpPath = `${cachePath}.${process.pid}.tmp`;\n  writeFileSync(tmpPath, JSON.stringify(merged, null, 2), \"utf-8\");\n  renameSync(tmpPath, cachePath);\n}\n\nexport function computeServerHash(definition: ServerEntry): string {\n  // Hash only fields that affect server identity and tool/resource output.\n  // Exclude lifecycle, idleTimeout, requestTimeoutMs, debug — those are runtime behavior settings\n  // that don't change which tools a server exposes.\n  const identity: Record<string, unknown> = {\n    command: definition.command,\n    args: definition.args,\n    env: interpolateEnvRecord(definition.env),\n    cwd: resolveConfigPath(definition.cwd),\n    url: definition.url,\n    headers: interpolateEnvRecord(definition.headers),\n    auth: definition.auth,\n    bearerToken: resolveBearerToken(definition),\n    bearerTokenEnv: definition.bearerTokenEnv,\n    exposeResources: definition.exposeResources,\n    excludeTools: definition.excludeTools,\n  };\n  const normalized = stableStringify(identity);\n  return createHash(\"sha256\").update(normalized).digest(\"hex\");\n}\n\nexport function isServerCacheValid(\n  entry: ServerCacheEntry,\n  definition: ServerEntry,\n  maxAgeMs: number = CACHE_MAX_AGE_MS\n): boolean {\n  if (!entry || entry.configHash !== computeServerHash(definition)) return false;\n  if (!entry.cachedAt || typeof entry.cachedAt !== \"number\") return false;\n  if (maxAgeMs > 0 && Date.now() - entry.cachedAt > maxAgeMs) return false;\n  return true;\n}\n\nexport function reconstructToolMetadata(\n  serverName: string,\n  entry: ServerCacheEntry,\n  prefix: \"server\" | \"none\" | \"short\",\n  definition: Pick<ServerEntry, \"exposeResources\" | \"excludeTools\">\n): ToolMetadata[] {\n  const metadata: ToolMetadata[] = [];\n\n  for (const tool of entry.tools ?? []) {\n    if (!tool?.name) continue;\n    if (isToolExcluded(tool.name, serverName, prefix, definition.excludeTools)) {\n      continue;\n    }\n\n    metadata.push({\n      name: formatToolName(tool.name, serverName, prefix),\n      originalName: tool.name,\n      description: tool.description ?? \"\",\n      inputSchema: tool.inputSchema,\n      uiResourceUri: tool.uiResourceUri,\n      uiStreamMode: tool.uiStreamMode,\n    });\n  }\n\n  if (definition.exposeResources !== false) {\n    for (const resource of entry.resources ?? []) {\n      if (!resource?.name || !resource?.uri) continue;\n      const baseName = `get_${resourceNameToToolName(resource.name)}`;\n      if (isToolExcluded(baseName, serverName, prefix, definition.excludeTools)) {\n        continue;\n      }\n\n      metadata.push({\n        name: formatToolName(baseName, serverName, prefix),\n        originalName: baseName,\n        description: resource.description ?? `Read resource: ${resource.uri}`,\n        resourceUri: resource.uri,\n      });\n    }\n  }\n\n  return metadata;\n}\n\nexport function serializeTools(tools: McpTool[]): CachedTool[] {\n  return tools\n    .filter(t => t?.name)\n    .map(t => ({\n      name: t.name,\n      description: t.description,\n      inputSchema: t.inputSchema,\n      uiResourceUri: tryGetToolUiResourceUri(t),\n      uiStreamMode: extractToolUiStreamMode(t._meta),\n    }));\n}\n\nexport function serializeResources(resources: McpResource[]): CachedResource[] {\n  return resources\n    .filter(r => r?.name && r?.uri)\n    .map(r => ({\n      uri: r.uri,\n      name: r.name,\n      description: r.description,\n    }));\n}\n\nfunction stableStringify(value: unknown): string {\n  if (value === null || value === undefined || typeof value !== \"object\") {\n    const serialized = JSON.stringify(value);\n    return serialized === undefined ? \"undefined\" : serialized;\n  }\n  if (Array.isArray(value)) {\n    return `[${value.map(v => stableStringify(v)).join(\",\")}]`;\n  }\n  const obj = value as Record<string, unknown>;\n  const keys = Object.keys(obj).sort();\n  return `{${keys.map(k => `${JSON.stringify(k)}:${stableStringify(obj[k])}`).join(\",\")}}`;\n}\n\nfunction tryGetToolUiResourceUri(tool: McpTool): string | undefined {\n  try {\n    return getToolUiResourceUri({ _meta: tool._meta });\n  } catch {\n    return undefined;\n  }\n}\n"]}

package/dist/builtin-extensions/pi-mcp-adapter/npx-resolver.d.ts

@@ -0,0 +1,7 @@
+export interface NpxResolution {
+    binPath: string;
+    extraArgs: string[];
+    isJs: boolean;
+}
+export declare function resolveNpxBinary(command: string, args: string[]): Promise<NpxResolution | null>;
+//# sourceMappingURL=npx-resolver.d.ts.map

package/dist/builtin-extensions/pi-mcp-adapter/npx-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npx-resolver.d.ts","sourceRoot":"","sources":["../../../src/builtin-extensions/pi-mcp-adapter/npx-resolver.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;CACf;AAQD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAgC/B","sourcesContent":["// @ts-nocheck\n// npx-resolver.ts - Resolve npx/npm exec binaries to avoid npm parent processes\nimport { existsSync, readFileSync, realpathSync, readdirSync, statSync, writeFileSync, renameSync, mkdirSync, openSync, readSync, closeSync } from \"node:fs\";\nimport { join, dirname, extname, resolve, sep } from \"node:path\";\nimport { getAgentPath } from \"./agent-dir.ts\";\nimport { spawn, spawnSync } from \"node:child_process\";\n\nconst CACHE_VERSION = 1;\nconst CACHE_TTL_MS = 24 * 60 * 60 * 1000;\n\ninterface NpxCacheEntry {\n  resolvedBin: string;\n  resolvedAt: number;\n  packageVersion?: string;\n  isJs: boolean;\n}\n\ninterface NpxCache {\n  version: number;\n  entries: Record<string, NpxCacheEntry>;\n}\n\nexport interface NpxResolution {\n  binPath: string;\n  extraArgs: string[];\n  isJs: boolean;\n}\n\ninterface ParsedInvocation {\n  packageSpec: string;\n  binName?: string;\n  extraArgs: string[];\n}\n\nexport async function resolveNpxBinary(\n  command: string,\n  args: string[]\n): Promise<NpxResolution | null> {\n  const parsed = command === \"npx\"\n    ? parseNpxArgs(args)\n    : command === \"npm\"\n      ? parseNpmExecArgs(args)\n      : null;\n\n  if (!parsed) return null;\n\n  const cacheKey = JSON.stringify([command, ...args]);\n  const cache = loadCache();\n  const cached = cache?.entries?.[cacheKey];\n\n  if (cached && Date.now() - cached.resolvedAt < CACHE_TTL_MS && existsSync(cached.resolvedBin)) {\n    return { binPath: cached.resolvedBin, extraArgs: parsed.extraArgs, isJs: cached.isJs };\n  }\n\n  const resolved = resolveFromNpmCache(parsed.packageSpec, parsed.binName);\n  if (resolved) {\n    saveCacheEntry(cacheKey, resolved);\n    return { binPath: resolved.resolvedBin, extraArgs: parsed.extraArgs, isJs: resolved.isJs };\n  }\n\n  // Slow path: force npx cache population\n  await forceNpxCache(parsed.packageSpec);\n  const resolvedAfterInstall = resolveFromNpmCache(parsed.packageSpec, parsed.binName);\n  if (resolvedAfterInstall) {\n    saveCacheEntry(cacheKey, resolvedAfterInstall);\n    return { binPath: resolvedAfterInstall.resolvedBin, extraArgs: parsed.extraArgs, isJs: resolvedAfterInstall.isJs };\n  }\n\n  return null;\n}\n\nfunction parseNpxArgs(args: string[]): ParsedInvocation | null {\n  const separatorIndex = args.indexOf(\"--\");\n  const before = separatorIndex >= 0 ? args.slice(0, separatorIndex) : args;\n  const after = separatorIndex >= 0 ? args.slice(separatorIndex + 1) : [];\n\n  const positionals: string[] = [];\n  let packageSpec: string | undefined;\n  let sawPackageFlag = false;\n  let foundFirstPositional = false;\n\n  for (let i = 0; i < before.length; i++) {\n    const arg = before[i];\n    if (foundFirstPositional) {\n      positionals.push(arg);\n      continue;\n    }\n    if (arg === \"-y\" || arg === \"--yes\") continue;\n    if (arg === \"-p\" || arg === \"--package\") {\n      const value = before[i + 1];\n      if (!value || value.startsWith(\"-\")) return null;\n      if (!packageSpec) packageSpec = value;\n      sawPackageFlag = true;\n      i++;\n      continue;\n    }\n    if (arg.startsWith(\"--package=\")) {\n      const value = arg.slice(\"--package=\".length);\n      if (!value) return null;\n      if (!packageSpec) packageSpec = value;\n      sawPackageFlag = true;\n      continue;\n    }\n    if (arg.startsWith(\"-\")) {\n      return null;\n    }\n    positionals.push(arg);\n    foundFirstPositional = true;\n  }\n\n  const separatedAfter = separatorIndex >= 0 && after.length > 0 ? [\"--\", ...after] : after;\n\n  if (sawPackageFlag) {\n    const binName = positionals[0];\n    if (!packageSpec || !binName) return null;\n    const extraArgs = positionals.slice(1).concat(separatedAfter);\n    return { packageSpec, binName, extraArgs };\n  }\n\n  const packagePositional = positionals[0];\n  if (!packagePositional) return null;\n  const extraArgs = positionals.slice(1).concat(separatedAfter);\n  return { packageSpec: packagePositional, extraArgs };\n}\n\nfunction parseNpmExecArgs(args: string[]): ParsedInvocation | null {\n  if (args[0] !== \"exec\") return null;\n  const execArgs = args.slice(1);\n  const separatorIndex = execArgs.indexOf(\"--\");\n  if (separatorIndex < 0) return null;\n\n  const before = execArgs.slice(0, separatorIndex);\n  const after = execArgs.slice(separatorIndex + 1);\n\n  let packageSpec: string | undefined;\n  for (let i = 0; i < before.length; i++) {\n    const arg = before[i];\n    if (arg === \"-y\" || arg === \"--yes\") continue;\n    if (arg === \"--package\") {\n      const value = before[i + 1];\n      if (!value || value.startsWith(\"-\")) return null;\n      if (!packageSpec) packageSpec = value;\n      i++;\n      continue;\n    }\n    if (arg.startsWith(\"--package=\")) {\n      const value = arg.slice(\"--package=\".length);\n      if (!value) return null;\n      if (!packageSpec) packageSpec = value;\n      continue;\n    }\n    if (arg.startsWith(\"-\")) {\n      return null;\n    }\n  }\n\n  const binName = after[0];\n  if (!packageSpec || !binName) return null;\n  const extraArgs = after.slice(1);\n  return { packageSpec, binName, extraArgs };\n}\n\nfunction resolveFromNpmCache(packageSpec: string, binName?: string): NpxCacheEntry | null {\n  const cacheDir = getNpmCacheDir();\n  if (!cacheDir) return null;\n\n  const packageName = extractPackageName(packageSpec);\n  if (!packageName) return null;\n\n  const packageDir = findCachedPackageDir(cacheDir, packageName);\n  if (!packageDir) return null;\n\n  const packageJsonPath = join(packageDir, \"package.json\");\n  if (!existsSync(packageJsonPath)) return null;\n\n  let pkg: { bin?: string | Record<string, string>; version?: string } | null = null;\n  try {\n    pkg = JSON.parse(readFileSync(packageJsonPath, \"utf-8\")) as {\n      bin?: string | Record<string, string>;\n      version?: string;\n    };\n  } catch {\n    return null;\n  }\n\n  const binField = pkg?.bin;\n  if (!binField) return null;\n\n  const candidates = buildBinCandidates(packageName, binName);\n  let chosenBinName: string | undefined;\n  let binRel: string | undefined;\n\n  if (typeof binField === \"string\") {\n    chosenBinName = defaultBinName(packageName);\n    binRel = binField;\n  } else {\n    for (const candidate of candidates) {\n      if (binField[candidate]) {\n        chosenBinName = candidate;\n        binRel = binField[candidate];\n        break;\n      }\n    }\n    if (!binRel) {\n      const firstEntry = Object.entries(binField)[0];\n      if (firstEntry) {\n        chosenBinName = firstEntry[0];\n        binRel = firstEntry[1];\n      }\n    }\n  }\n\n  if (!binRel) return null;\n\n  const nodeModulesDir = findNodeModulesDir(packageDir);\n  const binLink = chosenBinName ? join(nodeModulesDir, \".bin\", chosenBinName) : null;\n  let resolvedBin = binLink && existsSync(binLink) ? safeRealpath(binLink) : \"\";\n  if (!resolvedBin) {\n    resolvedBin = resolve(packageDir, binRel);\n    if (!existsSync(resolvedBin)) return null;\n  }\n\n  const isJs = detectJsBinary(resolvedBin);\n  return {\n    resolvedBin,\n    resolvedAt: Date.now(),\n    packageVersion: pkg?.version,\n    isJs,\n  };\n}\n\nconst FORCE_CACHE_TIMEOUT_MS = 30_000;\n\nasync function forceNpxCache(packageSpec: string): Promise<void> {\n  try {\n    await new Promise<void>((resolve, reject) => {\n      const proc = spawn(\n        \"npm\",\n        [\"exec\", \"--yes\", \"--package\", packageSpec, \"--\", \"node\", \"-e\", \"1\"],\n        { stdio: \"ignore\" }\n      );\n      const timer = setTimeout(() => {\n        proc.kill();\n        reject(new Error(\"timeout\"));\n      }, FORCE_CACHE_TIMEOUT_MS);\n      timer.unref();\n      proc.on(\"close\", () => { clearTimeout(timer); resolve(); });\n      proc.on(\"error\", (err) => { clearTimeout(timer); reject(err); });\n    });\n  } catch {\n    // Ignore failures, resolution will fall back to original command\n  }\n}\n\nfunction buildBinCandidates(packageName: string, explicitBin?: string): string[] {\n  const candidates: string[] = [];\n  if (explicitBin) candidates.push(explicitBin);\n\n  if (packageName.startsWith(\"@\")) {\n    const namePart = packageName.split(\"/\")[1] ?? \"\";\n    const scopePart = packageName.split(\"/\")[0]?.replace(\"@\", \"\") ?? \"\";\n    if (namePart) candidates.push(namePart);\n    if (scopePart && namePart) candidates.push(`${scopePart}-${namePart}`);\n  } else {\n    candidates.push(packageName);\n  }\n\n  return [...new Set(candidates.filter(Boolean))];\n}\n\nfunction extractPackageName(spec: string): string | null {\n  const trimmed = spec.trim();\n  if (!trimmed) return null;\n  if (trimmed.startsWith(\"@\")) {\n    const slashIndex = trimmed.indexOf(\"/\");\n    if (slashIndex < 0) return null;\n    const atIndex = trimmed.lastIndexOf(\"@\");\n    if (atIndex > slashIndex) {\n      return trimmed.slice(0, atIndex);\n    }\n    return trimmed;\n  }\n  const atIndex = trimmed.indexOf(\"@\");\n  return atIndex >= 0 ? trimmed.slice(0, atIndex) : trimmed;\n}\n\nfunction defaultBinName(packageName: string): string {\n  if (packageName.startsWith(\"@\")) {\n    const parts = packageName.split(\"/\");\n    return parts[1] ?? packageName.replace(\"@\", \"\").replace(\"/\", \"-\");\n  }\n  return packageName;\n}\n\nfunction findCachedPackageDir(cacheDir: string, packageName: string): string | null {\n  const npxDir = join(cacheDir, \"_npx\");\n  if (!existsSync(npxDir)) return null;\n\n  const packagePathParts = packageName.startsWith(\"@\")\n    ? packageName.split(\"/\")\n    : [packageName];\n\n  const candidates = readdirSync(npxDir, { withFileTypes: true })\n    .filter(entry => entry.isDirectory())\n    .map(entry => {\n      const full = join(npxDir, entry.name);\n      const mtime = safeStatMtime(full);\n      return { name: entry.name, mtime };\n    })\n    .sort((a, b) => b.mtime - a.mtime);\n\n  for (const entry of candidates) {\n    const pkgDir = join(npxDir, entry.name, \"node_modules\", ...packagePathParts);\n    if (existsSync(join(pkgDir, \"package.json\"))) {\n      return pkgDir;\n    }\n  }\n\n  return null;\n}\n\nfunction findNodeModulesDir(packageDir: string): string {\n  const parts = packageDir.split(sep);\n  const idx = parts.lastIndexOf(\"node_modules\");\n  if (idx >= 0) {\n    return parts.slice(0, idx + 1).join(sep);\n  }\n  return join(packageDir, \"..\");\n}\n\nfunction detectJsBinary(binPath: string): boolean {\n  const ext = extname(binPath).toLowerCase();\n  if (ext === \".js\" || ext === \".mjs\" || ext === \".cjs\") return true;\n  try {\n    const fd = openSync(binPath, \"r\");\n    try {\n      const buf = Buffer.alloc(256);\n      readSync(fd, buf, 0, 256, 0);\n      const firstLine = buf.toString(\"utf-8\").split(\"\\n\")[0] ?? \"\";\n      return firstLine.startsWith(\"#!\") && firstLine.includes(\"node\");\n    } finally {\n      closeSync(fd);\n    }\n  } catch {\n    return false;\n  }\n}\n\nlet npmCacheDirCached: string | null | undefined;\n\nfunction getNpmCacheDir(): string | null {\n  if (npmCacheDirCached !== undefined) return npmCacheDirCached;\n  if (process.env.NPM_CONFIG_CACHE) {\n    npmCacheDirCached = process.env.NPM_CONFIG_CACHE;\n    return npmCacheDirCached;\n  }\n  try {\n    const result = spawnSync(\"npm\", [\"config\", \"get\", \"cache\"], { encoding: \"utf-8\" });\n    if (result.status === 0) {\n      const path = String(result.stdout).trim();\n      npmCacheDirCached = path || null;\n      return npmCacheDirCached;\n    }\n  } catch {\n    npmCacheDirCached = null;\n    return null;\n  }\n  npmCacheDirCached = null;\n  return null;\n}\n\nfunction getNpxCachePath(): string {\n  return getAgentPath(\"mcp-npx-cache.json\");\n}\n\nfunction loadCache(): NpxCache | null {\n  const cachePath = getNpxCachePath();\n  if (!existsSync(cachePath)) return null;\n  try {\n    const raw = JSON.parse(readFileSync(cachePath, \"utf-8\"));\n    if (!raw || typeof raw !== \"object\") return null;\n    if (raw.version !== CACHE_VERSION) return null;\n    if (!raw.entries || typeof raw.entries !== \"object\") return null;\n    return raw as NpxCache;\n  } catch {\n    return null;\n  }\n}\n\nfunction saveCacheEntry(key: string, entry: NpxCacheEntry): void {\n  const cachePath = getNpxCachePath();\n  const dir = dirname(cachePath);\n  mkdirSync(dir, { recursive: true });\n\n  let merged: NpxCache = { version: CACHE_VERSION, entries: {} };\n  try {\n    if (existsSync(cachePath)) {\n      const existing = JSON.parse(readFileSync(cachePath, \"utf-8\")) as NpxCache;\n      if (existing && existing.version === CACHE_VERSION && existing.entries) {\n        merged.entries = { ...existing.entries };\n      }\n    }\n  } catch {\n    // Ignore parse errors\n  }\n\n  merged.entries[key] = entry;\n  const tmpPath = `${cachePath}.${process.pid}.tmp`;\n  writeFileSync(tmpPath, JSON.stringify(merged, null, 2), \"utf-8\");\n  renameSync(tmpPath, cachePath);\n}\n\nfunction safeRealpath(path: string): string {\n  try {\n    return realpathSync(path);\n  } catch {\n    return \"\";\n  }\n}\n\nfunction safeStatMtime(path: string): number {\n  try {\n    return statSync(path).mtimeMs;\n  } catch {\n    return 0;\n  }\n}\n"]}

package/dist/builtin-extensions/pi-mcp-adapter/npx-resolver.js

@@ -0,0 +1,388 @@
+// @ts-nocheck
+// npx-resolver.ts - Resolve npx/npm exec binaries to avoid npm parent processes
+import { existsSync, readFileSync, realpathSync, readdirSync, statSync, writeFileSync, renameSync, mkdirSync, openSync, readSync, closeSync } from "node:fs";
+import { join, dirname, extname, resolve, sep } from "node:path";
+import { getAgentPath } from "./agent-dir.js";
+import { spawn, spawnSync } from "node:child_process";
+const CACHE_VERSION = 1;
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+export async function resolveNpxBinary(command, args) {
+    const parsed = command === "npx"
+        ? parseNpxArgs(args)
+        : command === "npm"
+            ? parseNpmExecArgs(args)
+            : null;
+    if (!parsed)
+        return null;
+    const cacheKey = JSON.stringify([command, ...args]);
+    const cache = loadCache();
+    const cached = cache?.entries?.[cacheKey];
+    if (cached && Date.now() - cached.resolvedAt < CACHE_TTL_MS && existsSync(cached.resolvedBin)) {
+        return { binPath: cached.resolvedBin, extraArgs: parsed.extraArgs, isJs: cached.isJs };
+    }
+    const resolved = resolveFromNpmCache(parsed.packageSpec, parsed.binName);
+    if (resolved) {
+        saveCacheEntry(cacheKey, resolved);
+        return { binPath: resolved.resolvedBin, extraArgs: parsed.extraArgs, isJs: resolved.isJs };
+    }
+    // Slow path: force npx cache population
+    await forceNpxCache(parsed.packageSpec);
+    const resolvedAfterInstall = resolveFromNpmCache(parsed.packageSpec, parsed.binName);
+    if (resolvedAfterInstall) {
+        saveCacheEntry(cacheKey, resolvedAfterInstall);
+        return { binPath: resolvedAfterInstall.resolvedBin, extraArgs: parsed.extraArgs, isJs: resolvedAfterInstall.isJs };
+    }
+    return null;
+}
+function parseNpxArgs(args) {
+    const separatorIndex = args.indexOf("--");
+    const before = separatorIndex >= 0 ? args.slice(0, separatorIndex) : args;
+    const after = separatorIndex >= 0 ? args.slice(separatorIndex + 1) : [];
+    const positionals = [];
+    let packageSpec;
+    let sawPackageFlag = false;
+    let foundFirstPositional = false;
+    for (let i = 0; i < before.length; i++) {
+        const arg = before[i];
+        if (foundFirstPositional) {
+            positionals.push(arg);
+            continue;
+        }
+        if (arg === "-y" || arg === "--yes")
+            continue;
+        if (arg === "-p" || arg === "--package") {
+            const value = before[i + 1];
+            if (!value || value.startsWith("-"))
+                return null;
+            if (!packageSpec)
+                packageSpec = value;
+            sawPackageFlag = true;
+            i++;
+            continue;
+        }
+        if (arg.startsWith("--package=")) {
+            const value = arg.slice("--package=".length);
+            if (!value)
+                return null;
+            if (!packageSpec)
+                packageSpec = value;
+            sawPackageFlag = true;
+            continue;
+        }
+        if (arg.startsWith("-")) {
+            return null;
+        }
+        positionals.push(arg);
+        foundFirstPositional = true;
+    }
+    const separatedAfter = separatorIndex >= 0 && after.length > 0 ? ["--", ...after] : after;
+    if (sawPackageFlag) {
+        const binName = positionals[0];
+        if (!packageSpec || !binName)
+            return null;
+        const extraArgs = positionals.slice(1).concat(separatedAfter);
+        return { packageSpec, binName, extraArgs };
+    }
+    const packagePositional = positionals[0];
+    if (!packagePositional)
+        return null;
+    const extraArgs = positionals.slice(1).concat(separatedAfter);
+    return { packageSpec: packagePositional, extraArgs };
+}
+function parseNpmExecArgs(args) {
+    if (args[0] !== "exec")
+        return null;
+    const execArgs = args.slice(1);
+    const separatorIndex = execArgs.indexOf("--");
+    if (separatorIndex < 0)
+        return null;
+    const before = execArgs.slice(0, separatorIndex);
+    const after = execArgs.slice(separatorIndex + 1);
+    let packageSpec;
+    for (let i = 0; i < before.length; i++) {
+        const arg = before[i];
+        if (arg === "-y" || arg === "--yes")
+            continue;
+        if (arg === "--package") {
+            const value = before[i + 1];
+            if (!value || value.startsWith("-"))
+                return null;
+            if (!packageSpec)
+                packageSpec = value;
+            i++;
+            continue;
+        }
+        if (arg.startsWith("--package=")) {
+            const value = arg.slice("--package=".length);
+            if (!value)
+                return null;
+            if (!packageSpec)
+                packageSpec = value;
+            continue;
+        }
+        if (arg.startsWith("-")) {
+            return null;
+        }
+    }
+    const binName = after[0];
+    if (!packageSpec || !binName)
+        return null;
+    const extraArgs = after.slice(1);
+    return { packageSpec, binName, extraArgs };
+}
+function resolveFromNpmCache(packageSpec, binName) {
+    const cacheDir = getNpmCacheDir();
+    if (!cacheDir)
+        return null;
+    const packageName = extractPackageName(packageSpec);
+    if (!packageName)
+        return null;
+    const packageDir = findCachedPackageDir(cacheDir, packageName);
+    if (!packageDir)
+        return null;
+    const packageJsonPath = join(packageDir, "package.json");
+    if (!existsSync(packageJsonPath))
+        return null;
+    let pkg = null;
+    try {
+        pkg = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+    const binField = pkg?.bin;
+    if (!binField)
+        return null;
+    const candidates = buildBinCandidates(packageName, binName);
+    let chosenBinName;
+    let binRel;
+    if (typeof binField === "string") {
+        chosenBinName = defaultBinName(packageName);
+        binRel = binField;
+    }
+    else {
+        for (const candidate of candidates) {
+            if (binField[candidate]) {
+                chosenBinName = candidate;
+                binRel = binField[candidate];
+                break;
+            }
+        }
+        if (!binRel) {
+            const firstEntry = Object.entries(binField)[0];
+            if (firstEntry) {
+                chosenBinName = firstEntry[0];
+                binRel = firstEntry[1];
+            }
+        }
+    }
+    if (!binRel)
+        return null;
+    const nodeModulesDir = findNodeModulesDir(packageDir);
+    const binLink = chosenBinName ? join(nodeModulesDir, ".bin", chosenBinName) : null;
+    let resolvedBin = binLink && existsSync(binLink) ? safeRealpath(binLink) : "";
+    if (!resolvedBin) {
+        resolvedBin = resolve(packageDir, binRel);
+        if (!existsSync(resolvedBin))
+            return null;
+    }
+    const isJs = detectJsBinary(resolvedBin);
+    return {
+        resolvedBin,
+        resolvedAt: Date.now(),
+        packageVersion: pkg?.version,
+        isJs,
+    };
+}
+const FORCE_CACHE_TIMEOUT_MS = 30_000;
+async function forceNpxCache(packageSpec) {
+    try {
+        await new Promise((resolve, reject) => {
+            const proc = spawn("npm", ["exec", "--yes", "--package", packageSpec, "--", "node", "-e", "1"], { stdio: "ignore" });
+            const timer = setTimeout(() => {
+                proc.kill();
+                reject(new Error("timeout"));
+            }, FORCE_CACHE_TIMEOUT_MS);
+            timer.unref();
+            proc.on("close", () => { clearTimeout(timer); resolve(); });
+            proc.on("error", (err) => { clearTimeout(timer); reject(err); });
+        });
+    }
+    catch {
+        // Ignore failures, resolution will fall back to original command
+    }
+}
+function buildBinCandidates(packageName, explicitBin) {
+    const candidates = [];
+    if (explicitBin)
+        candidates.push(explicitBin);
+    if (packageName.startsWith("@")) {
+        const namePart = packageName.split("/")[1] ?? "";
+        const scopePart = packageName.split("/")[0]?.replace("@", "") ?? "";
+        if (namePart)
+            candidates.push(namePart);
+        if (scopePart && namePart)
+            candidates.push(`${scopePart}-${namePart}`);
+    }
+    else {
+        candidates.push(packageName);
+    }
+    return [...new Set(candidates.filter(Boolean))];
+}
+function extractPackageName(spec) {
+    const trimmed = spec.trim();
+    if (!trimmed)
+        return null;
+    if (trimmed.startsWith("@")) {
+        const slashIndex = trimmed.indexOf("/");
+        if (slashIndex < 0)
+            return null;
+        const atIndex = trimmed.lastIndexOf("@");
+        if (atIndex > slashIndex) {
+            return trimmed.slice(0, atIndex);
+        }
+        return trimmed;
+    }
+    const atIndex = trimmed.indexOf("@");
+    return atIndex >= 0 ? trimmed.slice(0, atIndex) : trimmed;
+}
+function defaultBinName(packageName) {
+    if (packageName.startsWith("@")) {
+        const parts = packageName.split("/");
+        return parts[1] ?? packageName.replace("@", "").replace("/", "-");
+    }
+    return packageName;
+}
+function findCachedPackageDir(cacheDir, packageName) {
+    const npxDir = join(cacheDir, "_npx");
+    if (!existsSync(npxDir))
+        return null;
+    const packagePathParts = packageName.startsWith("@")
+        ? packageName.split("/")
+        : [packageName];
+    const candidates = readdirSync(npxDir, { withFileTypes: true })
+        .filter(entry => entry.isDirectory())
+        .map(entry => {
+        const full = join(npxDir, entry.name);
+        const mtime = safeStatMtime(full);
+        return { name: entry.name, mtime };
+    })
+        .sort((a, b) => b.mtime - a.mtime);
+    for (const entry of candidates) {
+        const pkgDir = join(npxDir, entry.name, "node_modules", ...packagePathParts);
+        if (existsSync(join(pkgDir, "package.json"))) {
+            return pkgDir;
+        }
+    }
+    return null;
+}
+function findNodeModulesDir(packageDir) {
+    const parts = packageDir.split(sep);
+    const idx = parts.lastIndexOf("node_modules");
+    if (idx >= 0) {
+        return parts.slice(0, idx + 1).join(sep);
+    }
+    return join(packageDir, "..");
+}
+function detectJsBinary(binPath) {
+    const ext = extname(binPath).toLowerCase();
+    if (ext === ".js" || ext === ".mjs" || ext === ".cjs")
+        return true;
+    try {
+        const fd = openSync(binPath, "r");
+        try {
+            const buf = Buffer.alloc(256);
+            readSync(fd, buf, 0, 256, 0);
+            const firstLine = buf.toString("utf-8").split("\n")[0] ?? "";
+            return firstLine.startsWith("#!") && firstLine.includes("node");
+        }
+        finally {
+            closeSync(fd);
+        }
+    }
+    catch {
+        return false;
+    }
+}
+let npmCacheDirCached;
+function getNpmCacheDir() {
+    if (npmCacheDirCached !== undefined)
+        return npmCacheDirCached;
+    if (process.env.NPM_CONFIG_CACHE) {
+        npmCacheDirCached = process.env.NPM_CONFIG_CACHE;
+        return npmCacheDirCached;
+    }
+    try {
+        const result = spawnSync("npm", ["config", "get", "cache"], { encoding: "utf-8" });
+        if (result.status === 0) {
+            const path = String(result.stdout).trim();
+            npmCacheDirCached = path || null;
+            return npmCacheDirCached;
+        }
+    }
+    catch {
+        npmCacheDirCached = null;
+        return null;
+    }
+    npmCacheDirCached = null;
+    return null;
+}
+function getNpxCachePath() {
+    return getAgentPath("mcp-npx-cache.json");
+}
+function loadCache() {
+    const cachePath = getNpxCachePath();
+    if (!existsSync(cachePath))
+        return null;
+    try {
+        const raw = JSON.parse(readFileSync(cachePath, "utf-8"));
+        if (!raw || typeof raw !== "object")
+            return null;
+        if (raw.version !== CACHE_VERSION)
+            return null;
+        if (!raw.entries || typeof raw.entries !== "object")
+            return null;
+        return raw;
+    }
+    catch {
+        return null;
+    }
+}
+function saveCacheEntry(key, entry) {
+    const cachePath = getNpxCachePath();
+    const dir = dirname(cachePath);
+    mkdirSync(dir, { recursive: true });
+    let merged = { version: CACHE_VERSION, entries: {} };
+    try {
+        if (existsSync(cachePath)) {
+            const existing = JSON.parse(readFileSync(cachePath, "utf-8"));
+            if (existing && existing.version === CACHE_VERSION && existing.entries) {
+                merged.entries = { ...existing.entries };
+            }
+        }
+    }
+    catch {
+        // Ignore parse errors
+    }
+    merged.entries[key] = entry;
+    const tmpPath = `${cachePath}.${process.pid}.tmp`;
+    writeFileSync(tmpPath, JSON.stringify(merged, null, 2), "utf-8");
+    renameSync(tmpPath, cachePath);
+}
+function safeRealpath(path) {
+    try {
+        return realpathSync(path);
+    }
+    catch {
+        return "";
+    }
+}
+function safeStatMtime(path) {
+    try {
+        return statSync(path).mtimeMs;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=npx-resolver.js.map