@modootoday/pmcp 0.17.4 → 0.18.0

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.
Files changed (246) hide show
  1. package/.agents/plugins/marketplace.json +1 -1
  2. package/.claude-plugin/marketplace.json +1 -1
  3. package/.claude-plugin/plugin.json +1 -1
  4. package/CHANGELOG.md +60 -0
  5. package/README.md +29 -24
  6. package/dist/apply-4IGTXOCQ.js +242 -0
  7. package/dist/{attachment-tU5FZrgZ.d.ts → attachment-D84OGI6n.d.ts} +1 -1
  8. package/dist/available-DBSIVVJ6.js +73 -0
  9. package/dist/broadcast-3RY3OZGY.js +18 -0
  10. package/dist/chunk-25GHX674.js +1246 -0
  11. package/dist/chunk-2P4Z2NUX.js +28 -0
  12. package/dist/chunk-34DECPVC.js +22 -0
  13. package/dist/chunk-3NYG4SGU.js +45 -0
  14. package/dist/chunk-3PW4FI7U.js +32 -0
  15. package/dist/chunk-3Y3HDMHA.js +108 -0
  16. package/dist/chunk-47O3X4VS.js +113 -0
  17. package/dist/chunk-4NDEP7HU.js +26 -0
  18. package/dist/chunk-4VCC2NXE.js +104 -0
  19. package/dist/chunk-5OMOPUE6.js +39 -0
  20. package/dist/chunk-5QQWS4US.js +53 -0
  21. package/dist/chunk-5ZABTVSW.js +48 -0
  22. package/dist/chunk-65ZHM5RH.js +4985 -0
  23. package/dist/chunk-665TA55Z.js +419 -0
  24. package/dist/chunk-6STKGOCW.js +27 -0
  25. package/dist/chunk-6WXMJOMI.js +9 -0
  26. package/dist/chunk-73AKO4UL.js +24 -0
  27. package/dist/chunk-7BLPN3W6.js +31 -0
  28. package/dist/chunk-7DLZC73N.js +29 -0
  29. package/dist/chunk-7GBYECSK.js +72 -0
  30. package/dist/chunk-7TD53M7L.js +13 -0
  31. package/dist/chunk-A4PKLESO.js +112 -0
  32. package/dist/chunk-ABTJQ4QV.js +74 -0
  33. package/dist/chunk-BBTBJCFA.js +380 -0
  34. package/dist/chunk-BU65MNVU.js +13 -0
  35. package/dist/chunk-BVCTKPT3.js +83 -0
  36. package/dist/chunk-C4NHQGHL.js +142 -0
  37. package/dist/chunk-CJTKR6K6.js +1213 -0
  38. package/dist/chunk-DCU2EXQV.js +78 -0
  39. package/dist/chunk-DZ2MRTYT.js +135 -0
  40. package/dist/chunk-E2YOZ2FF.js +207 -0
  41. package/dist/chunk-E3DQB5LS.js +48 -0
  42. package/dist/chunk-E7OOHLQR.js +7 -0
  43. package/dist/chunk-EATCUWGG.js +66 -0
  44. package/dist/chunk-EIDIVIAD.js +33 -0
  45. package/dist/chunk-EJBZGIDK.js +1934 -0
  46. package/dist/chunk-ELAGZ635.js +252 -0
  47. package/dist/chunk-GZHHEHKY.js +44 -0
  48. package/dist/chunk-HDMBVLCZ.js +53 -0
  49. package/dist/chunk-HQOB7OQS.js +81 -0
  50. package/dist/chunk-IGYRMM62.js +28 -0
  51. package/dist/chunk-IJBSOWHK.js +86 -0
  52. package/dist/chunk-INT7QLEU.js +114 -0
  53. package/dist/chunk-J6QLLQVL.js +1025 -0
  54. package/dist/chunk-J7UYNJCR.js +9 -0
  55. package/dist/chunk-JEL35P7S.js +53 -0
  56. package/dist/chunk-JGJ4INEN.js +32 -0
  57. package/dist/chunk-JS5RTH4I.js +84 -0
  58. package/dist/chunk-JUXNIXN4.js +42 -0
  59. package/dist/chunk-JWRZDYB5.js +59 -0
  60. package/dist/chunk-KMXRRSKT.js +660 -0
  61. package/dist/chunk-LAZQBMAU.js +67 -0
  62. package/dist/chunk-LLBPVZXM.js +67 -0
  63. package/dist/chunk-LLT5FQBE.js +57 -0
  64. package/dist/chunk-LMT3PPXJ.js +17 -0
  65. package/dist/chunk-MM2Y43LC.js +87 -0
  66. package/dist/chunk-MPSQXSC6.js +346 -0
  67. package/dist/chunk-MVFH26QT.js +97 -0
  68. package/dist/chunk-MWFOUBFC.js +39 -0
  69. package/dist/chunk-N5AQ3PP7.js +211 -0
  70. package/dist/chunk-NQPURJT5.js +44 -0
  71. package/dist/chunk-NRBQK6UX.js +105 -0
  72. package/dist/chunk-NZS5CD72.js +333 -0
  73. package/dist/chunk-OEH47H6A.js +48 -0
  74. package/dist/chunk-OG7QR2DP.js +75 -0
  75. package/dist/chunk-OPYFEHKG.js +52 -0
  76. package/dist/chunk-P4N7DBD5.js +83 -0
  77. package/dist/chunk-PAX3QXX2.js +140 -0
  78. package/dist/chunk-PLX3BOOS.js +396 -0
  79. package/dist/chunk-PMJG2CXF.js +122 -0
  80. package/dist/chunk-PWSJJXLQ.js +643 -0
  81. package/dist/chunk-Q5H3L6Y4.js +23 -0
  82. package/dist/chunk-Q65R3XKX.js +155 -0
  83. package/dist/chunk-QEW4J3IZ.js +74 -0
  84. package/dist/chunk-QPL7E2HW.js +464 -0
  85. package/dist/chunk-R2GPCZUX.js +22 -0
  86. package/dist/chunk-R4L6LJJ2.js +778 -0
  87. package/dist/chunk-R5MT42JS.js +284 -0
  88. package/dist/chunk-RK4PYD7L.js +73 -0
  89. package/dist/chunk-RMATE45Z.js +197 -0
  90. package/dist/chunk-S3PIAMXV.js +230 -0
  91. package/dist/chunk-SG5TPMKH.js +93 -0
  92. package/dist/chunk-T3LKX23M.js +168 -0
  93. package/dist/chunk-T6GOWHK6.js +30 -0
  94. package/dist/chunk-TIA4SPU2.js +10 -0
  95. package/dist/chunk-TNCZ6444.js +57 -0
  96. package/dist/chunk-TVL5RTE6.js +269 -0
  97. package/dist/chunk-UOCLRM7P.js +151 -0
  98. package/dist/chunk-UPQTAHUK.js +189 -0
  99. package/dist/chunk-V4NPDK6X.js +14 -0
  100. package/dist/chunk-VJFEN6DJ.js +38 -0
  101. package/dist/chunk-WIW772I3.js +25 -0
  102. package/dist/chunk-XELAZAIM.js +136 -0
  103. package/dist/chunk-XNML2KIC.js +23 -0
  104. package/dist/chunk-XP2U3LO3.js +30 -0
  105. package/dist/chunk-YGOWIJPE.js +51 -0
  106. package/dist/chunk-YIXDHQYE.js +11 -0
  107. package/dist/chunk-YMHUM7AV.js +22 -0
  108. package/dist/chunk-YSAWTGNA.js +117 -0
  109. package/dist/chunk-Z4HRRXRF.js +478 -0
  110. package/dist/chunk-ZH6R642Z.js +102 -0
  111. package/dist/claude-U2JC2DNQ.js +77 -0
  112. package/dist/cli-VYCQJZ5X.js +41 -0
  113. package/dist/cli-ZTCBSDW4.js +46 -0
  114. package/dist/cli.js +144 -16197
  115. package/dist/completion-E7RRG3ZT.js +142 -0
  116. package/dist/config-DnpLL2kT.d.ts +46 -0
  117. package/dist/{service-qpCsOXkQ.d.ts → core-C1LPjxK6.d.ts} +2 -6
  118. package/dist/diagnostics-XXH4FLUG.js +93 -0
  119. package/dist/doctor-ZIOESU3N.js +538 -0
  120. package/dist/entry-ZNFCTDVE.js +305 -0
  121. package/dist/exec-mcp-X6372BLE.js +365 -0
  122. package/dist/harness-F2XFDYXF.js +177 -0
  123. package/dist/harness-egress-bridge.js +4 -4
  124. package/dist/harness-launch-gate.js +47 -940
  125. package/dist/harness-pane-runner.js +13 -80
  126. package/dist/harness-worker.js +21 -2703
  127. package/dist/hook-body.js +5221 -0
  128. package/dist/hook-spec-C5fWTSCH.d.ts +100 -0
  129. package/dist/hook.js +26 -0
  130. package/dist/hooks-FYE2L5RW.js +21 -0
  131. package/dist/host-GRY3VAHH.js +22 -0
  132. package/dist/host-X6BR6X4O.js +200 -0
  133. package/dist/host-run-GCA6H6SR.js +307 -0
  134. package/dist/http.d.ts +5 -42
  135. package/dist/http.js +21 -2234
  136. package/dist/import-mcp-2TTBPVLY.js +400 -0
  137. package/dist/index.d.ts +146 -168
  138. package/dist/index.js +133 -4948
  139. package/dist/init-627KFXTG.js +14 -0
  140. package/dist/install-GG7HHZK2.js +796 -0
  141. package/dist/invoke-LW22Z6ET.js +23 -0
  142. package/dist/list-MCP2FXUF.js +68 -0
  143. package/dist/list-NGMSQ5SH.js +65 -0
  144. package/dist/load-BEUBABtB.d.ts +21 -0
  145. package/dist/logout-6CSHUWWE.js +44 -0
  146. package/dist/logs-SPB6AANY.js +107 -0
  147. package/dist/mailbox/index.d.ts +10 -5
  148. package/dist/mailbox/index.js +53 -1572
  149. package/dist/mailbox-7BV54Q4R.js +285 -0
  150. package/dist/mailbox-GDJ7BWQN.js +189 -0
  151. package/dist/mainline-JQTTYJMI.js +639 -0
  152. package/dist/marketplace-G4VQET5W.js +191 -0
  153. package/dist/mcp-2DKVU3SW.js +15 -0
  154. package/dist/mcp-V23HC3LB.js +193 -0
  155. package/dist/models-ISU4DCMA.js +32 -0
  156. package/dist/opencode-CN7JLQYO.js +60 -0
  157. package/dist/pause-FFAYRBWI.js +18 -0
  158. package/dist/preview-DT7DWG5F.js +91 -0
  159. package/dist/project/hook-adapter.d.ts +5 -2
  160. package/dist/project/hook-adapter.js +41 -27
  161. package/dist/project-FY62G55N.js +70 -0
  162. package/dist/pty-XTJ4MIWK.js +94 -0
  163. package/dist/recovery-U6QB3PMT.js +100 -0
  164. package/dist/reindex-Y27QJFDB.js +22 -0
  165. package/dist/resume-UU4HZIUP.js +18 -0
  166. package/dist/run-HALGEJNJ.js +19 -0
  167. package/dist/run-OGA3P7FC.js +126 -0
  168. package/dist/serve-NBKT5BKY.js +104 -0
  169. package/dist/session-XM2CR425.js +159 -0
  170. package/dist/setup-DTKZLZUT.js +18 -0
  171. package/dist/start-login-UIQYQBMC.js +416 -0
  172. package/dist/status-A2OUTNGK.js +9 -0
  173. package/dist/status-H2VAHIDV.js +10 -0
  174. package/dist/status-NOOHW5WA.js +43 -0
  175. package/dist/status-VHODZPXB.js +55 -0
  176. package/dist/status-XQANBVXW.js +286 -0
  177. package/dist/stdio.d.ts +3 -13
  178. package/dist/stdio.js +16 -3186
  179. package/dist/sweep-64JDCGK6.js +18 -0
  180. package/dist/test-MKAXFJOL.js +561 -0
  181. package/dist/tools-gpHNq9Dh.d.ts +328 -0
  182. package/dist/tui-MWKAXE4K.js +153 -0
  183. package/dist/unbroadcast-KPUEFLZD.js +18 -0
  184. package/dist/validate-5GZ5YWNA.js +46 -0
  185. package/dist/worker-RQ575EJL.js +80 -0
  186. package/dist/worktree-create-PZSRB7PH.js +89 -0
  187. package/dist/worktree-list-JYB6VXLW.js +51 -0
  188. package/dist/worktree-sync-UF5CXPWV.js +30 -0
  189. package/docs/hooks/capabilities/antigravity.json +199 -0
  190. package/docs/hooks/capabilities/claude.json +179 -0
  191. package/docs/hooks/capabilities/codex.json +179 -0
  192. package/docs/hooks/capabilities/gemini.json +196 -0
  193. package/docs/hooks/capabilities/grok.json +192 -0
  194. package/docs/hooks/capabilities/opencode.json +184 -0
  195. package/docs/project-configuration.md +821 -4
  196. package/docs/terminal-harness.md +71 -28
  197. package/docs/terminal-workspace.md +91 -170
  198. package/gemini-extension.json +1 -1
  199. package/package.json +13 -1
  200. package/plugin.json +1 -1
  201. package/plugins/pmcp/.claude-plugin/plugin.json +4 -2
  202. package/plugins/pmcp/gemini-extension.json +1 -1
  203. package/plugins/pmcp/mod/commands.ts +72 -0
  204. package/plugins/pmcp/mod/contract.d.ts +39 -0
  205. package/plugins/pmcp/mod/draw.tsx +216 -0
  206. package/plugins/pmcp/mod/guard.ts +42 -0
  207. package/plugins/pmcp/mod/hooks.json +4 -0
  208. package/plugins/pmcp/mod/host.ts +46 -0
  209. package/plugins/pmcp/mod/model.ts +144 -0
  210. package/plugins/pmcp/mod/reader/index.ts +18 -0
  211. package/plugins/pmcp/mod/reader/read.ts +76 -0
  212. package/plugins/pmcp/mod/reader/settings.ts +54 -0
  213. package/plugins/pmcp/mod/reader/types.ts +38 -0
  214. package/plugins/pmcp/mod/register.tsx +73 -0
  215. package/plugins/pmcp/mod/sessions/format.ts +91 -0
  216. package/plugins/pmcp/mod/sessions/types.ts +162 -0
  217. package/plugins/pmcp/mod/snapshot.ts +75 -0
  218. package/plugins/pmcp/mod/spinner.tsx +30 -0
  219. package/plugins/pmcp/mod/state.ts +28 -0
  220. package/plugins/pmcp/plugin.json +1 -1
  221. package/plugins/pmcp/skills/agent-assets-migrate/SKILL.md +96 -0
  222. package/plugins/pmcp/skills/headless-agents-ci-scaffold/SKILL.md +100 -0
  223. package/plugins/pmcp/skills/marketplace-plugin-scaffold/SKILL.md +87 -0
  224. package/plugins/pmcp/skills/package-skill-catalog/SKILL.md +51 -11
  225. package/plugins/pmcp/skills/pmcp-project-init/SKILL.md +145 -0
  226. package/plugins/pmcp/skills/pmcp-sessions-and-git/SKILL.md +104 -0
  227. package/plugins/pmcp/skills/skill-package-scaffold/SKILL.md +88 -0
  228. package/schema/catalog-v1.json +158 -0
  229. package/schema/library.json +164 -0
  230. package/schema/marketplace-manifest.json +130 -0
  231. package/schema/plugin-manifest.json +55 -0
  232. package/schema/skill-frontmatter.json +144 -0
  233. package/schema/skill-metadata-core.json +110 -0
  234. package/skills/agent-assets-migrate/SKILL.md +96 -0
  235. package/skills/headless-agents-ci-scaffold/SKILL.md +100 -0
  236. package/skills/marketplace-plugin-scaffold/SKILL.md +87 -0
  237. package/skills/package-skill-catalog/SKILL.md +51 -11
  238. package/skills/pmcp-project-init/SKILL.md +145 -0
  239. package/skills/pmcp-sessions-and-git/SKILL.md +104 -0
  240. package/skills/skill-package-scaffold/SKILL.md +88 -0
  241. package/dist/config-BkSpjUG6.d.ts +0 -50
  242. package/dist/embed-DRROSD3F.d.ts +0 -53
  243. package/dist/hook-spec-CSJJySsH.d.ts +0 -11
  244. package/dist/server-VWSY3Shw.d.ts +0 -543
  245. package/dist/tui-worker.js +0 -6549
  246. /package/dist/{tui-worker.d.ts → hook.d.ts} +0 -0
