@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
package/dist/index.d.ts CHANGED
@@ -1,45 +1,48 @@
1
- import { I as IntentCache, b as Ranking, S as SkillServerOptions, E as Embedder, C as CatalogOptions, a as SkillEntry, M as MetadataValue, c as SkillTools } from './server-VWSY3Shw.js';
2
- export { A as ASSET_KINDS, d as AssetKind, B as BundleFile, e as CATALOG_PAGE_MAX, f as CATALOG_PAGE_SIZE, g as COMPATIBILITY_MAX, h as CallResponse, i as CatalogItem, j as CatalogResponse, k as Classified, D as DEFAULT_FIND_LIMIT, l as DESCRIBE_FILE_LIMIT, m as DESCRIPTION_MAX, F as FileKind, n as FindOptions, o as FindResult, p as IntentCacheStats, K as KindFilter, q as MAX_SKILL_DEPTH, s as Match, t as MetadataLeaf, N as NAME_MAX, u as READ_BUDGET_BYTES, w as RUNTIMES, x as ReadResult, R as Runtime, y as SKIPPED_DIRS, z as SkillBundle, G as SkillFile, H as SkillFileContent, J as SkillFileListing, L as SkillFilters, O as bundleResponseSchema, P as bundleSkill, Q as catalogResponseSchema, T as classify, U as cosine, V as createSkillTools, W as describeResponseSchema, X as detectRuntime, Y as displayPath, Z as find, _ as findResultSchema, $ as isUtf8Text, a0 as kindOf, a1 as lexicalScore, a2 as listSkillFiles, a3 as mimeOf, a4 as normaliseIntent, a5 as parseSkillFrontmatter, a6 as readBody, r as readCatalog, a7 as readFrontmatter, a8 as readSkillFile, a9 as runtimeOfClient, aa as specProblems, v as verifiedRuntimesOf, ab as withoutBody } from './server-VWSY3Shw.js';
3
- import { L as LoadEmbedderOptions } from './embed-DRROSD3F.js';
4
- export { E as EntryVectorStore, e as encodeEntries, l as loadEmbedder, o as openEntryVectors } from './embed-DRROSD3F.js';
1
+ import { a as SkillEntry, E as Embedder, I as IntentCache, b as Ranking, S as SkillServerOptions, C as CatalogOptions, M as MetadataValue, c as SkillTools } from './tools-gpHNq9Dh.js';
2
+ export { A as ASSET_KINDS, d as AssetKind, B as BundleFile, e as COMPATIBILITY_MAX, f as CallResponse, g as CatalogItem, h as CatalogResponse, i as Classified, D as DEFAULT_FIND_LIMIT, j as DESCRIPTION_MAX, F as FileKind, k as FindOptions, l as FindResult, m as IntentCacheStats, K as KindFilter, n as MAX_SKILL_DEPTH, o as Match, p as MetadataLeaf, N as NAME_MAX, q as READ_BUDGET_BYTES, r as RUNTIMES, s as ReadResult, R as Runtime, t as SKIPPED_DIRS, u as SkillBundle, w as SkillFile, x as SkillFileContent, y as SkillFileListing, z as SkillFilters, G as bundleResponseSchema, H as bundleSkill, J as catalogResponseSchema, L as classify, O as cosine, P as createSkillTools, Q as describeResponseSchema, T as detectRuntime, U as find, V as findResultSchema, W as isUtf8Text, X as kindOf, Y as lexicalScore, Z as listSkillFiles, _ as mimeOf, $ as normaliseIntent, a0 as parseSkillFrontmatter, a1 as readSkillFile, a2 as runtimeOfClient, a3 as specProblems, v as verifiedRuntimesOf } from './tools-gpHNq9Dh.js';
3
+ import { E as EntryVectorStore, L as LoadEmbedderOptions } from './load-BEUBABtB.js';
4
+ export { l as loadEmbedder, r as readCatalog } from './load-BEUBABtB.js';
5
5
  export { D as DEFAULT_MODEL_ID, a as EmbeddingModel, b as EncoderDtype, E as EncoderOptions, c as EncoderSpec, R as ResolvedEncoder, e as embeddingModels, d as encoderSpec, r as resolveEncoder } from './encoder-DGRy9skC.js';
