@modootoday/pmcp 0.7.1 → 0.8.1

package/dist/chunk-C46YCY2I.js

@@ -1,1194 +0,0 @@
-// src/intent.ts
-function normaliseIntent(intent) {
-  return intent.toLowerCase().replaceAll(/[^\p{L}\p{N}\s]/gu, " ").split(/\s+/u).filter(Boolean).join(" ");
-}
-
-// src/marketplace.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2, readdirSync as readdirSync2 } from "fs";
-import { basename as basename2, dirname as dirname2, join as join2, resolve } from "path";
-
-// src/catalog.ts
-import { existsSync, readFileSync, readdirSync } from "fs";
-import { basename, dirname, isAbsolute, join, relative } from "path";
-var ASSET_KINDS = ["skill", "agent", "hook", "mcp"];
-var kindOf = (entry) => entry.kind ?? "skill";
-var SKIPPED_DIRS = /* @__PURE__ */ new Set([
-  "node_modules",
-  ".git",
-  ".cache",
-  ".turbo",
-  "coverage",
-  "__tests__",
-  "__fixtures__"
-]);
-var MAX_SKILL_DEPTH = 3;
-function readFrontmatter(source) {
-  if (!source.startsWith("---")) return {};
-  const end = source.indexOf("\n---", 3);
-  if (end === -1) return {};
-  const fields = {};
-  for (const line of source.slice(3, end).split("\n")) {
-    const match = /^([A-Za-z][A-Za-z0-9_-]*):\s*(.*)$/u.exec(line);
-    if (!match) continue;
-    const value = (match[2] ?? "").trim();
-    if (value === "" || value.startsWith("#")) continue;
-    fields[match[1]] = value.replace(/^["'](.*)["']$/u, "$1");
-  }
-  return fields;
-}
-function readBody(source) {
-  if (!source.startsWith("---")) return source;
-  const end = source.indexOf("\n---", 3);
-  if (end === -1) return source;
-  return source.slice(end + 4).replace(/^(?:\r?\n)+/u, "");
-}
-function skillFiles(packageDir) {
-  const found = [];
-  const stack = [[packageDir, 0]];
-  while (stack.length > 0) {
-    const next = stack.pop();
-    if (next === void 0) break;
-    const [dir, depth] = next;
-    let entries;
-    try {
-      entries = readdirSync(dir, { withFileTypes: true });
-    } catch {
-      continue;
-    }
-    for (const entry of entries) {
-      if (entry.isFile()) {
-        if (entry.name === "SKILL.md") found.push(join(dir, entry.name));
-        continue;
-      }
-      if (!entry.isDirectory()) continue;
-      if (SKIPPED_DIRS.has(entry.name)) continue;
-      if (depth + 1 <= MAX_SKILL_DEPTH)
-        stack.push([join(dir, entry.name), depth + 1]);
-    }
-  }
-  return found.sort();
-}
-function packageDirs(root) {
-  if (!existsSync(root)) return [];
-  const found = [];
-  for (const entry of readdirSync(root, { withFileTypes: true })) {
-    if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;
-    if (entry.name === ".bin" || entry.name === ".cache") continue;
-    const path = join(root, entry.name);
-    if (entry.name.startsWith("@")) {
-      if (!existsSync(path)) continue;
-      for (const scoped of readdirSync(path, { withFileTypes: true })) {
-        if (scoped.isDirectory() || scoped.isSymbolicLink()) {
-          found.push(join(path, scoped.name));
-        }
-      }
-      continue;
-    }
-    found.push(path);
-  }
-  return found;
-}
-function readManifest(dir) {
-  try {
-    const parsed = JSON.parse(
-      readFileSync(join(dir, "package.json"), "utf8")
-    );
-    return parsed !== null && typeof parsed === "object" ? parsed : null;
-  } catch {
-    return null;
-  }
-}
-function workspacePatterns(manifest) {
-  const field = manifest["workspaces"];
-  const list = Array.isArray(field) ? field : field?.packages;
-  if (!Array.isArray(list)) return [];
-  return list.filter((p) => typeof p === "string");
-}
-function expandBraces(pattern) {
-  const match = /\{([^{}]*)\}/u.exec(pattern);
-  if (!match) return [pattern];
-  const head = pattern.slice(0, match.index);
-  const tail = pattern.slice(match.index + match[0].length);
-  return match[1].split(",").flatMap((option) => expandBraces(`${head}${option}${tail}`));
-}
-function segmentMatcher(segment) {
-  const body = segment.split("*").map((part) => part.replace(/[.+?^${}()|[\]\\]/gu, "\\$&")).join("[^/]*");
-  return new RegExp(`^${body}$`, "u");
-}
-function globDirs(base, pattern) {
-  const segments = pattern.split("/").filter((s) => s !== "" && s !== ".");
-  const found = /* @__PURE__ */ new Set();
-  const walk = (dir, index) => {
-    if (index === segments.length) {
-      found.add(dir);
-      return;
-    }
-    const segment = segments[index];
-    if (!segment.includes("*")) {
-      const next = join(dir, segment);
-      if (existsSync(next)) walk(next, index + 1);
-      return;
-    }
-    let entries;
-    try {
-      entries = readdirSync(dir, { withFileTypes: true });
-    } catch {
-      return;
-    }
-    const children = entries.filter((e) => e.isDirectory() || e.isSymbolicLink()).filter((e) => !SKIPPED_DIRS.has(e.name));
-    if (segment === "**") {
-      walk(dir, index + 1);
-      for (const child of children) walk(join(dir, child.name), index);
-      return;
-    }
-    const matcher = segmentMatcher(segment);
-    for (const child of children) {
-      if (matcher.test(child.name)) walk(join(dir, child.name), index + 1);
-    }
-  };
-  walk(base, 0);
-  return [...found];
-}
-function workspacePackageDirs(root) {
-  const ordered = [];
-  const visited = /* @__PURE__ */ new Set();
-  const expand = (dir) => {
-    if (visited.has(dir)) return;
-    visited.add(dir);
-    const manifest = readManifest(dir);
-    if (manifest === null) return;
-    const included = /* @__PURE__ */ new Set();
-    const excluded = /* @__PURE__ */ new Set();
-    for (const raw of workspacePatterns(manifest)) {
-      const negated = raw.startsWith("!");
-      const pattern = negated ? raw.slice(1) : raw;
-      for (const alternative of expandBraces(pattern)) {
-        for (const match of globDirs(dir, alternative)) {
-          (negated ? excluded : included).add(match);
-        }
-      }
-    }
-    const members = [...included].filter((m) => !excluded.has(m) && existsSync(join(m, "package.json"))).sort();
-    for (const member of members) expand(member);
-    ordered.push(dir);
-  };
-  expand(root);
-  return ordered;
-}
-function nameOf(dir, named) {
-  const manifestName = readManifest(dir)?.["name"];
-  if (typeof manifestName === "string" && manifestName !== "") {
-    return manifestName;
-  }
-  if (named) return basename(dir);
-  return "";
-}
-function expandRootGlob(dir) {
-  if (!dir.includes("*")) return [dir];
-  const absolute = isAbsolute(dir);
-  const base = absolute ? "/" : ".";
-  return globDirs(base, dir).filter((d) => existsSync(join(d, "package.json"))).sort();
-}
-function readCatalog(options) {
-  const scopes = options.scopes ?? [];
-  const found = [];
-  const seen = /* @__PURE__ */ new Set();
-  const seenPaths = /* @__PURE__ */ new Set();
-  const direct = new Set(options.packages ?? []);
-  const packageDirsToRead = [
-    ...options.roots.flatMap(packageDirs),
-    ...direct,
-    ...(options.workspaces ?? []).flatMap(expandRootGlob).flatMap(workspacePackageDirs)
-  ];
-  for (const packageDir of packageDirsToRead) {
-    const packageName = nameOf(packageDir, direct.has(packageDir));
-    if (packageName === "") continue;
-    if (scopes.length > 0 && !scopes.some((s) => packageName.startsWith(s))) {
-      continue;
-    }
-    for (const path of skillFiles(packageDir)) {
-      if (seenPaths.has(path)) continue;
-      seenPaths.add(path);
-      let source;
-      try {
-        source = readFileSync(path, "utf8");
-      } catch {
-        continue;
-      }
-      const front = readFrontmatter(source);
-      const description = front["description"] ?? "";
-      if (description === "") continue;
-      const dirName = basename(dirname(path));
-      const slug = front["name"] ?? (dirName === basename(packageDir) ? packageName : dirName);
-      const name = `${packageName}/${slug}`;
-      if (seen.has(name)) continue;
-      seen.add(name);
-      found.push({
-        name,
-        package: packageName,
-        slug,
-        description,
-        path
-      });
-    }
-  }
-  for (const dir of options.marketplaces ?? []) {
-    for (const entry of readMarketplace(dir, options.onReject)) {
-      if (seen.has(entry.name)) {
-        options.onReject?.({
-          path: entry.path,
-          reason: `duplicate name ${entry.name}`
-        });
-        continue;
-      }
-      seen.add(entry.name);
-      found.push(entry);
-    }
-  }
-  return found.sort((a, b) => a.name.localeCompare(b.name));
-}
-function withoutBody({
-  path,
-  ...rest
-}) {
-  void path;
-  return rest;
-}
-function displayPath(root, entry) {
-  return relative(root, entry.path).replaceAll("\\", "/");
-}
-
-// src/marketplace.ts
-function parseScalar(raw) {
-  const value = raw.trim();
-  if (value.startsWith("[") && value.endsWith("]")) {
-    return value.slice(1, -1).split(",").map((item) => item.trim().replace(/^["'](.*)["']$/u, "$1")).filter(Boolean);
-  }
-  return value.replace(/^["'](.*)["']$/u, "$1");
-}
-function readMetadata(source) {
-  if (!source.startsWith("---")) return {};
-  const end = source.indexOf("\n---", 3);
-  if (end === -1) return {};
-  const out = {};
-  let inside = false;
-  for (const line of source.slice(3, end).split("\n")) {
-    if (/^metadata:\s*$/u.test(line)) {
-      inside = true;
-      continue;
-    }
-    if (!inside) continue;
-    if (!/^\s/u.test(line)) break;
-    const match = /^ {2}([A-Za-z][A-Za-z0-9_.-]*):\s*(.*)$/u.exec(line);
-    if (!match) continue;
-    const raw = match[2] ?? "";
-    if (raw.trim() === "" || raw.trim().startsWith("#")) continue;
-    out[match[1]] = parseScalar(raw);
-  }
-  return out;
-}
-function readFrontmatterText(source) {
-  if (!source.startsWith("---")) return "";
-  const end = source.indexOf("\n---", 3);
-  return end === -1 ? "" : source.slice(3, end).replace(/^\r?\n/u, "");
-}
-var asString = (value) => typeof value === "string" ? value : void 0;
-var asList = (value) => {
-  if (value === void 0) return [];
-  return typeof value === "string" ? [value] : value;
-};
-function readJson(path) {
-  try {
-    const parsed = JSON.parse(readFileSync2(path, "utf8"));
-    return parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : null;
-  } catch {
-    return null;
-  }
-}
-function markdownEntry(context, path, fallbackSlug, shape) {
-  const source = readFileSync2(path, "utf8");
-  const front = readFrontmatter(source);
-  const description = front["description"] ?? "";
-  if (description === "") {
-    context.onReject?.({ path, reason: "no description" });
-    return null;
-  }
-  const metadata = readMetadata(source);
-  const ownTier = asString(metadata["tier"]);
-  if (context.tier !== void 0 && ownTier !== void 0 && ownTier !== context.tier) {
-    context.onReject?.({
-      path,
-      reason: `metadata.tier ${ownTier} in a ${context.tier} marketplace`
-    });
-    return null;
-  }
-  const slug = front["name"] ?? fallbackSlug;
-  const prefix = `${context.marketplace}/${context.plugin}`;
-  return {
-    name: shape.namespace ? `${prefix}/${shape.namespace}/${slug}` : `${prefix}/${slug}`,
-    package: prefix,
-    slug,
-    description,
-    path,
-    tier: ownTier ?? context.tier,
-    metadata,
-    keywords: asList(metadata["keywords"]),
-    ...shape.kind ? { kind: shape.kind } : {},
-    ...shape.root ? { root: shape.root } : {}
-  };
-}
-function skillEntries(context) {
-  const dir = join2(context.pluginDir, "skills");
-  if (!existsSync2(dir)) return [];
-  const found = [];
-  for (const child of readdirSync2(dir, { withFileTypes: true })) {
-    if (!child.isDirectory()) continue;
-    const path = join2(dir, child.name, "SKILL.md");
-    if (!existsSync2(path)) continue;
-    const entry = markdownEntry(context, path, child.name, {});
-    if (entry) found.push(entry);
-  }
-  return found;
-}
-function commandEntries(context) {
-  const dir = join2(context.pluginDir, "commands");
-  if (!existsSync2(dir)) return [];
-  const found = [];
-  for (const child of readdirSync2(dir, { withFileTypes: true })) {
-    if (!child.isFile() || !child.name.endsWith(".md")) continue;
-    const path = join2(dir, child.name);
-    const entry = markdownEntry(context, path, basename2(child.name, ".md"), {
-      root: path
-    });
-    if (entry) found.push(entry);
-  }
-  return found;
-}
-function agentEntries(context) {
-  const dir = join2(context.pluginDir, "agents");
-  if (!existsSync2(dir)) return [];
-  const found = [];
-  for (const child of readdirSync2(dir, { withFileTypes: true })) {
-    let entry = null;
-    if (child.isFile() && child.name.endsWith(".md")) {
-      const path = join2(dir, child.name);
-      entry = markdownEntry(context, path, basename2(child.name, ".md"), {
-        kind: "agent",
-        root: path,
-        namespace: "agents"
-      });
-    } else if (child.isDirectory() && existsSync2(join2(dir, child.name, "agent.md"))) {
-      entry = markdownEntry(
-        context,
-        join2(dir, child.name, "agent.md"),
-        child.name,
-        {
-          kind: "agent",
-          namespace: "agents"
-        }
-      );
-    }
-    if (entry) found.push(entry);
-  }
-  return found;
-}
-function hookEntries(context, manifest) {
-  const declared = typeof manifest.hooks === "string" ? manifest.hooks : void 0;
-  const path = resolve(context.pluginDir, declared ?? "hooks/hooks.json");
-  if (!existsSync2(path)) return [];
-  const hooks = readJson(path);
-  if (hooks === null) {
-    context.onReject?.({ path, reason: "hooks.json is not a JSON object" });
-    return [];
-  }
-  const own = typeof hooks["description"] === "string" ? hooks["description"] : void 0;
-  const description = own ?? context.pluginDescription ?? "";
-  if (description === "") {
-    context.onReject?.({ path, reason: "no description" });
-    return [];
-  }
-  const prefix = `${context.marketplace}/${context.plugin}`;
-  return [
-    {
-      name: `${prefix}/hooks`,
-      package: prefix,
-      slug: "hooks",
-      description,
-      path,
-      tier: context.tier,
-      kind: "hook",
-      root: context.pluginDir
-    }
-  ];
-}
-function mcpEntries(context) {
-  const path = join2(context.pluginDir, ".mcp.json");
-  if (!existsSync2(path)) return [];
-  const config = readJson(path);
-  const servers = config?.["mcpServers"];
-  if (servers === null || typeof servers !== "object" || Array.isArray(servers)) {
-    context.onReject?.({ path, reason: ".mcp.json has no mcpServers object" });
-    return [];
-  }
-  const prefix = `${context.marketplace}/${context.plugin}`;
-  return Object.keys(servers).map((server) => ({
-    name: `${prefix}/mcp/${server}`,
-    package: prefix,
-    slug: server,
-    description: context.pluginDescription ? `MCP server ${server}. ${context.pluginDescription}` : `MCP server ${server} from plugin ${context.plugin}.`,
-    path,
-    tier: context.tier,
-    kind: "mcp",
-    root: path
-  }));
-}
-function readMarketplace(dir, onReject) {
-  const manifestPath = join2(dir, ".claude-plugin", "marketplace.json");
-  if (!existsSync2(manifestPath)) {
-    onReject?.({
-      path: dir,
-      reason: "no .claude-plugin/marketplace.json here"
-    });
-    return [];
-  }
-  let manifest;
-  try {
-    manifest = JSON.parse(
-      readFileSync2(manifestPath, "utf8")
-    );
-  } catch {
-    onReject?.({
-      path: manifestPath,
-      reason: "marketplace.json is not valid JSON"
-    });
-    return [];
-  }
-  const marketplace = manifest.name ?? "marketplace";
-  const found = [];
-  for (const plugin of manifest.plugins ?? []) {
-    if (!plugin.name || !plugin.source) continue;
-    const pluginDir = resolve(dir, plugin.source);
-    if (!existsSync2(pluginDir)) continue;
-    const pluginManifest = readJson(
-      join2(pluginDir, ".claude-plugin", "plugin.json")
-    ) ?? {};
-    const context = {
-      marketplace,
-      plugin: plugin.name,
-      pluginDir,
-      pluginDescription: typeof pluginManifest.description === "string" ? pluginManifest.description : void 0,
-      tier: manifest.metadata?.tier,
-      onReject
-    };
-    found.push(
-      ...skillEntries(context),
-      ...commandEntries(context),
-      ...agentEntries(context),
-      ...hookEntries(context, pluginManifest),
-      ...mcpEntries(context)
-    );
-  }
-  return found;
-}
-var assetRoot = (entry) => entry.root ?? dirname2(entry.path);
-
-// src/find.ts
-var DEFAULT_FIND_LIMIT = 5;
-function tokens(text) {
-  return normaliseIntent(text).split(" ").filter(Boolean);
-}
-function bigrams(text) {
-  const flat = normaliseIntent(text).replaceAll(" ", "");
-  const out = /* @__PURE__ */ new Set();
-  for (let i = 0; i + 1 < flat.length; i += 1) out.add(flat.slice(i, i + 2));
-  return out;
-}
-function lexicalScore(intent, description) {
-  const wanted = tokens(intent);
-  if (wanted.length === 0) return 0;
-  const have = new Set(tokens(description));
-  const overlap = wanted.filter((token) => have.has(token)).length / wanted.length;
-  const a = bigrams(intent);
-  const b = bigrams(description);
-  if (a.size === 0 || b.size === 0) return overlap / 2;
-  let shared = 0;
-  for (const gram of a) if (b.has(gram)) shared += 1;
-  const dice = 2 * shared / (a.size + b.size);
-  return (overlap + dice) / 2;
-}
-function cosine(a, b) {
-  if (a.length !== b.length) return 0;
-  let dot = 0;
-  let na = 0;
-  let nb = 0;
-  for (let i = 0; i < a.length; i += 1) {
-    dot += a[i] * b[i];
-    na += a[i] * a[i];
-    nb += b[i] * b[i];
-  }
-  if (na === 0 || nb === 0) return 0;
-  return dot / (Math.sqrt(na) * Math.sqrt(nb));
-}
-async function find(options) {
-  const limit = options.limit ?? DEFAULT_FIND_LIMIT;
-  const semantic = options.embedder !== void 0 && options.vectors !== void 0 && options.vectors.size > 0;
-  if (semantic) {
-    const embedder = options.embedder;
-    const vectors = options.vectors;
-    let query = options.cache?.get(options.intent) ?? null;
-    if (!query) {
-      query = await embedder.embed(options.intent);
-      options.cache?.put(options.intent, query);
-    }
-    const scored = [];
-    for (const entry of options.entries) {
-      const vector = vectors.get(entry.name);
-      if (!vector) continue;
-      scored.push({
-        name: entry.name,
-        package: entry.package,
-        description: entry.description,
-        score: cosine(query, vector)
-      });
-    }
-    if (scored.length === options.entries.length) {
-      return {
-        ranking: "semantic",
-        matches: rank(scored, limit)
-      };
-    }
-  }
-  return {
-    ranking: "lexical",
-    matches: rank(
-      options.entries.map((entry) => ({
-        name: entry.name,
-        package: entry.package,
-        description: entry.description,
-        score: lexicalScore(options.intent, entry.description)
-      })),
-      limit
-    )
-  };
-}
-function rank(matches2, limit) {
-  return matches2.filter((match) => match.score > 0).sort((a, b) => b.score - a.score || a.name.localeCompare(b.name)).slice(0, limit);
-}
-
-// src/server.ts
-import { createHash } from "crypto";
-import { readFileSync as readFileSync3, readdirSync as readdirSync3, realpathSync, statSync } from "fs";
-import {
-  basename as basename3,
-  dirname as dirname3,
-  isAbsolute as isAbsolute2,
-  join as join3,
-  relative as relative2,
-  resolve as resolve2,
-  sep
-} from "path";
-var READ_BUDGET_BYTES = 256 * 1024;
-var DESCRIBE_FILE_LIMIT = 200;
-var CATALOG_PAGE_SIZE = 8;
-var CATALOG_PAGE_MAX = 20;
-function matches(entry, filters) {
-  const kind = filters?.kind ?? "skill";
-  if (kind !== "any" && kindOf(entry) !== kind) return false;
-  if (!filters) return true;
-  const meta = entry.metadata ?? {};
-  const field = (key) => {
-    const value = meta[key];
-    return typeof value === "string" ? value : void 0;
-  };
-  if (filters.tier !== void 0 && entry.tier !== filters.tier) return false;
-  if (filters.package !== void 0 && entry.package !== filters.package)
-    return false;
-  if (filters.level !== void 0 && field("level") !== filters.level)
-    return false;
-  if (filters.domain !== void 0 && field("domain") !== filters.domain)
-    return false;
-  if (filters.medium !== void 0 && field("medium") !== filters.medium)
-    return false;
-  return true;
-}
-var sha256 = (bytes) => createHash("sha256").update(bytes).digest("hex");
-function listFiles(root) {
-  const files = [];
-  if (statSync(root).isFile()) {
-    const bytes = readFileSync3(root);
-    const only = {
-      path: basename3(root),
-      bytes: bytes.length,
-      sha256: sha256(bytes)
-    };
-    return { files: [only], truncated: false };
-  }
-  const stack = [root];
-  while (stack.length > 0) {
-    const dir = stack.pop();
-    for (const entry of readdirSync3(dir, { withFileTypes: true })) {
-      if (entry.name === "node_modules" || entry.name === ".git") continue;
-      const full = join3(dir, entry.name);
-      if (entry.isDirectory()) {
-        stack.push(full);
-        continue;
-      }
-      if (!entry.isFile()) continue;
-      if (files.length >= DESCRIBE_FILE_LIMIT)
-        return { files, truncated: true };
-      const bytes = readFileSync3(full);
-      files.push({
-        path: relative2(root, full).split(sep).join("/"),
-        bytes: bytes.length,
-        sha256: sha256(bytes)
-      });
-    }
-  }
-  files.sort((a, b) => a.path.localeCompare(b.path));
-  return { files, truncated: false };
-}
-function catalogItem(entry) {
-  return {
-    name: entry.name,
-    description: entry.description,
-    ...entry.tier === void 0 ? {} : { tier: entry.tier },
-    ...kindOf(entry) === "skill" ? {} : { kind: kindOf(entry) }
-  };
-}
-function createSkillTools(options) {
-  const load = options.loadCatalog ?? readCatalog;
-  let entries = null;
-  const catalog = () => {
-    entries ??= load({
-      roots: options.roots,
-      scopes: options.scopes,
-      marketplaces: options.marketplaces,
-      packages: options.packages,
-      workspaces: options.workspaces,
-      onReject: options.onReject
-    });
-    return entries;
-  };
-  return {
-    /**
-     * Grouped, and without bodies. The cheap overview and the search's miss
-     * path. Paged by package so a large catalog never arrives in one answer.
-     */
-    catalog(request = {}) {
-      const byPackage = /* @__PURE__ */ new Map();
-      let count = 0;
-      for (const entry of catalog()) {
-        if (!matches(entry, { tier: request.tier, kind: request.kind }))
-          continue;
-        count += 1;
-        const list = byPackage.get(entry.package) ?? [];
-        list.push(catalogItem(entry));
-        byPackage.set(entry.package, list);
-      }
-      const groups = [...byPackage.entries()].sort(
-        ([a], [b]) => a.localeCompare(b)
-      );
-      const size = Math.min(
-        Math.max(request.pageSize ?? CATALOG_PAGE_SIZE, 1),
-        CATALOG_PAGE_MAX
-      );
-      const totalPages = Math.max(1, Math.ceil(groups.length / size));
-      const page = Math.min(Math.max(request.page ?? 1, 1), totalPages);
-      return {
-        count,
-        page,
-        totalPages,
-        hasNext: page < totalPages,
-        packages: groups.slice((page - 1) * size, page * size).map(([pkg, skills]) => ({ package: pkg, skills }))
-      };
-    },
-    /** Ranked names. Returns; never loads a body. */
-    find(intent, limit, filters) {
-      const scoped = catalog().filter((entry) => matches(entry, filters)).map(
-        (entry) => entry.keywords && entry.keywords.length > 0 ? {
-          ...entry,
-          description: `${entry.description} ${entry.keywords.join(" ")}`
-        } : entry
-      );
-      return find({
-        entries: scoped,
-        intent,
-        limit,
-        embedder: options.embedder,
-        cache: options.cache,
-        vectors: options.vectors
-      }).then((result) => ({
-        ...result,
-        matches: result.matches.map((match) => ({
-          ...match,
-          description: catalog().find((entry) => entry.name === match.name)?.description ?? match.description
-        }))
-      }));
-    },
-    /** Every property of one skill and the files it carries, without bodies. */
-    describe(name) {
-      const entry = catalog().find((candidate) => candidate.name === name);
-      if (!entry) return null;
-      const source = readFileSync3(entry.path, "utf8");
-      const listing = listFiles(assetRoot(entry));
-      return {
-        name: entry.name,
-        kind: kindOf(entry),
-        package: entry.package,
-        description: entry.description,
-        tier: entry.tier,
-        metadata: entry.metadata ?? {},
-        frontmatter: readFrontmatterText(source),
-        files: listing.files,
-        filesTruncated: listing.truncated
-      };
-    },
-    /**
-     * One file inside a skill's directory. Paths that leave the directory,
-     * directly or through a link, are refused; nothing is ever executed.
-     */
-    read(name, path) {
-      const entry = catalog().find((candidate) => candidate.name === name);
-      if (!entry) return { ok: false, error: "unknown_skill", detail: name };
-      const wanted = path ?? relative2(assetRoot(entry), entry.path);
-      if (isAbsolute2(wanted) || wanted.split(/[\\/]/u).includes("..")) {
-        return { ok: false, error: "path_outside_skill", detail: wanted };
-      }
-      const scope = realpathSync(assetRoot(entry));
-      const single = statSync(scope).isFile();
-      const root = single ? dirname3(scope) : scope;
-      let target;
-      try {
-        target = realpathSync(
-          single && wanted === "" ? scope : resolve2(root, wanted)
-        );
-      } catch {
-        return { ok: false, error: "no_such_file", detail: wanted };
-      }
-      const inside = single ? target === scope : target === root || target.startsWith(root + sep);
-      if (!inside) {
-        return { ok: false, error: "path_outside_skill", detail: wanted };
-      }
-      const size = statSync(target).size;
-      if (size > READ_BUDGET_BYTES) {
-        return {
-          ok: false,
-          error: "over_budget",
-          detail: `${size} bytes > ${READ_BUDGET_BYTES}`
-        };
-      }
-      const bytes = readFileSync3(target);
-      return {
-        ok: true,
-        name: entry.name,
-        path: relative2(root, target).split(sep).join("/"),
-        bytes: bytes.length,
-        sha256: sha256(bytes),
-        text: bytes.toString("utf8")
-      };
-    },
-    /** One body, at the moment it is needed. */
-    call(name) {
-      const entry = catalog().find((candidate) => candidate.name === name);
-      if (!entry) return null;
-      const root = assetRoot(entry);
-      const listing = listFiles(root);
-      const own = relative2(root, entry.path).split(sep).join("/");
-      return {
-        name: entry.name,
-        body: readBody(readFileSync3(entry.path, "utf8")),
-        files: listing.files.filter(
-          (file) => file.path !== own && file.path !== basename3(entry.path)
-        ),
-        filesTruncated: listing.truncated
-      };
-    },
-    /** Drops the memoised catalog, so the next call re-reads the tree. */
-    refresh() {
-      entries = null;
-    },
-    entries: () => catalog().map(withoutBody),
-    /** The catalog with paths, for the Skills extension. The same array until refresh. */
-    skills: () => catalog()
-  };
-}
-
-// src/skills-extension.ts
-import { createHash as createHash2 } from "crypto";
-import { readFileSync as readFileSync4, readdirSync as readdirSync4, statSync as statSync2 } from "fs";
-import { basename as basename4, dirname as dirname4, join as join4, relative as relative3, sep as sep2 } from "path";
-import {
-  ProtocolError,
-  ProtocolErrorCode,
-  ResourceNotFoundError,
-  ResourceTemplate
-} from "@modelcontextprotocol/server";
-import { parse as parseYaml } from "yaml";
-import { z } from "zod";
-var SKILLS_EXTENSION = "io.modelcontextprotocol/skills";
-var AUTHORITY = "pmcp";
-var SKILL_NAME = /^[a-z0-9](?:[a-z0-9]|-(?!-))*[a-z0-9]$|^[a-z0-9]$/u;
-var MAX_RESOURCES = 512;
-var MAX_SKILL_BYTES = 16 * 1024 * 1024;
-var PAGE_SIZE = 50;
-var LIST_TTL_MS = 6e4;
-var digests = /* @__PURE__ */ new Map();
-function facts(path) {
-  const stat = statSync2(path);
-  const key = `${stat.mtimeMs}:${stat.size}`;
-  const cached = digests.get(path);
-  if (cached?.key === key) return cached;
-  const digest = `sha256:${createHash2("sha256").update(readFileSync4(path)).digest("hex")}`;
-  const fresh = { key, digest, size: stat.size };
-  digests.set(path, fresh);
-  return fresh;
-}
-function filesUnder(root) {
-  const found = [];
-  const stack = [root];
-  while (stack.length > 0) {
-    const dir = stack.pop();
-    for (const entry of readdirSync4(dir, { withFileTypes: true })) {
-      if (entry.name === "node_modules" || entry.name === ".git") continue;
-      const full = join4(dir, entry.name);
-      if (entry.isDirectory()) stack.push(full);
-      else if (entry.isFile()) found.push(full);
-      if (found.length > MAX_RESOURCES) return null;
-    }
-  }
-  return found.sort();
-}
-function frontmatterObject(source) {
-  if (!source.startsWith("---")) return null;
-  const end = source.indexOf("\n---", 3);
-  if (end === -1) return null;
-  try {
-    const parsed = parseYaml(source.slice(3, end));
-    return parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : null;
-  } catch {
-    return null;
-  }
-}
-var skillUri = (entry, file = "SKILL.md") => `skill://${AUTHORITY}/${entry.name}/${file}`;
-function extensionEntry(entry) {
-  if (kindOf(entry) !== "skill" || basename4(entry.path) !== "SKILL.md")
-    return null;
-  const frontmatter = frontmatterObject(readFileSync4(entry.path, "utf8"));
-  const name = frontmatter?.["name"];
-  if (typeof name !== "string" || name !== entry.slug || !SKILL_NAME.test(name))
-    return null;
-  if (basename4(dirname4(entry.path)) !== name) return null;
-  if (typeof frontmatter?.["description"] !== "string") return null;
-  const root = dirname4(entry.path);
-  const files = filesUnder(root);
-  if (files === null) return null;
-  let total = 0;
-  const resources = files.map((path) => {
-    const fact = facts(path);
-    total += fact.size;
-    const file = relative3(root, path).split(sep2).join("/");
-    return { uri: skillUri(entry, file), digest: fact.digest, size: fact.size };
-  });
-  if (total > MAX_SKILL_BYTES) return null;
-  return { uri: skillUri(entry), frontmatter, resources };
-}
-var MIME = {
-  ".md": "text/markdown",
-  ".json": "application/json",
-  ".txt": "text/plain",
-  ".py": "text/x-python",
-  ".js": "text/javascript",
-  ".mjs": "text/javascript",
-  ".ts": "text/typescript",
-  ".sh": "text/x-shellscript",
-  ".yaml": "text/yaml",
-  ".yml": "text/yaml",
-  ".toml": "text/plain"
-};
-var mimeOf = (path) => {
-  const dot = path.lastIndexOf(".");
-  return dot === -1 ? void 0 : MIME[path.slice(dot).toLowerCase()];
-};
-function registerSkillsExtension(server, skills) {
-  let memo = null;
-  const entries = () => {
-    const source = skills();
-    if (memo?.source === source) return memo.entries;
-    const map = /* @__PURE__ */ new Map();
-    for (const entry of source) {
-      let served = null;
-      try {
-        served = extensionEntry(entry);
-      } catch {
-      }
-      if (served) map.set(served.uri, served);
-    }
-    memo = { source, entries: map };
-    return map;
-  };
-  const pathOf = /* @__PURE__ */ new Map();
-  const locate = (uri) => {
-    if (pathOf.size === 0) {
-      for (const entry of skills()) {
-        if (kindOf(entry) === "skill" && basename4(entry.path) === "SKILL.md") {
-          pathOf.set(skillUri(entry), dirname4(entry.path));
-        }
-      }
-    }
-    for (const [skill, root] of pathOf) {
-      const prefix = skill.slice(0, -"SKILL.md".length);
-      if (uri.startsWith(prefix)) return join4(root, uri.slice(prefix.length));
-    }
-    return void 0;
-  };
-  server.server.registerCapabilities({
-    extensions: { [SKILLS_EXTENSION]: {} }
-  });
-  server.server.setRequestHandler(
-    "skills/list",
-    { params: z.object({ cursor: z.string().optional() }).passthrough() },
-    async (params) => {
-      const all = [...entries().values()];
-      const start = params.cursor ? Number.parseInt(params.cursor, 10) : 0;
-      if (!Number.isInteger(start) || start < 0 || start > all.length) {
-        throw new ProtocolError(
-          ProtocolErrorCode.InvalidParams,
-          "invalid cursor"
-        );
-      }
-      const end = start + PAGE_SIZE;
-      return {
-        resultType: "complete",
-        skills: all.slice(start, end),
-        ...end < all.length ? { nextCursor: String(end) } : {},
-        ttlMs: LIST_TTL_MS,
-        cacheScope: "public"
-      };
-    }
-  );
-  server.server.setRequestHandler(
-    "skills/get",
-    { params: z.object({ uri: z.string() }).passthrough() },
-    async (params) => {
-      const skill = entries().get(params.uri);
-      if (!skill) {
-        throw new ProtocolError(
-          ProtocolErrorCode.InvalidParams,
-          `not a skill this server serves: ${params.uri}`
-        );
-      }
-      return { resultType: "complete", skill };
-    }
-  );
-  server.registerResource(
-    "skill-files",
-    new ResourceTemplate(`skill://${AUTHORITY}/{+path}`, { list: void 0 }),
-    {
-      title: "Skill files",
-      description: "Files of the skills listed by skills/list."
-    },
-    async (uri) => {
-      const href = uri.toString();
-      const listed = [...entries().values()].some(
-        (skill) => skill.resources.some((resource) => resource.uri === href)
-      );
-      const path = listed ? locate(href) : void 0;
-      if (path === void 0) throw new ResourceNotFoundError(href);
-      const bytes = readFileSync4(path);
-      const mimeType = mimeOf(path);
-      const text = mimeType !== void 0;
-      return {
-        contents: [
-          text ? { uri: href, mimeType, text: bytes.toString("utf8") } : { uri: href, blob: bytes.toString("base64") }
-        ]
-      };
-    }
-  );
-}
-
-// src/mcp.ts
-import { McpServer } from "@modelcontextprotocol/server";
-import { z as z2 } from "zod";
-var SERVER_NAME = "pmcp";
-var readOnly = {
-  readOnlyHint: true,
-  destructiveHint: false,
-  idempotentHint: true,
-  openWorldHint: false
-};
-var readOnlyTool = (title) => ({
-  title,
-  annotations: { ...readOnly, title }
-});
-var kindInput = z2.enum(["skill", "agent", "hook", "mcp", "any"]).optional().describe(
-  "skill (default), agent, hook, mcp, or any. Commands are skills; agents, hooks and MCP servers are installed with pmcp add rather than read."
-);
-var asText = (value) => ({
-  content: [{ type: "text", text: JSON.stringify(value, null, 2) }]
-});
-function registerSkillTools(server, tools) {
-  server.registerTool(
-    "skill_catalog",
-    {
-      ...readOnlyTool("List skills"),
-      description: "Every skill the installed packages and marketplaces ship, grouped by package or plugin, with names, one-line descriptions and tier, and no bodies. Paged by group. Use it to see what exists, or when skill_find returns nothing. Pass kind to list agents, hooks or MCP servers instead.",
-      inputSchema: z2.object({
-        page: z2.number().int().min(1).optional(),
-        pageSize: z2.number().int().min(1).max(20).optional(),
-        tier: z2.enum(["open", "free", "paid", "internal"]).optional(),
-        kind: kindInput
-      })
-    },
-    async (request) => asText(tools.catalog(request))
-  );
-  server.registerTool(
-    "skill_find",
-    {
-      ...readOnlyTool("Find skills"),
-      description: "Ranked skill names for an intent. Describe the problem in a full sentence in English rather than a keyword: a single word matches far worse, and the ranking is over descriptions. Returns names only -- read one with skill_call.",
-      inputSchema: z2.object({
-        intent: z2.string().min(1).max(256).describe("What you are trying to do, as an English sentence."),
-        limit: z2.number().int().min(1).max(25).optional(),
-        filters: z2.object({
-          kind: kindInput,
-          tier: z2.enum(["open", "free", "paid", "internal"]).optional(),
-          package: z2.string().optional(),
-          level: z2.string().optional(),
-          domain: z2.string().optional(),
-          medium: z2.string().optional()
-        }).optional().describe("Exact-match filters over the catalog before ranking.")
-      })
-    },
-    async ({ intent, limit, filters }) => asText(await tools.find(intent, limit, filters))
-  );
-  server.registerTool(
-    "skill_describe",
-    {
-      ...readOnlyTool("Describe a skill"),
-      description: "Frontmatter, metadata (tier, level, requirements, licence, approval), and the files the skill carries with sizes and sha256, without any body. Use it to decide between candidates before skill_call.",
-      inputSchema: z2.object({
-        name: z2.string().min(1).describe("The skill name skill_find or skill_catalog returned.")
-      })
-    },
-    async ({ name }) => {
-      const described = tools.describe(name);
-      if (!described) {
-        return {
-          ...asText({
-            error: "unknown_skill",
-            name,
-            hint: "Call skill_catalog for the names that exist."
-          }),
-          isError: true
-        };
-      }
-      return asText(described);
-    }
-  );
-  server.registerTool(
-    "skill_read",
-    {
-      ...readOnlyTool("Read a skill file"),
-      description: "A reference or script file inside one skill's directory in this catalog, as text, with its sha256. It reads only files the catalog ships and calls no external API; path is relative to the skill, as skill_call and skill_describe list it (layout: https://pmcp.build). Scripts are returned as text, never run. Files over 256 KiB and paths outside the skill are refused.",
-      inputSchema: z2.object({
-        name: z2.string().min(1),
-        path: z2.string().min(1).optional().describe(
-          "Path relative to the skill directory, as skill_describe lists it. Defaults to SKILL.md."
-        )
-      })
-    },
-    async ({ name, path }) => {
-      const result = tools.read(name, path);
-      if (!result.ok) return { ...asText(result), isError: true };
-      const { text, ...header } = result;
-      return {
-        content: [
-          { type: "text", text: JSON.stringify(header) },
-          { type: "text", text }
-        ]
-      };
-    }
-  );
-  server.registerTool(
-    "skill_call",
-    {
-      ...readOnlyTool("Read a skill"),
-      description: "The body of a single skill, by the name skill_find or skill_catalog returned, followed by a list of the reference and script files the skill carries, if any. This is the only call that costs a document.",
-      inputSchema: z2.object({
-        name: z2.string().min(1).describe("The skill name, as <package>/<slug>.")
-      })
-    },
-    async ({ name }) => {
-      const found = tools.call(name);
-      if (!found) {
-        return {
-          ...asText({
-            error: "unknown_skill",
-            name,
-            hint: "Call skill_catalog for the names that exist."
-          }),
-          isError: true
-        };
-      }
-      if (found.files.length === 0) {
-        return { content: [{ type: "text", text: found.body }] };
-      }
-      const lines = found.files.map(
-        (file) => `- ${file.path} (${file.bytes} bytes, sha256 ${file.sha256.slice(0, 12)})`
-      );
-      if (found.filesTruncated)
-        lines.push("- (list cut; skill_describe has the rest)");
-      const manifest = [
-        `Files in skill ${found.name}, each returned by skill_read with this name and the path:`,
-        ...lines
-      ].join("\n");
-      return {
-        content: [
-          { type: "text", text: found.body },
-          { type: "text", text: manifest }
-        ]
-      };
-    }
-  );
-  return server;
-}
-function createSkillServer(options) {
-  const server = new McpServer({ name: SERVER_NAME, version: "0.7.1" });
-  const tools = createSkillTools(options);
-  registerSkillsExtension(server, tools.skills);
-  return registerSkillTools(server, tools);
-}
-
-export {
-  normaliseIntent,
-  readMetadata,
-  readFrontmatterText,
-  readMarketplace,
-  assetRoot,
-  ASSET_KINDS,
-  kindOf,
-  SKIPPED_DIRS,
-  MAX_SKILL_DEPTH,
-  readFrontmatter,
-  readBody,
-  readCatalog,
-  withoutBody,
-  displayPath,
-  DEFAULT_FIND_LIMIT,
-  lexicalScore,
-  cosine,
-  find,
-  READ_BUDGET_BYTES,
-  DESCRIBE_FILE_LIMIT,
-  CATALOG_PAGE_SIZE,
-  CATALOG_PAGE_MAX,
-  createSkillTools,
-  SKILLS_EXTENSION,
-  skillUri,
-  extensionEntry,
-  registerSkillsExtension,
-  SERVER_NAME,
-  registerSkillTools,
-  createSkillServer
-};
-//# sourceMappingURL=chunk-C46YCY2I.js.map