@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,179 @@
1
+ {
2
+ "runtime": "codex",
3
+ "version": "0.163.0",
4
+ "measuredAt": "2026-10-19T10:54:00Z",
5
+ "events": {
6
+ "session_start": {
7
+ "native": "SessionStart",
8
+ "fires": true,
9
+ "fields": [
10
+ "session_id",
11
+ "transcript_path",
12
+ "cwd",
13
+ "hook_event_name",
14
+ "model",
15
+ "permission_mode",
16
+ "source"
17
+ ]
18
+ },
19
+ "prompt": {
20
+ "native": "UserPromptSubmit",
21
+ "fires": true,
22
+ "fields": [
23
+ "session_id",
24
+ "turn_id",
25
+ "transcript_path",
26
+ "cwd",
27
+ "hook_event_name",
28
+ "model",
29
+ "permission_mode",
30
+ "prompt"
31
+ ]
32
+ },
33
+ "before_tool": {
34
+ "native": "PreToolUse",
35
+ "fires": true,
36
+ "fields": [
37
+ "session_id",
38
+ "turn_id",
39
+ "transcript_path",
40
+ "cwd",
41
+ "hook_event_name",
42
+ "model",
43
+ "permission_mode",
44
+ "tool_name",
45
+ "tool_input",
46
+ "tool_use_id"
47
+ ]
48
+ },
49
+ "after_tool": {
50
+ "native": "PostToolUse",
51
+ "fires": true,
52
+ "fields": [
53
+ "session_id",
54
+ "turn_id",
55
+ "transcript_path",
56
+ "cwd",
57
+ "hook_event_name",
58
+ "model",
59
+ "permission_mode",
60
+ "tool_name",
61
+ "tool_input",
62
+ "tool_response",
63
+ "tool_use_id"
64
+ ]
65
+ },
66
+ "stop": {
67
+ "native": "Stop",
68
+ "fires": true,
69
+ "fields": [
70
+ "session_id",
71
+ "turn_id",
72
+ "transcript_path",
73
+ "cwd",
74
+ "hook_event_name",
75
+ "model",
76
+ "permission_mode",
77
+ "stop_hook_active",
78
+ "last_assistant_message"
79
+ ]
80
+ },
81
+ "session_end": {
82
+ "native": "SessionEnd",
83
+ "fires": true,
84
+ "fields": [
85
+ "session_id",
86
+ "transcript_path",
87
+ "cwd",
88
+ "hook_event_name",
89
+ "reason"
90
+ ]
91
+ },
92
+ "notification": {
93
+ "native": null,
94
+ "fires": false
95
+ }
96
+ },
97
+ "tools": {
98
+ "shell": {
99
+ "tool_name": "Bash",
100
+ "input": "tool_input.command (string)"
101
+ },
102
+ "edit": {
103
+ "tool_name": "apply_patch",
104
+ "input": "tool_input.command holds the patch; paths are absolute in '*** Add File:' / '*** Update File:' / '*** Delete File:' headers"
105
+ }
106
+ },
107
+ "outputs": {
108
+ "deny": {
109
+ "event": "before_tool",
110
+ "support": "measured",
111
+ "shape": "hookSpecificOutput.permissionDecision = deny + permissionDecisionReason; the reason reaches the model as the tool result"
112
+ },
113
+ "context": {
114
+ "support": "measured",
115
+ "delivered": ["session_start", "prompt", "before_tool", "after_tool"],
116
+ "shape": "hookSpecificOutput.additionalContext; lands in the transcript as a developer message",
117
+ "notes": "The model declines to quote developer messages, so delivery must be judged from the transcript"
118
+ },
119
+ "stop_output": {
120
+ "support": "unsupported_shape",
121
+ "notes": "hookSpecificOutput on Stop is rejected: 'hook returned invalid stop hook JSON output'. Stop must return {} or a decision object."
122
+ },
123
+ "ask": {
124
+ "support": "unqualified",
125
+ "notes": "not exercised; earlier research reports none"
126
+ }
127
+ },
128
+ "live": {
129
+ "version": "0.163.0",
130
+ "measuredAt": "2026-10-19T12:41:41.485Z",
131
+ "implementationCommits": ["880aa32", "d6d2cce"],
132
+ "deny": {
133
+ "support": "measured",
134
+ "scenarios": [
135
+ "codex-heredoc-a2bd46d6",
136
+ "codex-stage-all-9d40c45a",
137
+ "codex-pause-6cb11e0e",
138
+ "codex-lease-c22c12b4"
139
+ ]
140
+ },
141
+ "context": {
142
+ "support": "measured",
143
+ "delivered": {
144
+ "session_start": "codex-context-start-e7a33f51",
145
+ "prompt": "codex-context-prompt-31d406cf",
146
+ "before_tool": "codex-context-before-05898b7b"
147
+ },
148
+ "notes": "after_tool context stays measured by the earlier probe; the live extension did not exercise it. A broadcast from a Codex session reached a live Claude session through its hooks (codex-broadcast-34d5291a)."
149
+ },
150
+ "stop": {
151
+ "support": "measured",
152
+ "notes": "Stop fires in live sessions; no Stop context is claimed, so the stop_output limitation above stands and Stop notices wait for the next prompt"
153
+ },
154
+ "session_end_timeout": {
155
+ "maxSec": 3,
156
+ "support": "measured",
157
+ "notes": "Codex clamps a SessionEnd hook timeout to 3 s; pmcp projects min(compiled, 3) since 880aa32"
158
+ },
159
+ "quoted_executable_filter": {
160
+ "support": "measured",
161
+ "scenarios": [
162
+ "codex-worktree-create-f94e412f",
163
+ "codex-worktree-create-9a8e193c"
164
+ ],
165
+ "notes": "Codex's exec_command rejects a fully quoted executable form as arbitrary shell execution before spawning it; PreToolUse fires and allows first, so no hook sees the rejection. The unquoted form runs. Not a pmcp defect."
166
+ },
167
+ "ask": {
168
+ "support": "unqualified",
169
+ "notes": "interactive ask not exercised"
170
+ },
171
+ "scenarios": {
172
+ "passed": 13,
173
+ "failed": 1,
174
+ "failedCause": "quoted_executable_filter"
175
+ }
176
+ },
177
+ "fields_absent": ["agent_type"],
178
+ "trust": "hash_review: changed hooks.json shows 'Hooks need review'; untrusted hooks do not run"
179
+ }
@@ -0,0 +1,196 @@
1
+ {
2
+ "runtime": "gemini",
3
+ "version": "0.63.0",
4
+ "measuredAt": "2026-10-20T01:00:00Z",
5
+ "configuration": {
6
+ "hooks": "hooks object in .gemini/settings.json (project), ~/.gemini/settings.json (user), system settings and extensions; per event: [{matcher, sequential, hooks:[{type: command, command, name, timeout, description}]}]",
7
+ "trust": "measured: without trust, gemini -p exits 55 ('Gemini CLI is not running in a trusted directory ... --skip-trust, GEMINI_CLI_TRUST_WORKSPACE=true, or trust this directory in interactive mode'); an untrusted folder also ignores .gemini/settings.json and .env. With per-run trust, stderr warns 'The following project-level hooks have been detected in this workspace' and the hooks run.",
8
+ "trusted_hooks_write": "measured: the first run wrote ~/.gemini/trusted_hooks.json (397 -> 2968 bytes): 22 hook identities (name + command) under the project path. ~/.gemini/trustedFolders.json unchanged (no persistent folder trust).",
9
+ "auth_note": "measured: Vertex AI needs GOOGLE_CLOUD_PROJECT and GOOGLE_CLOUD_LOCATION; ~/.gemini/.env holds them but is not read in an untrusted folder (exit 41 before the trust check). Exported per run; values not printed.",
10
+ "headless": "gemini -p '<prompt>' --output-format json -> {session_id, response, stats}; --allowed-tools must be one flag per tool with = (a bare second value is read as a positional prompt)",
11
+ "mcp": "documented: mcpServers in .gemini/settings.json (project, trusted folders only) or user settings; tools named mcp_<server>_<tool>. Not exercised."
12
+ },
13
+ "events": {
14
+ "session_start": {
15
+ "native": "SessionStart",
16
+ "fires": true,
17
+ "fields": [
18
+ "session_id",
19
+ "transcript_path",
20
+ "cwd",
21
+ "hook_event_name",
22
+ "timestamp",
23
+ "source"
24
+ ]
25
+ },
26
+ "prompt": {
27
+ "native": "BeforeAgent",
28
+ "fires": true,
29
+ "fields": [
30
+ "session_id",
31
+ "transcript_path",
32
+ "cwd",
33
+ "hook_event_name",
34
+ "timestamp",
35
+ "prompt"
36
+ ]
37
+ },
38
+ "before_tool": {
39
+ "native": "BeforeTool",
40
+ "fires": true,
41
+ "fields": [
42
+ "session_id",
43
+ "transcript_path",
44
+ "cwd",
45
+ "hook_event_name",
46
+ "timestamp",
47
+ "tool_name",
48
+ "tool_input"
49
+ ]
50
+ },
51
+ "after_tool": {
52
+ "native": "AfterTool",
53
+ "fires": true,
54
+ "fields": [
55
+ "session_id",
56
+ "transcript_path",
57
+ "cwd",
58
+ "hook_event_name",
59
+ "timestamp",
60
+ "tool_name",
61
+ "tool_input",
62
+ "tool_response {llmContent, returnDisplay}"
63
+ ],
64
+ "notes": "not for the denied call"
65
+ },
66
+ "stop": {
67
+ "native": "AfterAgent",
68
+ "fires": true,
69
+ "fields": [
70
+ "session_id",
71
+ "transcript_path",
72
+ "cwd",
73
+ "hook_event_name",
74
+ "timestamp",
75
+ "prompt",
76
+ "prompt_response",
77
+ "stop_hook_active"
78
+ ]
79
+ },
80
+ "session_end": {
81
+ "native": "SessionEnd",
82
+ "fires": true,
83
+ "fields": [
84
+ "session_id",
85
+ "transcript_path",
86
+ "cwd",
87
+ "hook_event_name",
88
+ "timestamp",
89
+ "reason"
90
+ ]
91
+ },
92
+ "model": {
93
+ "native": "BeforeModel (4), AfterModel (25, per streamed chunk), BeforeToolSelection (4)",
94
+ "fires": true
95
+ },
96
+ "compress": {
97
+ "native": "PreCompress",
98
+ "fires": true,
99
+ "notes": "4 times with trigger auto in a short run"
100
+ },
101
+ "notification": {
102
+ "native": "Notification",
103
+ "fires": "not in this run (no permission prompt in headless mode)"
104
+ }
105
+ },
106
+ "tools": {
107
+ "shell": {
108
+ "tool_name": "run_shell_command",
109
+ "input": "tool_input.command, tool_input.description"
110
+ },
111
+ "edit": {
112
+ "tool_name": "write_file (also replace, documented)",
113
+ "input": "tool_input.file_path (relative to cwd here), tool_input.content"
114
+ }
115
+ },
116
+ "outputs": {
117
+ "deny": {
118
+ "event": "before_tool",
119
+ "support": "measured",
120
+ "shape": "top-level {decision: deny, reason}; the tool result reads 'Tool execution blocked: <reason>' and the model reports it"
121
+ },
122
+ "context": {
123
+ "support": "measured",
124
+ "delivered": ["session_start", "prompt", "after_tool"],
125
+ "not_delivered": ["before_tool additionalContext"],
126
+ "shape": "hookSpecificOutput.additionalContext; transcript user content wrapped in <hook_context>...</hook_context>",
127
+ "native_delivered": [
128
+ "session_start",
129
+ "prompt (BeforeAgent)",
130
+ "after_tool"
131
+ ],
132
+ "deferred": {
133
+ "before_tool": "after_tool; V2 gemini-context-before-619fdd0c"
134
+ }
135
+ },
136
+ "stop_context": {
137
+ "support": "documented",
138
+ "notes": "AfterAgent decision deny forces a retry with reason as the new prompt; stop_hook_active marks it. Not exercised (the probe does not deny AfterAgent)."
139
+ },
140
+ "rewrite": {
141
+ "support": "documented",
142
+ "notes": "BeforeTool hookSpecificOutput.tool_input merges into the arguments"
143
+ }
144
+ },
145
+ "fields_absent": ["turn_id / prompt_id", "agent_type"],
146
+ "timeouts": "per hook in milliseconds, default 60000",
147
+ "trust": "folder trust required for project settings (and so project hooks) in headless mode; new project hook identities warned about and recorded in ~/.gemini/trusted_hooks.json",
148
+ "live": {
149
+ "version": "0.63.0",
150
+ "measuredAt": "2026-10-20T04:07:05.574Z",
151
+ "implementationCommits": ["cfcdf5a", "35f3c77"],
152
+ "deny": {
153
+ "support": "measured",
154
+ "scenarios": [
155
+ "gemini-heredoc-8623d8e2",
156
+ "gemini-stage-all-e4881b2f",
157
+ "gemini-pause-c9ad18d6",
158
+ "gemini-lease-73ef0b6a"
159
+ ]
160
+ },
161
+ "context": {
162
+ "support": "measured",
163
+ "scenarios": {
164
+ "context-start": "gemini-context-start-5084022a",
165
+ "context-prompt": "gemini-context-prompt-6b8143f8",
166
+ "context-before": "gemini-context-before-619fdd0c",
167
+ "broadcast": "gemini-broadcast-dd1ccef0"
168
+ },
169
+ "notes": "pause, broadcast and shared_checkout notices reached the model; held context arrived at the next delivering event"
170
+ },
171
+ "workflow": {
172
+ "support": "measured",
173
+ "scenarios": [
174
+ "gemini-worktree-create-7e550fcb",
175
+ "gemini-worktree-sync-f2b22e6c",
176
+ "gemini-deliver-b0decc82",
177
+ "gemini-deliver-race-fcd98c2a",
178
+ "gemini-git-sync-28c4be9c"
179
+ ]
180
+ },
181
+ "cost": [
182
+ {
183
+ "event": "before_tool",
184
+ "addedMs": 24.6
185
+ },
186
+ {
187
+ "event": "prompt",
188
+ "addedMs": 25.3
189
+ }
190
+ ],
191
+ "scenarios": {
192
+ "passed": 13,
193
+ "failed": []
194
+ }
195
+ }
196
+ }
@@ -0,0 +1,192 @@
1
+ {
2
+ "runtime": "grok",
3
+ "version": "1.0.50",
4
+ "measuredAt": "2026-10-20T01:05:00Z",
5
+ "configuration": {
6
+ "hooks": "merged from ~/.grok/hooks/*.json, ~/.claude/settings.json (+ .local), ~/.cursor/hooks.json, <project>/.grok/hooks/*.json, <project>/.claude/settings.json (+ .local), <project>/.cursor/hooks.json, [[hooks.<Event>]] in ~/.grok/config.toml, managed/requirements toml, plugins",
7
+ "double_hooks": "measured: all three sources fire together. Each PreToolUse dispatched 4 hooks: global/settings (the user's ~/.claude/settings.json Bash hook, run for both shell calls, not for the write), project/settings (project .claude/settings.json) and project/probe (.grok/hooks, two handlers). Every recorded event appears once from .grok/hooks and once from .claude/settings.json. A pmcp projection that writes Claude hooks into .claude/settings.json and grok hooks into .grok/hooks would run each check twice; the adapter must project into one of them (or disable compat with [compat.claude] hooks = false, a user-level setting).",
8
+ "hook_env": "measured: a .claude/settings.json hook runs with CLAUDE_PROJECT_DIR and GROK_WORKSPACE_ROOT set to the project root and PWD at the project root, so a Claude projection's $CLAUDE_PROJECT_DIR command resolves under grok",
9
+ "trust": "measured: before trust, projectTrusted false and no project hook ran; after /hooks-trust, grok inspect lists 30 .grok/hooks handlers and 15 .claude handlers and they run headless. Trust is folder-wide (MCP, LSP, instructions, skills).",
10
+ "headless": "grok -p '<prompt>' --output-format json -> {text, stopReason, sessionId, usage, num_turns}; --permission-mode dontAsk with --allow rules ran the allowed tools without prompts",
11
+ "mcp": "documented: [mcp_servers.<name>] in <repo-root>/.grok/config.toml or <cwd>/.grok/config.toml (command or url), trust-gated; tools <server>__<tool> via search_tool/use_tool. Not exercised."
12
+ },
13
+ "events": {
14
+ "session_start": {
15
+ "native": "SessionStart",
16
+ "fires": true,
17
+ "fields": [
18
+ "hookEventName",
19
+ "sessionId",
20
+ "cwd",
21
+ "workspaceRoot",
22
+ "timestamp",
23
+ "transcriptPath",
24
+ "permissionMode",
25
+ "source",
26
+ "and snake_case twins"
27
+ ]
28
+ },
29
+ "prompt": {
30
+ "native": "UserPromptSubmit",
31
+ "fires": true
32
+ },
33
+ "before_tool": {
34
+ "native": "PreToolUse",
35
+ "fires": true,
36
+ "fields": [
37
+ "hookEventName",
38
+ "sessionId",
39
+ "cwd",
40
+ "workspaceRoot",
41
+ "timestamp",
42
+ "transcriptPath",
43
+ "permissionMode",
44
+ "toolName",
45
+ "toolUseId",
46
+ "toolInput",
47
+ "toolInputTruncated",
48
+ "hook_event_name",
49
+ "session_id",
50
+ "transcript_path",
51
+ "permission_mode",
52
+ "tool_name",
53
+ "tool_input",
54
+ "tool_use_id"
55
+ ]
56
+ },
57
+ "after_tool": {
58
+ "native": "PostToolUse",
59
+ "fires": true,
60
+ "notes": "not for the denied call"
61
+ },
62
+ "stop": {
63
+ "native": "Stop",
64
+ "fires": true,
65
+ "fields": ["... common", "reason", "stopHookActive", "stop_hook_active"]
66
+ },
67
+ "session_end": {
68
+ "native": "SessionEnd",
69
+ "fires": true,
70
+ "fields": ["... common", "reason (shutdown)"]
71
+ },
72
+ "other_documented": "PostToolUseFailure, PermissionDenied, StopFailure, StopCancelled, Notification, SubagentStart, SubagentStop, PreCompact, PostCompact (not triggered in this run)",
73
+ "notification": {
74
+ "native": "Notification",
75
+ "fires": false,
76
+ "notes": "documented, not triggered"
77
+ }
78
+ },
79
+ "tools": {
80
+ "shell": {
81
+ "tool_name": "run_terminal_command (matcher alias Bash)",
82
+ "input": "tool_input.command, tool_input.description"
83
+ },
84
+ "edit": {
85
+ "tool_name": "write (matcher alias Write); search_replace for edits (documented)",
86
+ "input": "tool_input.file_path, tool_input.content"
87
+ }
88
+ },
89
+ "outputs": {
90
+ "deny": {
91
+ "event": "before_tool",
92
+ "support": "measured",
93
+ "shape": "hookSpecificOutput.permissionDecision deny + permissionDecisionReason; the tool result reads 'Hook denied: <reason>' and the model reports it"
94
+ },
95
+ "context": {
96
+ "support": "measured",
97
+ "delivered": ["before_tool", "after_tool", "stop"],
98
+ "not_delivered": ["session_start", "prompt"],
99
+ "shape": "hookSpecificOutput.additionalContext; before_tool context arrives after the call ran, with its results",
100
+ "native_delivered": ["before_tool", "after_tool", "stop"],
101
+ "deferred": {
102
+ "session_start": "before_tool; V2 grok-context-start-fcfd44d1",
103
+ "prompt": "before_tool; V2 grok-context-prompt-6c279a76"
104
+ }
105
+ },
106
+ "stop_context": {
107
+ "support": "measured",
108
+ "notes": "additionalContext on Stop continues the turn, as on Claude: 9 Stop events in one run until --max-turns 10. Policies may return Stop context only when stop_hook_active is false."
109
+ },
110
+ "ask": {
111
+ "support": "documented",
112
+ "notes": "decision ask reaches the permission prompt; dontAsk turns it into a deny"
113
+ },
114
+ "failure": {
115
+ "support": "documented",
116
+ "notes": "hook failures fail open; only an explicit deny blocks"
117
+ }
118
+ },
119
+ "fields_absent": [
120
+ "promptId (documented, absent in this headless run)",
121
+ "agent_type"
122
+ ],
123
+ "timeouts": "default 5 s; 600 s for Stop, SubagentStop and PostToolUse gates",
124
+ "trust": "folder trust (~/.grok/trusted_folders.toml) required for any project hook, including .claude/settings.json; user-level ~/.claude/settings.json hooks run without it",
125
+ "live": {
126
+ "version": "1.0.62",
127
+ "measuredAt": "2026-10-20T03:50:35.533Z",
128
+ "implementationCommits": ["cfcdf5a", "35f3c77"],
129
+ "deny": {
130
+ "support": "measured",
131
+ "scenarios": [
132
+ "grok-heredoc-0a303279",
133
+ "grok-stage-all-a0ae281d",
134
+ "grok-pause-cc959085",
135
+ "grok-lease-677333e4"
136
+ ]
137
+ },
138
+ "context": {
139
+ "support": "measured",
140
+ "scenarios": {
141
+ "context-start": "grok-context-start-fcfd44d1",
142
+ "context-prompt": "grok-context-prompt-6c279a76",
143
+ "context-before": "grok-context-before-8db85a8c",
144
+ "broadcast": "grok-broadcast-c9f5d420"
145
+ },
146
+ "notes": "pause, broadcast and shared_checkout notices reached the model; held context arrived at the next delivering event"
147
+ },
148
+ "workflow": {
149
+ "support": "measured",
150
+ "scenarios": [
151
+ "grok-worktree-create-53b690da",
152
+ "grok-worktree-sync-18990306",
153
+ "grok-deliver-86fb266a",
154
+ "grok-deliver-race-e292c85c",
155
+ "grok-git-sync-adeae993"
156
+ ]
157
+ },
158
+ "cost": [
159
+ {
160
+ "event": "before_tool",
161
+ "addedMs": 28.8
162
+ },
163
+ {
164
+ "event": "prompt",
165
+ "addedMs": 20.8
166
+ }
167
+ ],
168
+ "single_dispatch": {
169
+ "support": "measured",
170
+ "notes": "With claude and grok targeted, pmcp projects only .claude/settings.json; every V2 grok run logged each hook once as runtime grok",
171
+ "scenarios": [
172
+ "grok-heredoc-0a303279",
173
+ "grok-stage-all-a0ae281d",
174
+ "grok-context-start-fcfd44d1",
175
+ "grok-context-prompt-6c279a76",
176
+ "grok-context-before-8db85a8c",
177
+ "grok-pause-cc959085",
178
+ "grok-lease-677333e4",
179
+ "grok-broadcast-c9f5d420",
180
+ "grok-worktree-create-53b690da",
181
+ "grok-worktree-sync-18990306",
182
+ "grok-deliver-86fb266a",
183
+ "grok-deliver-race-e292c85c",
184
+ "grok-git-sync-adeae993"
185
+ ]
186
+ },
187
+ "scenarios": {
188
+ "passed": 13,
189
+ "failed": []
190
+ }
191
+ }
192
+ }