6
- import { P as ProjectConfig } from './config-BkSpjUG6.js';
7
- export { C as CONFIG_FILE, a as CatalogSection, b as ConfigError, E as EmbeddingSection, f as findConfig, r as readConfig } from './config-BkSpjUG6.js';
8
- import { S as ShellHookSpec } from './hook-spec-CSJJySsH.js';
6
+ import { P as ProjectConfig, V as ValidationSettings, F as Finding$1 } from './config-DnpLL2kT.js';
7
+ export { C as CONFIG_FILE, a as CatalogSection, b as ConfigError, E as EmbeddingSection, f as findConfig, r as readConfig } from './config-DnpLL2kT.js';
8
+ import { S as ShellHookSpec, a as HookSpecs } from './hook-spec-C5fWTSCH.js';
9
9
  import { McpServer } from '@modelcontextprotocol/server';
10
- import { M as MailboxService } from './service-qpCsOXkQ.js';
10
+ import { M as MailboxService } from './core-C1LPjxK6.js';
11
11
  import 'zod';
12
12
 
13
- /**
14
- * Query vectors, kept on disk between sessions.
15
- *
16
- * An MCP server starts per session and exits with it, so a process-local cache
17
- * begins empty every time and the same question pays its full embed cost in
18
- * every session that asks it. The table outlives the process; that is the whole
19
- * reason it is a table.
20
- */
13
+ declare function readFrontmatter(source: string): Record<string, string>;
14
+ declare function readBody(source: string): string;
15
+
16
+ declare function withoutBody({ path, ...rest }: SkillEntry): Omit<SkillEntry, "path">;
17
+ declare function displayPath(root: string, entry: SkillEntry): string;
18
+
19
+ declare function encodeEntries(embedder: Embedder, entries: readonly {
20
+ readonly name: string;
21
+ readonly description: string;
22
+ }[], previous?: ReadonlyMap<string, {
23
+ hash: string;
24
+ vector: Float32Array;
25
+ }>): Promise<Map<string, {
26
+ hash: string;
27
+ vector: Float32Array;
28
+ }>>;
29
+
30
+ declare function openEntryVectors(path: string, options?: {
31
+ readOnly?: boolean;
32
+ }): Promise<EntryVectorStore | null>;
33
+
34
+ declare const DESCRIBE_FILE_LIMIT = 200;
35
+ declare const CATALOG_PAGE_SIZE = 8;
36
+ declare const CATALOG_PAGE_MAX = 20;
21
37
 
22
38
  interface IntentCacheOptions {
23
- /** Database file. `:memory:` is accepted and is what the tests use. */
24
39
  readonly path: string;
25
- /** The embedder's identity. Rows from another model are never scored. */
26
40
  readonly modelId: string;
27
- /** Vector width. A row of a different width is a different model. */
28
41
  readonly dims: number;
29
- /** Rows kept. The least recently asked are dropped past this. */
30
42
  readonly limit?: number;
31
- /** Injected for tests. Real time otherwise. */
32
43
  readonly now?: () => number;
33
44
  }
34
45
  declare const DEFAULT_INTENT_CACHE_LIMIT = 4096;
35
- /**
36
- * Opens the cache, or returns null when it cannot be opened.
37
- *
38
- * Null is the normal answer on a read-only volume, a locked file, a corrupt
39
- * database, or a runtime with neither builtin: the caller embeds on demand
40
- * instead. A cache that throws would turn a missing optimisation into a failed
41
- * search, and an older runtime is that case rather than an error.
42
- */
43
46
  declare function openIntentCache(options: IntentCacheOptions): Promise<IntentCache | null>;
44
47
 
