@modootoday/pmcp 0.17.4 → 0.18.2

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 (272) hide show
  1. package/.agents/plugins/marketplace.json +1 -1
  2. package/.claude-plugin/marketplace.json +1 -1
  3. package/.claude-plugin/plugin.json +2 -2
  4. package/.mcp.json +1 -1
  5. package/CHANGELOG.md +152 -0
  6. package/CONTRIBUTING.md +71 -0
  7. package/README.md +98 -201
  8. package/SECURITY.md +17 -1
  9. package/dist/apply-JUTGS5WZ.js +242 -0
  10. package/dist/{attachment-tU5FZrgZ.d.ts → attachment-D84OGI6n.d.ts} +1 -1
  11. package/dist/available-DBSIVVJ6.js +73 -0
  12. package/dist/broadcast-CBMVOV3G.js +18 -0
  13. package/dist/chunk-26WLNWDG.js +93 -0
  14. package/dist/chunk-2FIV63WC.js +252 -0
  15. package/dist/chunk-2P4Z2NUX.js +28 -0
  16. package/dist/chunk-34DECPVC.js +22 -0
  17. package/dist/chunk-3FCFAQDG.js +42 -0
  18. package/dist/chunk-3IDXEV5E.js +1934 -0
  19. package/dist/chunk-3PW4FI7U.js +32 -0
  20. package/dist/chunk-3Y3HDMHA.js +108 -0
  21. package/dist/chunk-47O3X4VS.js +113 -0
  22. package/dist/chunk-4NDEP7HU.js +26 -0
  23. package/dist/chunk-5OMOPUE6.js +39 -0
  24. package/dist/chunk-5QQWS4US.js +53 -0
  25. package/dist/chunk-5ZABTVSW.js +48 -0
  26. package/dist/chunk-65KAQSJP.js +7 -0
  27. package/dist/chunk-6STKGOCW.js +27 -0
  28. package/dist/chunk-6WXMJOMI.js +9 -0
  29. package/dist/chunk-73AKO4UL.js +24 -0
  30. package/dist/chunk-7DLZC73N.js +29 -0
  31. package/dist/chunk-7GBYECSK.js +72 -0
  32. package/dist/chunk-7HFIGCSL.js +419 -0
  33. package/dist/chunk-7TD53M7L.js +13 -0
  34. package/dist/chunk-7UCZAN4J.js +778 -0
  35. package/dist/chunk-A4PKLESO.js +112 -0
  36. package/dist/chunk-A7VF7A35.js +1025 -0
  37. package/dist/chunk-ABTJQ4QV.js +74 -0
  38. package/dist/chunk-AJ4VXM2U.js +349 -0
  39. package/dist/chunk-BBTBJCFA.js +380 -0
  40. package/dist/chunk-BU65MNVU.js +13 -0
  41. package/dist/chunk-C4NHQGHL.js +142 -0
  42. package/dist/chunk-CJTKR6K6.js +1213 -0
  43. package/dist/chunk-D77IRGHO.js +1246 -0
  44. package/dist/chunk-DCU2EXQV.js +78 -0
  45. package/dist/chunk-DMZHQZ7P.js +104 -0
  46. package/dist/chunk-DZ2MRTYT.js +135 -0
  47. package/dist/chunk-E2YOZ2FF.js +207 -0
  48. package/dist/chunk-E3DQB5LS.js +48 -0
  49. package/dist/chunk-EATCUWGG.js +66 -0
  50. package/dist/chunk-EAWPJHJ7.js +155 -0
  51. package/dist/chunk-EIDIVIAD.js +33 -0
  52. package/dist/chunk-F5QYZK7E.js +396 -0
  53. package/dist/chunk-F5XMGOOX.js +28 -0
  54. package/dist/chunk-FENOGX3U.js +31 -0
  55. package/dist/chunk-GZHHEHKY.js +44 -0
  56. package/dist/chunk-HDMBVLCZ.js +53 -0
  57. package/dist/chunk-HQOB7OQS.js +81 -0
  58. package/dist/chunk-I2ZP2PSA.js +211 -0
  59. package/dist/chunk-IG33DXLT.js +151 -0
  60. package/dist/chunk-IJBSOWHK.js +86 -0
  61. package/dist/chunk-INT7QLEU.js +114 -0
  62. package/dist/chunk-J7UYNJCR.js +9 -0
  63. package/dist/chunk-JEL35P7S.js +53 -0
  64. package/dist/chunk-JGJ4INEN.js +32 -0
  65. package/dist/chunk-JS5RTH4I.js +84 -0
  66. package/dist/chunk-JWRZDYB5.js +59 -0
  67. package/dist/chunk-KMXRRSKT.js +660 -0
  68. package/dist/chunk-LBXO4VPG.js +73 -0
  69. package/dist/chunk-LLBPVZXM.js +67 -0
  70. package/dist/chunk-LLT5FQBE.js +57 -0
  71. package/dist/chunk-LMT3PPXJ.js +17 -0
  72. package/dist/chunk-LMUBBIE2.js +83 -0
  73. package/dist/chunk-LTZH5E3G.js +479 -0
  74. package/dist/chunk-LW4TG7EL.js +39 -0
  75. package/dist/chunk-MPSQXSC6.js +346 -0
  76. package/dist/chunk-MVFH26QT.js +97 -0
  77. package/dist/chunk-NLEXKE7U.js +67 -0
  78. package/dist/chunk-NQPURJT5.js +44 -0
  79. package/dist/chunk-NRBQK6UX.js +105 -0
  80. package/dist/chunk-OEH47H6A.js +48 -0
  81. package/dist/chunk-OG7QR2DP.js +75 -0
  82. package/dist/chunk-OPYFEHKG.js +52 -0
  83. package/dist/chunk-P4N7DBD5.js +83 -0
  84. package/dist/chunk-PAX3QXX2.js +140 -0
  85. package/dist/chunk-PKODFR5F.js +102 -0
  86. package/dist/chunk-PMJG2CXF.js +122 -0
  87. package/dist/chunk-Q5H3L6Y4.js +23 -0
  88. package/dist/chunk-QEF7EK3T.js +28 -0
  89. package/dist/chunk-QEW4J3IZ.js +74 -0
  90. package/dist/chunk-QPL7E2HW.js +464 -0
  91. package/dist/chunk-R2GPCZUX.js +22 -0
  92. package/dist/chunk-R5MT42JS.js +284 -0
  93. package/dist/chunk-RMATE45Z.js +197 -0
  94. package/dist/chunk-RPQOBHVU.js +87 -0
  95. package/dist/chunk-S3PIAMXV.js +230 -0
  96. package/dist/chunk-T3LKX23M.js +168 -0
  97. package/dist/chunk-T6GOWHK6.js +30 -0
  98. package/dist/chunk-TIA4SPU2.js +10 -0
  99. package/dist/chunk-TNCZ6444.js +57 -0
  100. package/dist/chunk-TVL5RTE6.js +269 -0
  101. package/dist/chunk-TXQ7L33K.js +45 -0
  102. package/dist/chunk-UPQTAHUK.js +189 -0
  103. package/dist/chunk-V4NPDK6X.js +14 -0
  104. package/dist/chunk-VJFEN6DJ.js +38 -0
  105. package/dist/chunk-VMHUEOT5.js +643 -0
  106. package/dist/chunk-VRPMYPZU.js +4985 -0
  107. package/dist/chunk-WIW772I3.js +25 -0
  108. package/dist/chunk-XELAZAIM.js +136 -0
  109. package/dist/chunk-XNML2KIC.js +23 -0
  110. package/dist/chunk-XP2U3LO3.js +30 -0
  111. package/dist/chunk-YGOWIJPE.js +51 -0
  112. package/dist/chunk-YIXDHQYE.js +11 -0
  113. package/dist/chunk-YSAWTGNA.js +117 -0
  114. package/dist/claude-U2JC2DNQ.js +77 -0
  115. package/dist/cli-MI4ZCAZ3.js +41 -0
  116. package/dist/cli-ZN7ZVDEZ.js +46 -0
  117. package/dist/cli.js +144 -16197
  118. package/dist/completion-ILSRB3LW.js +142 -0
  119. package/dist/config-DnpLL2kT.d.ts +46 -0
  120. package/dist/{service-qpCsOXkQ.d.ts → core-C1LPjxK6.d.ts} +2 -6
  121. package/dist/diagnostics-XKXVVQWH.js +93 -0
  122. package/dist/doctor-O2E63YGO.js +538 -0
  123. package/dist/entry-X6CSYQRQ.js +305 -0
  124. package/dist/exec-mcp-2PMWBPD7.js +365 -0
  125. package/dist/harness-L2KSI2ZB.js +177 -0
  126. package/dist/harness-egress-bridge.js +4 -4
  127. package/dist/harness-launch-gate.js +47 -940
  128. package/dist/harness-pane-runner.js +13 -80
  129. package/dist/harness-worker.js +21 -2703
  130. package/dist/hook-body.js +5222 -0
  131. package/dist/hook-spec-C5fWTSCH.d.ts +100 -0
  132. package/dist/hook.js +26 -0
  133. package/dist/hooks-BHTA44X7.js +21 -0
  134. package/dist/host-UIZAXXQH.js +22 -0
  135. package/dist/host-UWK754BW.js +210 -0
  136. package/dist/host-run-BI2OTZDZ.js +307 -0
  137. package/dist/http.d.ts +5 -42
  138. package/dist/http.js +21 -2234
  139. package/dist/import-mcp-GPKJI7DI.js +400 -0
  140. package/dist/index.d.ts +146 -168
  141. package/dist/index.js +133 -4948
  142. package/dist/init-3C2Y7BNJ.js +14 -0
  143. package/dist/install-GG7HHZK2.js +796 -0
  144. package/dist/invoke-44CJRVMK.js +23 -0
  145. package/dist/list-MCP2FXUF.js +68 -0
  146. package/dist/list-WL6L4J5H.js +65 -0
  147. package/dist/load-BEUBABtB.d.ts +21 -0
  148. package/dist/logout-F5EJ5MOU.js +44 -0
  149. package/dist/logs-TBUA4UWU.js +107 -0
  150. package/dist/mailbox/index.d.ts +10 -5
  151. package/dist/mailbox/index.js +53 -1572
  152. package/dist/mailbox-BMTZOSZ7.js +285 -0
  153. package/dist/mailbox-GDJ7BWQN.js +189 -0
  154. package/dist/mainline-KAD2ERLP.js +639 -0
  155. package/dist/marketplace-G4VQET5W.js +191 -0
  156. package/dist/mcp-235QZN2A.js +15 -0
  157. package/dist/mcp-FJ2UQ4RH.js +193 -0
  158. package/dist/models-ISU4DCMA.js +32 -0
  159. package/dist/opencode-CN7JLQYO.js +60 -0
  160. package/dist/pause-7LILUVGL.js +18 -0
  161. package/dist/preview-DT7DWG5F.js +91 -0
  162. package/dist/project/hook-adapter.d.ts +5 -2
  163. package/dist/project/hook-adapter.js +41 -27
  164. package/dist/project-5YV5CUEG.js +70 -0
  165. package/dist/pty-XTJ4MIWK.js +94 -0
  166. package/dist/recovery-U6QB3PMT.js +100 -0
  167. package/dist/reindex-Y27QJFDB.js +22 -0
  168. package/dist/resume-26VFAAMH.js +18 -0
  169. package/dist/run-3AXTZSR7.js +126 -0
  170. package/dist/run-3SOVRQIA.js +19 -0
  171. package/dist/serve-DQMKTFIV.js +104 -0
  172. package/dist/session-XM2CR425.js +159 -0
  173. package/dist/setup-DTKZLZUT.js +18 -0
  174. package/dist/start-login-YTZV6KMF.js +416 -0
  175. package/dist/status-A2OUTNGK.js +9 -0
  176. package/dist/status-H2VAHIDV.js +10 -0
  177. package/dist/status-MROQ7WR7.js +43 -0
  178. package/dist/status-RO55QPKV.js +55 -0
  179. package/dist/status-UME2L33L.js +286 -0
  180. package/dist/stdio.d.ts +3 -13
  181. package/dist/stdio.js +16 -3186
  182. package/dist/sweep-35LGQTTO.js +18 -0
  183. package/dist/test-AGZOJLRZ.js +561 -0
  184. package/dist/tools-gpHNq9Dh.d.ts +328 -0
  185. package/dist/tui-G5LLWCSV.js +153 -0
  186. package/dist/unbroadcast-5QNGAJR2.js +18 -0
  187. package/dist/validate-IU52H2IC.js +46 -0
  188. package/dist/worker-QZ5T6LJD.js +80 -0
  189. package/dist/worktree-create-PZSRB7PH.js +89 -0
  190. package/dist/worktree-list-JYB6VXLW.js +51 -0
  191. package/dist/worktree-sync-UF5CXPWV.js +30 -0
  192. package/docs/authoring.md +82 -0
  193. package/docs/browser-and-desktop.md +46 -0
  194. package/docs/commands.md +325 -0
  195. package/docs/compare.md +35 -0
  196. package/docs/compatibility.md +55 -0
  197. package/docs/embeddings.md +1 -1
  198. package/docs/getting-started.md +105 -0
  199. package/docs/git-workflow.md +60 -0
  200. package/docs/glossary.md +31 -0
  201. package/docs/hooks/capabilities/antigravity.json +199 -0
  202. package/docs/hooks/capabilities/claude.json +179 -0
  203. package/docs/hooks/capabilities/codex.json +179 -0
  204. package/docs/hooks/capabilities/gemini.json +196 -0
  205. package/docs/hooks/capabilities/grok.json +192 -0
  206. package/docs/hooks/capabilities/opencode.json +184 -0
  207. package/docs/hooks.md +264 -0
  208. package/docs/install.md +72 -0
  209. package/docs/library-skills.md +132 -0
  210. package/docs/mailbox.md +16 -5
  211. package/docs/project-configuration.md +540 -58
  212. package/docs/sessions.md +64 -0
  213. package/docs/skills.md +4 -45
  214. package/docs/terminal-harness.md +92 -44
  215. package/docs/terminal-workspace.md +81 -169
  216. package/gemini-extension.json +2 -2
  217. package/mcp.json +1 -1
  218. package/package.json +16 -2
  219. package/plugin.json +2 -2
  220. package/plugins/pmcp/.claude-plugin/plugin.json +4 -2
  221. package/plugins/pmcp/.mcp.json +1 -1
  222. package/plugins/pmcp/gemini-extension.json +2 -2
  223. package/plugins/pmcp/mcp.json +1 -1
  224. package/plugins/pmcp/mod/commands.ts +72 -0
  225. package/plugins/pmcp/mod/contract.d.ts +39 -0
  226. package/plugins/pmcp/mod/draw.tsx +216 -0
  227. package/plugins/pmcp/mod/guard.ts +42 -0
  228. package/plugins/pmcp/mod/hooks.json +4 -0
  229. package/plugins/pmcp/mod/host.ts +46 -0
  230. package/plugins/pmcp/mod/model.ts +144 -0
  231. package/plugins/pmcp/mod/reader/index.ts +18 -0
  232. package/plugins/pmcp/mod/reader/read.ts +76 -0
  233. package/plugins/pmcp/mod/reader/settings.ts +54 -0
  234. package/plugins/pmcp/mod/reader/types.ts +38 -0
  235. package/plugins/pmcp/mod/register.tsx +73 -0
  236. package/plugins/pmcp/mod/sessions/format.ts +91 -0
  237. package/plugins/pmcp/mod/sessions/types.ts +162 -0
  238. package/plugins/pmcp/mod/snapshot.ts +75 -0
  239. package/plugins/pmcp/mod/spinner.tsx +30 -0
  240. package/plugins/pmcp/mod/state.ts +28 -0
  241. package/plugins/pmcp/plugin.json +2 -2
  242. package/plugins/pmcp/skills/agent-assets-migrate/SKILL.md +96 -0
  243. package/plugins/pmcp/skills/headless-agents-ci-scaffold/SKILL.md +101 -0
  244. package/plugins/pmcp/skills/marketplace-plugin-scaffold/SKILL.md +87 -0
  245. package/plugins/pmcp/skills/package-skill-catalog/SKILL.md +51 -15
  246. package/plugins/pmcp/skills/pmcp-browser/SKILL.md +27 -0
  247. package/plugins/pmcp/skills/pmcp-desktop/SKILL.md +25 -0
  248. package/plugins/pmcp/skills/pmcp-project-init/SKILL.md +153 -0
  249. package/plugins/pmcp/skills/pmcp-sessions-and-git/SKILL.md +96 -0
  250. package/plugins/pmcp/skills/skill-package-scaffold/SKILL.md +89 -0
  251. package/schema/catalog-v1.json +187 -0
  252. package/schema/library.json +196 -0
  253. package/schema/marketplace-manifest.json +144 -0
  254. package/schema/plugin-manifest.json +59 -0
  255. package/schema/skill-frontmatter.json +170 -0
  256. package/schema/skill-metadata-core.json +131 -0
  257. package/skills/agent-assets-migrate/SKILL.md +96 -0
  258. package/skills/headless-agents-ci-scaffold/SKILL.md +101 -0
  259. package/skills/marketplace-plugin-scaffold/SKILL.md +87 -0
  260. package/skills/package-skill-catalog/SKILL.md +51 -15
  261. package/skills/pmcp-browser/SKILL.md +27 -0
  262. package/skills/pmcp-desktop/SKILL.md +25 -0
  263. package/skills/pmcp-project-init/SKILL.md +153 -0
  264. package/skills/pmcp-sessions-and-git/SKILL.md +96 -0
  265. package/skills/skill-package-scaffold/SKILL.md +89 -0
  266. package/dist/config-BkSpjUG6.d.ts +0 -50
  267. package/dist/embed-DRROSD3F.d.ts +0 -53
  268. package/dist/hook-spec-CSJJySsH.d.ts +0 -11
  269. package/dist/server-VWSY3Shw.d.ts +0 -543
  270. package/dist/tui-worker.js +0 -6549
  271. package/docs/manual-library-skills.md +0 -74
  272. /package/dist/{tui-worker.d.ts → hook.d.ts} +0 -0
