@modootoday/pmcp 0.18.0 → 0.18.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agents/plugins/marketplace.json +1 -1
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +2 -2
- package/.mcp.json +1 -1
- package/CONTRIBUTING.md +80 -0
- package/README.md +100 -206
- package/SECURITY.md +17 -1
- package/dist/{apply-4IGTXOCQ.js → apply-S2QI72W3.js} +13 -13
- package/dist/{available-DBSIVVJ6.js → available-GFMTJW4E.js} +3 -3
- package/dist/{broadcast-3RY3OZGY.js → broadcast-CBMVOV3G.js} +4 -4
- package/dist/{chunk-SG5TPMKH.js → chunk-26WLNWDG.js} +2 -2
- package/dist/{chunk-4VCC2NXE.js → chunk-2RTRY45B.js} +2 -2
- package/dist/{chunk-3NYG4SGU.js → chunk-3MEYKFFO.js} +3 -3
- package/dist/{chunk-KMXRRSKT.js → chunk-4CRRLDDS.js} +1 -1
- package/dist/{chunk-ZH6R642Z.js → chunk-4GSGT55G.js} +2 -2
- package/dist/{chunk-EJBZGIDK.js → chunk-6BN35BHI.js} +3 -3
- package/dist/{chunk-T3LKX23M.js → chunk-7B6IC3F7.js} +3 -3
- package/dist/{chunk-25GHX674.js → chunk-7DEYLLIE.js} +9 -9
- package/dist/{chunk-ELAGZ635.js → chunk-7PTG42QU.js} +5 -5
- package/dist/chunk-AF2IBMWN.js +7 -0
- package/dist/{chunk-IGYRMM62.js → chunk-CKTN6LKP.js} +2 -2
- package/dist/{chunk-PLX3BOOS.js → chunk-E5XVSMBR.js} +2 -2
- package/dist/{chunk-Q65R3XKX.js → chunk-EAWPJHJ7.js} +2 -2
- package/dist/{chunk-7BLPN3W6.js → chunk-F5LEGPGP.js} +2 -2
- package/dist/{chunk-BBTBJCFA.js → chunk-F5WBMUOT.js} +2 -2
- package/dist/{chunk-YMHUM7AV.js → chunk-F5XMGOOX.js} +7 -1
- package/dist/{chunk-R4L6LJJ2.js → chunk-FX3LTTMB.js} +2 -2
- package/dist/{chunk-5QQWS4US.js → chunk-HEBCQTOD.js} +2 -2
- package/dist/{chunk-NZS5CD72.js → chunk-HEWZ6INU.js} +21 -5
- package/dist/{chunk-MWFOUBFC.js → chunk-HFE4QDJQ.js} +2 -2
- package/dist/{chunk-N5AQ3PP7.js → chunk-HQWVGU3W.js} +5 -5
- package/dist/{chunk-UOCLRM7P.js → chunk-IIBB37JE.js} +22 -22
- package/dist/{chunk-MPSQXSC6.js → chunk-ISZOLR3D.js} +5 -3
- package/dist/{chunk-J6QLLQVL.js → chunk-JM2KR2WJ.js} +5 -5
- package/dist/{chunk-CJTKR6K6.js → chunk-JZK7ZO7K.js} +2 -2
- package/dist/{chunk-RK4PYD7L.js → chunk-LBXO4VPG.js} +2 -2
- package/dist/{chunk-BVCTKPT3.js → chunk-LMUBBIE2.js} +2 -2
- package/dist/{chunk-Z4HRRXRF.js → chunk-LTZH5E3G.js} +6 -5
- package/dist/{chunk-MM2Y43LC.js → chunk-M455QSCW.js} +3 -3
- package/dist/{chunk-7GBYECSK.js → chunk-NLHLA2N5.js} +3 -3
- package/dist/{chunk-HDMBVLCZ.js → chunk-NWOV2E26.js} +2 -2
- package/dist/{chunk-PWSJJXLQ.js → chunk-QK4G7FCU.js} +8 -8
- package/dist/{chunk-47O3X4VS.js → chunk-QRCAGKC6.js} +1 -1
- package/dist/{chunk-665TA55Z.js → chunk-TAOOPXBV.js} +2 -2
- package/dist/{chunk-JUXNIXN4.js → chunk-TZORR6GZ.js} +2 -2
- package/dist/{chunk-LAZQBMAU.js → chunk-WM2RF2MI.js} +3 -3
- package/dist/{chunk-65ZHM5RH.js → chunk-XJUNAVU2.js} +9 -9
- package/dist/{chunk-TNCZ6444.js → chunk-Y2XASHVY.js} +2 -2
- package/dist/{cli-VYCQJZ5X.js → cli-MI4ZCAZ3.js} +9 -9
- package/dist/{cli-ZTCBSDW4.js → cli-ZN7ZVDEZ.js} +3 -3
- package/dist/cli.js +4 -4
- package/dist/{completion-E7RRG3ZT.js → completion-GYN7PX3T.js} +3 -3
- package/dist/{diagnostics-XXH4FLUG.js → diagnostics-WACXQ33W.js} +6 -6
- package/dist/{doctor-ZIOESU3N.js → doctor-VSQ72A6X.js} +13 -13
- package/dist/{entry-ZNFCTDVE.js → entry-VFEZC2XB.js} +10 -10
- package/dist/{exec-mcp-X6372BLE.js → exec-mcp-TOQEJFK3.js} +8 -8
- package/dist/{harness-F2XFDYXF.js → harness-XCEWFGCG.js} +5 -5
- package/dist/harness-launch-gate.js +4 -4
- package/dist/harness-worker.js +6 -6
- package/dist/hook-body.js +7 -6
- package/dist/{hooks-FYE2L5RW.js → hooks-32AFBC3Z.js} +3 -3
- package/dist/{host-X6BR6X4O.js → host-72OLHUX7.js} +20 -10
- package/dist/{host-GRY3VAHH.js → host-TE5PNDHJ.js} +7 -7
- package/dist/{host-run-GCA6H6SR.js → host-run-MXCH26ZD.js} +5 -5
- package/dist/http.js +5 -5
- package/dist/{import-mcp-2TTBPVLY.js → import-mcp-QWGZSIZR.js} +6 -6
- package/dist/index.d.ts +1 -1
- package/dist/index.js +18 -18
- package/dist/{init-627KFXTG.js → init-5M3XWOTJ.js} +2 -2
- package/dist/{install-GG7HHZK2.js → install-MQ7QSJQ7.js} +3 -3
- package/dist/{invoke-LW22Z6ET.js → invoke-SFSN4XT7.js} +8 -8
- package/dist/{list-MCP2FXUF.js → list-FB6RNYYB.js} +3 -3
- package/dist/{list-NGMSQ5SH.js → list-FGDUU5DL.js} +8 -8
- package/dist/{logout-6CSHUWWE.js → logout-KM5N5GOC.js} +7 -7
- package/dist/{logs-SPB6AANY.js → logs-TBUA4UWU.js} +4 -4
- package/dist/mailbox/index.js +4 -4
- package/dist/{mailbox-GDJ7BWQN.js → mailbox-5DWLH4W2.js} +3 -3
- package/dist/{mailbox-7BV54Q4R.js → mailbox-BMTZOSZ7.js} +4 -4
- package/dist/{mainline-JQTTYJMI.js → mainline-KAD2ERLP.js} +2 -2
- package/dist/{mcp-V23HC3LB.js → mcp-FJ2UQ4RH.js} +2 -2
- package/dist/{mcp-2DKVU3SW.js → mcp-ND6ZQWJE.js} +2 -2
- package/dist/{pause-FFAYRBWI.js → pause-7LILUVGL.js} +4 -4
- package/dist/{project-FY62G55N.js → project-LZKQUV2W.js} +4 -4
- package/dist/{reindex-Y27QJFDB.js → reindex-ZULHSQWY.js} +5 -5
- package/dist/{resume-UU4HZIUP.js → resume-26VFAAMH.js} +4 -4
- package/dist/{run-HALGEJNJ.js → run-X4663F4M.js} +4 -4
- package/dist/{run-OGA3P7FC.js → run-YEVGHGTN.js} +7 -7
- package/dist/{serve-NBKT5BKY.js → serve-S7MF42SS.js} +12 -12
- package/dist/{start-login-UIQYQBMC.js → start-login-GKFGTE2A.js} +7 -7
- package/dist/{status-NOOHW5WA.js → status-FYG6XYQ6.js} +7 -7
- package/dist/{status-VHODZPXB.js → status-RO55QPKV.js} +4 -4
- package/dist/{status-XQANBVXW.js → status-XG5GRWVU.js} +11 -11
- package/dist/stdio.js +7 -7
- package/dist/{sweep-64JDCGK6.js → sweep-35LGQTTO.js} +4 -4
- package/dist/{test-MKAXFJOL.js → test-KFDO6ROC.js} +7 -7
- package/dist/{tui-MWKAXE4K.js → tui-2MP7DRIX.js} +5 -5
- package/dist/{unbroadcast-KPUEFLZD.js → unbroadcast-5QNGAJR2.js} +4 -4
- package/dist/{validate-5GZ5YWNA.js → validate-AVM2VHMM.js} +4 -4
- package/dist/{worker-RQ575EJL.js → worker-3VS6RQEL.js} +8 -8
- package/docs/authoring.md +82 -0
- package/docs/browser-and-desktop.md +46 -0
- package/docs/commands.md +325 -0
- package/docs/compare.md +35 -0
- package/docs/compatibility.md +56 -0
- package/docs/embeddings.md +1 -1
- package/docs/getting-started.md +105 -0
- package/docs/git-workflow.md +60 -0
- package/docs/glossary.md +31 -0
- package/docs/hooks.md +264 -0
- package/docs/install.md +72 -0
- package/docs/known-issues.md +17 -0
- package/docs/library-skills.md +132 -0
- package/docs/mailbox.md +16 -5
- package/docs/project-configuration.md +51 -386
- package/docs/sessions.md +64 -0
- package/docs/skills.md +4 -45
- package/docs/terminal-harness.md +26 -21
- package/docs/terminal-workspace.md +4 -13
- package/docs/upgrading.md +23 -0
- package/gemini-extension.json +2 -2
- package/mcp.json +1 -1
- package/package.json +8 -7
- package/plugin.json +2 -2
- package/plugins/pmcp/.claude-plugin/plugin.json +2 -2
- package/plugins/pmcp/.mcp.json +1 -1
- package/plugins/pmcp/gemini-extension.json +2 -2
- package/plugins/pmcp/mcp.json +1 -1
- package/plugins/pmcp/mod/sessions/types.ts +1 -1
- package/plugins/pmcp/plugin.json +2 -2
- package/plugins/pmcp/skills/agent-assets-migrate/SKILL.md +8 -8
- package/plugins/pmcp/skills/headless-agents-ci-scaffold/SKILL.md +12 -11
- package/plugins/pmcp/skills/marketplace-plugin-scaffold/SKILL.md +10 -8
- package/plugins/pmcp/skills/package-skill-catalog/SKILL.md +0 -4
- package/plugins/pmcp/skills/pmcp-browser/SKILL.md +27 -0
- package/plugins/pmcp/skills/pmcp-desktop/SKILL.md +25 -0
- package/plugins/pmcp/skills/pmcp-project-init/SKILL.md +19 -11
- package/plugins/pmcp/skills/pmcp-sessions-and-git/SKILL.md +20 -28
- package/plugins/pmcp/skills/skill-package-scaffold/SKILL.md +16 -15
- package/schema/catalog-v1.json +36 -7
- package/schema/library.json +40 -8
- package/schema/marketplace-manifest.json +19 -5
- package/schema/plugin-manifest.json +6 -2
- package/schema/skill-frontmatter.json +33 -7
- package/schema/skill-metadata-core.json +26 -5
- package/skills/agent-assets-migrate/SKILL.md +8 -8
- package/skills/headless-agents-ci-scaffold/SKILL.md +12 -11
- package/skills/marketplace-plugin-scaffold/SKILL.md +10 -8
- package/skills/package-skill-catalog/SKILL.md +0 -4
- package/skills/pmcp-browser/SKILL.md +27 -0
- package/skills/pmcp-desktop/SKILL.md +25 -0
- package/skills/pmcp-project-init/SKILL.md +19 -11
- package/skills/pmcp-sessions-and-git/SKILL.md +20 -28
- package/skills/skill-package-scaffold/SKILL.md +16 -15
- package/CHANGELOG.md +0 -60
- package/dist/chunk-E7OOHLQR.js +0 -7
- package/docs/manual-library-skills.md +0 -74
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
# Library skills
|
|
2
|
+
|
|
3
|
+
[Back to the overview](../README.md)
|
|
4
|
+
|
|
5
|
+
Free instructions for public libraries, one plugin per library major line. Install them as
|
|
6
|
+
native plugins from the public marketplace, as npm skill packages with `pmcp install`, or, for
|
|
7
|
+
Python, Rust and Go, copy them into a local collection. How pmcp finds and serves skills in
|
|
8
|
+
general is in the [skills reference](skills.md).
|
|
9
|
+
|
|
10
|
+
## How they are matched and verified
|
|
11
|
+
|
|
12
|
+
Each npm library skill is for one package and major line, not for a kind of task: its
|
|
13
|
+
description names the package and major (most read "Use <package> <major> to ..."). In `docs/catalog.json`, every entry's
|
|
14
|
+
`targets` name the `packageName` and the version `range` it applies to, and
|
|
15
|
+
`pmcp available` and `pmcp install` match that against the version your project has
|
|
16
|
+
installed. Every entry also carries the evidence it was checked against: `evidence.examplesExecuted`
|
|
17
|
+
(the examples that ran), `evidence.verifiedOn` (the date) and, per target,
|
|
18
|
+
`verifiedVersions` (the exact versions they ran on). A native plugin install does not match
|
|
19
|
+
versions for you, so choose the major you use.
|
|
20
|
+
|
|
21
|
+
## Native plugins from the public marketplace
|
|
22
|
+
|
|
23
|
+
The public repository's canonical sources are standard Agent Skills folders:
|
|
24
|
+
`plugins/<product-major>/skills/<skill-name>/SKILL.md`. Each supported library
|
|
25
|
+
major is a separate selectable plugin. The PMCP bridge has its own `pmcp` plugin.
|
|
26
|
+
The website's `docs/skills/` files are generated downloads from those sources,
|
|
27
|
+
with immutable archives.
|
|
28
|
+
|
|
29
|
+
| Tool | Native distribution |
|
|
30
|
+
| --------------- | -------------------------------------------------------------------- |
|
|
31
|
+
| Claude Code | `.claude-plugin/marketplace.json` and plugin manifests |
|
|
32
|
+
| Codex | `.agents/plugins/marketplace.json` and portable `plugin.json` |
|
|
33
|
+
| Grok Build | Claude-compatible marketplace and plugin manifests |
|
|
34
|
+
| Gemini CLI | `gemini-extension.json`; selected CLI exports are extensions |
|
|
35
|
+
| Antigravity CLI | Selected CLI export with its own `plugin.json` and `mcp_config.json` |
|
|
36
|
+
|
|
37
|
+
The native marketplace commands are in the [README](../README.md#free-library-skills-as-native-plugins).
|
|
38
|
+
Gemini and Antigravity need their own package formats for selected library plugins;
|
|
39
|
+
do not assume that identically named manifest files accept the same schema.
|
|
40
|
+
`pmcp marketplace export <plugin> --runtime <tool> --output <new-directory>`
|
|
41
|
+
materializes a selected package without altering native
|
|
42
|
+
settings or installing it. Use the native manager to review and install that folder.
|
|
43
|
+
Existing export destinations are preserved.
|
|
44
|
+
|
|
45
|
+
The built-in catalog is available without remote fetching.
|
|
46
|
+
`--no-builtin` or `[catalog] builtin = false` opts out; library APIs continue to
|
|
47
|
+
read explicitly supplied catalog roots. `--marketplace <directory>` reads installed
|
|
48
|
+
Claude, Codex and Grok local descriptors, rejects path escapes and does not fetch
|
|
49
|
+
remote plugin sources. Add a remote marketplace with its native manager first.
|
|
50
|
+
|
|
51
|
+
## npm skill packages
|
|
52
|
+
|
|
53
|
+
Public npm skill installation uses the bundled catalog, a matching installed
|
|
54
|
+
dependency version and immutable free archive URLs. It verifies archive integrity,
|
|
55
|
+
content-only metadata, instruction digests and installed file bytes. npm, Bun or pnpm
|
|
56
|
+
changes the project and lockfile only after confirmation, with scripts disabled.
|
|
57
|
+
`--provider hosted` remains a separate service path with its own access policy.
|
|
58
|
+
Native plugin installation does not automatically version-match dependencies:
|
|
59
|
+
select the appropriate major yourself. Non-npm library instructions remain manual.
|
|
60
|
+
|
|
61
|
+
## Python, Rust and Go libraries
|
|
62
|
+
|
|
63
|
+
These three library-major skills provide free public instructions for Python,
|
|
64
|
+
Rust and Go libraries. Select them yourself and copy them into a local collection
|
|
65
|
+
you choose. No PMCP login, subscription or registry account is required to read
|
|
66
|
+
the files or load that collection.
|
|
67
|
+
|
|
68
|
+
| Ecosystem | Library | Selected version | Instructions |
|
|
69
|
+
| ---------- | -------------------------- | ------------------------------- | ------------------------------------------------------------------------ |
|
|
70
|
+
| PyPI | `pydantic` 2 | `2.13.4` | [Pydantic SKILL.md](https://pmcp.build/skills/pydantic/2/SKILL.md) |
|
|
71
|
+
| crates.io | `serde_json` 1 | `1.0.149`, with Serde `1.0.228` | [serde_json SKILL.md](https://pmcp.build/skills/serde-json/1/SKILL.md) |
|
|
72
|
+
| Go modules | `github.com/google/uuid` 1 | `v1.6.0` | [Google UUID SKILL.md](https://pmcp.build/skills/google-uuid/1/SKILL.md) |
|
|
73
|
+
|
|
74
|
+
Selected versions identify each skill's scope. They are not a statement that
|
|
75
|
+
every project, feature or AI runtime has been verified. Each SKILL.md contains
|
|
76
|
+
its own supported task boundaries and links to primary documentation and
|
|
77
|
+
licenses. Keep those sources when copying or adapting the instructions.
|
|
78
|
+
|
|
79
|
+
### Choose a collection and copy only the skills you need
|
|
80
|
+
|
|
81
|
+
Place each downloaded file under its frontmatter name:
|
|
82
|
+
|
|
83
|
+
```text
|
|
84
|
+
chosen-collection/
|
|
85
|
+
skills/
|
|
86
|
+
pydantic/
|
|
87
|
+
SKILL.md
|
|
88
|
+
serde-json/
|
|
89
|
+
SKILL.md
|
|
90
|
+
google-uuid/
|
|
91
|
+
SKILL.md
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
Include only your selected files; all three are not required locally. The
|
|
95
|
+
collection may be a plain directory without a package.json. Keep SKILL.md
|
|
96
|
+
frontmatter, source links and any accompanying reference files intact. The
|
|
97
|
+
collection's directory name is a local discovery label, not a registry package
|
|
98
|
+
identity.
|
|
99
|
+
|
|
100
|
+
### Register the collection explicitly
|
|
101
|
+
|
|
102
|
+
For a direct CLI invocation:
|
|
103
|
+
|
|
104
|
+
```bash
|
|
105
|
+
pmcp serve --package /absolute/path/to/chosen-collection
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
Or merge the chosen path into the existing project's pmcp.toml:
|
|
109
|
+
|
|
110
|
+
```toml
|
|
111
|
+
[catalog]
|
|
112
|
+
packages = ["./chosen-collection"]
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
Preserve other catalog entries rather than replacing them with this example.
|
|
116
|
+
Project-relative paths resolve from the configuration's directory. The
|
|
117
|
+
existing `skill_catalog`, `skill_find` and `skill_call` tools can then discover
|
|
118
|
+
and read the selected local instructions. Leave folder trust and tool approval
|
|
119
|
+
to the native AI runtime.
|
|
120
|
+
|
|
121
|
+
### Understand the manual boundary
|
|
122
|
+
|
|
123
|
+
PMCP does not automatically detect these libraries from PyPI, Cargo or Go
|
|
124
|
+
dependencies. They are separate from the managed npm skill catalog and are
|
|
125
|
+
not installed through `pmcp available` or `pmcp install`. Serving a local
|
|
126
|
+
collection does not install a library, download a compiler or run its examples.
|
|
127
|
+
|
|
128
|
+
Loading an instruction file also does not establish model execution evidence.
|
|
129
|
+
Check the project's installed library major, lockfile and environment before
|
|
130
|
+
applying guidance, and run the appropriate project checks after code changes.
|
|
131
|
+
This explicit workflow supplements the package skill discovery described in
|
|
132
|
+
the [skills reference](skills.md).
|
package/docs/mailbox.md
CHANGED
|
@@ -2,6 +2,17 @@
|
|
|
2
2
|
|
|
3
3
|
[Back to the overview](../README.md)
|
|
4
4
|
|
|
5
|
+
## Which mailbox?
|
|
6
|
+
|
|
7
|
+
pmcp has two message systems; pick by who talks to whom.
|
|
8
|
+
|
|
9
|
+
| You want | Use |
|
|
10
|
+
| --------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
|
|
11
|
+
| Agents working in one repository to message each other and you | `[sessions.mailbox]` and `pmcp sessions send` ([Run several agents](sessions.md)) |
|
|
12
|
+
| Actors with their own credentials to exchange messages across projects or hosts, or a mailbox in your own application | this page: `pmcp mailbox` and the mailbox library |
|
|
13
|
+
|
|
14
|
+
They do not share messages, state or credentials.
|
|
15
|
+
|
|
5
16
|
## Optional local mailbox
|
|
6
17
|
|
|
7
18
|
Mailbox is disabled by default. The six catalog tools stay read-only. A launcher
|
|
@@ -26,9 +37,9 @@ grok-cli, and antigravity; the Antigravity executable is agy.
|
|
|
26
37
|
|
|
27
38
|
The mailbox CLI also supports send, inbox, read, ack, sessions, rotate, export,
|
|
28
39
|
backup, and restore. Actor operations accept a private actor-file or existing
|
|
29
|
-
binding-file and JSON input file. Administration
|
|
30
|
-
|
|
31
|
-
available through the mailbox API;
|
|
40
|
+
binding-file and JSON input file. Administration runs only when you ask for
|
|
41
|
+
it explicitly. Backups and exports are sensitive. Encrypted recovery bundles are
|
|
42
|
+
available through the mailbox API; you keep their keys.
|
|
32
43
|
|
|
33
44
|
```ts
|
|
34
45
|
import { MailboxService, MailboxStore } from "@modootoday/pmcp/mailbox";
|
|
@@ -54,6 +65,6 @@ The public package contains one reusable local mailbox domain. Optional owned
|
|
|
54
65
|
terminal supervision and explicit input delivery are provided separately by the
|
|
55
66
|
[local CLI harness](terminal-harness.md); MCP mailbox tools cannot reach those
|
|
56
67
|
execution paths. Provider credentials and approvals remain with native runtimes.
|
|
57
|
-
Organization identity,
|
|
58
|
-
dedicated host. Existing arbitrary terminal sessions are not captured. Elastic
|
|
68
|
+
Organization identity, organization-wide policy and enterprise audit retention
|
|
69
|
+
belong to a dedicated host. Existing arbitrary terminal sessions are not captured. Elastic
|
|
59
70
|
License 2.0 and NOTICE continue to apply.
|