@modootoday/pmcp 0.5.0 → 0.5.1

package/dist/{chunk-JOQTOVTJ.js → chunk-76UKXVUE.js}

@@ -1009,6 +1009,10 @@ var readOnly = {
   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."
 );
@@ -1019,22 +1023,21 @@ function registerSkillTools(server, tools) {
   server.registerTool(
     "skill_catalog",
     {
-      title: "List installed skills without their bodies",
+      ...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
-      }),
-      annotations: readOnly
+      })
     },
     async (request) => asText(tools.catalog(request))
   );
   server.registerTool(
     "skill_find",
     {
-      title: "Find skills by describing the problem",
+      ...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."),
@@ -1047,20 +1050,18 @@ function registerSkillTools(server, tools) {
           domain: z2.string().optional(),
           medium: z2.string().optional()
         }).optional().describe("Exact-match filters over the catalog before ranking.")
-      }),
-      annotations: readOnly
+      })
     },
     async ({ intent, limit, filters }) => asText(await tools.find(intent, limit, filters))
   );
   server.registerTool(
     "skill_describe",
     {
-      title: "Check one skill's properties before loading it",
+      ...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.")
-      }),
-      annotations: readOnly
+      })
     },
     async ({ name }) => {
       const described = tools.describe(name);
@@ -1080,15 +1081,14 @@ function registerSkillTools(server, tools) {
   server.registerTool(
     "skill_read",
     {
-      title: "Read one file a skill carries",
-      description: "A reference or script file inside one skill's directory, as text, with its sha256. Read only when the skill body points at the file. Scripts are returned, never run. Files over 256 KiB and paths outside the skill are refused.",
+      ...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_describe lists it (layout: https://pmcp.build). Read only when the skill body points at the file. Scripts are returned, 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."
         )
-      }),
-      annotations: readOnly
+      })
     },
     async ({ name, path }) => {
       const result = tools.read(name, path);
@@ -1105,12 +1105,11 @@ function registerSkillTools(server, tools) {
   server.registerTool(
     "skill_call",
     {
-      title: "Read one skill",
+      ...readOnlyTool("Read a skill"),
       description: "The body of a single skill, by the name skill_find or skill_catalog returned. This is the only call that costs a document.",
       inputSchema: z2.object({
         name: z2.string().min(1).describe("The skill name, as <package>/<slug>.")
-      }),
-      annotations: readOnly
+      })
     },
     async ({ name }) => {
       const found = tools.call(name);
@@ -1130,7 +1129,7 @@ function registerSkillTools(server, tools) {
   return server;
 }
 function createSkillServer(options) {
-  const server = new McpServer({ name: SERVER_NAME, version: "0.5.0" });
+  const server = new McpServer({ name: SERVER_NAME, version: "0.5.1" });
   const tools = createSkillTools(options);
   registerSkillsExtension(server, tools.skills);
   return registerSkillTools(server, tools);
@@ -1168,4 +1167,4 @@ export {
   registerSkillTools,
   createSkillServer
 };
-//# sourceMappingURL=chunk-JOQTOVTJ.js.map
+//# sourceMappingURL=chunk-76UKXVUE.js.map

package/dist/{chunk-X4LYYULW.js → chunk-ICHBC5FM.js}

@@ -1,6 +1,6 @@
 import {
   createSkillServer
-} from "./chunk-JOQTOVTJ.js";
+} from "./chunk-76UKXVUE.js";
 
 // src/stdio.ts
 import { serveStdio } from "@modelcontextprotocol/server/stdio";
@@ -35,4 +35,4 @@ export {
   serve,
   main
 };
-//# sourceMappingURL=chunk-X4LYYULW.js.map
+//# sourceMappingURL=chunk-ICHBC5FM.js.map

package/dist/{chunk-PUGLIJYM.js → chunk-XTLANVRL.js}

@@ -1,6 +1,6 @@
 import {
   normaliseIntent
-} from "./chunk-JOQTOVTJ.js";
+} from "./chunk-76UKXVUE.js";
 
 // src/cache.ts
 async function openDatabase(path) {
@@ -190,4 +190,4 @@ export {
   findConfig,
   readConfig
 };
-//# sourceMappingURL=chunk-PUGLIJYM.js.map
+//# sourceMappingURL=chunk-XTLANVRL.js.map

package/dist/cli.js

@@ -4,13 +4,13 @@ import {
   findConfig,
   openDatabase,
   readConfig
-} from "./chunk-PUGLIJYM.js";
+} from "./chunk-XTLANVRL.js";
 import {
   serve
-} from "./chunk-X4LYYULW.js";
+} from "./chunk-ICHBC5FM.js";
 import {
   readCatalog
-} from "./chunk-JOQTOVTJ.js";
+} from "./chunk-76UKXVUE.js";
 
 // src/cli/command.ts
 var ArgumentError = class extends Error {
@@ -2135,7 +2135,7 @@ function dispatch(argv, options = {}) {
   }
   return run(command, rest, { ui, env, cwd });
 }
-var VERSION = "0.5.0";
+var VERSION = "0.5.1";
 async function run(command, argv, context) {
   try {
     return await command.run({

package/dist/http.js

@@ -1,7 +1,7 @@
 import {
   createSkillServer,
   readCatalog
-} from "./chunk-JOQTOVTJ.js";
+} from "./chunk-76UKXVUE.js";
 
 // src/http.ts
 import {

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   findConfig,
   openIntentCache,
   readConfig
-} from "./chunk-PUGLIJYM.js";
+} from "./chunk-XTLANVRL.js";
 import {
   ASSET_KINDS,
   CATALOG_PAGE_MAX,
@@ -37,7 +37,7 @@ import {
   registerSkillsExtension,
   skillUri,
   withoutBody
-} from "./chunk-JOQTOVTJ.js";
+} from "./chunk-76UKXVUE.js";
 export {
   ASSET_KINDS,
   CATALOG_PAGE_MAX,

package/dist/stdio.js

@@ -3,8 +3,8 @@ import {
   main,
   resolveRoots,
   serve
-} from "./chunk-X4LYYULW.js";
-import "./chunk-JOQTOVTJ.js";
+} from "./chunk-ICHBC5FM.js";
+import "./chunk-76UKXVUE.js";
 export {
   main,
   resolveRoots,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modootoday/pmcp",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "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.",