@@ -0,0 +1,479 @@
1
+ import {
2
+ STALE_MS,
3
+ STATE_FILES,
4
+ alive,
5
+ asBroadcast,
6
+ asLease,
7
+ asPause,
8
+ asRecord,
9
+ isLive,
10
+ leaseFile
11
+ } from "./chunk-C4NHQGHL.js";
12
+ import {
13
+ checkoutOf
14
+ } from "./chunk-IJBSOWHK.js";
15
+
16
+ // src/sessions/mailbox/select.ts
17
+ import { basename, resolve } from "path";
18
+ var KINDS = ["session", "alias", "role", "worktree", "desk"];
19
+ var isWorktree = (kind) => kind === "worktree" || kind === "desk";
20
+ function checkSelector(selector) {
21
+ if (selector === "all") return selector;
22
+ const [kind, value] = splitSelector(selector);
23
+ if (!KINDS.includes(kind) || !value)
24
+ throw new Error(
25
+ `--to ${selector}: use all, session:<id>, alias:<name>, role:<name> or worktree:<path>`
26
+ );
27
+ return selector;
28
+ }
29
+ function splitSelector(selector) {
30
+ const at = selector.indexOf(":");
31
+ if (at < 0) return [selector, ""];
32
+ return [selector.slice(0, at), selector.slice(at + 1)];
33
+ }
34
+ function normalizeSelector(selector, cwd) {
35
+ const [kind, value] = splitSelector(checkSelector(selector));
36
+ return isWorktree(kind) ? `${kind}:${resolve(cwd, value)}` : selector;
37
+ }
38
+ function matches(selector, recipient) {
39
+ if (selector === "all") return true;
40
+ const [kind, value] = splitSelector(selector);
41
+ if (kind === "session")
42
+ return !!recipient.session && recipient.session.startsWith(value);
43
+ if (kind === "alias") return recipient.alias === value;
44
+ if (kind === "role") return (recipient.roles ?? []).includes(value);
45
+ if (!isWorktree(kind) || !recipient.desk) return false;
46
+ return recipient.desk === value || basename(recipient.desk) === value;
47
+ }
48
+ function before(message, recipient) {
49
+ if (!recipient.since) return false;
50
+ return Date.parse(message.createdAt) < Date.parse(recipient.since);
51
+ }
52
+ function addressedTo(message, recipient) {
53
+ return message.to.some(
54
+ (selector) => matches(selector, recipient) && !(selector === "all" && before(message, recipient))
55
+ );
56
+ }
57
+ function sentBy(message, recipient) {
58
+ const { session, alias } = message.from;
59
+ if (session && session === recipient.session) return true;
60
+ return !!alias && alias === recipient.alias;
61
+ }
62
+ function inboxKey(recipient) {
63
+ if (recipient.session) return recipient.session.replace(/[^\w-]/gu, "_");
64
+ return `@${(recipient.alias ?? "operator").replace(/[^\w.-]/gu, "_")}`;
65
+ }
66
+
67
+ // src/sessions/files/broadcast.ts
68
+ import { rmSync } from "fs";
69
+ import { join } from "path";
70
+
71
+ // src/sessions/files/json.ts
72
+ import { mkdirSync, readFileSync, renameSync, writeFileSync } from "fs";
73
+ import { dirname } from "path";
74
+ function readJson(path) {
75
+ try {
76
+ return JSON.parse(readFileSync(path, "utf8"));
77
+ } catch {
78
+ return null;
79
+ }
80
+ }
81
+ function writeJson(path, value) {
82
+ mkdirSync(dirname(path), { recursive: true, mode: 448 });
83
+ const temporary = `${path}.${process.pid}.tmp`;
84
+ writeFileSync(temporary, `${JSON.stringify(value, null, 2)}
85
+ `, {
86
+ mode: 384
87
+ });
88
+ renameSync(temporary, path);
89
+ }
90
+ function readLines(path) {
91
+ let text2 = "";
92
+ try {
93
+ text2 = readFileSync(path, "utf8");
94
+ } catch {
95
+ return [];
96
+ }
97
+ return text2.split("\n").filter(Boolean).flatMap((line) => {
98
+ try {
99
+ return [JSON.parse(line)];
100
+ } catch {
101
+ return [];
102
+ }
103
+ });
104
+ }
105
+ function writeLines(path, values) {
106
+ mkdirSync(dirname(path), { recursive: true, mode: 448 });
107
+ writeFileSync(
108
+ path,
109
+ `${values.map((value) => JSON.stringify(value)).join("\n")}
110
+ `,
111
+ { mode: 384 }
112
+ );
113
+ }
114
+
115
+ // src/sessions/files/broadcast.ts
116
+ function filesBroadcast(dir, keep, registry) {
117
+ const latestPath = join(dir, STATE_FILES.broadcast);
118
+ const historyPath = join(dir, STATE_FILES.history);
119
+ const list = () => {
120
+ const latest = asBroadcast(readJson(latestPath));
121
+ if (!latest) return [];
122
+ const earlier = readLines(historyPath).map(asBroadcast).filter(
123
+ (entry) => entry !== null && Number(entry.id) < Number(latest.id)
124
+ );
125
+ return [...earlier, latest];
126
+ };
127
+ return {
128
+ list,
129
+ unseen(session) {
130
+ const record = registry.get(session);
131
+ const own = new Set([session, record?.alias].filter(Boolean));
132
+ const seen = Number(record?.seenBroadcast ?? 0);
133
+ const started = Date.parse(record?.startedAt ?? "") || 0;
134
+ const all = list();
135
+ const latest = all.at(-1);
136
+ const unseen = all.filter(
137
+ (entry) => !own.has(entry.by) && Number(entry.id) > seen && (seen > 0 || entry === latest || Number(entry.id) >= started)
138
+ );
139
+ if (latest && Number(latest.id) > seen)
140
+ registry.upsert(session, { seenBroadcast: latest.id });
141
+ return unseen;
142
+ },
143
+ post({ by, text: text2 }) {
144
+ const entry = {
145
+ id: `${Date.now()}`,
146
+ by,
147
+ text: text2,
148
+ since: (/* @__PURE__ */ new Date()).toISOString()
149
+ };
150
+ writeLines(historyPath, [...list(), entry].slice(-keep));
151
+ writeJson(latestPath, entry);
152
+ return entry;
153
+ },
154
+ clear() {
155
+ rmSync(latestPath, { force: true });
156
+ rmSync(historyPath, { force: true });
157
+ }
158
+ };
159
+ }
160
+
161
+ // src/sessions/files/leases.ts
162
+ import { rmSync as rmSync2 } from "fs";
163
+ import { join as join2 } from "path";
164
+ var leasePath = (dir, name) => join2(dir, leaseFile(name));
165
+ function filesLeases(dir) {
166
+ const read = (name) => {
167
+ const lease = asLease(readJson(leasePath(dir, name)));
168
+ if (!lease || !alive(lease.pid)) return null;
169
+ return lease;
170
+ };
171
+ return {
172
+ read,
173
+ take(name, lease) {
174
+ const held = read(name);
175
+ const pid = lease.pid ?? process.pid;
176
+ if (held && held.pid !== pid) return false;
177
+ writeJson(leasePath(dir, name), {
178
+ pid,
179
+ subject: lease.subject,
180
+ ...lease.cwd ? { cwd: lease.cwd } : {},
181
+ since: (/* @__PURE__ */ new Date()).toISOString()
182
+ });
183
+ return true;
184
+ },
185
+ release(name, pid = process.pid) {
186
+ const held = asLease(readJson(leasePath(dir, name)));
187
+ if (!held || held.pid === pid || !alive(held.pid)) {
188
+ rmSync2(leasePath(dir, name), { force: true });
189
+ }
190
+ }
191
+ };
192
+ }
193
+
194
+ // src/sessions/files/mailbox.ts
195
+ import {
196
+ appendFileSync,
197
+ existsSync,
198
+ linkSync,
199
+ mkdirSync as mkdirSync2,
200
+ readdirSync,
201
+ rmSync as rmSync3,
202
+ unlinkSync,
203
+ writeFileSync as writeFileSync2
204
+ } from "fs";
205
+ import { join as join3 } from "path";
206
+
207
+ // src/sessions/mailbox/format.ts
208
+ var text = (value) => typeof value === "string";
209
+ function asMessage(value) {
210
+ if (value === null || typeof value !== "object" || Array.isArray(value))
211
+ return null;
212
+ const fields = value;
213
+ const from = fields["from"];
214
+ const to = fields["to"];
215
+ const valid = text(fields["id"]) && text(fields["body"]) && text(fields["createdAt"]) && text(fields["expiresAt"]) && Array.isArray(to) && to.every(text) && from !== null && typeof from === "object";
216
+ return valid ? value : null;
217
+ }
218
+ var MAX_BODY = 600;
219
+ function noticeOf(fresh, earlier, limit, session, pmcp = "pmcp") {
220
+ const shown = fresh.slice(-limit);
221
+ const as = session ? ` --session ${session}` : "";
222
+ const lines = [
223
+ `Mailbox: ${fresh.length} new message${fresh.length === 1 ? "" : "s"} for this session.`
224
+ ];
225
+ for (const message of shown) {
226
+ const sender = message.from.alias ?? message.from.session?.slice(0, 8) ?? "unknown";
227
+ const subject = message.subject ? ` (${message.subject})` : "";
228
+ const body = message.body.length > MAX_BODY ? `${message.body.slice(0, MAX_BODY)}...` : message.body;
229
+ lines.push(`- ${message.id} from ${sender}${subject}: ${body}`);
230
+ if (message.once)
231
+ lines.push(
232
+ " One-time request: act on it once. Do not keep its instructions as standing rules."
233
+ );
234
+ }
235
+ const hidden = fresh.length - shown.length;
236
+ if (hidden > 0) lines.push(`${hidden} more new message(s) not shown.`);
237
+ if (earlier > 0)
238
+ lines.push(`${earlier} earlier message(s) are still unacknowledged.`);
239
+ lines.push(
240
+ `Read: ${pmcp} sessions inbox${as}`,
241
+ `Acknowledge: ${pmcp} sessions ack <id>${as}`,
242
+ `Reply: ${pmcp} sessions reply <id>${as} '<text>'`
243
+ );
244
+ return lines.join("\n");
245
+ }
246
+
247
+ // src/sessions/files/mailbox.ts
248
+ var ID = /^\d{13}-[0-9a-f]{8}$/u;
249
+ var SAFE_KEY = /^@?[\w.-]+$/u;
250
+ function filesMailbox(dir, settings) {
251
+ const messages = join3(dir, "messages");
252
+ const inbox = join3(dir, "inbox");
253
+ const pathOf = (id) => join3(messages, `${id}.json`);
254
+ const marker = (key, id, kind) => {
255
+ if (!SAFE_KEY.test(key) || !ID.test(id))
256
+ throw new Error(`invalid mailbox key ${key} or id ${id}`);
257
+ return join3(inbox, key, `${id}.${kind}`);
258
+ };
259
+ const audit = (event, fields) => {
260
+ if (!settings.audit) return;
261
+ const line = { at: (/* @__PURE__ */ new Date()).toISOString(), event, ...fields };
262
+ appendFileSync(join3(dir, "messages.jsonl"), `${JSON.stringify(line)}
263
+ `, {
264
+ mode: 384
265
+ });
266
+ };
267
+ const touch = (path) => {
268
+ mkdirSync2(join3(path, ".."), { recursive: true, mode: 448 });
269
+ try {
270
+ writeFileSync2(path, "", { flag: "wx", mode: 384 });
271
+ return true;
272
+ } catch {
273
+ return false;
274
+ }
275
+ };
276
+ const get = (id) => ID.test(id) ? asMessage(readJson(pathOf(id))) : null;
277
+ const all = () => existsSync(messages) ? readdirSync(messages).filter((name) => name.endsWith(".json")).map((name) => get(name.slice(0, -5))).filter((message) => message !== null).sort((a, b) => a.id.localeCompare(b.id)) : [];
278
+ const live = (now) => all().filter((message) => Date.parse(message.expiresAt) > now);
279
+ const acked = (key, id) => existsSync(marker(key, id, "ack"));
280
+ const remove = (message, event) => {
281
+ rmSync3(pathOf(message.id), { force: true });
282
+ if (existsSync(inbox))
283
+ for (const key of readdirSync(inbox))
284
+ for (const kind of ["ack", "delivered"])
285
+ rmSync3(join3(inbox, key, `${message.id}.${kind}`), { force: true });
286
+ audit(event, { id: message.id });
287
+ };
288
+ return {
289
+ settings,
290
+ send(input) {
291
+ mkdirSync2(messages, { recursive: true, mode: 448 });
292
+ const created = Date.now();
293
+ const ttl = input.ttlMinutes ?? settings.ttlMinutes;
294
+ for (let attempt = 0; ; attempt += 1) {
295
+ if (attempt === 8)
296
+ throw new Error(`could not create a message in ${messages}`);
297
+ const id = `${created}-${Math.random().toString(16).slice(2, 10).padEnd(8, "0")}`;
298
+ const message = {
299
+ id,
300
+ from: input.from,
301
+ to: [...input.to],
302
+ ...input.subject ? { subject: input.subject } : {},
303
+ body: input.body,
304
+ createdAt: new Date(created).toISOString(),
305
+ expiresAt: new Date(created + ttl * 6e4).toISOString(),
306
+ ...input.replyTo ? { replyTo: input.replyTo } : {},
307
+ once: input.once === true,
308
+ ...input.broadcastId ? { broadcastId: input.broadcastId } : {}
309
+ };
310
+ const temporary = `${pathOf(id)}.${process.pid}.tmp`;
311
+ writeFileSync2(temporary, `${JSON.stringify(message, null, 2)}
312
+ `, {
313
+ mode: 384
314
+ });
315
+ try {
316
+ linkSync(temporary, pathOf(id));
317
+ } catch {
318
+ continue;
319
+ } finally {
320
+ unlinkSync(temporary);
321
+ }
322
+ audit("sent", { id, from: input.from, to: message.to });
323
+ return message;
324
+ }
325
+ },
326
+ get,
327
+ list: (now = Date.now()) => live(now),
328
+ inbox: (recipient, now = Date.now()) => live(now).filter(
329
+ (message) => addressedTo(message, recipient) && !sentBy(message, recipient) && !acked(recipient.key, message.id)
330
+ ),
331
+ delivered: (key, id) => existsSync(marker(key, id, "delivered")),
332
+ markDelivered(key, ids) {
333
+ for (const id of ids)
334
+ if (touch(marker(key, id, "delivered")))
335
+ audit("delivered", { id, to: key });
336
+ },
337
+ acked,
338
+ ack(key, ids) {
339
+ const done = ids.filter((id) => get(id) !== null);
340
+ for (const id of done)
341
+ if (touch(marker(key, id, "ack"))) audit("acked", { id, by: key });
342
+ return done;
343
+ },
344
+ withdraw(match) {
345
+ const gone = all().filter(match);
346
+ for (const message of gone) remove(message, "withdrawn");
347
+ return gone.length;
348
+ },
349
+ sweep(now = Date.now()) {
350
+ const expired = all().filter(
351
+ (message) => Date.parse(message.expiresAt) <= now
352
+ );
353
+ for (const message of expired) remove(message, "expired");
354
+ return expired.length;
355
+ },
356
+ record: (event, fields) => audit(event, fields)
357
+ };
358
+ }
359
+
360
+ // src/sessions/files/pause.ts
361
+ import { rmSync as rmSync4 } from "fs";
362
+ import { join as join4 } from "path";
363
+ function filesPause(dir) {
364
+ const path = join4(dir, STATE_FILES.pause);
365
+ return {
366
+ read: () => asPause(readJson(path)),
367
+ write(pause) {
368
+ if (!pause) {
369
+ rmSync4(path, { force: true });
370
+ return;
371
+ }
372
+ writeJson(path, {
373
+ by: pause.by,
374
+ reason: pause.reason,
375
+ since: (/* @__PURE__ */ new Date()).toISOString()
376
+ });
377
+ }
378
+ };
379
+ }
380
+
381
+ // src/sessions/files/registry.ts
382
+ import { readdirSync as readdirSync2, rmSync as rmSync5 } from "fs";
383
+ import { join as join5 } from "path";
384
+ var SESSION_ID = /^[A-Za-z0-9_-]{8,64}$/u;
385
+ function filesRegistry(dir, staleMs) {
386
+ const fleetDir = join5(dir, STATE_FILES.records);
387
+ const pathOf = (session) => join5(fleetDir, `${session}.json`);
388
+ const get = (session) => SESSION_ID.test(session) ? asRecord(readJson(pathOf(session))) : null;
389
+ const list = (now = Date.now()) => {
390
+ let names = [];
391
+ try {
392
+ names = readdirSync2(fleetDir).filter((name) => name.endsWith(".json"));
393
+ } catch {
394
+ return [];
395
+ }
396
+ return names.map((name) => asRecord(readJson(join5(fleetDir, name)))).filter((record) => record !== null).map((record) => ({ ...record, live: isLive(record, now, staleMs) }));
397
+ };
398
+ const remove = (session) => {
399
+ if (SESSION_ID.test(session)) rmSync5(pathOf(session), { force: true });
400
+ };
401
+ return {
402
+ get,
403
+ list,
404
+ remove,
405
+ upsert(session, fields) {
406
+ if (!SESSION_ID.test(session)) return null;
407
+ const now = (/* @__PURE__ */ new Date()).toISOString();
408
+ const previous = get(session) ?? { session, startedAt: now };
409
+ const next = {
410
+ ...previous,
411
+ ...fields,
412
+ updatedAt: now
413
+ };
414
+ if (typeof fields.cwd === "string" && fields.cwd !== previous.cwd) {
415
+ const checkout = checkoutOf(fields.cwd);
416
+ next["worktree"] = checkout?.root ?? "";
417
+ next["branch"] = checkout?.branch ?? "";
418
+ }
419
+ writeJson(pathOf(session), next);
420
+ return next;
421
+ },
422
+ sweep(now = Date.now()) {
423
+ const stale = list(now).filter((record) => !record.live);
424
+ stale.forEach((record) => remove(record.session));
425
+ return stale.length;
426
+ }
427
+ };
428
+ }
429
+
430
+ // src/sessions/files-store.ts
431
+ var OFF = {
432
+ enabled: false,
433
+ ttlMinutes: 1440,
434
+ maxDelivered: 5,
435
+ audit: true
436
+ };
437
+ function createFilesStore(dir, options = {}) {
438
+ const registry = filesRegistry(dir, options.staleMs ?? STALE_MS);
439
+ const mailbox = filesMailbox(dir, options.mailbox ?? OFF);
440
+ const broadcast = filesBroadcast(dir, options.keepBroadcasts ?? 10, registry);
441
+ return {
442
+ dir,
443
+ registry,
444
+ pause: filesPause(dir),
445
+ leases: filesLeases(dir),
446
+ // With the mailbox on, a broadcast is also a message to all, which the mailbox delivers;
447
+ // broadcast.json stays the record status, snapshot and the Claude band read.
448
+ broadcast: !mailbox.settings.enabled ? broadcast : {
449
+ ...broadcast,
450
+ post(entry) {
451
+ const posted = broadcast.post(entry);
452
+ mailbox.send({
453
+ from: { alias: entry.by },
454
+ to: ["all"],
455
+ body: entry.text,
456
+ broadcastId: posted.id
457
+ });
458
+ return posted;
459
+ },
460
+ clear() {
461
+ broadcast.clear();
462
+ mailbox.withdraw((message) => message.broadcastId !== void 0);
463
+ }
464
+ },
465
+ mailbox
466
+ };
467
+ }
468
+
469
+ export {
470
+ noticeOf,
471
+ normalizeSelector,
472
+ addressedTo,
473
+ sentBy,
474
+ inboxKey,
475
+ writeJson,
476
+ SESSION_ID,
477
+ createFilesStore
478
+ };
479
+ //# sourceMappingURL=chunk-LTZH5E3G.js.map
@@ -0,0 +1,39 @@
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-DMZHQZ7P.js";
10
+
11
+ // src/harness/adapters/systemd/admission.ts
12
+ var nativeHostTools = ["systemctl", "systemd-run"];
13
+ function assertNativeHost() {
14
+ if (process.platform !== "linux" && process.platform !== "darwin")
15
+ throw new Error("native_host_requires_linux_or_macos");
16
+ if (!ptyBinary(process.env))
17
+ throw new Error("native_host_tool_unavailable:pmcp-pty");
18
+ if (process.platform !== "linux") return;
19
+ for (const executable of nativeHostTools) {
20
+ if (!locateExecutable(executable))
21
+ throw new Error(`native_host_tool_unavailable:${executable}`);
22
+ }
23
+ try {
24
+ const version = command(
25
+ "systemctl",
26
+ ["--user", "show", "--property=Version", "--value"],
27
+ { timeout: 5e3 }
28
+ );
29
+ if (!version.trim()) throw new Error("empty_user_manager_version");
30
+ } catch {
31
+ throw new Error("native_user_manager_unavailable");
32
+ }
33
+ }
34
+
35
+ export {
36
+ nativeHostTools,
37
+ assertNativeHost
38
+ };
39
+ //# sourceMappingURL=chunk-LW4TG7EL.js.map