45
48
  interface SearchOptions extends LoadEmbedderOptions {
@@ -55,21 +58,18 @@ interface PreparedSearch {
55
58
  }
56
59
  declare function prepareSearch(catalog: CatalogOptions, options: SearchOptions): Promise<PreparedSearch>;
57
60
 
58
- /** Why an asset was left out rather than served. */
59
61
  interface Rejection {
60
62
  readonly path: string;
61
63
  readonly reason: string;
62
64
  }
63
- /** The `metadata:` map of a frontmatter: strings, string lists and maps of those. */
65
+
64
66
  declare function readMetadata(source: string): Record<string, MetadataValue>;
65
- /** The raw frontmatter text between the fences, for skill_describe. */
66
67
  declare function readFrontmatterText(source: string): string;
67
- /** Every asset one marketplace lists. */
68
+
68
69
  declare function readMarketplace(dir: string, onReject?: (rejection: Rejection) => void): SkillEntry[];
69
- /** The directory or single file an entry's describe and read may open. */
70
+
70
71
  declare const assetRoot: (entry: Pick<SkillEntry, "root" | "path">) => string;
71
72
 
72
- /** What the projector writes. A path is unique across a plan and is the lock key. */
73
73
  type Output = {
74
74
  readonly kind: "link";
75
75
  readonly path: string;
@@ -96,23 +96,110 @@ type Output = {
96
96
  readonly content: string;
97
97
  };
98
98
 
99
- /**
100
- * The projector's reading of pmcp.toml: which tools to write for, and the
101
- * per-asset settings that do not belong in the cross-tool sources under .agents/.
102
- */
99
+ declare const MARKETPLACE_RUNTIMES: readonly ["claude", "codex"];
100
+ type MarketplaceRuntime = (typeof MARKETPLACE_RUNTIMES)[number];
101
+ type MarketplaceSource = {
102
+ readonly kind: "path";
103
+ readonly path: string;
104
+ } | {
105
+ readonly kind: "github";
106
+ readonly repo: string;
107
+ readonly ref?: string;
108
+ } | {
109
+ readonly kind: "builtin";
110
+ };
111
+ interface DeclaredPlugin {
112
+ readonly name: string;
113
+ readonly targets: readonly MarketplaceRuntime[];
114
+ }
115
+ interface DeclaredMarketplace {
116
+ readonly name: string;
117
+ readonly source: MarketplaceSource;
118
+ readonly catalog?: boolean;
119
+ readonly plugins: readonly DeclaredPlugin[];
120
+ }
121
+
122
+ interface UiSettings {
123
+ readonly stateDir?: string;
124
+ readonly sessionsPane: boolean;
125
+ readonly statusBand: boolean;
126
+ readonly commands: boolean;
127
+ readonly holdForeignEdits: boolean;
128
+ }
129
+
130
+ interface RunResult {
131
+ readonly missing: boolean;
132
+ readonly status: number | null;
133
+ readonly stdout: string;
134
+ }
135
+ type Runner = (command: string, args: readonly string[], cwd: string, env?: Readonly<Record<string, string | undefined>>) => RunResult;
136
+ type Status = "ok" | "fail" | "warn" | "skip";
137
+ interface Finding {
138
+ readonly tool: Tool | "project";
139
+ readonly check: string;
140
+ readonly status: Status;
141
+ readonly detail?: string;
142
+ }
143
+ interface DoctorOptions {
144
+ readonly env?: Readonly<Record<string, string | undefined>>;
145
+ readonly run: Runner;
146
+ readonly home: string;
147
+ readonly only?: ReadonlySet<Tool>;
148
+ }
149
+
150
+ declare const BUCKETS: readonly ["allow", "ask", "deny"];
151
+ type Bucket = (typeof BUCKETS)[number];
152
+ interface PermissionSpec {
153
+ readonly claude: Readonly<Partial<Record<Bucket, readonly string[]>>>;
154
+ }
155
+
156
+ interface HostBrowser {
157
+ readonly allowPrivate: readonly string[];
158
+ }
159
+ interface HostLaunch {
160
+ readonly name: string;
161
+ readonly argv: readonly string[];
162
+ }
163
+ interface HostDesktop {
164
+ readonly launch: readonly HostLaunch[];
165
+ }
166
+
167
+ declare const HOST_RUNTIMES: readonly ["claude", "codex", "gemini", "agy", "grok", "opencode"];
168
+ type HostRuntime = (typeof HOST_RUNTIMES)[number];
169
+ interface HostSession {
170
+ readonly name: string;
171
+ readonly runtime: HostRuntime;
172
+ readonly cwd: string;
173
+ readonly argv: readonly string[];
174
+ readonly labels: Readonly<Record<string, string>>;
175
+ readonly restart: "no" | "on-exit";
176
+ readonly maxRestarts: number;
177
+ }
178
+ interface HostAnswer {
179
+ readonly runtime: HostRuntime;
180
+ readonly dialog: string;
181
+ readonly options: readonly string[];
182
+ }
183
+ interface HostSpec {
184
+ readonly sessions: readonly HostSession[];
185
+ readonly answers: readonly HostAnswer[];
186
+ readonly mcpWrite: boolean;
187
+ readonly roots: readonly string[];
188
+ readonly browser: HostBrowser;
189
+ readonly desktop: HostDesktop;
190
+ }
103
191
 
104
192
  declare const TOOLS: readonly ["claude", "codex", "gemini", "grok", "antigravity", "opencode"];
105
193
  type Tool = (typeof TOOLS)[number];
194
+
106
195
  type Invocation = "any" | "user";
107
196
  interface PackageRulesSpec {
108
- /** Path of the rule file inside each package, e.g. `.agent/rules/PACKAGE.RULE.md`. */
109
197
  readonly file: string;
110
- /** Subdirectory of `.claude/rules` the links go in. */
111
198
  readonly dir: string;
112
- /** Leading path segments dropped when a link name is derived. */
113
199
  readonly strip: readonly string[];
114
200
  }
115
201
  interface McpServerSpec {
202
+ readonly auth?: "native" | "pmcp";
116
203
  readonly mailbox?: boolean;
117
204
  readonly command?: string;
118
205
  readonly url?: string;
@@ -129,11 +216,13 @@ interface McpServerSpec {
129
216
  readonly bearerTokenEnvVar?: string;
130
217
  readonly native?: Partial<Record<Tool, Readonly<Record<string, number>>>>;
131
218
  readonly targets?: readonly Tool[];
132
- /** Tools the server should expose where a host can narrow them. */
133
219
  readonly tools?: readonly string[];
134
220
  }
135
221
  interface ProjectSpec {
136
222
  readonly hooks?: readonly ShellHookSpec[];
223
+ readonly hookBundle?: HookSpecs["bundle"];
224
+ readonly featureSources?: HookSpecs["sources"];
225
+ readonly deprecations?: readonly string[];
137
226
  readonly root: string;
138
227
  readonly tools: ReadonlySet<Tool>;
139
228
  readonly skills: Readonly<Record<string, {
@@ -142,80 +231,39 @@ interface ProjectSpec {
142
231
  readonly agents: Readonly<Record<string, Partial<Record<Tool, Record<string, unknown>>>>>;
143
232
  readonly packageRules: PackageRulesSpec | null;
144
233
  readonly mcp: Readonly<Record<string, McpServerSpec>>;
234
+ readonly marketplaces?: readonly DeclaredMarketplace[];
235
+ readonly uiClaude?: UiSettings;
236
+ readonly permissions?: PermissionSpec;
237
+ readonly host?: HostSpec;
145
238
  }
146
239
  declare function readSpec(config: ProjectConfig): ProjectSpec;
147
240
 
148
- /**
149
- * Every output the sources imply, read from disk but written nowhere. Sources:
150
- * .agents/skills, .agents/agents, .agents/rules, package rule files, and pmcp.toml.
151
- */
152
-
153
241
  declare function plan(spec: ProjectSpec, owned?: ReadonlyMap<string, string>): Output[];
154
242
 
155
- /**
156
- * Writes or checks a plan. The lock (pmcp.lock) records what this wrote, so a
157
- * source removed later takes its outputs with it, and a file someone else wrote
158
- * is never overwritten.
159
- */
160
-
161
- declare const LOCK_FILE = "pmcp.lock";
162
243
  interface ProjectResult {
163
244
  readonly backup?: string;
164
- /** 0 done or clean, 2 check found problems, 3 refused to overwrite. */
165
245
  readonly code: 0 | 2 | 3;
166
246
  readonly problems: readonly string[];
247
+ readonly warnings?: readonly string[];
167
248
  readonly outputs: number;
168
249
  readonly pruned: number;
169
250
  }
170
- /** paths: globs whose fixed prefix holds no tracked file: a rule that loads nowhere. */
251
+
171
252
  declare function deadGlobs(root: string, outputs: readonly Output[]): string[];
253
+
254
+ declare const LOCK_FILE = "pmcp.lock";
255
+
172
256
  declare function project(spec: ProjectSpec, options: {
173
257
  readonly check: boolean;
174
258
  }): ProjectResult;
175
259
 
176
- /**
177
- * Asks each tool what it loads, through its own listing commands only: no
178
- * model is called. A tool whose CLI is not installed is skipped, not failed.
179
- */
180
-
181
- interface RunResult {
182
- /** The executable was not found. */
183
- readonly missing: boolean;
184
- readonly status: number | null;
185
- readonly stdout: string;
186
- }
187
- type Runner = (command: string, args: readonly string[], cwd: string, env?: Readonly<Record<string, string | undefined>>) => RunResult;
188
- type Status = "ok" | "fail" | "skip";
189
- interface Finding$1 {
190
- readonly tool: Tool | "project";
191
- readonly check: string;
192
- readonly status: Status;
193
- readonly detail?: string;
194
- }
195
- interface DoctorOptions {
196
- readonly env?: Readonly<Record<string, string | undefined>>;
197
- readonly run: Runner;
198
- readonly home: string;
199
- readonly only?: ReadonlySet<Tool>;
200
- }
201
- declare function doctor(spec: ProjectSpec, options: DoctorOptions): Finding$1[];
202
-
203
- /**
204
- * Links each package's path-scoped rule file into .claude/rules/<dir>/. One level
205
- * down because Grok Build loads every top-level .claude/rules/*.md unscoped.
206
- * Names already in use are kept, so moving the links renames nothing.
207
- */
260
+ declare function doctor(spec: ProjectSpec, options: DoctorOptions): Finding[];
208
261
 
209
262
  declare class ProjectError extends Error {
210
263
  constructor(message: string);
211
264
  }
212
265
  declare function deriveName(dir: string, strip: readonly string[]): string;
213
266
 
214
- /**
215
- * One catalog skill as the Skills extension (SEP-2640) describes it: frontmatter
216
- * plus a complete manifest of its files with sha256 digests and sizes.
217
- */
218
-
219
267
  interface SkillResource {
220
268
  readonly uri: string;
221
269
  readonly digest: string;
@@ -226,106 +274,36 @@ interface SkillExtensionEntry {
226
274
  readonly frontmatter: Readonly<Record<string, unknown>>;
227
275
  readonly resources: readonly SkillResource[];
228
276
  }
229
- /**
230
- * The extension's entry, or null when the skill cannot be served under SEP-2640:
231
- * not a directory with SKILL.md, frontmatter that breaks the Agent Skills
232
- * specification, a name unlike its path, or over the per-skill limits. Such a
233
- * skill stays reachable through the skill_* tools.
234
- */
235
277
  declare function extensionEntry(entry: SkillEntry): SkillExtensionEntry | null;
236
278
 
237
- /**
238
- * The Skills extension's methods, skills/list and skills/get. Their files are
239
- * served by the skill:// resources (resources.ts), which every surface shares.
240
- */
241
-
242
279
  declare const SKILLS_EXTENSION = "io.modelcontextprotocol/skills";
243
280
  interface SkillsExtensionOptions {
244
- /**
245
- * "public" when every caller sees the same catalog; "private" when the list is
246
- * filtered per caller, as it is behind authorization.
247
- */
248
281
  readonly cacheScope?: "public" | "private";
249
282
  }
250
- /** Declares the extension and its methods. Must run before the server connects. */
251
283
  declare function registerSkillsExtension(server: McpServer, skills: () => readonly SkillEntry[], options?: SkillsExtensionOptions): void;
252
284
 
253
- /**
254
- * skill:// URIs for skill files. The authority names this server's namespace and
255
- * resolves to nothing; the path is the catalog name, then the file inside it.
256
- */
257
-
258
285
  declare const skillFileUri: (entry: Pick<SkillEntry, "name">, file?: string) => string;
259
- /**
260
- * The catalog entry and relative file a URI names, matched against the entries
261
- * the caller may see. Names contain slashes, so the longest matching name wins.
262
- */
263
286
  declare function resolveSkillFileUri(uri: string, entries: readonly SkillEntry[]): {
264
287
  entry: SkillEntry;
265
288
  file: string;
266
289
  } | null;
267
290
 
268
- /**
269
- * The catalog, spoken over MCP: the skill_* tools, skill:// resources, the
270
- * Skills extension and, when asked for, one prompt per skill.
271
- *
272
- * Thin on purpose: every decision is in createSkillTools and the modules under
273
- * tools/ and files/; this file only composes them on one server.
274
- */
275
-
276
- /** Reported to the host on connect. */
277
291
  declare const SERVER_NAME = "pmcp";
278
- declare const SERVER_VERSION = "0.17.4";
279
- /**
280
- * Registers the skill_* tools on a server.
281
- *
282
- * Exported separately from the stdio entry so a consumer already running an MCP
283
- * server can add these to it rather than starting a second process.
284
- */
292
+ declare const SERVER_VERSION = "0.18.0";
285
293
  declare function registerSkillTools(server: McpServer, tools: SkillTools): McpServer;
286
294
  interface SkillMcpOptions extends SkillServerOptions {
287
295
  readonly mailbox?: MailboxService;
288
- /** One prompt per skill, for hosts that offer prompts as commands. Off by default. */
289
296
  readonly prompts?: boolean;
290
297
  readonly skillsExtension?: SkillsExtensionOptions;
291
298
  }
292
- /**
293
- * A server with everything registered.
294
- *
295
- * The catalog is read on first use rather than here, so a host that connects
296
- * and never asks pays nothing for the walk.
297
- */
298
299
  declare function createSkillServer(options: SkillMcpOptions): McpServer;
299
300
 
300
- /** Checks skill directories against the Agent Skills specification. */
301
-
302
- interface Finding {
303
- readonly path: string;
304
- readonly reason: string;
305
- /** error: the skill is left out or breaks a MUST; warning: served anyway. */
306
- readonly level: "error" | "warning";
307
- }
308
- /** One skill directory, or the SKILL.md inside it. */
309
- declare function validateSkillDir(dir: string): Finding[];
310
- /** Every skill the catalog options reach, with what loading reported. */
311
- declare function validateCatalog(options: CatalogOptions): Finding[];
312
-
313
- /**
314
- * skill:// resources: every file of every skill the caller may see. The tools,
315
- * the Skills extension and resource links all resolve here, over the same
316
- * caller-filtered catalog, so nothing a caller cannot list can be read.
317
- */
301
+ declare function validateSkillDir(dir: string, settings?: ValidationSettings): Finding$1[];
302
+ declare function validateCatalog(options: CatalogOptions, settings?: ValidationSettings): Finding$1[];
318
303
 
319
304
  declare function registerSkillResources(server: McpServer, skills: () => readonly SkillEntry[]): void;
320
305
 
321
- /**
322
- * One prompt per skill, for hosts that offer prompts as commands: the Agent
323
- * Skills "user-explicit activation" path. Off unless the host asks for it,
324
- * because the list grows with the catalog.
325
- */
326
-
327
- /** Prompt names travel into host command names, so they stay to a plain set. */
328
306
  declare const promptName: (entry: Pick<SkillEntry, "name">) => string;
329
307
  declare function registerSkillPrompts(server: McpServer, tools: SkillTools): void;
330
308
 
331
- export { CatalogOptions, DEFAULT_INTENT_CACHE_LIMIT, Embedder, type Finding$1 as Finding, IntentCache, type IntentCacheOptions, LOCK_FILE, LoadEmbedderOptions, type McpServerSpec, MetadataValue, type Output, type PackageRulesSpec, type PreparedSearch, ProjectConfig, ProjectError, type ProjectResult, type ProjectSpec, Ranking, type Rejection, type Runner, SERVER_NAME, SERVER_VERSION, SKILLS_EXTENSION, type SearchOptions, SkillEntry, type SkillExtensionEntry, type SkillMcpOptions, type SkillResource, SkillServerOptions, SkillTools, TOOLS, type Tool, type Finding as ValidationFinding, assetRoot, createSkillServer, deadGlobs, deriveName, doctor, extensionEntry, openIntentCache, plan, prepareSearch, project, promptName, readFrontmatterText, readMarketplace, readMetadata, readSpec, registerSkillPrompts, registerSkillResources, registerSkillTools, registerSkillsExtension, resolveSkillFileUri, skillFileUri, skillFileUri as skillUri, validateCatalog, validateSkillDir };
309
+ export { CATALOG_PAGE_MAX, CATALOG_PAGE_SIZE, CatalogOptions, DEFAULT_INTENT_CACHE_LIMIT, DESCRIBE_FILE_LIMIT, Embedder, EntryVectorStore, type Finding, IntentCache, type IntentCacheOptions, LOCK_FILE, LoadEmbedderOptions, type McpServerSpec, MetadataValue, type Output, type PackageRulesSpec, type PreparedSearch, ProjectConfig, ProjectError, type ProjectResult, type ProjectSpec, Ranking, type Rejection, type Runner, SERVER_NAME, SERVER_VERSION, SKILLS_EXTENSION, type SearchOptions, SkillEntry, type SkillExtensionEntry, type SkillMcpOptions, type SkillResource, SkillServerOptions, SkillTools, TOOLS, type Tool, Finding$1 as ValidationFinding, assetRoot, createSkillServer, deadGlobs, deriveName, displayPath, doctor, encodeEntries, extensionEntry, openEntryVectors, openIntentCache, plan, prepareSearch, project, promptName, readBody, readFrontmatter, readFrontmatterText, readMarketplace, readMetadata, readSpec, registerSkillPrompts, registerSkillResources, registerSkillTools, registerSkillsExtension, resolveSkillFileUri, skillFileUri, skillFileUri as skillUri, validateCatalog, validateSkillDir, withoutBody };