@modootoday/pmcp 0.9.0 → 0.9.2

package/README.md

@@ -142,21 +142,25 @@ breaks the specification is reported, and `pmcp validate [<skill-dir>...]` check
 directories or every skill the catalog reaches (name rules and length, description and
 compatibility length, field types, name matching the directory, duplicate names).
 
-`metadata` keeps strings, string lists and maps of those one level down, so
-`requires: {mcp, bin, env, capabilities, gpu-gb}` reaches `skill_describe`; deeper
-nesting is dropped.
+`metadata` keeps strings, string lists and maps of those one level down; `skill_describe`
+reports a map as dotted keys, so `requires: {mcp, gpu-gb}` arrives as `requires.mcp` and
+`requires.gpu-gb`. Deeper nesting is dropped.
+
+Output schemas accept additional properties, so a field added later does not break a
+client that cached an earlier tool list. An answer to a call without the newer inputs keeps
+the earlier shape.
 
 Since 0.9.0 a skill can list `metadata.verified-runtimes`, a list drawn from `claude-code`,
 `codex-cli`, `gemini-cli`, `grok-cli` and `antigravity`, meaning its effect was verified on
-that runtime. `skill_find` and `skill_catalog` items carry `verifiedRuntimes` (omitted when
-empty) and accept `runtime` and `verifiedOnly`. `runtime` never removes a skill: it marks
+that runtime. `skill_find` and `skill_catalog` accept `runtime` and `verifiedOnly`; when either
+is given, items carry `verifiedRuntimes` (omitted when empty). `runtime` never removes a skill: it marks
 each item `verified` and lists verified ones first (within a package group in
 `skill_catalog`). `verifiedOnly` drops the rest, keeping those verified on `runtime`, or on
 any runtime when none is given. Without `runtime` the answer is ordered exactly as before.
 A server can opt in with `rankByClientRuntime: true`: then, when `runtime` is not passed and
 the MCP client's name is recognised (`claude-code`, `codex`, `gemini`, `grok`,
 `antigravity`), that runtime is used for the ordering only, never for filtering.
-`skill_find` answers with `runtime`, the one the ordering used, or `null`.
+`skill_find` then answers with `runtime`, the one the ordering used, or `null`.
 
 `pmcp serve --prompts` also offers one prompt per skill, for hosts that turn prompts into
 commands; the prompt's text is the skill body and its file list, with an optional `task`.

package/dist/{chunk-PXNRZXL6.js → chunk-A5NOHVHN.js}

@@ -1103,7 +1103,8 @@ function matches(entry, filters) {
   }
   return true;
 }
