@modootoday/pmcp 0.4.0 → 0.5.1

package/README.md

@@ -53,15 +53,48 @@ Run `pmcp --help` or `pmcp <command> --help` for options. With no command,
 `pmcp` serves MCP on stdio. Use `--root <node_modules>` to select a local tree
 and repeat `--scope <prefix>` to restrict local package discovery.
 
+## Project config
+
+A `pmcp.toml` at or above the working directory sets the catalog once, so a
+host entry needs no flags and works from any package in the repository:
+
+```toml
+[catalog]
+workspaces = [".", "packages/*"]
+packages = ["docs"]
+marketplaces = ["vendor/marketplace"]
+```
+
+Paths resolve against the file's directory. Keys are `roots`, `scopes`,
+`workspaces`, `packages` and `marketplaces`, each a list mirroring the flag of
+the same meaning; an unknown key is an error. A flag replaces the file's list
+of its kind. `--config <file>` names another file and `--no-config` ignores it.
+
 ## Package skills
 
-Skills are discovered by filename, including `skills/`, `.agent/skills/`,
-`.claude/skills/`, `.gemini/skills/`, `.codex/skills/`, and `lib/skill/` layouts
+Skills are discovered by filename, including `skills/`, `.agents/skills/`,
+`.agent/skills/`, `.claude/skills/`, `.gemini/skills/`, `.codex/skills/`, and
+`lib/skill/` layouts
 within the discovery depth. A skill needs a frontmatter `description` for search.
 
 `skill_find` accepts a problem description and returns matching skills.
 `skill_call` opens the selected document. Local MCP reading requires no login.
 
+Marketplace plugins also carry commands, agents, hooks and MCP servers.
+Commands are listed as skills. The others are listed under their own kind and
+are left out of `skill_catalog` and `skill_find` unless `kind` asks for them
+(`agent`, `hook`, `mcp`, or `any`); `skill_describe`, `skill_read` and
+`skill_call` work on every kind.
+
+## MCP Skills extension
+
+The server also declares `io.modelcontextprotocol/skills` (SEP-2640): it
+answers `skills/list` and `skills/get`, and serves each file of a conforming
+skill as `skill://pmcp/<package>/<name>/<file>` through `resources/read`, with
+a sha256 digest and size per file. A skill qualifies when its frontmatter
+`name` matches its directory and the Agent Skills naming rules, and it stays
+within 512 files and 16 MiB; the rest remain reachable through the tools.
+
 ## Hosting over HTTP
 
 `@modootoday/pmcp/http` serves the same five tools over streamable HTTP for a hosted catalog.
@@ -76,7 +109,8 @@ import { createSkillHttpHandler } from "@modootoday/pmcp/http";
 const skills = createSkillHttpHandler({
   roots: [],
   marketplaces: ["/srv/marketplace", "/srv/marketplace-free"],
-  authorize: async (request) => verifyBearer(request.headers.get("authorization")),
+  authorize: async (request) =>
+    verifyBearer(request.headers.get("authorization")),
 });
 export default { fetch: (request: Request) => skills.fetch(request) };
 ```

package/dist/{catalog-BiPLcbLu.d.ts → catalog-5v7jrGwP.d.ts}

@@ -20,7 +20,18 @@ interface SkillEntry {
     readonly metadata?: Readonly<Record<string, string | readonly string[]>>;
     /** Extra search terms. Ranked with the description, never used as triggers. */
     readonly keywords?: readonly string[];
+    /** What the entry is. Absent means a skill. */
+    readonly kind?: AssetKind;
+    /**
+     * What describe and read may open: a directory, or one file for an asset
+     * that is a single file. Absent means the directory holding `path`.
+     */
+    readonly root?: string;
 }
+/** Everything the catalog serves. Commands are skills; workflows have no kind of their own. */
+declare const ASSET_KINDS: readonly ["skill", "agent", "hook", "mcp"];
+type AssetKind = (typeof ASSET_KINDS)[number];
+declare const kindOf: (entry: Pick<SkillEntry, "kind">) => AssetKind;
 interface CatalogOptions {
     /** Directories to walk. Each is a `node_modules` root, not a package root. */
     readonly roots: readonly string[];
@@ -83,4 +94,4 @@ declare function withoutBody({ path, ...rest }: SkillEntry): Omit<SkillEntry, "p
 /** Path relative to a root, for a message a reader can act on. */
 declare function displayPath(root: string, entry: SkillEntry): string;
 
-export { type CatalogOptions as C, MAX_SKILL_DEPTH as M, type SkillEntry as S, SKIPPED_DIRS as a, readCatalog as b, readFrontmatter as c, displayPath as d, readBody as r, withoutBody as w };
+export { type AssetKind as A, type CatalogOptions as C, MAX_SKILL_DEPTH as M, type SkillEntry as S, ASSET_KINDS as a, SKIPPED_DIRS as b, readCatalog as c, displayPath as d, readFrontmatter as e, kindOf as k, readBody as r, withoutBody as w };