@@ -612,7 +612,7 @@
612
612
  },
613
613
  {
614
614
  "name": "pmcp",
615
- "version": "0.17.4",
615
+ "version": "0.18.0",
616
616
  "description": "Find package skills and use native runtime project configuration.",
617
617
  "source": { "source": "local", "path": "./plugins/pmcp" },
618
618
  "policy": { "installation": "AVAILABLE", "authentication": "ON_USE" },
@@ -445,7 +445,7 @@
445
445
  },
446
446
  {
447
447
  "name": "pmcp",
448
- "version": "0.17.4",
448
+ "version": "0.18.0",
449
449
  "description": "Find package skills and use native runtime project configuration.",
450
450
  "source": "./plugins/pmcp"
451
451
  },
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pmcp",
3
- "version": "0.17.4",
3
+ "version": "0.18.0",
4
4
  "description": "Find package skills and use native runtime project configuration.",
5
5
  "author": { "name": "modootoday" },
6
6
  "license": "Elastic-2.0",
package/CHANGELOG.md ADDED
@@ -0,0 +1,60 @@
1
+ # Changelog
2
+
3
+ ## 0.18.0
4
+
5
+ This release replaces tmux with pmcp's own terminal host and adds project
6
+ hooks, sessions and two MCP servers for browser and desktop use. As a 0.x minor
7
+ release it contains breaking changes.
8
+
9
+ ### Breaking
10
+
11
+ - tmux is no longer used or required. Native sessions run in pmcp-pty, a PTY
12
+ host with one daemon per harness group, and `pmcp tui` draws the workspace
13
+ with pmcp-tui. Groups and workspaces created by 0.17 and earlier are not
14
+ migrated: close them with the release that created them, then start a new
15
+ one.
16
+ - The `pmcp tui` view operations (`create`, `open`, `close`, `stop` and the
17
+ others taking `--view`) and their options are removed. `pmcp tui`,
18
+ `plan`, `recovery`, `doctor` and `start-worker` remain.
19
+ - Harness session records hold the pmcp-pty session, host instance and
20
+ process id instead of tmux pane identities.
21
+ - The terminal workspace and harness need Linux (glibc 2.35 or later) or
22
+ macOS. On Linux a user systemd manager caps each session's memory; macOS
23
+ runs sessions uncapped. Windows is not supported yet.
24
+
25
+ ### Terminal host and workspace
26
+
27
+ - pmcp-pty hosts native runtimes with guarded writes, per-runtime screen
28
+ profiles, turn detection from hook events, and a lease that refuses any
29
+ other writer while someone holds control.
30
+ - pmcp-tui shows main, a worker dock and a coordination panel, with explicit
31
+ control, history and mailbox views, read only until you take control.
32
+ - npm installs pmcp-pty and pmcp-tui through a platform package
33
+ (`@modootoday/pmcp-<os>-<cpu>`) for Linux and macOS on x64 and arm64.
34
+ `PMCP_PTY_BIN` and `PMCP_TUI_BIN` override it. The macOS binaries are
35
+ unsigned.
36
+ - `[host]` in pmcp.toml declares which tool dialogs an operator-approved host
37
+ may answer; login, authentication and trust prompts are never answered.
38
+ - `pmcp harness host up`, `down` and `unit` manage a host for the project.
39
+
40
+ ### Browser and desktop
41
+
42
+ - pmcp-browser runs an isolated, headless Chromium over MCP that reaches
43
+ public sites only. pmcp-desktop drives an Xvfb desktop through screenshots
44
+ and input. Both ship in the Linux platform package; name them bare in
45
+ `[mcp.<alias>] command` and `pmcp project` resolves the installed binary.
46
+
47
+ ### Hooks, sessions and project configuration
48
+
49
+ - `[hooks]` compiles to one hook bundle projected for Claude Code, Codex,
50
+ Gemini CLI, Grok, Antigravity and opencode, with guards for secrets,
51
+ staging, pushes and worktrees.
52
+ - Sessions: a files-based session store, `pmcp sessions`, an addressed
53
+ mailbox, and waking idle recipients.
54
+ - `pmcp logs` reads the project's JSONL logs, with rotation and retention set
55
+ by `[logging]`.
56
+ - `pmcp git` creates and syncs worktrees and delivers commits to the mainline.
57
+ - `pmcp mcp` shares remote MCP authentication across runtimes.
58
+ - `pmcp status`, `pmcp init`, `pmcp hooks` and `pmcp completion` are new;
59
+ `[permissions.claude]`, `[catalog.validation]` and declared marketplaces
60
+ are projected from pmcp.toml.
package/README.md CHANGED
@@ -143,12 +143,18 @@ and memory metadata.
143
143
  ## Manage native terminals