-function verification(entry, runtime) {
+function verification(entry, runtime, asked) {
+  if (!asked) return {};
   const verifiedRuntimes = verifiedRuntimesOf(entry?.metadata);
   return {
     ...verifiedRuntimes.length > 0 ? { verifiedRuntimes } : {},
@@ -1116,15 +1117,28 @@ function verifiedFirst(items) {
     ...items.filter((item) => item.verified !== true)
   ];
 }
-function catalogItem(entry, runtime) {
+function catalogItem(entry, runtime, asked) {
   return {
     name: entry.name,
     description: entry.description,
     ...entry.tier === void 0 ? {} : { tier: entry.tier },
     ...kindOf(entry) === "skill" ? {} : { kind: kindOf(entry) },
-    ...verification(entry, runtime)
+    ...verification(entry, runtime, asked)
   };
 }
+function flatMetadata(metadata) {
+  const flat = {};
+  for (const [key, value] of Object.entries(metadata ?? {})) {
+    if (typeof value === "string" || Array.isArray(value)) {
+      flat[key] = value;
+      continue;
+    }
+    for (const [inner, leaf] of Object.entries(value ?? {})) {
+      flat[`${key}.${inner}`] = leaf;
+    }
+  }
+  return flat;
+}
 function createSkillTools(options) {
   const load = options.loadCatalog ?? readCatalog;
   let entries = null;
@@ -1149,6 +1163,7 @@ function createSkillTools(options) {
     catalog(request = {}) {
       const client = options.rankByClientRuntime ? request.clientRuntime : null;
       const runtime = request.runtime ?? client ?? null;
+      const asked = runtime !== null || request.verifiedOnly !== void 0;
       const byPackage = /* @__PURE__ */ new Map();
       let count = 0;
       for (const entry of catalog()) {
@@ -1161,7 +1176,7 @@ function createSkillTools(options) {
           continue;
         count += 1;
         const list = byPackage.get(entry.package) ?? [];
-        list.push(catalogItem(entry, runtime));
+        list.push(catalogItem(entry, runtime, asked));
         byPackage.set(entry.package, list);
       }
       const groups = [...byPackage.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([pkg, skills]) => [
@@ -1186,6 +1201,7 @@ function createSkillTools(options) {
     find(intent, limit, filters, clientRuntime) {
       const client = options.rankByClientRuntime ? clientRuntime : null;
       const runtime = filters?.runtime ?? client ?? null;
+      const asked = runtime !== null || filters?.verifiedOnly !== void 0;
       const scoped = catalog().filter((entry) => matches(entry, filters)).map(
         (entry) => entry.keywords && entry.keywords.length > 0 ? {
           ...entry,
@@ -1205,13 +1221,13 @@ function createSkillTools(options) {
           return {
             ...match,
             description: entry?.description ?? match.description,
-            ...verification(entry, runtime)
+            ...verification(entry, runtime, asked)
           };
         });
         const ordered = runtime === null ? marked : verifiedFirst(marked);
         return {
           ...result,
-          runtime,
+          ...asked ? { runtime } : {},
           matches: runtime === null ? ordered : ordered.slice(0, limit ?? DEFAULT_FIND_LIMIT)
         };
       });
@@ -1228,9 +1244,9 @@ function createSkillTools(options) {
         package: entry.package,
         description: entry.description,
         ...entry.tier === void 0 ? {} : { tier: entry.tier },
-        metadata: entry.metadata ?? {},
+        metadata: flatMetadata(entry.metadata),
         frontmatter: readFrontmatterText(source),
-        files: [...listing2.files],
+        files: listing2.files.map((file) => ({ ...file })),
         filesTruncated: listing2.truncated
       };
     },
@@ -1404,7 +1420,7 @@ function registerSkillsExtension(server, skills, options = {}) {
 import { z as z3 } from "zod";
 var kind = z3.enum(ASSET_KINDS);
 var runtimeSchema = z3.enum(RUNTIMES);
-var catalogItemSchema = z3.object({
+var catalogItemSchema = z3.looseObject({
   name: z3.string(),
   description: z3.string(),
   tier: z3.string().optional(),
@@ -1412,20 +1428,20 @@ var catalogItemSchema = z3.object({
   verifiedRuntimes: z3.array(runtimeSchema).optional(),
   verified: z3.boolean().optional()
 });
-var catalogResponseSchema = z3.object({
+var catalogResponseSchema = z3.looseObject({
   count: z3.number().int(),
   page: z3.number().int(),
   totalPages: z3.number().int(),
   hasNext: z3.boolean(),
   packages: z3.array(
-    z3.object({ package: z3.string(), skills: z3.array(catalogItemSchema) })
+    z3.looseObject({ package: z3.string(), skills: z3.array(catalogItemSchema) })
   )
 });
-var findResultSchema = z3.object({
+var findResultSchema = z3.looseObject({
   ranking: z3.enum(["semantic", "lexical"]),
-  runtime: runtimeSchema.nullable(),
+  runtime: runtimeSchema.nullable().optional(),
   matches: z3.array(
-    z3.object({
+    z3.looseObject({
       name: z3.string(),
       package: z3.string(),
       description: z3.string(),
@@ -1435,16 +1451,12 @@ var findResultSchema = z3.object({
     })
   )
 });
-var skillFileSchema = z3.object({
+var skillFileSchema = z3.looseObject({
   path: z3.string(),
   bytes: z3.number().int(),
   sha256: z3.string()
 });
-var metadataLeafSchema = z3.union([
-  z3.string(),
-  z3.array(z3.string()).readonly()
-]);
-var describeResponseSchema = z3.object({
+var describeResponseSchema = z3.looseObject({
   name: z3.string(),
   kind,
   package: z3.string(),
@@ -1452,16 +1464,13 @@ var describeResponseSchema = z3.object({
   tier: z3.string().optional(),
   metadata: z3.record(
     z3.string(),
-    z3.union([
-      metadataLeafSchema,
-      z3.record(z3.string(), metadataLeafSchema).readonly()
-    ])
+    z3.union([z3.string(), z3.array(z3.string()).readonly()])
   ),
   frontmatter: z3.string(),
   files: z3.array(skillFileSchema),
   filesTruncated: z3.boolean()
 });
-var bundleResponseSchema = z3.object({
+var bundleResponseSchema = z3.looseObject({
   name: z3.string(),
   truncated: z3.boolean(),
   files: z3.array(
@@ -1521,7 +1530,7 @@ var kindInput = z4.enum(["skill", "agent", "hook", "mcp", "any"]).optional().des
 );
 var tierInput = z4.enum(["open", "free", "paid", "internal"]).optional();
 var runtimeInput = runtimeSchema.optional().describe(
-  "A runtime (claude-code, codex-cli, gemini-cli, grok-cli, antigravity). Skills whose metadata.verified-runtimes lists it are marked verified and listed first; the rest are kept. Without it, the runtime of the connected client is used for the same ordering when it is recognised."
+  "A runtime (claude-code, codex-cli, gemini-cli, grok-cli, antigravity). Skills whose metadata.verified-runtimes lists it are marked verified and listed first; the rest are kept. Without it, the order is the same as without verification data."
 );
 var verifiedOnlyInput = z4.boolean().optional().describe(
   "Drop skills that are not verified: on the given runtime, or on any runtime when none is given. The detected client runtime never filters."
@@ -1641,7 +1650,7 @@ function registerDescribeTool(server, tools) {
     "skill_describe",
     {
       ...readOnlyTool("Describe a skill"),
-      description: "One skill's frontmatter, metadata (tier, level, requirements as a nested requires map, verified-runtimes, licence, approval), and the files it carries with sizes and sha256, without any body.",
+      description: "One skill's frontmatter, metadata (tier, level, requirements as requires.<name> entries, verified-runtimes, licence, approval), and the files it carries with sizes and sha256, without any body.",
       inputSchema: z8.object({ name: skillNameInput }),
       outputSchema: describeResponseSchema
     },
@@ -1718,7 +1727,7 @@ function registerReadTool(server, tools) {
 
 // src/mcp.ts
 var SERVER_NAME = "pmcp";
-var SERVER_VERSION = "0.9.0";
+var SERVER_VERSION = "0.9.2";
 function registerSkillTools(server, tools) {
   registerCatalogTool(server, tools);
   registerFindTool(server, tools);
@@ -1793,4 +1802,4 @@ export {
   registerSkillTools,
   createSkillServer
 };
-//# sourceMappingURL=chunk-PXNRZXL6.js.map
+//# sourceMappingURL=chunk-A5NOHVHN.js.map

package/dist/{chunk-AKPSLZRJ.js → chunk-CMZ7OTQD.js}

@@ -1,6 +1,6 @@
 import {
   normaliseIntent
-} from "./chunk-PXNRZXL6.js";
+} from "./chunk-A5NOHVHN.js";
 
 // src/cache.ts
 async function openDatabase(path) {
@@ -131,4 +131,4 @@ export {
   DEFAULT_INTENT_CACHE_LIMIT,
   openIntentCache
 };
-//# sourceMappingURL=chunk-AKPSLZRJ.js.map
+//# sourceMappingURL=chunk-CMZ7OTQD.js.map

package/dist/{chunk-PWEAKJZ3.js → chunk-D3OZVMHN.js}

@@ -2,7 +2,7 @@ import {
   frontmatterObject,
   readCatalog,
   specProblems
-} from "./chunk-PXNRZXL6.js";
+} from "./chunk-A5NOHVHN.js";
 
 // src/config.ts
 import { existsSync, readFileSync } from "fs";
@@ -1139,4 +1139,4 @@ export {
   validateSkillDir,
   validateCatalog
 };
-//# sourceMappingURL=chunk-PWEAKJZ3.js.map
+//# sourceMappingURL=chunk-D3OZVMHN.js.map

package/dist/{chunk-Y7UX36AC.js → chunk-EIHMCKY5.js}

@@ -1,6 +1,6 @@
 import {
   createSkillServer
-} from "./chunk-PXNRZXL6.js";
+} from "./chunk-A5NOHVHN.js";
 
 // src/stdio.ts
 import { serveStdio } from "@modelcontextprotocol/server/stdio";
@@ -38,4 +38,4 @@ export {
   serve,
   main
 };
-//# sourceMappingURL=chunk-Y7UX36AC.js.map
+//# sourceMappingURL=chunk-EIHMCKY5.js.map

package/dist/{chunk-RYOLBTSW.js → chunk-KYW3VP3L.js}

@@ -1,6 +1,6 @@
 import {
   openDatabase
-} from "./chunk-AKPSLZRJ.js";
+} from "./chunk-CMZ7OTQD.js";
 
 // src/embed.ts
 var DEFAULT_MODEL_ID = "Xenova/multilingual-e5-small";
@@ -157,4 +157,4 @@ export {
   encodeEntries,
   openEntryVectors
 };
-//# sourceMappingURL=chunk-RYOLBTSW.js.map
+//# sourceMappingURL=chunk-KYW3VP3L.js.map

package/dist/cli.js

@@ -2,7 +2,7 @@
 import {
   loadEmbedder,
   openEntryVectors
-} from "./chunk-RYOLBTSW.js";
+} from "./chunk-KYW3VP3L.js";
 import {
   ConfigError,
   ProjectError,
@@ -17,15 +17,15 @@ import {
   splitFrontmatter,
   validateCatalog,
   validateSkillDir
-} from "./chunk-PWEAKJZ3.js";
-import "./chunk-AKPSLZRJ.js";
+} from "./chunk-D3OZVMHN.js";
+import "./chunk-CMZ7OTQD.js";
 import {
   serve
-} from "./chunk-Y7UX36AC.js";
+} from "./chunk-EIHMCKY5.js";
 import {
   kindOf,
   readCatalog
-} from "./chunk-PXNRZXL6.js";
+} from "./chunk-A5NOHVHN.js";
 
 // src/cli/command.ts
 var ArgumentError = class extends Error {
@@ -2347,7 +2347,7 @@ function dispatch(argv, options = {}) {
   }
   return run(command, rest, { ui, env, cwd });
 }
-var VERSION = "0.9.0";
+var VERSION = "0.9.2";
 async function run(command, argv, context) {
   try {
     return await command.run({

package/dist/http.d.ts

@@ -1,5 +1,5 @@
 import { S as SkillEntry } from './catalog-BU5VLLyd.js';
-import { E as Embedder, S as SkillServerOptions } from './server-BBZDjzWZ.js';
+import { E as Embedder, S as SkillServerOptions } from './server-C9eO6LMI.js';
 import 'zod';
 
 /**

package/dist/http.js

@@ -2,12 +2,12 @@ import {
   DEFAULT_MODEL_ID,
   encodeEntries,
   loadEmbedder
-} from "./chunk-RYOLBTSW.js";
-import "./chunk-AKPSLZRJ.js";
+} from "./chunk-KYW3VP3L.js";
+import "./chunk-CMZ7OTQD.js";
 import {
   createSkillServer,
   readCatalog
-} from "./chunk-PXNRZXL6.js";
+} from "./chunk-A5NOHVHN.js";
 
 // src/http.ts
 import {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { I as IntentCache, S as SkillServerOptions, a as SkillTools } from './server-BBZDjzWZ.js';
-export { B as BundleFile, C as CATALOG_PAGE_MAX, b as CATALOG_PAGE_SIZE, c as CallResponse, d as CatalogItem, e as CatalogResponse, f as Classified, D as DEFAULT_FIND_LIMIT, g as DESCRIBE_FILE_LIMIT, E as Embedder, F as FileKind, h as FindOptions, i as FindResult, j as IntentCacheStats, K as KindFilter, M as Match, R as READ_BUDGET_BYTES, k as RUNTIMES, l as Ranking, m as ReadResult, n as Runtime, o as SkillBundle, p as SkillFile, q as SkillFileContent, r as SkillFileListing, s as SkillFilters, t as bundleResponseSchema, u as bundleSkill, v as catalogResponseSchema, w as classify, x as cosine, y as createSkillTools, z as describeResponseSchema, A as detectRuntime, G as find, H as findResultSchema, J as isUtf8Text, L as lexicalScore, N as listSkillFiles, O as mimeOf, P as normaliseIntent, Q as readSkillFile, T as runtimeOfClient, U as verifiedRuntimesOf } from './server-BBZDjzWZ.js';
+import { I as IntentCache, S as SkillServerOptions, a as SkillTools } from './server-C9eO6LMI.js';
+export { B as BundleFile, C as CATALOG_PAGE_MAX, b as CATALOG_PAGE_SIZE, c as CallResponse, d as CatalogItem, e as CatalogResponse, f as Classified, D as DEFAULT_FIND_LIMIT, g as DESCRIBE_FILE_LIMIT, E as Embedder, F as FileKind, h as FindOptions, i as FindResult, j as IntentCacheStats, K as KindFilter, M as Match, R as READ_BUDGET_BYTES, k as RUNTIMES, l as Ranking, m as ReadResult, n as Runtime, o as SkillBundle, p as SkillFile, q as SkillFileContent, r as SkillFileListing, s as SkillFilters, t as bundleResponseSchema, u as bundleSkill, v as catalogResponseSchema, w as classify, x as cosine, y as createSkillTools, z as describeResponseSchema, A as detectRuntime, G as find, H as findResultSchema, J as isUtf8Text, L as lexicalScore, N as listSkillFiles, O as mimeOf, P as normaliseIntent, Q as readSkillFile, T as runtimeOfClient, U as verifiedRuntimesOf } from './server-C9eO6LMI.js';
 import { S as SkillEntry, M as MetadataValue, C as CatalogOptions } from './catalog-BU5VLLyd.js';
 export { a as ASSET_KINDS, A as AssetKind, b as COMPATIBILITY_MAX, D as DESCRIPTION_MAX, c as MAX_SKILL_DEPTH, d as MetadataLeaf, N as NAME_MAX, e as SKIPPED_DIRS, f as displayPath, k as kindOf, g as parseSkillFrontmatter, r as readBody, h as readCatalog, i as readFrontmatter, s as specProblems, w as withoutBody } from './catalog-BU5VLLyd.js';
 import { McpServer } from '@modelcontextprotocol/server';
@@ -285,7 +285,7 @@ declare function resolveSkillFileUri(uri: string, entries: readonly SkillEntry[]
 
 /** Reported to the host on connect. */
 declare const SERVER_NAME = "pmcp";
-declare const SERVER_VERSION = "0.9.0";
+declare const SERVER_VERSION = "0.9.2";
 /**
  * Registers the skill_* tools on a server.
  *

package/dist/index.js

@@ -14,11 +14,11 @@ import {
   readSpec,
   validateCatalog,
   validateSkillDir
-} from "./chunk-PWEAKJZ3.js";
+} from "./chunk-D3OZVMHN.js";
 import {
   DEFAULT_INTENT_CACHE_LIMIT,
   openIntentCache
-} from "./chunk-AKPSLZRJ.js";
+} from "./chunk-CMZ7OTQD.js";
 import {
   ASSET_KINDS,
   CATALOG_PAGE_MAX,
@@ -74,7 +74,7 @@ import {
   specProblems,
   verifiedRuntimesOf,
   withoutBody
-} from "./chunk-PXNRZXL6.js";
+} from "./chunk-A5NOHVHN.js";
 export {
   ASSET_KINDS,
   CATALOG_PAGE_MAX,

package/dist/{server-BBZDjzWZ.d.ts → server-C9eO6LMI.d.ts}

@@ -233,7 +233,7 @@ declare const catalogItemSchema: z.ZodObject<{
         antigravity: "antigravity";
     }>>>;
     verified: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strip>;
+}, z.core.$loose>;
 declare const catalogResponseSchema: z.ZodObject<{
     count: z.ZodNumber;
     page: z.ZodNumber;
@@ -259,21 +259,21 @@ declare const catalogResponseSchema: z.ZodObject<{
                 antigravity: "antigravity";
             }>>>;
             verified: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
 declare const findResultSchema: z.ZodObject<{
     ranking: z.ZodEnum<{
         semantic: "semantic";
         lexical: "lexical";
     }>;
-    runtime: z.ZodNullable<z.ZodEnum<{
+    runtime: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         "claude-code": "claude-code";
         "codex-cli": "codex-cli";
         "gemini-cli": "gemini-cli";
         "grok-cli": "grok-cli";
         antigravity: "antigravity";
-    }>>;
+    }>>>;
     matches: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         package: z.ZodString;
@@ -287,8 +287,8 @@ declare const findResultSchema: z.ZodObject<{
             antigravity: "antigravity";
         }>>>;
         verified: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
 declare const describeResponseSchema: z.ZodObject<{
     name: z.ZodString;
     kind: z.ZodEnum<{
@@ -300,15 +300,15 @@ declare const describeResponseSchema: z.ZodObject<{
     package: z.ZodString;
     description: z.ZodString;
     tier: z.ZodOptional<z.ZodString>;
-    metadata: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString>>]>, z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString>>]>>>]>>;
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodReadonly<z.ZodArray<z.ZodString>>]>>;
     frontmatter: z.ZodString;
     files: z.ZodArray<z.ZodObject<{
         path: z.ZodString;
         bytes: z.ZodNumber;
         sha256: z.ZodString;
-    }, z.core.$strip>>;
+    }, z.core.$loose>>;
     filesTruncated: z.ZodBoolean;
-}, z.core.$strip>;
+}, z.core.$loose>;
 declare const bundleResponseSchema: z.ZodObject<{
     name: z.ZodString;
     truncated: z.ZodBoolean;
@@ -318,8 +318,8 @@ declare const bundleResponseSchema: z.ZodObject<{
         sha256: z.ZodString;
         uri: z.ZodString;
         mimeType: z.ZodString;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
 type CatalogItem = z.infer<typeof catalogItemSchema>;
 type CatalogResponse = z.infer<typeof catalogResponseSchema>;
 type FindResponse = z.infer<typeof findResultSchema>;

package/dist/stdio.js

@@ -3,8 +3,8 @@ import {
   main,
   resolveRoots,
   serve
-} from "./chunk-Y7UX36AC.js";
-import "./chunk-PXNRZXL6.js";
+} from "./chunk-EIHMCKY5.js";
+import "./chunk-A5NOHVHN.js";
 export {
   main,
   resolveRoots,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modootoday/pmcp",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "license": "Elastic-2.0",
   "author": "modootoday",
   "description": "An MCP server that finds the skills your installed packages already ship. Reads SKILL.md out of node_modules by shape rather than by path, so it sees the skills, .agent, .claude, .gemini and .codex conventions alike, and keeps session startup flat as the number of installed skills grows.",