@modootoday/pmcp 0.17.3 → 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 -16160
  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 -4911
  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 +6 -3
  160. package/dist/project/hook-adapter.js +66 -35
  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 +844 -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-PRSnYGLV.d.ts +0 -10
  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
@@ -0,0 +1,67 @@
1
+ import {
2
+ locateExecutable
3
+ } from "./chunk-R2GPCZUX.js";
4
+ import {
5
+ command
6
+ } from "./chunk-34DECPVC.js";
7
+ import {
8
+ ptyBinary
9
+ } from "./chunk-4VCC2NXE.js";
10
+ import {
11
+ nativeBinary
12
+ } from "./chunk-665TA55Z.js";
13
+
14
+ // src/tui/rust.ts
15
+ import { spawn } from "child_process";
16
+ function tuiBinary(env = process.env) {
17
+ return nativeBinary("pmcp-tui", "PMCP_TUI_BIN", env);
18
+ }
19
+ var TUI_MISSING = "tui_binary_missing: set PMCP_TUI_BIN to the pmcp-tui binary (cargo build --release in crates/pmcp-tui gives crates/pmcp-tui/target/release/pmcp-tui) or put pmcp-tui on PATH";
20
+ async function runTui(socket, main) {
21
+ const binary = tuiBinary();
22
+ if (!binary) throw new Error(TUI_MISSING);
23
+ const child = spawn(binary, ["--socket", socket, "--main", main], {
24
+ stdio: "inherit"
25
+ });
26
+ return new Promise((resolve, reject) => {
27
+ child.once("error", reject);
28
+ child.once("exit", (code) => resolve(code ?? 1));
29
+ });
30
+ }
31
+
32
+ // src/tui/startup/dependencies.ts
33
+ function dependencies() {
34
+ const node = locateExecutable("node");
35
+ const linux = process.platform === "linux";
36
+ const systemctl = linux ? locateExecutable("systemctl") : null;
37
+ const systemdRun = linux ? locateExecutable("systemd-run") : null;
38
+ let nodeSupported = false;
39
+ if (node) {
40
+ try {
41
+ nodeSupported = Number(
42
+ command(node, ["--version"]).trim().replace(/^v/, "").split(".")[0]
43
+ ) >= 22;
44
+ } catch {
45
+ }
46
+ }
47
+ const pty = ptyBinary(process.env);
48
+ const tui = tuiBinary();
49
+ const platformSupported = linux || process.platform === "darwin";
50
+ return {
51
+ platform: process.platform,
52
+ node,
53
+ nodeSupported,
54
+ pmcpPty: pty,
55
+ pmcpTui: tui,
56
+ systemctl,
57
+ systemdRun,
58
+ memoryCapped: linux,
59
+ supported: platformSupported && Boolean(pty && tui && nodeSupported) && (!linux || Boolean(systemctl && systemdRun))
60
+ };
61
+ }
62
+
63
+ export {
64
+ runTui,
65
+ dependencies
66
+ };
67
+ //# sourceMappingURL=chunk-LAZQBMAU.js.map
@@ -0,0 +1,67 @@
1
+ import {
2
+ nearestConfigOption
3
+ } from "./chunk-XNML2KIC.js";
4
+ import {
5
+ CATALOG_OPTIONS
6
+ } from "./chunk-JEL35P7S.js";
7
+ import {
8
+ TOOLS
9
+ } from "./chunk-V4NPDK6X.js";
10
+
11
+ // src/commands/specs/project.ts
12
+ var projectSpec = {
13
+ name: "project",
14
+ describe: "Write each agent tool's native files from .agents/ and pmcp.toml",
15
+ usage: "pmcp project [--check] | pmcp project add <skill|agent> | pmcp project remove <name> | pmcp project import-mcp --source <tool>:<file> [--name <alias>] [--write]",
16
+ options: [
17
+ ...CATALOG_OPTIONS,
18
+ {
19
+ name: "source",
20
+ describe: "Explicit native MCP source as <tool>:<file>. Repeatable; import-mcp only.",
21
+ repeat: true,
22
+ placeholder: "<tool>:<file>"
23
+ },
24
+ {
25
+ name: "name",
26
+ describe: "Import only this MCP alias. Repeatable; import-mcp only.",
27
+ repeat: true,
28
+ placeholder: "<alias>"
29
+ },
30
+ {
31
+ name: "write",
32
+ describe: "Back up and import the reviewed MCP declarations; import-mcp only.",
33
+ boolean: true
34
+ },
35
+ {
36
+ name: "check",
37
+ describe: "Write nothing; exit 2 when an output drifted, went stale or is undeclared.",
38
+ boolean: true
39
+ }
40
+ ]
41
+ };
42
+ var doctorSpec = {
43
+ name: "doctor",
44
+ describe: "Ask each agent tool, through its own listing commands, whether it loads this project's assets",
45
+ usage: "pmcp doctor [--tool <name>] [--json] [--memory]",
46
+ options: [
47
+ nearestConfigOption,
48
+ {
49
+ name: "tool",
50
+ describe: `Check only this tool (${TOOLS.join(", ")}). Repeatable.`,
51
+ repeat: true,
52
+ placeholder: "<name>"
53
+ },
54
+ { name: "json", describe: "Emit JSON rather than a table.", boolean: true },
55
+ {
56
+ name: "memory",
57
+ describe: "Report native memory configuration metadata only; do not read memory bodies or check MCP connections.",
58
+ boolean: true
59
+ }
60
+ ]
61
+ };
62
+
63
+ export {
64
+ projectSpec,
65
+ doctorSpec
66
+ };
67
+ //# sourceMappingURL=chunk-LLBPVZXM.js.map
@@ -0,0 +1,57 @@
1
+ import {
2
+ EMBEDDING_OPTIONS
3
+ } from "./chunk-INT7QLEU.js";
4
+ import {
5
+ CATALOG_OPTIONS
6
+ } from "./chunk-JEL35P7S.js";
7
+
8
+ // src/commands/specs/serve.ts
9
+ var serveSpec = {
10
+ name: "serve",
11
+ describe: "Run the MCP server on stdio (also the default for piped launches)",
12
+ usage: "pmcp serve [--root <dir>] [--scope <prefix>] [--marketplace <dir>] [--package <dir>] [--workspace <dir>] [--config <file> | --no-config] [--prompts]",
13
+ options: [
14
+ ...CATALOG_OPTIONS,
15
+ ...EMBEDDING_OPTIONS,
16
+ {
17
+ name: "lexical",
18
+ describe: "Skip semantic index and model loading",
19
+ boolean: true
20
+ },
21
+ {
22
+ name: "mailbox-actor-file",
23
+ describe: "Private launcher actor credential for opt-in mailbox",
24
+ placeholder: "<file>"
25
+ },
26
+ {
27
+ name: "mailbox-binding-file",
28
+ describe: "Private attachment file written by the launcher",
29
+ placeholder: "<file>"
30
+ },
31
+ {
32
+ name: "mailbox-runtime",
33
+ describe: "Launcher-assigned canonical runtime",
34
+ placeholder: "<runtime>"
35
+ },
36
+ {
37
+ name: "mailbox-replace-session",
38
+ describe: "Exact old attachment ID to replace",
39
+ placeholder: "<id>"
40
+ },
41
+ {
42
+ name: "mailbox-native-session",
43
+ describe: "Launcher-owned native session ID",
44
+ placeholder: "<id>"
45
+ },
46
+ {
47
+ name: "prompts",
48
+ describe: "Also offer one prompt per skill, for hosts that turn prompts into commands.",
49
+ boolean: true
50
+ }
51
+ ]
52
+ };
53
+
54
+ export {
55
+ serveSpec
56
+ };
57
+ //# sourceMappingURL=chunk-LLT5FQBE.js.map
@@ -0,0 +1,17 @@
1
+ // src/cli/entry.ts
2
+ function interactiveEntry(terminal) {
3
+ if (!terminal.stdin || !terminal.stdout) return false;
4
+ if (!terminal.term || terminal.term === "dumb") return false;
5
+ return !terminal.ci || terminal.ci === "false" || terminal.ci === "0";
6
+ }
7
+ function entryMode(terminal) {
8
+ if (!terminal.stdin || !terminal.stdout) return "server";
9
+ if (!interactiveEntry(terminal)) return "help";
10
+ return "terminal";
11
+ }
12
+
13
+ export {
14
+ interactiveEntry,
15
+ entryMode
16
+ };
17
+ //# sourceMappingURL=chunk-LMT3PPXJ.js.map
@@ -0,0 +1,87 @@
1
+ import {
2
+ createSkillServer
3
+ } from "./chunk-25GHX674.js";
4
+ import {
5
+ attachMailbox
6
+ } from "./chunk-HDMBVLCZ.js";
7
+
8
+ // src/stdio.ts
9
+ import { serveStdio } from "@modelcontextprotocol/server/stdio";
10
+ function resolveRoots(argv, cwd) {
11
+ const given = argv.filter((arg) => !arg.startsWith("-"));
12
+ return given.length > 0 ? given : [`${cwd}/node_modules`];
13
+ }
14
+ function serve(catalog, serving = {}) {
15
+ const options = {
16
+ ...catalog,
17
+ ...serving,
18
+ onReject: ({ path, reason }) => process.stderr.write(`pmcp: skipped ${path}: ${reason}
19
+ `),
20
+ onWarning: ({ path, reason }) => process.stderr.write(`pmcp: warning ${path}: ${reason}
21
+ `)
22
+ };
23
+ return serveStdio(() => createSkillServer(options), {
24
+ // Keep diagnostics on stderr because stdout carries the MCP protocol.
25
+ onerror: (error) => process.stderr.write(`pmcp: ${error.message}
26
+ `)
27
+ });
28
+ }
29
+ async function serveWithMailbox(catalog, mailbox, serving = {}) {
30
+ let stop;
31
+ const attachment = await attachMailbox({
32
+ ...mailbox,
33
+ onExpired: () => {
34
+ process.stderr.write("pmcp: mailbox attachment expired or superseded\n");
35
+ void stop?.().catch(() => {
36
+ process.exitCode = 1;
37
+ });
38
+ }
39
+ });
40
+ let handle;
41
+ try {
42
+ handle = serve(catalog, { ...serving, mailbox: attachment.service });
43
+ } catch (error) {
44
+ await attachment.close();
45
+ throw error;
46
+ }
47
+ let shutdown;
48
+ const onExit = () => {
49
+ void stop().catch(() => {
50
+ process.exitCode = 1;
51
+ });
52
+ };
53
+ stop = () => {
54
+ if (shutdown) return shutdown;
55
+ process.removeListener("SIGINT", onExit);
56
+ process.removeListener("SIGTERM", onExit);
57
+ process.stdin.removeListener("end", onExit);
58
+ shutdown = (async () => {
59
+ try {
60
+ await handle.close();
61
+ } finally {
62
+ await attachment.close();
63
+ }
64
+ })();
65
+ return shutdown;
66
+ };
67
+ process.once("SIGINT", onExit);
68
+ process.once("SIGTERM", onExit);
69
+ process.stdin.once("end", onExit);
70
+ return stop;
71
+ }
72
+ function main(argv = process.argv.slice(2)) {
73
+ const scopeArg = argv.find((arg) => arg.startsWith("--scope="));
74
+ const scopes = scopeArg ? scopeArg.slice("--scope=".length).split(",") : [];
75
+ serve({
76
+ roots: resolveRoots(argv, process.cwd()),
77
+ ...scopes.length > 0 ? { scopes } : {}
78
+ });
79
+ }
80
+
81
+ export {
82
+ resolveRoots,
83
+ serve,
84
+ serveWithMailbox,
85
+ main
86
+ };
87
+ //# sourceMappingURL=chunk-MM2Y43LC.js.map
@@ -0,0 +1,346 @@
1
+ import {
2
+ normaliseIntent
3
+ } from "./chunk-6WXMJOMI.js";
4
+ import {
5
+ openSqlite
6
+ } from "./chunk-6STKGOCW.js";
7
+ import {
8
+ resolveEncoder
9
+ } from "./chunk-PMJG2CXF.js";
10
+
11
+ // src/cache.ts
12
+ async function openDatabase(path) {
13
+ try {
14
+ return await openSqlite(path);
15
+ } catch {
16
+ return null;
17
+ }
18
+ }
19
+ var DEFAULT_INTENT_CACHE_LIMIT = 4096;
20
+ var SCHEMA = `
21
+ CREATE TABLE IF NOT EXISTS intent_vector (
22
+ intent TEXT NOT NULL PRIMARY KEY,
23
+ model_id TEXT NOT NULL,
24
+ dims INTEGER NOT NULL,
25
+ vector BLOB NOT NULL,
26
+ used_at INTEGER NOT NULL
27
+ );
28
+ CREATE INDEX IF NOT EXISTS intent_vector_used_at ON intent_vector (used_at);
29
+ `;
30
+ async function openIntentCache(options) {
31
+ const opened = await openDatabase(options.path);
32
+ if (!opened) return null;
33
+ const { db, provider } = opened;
34
+ try {
35
+ db.exec("PRAGMA journal_mode = WAL");
36
+ db.exec(SCHEMA);
37
+ } catch {
38
+ db.close();
39
+ return null;
40
+ }
41
+ const limit = options.limit ?? DEFAULT_INTENT_CACHE_LIMIT;
42
+ const now = options.now ?? (() => Date.now());
43
+ let hits = 0;
44
+ let misses = 0;
45
+ let mismatched = 0;
46
+ const selectRow = db.prepare("SELECT model_id, dims, vector FROM intent_vector WHERE intent = ?");
47
+ const touch = db.prepare(
48
+ "UPDATE intent_vector SET used_at = ? WHERE intent = ?"
49
+ );
50
+ const upsert = db.prepare(
51
+ `INSERT INTO intent_vector (intent, model_id, dims, vector, used_at)
52
+ VALUES (?, ?, ?, ?, ?)
53
+ ON CONFLICT(intent) DO UPDATE SET
54
+ model_id = excluded.model_id,
55
+ dims = excluded.dims,
56
+ vector = excluded.vector,
57
+ used_at = excluded.used_at`
58
+ );
59
+ const countRows = db.prepare(
60
+ "SELECT count(*) AS n FROM intent_vector"
61
+ );
62
+ const evict = db.prepare(
63
+ `DELETE FROM intent_vector WHERE intent IN (
64
+ SELECT intent FROM intent_vector ORDER BY used_at ASC LIMIT ?
65
+ )`
66
+ );
67
+ return {
68
+ get(intent) {
69
+ const key = normaliseIntent(intent);
70
+ const row = selectRow.get(key) ?? null;
71
+ if (!row) {
72
+ misses += 1;
73
+ return null;
74
+ }
75
+ if (row.model_id !== options.modelId || row.dims !== options.dims) {
76
+ mismatched += 1;
77
+ return null;
78
+ }
79
+ hits += 1;
80
+ touch.run(now(), key);
81
+ const bytes = row.vector;
82
+ return new Float32Array(
83
+ bytes.buffer.slice(
84
+ bytes.byteOffset,
85
+ bytes.byteOffset + bytes.byteLength
86
+ )
87
+ );
88
+ },
89
+ put(intent, vector) {
90
+ if (vector.length !== options.dims) {
91
+ throw new Error(
92
+ `intent vector is ${vector.length} wide, cache holds ${options.dims}`
93
+ );
94
+ }
95
+ const key = normaliseIntent(intent);
96
+ upsert.run(
97
+ key,
98
+ options.modelId,
99
+ options.dims,
100
+ new Uint8Array(vector.buffer, vector.byteOffset, vector.byteLength),
101
+ now()
102
+ );
103
+ const rows = countRows.get()?.n ?? 0;
104
+ if (rows > limit) evict.run(rows - limit);
105
+ },
106
+ stats() {
107
+ return {
108
+ hits,
109
+ misses,
110
+ mismatched,
111
+ rows: countRows.get()?.n ?? 0,
112
+ provider
113
+ };
114
+ },
115
+ close() {
116
+ db.close();
117
+ }
118
+ };
119
+ }
120
+
121
+ // src/embed/load.ts
122
+ import { resolve } from "path";
123
+
124
+ // src/embed/_shared.ts
125
+ var ENTRY_SCHEMA = `
126
+ CREATE TABLE IF NOT EXISTS entry_vector (
127
+ name TEXT NOT NULL,
128
+ model_id TEXT NOT NULL,
129
+ dims INTEGER NOT NULL,
130
+ description_hash TEXT NOT NULL,
131
+ vector BLOB NOT NULL,
132
+ PRIMARY KEY (name, model_id)
133
+ );
134
+ `;
135
+ var TRANSFORMERS = "@huggingface/transformers";
136
+
137
+ // src/embed/projected.ts
138
+ function pretrainedFactory(value) {
139
+ if (!value || !["object", "function"].includes(typeof value)) return null;
140
+ const candidate = value;
141
+ return typeof candidate.from_pretrained === "function" ? candidate : null;
142
+ }
143
+ async function loadProjectedEncoder(module, selected, source, options) {
144
+ const tokenizers = pretrainedFactory(module.AutoTokenizer);
145
+ const models = pretrainedFactory(module.AutoModel);
146
+ if (!tokenizers || !models) return null;
147
+ const settings = {
148
+ dtype: selected.dtype,
149
+ revision: selected.revision,
150
+ local_files_only: options.localOnly ?? false
151
+ };
152
+ if (options.cacheDir !== void 0) settings.cache_dir = options.cacheDir;
153
+ const modelSettings = { ...settings };
154
+ if (selected.modelId === "onnx-community/embeddinggemma-2-ONNX") {
155
+ const configurations = pretrainedFactory(module.AutoConfig);
156
+ if (!configurations) return null;
157
+ const config = await configurations.from_pretrained(
158
+ source,
159
+ settings
160
+ );
161
+ config.vision_config = null;
162
+ config.audio_config = null;
163
+ modelSettings.config = config;
164
+ }
165
+ const tokenizer = await tokenizers.from_pretrained(source, settings);
166
+ const model = await models.from_pretrained(source, modelSettings);
167
+ return async (text) => {
168
+ const output = await model(
169
+ tokenizer(text, { padding: true, truncation: true })
170
+ );
171
+ const vector = output.sentence_embedding;
172
+ const gemma = selected.modelId.startsWith("onnx-community/embeddinggemma-");
173
+ if (!vector || vector.data.length === 0 || gemma && vector.data.length !== 768)
174
+ throw new Error(
175
+ "EmbeddingGemma requires its projected 768-dimensional sentence_embedding"
176
+ );
177
+ if (!Array.from(vector.data).every(Number.isFinite))
178
+ throw new Error("EmbeddingGemma returned a non-finite embedding");
179
+ return vector;
180
+ };
181
+ }
182
+
183
+ // src/embed/load.ts
184
+ async function loadEmbedder(modelId, options = {}) {
185
+ const selected = resolveEncoder(modelId, options);
186
+ let module;
187
+ try {
188
+ module = options.module ?? await import(TRANSFORMERS);
189
+ } catch {
190
+ return null;
191
+ }
192
+ let source = options.modelPath ?? selected.modelId;
193
+ if (options.localOnly && !options.modelPath) {
194
+ const cache = options.cacheDir ?? module.env?.cacheDir;
195
+ if (typeof cache !== "string")
196
+ throw new Error("Provide modelPath or cacheDir for an offline encoder");
197
+ source = resolve(
198
+ cache,
199
+ selected.modelId,
200
+ selected.revision === "main" ? "." : selected.revision
201
+ );
202
+ }
203
+ const spec = selected.encoder;
204
+ let encode;
205
+ if (spec.projected) {
206
+ const projected = await loadProjectedEncoder(
207
+ module,
208
+ selected,
209
+ source,
210
+ options
211
+ );
212
+ if (!projected) return null;
213
+ encode = projected;
214
+ } else {
215
+ const factory = module.pipeline;
216
+ if (typeof factory !== "function") return null;
217
+ encode = await factory("feature-extraction", source, {
218
+ dtype: selected.dtype,
219
+ revision: selected.revision,
220
+ cache_dir: options.cacheDir,
221
+ local_files_only: options.localOnly ?? false
222
+ });
223
+ }
224
+ let dims = 0;
225
+ const run = async (text) => {
226
+ const output = await encode(text, {
227
+ pooling: spec.pooling,
228
+ normalize: true
229
+ });
230
+ let vector = Float32Array.from(output.data);
231
+ if (vector.length === 0 || !vector.every(Number.isFinite))
232
+ throw new Error("Encoder returned an invalid embedding");
233
+ if (selected.dimensions !== void 0) {
234
+ if (selected.dimensions > vector.length)
235
+ throw new Error(
236
+ "Encoder output is smaller than the requested dimensions"
237
+ );
238
+ vector = vector.slice(0, selected.dimensions);
239
+ const norm = Math.hypot(...vector);
240
+ if (norm === 0 || !Number.isFinite(norm))
241
+ throw new Error("Encoder returned a zero embedding");
242
+ vector = vector.map((value) => value / norm);
243
+ }
244
+ dims = vector.length;
245
+ return vector;
246
+ };
247
+ return {
248
+ modelId: selected.modelId,
249
+ indexKey: selected.indexKey,
250
+ get dims() {
251
+ return dims;
252
+ },
253
+ embed: (text) => run(spec.queryPrefix + text),
254
+ embedPassage: (text) => run(spec.passagePrefix + text)
255
+ };
256
+ }
257
+
258
+ // src/embed/entries.ts
259
+ async function encodeEntries(embedder, entries, previous = /* @__PURE__ */ new Map()) {
260
+ const out = /* @__PURE__ */ new Map();
261
+ const passage = (text) => embedder.embedPassage ? embedder.embedPassage(text) : embedder.embed(text);
262
+ for (const entry of entries) {
263
+ const hash = describeHash(entry.description);
264
+ const kept = previous.get(entry.name);
265
+ if (kept && kept.hash === hash) {
266
+ out.set(entry.name, kept);
267
+ continue;
268
+ }
269
+ out.set(entry.name, { hash, vector: await passage(entry.description) });
270
+ }
271
+ return out;
272
+ }
273
+ function describeHash(description) {
274
+ let hash = 2166136261;
275
+ for (let i = 0; i < description.length; i++) {
276
+ hash ^= description.charCodeAt(i);
277
+ hash = Math.imul(hash, 16777619) >>> 0;
278
+ }
279
+ return hash.toString(16).padStart(8, "0");
280
+ }
281
+
282
+ // src/embed/vectors.ts
283
+ async function openEntryVectors(path, options = {}) {
284
+ const opened = options.readOnly ? await openSqlite(path, options).catch(() => null) : await openDatabase(path);
285
+ if (opened === null) return null;
286
+ const db = opened.db;
287
+ if (!options.readOnly) db.exec(ENTRY_SCHEMA);
288
+ return {
289
+ read(modelId) {
290
+ const out = /* @__PURE__ */ new Map();
291
+ const rows = db.prepare(
292
+ "SELECT name, dims, vector FROM entry_vector WHERE model_id = ?"
293
+ ).all(modelId);
294
+ for (const row of rows) {
295
+ const bytes = row.vector;
296
+ const vector = new Float32Array(
297
+ bytes.buffer.slice(
298
+ bytes.byteOffset,
299
+ bytes.byteOffset + bytes.byteLength
300
+ )
301
+ );
302
+ if (vector.length === row.dims) out.set(row.name, vector);
303
+ }
304
+ return out;
305
+ },
306
+ stale(modelId, entries) {
307
+ const rows = db.prepare(
308
+ "SELECT name, description_hash FROM entry_vector WHERE model_id = ?"
309
+ ).all(modelId);
310
+ const stored = new Map(
311
+ rows.map((row) => [row.name, row.description_hash])
312
+ );
313
+ const out = [];
314
+ for (const [name, description] of entries) {
315
+ if (stored.get(name) !== describeHash(description)) out.push(name);
316
+ }
317
+ return out;
318
+ },
319
+ write(modelId, name, description, vector) {
320
+ db.prepare(`INSERT INTO entry_vector (name, model_id, dims, description_hash, vector)
321
+ VALUES (?, ?, ?, ?, ?)
322
+ ON CONFLICT(name, model_id) DO UPDATE SET
323
+ dims = excluded.dims,
324
+ description_hash = excluded.description_hash,
325
+ vector = excluded.vector`).run(
326
+ name,
327
+ modelId,
328
+ vector.length,
329
+ describeHash(description),
330
+ new Uint8Array(vector.buffer, vector.byteOffset, vector.byteLength)
331
+ );
332
+ },
333
+ close() {
334
+ db.close();
335
+ }
336
+ };
337
+ }
338
+
339
+ export {
340
+ DEFAULT_INTENT_CACHE_LIMIT,
341
+ openIntentCache,
342
+ loadEmbedder,
343
+ encodeEntries,
344
+ openEntryVectors
345
+ };
346
+ //# sourceMappingURL=chunk-MPSQXSC6.js.map