144
144
 
145
145
  PMCP 0.13.0 or later can show a native main runtime, its worker terminals and a
146
- coordination panel in one terminal workspace. The optional harness and TUI need
147
- Linux, tmux, util-linux flock, Node.js 22 or later and a working user systemd
148
- manager. Provider login, folder trust and tool approvals remain native.
149
-
150
- PMCP 0.16.0 adds the numbered runtime picker, worker menu, worker-start and
151
- read-only recovery flows below.
146
+ coordination panel in one terminal workspace. PMCP 0.18.0 and later run it on
147
+ pmcp-pty (`crates/pmcp-pty`), a PTY host, and draw it with pmcp-tui
148
+ (`crates/pmcp-tui`); earlier releases used tmux. The optional harness and TUI
149
+ need Linux (glibc 2.35 or later) or macOS, Node.js 22 or later, and on Linux a
150
+ working user systemd manager; npm installs pmcp-pty and pmcp-tui with PMCP.
151
+ Windows is not supported yet. Provider login, folder trust and tool approvals
152
+ remain native; an operator-approved `[host]` may answer the tool dialogs it
153
+ lists, and never login, auth or trust prompts (see
154
+ [Sessions pmcp-pty hosts](docs/project-configuration.md#sessions-pmcp-pty-hosts)).
155
+
156
+ See the [changelog](CHANGELOG.md) for what changed in 0.18.0, including the
157
+ removal of tmux.
152
158
 
153
159
  ```sh
154
160
  npx @modootoday/pmcp --version
@@ -163,8 +169,8 @@ pmcp
163
169
  ```
164
170
 
165
171
  The first launch lists installed native runtimes. Choose a number or accept the
166
- default, then confirm the start; q cancels without creating a group. No group or
167
- view JSON is required. Later launches reconnect to the workspace
172
+ default, then confirm the start; q cancels without creating a group. No group JSON is
173
+ required. Later launches reconnect to the workspace
168
174
  created for this project. Native login and folder trust stay with the runtime.
169
175
  Use `pmcp tui --runtime codex-cli` to choose the main, or set an optional default:
170
176
 
@@ -173,9 +179,8 @@ Use `pmcp tui --runtime codex-cli` to choose the main, or set an optional defaul
173
179
  runtime = "codex-cli"
174
180
  ```
175
181
 
176
- Once the workspace is open, press Ctrl-g then n to choose and confirm a worker.
177
- The menu releases input control and preserves the current draft. You can also use
178
- `pmcp tui start-worker --runtime gemini-cli`. The existing group keeps its
182
+ Add a worker with `pmcp tui start-worker --runtime gemini-cli`; it appears in
183
+ the workspace's dock. The existing group keeps its
179
184
  runtime grants and resource bounds. Use `pmcp tui recovery` to inspect a saved
180
185
  workspace and obtain explicit next commands after an interrupted start. Inspection
181
186
  does not restart a runtime or replay input.
@@ -184,8 +189,8 @@ does not restart a runtime or replay input.
184
189
  [terminal workspace guide](docs/terminal-workspace.md) covers defaults, custom
185
190
  configuration and advanced controls. The [native terminal guide](docs/terminal-harness.md)
186
191
  explains explicit group and session operations.
187
- Views start read only; acquiring control and stopping a runtime are explicit
188
- actions. This optional CLI feature does not add execution tools to the MCP server.
192
+ The workspace starts read only; taking control (Ctrl-g then c) and stopping a
193
+ runtime are explicit actions. This optional CLI feature does not add execution tools to the MCP server.
189
194
 
190
195
  ## Everyday commands
191
196
 
@@ -222,20 +227,20 @@ interactive hosts show help and prerequisite guidance.
222
227
 
223
228
  ## Compatibility
224
229
 
225
- | Surface | Current qualification |
226
- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
227
- | CLI and MCP on Linux amd64 | Published 0.15.0 passed clean Docker installation with npm on Debian/Alpine and Bun/pnpm on Debian; 60 installation and failure contracts |
228
- | Optional terminal workspace | Linux PTY/tmux checks and bounded native Codex, Gemini, Grok and agy main/worker acceptance; Claude remains deferred |
229
- | Public skill installation | npm, Bun and pnpm 10.17.1; confirmation required, scripts disabled |
230
- | Native plugin export | Claude, Codex, Gemini, Grok and agy formats; export does not install or activate a vendor plugin |
231
- | pnpm workspace installation | Selects the member, preserves root dependencies and updates the shared lockfile |
232
- | Yarn skill installation | Refused without changing project files; Yarn PnP is not supported |
233
- | macOS, Windows and other architectures | Not qualified by the Linux Docker tests |
230
+ | Surface | Current qualification |
231
+ | -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
232
+ | CLI and MCP on Linux amd64 | Published 0.15.0 passed clean Docker installation with npm on Debian/Alpine and Bun/pnpm on Debian; 60 installation and failure contracts |
233
+ | Optional terminal workspace | Linux pmcp-pty checks and a native Claude main with a Gemini worker (control, input, wake turns, recovery); other runtimes measured on tmux in 0.17 |
234
+ | Public skill installation | npm, Bun and pnpm 10.17.1; confirmation required, scripts disabled |
235
+ | Native plugin export | Claude, Codex, Gemini, Grok and agy formats; export does not install or activate a vendor plugin |
236
+ | pnpm workspace installation | Selects the member, preserves root dependencies and updates the shared lockfile |
237
+ | Yarn skill installation | Refused without changing project files; Yarn PnP is not supported |
238
+ | macOS, Windows and other architectures | Not qualified by the Linux Docker tests; macOS terminal binaries ship unsigned, Windows is not supported yet |
234
239
 
235
240
  Provider authentication, native children and vendor behavior have separate
236
241
  qualification scopes. An installed executable or exported manifest is not proof
237
- that every native feature works. Public package CI checks actual packed-archive
238
- installation, CLI startup, MCP and SQLite before publication; isolated projects
242
+ that every native feature works. The packed-package check, run before a
243
+ release, covers actual archive installation, CLI startup, MCP and SQLite; isolated projects
239
244
  on a host are distinct from Docker and OS qualification.
240
245
 
241
246
  ## Guides
@@ -0,0 +1,242 @@
1
+ import {
2
+ specFrom
3
+ } from "./chunk-7BLPN3W6.js";
4
+ import {
5
+ catalogFrom
6
+ } from "./chunk-5QQWS4US.js";
7
+ import "./chunk-7DLZC73N.js";
8
+ import {
9
+ project
10
+ } from "./chunk-N5AQ3PP7.js";
11
+ import "./chunk-P4N7DBD5.js";
12
+ import {
13
+ renderFrontmatter,
14
+ splitFrontmatter
15
+ } from "./chunk-J6QLLQVL.js";
16
+ import "./chunk-PLX3BOOS.js";
17
+ import {
18
+ RUNTIMES
19
+ } from "./chunk-65ZHM5RH.js";
20
+ import "./chunk-HQOB7OQS.js";
21
+ import "./chunk-S3PIAMXV.js";
22
+ import "./chunk-JS5RTH4I.js";
23
+ import "./chunk-DCU2EXQV.js";
24
+ import "./chunk-XELAZAIM.js";
25
+ import "./chunk-QEW4J3IZ.js";
26
+ import "./chunk-OPYFEHKG.js";
27
+ import "./chunk-EATCUWGG.js";
28
+ import {
29
+ ProjectError
30
+ } from "./chunk-NRBQK6UX.js";
31
+ import "./chunk-3PW4FI7U.js";
32
+ import "./chunk-SG5TPMKH.js";
33
+ import "./chunk-Z4HRRXRF.js";
34
+ import "./chunk-C4NHQGHL.js";
35
+ import "./chunk-Q5H3L6Y4.js";
36
+ import "./chunk-73AKO4UL.js";
37
+ import "./chunk-JEL35P7S.js";
38
+ import "./chunk-A4PKLESO.js";
39
+ import "./chunk-V4NPDK6X.js";
40
+ import {
41
+ kindOf
42
+ } from "./chunk-KMXRRSKT.js";
43
+ import "./chunk-YSAWTGNA.js";
44
+ import "./chunk-4VCC2NXE.js";
45
+ import {
46
+ recordProjector
47
+ } from "./chunk-665TA55Z.js";
48
+ import "./chunk-OEH47H6A.js";
49
+ import "./chunk-IJBSOWHK.js";
50
+ import "./chunk-E7OOHLQR.js";
51
+ import "./chunk-QPL7E2HW.js";
52
+ import "./chunk-PMJG2CXF.js";
53
+
54
+ // src/project/edit.ts
55
+ import {
56
+ cpSync,
57
+ existsSync,
58
+ mkdirSync,
59
+ readFileSync,
60
+ rmSync,
61
+ statSync,
62
+ writeFileSync
63
+ } from "fs";
64
+ import { basename, dirname, join } from "path";
65
+ var CROSS_TOOL = ["name", "description"];
66
+ var tomlValue = (value) => JSON.stringify(value);
67
+ function findEntry(entries, wanted) {
68
+ const exact = entries.filter((e) => e.name === wanted);
69
+ if (exact.length === 1 && exact[0]) return exact[0];
70
+ const bySlug = entries.filter(
71
+ (e) => e.slug === wanted || e.slug.endsWith(`/${wanted}`)
72
+ );
73
+ if (bySlug.length === 1 && bySlug[0]) return bySlug[0];
74
+ if (bySlug.length > 1) {
75
+ throw new ProjectError(
76
+ `${wanted} is ambiguous: ${bySlug.map((e) => e.name).join(", ")}`
77
+ );
78
+ }
79
+ throw new ProjectError(`no catalog skill or agent named ${wanted}`);
80
+ }
81
+ function addEntry(root, entry) {
82
+ const kind = kindOf(entry);
83
+ if (kind !== "skill" && kind !== "agent") {
84
+ throw new ProjectError(
85
+ `${entry.name} is a ${kind}; only skills and agents are added to .agents/`
86
+ );
87
+ }
88
+ const { meta, body } = splitFrontmatter(readFileSync(entry.path, "utf8"));
89
+ const name = basename(entry.slug);
90
+ if (!/^[a-z0-9][a-z0-9-]*$/u.test(name)) {
91
+ throw new ProjectError(
92
+ `${entry.name}: ${name} is not a usable directory name`
93
+ );
94
+ }
95
+ if (kind === "skill") {
96
+ const dest2 = join(root, ".agents/skills", name);
97
+ if (existsSync(dest2))
98
+ throw new ProjectError(`.agents/skills/${name} already exists`);
99
+ const source = entry.root ?? dirname(entry.path);
100
+ mkdirSync(dirname(dest2), { recursive: true });
101
+ if (statSync(source).isDirectory()) {
102
+ cpSync(source, dest2, { recursive: true });
103
+ } else {
104
+ mkdirSync(dest2);
105
+ }
106
+ const head = renderFrontmatter({
107
+ ...meta,
108
+ name,
109
+ description: meta["description"] ?? entry.description
110
+ });
111
+ writeFileSync(
112
+ join(dest2, "SKILL.md"),
113
+ `${head}
114
+ ${body.replace(/^\n/u, "")}`
115
+ );
116
+ return { kind, name, path: `.agents/skills/${name}` };
117
+ }
118
+ const dest = join(root, ".agents/agents", name);
119
+ if (existsSync(dest))
120
+ throw new ProjectError(`.agents/agents/${name} already exists`);
121
+ const kept = {};
122
+ const moved = {};
123
+ for (const [key, value] of Object.entries({ ...meta, name })) {
124
+ if (CROSS_TOOL.includes(key)) {
125
+ kept[key] = value;
126
+ continue;
127
+ }
128
+ moved[key] = value;
129
+ }
130
+ mkdirSync(dest, { recursive: true });
131
+ writeFileSync(
132
+ join(dest, "agent.md"),
133
+ `${renderFrontmatter(kept)}
134
+ ${body.replace(/^\n/u, "")}`
135
+ );
136
+ if (Object.keys(moved).length > 0) {
137
+ const config = join(root, "pmcp.toml");
138
+ const lines = [
139
+ `[agents.${name}.claude]`,
140
+ ...Object.entries(moved).map(([k, v]) => `${k} = ${tomlValue(v)}`)
141
+ ];
142
+ const before = existsSync(config) ? readFileSync(config, "utf8") : "";
143
+ const sep = before === "" || before.endsWith("\n\n") ? "" : "\n";
144
+ writeFileSync(config, `${before}${sep}${lines.join("\n")}
145
+ `);
146
+ }
147
+ return { kind, name, path: `.agents/agents/${name}/agent.md` };
148
+ }
149
+ function withoutTables(toml, name) {
150
+ const own = new RegExp(
151
+ `^\\[(skills\\.${name}|agents\\.${name}(\\.[a-z]+)?)\\]\\s*$`,
152
+ "u"
153
+ );
154
+ const out = [];
155
+ let skipping = false;
156
+ for (const line of toml.split("\n")) {
157
+ if (/^\[/u.test(line)) skipping = own.test(line);
158
+ if (!skipping) out.push(line);
159
+ }
160
+ return out.join("\n").replace(/\n{3,}/gu, "\n\n");
161
+ }
162
+ function removeAsset(root, name) {
163
+ const removed = [];
164
+ for (const rel of [`.agents/skills/${name}`, `.agents/agents/${name}`]) {
165
+ if (!existsSync(join(root, rel))) continue;
166
+ rmSync(join(root, rel), { recursive: true, force: true });
167
+ removed.push(rel);
168
+ }
169
+ if (removed.length === 0)
170
+ throw new ProjectError(`no skill or agent named ${name} in .agents/`);
171
+ const config = join(root, "pmcp.toml");
172
+ if (existsSync(config)) {
173
+ const before = readFileSync(config, "utf8");
174
+ const after = withoutTables(before, name);
175
+ if (after !== before) writeFileSync(config, after);
176
+ }
177
+ return removed;
178
+ }
179
+
180
+ // src/commands/project/apply.ts
181
+ function reproject(context, spec) {
182
+ const result = project(spec, { check: false });
183
+ for (const problem of result.problems) context.ui.error(problem);
184
+ if (result.code !== 0) {
185
+ return 1;
186
+ }
187
+ recordProjector(spec);
188
+ if (result.backup) {
189
+ context.ui.info("backup", result.backup);
190
+ }
191
+ context.ui.success(
192
+ `projected ${result.outputs} outputs`,
193
+ result.pruned > 0 ? `pruned ${result.pruned}` : void 0
194
+ );
195
+ for (const deprecation of spec.deprecations ?? [])
196
+ context.ui.warn(deprecation);
197
+ for (const id of spec.hookBundle?.policy?.targets ?? []) {
198
+ if (RUNTIMES[id].trust !== "folder") continue;
199
+ context.ui.info(
200
+ id,
201
+ "hooks run only once you trust this folder in the runtime; pmcp doctor reports it"
202
+ );
203
+ }
204
+ return 0;
205
+ }
206
+ function projectOrCheck(context) {
207
+ const spec = specFrom(context);
208
+ if (!context.args.flags.has("check")) {
209
+ return reproject(context, spec);
210
+ }
211
+ const result = project(spec, { check: true });
212
+ for (const problem of result.problems) context.ui.error(problem);
213
+ for (const warning of result.warnings ?? []) context.ui.warn(warning);
214
+ if (result.code !== 0) {
215
+ context.ui.info(
216
+ "fix",
217
+ "pmcp project (edit .agents/ or pmcp.toml, never the outputs)"
218
+ );
219
+ return 2;
220
+ }
221
+ context.ui.success(`${result.outputs} outputs match`);
222
+ return 0;
223
+ }
224
+ function addAndProject(context, name) {
225
+ const spec = specFrom(context);
226
+ const added = addEntry(spec.root, findEntry(catalogFrom(context), name));
227
+ context.ui.success(`added ${added.kind} ${added.name}`, added.path);
228
+ return reproject(context, specFrom(context));
229
+ }
230
+ function removeAndProject(context, name) {
231
+ const spec = specFrom(context);
232
+ for (const path of removeAsset(spec.root, name)) {
233
+ context.ui.success("removed", path);
234
+ }
235
+ return reproject(context, specFrom(context));
236
+ }
237
+ export {
238
+ addAndProject,
239
+ projectOrCheck,
240
+ removeAndProject
241
+ };
242
+ //# sourceMappingURL=apply-4IGTXOCQ.js.map
@@ -1,4 +1,4 @@
1
- import { a as MailboxConfig, M as MailboxService } from './service-qpCsOXkQ.js';
1
+ import { a as MailboxConfig, M as MailboxService } from './core-C1LPjxK6.js';
2
2
 
3
3
  interface MailboxAttachmentOptions {
4
4
  readonly config: MailboxConfig;
@@ -0,0 +1,73 @@
1
+ import {
2
+ sayStanding
3
+ } from "./chunk-4NDEP7HU.js";
4
+ import {
5
+ matchingSkills,
6
+ readInstalledDependencies
7
+ } from "./chunk-BBTBJCFA.js";
8
+ import {
9
+ invocation
10
+ } from "./chunk-J7UYNJCR.js";
11
+ import {
12
+ projectFrom,
13
+ remoteCatalog
14
+ } from "./chunk-R5MT42JS.js";
15
+ import "./chunk-RMATE45Z.js";
16
+ import "./chunk-73AKO4UL.js";
17
+ import {
18
+ availableSpec
19
+ } from "./chunk-ABTJQ4QV.js";
20
+ import {
21
+ ArgumentError
22
+ } from "./chunk-A4PKLESO.js";
23
+ import "./chunk-KMXRRSKT.js";
24
+ import "./chunk-YSAWTGNA.js";
25
+
26
+ // src/commands/available.ts
27
+ var availableCommand = {
28
+ ...availableSpec,
29
+ async run(context) {
30
+ if (context.args.positional.length)
31
+ throw new ArgumentError("available takes no package arguments");
32
+ const inventory = readInstalledDependencies(projectFrom(context));
33
+ const catalog = await remoteCatalog(context);
34
+ const matches = matchingSkills(catalog, inventory);
35
+ if (context.args.flags.has("json")) {
36
+ context.ui.data(
37
+ `${JSON.stringify({ catalogRevision: catalog.revision, matches, issues: inventory.issues }, null, 2)}
38
+ `
39
+ );
40
+ } else {
41
+ for (const match of matches) {
42
+ const status = match.verified ? "verified" : "compatible, not verified at this exact version";
43
+ context.ui.data(
44
+ `${match.targetName}@${match.targetVersion} ${match.entry.delivery.packageName}@${match.entry.delivery.version} ${status}
45
+ `
46
+ );
47
+ const { verifiedOn, examplesExecuted } = match.entry.evidence;
48
+ context.ui.line(
49
+ ` ${examplesExecuted} examples executed${verifiedOn ? ` on ${verifiedOn}` : ""}`
50
+ );
51
+ const headings = match.entry.preview?.headings ?? [];
52
+ if (headings.length > 0) {
53
+ context.ui.line(` ${headings.join(" \xB7 ")}`);
54
+ }
55
+ sayStanding(context, match.entry.line);
56
+ }
57
+ context.ui.info(`${matches.length} matching skills`, catalog.revision);
58
+ if (matches.length > 0) {
59
+ context.ui.info(
60
+ "preview",
61
+ `${invocation()} preview <package> shows the contents and a complete example`
62
+ );
63
+ }
64
+ for (const issue of inventory.issues)
65
+ context.ui.warn(issue.reason, issue.name);
66
+ }
67
+ return inventory.issues.length ? 1 : 0;
68
+ }
69
+ };
70
+ export {
71
+ availableCommand
72
+ };
73
+ //# sourceMappingURL=available-DBSIVVJ6.js.map
@@ -0,0 +1,18 @@
1
+ import {
2
+ change
3
+ } from "./chunk-RK4PYD7L.js";
4
+ import "./chunk-SG5TPMKH.js";
5
+ import "./chunk-Z4HRRXRF.js";
6
+ import "./chunk-C4NHQGHL.js";
7
+ import "./chunk-A4PKLESO.js";
8
+ import "./chunk-OEH47H6A.js";
9
+ import "./chunk-IJBSOWHK.js";
10
+ import "./chunk-QPL7E2HW.js";
11
+ import "./chunk-PMJG2CXF.js";
12
+
13
+ // src/sessions/cli/broadcast.ts
14
+ var run = (context) => change(context, "broadcast");
15
+ export {
16
+ run
17
+ };
18
+ //# sourceMappingURL=broadcast-3RY3OZGY.js.map