better-dsh 0.2.4-a → 0.2.4-b

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 (1184) hide show
  1. package/cordis.patch.yml +7 -0
  2. package/docs/10_plans/2026-09-23-remote-execution-framework.md +236 -0
  3. package/docs/10_plans/2026-09-23-remote-framework-impl.md +2083 -0
  4. package/docs/50_test-reports/2026-09-23-remote-framework/345/256/236/346/265/213/346/212/245/345/221/212.md +92 -0
  5. package/docs/50_test-reports/2026-09-23-remote-framework/347/254/254/344/270/200/344/272/272/347/247/260/345/244/215/346/265/213/346/212/245/345/221/212.md +125 -0
  6. package/lib/client/index.js +2 -2
  7. package/lib/fs-aware/sandbox-plugin.js +1 -1
  8. package/lib/remote/plugin.d.ts +24 -0
  9. package/lib/remote/plugin.js +1095 -0
  10. package/lib/url-schemes/index.js +1 -1
  11. package/package.json +6 -2
  12. package/docs/10_plans/dashr-remote-tool-design.md +0 -337
  13. package/docs/10_plans/self-exo-cot-draft.md +0 -322
  14. package/docs/10_plans/self-scheme-and-monolog-draft.md +0 -357
  15. package/docs/50_test-reports/2026-09-22-4988/345/217/214/345/271/263/351/235/242/345/220/257/345/212/250/344/277/256/345/244/215/345/256/236/346/265/213/346/212/245/345/221/212.md +0 -76
  16. package/docs/50_test-reports/2026-09-22-better-dsh/347/273/204/344/273/266/347/203/255/346/217/222/346/213/224/344/270/216/344/276/235/350/265/226/347/272/247/350/201/224/345/256/236/346/265/213/346/212/245/345/221/212.md +0 -117
  17. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/.tools/MdxPage-CTY7atqe.js +0 -11
  18. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/.tools/extract_omp.mjs +0 -42
  19. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/.tools/fetch_pi.py +0 -52
  20. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/.tools/jsx-runtime-BHwPObl3.js +0 -13
  21. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/.tools/omp_extracted.json +0 -1
  22. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/.tools/omp_pages.txt +0 -35
  23. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/.tools/package.json +0 -1
  24. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/.tools/pi_convert.py +0 -49
  25. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/.tools/pi_pages.txt +0 -30
  26. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/.tools/serialize_omp.py +0 -250
  27. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/README.md +0 -80
  28. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/Overview.md +0 -88
  29. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/acp.md +0 -151
  30. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/advisor.md +0 -185
  31. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/agents-and-roles.md +0 -168
  32. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/approvals.md +0 -200
  33. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/cli.md +0 -381
  34. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/code-intelligence.md +0 -225
  35. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/collab.md +0 -207
  36. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/commit.md +0 -169
  37. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/compaction.md +0 -195
  38. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/computer.md +0 -224
  39. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/context-files.md +0 -184
  40. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/custom-models.md +0 -284
  41. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/custom-tools.md +0 -248
  42. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/debugging.md +0 -254
  43. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/editing.md +0 -157
  44. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/env.md +0 -552
  45. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/extension-authoring.md +0 -378
  46. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/files.md +0 -144
  47. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/github.md +0 -175
  48. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/goal.md +0 -156
  49. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/handoff.md +0 -139
  50. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/hooks.md +0 -257
  51. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/keybindings.md +0 -204
  52. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/magic-keywords.md +0 -135
  53. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/marketplace.md +0 -269
  54. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/mcp-authoring.md +0 -243
  55. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/mcp.md +0 -260
  56. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/memory.md +0 -306
  57. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/modes.md +0 -214
  58. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/pages.txt +0 -56
  59. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/plan.md +0 -126
  60. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/plugins.md +0 -287
  61. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/prewalk.md +0 -122
  62. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/prompt-templates.md +0 -149
  63. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/providers.md +0 -229
  64. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/quickstart.md +0 -117
  65. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/review.md +0 -248
  66. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/roles.md +0 -247
  67. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/rpc.md +0 -523
  68. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/sdk.md +0 -260
  69. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/secrets.md +0 -199
  70. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/security.md +0 -260
  71. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/session-format.md +0 -254
  72. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/session-tree.md +0 -135
  73. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/sessions.md +0 -223
  74. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/settings.md +0 -290
  75. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/skills.md +0 -187
  76. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/slash.md +0 -328
  77. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/subagent-authoring.md +0 -165
  78. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/subagents.md +0 -149
  79. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/themes.md +0 -230
  80. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/tools.md +0 -120
  81. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/ttsr.md +0 -242
  82. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/using.md +0 -214
  83. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/vibe.md +0 -187
  84. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/omp/web.md +0 -233
  85. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/compaction.md +0 -427
  86. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/containerization.md +0 -162
  87. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/custom-provider.md +0 -782
  88. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/development.md +0 -96
  89. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/environment-variables.md +0 -104
  90. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/extensions.md +0 -3058
  91. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/index.md +0 -89
  92. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/json.md +0 -105
  93. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/keybindings.md +0 -244
  94. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/llama-cpp.md +0 -106
  95. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/models.md +0 -587
  96. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/packages.md +0 -234
  97. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/pages.txt +0 -30
  98. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/prompt-templates.md +0 -101
  99. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/providers.md +0 -327
  100. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/quickstart.md +0 -172
  101. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/rpc.md +0 -1679
  102. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/sdk.md +0 -1239
  103. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/security.md +0 -64
  104. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/session-format.md +0 -454
  105. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/sessions.md +0 -150
  106. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/settings.md +0 -374
  107. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/shell-aliases.md +0 -18
  108. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/skills.md +0 -241
  109. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/terminal-setup.md +0 -199
  110. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/termux.md +0 -135
  111. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/themes.md +0 -328
  112. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/tmux.md +0 -68
  113. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/tui.md +0 -965
  114. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/usage.md +0 -315
  115. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/pi-and-omp/pi/windows.md +0 -44
  116. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/SKILL.md +0 -147
  117. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/chapters/ch01-user-guide.md +0 -123
  118. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/chapters/ch02-plugin-basics.md +0 -127
  119. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/chapters/ch03-plugin-framework-practice.md +0 -120
  120. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/chapters/ch04-cordis-fundamentals.md +0 -129
  121. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/chapters/ch05-cordis-api.md +0 -115
  122. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/chapters/ch06-architecture.md +0 -109
  123. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/chapters/ch07-capability-seams.md +0 -97
  124. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/chapters/ch08-internals-pipelines.md +0 -111
  125. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/chapters/ch09-api-gateway.md +0 -106
  126. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/chapters/ch10-config-catalog.md +0 -97
  127. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/chapters/ch11-tool-catalog.md +0 -121
  128. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/chapters/ch12-persistence-catalog.md +0 -109
  129. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/chapters/ch13-subsystems-core-session.md +0 -106
  130. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/chapters/ch14-subsystems-agent-loop.md +0 -111
  131. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/chapters/ch15-subsystems-tool-execution.md +0 -106
  132. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/chapters/ch16-subsystems-session-data.md +0 -132
  133. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/chapters/ch17-subsystems-llm-streaming.md +0 -128
  134. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/chapters/ch18-subsystems-web-ui.md +0 -142
  135. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/chapters/ch19-cookbook.md +0 -149
  136. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/chapters/ch20-development-testing.md +0 -87
  137. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/chapters/ch21-postmortems.md +0 -82
  138. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/chapters/ch22-i18n.md +0 -86
  139. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/cheatsheet.md +0 -67
  140. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/glossary.md +0 -57
  141. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/skill/patterns.md +0 -88
  142. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/AGENTS.md +0 -75
  143. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/agent-lifecycle.md +0 -84
  144. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/agent-lifecycle.zh.md +0 -86
  145. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/api-gateway.md +0 -164
  146. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/api-gateway.zh.md +0 -164
  147. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/architecture.md +0 -150
  148. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/architecture.zh.md +0 -154
  149. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/capability-seams.md +0 -543
  150. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/capability-seams.zh.md +0 -545
  151. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/config-catalog.md +0 -3473
  152. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/config-catalog.zh.md +0 -3474
  153. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cookbook/adding-a-package.md +0 -117
  154. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cookbook/adding-a-package.zh.md +0 -119
  155. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cookbook/adding-a-remote-api.md +0 -197
  156. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cookbook/adding-a-remote-api.zh.md +0 -197
  157. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cookbook/adding-a-settings-card.md +0 -102
  158. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cookbook/adding-a-settings-card.zh.md +0 -102
  159. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cookbook/adding-a-tool.md +0 -101
  160. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cookbook/adding-a-tool.zh.md +0 -103
  161. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cookbook/adding-a-vendored-package.md +0 -59
  162. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cookbook/adding-a-vendored-package.zh.md +0 -59
  163. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cookbook/adding-an-llm-adapter.md +0 -43
  164. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cookbook/adding-an-llm-adapter.zh.md +0 -43
  165. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cookbook/extension-cookbook.md +0 -132
  166. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cookbook/extension-cookbook.zh.md +0 -136
  167. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cookbook/maintaining-dsh-code-review.md +0 -64
  168. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cookbook/maintaining-dsh-code-review.zh.md +0 -64
  169. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cookbook/responding-to-pr-review-on-a-stack.md +0 -32
  170. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cookbook/responding-to-pr-review-on-a-stack.zh.md +0 -32
  171. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-api/context.md +0 -364
  172. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-api/context.zh.md +0 -366
  173. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-api/events.md +0 -207
  174. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-api/events.zh.md +0 -209
  175. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-api/fiber.md +0 -375
  176. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-api/fiber.zh.md +0 -377
  177. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-api/inherited.md +0 -39
  178. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-api/registry.md +0 -152
  179. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-api/registry.zh.md +0 -154
  180. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-api/service.md +0 -102
  181. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-api/service.zh.md +0 -104
  182. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-primer.md +0 -45
  183. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-primer.zh.md +0 -51
  184. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-tutorial/01-first-plugin.md +0 -95
  185. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-tutorial/01-first-plugin.zh.md +0 -95
  186. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-tutorial/02-lifecycle-and-effects.md +0 -98
  187. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-tutorial/02-lifecycle-and-effects.zh.md +0 -98
  188. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-tutorial/03-services.md +0 -98
  189. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-tutorial/03-services.zh.md +0 -98
  190. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-tutorial/04-events.md +0 -144
  191. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-tutorial/04-events.zh.md +0 -144
  192. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-tutorial/05-config.md +0 -84
  193. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-tutorial/05-config.zh.md +0 -84
  194. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-tutorial/06-composition-and-hmr.md +0 -113
  195. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-tutorial/06-composition-and-hmr.zh.md +0 -113
  196. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-tutorial/07-into-the-harness.md +0 -108
  197. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-tutorial/07-into-the-harness.zh.md +0 -108
  198. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-tutorial/index.md +0 -60
  199. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/cordis-tutorial/index.zh.md +0 -62
  200. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/deepseek-llm-api-wire-extensions.md +0 -163
  201. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/deepseek-llm-api-wire-extensions.zh.md +0 -163
  202. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/defensive-patterns.md +0 -33
  203. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/defensive-patterns.zh.md +0 -35
  204. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/development.md +0 -167
  205. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/development.zh.md +0 -173
  206. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/event-producer-consumer.md +0 -86
  207. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/event-producer-consumer.zh.md +0 -88
  208. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/glossary.md +0 -45
  209. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/glossary.zh.md +0 -45
  210. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/graph-atlas.md +0 -22
  211. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/graph-atlas.zh.md +0 -24
  212. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/i18n/README.md +0 -60
  213. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/i18n/README.zh.md +0 -62
  214. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/i18n/style-samples.md +0 -87
  215. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/i18n/terminology.md +0 -214
  216. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/i18n/translation-prompt.md +0 -263
  217. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/i18n/translation-rules.md +0 -69
  218. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/i18n/translation-rules.zh.md +0 -69
  219. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/module-graph.md +0 -1411
  220. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/module-graph.zh.md +0 -1413
  221. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/persistence-catalog.md +0 -1075
  222. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/persistence-catalog.zh.md +0 -1077
  223. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/postmortem/0001-acp-default-export-drops-inject.md +0 -113
  224. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/postmortem/0001-acp-default-export-drops-inject.zh.md +0 -113
  225. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/postmortem/0002-js-expression-disabled-filesystem-tools.md +0 -47
  226. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/postmortem/0002-js-expression-disabled-filesystem-tools.zh.md +0 -47
  227. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/postmortem/0003-web-agent-gui-feedback-loop.md +0 -53
  228. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/postmortem/0003-web-agent-gui-feedback-loop.zh.md +0 -53
  229. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/postmortem/0004-landlock-partial-notice-misclassified-child-failures.md +0 -55
  230. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/postmortem/0004-landlock-partial-notice-misclassified-child-failures.zh.md +0 -55
  231. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/postmortem/README.md +0 -18
  232. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/postmortem/README.zh.md +0 -18
  233. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/rescope.md +0 -53
  234. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/rescope.zh.md +0 -53
  235. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/README.md +0 -61
  236. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/README.zh.md +0 -61
  237. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/agent-team.md +0 -207
  238. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/agent-team.zh.md +0 -207
  239. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/approval.md +0 -170
  240. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/approval.zh.md +0 -170
  241. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/attachment.md +0 -351
  242. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/attachment.zh.md +0 -351
  243. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/client-modules.md +0 -168
  244. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/client-modules.zh.md +0 -168
  245. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/code-runtime.md +0 -195
  246. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/code-runtime.zh.md +0 -195
  247. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/commands.md +0 -219
  248. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/commands.zh.md +0 -219
  249. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/compaction.md +0 -238
  250. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/compaction.zh.md +0 -238
  251. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/conversation.md +0 -258
  252. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/conversation.zh.md +0 -258
  253. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/core.md +0 -1209
  254. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/core.zh.md +0 -1219
  255. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/credentials.md +0 -329
  256. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/credentials.zh.md +0 -329
  257. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/extensions.md +0 -382
  258. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/extensions.zh.md +0 -382
  259. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/feedback.md +0 -266
  260. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/feedback.zh.md +0 -266
  261. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/filesystem.md +0 -505
  262. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/filesystem.zh.md +0 -505
  263. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/goal.md +0 -277
  264. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/goal.zh.md +0 -277
  265. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/invariants.md +0 -88
  266. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/invariants.zh.md +0 -88
  267. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/jobs.md +0 -290
  268. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/jobs.zh.md +0 -290
  269. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/llm-streaming.md +0 -1080
  270. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/llm-streaming.zh.md +0 -1086
  271. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/lsp.md +0 -202
  272. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/lsp.zh.md +0 -202
  273. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/permission-presets.md +0 -131
  274. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/permission-presets.zh.md +0 -131
  275. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/persistence.md +0 -395
  276. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/persistence.zh.md +0 -395
  277. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/plan.md +0 -87
  278. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/plan.zh.md +0 -87
  279. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/sandbox.md +0 -220
  280. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/sandbox.zh.md +0 -220
  281. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/schedule.md +0 -192
  282. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/schedule.zh.md +0 -192
  283. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/scope.md +0 -59
  284. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/scope.zh.md +0 -59
  285. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/session-projection.md +0 -354
  286. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/session-projection.zh.md +0 -354
  287. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/session-query.md +0 -509
  288. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/session-query.zh.md +0 -509
  289. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/session-reference.md +0 -219
  290. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/session-reference.zh.md +0 -219
  291. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/session-telemetry.md +0 -194
  292. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/session-telemetry.zh.md +0 -194
  293. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/session-title.md +0 -204
  294. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/session-title.zh.md +0 -204
  295. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/session.md +0 -1155
  296. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/session.zh.md +0 -1159
  297. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/settings.md +0 -405
  298. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/settings.zh.md +0 -405
  299. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/shell.md +0 -303
  300. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/shell.zh.md +0 -303
  301. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/skills.md +0 -354
  302. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/skills.zh.md +0 -354
  303. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/slots.md +0 -175
  304. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/slots.zh.md +0 -175
  305. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/spill.md +0 -117
  306. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/spill.zh.md +0 -117
  307. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/storage.md +0 -260
  308. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/storage.zh.md +0 -260
  309. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/subagent.md +0 -766
  310. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/subagent.zh.md +0 -770
  311. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/subprocess.md +0 -324
  312. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/subprocess.zh.md +0 -324
  313. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/system-prompt.md +0 -220
  314. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/system-prompt.zh.md +0 -220
  315. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/terminal.md +0 -184
  316. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/terminal.zh.md +0 -184
  317. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/todo.md +0 -32
  318. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/todo.zh.md +0 -32
  319. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/token-meter.md +0 -105
  320. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/token-meter.zh.md +0 -105
  321. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/tools.md +0 -720
  322. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/tools.zh.md +0 -720
  323. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/typert.md +0 -343
  324. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/typert.zh.md +0 -343
  325. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/user-questions.md +0 -178
  326. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/user-questions.zh.md +0 -178
  327. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/web-client.md +0 -95
  328. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/web-client.zh.md +0 -95
  329. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/web-server.md +0 -154
  330. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/web-server.zh.md +0 -154
  331. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/web.md +0 -206
  332. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/web.zh.md +0 -206
  333. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/webhook.md +0 -70
  334. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/webhook.zh.md +0 -70
  335. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/workflow.md +0 -278
  336. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/workflow.zh.md +0 -278
  337. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/workspace.md +0 -321
  338. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/subsystems/workspace.zh.md +0 -321
  339. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/testing.md +0 -54
  340. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/testing.zh.md +0 -54
  341. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/tool-catalog.md +0 -2225
  342. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/tool-catalog.zh.md +0 -2233
  343. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/tool-execution-pipeline.md +0 -62
  344. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/tool-execution-pipeline.zh.md +0 -64
  345. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/develop/basic/config.md +0 -106
  346. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/develop/basic/config.zh.md +0 -106
  347. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/develop/basic/index.md +0 -144
  348. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/develop/basic/index.zh.md +0 -144
  349. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/develop/basic/publish.md +0 -183
  350. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/develop/basic/publish.zh.md +0 -183
  351. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/develop/basic/tool.md +0 -52
  352. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/develop/basic/tool.zh.md +0 -52
  353. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/develop/framework/events.md +0 -143
  354. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/develop/framework/events.zh.md +0 -143
  355. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/develop/framework/index.md +0 -137
  356. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/develop/framework/index.zh.md +0 -137
  357. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/develop/framework/service.md +0 -148
  358. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/develop/framework/service.zh.md +0 -150
  359. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/develop/practice/dynamic-cordis.md +0 -15
  360. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/develop/practice/dynamic-cordis.zh.md +0 -15
  361. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/develop/practice/index.md +0 -155
  362. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/develop/practice/index.zh.md +0 -155
  363. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/develop/practice/llm-adapter.md +0 -189
  364. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/develop/practice/llm-adapter.zh.md +0 -189
  365. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/guide/github-review.md +0 -102
  366. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/guide/github-review.zh.md +0 -102
  367. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/guide/index.md +0 -30
  368. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/guide/index.zh.md +0 -30
  369. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/guide/mcp-memory.md +0 -101
  370. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/guide/mcp-memory.zh.md +0 -101
  371. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/guide/network-proxy.md +0 -85
  372. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/guide/network-proxy.zh.md +0 -85
  373. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/guide/providers.md +0 -190
  374. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/guide/providers.zh.md +0 -190
  375. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/guide/python-sdk.md +0 -150
  376. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/guide/python-sdk.zh.md +0 -150
  377. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/guide/schedule.md +0 -21
  378. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/guide/schedule.zh.md +0 -21
  379. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/index.md +0 -11
  380. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/user/index.zh.md +0 -11
  381. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/web-styling.md +0 -29
  382. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/docs/web-styling.zh.md +0 -29
  383. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/site-pages-map.txt +0 -234
  384. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src/site-pages.json +0 -232
  385. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src-README.md +0 -63
  386. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src-scripts/crawl.py +0 -103
  387. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src-scripts/docs-tree.json +0 -82965
  388. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src-scripts/download.py +0 -56
  389. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src-scripts/gen_mapping.py +0 -125
  390. package/docs/80_upstream-docs-and-skills/dsh-dev-skill/src-scripts/pages.json +0 -232
  391. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/api-plugins.json +0 -1
  392. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/api-skills.json +0 -4
  393. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/_category_.json +0 -8
  394. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/acp-internals.md +0 -181
  395. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/adding-platform-adapters.md +0 -788
  396. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/adding-providers.md +0 -464
  397. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/adding-tools.md +0 -211
  398. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/agent-loop.md +0 -242
  399. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/architecture.md +0 -279
  400. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/billing-lifecycle.md +0 -184
  401. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/browser-provider-plugin.md +0 -153
  402. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/browser-supervisor.md +0 -198
  403. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/chronos-managed-cron-contract.md +0 -227
  404. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/cli-internals.md +0 -85
  405. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/codebase-ownership.md +0 -34
  406. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/completion-backlog-delivery.md +0 -52
  407. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/context-compression-and-caching.md +0 -642
  408. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/context-engine-plugin.md +0 -272
  409. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/contributing.md +0 -303
  410. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/creating-skills.md +0 -438
  411. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/cron-internals.md +0 -380
  412. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/desktop-plugin-sdk.md +0 -952
  413. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/egress-internals.md +0 -319
  414. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/extending-the-cli.md +0 -192
  415. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/gateway-internals.md +0 -297
  416. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/gateway-monitoring.md +0 -309
  417. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/gateway-session-lifecycle.md +0 -621
  418. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/image-gen-provider-plugin.md +0 -316
  419. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/memory-provider-plugin.md +0 -452
  420. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/micro-compaction.md +0 -406
  421. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/middleware.md +0 -266
  422. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/model-provider-plugin.md +0 -327
  423. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/multiplexing-gateway.md +0 -228
  424. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/observer-hooks.md +0 -331
  425. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/plugin-llm-access.md +0 -506
  426. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/plugins/index.md +0 -1775
  427. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/programmatic-integration.md +0 -212
  428. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/prompt-assembly.md +0 -328
  429. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/provider-runtime.md +0 -222
  430. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/relay-connector-contract.md +0 -790
  431. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/relay-shared-metrics.md +0 -487
  432. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/secret-source-plugin.md +0 -192
  433. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/session-storage.md +0 -523
  434. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/state-db-recovery.md +0 -107
  435. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/streaming-tts.md +0 -98
  436. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/subagent-lifecycle-api.md +0 -61
  437. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/terminal-environment-plugin.md +0 -140
  438. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/tools-runtime.md +0 -250
  439. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/trajectory-format.md +0 -232
  440. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/video-gen-provider-plugin.md +0 -231
  441. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/web-search-provider-plugin.md +0 -260
  442. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/developer-guide/worktree-ui-dev.md +0 -168
  443. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/getting-started/_category_.json +0 -8
  444. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/getting-started/installation.md +0 -200
  445. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/getting-started/learning-path.md +0 -169
  446. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/getting-started/nix-setup.md +0 -1234
  447. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/getting-started/platform-support.md +0 -50
  448. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/getting-started/quickstart.md +0 -399
  449. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/getting-started/termux.md +0 -301
  450. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/getting-started/updating.md +0 -374
  451. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/_category_.json +0 -6
  452. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/agent-email-address.md +0 -93
  453. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/automate-with-cron.md +0 -292
  454. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/automation-blueprints.md +0 -595
  455. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/aws-bedrock.md +0 -196
  456. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/azure-foundry.md +0 -334
  457. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/cron-script-only.md +0 -247
  458. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/cron-troubleshooting.md +0 -235
  459. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/daily-briefing-bot.md +0 -272
  460. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/delegation-patterns.md +0 -242
  461. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/desktop-native-signin.md +0 -125
  462. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/github-pr-review-agent.md +0 -303
  463. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/google-gemini.md +0 -270
  464. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/google-vertex.md +0 -148
  465. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/local-llm-on-mac.md +0 -252
  466. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/local-ollama-setup.md +0 -338
  467. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/manage-hermes-cloud-with-mcp.md +0 -176
  468. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/microsoft-graph-app-registration.md +0 -180
  469. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/migrate-from-openclaw.md +0 -252
  470. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/minimax-oauth.md +0 -226
  471. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/oauth-over-ssh.md +0 -172
  472. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/operate-teams-meeting-pipeline.md +0 -295
  473. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/pipe-script-output.md +0 -249
  474. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/python-library.md +0 -333
  475. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/run-hermes-with-nous-portal.md +0 -276
  476. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/run-nemotron-3-ultra-free.md +0 -123
  477. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/secure-hermes-on-a-work-machine.md +0 -182
  478. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/team-telegram-assistant.md +0 -441
  479. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/tips.md +0 -238
  480. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/troubleshooting-agent-quality.md +0 -145
  481. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/use-mcp-with-hermes.md +0 -541
  482. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/use-soul-with-hermes.md +0 -264
  483. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/use-voice-mode-with-hermes.md +0 -473
  484. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/webhook-github-pr-review.md +0 -336
  485. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/work-with-skills.md +0 -290
  486. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/guides/xai-grok-oauth.md +0 -243
  487. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/index.mdx +0 -155
  488. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/integrations/buzz.md +0 -57
  489. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/integrations/index.md +0 -126
  490. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/integrations/nous-portal.md +0 -286
  491. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/integrations/providers.md +0 -1681
  492. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/reference/_category_.json +0 -8
  493. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/reference/automation-blueprints-catalog.mdx +0 -36
  494. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/reference/cli-commands.md +0 -1900
  495. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/reference/cli-symbols.md +0 -126
  496. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/reference/environment-variables.md +0 -952
  497. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/reference/faq.md +0 -874
  498. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/reference/mcp-config-reference.md +0 -439
  499. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/reference/model-catalog.md +0 -121
  500. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/reference/optional-skills-catalog.md +0 -303
  501. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/reference/profile-commands.md +0 -544
  502. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/reference/skills-catalog.md +0 -132
  503. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/reference/slash-commands.md +0 -336
  504. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/reference/tools-reference.md +0 -399
  505. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/reference/toolsets-reference.md +0 -171
  506. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/_category_.json +0 -8
  507. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/bot-mode.md +0 -309
  508. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/checkpoints-and-rollback.md +0 -283
  509. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/cli.md +0 -591
  510. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/configuration.md +0 -2901
  511. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/configuring-models.md +0 -414
  512. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/desktop.md +0 -728
  513. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/docker.md +0 -896
  514. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/egress/index.md +0 -10
  515. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/egress/iron-proxy.md +0 -570
  516. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/egress/network-isolation.md +0 -201
  517. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/_category_.json +0 -8
  518. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/acp.md +0 -407
  519. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/api-server.md +0 -810
  520. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/batch-processing.md +0 -230
  521. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/browser.md +0 -901
  522. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/built-in-plugins.md +0 -366
  523. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/code-execution.md +0 -319
  524. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/codex-app-server-runtime.md +0 -460
  525. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/computer-use.md +0 -636
  526. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/context-files.md +0 -237
  527. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/context-references.md +0 -142
  528. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/credential-pools.md +0 -308
  529. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/credential-vault.md +0 -122
  530. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/cron.md +0 -1262
  531. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/curator.md +0 -409
  532. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/delegation.md +0 -664
  533. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/deliverable-mode.md +0 -134
  534. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/document-extraction.md +0 -58
  535. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/extending-the-dashboard.md +0 -927
  536. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/fallback-providers.md +0 -444
  537. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/goals.md +0 -293
  538. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/heartbeat.md +0 -68
  539. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/honcho.md +0 -276
  540. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/hooks.md +0 -2007
  541. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/image-generation.md +0 -347
  542. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/kanban-multi-gateway.md +0 -52
  543. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/kanban-tutorial.md +0 -310
  544. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/kanban-worker-lanes.md +0 -142
  545. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/kanban.md +0 -1327
  546. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/loops.md +0 -122
  547. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/lsp.md +0 -307
  548. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/mcp.md +0 -957
  549. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/memory-providers.md +0 -699
  550. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/memory.md +0 -466
  551. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/mixture-of-agents.md +0 -246
  552. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/overview.md +0 -57
  553. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/personality.md +0 -289
  554. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/pets.md +0 -236
  555. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/plugin-catalog.md +0 -212
  556. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/plugins.md +0 -847
  557. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/provider-routing.md +0 -229
  558. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/skills.md +0 -1112
  559. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/skins.md +0 -271
  560. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/spotify.md +0 -279
  561. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/subscription-proxy.md +0 -203
  562. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/tool-gateway.md +0 -223
  563. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/tool-search.md +0 -277
  564. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/tools.md +0 -261
  565. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/tts.md +0 -744
  566. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/vision.md +0 -214
  567. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/voice-mode.md +0 -608
  568. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/wake-word.md +0 -343
  569. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/web-dashboard.md +0 -1206
  570. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/web-search.md +0 -506
  571. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/features/x-search.md +0 -167
  572. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/git-worktrees.md +0 -196
  573. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/import-from-other-agents.md +0 -74
  574. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/local-models.md +0 -140
  575. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/managed-scope.md +0 -157
  576. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/_category_.json +0 -8
  577. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/a2a.md +0 -130
  578. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/bluebubbles.md +0 -171
  579. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/buzz.md +0 -162
  580. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/dingtalk.md +0 -283
  581. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/discord.md +0 -936
  582. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/email.md +0 -223
  583. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/feishu.md +0 -599
  584. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/google_chat.md +0 -430
  585. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/homeassistant.md +0 -269
  586. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/index.md +0 -859
  587. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/irc.md +0 -78
  588. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/line.md +0 -201
  589. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/matrix.md +0 -910
  590. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/mattermost.md +0 -340
  591. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/msgraph-webhook.md +0 -142
  592. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/ntfy.md +0 -157
  593. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/open-webui.md +0 -296
  594. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/photon.md +0 -255
  595. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/qqbot.md +0 -123
  596. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/raft.md +0 -70
  597. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/relay.md +0 -212
  598. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/signal.md +0 -262
  599. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/simplex.md +0 -151
  600. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/slack.md +0 -1093
  601. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/sms.md +0 -203
  602. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/teams-meetings.md +0 -242
  603. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/teams.md +0 -288
  604. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/telegram.md +0 -1373
  605. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/webhooks.md +0 -694
  606. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/wecom-callback.md +0 -179
  607. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/wecom.md +0 -306
  608. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/weixin.md +0 -333
  609. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/whatsapp-cloud.md +0 -417
  610. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/whatsapp.md +0 -283
  611. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/messaging/yuanbao.md +0 -342
  612. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/multi-connection-desktop.md +0 -361
  613. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/multi-profile-gateways.md +0 -1062
  614. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/profile-distributions.md +0 -757
  615. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/profiles.md +0 -418
  616. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/secrets/bitwarden.md +0 -155
  617. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/secrets/command.md +0 -50
  618. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/secrets/index.md +0 -50
  619. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/secrets/onepassword.md +0 -169
  620. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/security.md +0 -892
  621. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/sessions.md +0 -990
  622. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/apple/apple-apple-notes.md +0 -110
  623. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/apple/apple-apple-reminders.md +0 -146
  624. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/apple/apple-findmy.md +0 -149
  625. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/apple/apple-imessage.md +0 -118
  626. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-claude-code.md +0 -763
  627. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-codex.md +0 -169
  628. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-computer-use.md +0 -355
  629. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-hermes-agent.md +0 -230
  630. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-merge-reconciler.md +0 -176
  631. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-opencode.md +0 -237
  632. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/creative/creative-architecture-diagram.md +0 -165
  633. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/creative/creative-ascii-art.md +0 -338
  634. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/creative/creative-ascii-video.md +0 -265
  635. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/creative/creative-baoyu-infographic.md +0 -256
  636. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/creative/creative-claude-design.md +0 -668
  637. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/creative/creative-comfyui.md +0 -616
  638. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/creative/creative-design-md.md +0 -238
  639. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/creative/creative-excalidraw.md +0 -212
  640. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/creative/creative-humanizer.md +0 -663
  641. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/creative/creative-manim-video.md +0 -292
  642. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/creative/creative-p5js.md +0 -576
  643. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/creative/creative-popular-web-designs.md +0 -223
  644. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/creative/creative-pretext.md +0 -238
  645. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/creative/creative-sketch.md +0 -240
  646. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/creative/creative-songwriting-and-ai-music.md +0 -319
  647. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/devops/devops-sdlc-review.md +0 -195
  648. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/email/email-email-inbox-triage.md +0 -115
  649. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/email/email-himalaya.md +0 -319
  650. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/github/github-codebase-inspection.md +0 -132
  651. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/github/github-github-auth.md +0 -265
  652. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/github/github-github-code-review.md +0 -499
  653. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/github/github-github-issue-to-pr.md +0 -95
  654. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/github/github-github-issues.md +0 -388
  655. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/github/github-github-pr-workflow.md +0 -385
  656. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/github/github-github-repo-management.md +0 -534
  657. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/media/media-gif-search.md +0 -106
  658. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/media/media-songsee.md +0 -98
  659. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/media/media-youtube-content.md +0 -100
  660. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/mlops/mlops-evaluation-evaluating-llms-harness.md +0 -512
  661. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/mlops/mlops-evaluation-weights-and-biases.md +0 -613
  662. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/mlops/mlops-huggingface-hub.md +0 -100
  663. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/mlops/mlops-inference-llama-cpp.md +0 -267
  664. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/mlops/mlops-inference-serving-llms-vllm.md +0 -387
  665. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/note-taking/note-taking-obsidian.md +0 -85
  666. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/productivity/productivity-airtable.md +0 -243
  667. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/productivity/productivity-box.md +0 -132
  668. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/productivity/productivity-document-to-action-items.md +0 -99
  669. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/productivity/productivity-docx.md +0 -213
  670. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/productivity/productivity-google-workspace.md +0 -348
  671. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/productivity/productivity-maps.md +0 -210
  672. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/productivity/productivity-meeting-action-items.md +0 -105
  673. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/productivity/productivity-nano-pdf.md +0 -70
  674. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/productivity/productivity-notion.md +0 -463
  675. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/productivity/productivity-ocr-and-documents.md +0 -193
  676. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/productivity/productivity-pdf.md +0 -142
  677. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/productivity/productivity-powerpoint.md +0 -237
  678. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/productivity/productivity-product-price-monitor.md +0 -97
  679. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/productivity/productivity-session-librarian.md +0 -122
  680. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/productivity/productivity-teams-meeting-pipeline.md +0 -129
  681. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/productivity/productivity-weekly-review-planning.md +0 -99
  682. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/productivity/productivity-xlsx.md +0 -213
  683. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/research/research-arxiv.md +0 -300
  684. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/research/research-blocked-page-recovery.md +0 -155
  685. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/research/research-blogwatcher.md +0 -152
  686. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/research/research-competitor-news-monitor.md +0 -106
  687. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/research/research-grounded-citations.md +0 -274
  688. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/research/research-llm-wiki.md +0 -526
  689. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/research/research-research-paper-writing.md +0 -1645
  690. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/smart-home/smart-home-openhue.md +0 -127
  691. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/social-media/social-media-xurl.md +0 -450
  692. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/software-development/software-development-codebase-inspection.md +0 -132
  693. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/software-development/software-development-dogfood.md +0 -183
  694. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/software-development/software-development-github.md +0 -73
  695. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/software-development/software-development-hermes-agent-skill-authoring.md +0 -230
  696. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/software-development/software-development-inspecting-hermes-desktop-dom.md +0 -177
  697. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/software-development/software-development-node-inspect-debugger.md +0 -337
  698. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/software-development/software-development-python-debugpy.md +0 -391
  699. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/software-development/software-development-requesting-code-review.md +0 -298
  700. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/software-development/software-development-simplify-code.md +0 -288
  701. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/software-development/software-development-spike.md +0 -217
  702. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/software-development/software-development-systematic-debugging.md +0 -429
  703. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/software-development/software-development-test-driven-development.md +0 -380
  704. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/bundled/web/web-blocked-page-recovery.md +0 -155
  705. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/google-workspace.md +0 -191
  706. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/autonomous-ai-agents/autonomous-ai-agents-antigravity-cli.md +0 -259
  707. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/autonomous-ai-agents/autonomous-ai-agents-blackbox.md +0 -161
  708. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/autonomous-ai-agents/autonomous-ai-agents-dynamic-workflow.md +0 -198
  709. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/autonomous-ai-agents/autonomous-ai-agents-grok.md +0 -326
  710. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/autonomous-ai-agents/autonomous-ai-agents-honcho.md +0 -446
  711. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/autonomous-ai-agents/autonomous-ai-agents-openhands.md +0 -167
  712. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/blockchain/blockchain-evm.md +0 -227
  713. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/blockchain/blockchain-hyperliquid.md +0 -228
  714. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/blockchain/blockchain-solana.md +0 -225
  715. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/communication/communication-one-three-one-rule.md +0 -114
  716. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-ai-presenter-video.md +0 -211
  717. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-archify.md +0 -66
  718. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-ascii-art.md +0 -338
  719. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-audiocraft-audio-generation.md +0 -588
  720. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-auteur.md +0 -195
  721. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-baoyu-article-illustrator.md +0 -225
  722. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-baoyu-comic.md +0 -264
  723. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-comfyui.md +0 -616
  724. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-concept-diagrams.md +0 -379
  725. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-creative-ideation.md +0 -192
  726. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-draw-your-font.md +0 -169
  727. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-dream-loop.md +0 -297
  728. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-excalidraw.md +0 -212
  729. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-heartmula.md +0 -191
  730. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-hyperframes.md +0 -222
  731. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-impeccable.md +0 -56
  732. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-ip-as-logo.md +0 -171
  733. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-kanban-video-orchestrator.md +0 -220
  734. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-meme-generation.md +0 -147
  735. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-mono-color.md +0 -158
  736. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-pixel-art.md +0 -234
  737. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-pretext.md +0 -238
  738. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-simple-english.md +0 -362
  739. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-sketch.md +0 -240
  740. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-social-media-content-calendar.md +0 -88
  741. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-system-atlas.md +0 -105
  742. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-tldraw-offline.md +0 -294
  743. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/creative/creative-unreal-mcp.md +0 -269
  744. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/data-science/data-science-jupyter-notebook.md +0 -195
  745. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/devops/devops-actual-setup.md +0 -164
  746. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/devops/devops-docker-management.md +0 -298
  747. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/devops/devops-hermes-s6-container-supervision.md +0 -198
  748. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/devops/devops-inference-sh-cli.md +0 -173
  749. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/devops/devops-pinggy-tunnel.md +0 -326
  750. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/devops/devops-setup-wizard-generator.md +0 -133
  751. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/devops/devops-watchers.md +0 -126
  752. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/dogfood/dogfood-adversarial-ux-test.md +0 -209
  753. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/email/email-agentmail.md +0 -104
  754. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/finance/finance-3-statement-model.md +0 -451
  755. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/finance/finance-comps-analysis.md +0 -682
  756. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/finance/finance-dcf-model.md +0 -1288
  757. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/finance/finance-excel-author.md +0 -262
  758. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/finance/finance-lbo-model.md +0 -309
  759. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/finance/finance-merger-model.md +0 -162
  760. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/finance/finance-polymarket.md +0 -97
  761. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/finance/finance-pptx-author.md +0 -191
  762. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/finance/finance-stocks.md +0 -112
  763. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/gaming/gaming-minecraft-modpack-server.md +0 -209
  764. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/gaming/gaming-pokemon-player.md +0 -240
  765. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/health/health-fitness-nutrition.md +0 -259
  766. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/health/health-neuroskill-bci.md +0 -470
  767. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mcp/mcp-fastmcp.md +0 -315
  768. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mcp/mcp-mcp-oauth-remote-gateway.md +0 -389
  769. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mcp/mcp-mcporter.md +0 -138
  770. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/migration/migration-openclaw-migration.md +0 -316
  771. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-accelerate.md +0 -366
  772. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-chroma.md +0 -425
  773. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-clip.md +0 -272
  774. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-evaluation-evaluating-llms-harness.md +0 -512
  775. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-evaluation-weights-and-biases.md +0 -613
  776. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-faiss.md +0 -240
  777. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-flash-attention.md +0 -388
  778. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-guidance.md +0 -595
  779. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-huggingface-tokenizers.md +0 -535
  780. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-inference-llama-cpp.md +0 -267
  781. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-inference-outlines.md +0 -679
  782. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-inference-serving-llms-vllm.md +0 -387
  783. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-instructor.md +0 -759
  784. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-lambda-labs.md +0 -568
  785. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-llava.md +0 -323
  786. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-modal.md +0 -368
  787. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-models-huggingface-hub.md +0 -100
  788. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-models-segment-anything-model.md +0 -525
  789. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-nemo-curator.md +0 -415
  790. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-obliteratus.md +0 -360
  791. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-peft.md +0 -452
  792. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-pinecone.md +0 -396
  793. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-pytorch-fsdp.md +0 -97
  794. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-pytorch-lightning.md +0 -365
  795. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-qdrant.md +0 -522
  796. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-research-dspy.md +0 -609
  797. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-saelens.md +0 -439
  798. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-simpo.md +0 -237
  799. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-slime.md +0 -486
  800. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-stable-diffusion.md +0 -542
  801. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-tensorrt-llm.md +0 -208
  802. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-torchtitan.md +0 -404
  803. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-training-axolotl.md +0 -181
  804. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-training-trl-fine-tuning.md +0 -512
  805. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-training-unsloth.md +0 -98
  806. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/mlops/mlops-whisper.md +0 -336
  807. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/payments/payments-mpp-agent.md +0 -142
  808. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/payments/payments-stripe-link-cli.md +0 -202
  809. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/payments/payments-stripe-projects.md +0 -138
  810. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/productivity/productivity-canvas.md +0 -114
  811. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/productivity/productivity-decision-questionnaire.md +0 -133
  812. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/productivity/productivity-here-now.md +0 -231
  813. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/productivity/productivity-live-dashboard.md +0 -126
  814. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/productivity/productivity-memento-flashcards.md +0 -336
  815. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/productivity/productivity-property-listings.md +0 -121
  816. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/productivity/productivity-shop.md +0 -238
  817. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/productivity/productivity-shopify.md +0 -377
  818. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/productivity/productivity-siyuan.md +0 -305
  819. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/productivity/productivity-telephony.md +0 -435
  820. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/research/research-bioinformatics.md +0 -254
  821. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/research/research-blogwatcher.md +0 -162
  822. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/research/research-darwinian-evolver.md +0 -217
  823. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/research/research-domain-intel.md +0 -121
  824. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/research/research-drug-discovery.md +0 -237
  825. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/research/research-duckduckgo-search.md +0 -255
  826. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/research/research-gitnexus-explorer.md +0 -232
  827. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/research/research-osint-investigation.md +0 -295
  828. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/research/research-parallel-cli.md +0 -411
  829. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/research/research-pinecone-research.md +0 -125
  830. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/research/research-qmd.md +0 -459
  831. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/research/research-research-paper-writing.md +0 -1645
  832. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/research/research-rss-feeds.md +0 -114
  833. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/research/research-scrapling.md +0 -351
  834. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/research/research-searxng-search.md +0 -212
  835. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/security/security-1password.md +0 -173
  836. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/security/security-godmode.md +0 -421
  837. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/security/security-oss-forensics.md +0 -426
  838. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/security/security-sherlock.md +0 -208
  839. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/security/security-unbroker.md +0 -331
  840. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/security/security-web-pentest.md +0 -337
  841. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/smart-home/smart-home-openhue.md +0 -127
  842. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/social-media/social-media-reddit-reading.md +0 -146
  843. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/software-development/software-development-ast-grep.md +0 -307
  844. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/software-development/software-development-code-wiki.md +0 -463
  845. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/software-development/software-development-grill-me.md +0 -135
  846. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/software-development/software-development-pr-lens.md +0 -160
  847. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/software-development/software-development-rest-graphql-debug.md +0 -532
  848. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/software-development/software-development-subagent-driven-development.md +0 -370
  849. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/web-development/web-development-cloudflare-temporary-deploy.md +0 -144
  850. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/web-development/web-development-har-derived-api-client.md +0 -180
  851. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/web-development/web-development-page-agent.md +0 -207
  852. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/web-development/web-development-publish-site.md +0 -174
  853. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/web-development/web-development-scrollcraft.md +0 -257
  854. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/skills/optional/yuanbao/yuanbao-yuanbao.md +0 -127
  855. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/tui.md +0 -313
  856. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/which-file-does-what.md +0 -57
  857. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/windows-native.md +0 -326
  858. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-guide/windows-wsl-quickstart.md +0 -358
  859. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docs/user-stories.mdx +0 -10
  860. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/docusaurus.config.ts +0 -210
  861. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/acp-internals.md +0 -181
  862. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/adding-platform-adapters.md +0 -686
  863. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/adding-providers.md +0 -459
  864. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/adding-tools.md +0 -209
  865. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/agent-loop.md +0 -239
  866. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/architecture.md +0 -277
  867. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/browser-supervisor.md +0 -160
  868. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/context-compression-and-caching.md +0 -328
  869. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/context-engine-plugin.md +0 -193
  870. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/contributing.md +0 -253
  871. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/creating-skills.md +0 -375
  872. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/cron-internals.md +0 -236
  873. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/extending-the-cli.md +0 -192
  874. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/gateway-internals.md +0 -267
  875. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/image-gen-provider-plugin.md +0 -288
  876. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/memory-provider-plugin.md +0 -258
  877. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/model-provider-plugin.md +0 -267
  878. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/plugin-llm-access.md +0 -401
  879. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/plugins/index.md +0 -1156
  880. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/programmatic-integration.md +0 -126
  881. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/prompt-assembly.md +0 -273
  882. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/provider-runtime.md +0 -208
  883. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/session-storage.md +0 -420
  884. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/tools-runtime.md +0 -236
  885. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/trajectory-format.md +0 -222
  886. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/video-gen-provider-plugin.md +0 -231
  887. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/developer-guide/web-search-provider-plugin.md +0 -260
  888. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/getting-started/installation.md +0 -204
  889. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/getting-started/learning-path.md +0 -154
  890. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/getting-started/nix-setup.md +0 -975
  891. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/getting-started/quickstart.md +0 -352
  892. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/getting-started/termux.md +0 -236
  893. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/getting-started/updating.md +0 -231
  894. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/automate-with-cron.md +0 -266
  895. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/automation-blueprints.md +0 -595
  896. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/aws-bedrock.md +0 -170
  897. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/azure-foundry.md +0 -334
  898. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/cron-script-only.md +0 -247
  899. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/cron-troubleshooting.md +0 -227
  900. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/daily-briefing-bot.md +0 -268
  901. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/delegation-patterns.md +0 -239
  902. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/github-pr-review-agent.md +0 -303
  903. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/google-gemini.md +0 -254
  904. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/local-llm-on-mac.md +0 -240
  905. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/local-ollama-setup.md +0 -317
  906. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/microsoft-graph-app-registration.md +0 -180
  907. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/migrate-from-openclaw.md +0 -244
  908. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/minimax-oauth.md +0 -228
  909. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/oauth-over-ssh.md +0 -96
  910. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/operate-teams-meeting-pipeline.md +0 -288
  911. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/pipe-script-output.md +0 -217
  912. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/python-library.md +0 -333
  913. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/run-hermes-with-nous-portal.md +0 -273
  914. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/team-telegram-assistant.md +0 -441
  915. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/tips.md +0 -234
  916. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/use-mcp-with-hermes.md +0 -490
  917. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/use-soul-with-hermes.md +0 -264
  918. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/use-voice-mode-with-hermes.md +0 -469
  919. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/webhook-github-pr-review.md +0 -329
  920. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/work-with-skills.md +0 -290
  921. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/guides/xai-grok-oauth.md +0 -243
  922. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/index.mdx +0 -117
  923. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/integrations/buzz.md +0 -57
  924. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/integrations/index.md +0 -100
  925. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/integrations/nous-portal.md +0 -272
  926. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/integrations/providers.md +0 -1433
  927. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/reference/cli-commands.md +0 -1259
  928. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/reference/environment-variables.md +0 -678
  929. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/reference/faq.md +0 -859
  930. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/reference/mcp-config-reference.md +0 -250
  931. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/reference/model-catalog.md +0 -103
  932. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/reference/optional-skills-catalog.md +0 -220
  933. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/reference/profile-commands.md +0 -467
  934. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/reference/skills-catalog.md +0 -156
  935. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/reference/slash-commands.md +0 -272
  936. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/reference/tools-reference.md +0 -261
  937. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/reference/toolsets-reference.md +0 -162
  938. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/checkpoints-and-rollback.md +0 -251
  939. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/cli.md +0 -445
  940. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/configuration.md +0 -1746
  941. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/configuring-models.md +0 -239
  942. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/docker.md +0 -595
  943. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/acp.md +0 -341
  944. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/api-server.md +0 -456
  945. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/batch-processing.md +0 -229
  946. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/browser.md +0 -629
  947. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/built-in-plugins.md +0 -269
  948. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/code-execution.md +0 -240
  949. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/codex-app-server-runtime.md +0 -441
  950. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/computer-use.md +0 -144
  951. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/context-files.md +0 -218
  952. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/context-references.md +0 -142
  953. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/credential-pools.md +0 -240
  954. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/cron.md +0 -761
  955. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/curator.md +0 -248
  956. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/delegation.md +0 -355
  957. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/deliverable-mode.md +0 -91
  958. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/extending-the-dashboard.md +0 -907
  959. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/fallback-providers.md +0 -408
  960. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/goals.md +0 -180
  961. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/honcho.md +0 -233
  962. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/hooks.md +0 -1388
  963. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/image-generation.md +0 -150
  964. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/kanban-tutorial.md +0 -308
  965. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/kanban-worker-lanes.md +0 -117
  966. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/kanban.md +0 -863
  967. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/lsp.md +0 -217
  968. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/mcp.md +0 -591
  969. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/memory-providers.md +0 -570
  970. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/memory.md +0 -233
  971. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/overview.md +0 -52
  972. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/personality.md +0 -271
  973. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/plugins.md +0 -346
  974. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/provider-routing.md +0 -200
  975. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/skills.md +0 -760
  976. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/skins.md +0 -271
  977. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/spotify.md +0 -279
  978. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/subscription-proxy.md +0 -163
  979. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/tool-gateway.md +0 -187
  980. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/tools.md +0 -223
  981. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/tts.md +0 -456
  982. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/vision.md +0 -210
  983. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/voice-mode.md +0 -521
  984. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/web-dashboard.md +0 -351
  985. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/web-search.md +0 -422
  986. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/features/x-search.md +0 -147
  987. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/git-worktrees.md +0 -173
  988. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/bluebubbles.md +0 -143
  989. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/dingtalk.md +0 -283
  990. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/discord.md +0 -843
  991. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/email.md +0 -190
  992. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/feishu.md +0 -538
  993. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/google_chat.md +0 -283
  994. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/homeassistant.md +0 -252
  995. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/index.md +0 -569
  996. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/line.md +0 -199
  997. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/matrix.md +0 -677
  998. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/mattermost.md +0 -340
  999. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/msgraph-webhook.md +0 -137
  1000. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/ntfy.md +0 -155
  1001. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/open-webui.md +0 -296
  1002. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/qqbot.md +0 -123
  1003. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/signal.md +0 -257
  1004. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/simplex.md +0 -98
  1005. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/slack.md +0 -614
  1006. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/sms.md +0 -203
  1007. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/teams-meetings.md +0 -233
  1008. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/teams.md +0 -255
  1009. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/telegram.md +0 -1241
  1010. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/webhooks.md +0 -601
  1011. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/wecom-callback.md +0 -149
  1012. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/wecom.md +0 -292
  1013. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/weixin.md +0 -312
  1014. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/whatsapp.md +0 -236
  1015. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/messaging/yuanbao.md +0 -341
  1016. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/profile-distributions.md +0 -573
  1017. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/profiles.md +0 -272
  1018. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/secrets/bitwarden.md +0 -143
  1019. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/secrets/index.md +0 -9
  1020. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/security.md +0 -664
  1021. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/sessions.md +0 -609
  1022. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/apple/apple-apple-notes.md +0 -106
  1023. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/apple/apple-apple-reminders.md +0 -114
  1024. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/apple/apple-findmy.md +0 -147
  1025. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/apple/apple-imessage.md +0 -118
  1026. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/apple/apple-macos-computer-use.md +0 -175
  1027. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-claude-code.md +0 -763
  1028. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-codex.md +0 -143
  1029. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-hermes-agent.md +0 -947
  1030. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-opencode.md +0 -237
  1031. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/creative/creative-architecture-diagram.md +0 -165
  1032. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/creative/creative-ascii-art.md +0 -338
  1033. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/creative/creative-ascii-video.md +0 -261
  1034. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/creative/creative-baoyu-infographic.md +0 -256
  1035. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/creative/creative-claude-design.md +0 -609
  1036. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/creative/creative-comfyui.md +0 -547
  1037. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/creative/creative-design-md.md +0 -189
  1038. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/creative/creative-excalidraw.md +0 -210
  1039. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/creative/creative-humanizer.md +0 -594
  1040. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/creative/creative-manim-video.md +0 -289
  1041. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/creative/creative-p5js.md +0 -574
  1042. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/creative/creative-popular-web-designs.md +0 -211
  1043. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/creative/creative-pretext.md +0 -238
  1044. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/creative/creative-sketch.md +0 -238
  1045. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/creative/creative-songwriting-and-ai-music.md +0 -305
  1046. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/email/email-himalaya.md +0 -305
  1047. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/github/github-codebase-inspection.md +0 -132
  1048. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/github/github-github-auth.md +0 -265
  1049. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/github/github-github-code-review.md +0 -499
  1050. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/github/github-github-issues.md +0 -388
  1051. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/github/github-github-pr-workflow.md +0 -385
  1052. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/github/github-github-repo-management.md +0 -534
  1053. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/media/media-gif-search.md +0 -106
  1054. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/media/media-songsee.md +0 -98
  1055. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/media/media-youtube-content.md +0 -93
  1056. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/mlops/mlops-evaluation-evaluating-llms-harness.md +0 -512
  1057. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/mlops/mlops-evaluation-weights-and-biases.md +0 -609
  1058. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/mlops/mlops-huggingface-hub.md +0 -100
  1059. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/mlops/mlops-inference-llama-cpp.md +0 -267
  1060. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/mlops/mlops-inference-serving-llms-vllm.md +0 -386
  1061. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/note-taking/note-taking-obsidian.md +0 -81
  1062. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/productivity/productivity-airtable.md +0 -243
  1063. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/productivity/productivity-google-workspace.md +0 -325
  1064. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/productivity/productivity-maps.md +0 -196
  1065. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/productivity/productivity-nano-pdf.md +0 -69
  1066. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/productivity/productivity-notion.md +0 -463
  1067. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/productivity/productivity-ocr-and-documents.md +0 -190
  1068. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/productivity/productivity-powerpoint.md +0 -257
  1069. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/productivity/productivity-teams-meeting-pipeline.md +0 -127
  1070. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/research/research-arxiv.md +0 -300
  1071. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/research/research-blogwatcher.md +0 -152
  1072. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/research/research-llm-wiki.md +0 -469
  1073. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/research/research-research-paper-writing.md +0 -2395
  1074. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/smart-home/smart-home-openhue.md +0 -124
  1075. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/social-media/social-media-xurl.md +0 -428
  1076. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/software-development/software-development-dogfood.md +0 -181
  1077. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/software-development/software-development-hermes-agent-skill-authoring.md +0 -183
  1078. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/software-development/software-development-node-inspect-debugger.md +0 -337
  1079. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/software-development/software-development-python-debugpy.md +0 -391
  1080. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/software-development/software-development-requesting-code-review.md +0 -287
  1081. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/software-development/software-development-spike.md +0 -217
  1082. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/software-development/software-development-systematic-debugging.md +0 -385
  1083. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/software-development/software-development-test-driven-development.md +0 -361
  1084. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/google-workspace.md +0 -191
  1085. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/autonomous-ai-agents/autonomous-ai-agents-blackbox.md +0 -162
  1086. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/autonomous-ai-agents/autonomous-ai-agents-honcho.md +0 -446
  1087. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/blockchain/blockchain-evm.md +0 -227
  1088. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/blockchain/blockchain-hyperliquid.md +0 -210
  1089. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/blockchain/blockchain-solana.md +0 -206
  1090. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/communication/communication-one-three-one-rule.md +0 -114
  1091. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/creative/creative-audiocraft-audio-generation.md +0 -588
  1092. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/creative/creative-concept-diagrams.md +0 -379
  1093. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/creative/creative-heartmula.md +0 -189
  1094. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/creative/creative-hyperframes.md +0 -205
  1095. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/creative/creative-kanban-video-orchestrator.md +0 -173
  1096. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/creative/creative-meme-generation.md +0 -147
  1097. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/data-science/data-science-jupyter-notebook.md +0 -180
  1098. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/devops/devops-docker-management.md +0 -297
  1099. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/devops/devops-inference-sh-cli.md +0 -173
  1100. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/devops/devops-pinggy-tunnel.md +0 -327
  1101. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/devops/devops-watchers.md +0 -126
  1102. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/dogfood/dogfood-adversarial-ux-test.md +0 -209
  1103. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/email/email-agentmail.md +0 -143
  1104. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/finance/finance-3-statement-model.md +0 -451
  1105. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/finance/finance-comps-analysis.md +0 -682
  1106. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/finance/finance-dcf-model.md +0 -1288
  1107. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/finance/finance-excel-author.md +0 -262
  1108. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/finance/finance-lbo-model.md +0 -309
  1109. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/finance/finance-merger-model.md +0 -162
  1110. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/finance/finance-polymarket.md +0 -94
  1111. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/finance/finance-pptx-author.md +0 -191
  1112. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/finance/finance-stocks.md +0 -108
  1113. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/health/health-fitness-nutrition.md +0 -255
  1114. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/health/health-neuroskill-bci.md +0 -431
  1115. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mcp/mcp-fastmcp.md +0 -315
  1116. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mcp/mcp-mcporter.md +0 -138
  1117. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/migration/migration-openclaw-migration.md +0 -316
  1118. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-accelerate.md +0 -350
  1119. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-chroma.md +0 -425
  1120. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-clip.md +0 -272
  1121. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-faiss.md +0 -240
  1122. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-flash-attention.md +0 -381
  1123. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-guidance.md +0 -591
  1124. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-huggingface-tokenizers.md +0 -535
  1125. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-inference-outlines.md +0 -671
  1126. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-instructor.md +0 -759
  1127. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-lambda-labs.md +0 -568
  1128. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-llava.md +0 -323
  1129. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-modal.md +0 -362
  1130. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-models-segment-anything-model.md +0 -525
  1131. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-nemo-curator.md +0 -401
  1132. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-peft.md +0 -452
  1133. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-pinecone.md +0 -377
  1134. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-pytorch-fsdp.md +0 -145
  1135. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-pytorch-lightning.md +0 -365
  1136. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-qdrant.md +0 -514
  1137. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-saelens.md +0 -407
  1138. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-simpo.md +0 -237
  1139. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-slime.md +0 -486
  1140. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-stable-diffusion.md +0 -542
  1141. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-tensorrt-llm.md +0 -206
  1142. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-torchtitan.md +0 -378
  1143. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-training-axolotl.md +0 -181
  1144. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-training-trl-fine-tuning.md +0 -477
  1145. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-training-unsloth.md +0 -98
  1146. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/mlops/mlops-whisper.md +0 -336
  1147. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/productivity/productivity-canvas.md +0 -114
  1148. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/productivity/productivity-here-now.md +0 -231
  1149. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/productivity/productivity-memento-flashcards.md +0 -336
  1150. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/productivity/productivity-shop.md +0 -354
  1151. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/productivity/productivity-shopify.md +0 -377
  1152. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/productivity/productivity-siyuan.md +0 -305
  1153. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/productivity/productivity-telephony.md +0 -435
  1154. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/research/research-bioinformatics.md +0 -252
  1155. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/research/research-darwinian-evolver.md +0 -188
  1156. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/research/research-domain-intel.md +0 -117
  1157. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/research/research-drug-discovery.md +0 -237
  1158. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/research/research-duckduckgo-search.md +0 -255
  1159. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/research/research-gitnexus-explorer.md +0 -213
  1160. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/research/research-osint-investigation.md +0 -243
  1161. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/research/research-parallel-cli.md +0 -411
  1162. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/research/research-qmd.md +0 -435
  1163. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/research/research-scrapling.md +0 -351
  1164. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/research/research-searxng-search.md +0 -229
  1165. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/security/security-1password.md +0 -173
  1166. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/security/security-oss-forensics.md +0 -421
  1167. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/security/security-sherlock.md +0 -208
  1168. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/software-development/software-development-rest-graphql-debug.md +0 -531
  1169. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/web-development/web-development-page-agent.md +0 -207
  1170. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/yuanbao/yuanbao-yuanbao.md +0 -125
  1171. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/tui.md +0 -256
  1172. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/windows-native.md +0 -325
  1173. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/windows-wsl-quickstart.md +0 -332
  1174. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-stories.mdx +0 -10
  1175. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/llms-full.txt +0 -88833
  1176. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/llms.txt +0 -267
  1177. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/site-pages-map.txt +0 -928
  1178. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/site-pages.json +0 -4218
  1179. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src-README.md +0 -101
  1180. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src-scripts/clone_repo.sh +0 -17
  1181. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src-scripts/crawl.py +0 -82
  1182. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src-scripts/gen_mapping.py +0 -112
  1183. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src-scripts/retry-none.json +0 -305
  1184. package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src-scripts/verify_orphans.py +0 -53
@@ -1,3058 +0,0 @@
1
- <!--
2
- source: https://pi.dev/docs/latest/extensions
3
- fetched: 2026-09-06
4
- -->
5
-
6
- # Extensions
7
-
8
- > pi can create extensions. Ask it to build one for your use case.
9
-
10
- Extensions are TypeScript modules that extend pi's behavior. They can subscribe to lifecycle events, register custom tools callable by the LLM, add commands, and more.
11
-
12
- > **Placement for /reload:** Put extensions in `~/.pi/agent/extensions/` (global) or `.pi/extensions/` (project-local) for auto-discovery. Use `pi -e ./path.ts` only for quick tests. Extensions in auto-discovered locations can be hot-reloaded with `/reload`.
13
-
14
- **Key capabilities:**
15
-
16
- - **Custom tools** - Register tools the LLM can call via `pi.registerTool()`
17
- - **Event interception** - Block or modify tool calls, inject context, customize compaction
18
- - **User interaction** - Prompt users via `ctx.ui` (select, confirm, input, notify)
19
- - **Custom UI components** - Full TUI components with keyboard input via `ctx.ui.custom()` for complex interactions
20
- - **Custom commands** - Register commands like `/mycommand` via `pi.registerCommand()`
21
- - **Session persistence** - Store state that survives restarts via `pi.appendEntry()`
22
- - **Custom rendering** - Control how tool calls/results and messages appear in TUI
23
-
24
- **Example use cases:**
25
-
26
- - Permission gates (confirm before `rm -rf`, `sudo`, etc.)
27
- - Git checkpointing (stash at each turn, restore on branch)
28
- - Path protection (block writes to `.env`, `node_modules/`)
29
- - Custom compaction (summarize conversation your way)
30
- - Conversation summaries (see `summarize.ts` example)
31
- - Interactive tools (questions, wizards, custom dialogs)
32
- - Stateful tools (todo lists, connection pools)
33
- - External integrations (file watchers, webhooks, CI triggers)
34
- - Games while you wait (see `snake.ts` example)
35
-
36
- See [examples/extensions/](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/examples/extensions) for working implementations.
37
-
38
- ## Table of Contents
39
-
40
- - [Quick Start](#quick-start)
41
- - [Extension Locations](#extension-locations)
42
- - [Available Imports](#available-imports)
43
- - [Writing an Extension](#writing-an-extension)
44
- - [Extension Styles](#extension-styles)
45
- - [Events](#events)
46
- - [Lifecycle Overview](#lifecycle-overview)
47
- - [Resource Events](#resource-events)
48
- - [Session Events](#session-events)
49
- - [Agent Events](#agent-events)
50
- - [Model Events](#model-events)
51
- - [Tool Events](#tool-events)
52
- - [ExtensionContext](#extensioncontext)
53
- - [ExtensionCommandContext](#extensioncommandcontext)
54
- - [ExtensionAPI Methods](#extensionapi-methods)
55
- - [State Management](#state-management)
56
- - [Custom Tools](#custom-tools)
57
- - [Dynamic Tool Loading](#dynamic-tool-loading)
58
- - [Custom UI](#custom-ui)
59
- - [Error Handling](#error-handling)
60
- - [Mode Behavior](#mode-behavior)
61
- - [Examples Reference](#examples-reference)
62
-
63
- ## Quick Start
64
-
65
- Create `~/.pi/agent/extensions/my-extension.ts`:
66
-
67
- ```
68
- import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
69
- import { Type } from "typebox";
70
-
71
- export default function (pi: ExtensionAPI) {
72
- // React to events
73
- pi.on("session_start", async (_event, ctx) => {
74
- ctx.ui.notify("Extension loaded!", "info");
75
- });
76
-
77
- pi.on("tool_call", async (event, ctx) => {
78
- if (event.toolName === "bash" && event.input.command?.includes("rm -rf")) {
79
- const ok = await ctx.ui.confirm("Dangerous!", "Allow rm -rf?");
80
- if (!ok) return { block: true, reason: "Blocked by user" };
81
- }
82
- });
83
-
84
- // Register a custom tool
85
- pi.registerTool({
86
- name: "greet",
87
- label: "Greet",
88
- description: "Greet someone by name",
89
- parameters: Type.Object({
90
- name: Type.String({ description: "Name to greet" }),
91
- }),
92
- async execute(toolCallId, params, signal, onUpdate, ctx) {
93
- return {
94
- content: [{ type: "text", text: `Hello, ${params.name}!` }],
95
- details: {},
96
- };
97
- },
98
- });
99
-
100
- // Register a command
101
- pi.registerCommand("hello", {
102
- description: "Say hello",
103
- handler: async (args, ctx) => {
104
- ctx.ui.notify(`Hello ${args || "world"}!`, "info");
105
- },
106
- });
107
- }
108
- ```
109
-
110
- Test with `--extension` (or `-e`) flag:
111
-
112
- ```
113
- pi -e ./my-extension.ts
114
- ```
115
-
116
- ## Extension Locations
117
-
118
- > **Security:** Extensions run with your full system permissions and can execute arbitrary code. Only install from sources you trust.
119
-
120
- Extensions are auto-discovered from trusted locations. Project-local `.pi/extensions` entries load only after the project is trusted.
121
-
122
- | Location | Scope |
123
- | --- | --- |
124
- | `~/.pi/agent/extensions/*.ts` | Global (all projects) |
125
- | `~/.pi/agent/extensions/*/index.ts` | Global (subdirectory) |
126
- | `.pi/extensions/*.ts` | Project-local |
127
- | `.pi/extensions/*/index.ts` | Project-local (subdirectory) |
128
-
129
- Additional paths via `settings.json`:
130
-
131
- ```
132
- {
133
- "packages": [
134
- "npm:@foo/bar@1.0.0",
135
- "git:github.com/user/repo@v1"
136
- ],
137
- "extensions": [
138
- "/path/to/local/extension.ts",
139
- "/path/to/local/extension/dir"
140
- ]
141
- }
142
- ```
143
-
144
- To share extensions via npm or git as pi packages, see [packages.md](/docs/latest/packages).
145
-
146
- ## Available Imports
147
-
148
- | Package | Purpose |
149
- | --- | --- |
150
- | `@earendil-works/pi-coding-agent` | Extension types (`ExtensionAPI`, `ExtensionContext`, events) |
151
- | `typebox` | Schema definitions for tool parameters |
152
- | `@earendil-works/pi-ai` | AI utilities (`StringEnum` for Google-compatible enums) |
153
- | `@earendil-works/pi-tui` | TUI components for custom rendering |
154
-
155
- npm dependencies work too. Add a `package.json` next to your extension (or in a parent directory), run `npm install`, and imports from `node_modules/` are resolved automatically.
156
-
157
- For distributed pi packages installed with `pi install` (npm or git), runtime deps must be in `dependencies`. Package installation uses production installs (`npm install --omit=dev`) by default, so `devDependencies` are not available at runtime; when `npmCommand` is configured, git packages use plain `install` for compatibility with wrappers.
158
-
159
- Node.js built-ins (`node:fs`, `node:path`, etc.) are also available.
160
-
161
- ## Writing an Extension
162
-
163
- An extension exports a default factory function that receives `ExtensionAPI`. The factory can be synchronous or asynchronous:
164
-
165
- ```
166
- import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
167
-
168
- export default function (pi: ExtensionAPI) {
169
- // Subscribe to events
170
- pi.on("event_name", async (event, ctx) => {
171
- // ctx.ui for user interaction
172
- const ok = await ctx.ui.confirm("Title", "Are you sure?");
173
- ctx.ui.notify("Done!", "info");
174
- ctx.ui.setStatus("my-ext", "Processing..."); // Footer status
175
- ctx.ui.setWidget("my-ext", ["Line 1", "Line 2"]); // Widget above editor (default)
176
- });
177
-
178
- // Register tools, commands, shortcuts, flags
179
- pi.registerTool({ ... });
180
- pi.registerCommand("name", { ... });
181
- pi.registerShortcut("ctrl+x", { ... });
182
- pi.registerFlag("my-flag", { ... });
183
- }
184
- ```
185
-
186
- Extensions are loaded via [jiti](https://github.com/unjs/jiti), so TypeScript works without compilation.
187
-
188
- If the factory returns a `Promise`, pi awaits it before continuing startup. That means async initialization completes before `session_start`, before `resources_discover`, and before provider registrations queued via `pi.registerProvider()` are flushed.
189
-
190
- ### Async factory functions
191
-
192
- Use an async factory for one-time startup work such as fetching remote configuration or dynamically discovering available models.
193
-
194
- ```
195
- import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
196
-
197
- export default async function (pi: ExtensionAPI) {
198
- const response = await fetch("http://localhost:1234/v1/models");
199
- const payload = (await response.json()) as {
200
- data: Array<{
201
- id: string;
202
- name?: string;
203
- context_window?: number;
204
- max_tokens?: number;
205
- }>;
206
- };
207
-
208
- pi.registerProvider("local-openai", {
209
- baseUrl: "http://localhost:1234/v1",
210
- apiKey: "$LOCAL_OPENAI_API_KEY",
211
- api: "openai-completions",
212
- models: payload.data.map((model) => ({
213
- id: model.id,
214
- name: model.name ?? model.id,
215
- reasoning: false,
216
- input: ["text"],
217
- cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
218
- contextWindow: model.context_window ?? 128000,
219
- maxTokens: model.max_tokens ?? 4096,
220
- })),
221
- });
222
- }
223
- ```
224
-
225
- This pattern makes the fetched models available during normal startup and to `pi --list-models`.
226
-
227
- ### Long-lived resources and shutdown
228
-
229
- Extension factories may run in invocations that never start a session. Do not start background resources such as processes, sockets, file watchers, or timers from the factory.
230
-
231
- Defer background resource startup until `session_start` or the command/tool/event that needs the resource. Register an idempotent `session_shutdown` handler to close any session-scoped resources you start.
232
-
233
- ### Extension Styles
234
-
235
- **Single file** - simplest, for small extensions:
236
-
237
- ```
238
- ~/.pi/agent/extensions/
239
- └── my-extension.ts
240
- ```
241
-
242
- **Directory with index.ts** - for multi-file extensions:
243
-
244
- ```
245
- ~/.pi/agent/extensions/
246
- └── my-extension/
247
- ├── index.ts # Entry point (exports default function)
248
- ├── tools.ts # Helper module
249
- └── utils.ts # Helper module
250
- ```
251
-
252
- **Package with dependencies** - for extensions that need npm packages:
253
-
254
- ```
255
- ~/.pi/agent/extensions/
256
- └── my-extension/
257
- ├── package.json # Declares dependencies and entry points
258
- ├── package-lock.json
259
- ├── node_modules/ # After npm install
260
- └── src/
261
- └── index.ts
262
- ```
263
-
264
- ```
265
- // package.json
266
- {
267
- "name": "my-extension",
268
- "dependencies": {
269
- "zod": "^3.0.0",
270
- "chalk": "^5.0.0"
271
- },
272
- "pi": {
273
- "extensions": ["./src/index.ts"]
274
- }
275
- }
276
- ```
277
-
278
- Run `npm install` in the extension directory, then imports from `node_modules/` work automatically.
279
-
280
- ## Events
281
-
282
- ### Lifecycle Overview
283
-
284
- ```
285
- pi starts
286
- │
287
- ├─► project_trust (user/global and CLI extensions only, before project resources load)
288
- ├─► session_start { reason: "startup" }
289
- └─► resources_discover { reason: "startup" }
290
- │
291
- ▼
292
- user sends prompt ─────────────────────────────────────────┐
293
- │ │
294
- ├─► (extension commands checked first, bypass if found) │
295
- ├─► input (can intercept, transform, or handle) │
296
- ├─► (skill/template expansion if not handled) │
297
- ├─► before_agent_start (can inject message, modify system prompt)
298
- ├─► agent_start │
299
- ├─► message_start / message_update / message_end │
300
- │ │
301
- │ ┌─── turn (repeats while LLM calls tools) ───┐ │
302
- │ │ │ │
303
- │ ├─► turn_start │ │
304
- │ ├─► context (can modify messages) │ │
305
- │ ├─► before_provider_headers (can mutate headers) |
306
- │ ├─► before_provider_request (can inspect or replace payload)
307
- │ ├─► after_provider_response (status + headers, before stream consume)
308
- │ │ │ │
309
- │ │ LLM responds, may call tools: │ │
310
- │ │ ├─► tool_execution_start │ │
311
- │ │ ├─► tool_call (can block) │ │
312
- │ │ ├─► tool_execution_update │ │
313
- │ │ ├─► tool_result (can modify) │ │
314
- │ │ └─► tool_execution_end │ │
315
- │ │ │ │
316
- │ └─► turn_end │ │
317
- │ │
318
- ├─► agent_end │
319
- └─► agent_settled (no retry/compaction/follow-up left) │
320
- │
321
- user sends another prompt ◄────────────────────────────────┘
322
-
323
- /new (new session) or /resume (switch session)
324
- ├─► session_before_switch (can cancel)
325
- ├─► session_shutdown
326
- ├─► session_start { reason: "new" | "resume", previousSessionFile? }
327
- └─► resources_discover { reason: "startup" }
328
-
329
- /fork or /clone
330
- ├─► session_before_fork (can cancel)
331
- ├─► session_shutdown
332
- ├─► session_start { reason: "fork", previousSessionFile }
333
- └─► resources_discover { reason: "startup" }
334
-
335
- /name or pi.setSessionName()
336
- └─► session_info_changed
337
-
338
- /compact or auto-compaction
339
- ├─► session_before_compact (can cancel or customize)
340
- ├─► session_compact (success)
341
- └─► session_compact_failed (failure or abort)
342
-
343
- /tree navigation
344
- ├─► session_before_tree (can cancel or customize)
345
- └─► session_tree
346
-
347
- /model or Ctrl+P (model selection/cycling)
348
- ├─► thinking_level_select (if model change changes/clamps thinking level)
349
- └─► model_select
350
-
351
- thinking level changes (settings, keybinding, pi.setThinkingLevel())
352
- └─► thinking_level_select
353
-
354
- exit (Ctrl+C, Ctrl+D, SIGHUP, SIGTERM)
355
- └─► session_shutdown
356
- ```
357
-
358
- ### Startup Events
359
-
360
- #### project\_trust
361
-
362
- Fired before pi decides whether to trust a project with dynamic configs (`.pi` or `.agents/skills`). It runs during startup and when session replacement (for example `/resume`) enters a cwd whose trust has not been resolved in the current process. Only user/global extensions and CLI `-e` extensions participate; project-local extensions are not loaded until after trust is resolved.
363
-
364
- ```
365
- pi.on("project_trust", async (event, ctx) => {
366
- // event.cwd - current working directory
367
- // ctx has a limited trust context: cwd, mode, hasUI, and select/confirm/input/notify UI helpers
368
- if (await ctx.ui.confirm("Trust project?", event.cwd)) {
369
- return { trusted: "yes", remember: true };
370
- }
371
- return { trusted: "undecided" };
372
- });
373
- ```
374
-
375
- A `project_trust` handler must return `{ trusted: "yes" | "no" | "undecided" }`. A user/global or CLI extension that returns `"yes"` or `"no"` owns the decision; the first yes/no decision wins and suppresses the built-in trust prompt. Use `remember: true` to persist a yes/no decision; otherwise it applies only to the current process. Return `"undecided"` to let later handlers or the built-in trust flow decide. Check `ctx.hasUI` before prompting. If no handler returns yes/no, normal trust resolution continues: saved `trust.json` decisions apply first, then `defaultProjectTrust` controls whether pi asks, trusts, or declines by default.
376
-
377
- ### Resource Events
378
-
379
- #### resources\_discover
380
-
381
- Fired after `session_start` so extensions can contribute additional skill, prompt, and theme paths.
382
- The startup path uses `reason: "startup"`. Reload uses `reason: "reload"`.
383
-
384
- ```
385
- pi.on("resources_discover", async (event, _ctx) => {
386
- // event.cwd - current working directory
387
- // event.reason - "startup" | "reload"
388
- return {
389
- skillPaths: ["/path/to/skills"],
390
- promptPaths: ["/path/to/prompts"],
391
- themePaths: ["/path/to/themes"],
392
- };
393
- });
394
- ```
395
-
396
- ### Session Events
397
-
398
- See [Session Format](/docs/latest/session-format) for session storage internals and the SessionManager API.
399
-
400
- #### session\_start
401
-
402
- Fired when a session is started, loaded, or reloaded.
403
-
404
- ```
405
- pi.on("session_start", async (event, ctx) => {
406
- // event.reason - "startup" | "reload" | "new" | "resume" | "fork"
407
- // event.previousSessionFile - present for "new", "resume", and "fork"
408
- ctx.ui.notify(`Session: ${ctx.sessionManager.getSessionFile() ?? "ephemeral"}`, "info");
409
- });
410
- ```
411
-
412
- #### session\_info\_changed
413
-
414
- Fired when the current session display name is set via `/name`, RPC, or `pi.setSessionName()`.
415
-
416
- ```
417
- pi.on("session_info_changed", async (event, ctx) => {
418
- // event.name - current normalized name, or undefined if cleared
419
- ctx.ui.notify(`Session renamed: ${event.name ?? "(none)"}`, "info");
420
- });
421
- ```
422
-
423
- #### session\_before\_switch
424
-
425
- Fired before starting a new session (`/new`) or switching sessions (`/resume`).
426
-
427
- ```
428
- pi.on("session_before_switch", async (event, ctx) => {
429
- // event.reason - "new" or "resume"
430
- // event.targetSessionFile - session we're switching to (only for "resume")
431
-
432
- if (event.reason === "new") {
433
- const ok = await ctx.ui.confirm("Clear?", "Delete all messages?");
434
- if (!ok) return { cancel: true };
435
- }
436
- });
437
- ```
438
-
439
- After a successful switch or new-session action, pi emits `session_shutdown` for the old extension instance, reloads and rebinds extensions for the new session, then emits `session_start` with `reason: "new" | "resume"` and `previousSessionFile`.
440
- Do cleanup work in `session_shutdown`, then reestablish any in-memory state in `session_start`.
441
-
442
- #### session\_before\_fork
443
-
444
- Fired when forking via `/fork` or cloning via `/clone`.
445
-
446
- ```
447
- pi.on("session_before_fork", async (event, ctx) => {
448
- // event.entryId - ID of the selected entry
449
- // event.position - "before" for /fork, "at" for /clone
450
- return { cancel: true }; // Cancel fork/clone
451
- // OR
452
- return { skipConversationRestore: true }; // Reserved for future conversation restore control
453
- });
454
- ```
455
-
456
- After a successful fork or clone, pi emits `session_shutdown` for the old extension instance, reloads and rebinds extensions for the new session, then emits `session_start` with `reason: "fork"` and `previousSessionFile`.
457
- Do cleanup work in `session_shutdown`, then reestablish any in-memory state in `session_start`.
458
-
459
- #### session\_before\_compact / session\_compact / session\_compact\_failed
460
-
461
- Fired on compaction. See [compaction.md](/docs/latest/compaction) for details.
462
-
463
- ```
464
- pi.on("session_before_compact", async (event, ctx) => {
465
- const { preparation, branchEntries, customInstructions, reason, willRetry, signal } = event;
466
-
467
- // reason - "manual" (/compact), "threshold", or "overflow"
468
- // willRetry - whether the aborted turn is retried after compaction (overflow recovery)
469
-
470
- // Cancel:
471
- return { cancel: true };
472
-
473
- // Custom summary:
474
- return {
475
- compaction: {
476
- summary: "...",
477
- firstKeptEntryId: preparation.firstKeptEntryId,
478
- tokensBefore: preparation.tokensBefore,
479
- // usage: summaryResponse.usage, // Optional; included in session totals
480
- }
481
- };
482
- });
483
-
484
- pi.on("session_compact", async (event, ctx) => {
485
- // event.compactionEntry - the saved compaction
486
- // event.fromExtension - whether extension provided it
487
- // event.reason - "manual" (/compact), "threshold", or "overflow"
488
- // event.willRetry - whether the aborted turn is retried after compaction (overflow recovery)
489
- });
490
-
491
- pi.on("session_compact_failed", async (event, ctx) => {
492
- // event.reason - "manual" (/compact), "threshold", or "overflow"
493
- // event.errorMessage - present for non-abort failures
494
- // event.aborted - true for cancelled/aborted compactions
495
- // event.willRetry - whether the aborted turn would have retried after compaction
496
- // event.fromExtension - whether extension-provided compaction content was being used
497
- });
498
- ```
499
-
500
- #### session\_before\_tree / session\_tree
501
-
502
- Fired on `/tree` navigation. See [Sessions](/docs/latest/sessions) for tree navigation concepts.
503
-
504
- ```
505
- pi.on("session_before_tree", async (event, ctx) => {
506
- const { preparation, signal } = event;
507
- return { cancel: true };
508
- // OR provide custom summary:
509
- return {
510
- summary: {
511
- summary: "...",
512
- // usage: summaryResponse.usage, // Optional; included in session totals
513
- details: {},
514
- },
515
- };
516
- });
517
-
518
- pi.on("session_tree", async (event, ctx) => {
519
- // event.newLeafId, oldLeafId, summaryEntry, fromExtension
520
- });
521
- ```
522
-
523
- #### session\_shutdown
524
-
525
- Fired before a started session runtime is torn down. Use this to clean up resources opened from `session_start` or other session-scoped hooks.
526
-
527
- ```
528
- pi.on("session_shutdown", async (event, ctx) => {
529
- // event.reason - "quit" | "reload" | "new" | "resume" | "fork"
530
- // event.targetSessionFile - destination session for session replacement flows
531
- // Cleanup, save state, etc.
532
- });
533
- ```
534
-
535
- ### Agent Events
536
-
537
- #### before\_agent\_start
538
-
539
- Fired after user submits prompt, before agent loop. Can inject a message and/or modify the system prompt.
540
-
541
- ```
542
- pi.on("before_agent_start", async (event, ctx) => {
543
- // event.prompt - user's prompt text
544
- // event.images - attached images (if any)
545
- // event.systemPrompt - current chained system prompt for this handler
546
- // (includes changes from earlier before_agent_start handlers)
547
- // event.systemPromptOptions - structured options used to build the system prompt
548
- // .customPrompt - any custom system prompt (from --system-prompt, SYSTEM.md, or custom templates)
549
- // .selectedTools - tools currently active in the prompt
550
- // .toolSnippets - one-line descriptions for each tool
551
- // .promptGuidelines - custom guideline bullets
552
- // .appendSystemPrompt - text from --append-system-prompt flags
553
- // .cwd - working directory
554
- // .contextFiles - AGENTS.md files and other loaded context files
555
- // .skills - loaded skills
556
-
557
- return {
558
- // Inject a persistent message (stored in session, sent to LLM)
559
- message: {
560
- customType: "my-extension",
561
- content: "Additional context for the LLM",
562
- display: true,
563
- },
564
- // Replace the system prompt for this turn (chained across extensions)
565
- systemPrompt: event.systemPrompt + "\n\nExtra instructions for this turn...",
566
- };
567
- });
568
- ```
569
-
570
- The `systemPromptOptions` field gives extensions access to the same structured data Pi uses to build the system prompt. This lets you inspect what Pi has loaded — custom prompts, guidelines, tool snippets, context files, skills — without re-discovering resources or re-parsing flags. Use it when your extension needs to make deep, informed changes to the system prompt while respecting user-provided configuration.
571
-
572
- Inside `before_agent_start`, `event.systemPrompt` and `ctx.getSystemPrompt()` both reflect the chained system prompt as of the current handler. Later `before_agent_start` handlers can still modify it again.
573
-
574
- #### agent\_start / agent\_end / agent\_settled
575
-
576
- `agent_start` fires when a low-level agent run begins. `agent_end` fires when that run ends, but Pi may still auto-retry, auto-compact and retry, or continue with queued follow-up messages. Use `agent_settled` for status integrations that need to know Pi will not continue running automatically.
577
-
578
- ```
579
- pi.on("agent_start", async (_event, ctx) => {});
580
-
581
- pi.on("agent_end", async (event, ctx) => {
582
- // event.messages - messages from this low-level run
583
- });
584
-
585
- pi.on("agent_settled", async (_event, ctx) => {
586
- // ctx.isIdle() is true here unless another extension started a new run.
587
- });
588
- ```
589
-
590
- #### ui\_prompt\_start / ui\_prompt\_end
591
-
592
- Notification-only lifecycle events for blocking user-facing extension UI prompts. They fire around `ctx.ui.select()`, `ctx.ui.confirm()`, `ctx.ui.input()`, `ctx.ui.editor()`, and `ctx.ui.custom()` so host/status integrations can report "waiting for user" instead of just "running".
593
-
594
- Nested or overlapping prompts are coalesced into one outer waiting span. Handlers are invoked best-effort and are not awaited before showing or closing the prompt.
595
-
596
- ```
597
- pi.on("ui_prompt_start", async (event, ctx) => {
598
- // event.reason === "ui_prompt"
599
- // event.kind: "select" | "confirm" | "input" | "editor" | "custom"
600
- // event.title: prompt title when available
601
- });
602
-
603
- pi.on("ui_prompt_end", async (event, ctx) => {
604
- // Pi is no longer waiting on that UI prompt span.
605
- });
606
- ```
607
-
608
- #### turn\_start / turn\_end
609
-
610
- Fired for each turn (one LLM response + tool calls).
611
-
612
- ```
613
- pi.on("turn_start", async (event, ctx) => {
614
- // event.turnIndex, event.timestamp
615
- });
616
-
617
- pi.on("turn_end", async (event, ctx) => {
618
- // event.turnIndex, event.message, event.toolResults
619
- });
620
- ```
621
-
622
- #### message\_start / message\_update / message\_end
623
-
624
- Fired for message lifecycle updates.
625
-
626
- - `message_start` and `message_end` fire for user, assistant, and toolResult messages.
627
- - `message_update` fires for assistant streaming updates.
628
- - `message_end` handlers can return `{ message }` to replace the finalized message. The replacement must keep the same `role`.
629
-
630
- ```
631
- pi.on("message_start", async (event, ctx) => {
632
- // event.message
633
- });
634
-
635
- pi.on("message_update", async (event, ctx) => {
636
- // event.message
637
- // event.assistantMessageEvent (token-by-token stream event)
638
- });
639
-
640
- pi.on("message_end", async (event, ctx) => {
641
- if (event.message.role !== "assistant") return;
642
-
643
- return {
644
- message: {
645
- ...event.message,
646
- usage: {
647
- ...event.message.usage,
648
- cost: {
649
- ...event.message.usage.cost,
650
- total: 0.123,
651
- },
652
- },
653
- },
654
- };
655
- });
656
- ```
657
-
658
- #### tool\_execution\_start / tool\_execution\_update / tool\_execution\_end
659
-
660
- Fired for tool execution lifecycle updates.
661
-
662
- In parallel tool mode:
663
-
664
- - `tool_execution_start` is emitted in assistant source order during the preflight phase
665
- - `tool_execution_update` events may interleave across tools
666
- - `tool_execution_end` is emitted in tool completion order after each tool is finalized
667
- - final `toolResult` message events are still emitted later in assistant source order
668
-
669
- ```
670
- pi.on("tool_execution_start", async (event, ctx) => {
671
- // event.toolCallId, event.toolName, event.args
672
- });
673
-
674
- pi.on("tool_execution_update", async (event, ctx) => {
675
- // event.toolCallId, event.toolName, event.args, event.partialResult
676
- });
677
-
678
- pi.on("tool_execution_end", async (event, ctx) => {
679
- // event.toolCallId, event.toolName, event.result, event.isError
680
- });
681
- ```
682
-
683
- #### context
684
-
685
- Fired before each LLM call. Modify messages non-destructively. See [Session Format](/docs/latest/session-format) for message types.
686
-
687
- ```
688
- pi.on("context", async (event, ctx) => {
689
- // event.messages - deep copy, safe to modify
690
- const filtered = event.messages.filter(m => !shouldPrune(m));
691
- return { messages: filtered };
692
- });
693
- ```
694
-
695
- #### before\_provider\_headers
696
-
697
- Fired after the outgoing HTTP headers are assembled. Use it to add, override, or remove request headers.
698
-
699
- Handlers mutate `event.headers` in place. Set a key to a string to add or override it, or to `null` to delete it.
700
-
701
- ```
702
- pi.on("before_provider_headers", (event, ctx) => {
703
- // Add or override — e.g. a session id for gateway tracing/attribution
704
- event.headers["x-session-id"] = ctx.sessionManager.getSessionId();
705
-
706
- // Drop a tracking header pi adds for this call
707
- event.headers["X-OpenRouter-Title"] = null;
708
- });
709
- ```
710
-
711
- Runs once per provider request; retries reuse the same headers rather than re-firing the hook.
712
-
713
- #### before\_provider\_request
714
-
715
- Fired after the provider-specific payload is built, right before the request is sent. Handlers run in extension load order. Returning `undefined` keeps the payload unchanged. Returning any other value replaces the payload for later handlers and for the actual request.
716
-
717
- This hook can rewrite provider-level system instructions or remove them entirely. Those payload-level changes are not reflected by `ctx.getSystemPrompt()`, which reports Pi's system prompt string rather than the final serialized provider payload.
718
-
719
- ```
720
- pi.on("before_provider_request", (event, ctx) => {
721
- console.log(JSON.stringify(event.payload, null, 2));
722
-
723
- // Optional: replace payload
724
- // return { ...event.payload, temperature: 0 };
725
- });
726
- ```
727
-
728
- This is mainly useful for debugging provider serialization and cache behavior.
729
-
730
- #### after\_provider\_response
731
-
732
- Fired after an HTTP response is received and before its stream body is consumed. Handlers run in extension load order.
733
-
734
- ```
735
- pi.on("after_provider_response", (event, ctx) => {
736
- // event.status - HTTP status code
737
- // event.headers - normalized response headers
738
- if (event.status === 429) {
739
- console.log("rate limited", event.headers["retry-after"]);
740
- }
741
- });
742
- ```
743
-
744
- Header availability depends on provider and transport. Providers that abstract HTTP responses may not expose headers.
745
-
746
- ### Model Events
747
-
748
- #### model\_select
749
-
750
- Fired when the model changes via `/model` command, model cycling (`Ctrl+P`), or session restore.
751
-
752
- ```
753
- pi.on("model_select", async (event, ctx) => {
754
- // event.model - newly selected model
755
- // event.previousModel - previous model (undefined if first selection)
756
- // event.source - "set" | "cycle" | "restore"
757
-
758
- const prev = event.previousModel
759
- ? `${event.previousModel.provider}/${event.previousModel.id}`
760
- : "none";
761
- const next = `${event.model.provider}/${event.model.id}`;
762
-
763
- ctx.ui.notify(`Model changed (${event.source}): ${prev} -> ${next}`, "info");
764
- });
765
- ```
766
-
767
- Use this to update UI elements (status bars, footers) or perform model-specific initialization when the active model changes.
768
-
769
- #### thinking\_level\_select
770
-
771
- Fired when the thinking level changes. This is notification-only; handler return values are ignored.
772
-
773
- ```
774
- pi.on("thinking_level_select", async (event, ctx) => {
775
- // event.level - newly selected thinking level
776
- // event.previousLevel - previous thinking level
777
-
778
- ctx.ui.setStatus("thinking", `thinking: ${event.level}`);
779
- });
780
- ```
781
-
782
- Use this to update extension UI when `pi.setThinkingLevel()`, model changes, or built-in thinking-level controls change the active thinking level.
783
-
784
- ### Tool Events
785
-
786
- #### tool\_call
787
-
788
- Fired after `tool_execution_start`, before the tool executes. **Can block.** Use `isToolCallEventType` to narrow and get typed inputs.
789
-
790
- Before `tool_call` runs, pi waits for previously emitted Agent events to finish draining through `AgentSession`. This means `ctx.sessionManager` is up to date through the current assistant tool-calling message.
791
-
792
- In the default parallel tool execution mode, sibling tool calls from the same assistant message are preflighted sequentially, then executed concurrently. `tool_call` is not guaranteed to see sibling tool results from that same assistant message in `ctx.sessionManager`.
793
-
794
- `event.input` is mutable. Mutate it in place to patch tool arguments before execution.
795
-
796
- Behavior guarantees:
797
-
798
- - Mutations to `event.input` affect the actual tool execution
799
- - Later `tool_call` handlers see mutations made by earlier handlers
800
- - No re-validation is performed after your mutation
801
- - Return values from `tool_call` control blocking via `{ block: true, reason?: string, terminate?: boolean }`
802
- - `terminate` only applies to a blocked call; the agent stops early only when every finalized result in the batch is terminating
803
-
804
- ```
805
- import { isToolCallEventType } from "@earendil-works/pi-coding-agent";
806
-
807
- pi.on("tool_call", async (event, ctx) => {
808
- // event.toolName - "bash", "read", "write", "edit", etc.
809
- // event.toolCallId
810
- // event.input - tool parameters (mutable)
811
-
812
- // Built-in tools: no type params needed
813
- if (isToolCallEventType("bash", event)) {
814
- // event.input is { command: string; timeout?: number }
815
- event.input.command = `source ~/.profile\n${event.input.command}`;
816
-
817
- if (event.input.command.includes("rm -rf")) {
818
- return { block: true, reason: "Dangerous command", terminate: true };
819
- }
820
- }
821
-
822
- if (isToolCallEventType("read", event)) {
823
- // event.input is { path: string; offset?: number; limit?: number }
824
- console.log(`Reading: ${event.input.path}`);
825
- }
826
- });
827
- ```
828
-
829
- #### Typing custom tool input
830
-
831
- Custom tools should export their input type:
832
-
833
- ```
834
- // my-extension.ts
835
- export type MyToolInput = Static<typeof myToolSchema>;
836
- ```
837
-
838
- Use `isToolCallEventType` with explicit type parameters:
839
-
840
- ```
841
- import { isToolCallEventType } from "@earendil-works/pi-coding-agent";
842
- import type { MyToolInput } from "my-extension";
843
-
844
- pi.on("tool_call", (event) => {
845
- if (isToolCallEventType<"my_tool", MyToolInput>("my_tool", event)) {
846
- event.input.action; // typed
847
- }
848
- });
849
- ```
850
-
851
- #### tool\_result
852
-
853
- Fired after tool execution finishes and before `tool_execution_end` plus the final tool result message events are emitted. **Can modify result.**
854
-
855
- In parallel tool mode, `tool_result` and `tool_execution_end` may interleave in tool completion order, while final `toolResult` message events are still emitted later in assistant source order.
856
-
857
- `tool_result` handlers chain like middleware:
858
-
859
- - Handlers run in extension load order
860
- - Each handler sees the latest result after previous handler changes
861
- - Handlers can return partial patches (`content`, `details`, `isError`, or `usage`); omitted fields keep their current values
862
-
863
- Use `ctx.signal` for nested async work inside the handler. This lets Esc cancel model calls, `fetch()`, and other abort-aware operations started by the extension.
864
-
865
- ```
866
- import { isBashToolResult } from "@earendil-works/pi-coding-agent";
867
-
868
- pi.on("tool_result", async (event, ctx) => {
869
- // event.toolName, event.toolCallId, event.input
870
- // event.content, event.details, event.isError, event.usage
871
-
872
- if (isBashToolResult(event)) {
873
- // event.details is typed as BashToolDetails
874
- }
875
-
876
- const response = await fetch("https://example.com/summarize", {
877
- method: "POST",
878
- body: JSON.stringify({ content: event.content }),
879
- signal: ctx.signal,
880
- });
881
-
882
- // Modify result:
883
- return { content: [...], details: {...}, isError: false, usage: nestedModelUsage };
884
- });
885
- ```
886
-
887
- ### User Bash Events
888
-
889
- #### user\_bash
890
-
891
- Fired when user executes `!` or `!!` commands. **Can intercept.**
892
-
893
- ```
894
- import { createLocalBashOperations } from "@earendil-works/pi-coding-agent";
895
-
896
- pi.on("user_bash", (event, ctx) => {
897
- // event.command - the bash command
898
- // event.excludeFromContext - true if !! prefix
899
- // event.cwd - working directory
900
-
901
- // Option 1: Provide custom operations (e.g., SSH)
902
- return { operations: remoteBashOps };
903
-
904
- // Option 2: Wrap pi's built-in local bash backend
905
- const local = createLocalBashOperations();
906
- return {
907
- operations: {
908
- exec(command, cwd, options) {
909
- return local.exec(`source ~/.profile\n${command}`, cwd, options);
910
- }
911
- }
912
- };
913
-
914
- // Option 3: Full replacement - return result directly
915
- return { result: { output: "...", exitCode: 0, cancelled: false, truncated: false } };
916
- });
917
- ```
918
-
919
- ### Input Events
920
-
921
- #### input
922
-
923
- Fired when user input is received, after extension commands are checked but before skill and template expansion. The event sees the raw input text, so `/skill:foo` and `/template` are not yet expanded.
924
-
925
- **Processing order:**
926
-
927
- 1. Extension commands (`/cmd`) checked first - if found, handler runs and input event is skipped
928
- 2. `input` event fires - can intercept, transform, or handle
929
- 3. If not handled: skill commands (`/skill:name`) expanded to skill content
930
- 4. If not handled: prompt templates (`/template`) expanded to template content
931
- 5. Agent processing begins (`before_agent_start`, etc.)
932
-
933
- ```
934
- pi.on("input", async (event, ctx) => {
935
- // event.text - raw input (before skill/template expansion)
936
- // event.images - attached images, if any
937
- // event.source - "interactive" (typed), "rpc" (API), or "extension" (via sendUserMessage)
938
- // event.streamingBehavior - "steer" | "followUp" | undefined
939
- // undefined when idle, "steer" for mid-stream interrupts,
940
- // "followUp" for messages queued until the agent finishes
941
-
942
- // Transform: rewrite input before expansion
943
- if (event.text.startsWith("?quick "))
944
- return { action: "transform", text: `Respond briefly: ${event.text.slice(7)}` };
945
-
946
- // Handle: respond without LLM (extension shows its own feedback)
947
- if (event.text === "ping") {
948
- ctx.ui.notify("pong", "info");
949
- return { action: "handled" };
950
- }
951
-
952
- // Route by source: skip processing for extension-injected messages
953
- if (event.source === "extension") return { action: "continue" };
954
-
955
- // Intercept skill commands before expansion
956
- if (event.text.startsWith("/skill:")) {
957
- // Could transform, block, or let pass through
958
- }
959
-
960
- return { action: "continue" }; // Default: pass through to expansion
961
- });
962
- ```
963
-
964
- **Results:**
965
-
966
- - `continue` - pass through unchanged (default if handler returns nothing)
967
- - `transform` - modify text/images, then continue to expansion
968
- - `handled` - skip agent entirely (first handler to return this wins)
969
-
970
- Transforms chain across handlers. See [input-transform.ts](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/examples/extensions/input-transform.ts) and [input-transform-streaming.ts](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/examples/extensions/input-transform-streaming.ts) for `streamingBehavior`-aware routing.
971
-
972
- ## ExtensionContext
973
-
974
- All handlers receive `ctx: ExtensionContext`.
975
-
976
- ### ctx.ui
977
-
978
- UI methods for user interaction. See [Custom UI](#custom-ui) for full details.
979
-
980
- ### ctx.mode
981
-
982
- Current run mode: `"tui"`, `"rpc"`, `"json"`, or `"print"`. Use `ctx.mode === "tui"` to guard terminal-only features such as `custom()`, component factories, terminal input, and direct TUI rendering.
983
-
984
- ### ctx.hasUI
985
-
986
- `true` in TUI and RPC modes. `false` in print mode (`-p`) and JSON mode. Use this to guard dialog methods (`select`, `confirm`, `input`, `editor`) and fire-and-forget methods (`notify`, `setStatus`, `setWidget`, `setTitle`, `setEditorText`) that work in both TUI and RPC modes. In RPC mode, some TUI-specific methods are no-ops or return defaults (see [rpc.md](/docs/latest/rpc#extension-ui-protocol)).
987
-
988
- ### ctx.cwd
989
-
990
- Current working directory.
991
-
992
- Use `CONFIG_DIR_NAME` instead of hardcoding `.pi` when constructing project-local config paths. Rebranded distributions can use a different config directory name.
993
-
994
- ```
995
- import { CONFIG_DIR_NAME, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
996
- import { join } from "node:path";
997
-
998
- export default function (pi: ExtensionAPI) {
999
- pi.on("session_start", (_event, ctx) => {
1000
- const projectConfigPath = join(ctx.cwd, CONFIG_DIR_NAME, "my-extension.json");
1001
- // ...
1002
- });
1003
- }
1004
- ```
1005
-
1006
- ### ctx.isProjectTrusted()
1007
-
1008
- Returns whether project-local trust is active for the current session context. This includes temporary trust decisions and CLI trust overrides, not just saved decisions in the global trust store.
1009
-
1010
- Use this before reading project-local extension configuration that should only be honored for trusted projects.
1011
-
1012
- ### ctx.sessionManager
1013
-
1014
- Read-only access to session state. See [Session Format](/docs/latest/session-format) for the full SessionManager API and entry types.
1015
-
1016
- For `tool_call`, this state is synchronized through the current assistant message before handlers run. In parallel tool execution mode it is still not guaranteed to include sibling tool results from the same assistant message.
1017
-
1018
- ```
1019
- ctx.sessionManager.getEntries() // All entries
1020
- ctx.sessionManager.getBranch() // Current branch
1021
- ctx.sessionManager.buildContextEntries() // Active branch entries with compaction applied
1022
- ctx.sessionManager.getLeafId() // Current leaf entry ID
1023
- ```
1024
-
1025
- ### ctx.modelRegistry / ctx.model / ctx.thinkingLevel / ctx.scopedModels
1026
-
1027
- Access to models, providers, and resolved authentication. `ctx.modelRegistry.getProvider(id)` returns the effective pi-ai provider, while `getProviderAuth(id)` resolves its current API key, headers, base URL, and provider-scoped environment without requiring a loaded model. `ctx.model` is the active model, and `ctx.thinkingLevel` is its current effective thinking level.
1028
-
1029
- `ctx.scopedModels` is the read-only list of models scoped to the current session — the same set the `/scoped-models` command shows. It is resolved at session start from the `--models` CLI flag and the `enabledModels` setting (matched against the available catalogue with minimatch on `provider/modelId` or a bare `modelId`). It is empty when no scoping is configured, meaning every available model is usable. Each entry is `{ model, thinkingLevel? }`, where `thinkingLevel` is set only when a pattern pinned it (e.g. `anthropic/*:high`). Use it to populate a model picker that mirrors the built-in one instead of enumerating the whole catalogue via `ctx.modelRegistry.getAvailable()`.
1030
-
1031
- ### ctx.signal
1032
-
1033
- The current agent abort signal, or `undefined` when no agent turn is active.
1034
-
1035
- Use this for abort-aware nested work started by extension handlers, for example:
1036
-
1037
- - `fetch(..., { signal: ctx.signal })`
1038
- - model calls that accept `signal`
1039
- - file or process helpers that accept `AbortSignal`
1040
-
1041
- `ctx.signal` is typically defined during active turn events such as `tool_call`, `tool_result`, `message_update`, and `turn_end`.
1042
- It is usually `undefined` in idle or non-turn contexts such as session events, extension commands, and shortcuts fired while pi is idle.
1043
-
1044
- ```
1045
- pi.on("tool_result", async (event, ctx) => {
1046
- const response = await fetch("https://example.com/api", {
1047
- method: "POST",
1048
- body: JSON.stringify(event),
1049
- signal: ctx.signal,
1050
- });
1051
-
1052
- const data = await response.json();
1053
- return { details: data };
1054
- });
1055
- ```
1056
-
1057
- ### ctx.isIdle() / ctx.abort() / ctx.hasPendingMessages()
1058
-
1059
- Control flow helpers. `ctx.isIdle()` is false while Pi is processing an agent run, automatic retry, auto-compaction retry, or queued continuation.
1060
-
1061
- ### ctx.shutdown()
1062
-
1063
- Request a graceful shutdown of pi.
1064
-
1065
- - **Interactive mode:** Deferred until the agent becomes idle (after processing all queued steering and follow-up messages).
1066
- - **RPC mode:** Deferred until the next idle state (after completing the current command response, when waiting for the next command).
1067
- - **Print mode:** No-op. The process exits automatically when all prompts are processed.
1068
-
1069
- Emits `session_shutdown` event to all extensions before exiting. Available in all contexts (event handlers, tools, commands, shortcuts).
1070
-
1071
- ```
1072
- pi.on("tool_call", (event, ctx) => {
1073
- if (isFatal(event.input)) {
1074
- ctx.shutdown();
1075
- }
1076
- });
1077
- ```
1078
-
1079
- ### ctx.getContextUsage()
1080
-
1081
- Returns current context usage for the active model. Uses last assistant usage when available, then estimates tokens for trailing messages.
1082
-
1083
- ```
1084
- const usage = ctx.getContextUsage();
1085
- if (usage && usage.tokens > 100_000) {
1086
- // ...
1087
- }
1088
- ```
1089
-
1090
- ### ctx.compact()
1091
-
1092
- Trigger compaction without awaiting completion. Use `onComplete` and `onError` for follow-up actions.
1093
-
1094
- ```
1095
- ctx.compact({
1096
- customInstructions: "Focus on recent changes",
1097
- onComplete: (result) => {
1098
- ctx.ui.notify("Compaction completed", "info");
1099
- },
1100
- onError: (error) => {
1101
- ctx.ui.notify(`Compaction failed: ${error.message}`, "error");
1102
- },
1103
- });
1104
- ```
1105
-
1106
- ### ctx.getSystemPrompt()
1107
-
1108
- Returns Pi's current system prompt string.
1109
-
1110
- - During `before_agent_start`, this reflects chained system-prompt changes made so far for the current turn.
1111
- - It does not include later `context` message mutations.
1112
- - It does not include `before_provider_request` payload rewrites.
1113
- - If later-loaded extensions run after yours, they can still change what is ultimately sent.
1114
-
1115
- ```
1116
- pi.on("before_agent_start", (event, ctx) => {
1117
- const prompt = ctx.getSystemPrompt();
1118
- console.log(`System prompt length: ${prompt.length}`);
1119
- });
1120
- ```
1121
-
1122
- ## ExtensionCommandContext
1123
-
1124
- Command handlers receive `ExtensionCommandContext`, which extends `ExtensionContext` with session control methods. These are only available in commands because they can deadlock if called from event handlers.
1125
-
1126
- ### ctx.getSystemPromptOptions()
1127
-
1128
- Returns the base inputs Pi currently uses to build the system prompt.
1129
-
1130
- ```
1131
- const options = ctx.getSystemPromptOptions();
1132
- const contextPaths = options.contextFiles?.map((file) => file.path) ?? [];
1133
- ```
1134
-
1135
- This has the same shape and mutability as `before_agent_start` `event.systemPromptOptions`: custom prompt, active tools, tool snippets, prompt guidelines, appended system prompt text, cwd, loaded context files, and loaded skills. It may include full context file contents, so treat it as sensitive extension-local data and avoid exposing it through command lists, logs, or autocomplete metadata.
1136
-
1137
- This reports the current base prompt inputs. It does not include per-turn `before_agent_start` chained system-prompt changes, later `context` event message mutations, or `before_provider_request` payload rewrites.
1138
-
1139
- ### ctx.waitForIdle()
1140
-
1141
- Wait for the agent to fully settle, including automatic retries, auto-compaction retries, and queued continuations:
1142
-
1143
- ```
1144
- pi.registerCommand("my-cmd", {
1145
- handler: async (args, ctx) => {
1146
- await ctx.waitForIdle();
1147
- // Agent is now idle, safe to modify session
1148
- },
1149
- });
1150
- ```
1151
-
1152
- ### ctx.newSession(options?)
1153
-
1154
- Create a new session:
1155
-
1156
- ```
1157
- const parentSession = ctx.sessionManager.getSessionFile();
1158
- const kickoff = "Continue in the replacement session";
1159
-
1160
- const result = await ctx.newSession({
1161
- parentSession,
1162
- setup: async (sm) => {
1163
- sm.appendMessage({
1164
- role: "user",
1165
- content: [{ type: "text", text: "Context from previous session..." }],
1166
- timestamp: Date.now(),
1167
- });
1168
- },
1169
- withSession: async (ctx) => {
1170
- // Use only the replacement-session ctx here.
1171
- await ctx.sendUserMessage(kickoff);
1172
- },
1173
- });
1174
-
1175
- if (result.cancelled) {
1176
- // An extension cancelled the new session
1177
- }
1178
- ```
1179
-
1180
- Options:
1181
-
1182
- - `parentSession`: parent session file to record in the new session header
1183
- - `setup`: mutate the new session's `SessionManager` before `withSession` runs
1184
- - `withSession`: run post-switch work against a fresh replacement-session context. Do not use captured old `pi` / command `ctx`; see [Session replacement lifecycle and footguns](#session-replacement-lifecycle-and-footguns).
1185
-
1186
- ### ctx.fork(entryId, options?)
1187
-
1188
- Fork from a specific entry, creating a new session file:
1189
-
1190
- ```
1191
- const result = await ctx.fork("entry-id-123", {
1192
- withSession: async (ctx) => {
1193
- // Use only the replacement-session ctx here.
1194
- ctx.ui.notify("Now in the forked session", "info");
1195
- },
1196
- });
1197
- if (result.cancelled) {
1198
- // An extension cancelled the fork
1199
- }
1200
-
1201
- const cloneResult = await ctx.fork("entry-id-456", { position: "at" });
1202
- if (cloneResult.cancelled) {
1203
- // An extension cancelled the clone
1204
- }
1205
- ```
1206
-
1207
- Options:
1208
-
1209
- - `position`: `"before"` (default) forks before the selected user message, restoring that prompt into the editor
1210
- - `position`: `"at"` duplicates the active path through the selected entry without restoring editor text
1211
- - `withSession`: run post-switch work against a fresh replacement-session context. Do not use captured old `pi` / command `ctx`; see [Session replacement lifecycle and footguns](#session-replacement-lifecycle-and-footguns).
1212
-
1213
- ### ctx.navigateTree(targetId, options?)
1214
-
1215
- Navigate to a different point in the session tree:
1216
-
1217
- ```
1218
- const result = await ctx.navigateTree("entry-id-456", {
1219
- summarize: true,
1220
- customInstructions: "Focus on error handling changes",
1221
- replaceInstructions: false, // true = replace default prompt entirely
1222
- label: "review-checkpoint",
1223
- });
1224
- ```
1225
-
1226
- Options:
1227
-
1228
- - `summarize`: Whether to generate a summary of the abandoned branch
1229
- - `customInstructions`: Custom instructions for the summarizer
1230
- - `replaceInstructions`: If true, `customInstructions` replaces the default prompt instead of being appended
1231
- - `label`: Label to attach to the branch summary entry (or target entry if not summarizing)
1232
-
1233
- ### ctx.switchSession(sessionPath, options?)
1234
-
1235
- Switch to a different session file:
1236
-
1237
- ```
1238
- const result = await ctx.switchSession("/path/to/session.jsonl", {
1239
- withSession: async (ctx) => {
1240
- await ctx.sendUserMessage("Resume work in the replacement session");
1241
- },
1242
- });
1243
- if (result.cancelled) {
1244
- // An extension cancelled the switch via session_before_switch
1245
- }
1246
- ```
1247
-
1248
- Options:
1249
-
1250
- - `withSession`: run post-switch work against a fresh replacement-session context. Do not use captured old `pi` / command `ctx`; see [Session replacement lifecycle and footguns](#session-replacement-lifecycle-and-footguns).
1251
-
1252
- To discover available sessions, use the static `SessionManager.list()` or `SessionManager.listAll()` methods:
1253
-
1254
- ```
1255
- import { SessionManager } from "@earendil-works/pi-coding-agent";
1256
-
1257
- pi.registerCommand("switch", {
1258
- description: "Switch to another session",
1259
- handler: async (args, ctx) => {
1260
- const sessions = await SessionManager.list(ctx.cwd);
1261
- if (sessions.length === 0) return;
1262
- const choice = await ctx.ui.select(
1263
- "Pick session:",
1264
- sessions.map(s => s.file),
1265
- );
1266
- if (choice) {
1267
- await ctx.switchSession(choice, {
1268
- withSession: async (ctx) => {
1269
- ctx.ui.notify("Switched session", "info");
1270
- },
1271
- });
1272
- }
1273
- },
1274
- });
1275
- ```
1276
-
1277
- ### Session replacement lifecycle and footguns
1278
-
1279
- `withSession` receives a fresh `ReplacedSessionContext`, which extends `ExtensionCommandContext` with async `sendMessage()` and `sendUserMessage()` helpers bound to the replacement session.
1280
-
1281
- Lifecycle and footguns:
1282
-
1283
- - `withSession` runs only after the old session has emitted `session_shutdown`, the old runtime has been torn down, the replacement session has been rebound, and the new extension instance has already received `session_start`.
1284
- - The callback still executes in the original closure, not inside the new extension instance. That means your old extension instance may already have run its shutdown cleanup before `withSession` starts.
1285
- - Captured old `pi` / old command `ctx` session-bound objects are stale after replacement and will throw if used. Use only the `ctx` passed to `withSession` for session-bound work.
1286
- - Previously extracted raw objects are still your responsibility. For example, if you capture `const sm = ctx.sessionManager` before replacement, `sm` is still the old `SessionManager` object. Do not reuse it after replacement.
1287
- - Code in `withSession` should assume any state invalidated by your `session_shutdown` handler is already gone. Only capture plain data that survives shutdown cleanly, such as strings, ids, and serialized config.
1288
-
1289
- Safe pattern:
1290
-
1291
- ```
1292
- pi.registerCommand("handoff", {
1293
- handler: async (_args, ctx) => {
1294
- const kickoff = "Continue from the replacement session";
1295
- await ctx.newSession({
1296
- withSession: async (ctx) => {
1297
- await ctx.sendUserMessage(kickoff);
1298
- },
1299
- });
1300
- },
1301
- });
1302
- ```
1303
-
1304
- Unsafe pattern:
1305
-
1306
- ```
1307
- pi.registerCommand("handoff", {
1308
- handler: async (_args, ctx) => {
1309
- const oldSessionManager = ctx.sessionManager;
1310
- await ctx.newSession({
1311
- withSession: async (_ctx) => {
1312
- // stale old objects: do not do this
1313
- oldSessionManager.getSessionFile();
1314
- pi.sendUserMessage("wrong");
1315
- },
1316
- });
1317
- },
1318
- });
1319
- ```
1320
-
1321
- ### ctx.reload()
1322
-
1323
- Run the same reload flow as `/reload`.
1324
-
1325
- ```
1326
- pi.registerCommand("reload-runtime", {
1327
- description: "Reload extensions, skills, prompts, themes, and context files",
1328
- handler: async (_args, ctx) => {
1329
- await ctx.reload();
1330
- return;
1331
- },
1332
- });
1333
- ```
1334
-
1335
- Important behavior:
1336
-
1337
- - `await ctx.reload()` emits `session_shutdown` for the current extension runtime
1338
- - It then reloads resources and emits `session_start` with `reason: "reload"` and `resources_discover` with reason `"reload"`
1339
- - The currently running command handler still continues in the old call frame
1340
- - Code after `await ctx.reload()` still runs from the pre-reload version
1341
- - Code after `await ctx.reload()` must not assume old in-memory extension state is still valid
1342
- - After the handler returns, future commands/events/tool calls use the new extension version
1343
-
1344
- For predictable behavior, treat reload as terminal for that handler (`await ctx.reload(); return;`).
1345
-
1346
- Tools run with `ExtensionContext`, so they cannot call `ctx.reload()` directly. Use a command as the reload entrypoint, then expose a tool that queues that command as a follow-up user message.
1347
-
1348
- Example tool the LLM can call to trigger reload:
1349
-
1350
- ```
1351
- import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
1352
- import { Type } from "typebox";
1353
-
1354
- export default function (pi: ExtensionAPI) {
1355
- pi.registerCommand("reload-runtime", {
1356
- description: "Reload extensions, skills, prompts, themes, and context files",
1357
- handler: async (_args, ctx) => {
1358
- await ctx.reload();
1359
- return;
1360
- },
1361
- });
1362
-
1363
- pi.registerTool({
1364
- name: "reload_runtime",
1365
- label: "Reload Runtime",
1366
- description: "Reload extensions, skills, prompts, themes, and context files",
1367
- parameters: Type.Object({}),
1368
- async execute() {
1369
- pi.sendUserMessage("/reload-runtime", { deliverAs: "followUp" });
1370
- return {
1371
- content: [{ type: "text", text: "Queued /reload-runtime as a follow-up command." }],
1372
- };
1373
- },
1374
- });
1375
- }
1376
- ```
1377
-
1378
- ## ExtensionAPI Methods
1379
-
1380
- ### pi.on(event, handler)
1381
-
1382
- Subscribe to events. See [Events](#events) for event types and return values.
1383
-
1384
- ### pi.registerTool(definition)
1385
-
1386
- Register a custom tool callable by the LLM. See [Custom Tools](#custom-tools) for full details.
1387
-
1388
- `pi.registerTool()` works both during extension load and after startup. You can call it inside `session_start`, command handlers, or other event handlers. New tools are refreshed immediately in the same session, so they appear in `pi.getAllTools()` and are callable by the LLM without `/reload`.
1389
-
1390
- Use `pi.setActiveTools()` to enable or disable tools (including dynamically added tools) at runtime.
1391
-
1392
- Use `promptSnippet` to opt a custom tool into a one-line entry in `Available tools`, and `promptGuidelines` to append tool-specific bullets to the default `Guidelines` section when the tool is active.
1393
-
1394
- **Important:** `promptGuidelines` bullets are appended flat to the `Guidelines` section with no tool name prefix. Each guideline must name the tool it refers to — avoid "Use this tool when..." because the LLM cannot tell which tool "this" means. Write "Use my\_tool when..." instead.
1395
-
1396
- See [dynamic-tools.ts](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/examples/extensions/dynamic-tools.ts) for a full example.
1397
-
1398
- ```
1399
- import { Type } from "typebox";
1400
- import { StringEnum } from "@earendil-works/pi-ai";
1401
-
1402
- pi.registerTool({
1403
- name: "my_tool",
1404
- label: "My Tool",
1405
- description: "What this tool does",
1406
- promptSnippet: "Summarize or transform text according to action",
1407
- promptGuidelines: ["Use my_tool when the user asks to summarize previously generated text."],
1408
- parameters: Type.Object({
1409
- action: StringEnum(["list", "add"] as const),
1410
- text: Type.Optional(Type.String()),
1411
- }),
1412
- prepareArguments(args) {
1413
- // Optional compatibility shim. Runs before schema validation.
1414
- // Return the current schema shape, for example to fold legacy fields
1415
- // into the modern parameter object.
1416
- return args;
1417
- },
1418
-
1419
- async execute(toolCallId, params, signal, onUpdate, ctx) {
1420
- // Stream progress
1421
- onUpdate?.({ content: [{ type: "text", text: "Working..." }] });
1422
-
1423
- return {
1424
- content: [{ type: "text", text: "Done" }],
1425
- details: { result: "..." },
1426
- };
1427
- },
1428
-
1429
- // Optional: Custom rendering
1430
- renderCall(args, theme, context) { ... },
1431
- renderResult(result, options, theme, context) { ... },
1432
- });
1433
- ```
1434
-
1435
- ### pi.sendMessage(message, options?)
1436
-
1437
- Inject a custom message into the session. Custom messages participate in LLM context. For durable TUI-only content that should not be sent to the LLM, use [`pi.appendEntry()`](#piappendentrycustomtype-data) with [`pi.registerEntryRenderer()`](#piregisterentryrenderercustomtype-renderer).
1438
-
1439
- ```
1440
- pi.sendMessage({
1441
- customType: "my-extension",
1442
- content: "Message text",
1443
- display: true,
1444
- details: { ... },
1445
- }, {
1446
- triggerTurn: true,
1447
- deliverAs: "steer",
1448
- });
1449
- ```
1450
-
1451
- **Options:**
1452
-
1453
- - `deliverAs` - Delivery mode:
1454
- - `"steer"` (default) - Queues the message while streaming. Delivered after the current assistant turn finishes executing its tool calls, before the next LLM call.
1455
- - `"followUp"` - Waits for agent to finish. Delivered only when agent has no more tool calls.
1456
- - `"nextTurn"` - Queued for next user prompt. Does not interrupt or trigger anything.
1457
- - `triggerTurn: true` - If agent is idle, trigger an LLM response immediately. Only applies to `"steer"` and `"followUp"` modes (ignored for `"nextTurn"`).
1458
-
1459
- ### pi.sendUserMessage(content, options?)
1460
-
1461
- Send a user message to the agent. Unlike `sendMessage()` which sends custom messages, this sends an actual user message that appears as if typed by the user. Always triggers a turn.
1462
-
1463
- ```
1464
- // Simple text message
1465
- pi.sendUserMessage("What is 2+2?");
1466
-
1467
- // With content array (text + images)
1468
- pi.sendUserMessage([
1469
- { type: "text", text: "Describe this image:" },
1470
- { type: "image", source: { type: "base64", mediaType: "image/png", data: "..." } },
1471
- ]);
1472
-
1473
- // During streaming - must specify delivery mode
1474
- pi.sendUserMessage("Focus on error handling", { deliverAs: "steer" });
1475
- pi.sendUserMessage("And then summarize", { deliverAs: "followUp" });
1476
-
1477
- // Opt in to extension command dispatch and skill/prompt template expansion
1478
- pi.sendUserMessage("/review src/index.ts", { expandPromptTemplates: true });
1479
- ```
1480
-
1481
- **Options:**
1482
-
1483
- - `deliverAs` - Required when agent is streaming:
1484
- - `"steer"` - Queues the message for delivery after the current assistant turn finishes executing its tool calls
1485
- - `"followUp"` - Waits for agent to finish all tools
1486
- - `expandPromptTemplates` - Dispatch extension commands and expand skill commands and prompt templates. Defaults to `false`.
1487
-
1488
- When not streaming, the message is sent immediately and triggers a new turn. When streaming without `deliverAs`, throws an error.
1489
-
1490
- See [send-user-message.ts](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/examples/extensions/send-user-message.ts) for a complete example.
1491
-
1492
- ### pi.appendEntry(customType, data?)
1493
-
1494
- Persist extension data. Custom entries do NOT participate in LLM context. In interactive mode, they can also render inside the chat transcript when paired with `pi.registerEntryRenderer()`.
1495
-
1496
- ```
1497
- pi.appendEntry("my-state", { count: 42 });
1498
- pi.appendEntry("status-card", { title: "Indexed files", count: 17 });
1499
-
1500
- // Restore on reload
1501
- pi.on("session_start", async (_event, ctx) => {
1502
- for (const entry of ctx.sessionManager.getEntries()) {
1503
- if (entry.type === "custom" && entry.customType === "my-state") {
1504
- // Reconstruct from entry.data
1505
- }
1506
- }
1507
- });
1508
- ```
1509
-
1510
- ### pi.setSessionName(name)
1511
-
1512
- Set the session display name (shown in session selector instead of first message).
1513
-
1514
- ```
1515
- pi.setSessionName("Refactor auth module");
1516
- ```
1517
-
1518
- ### pi.getSessionName()
1519
-
1520
- Get the current session name, if set.
1521
-
1522
- ```
1523
- const name = pi.getSessionName();
1524
- if (name) {
1525
- console.log(`Session: ${name}`);
1526
- }
1527
- ```
1528
-
1529
- ### pi.setLabel(entryId, label)
1530
-
1531
- Set or clear a label on an entry. Labels are user-defined markers for bookmarking and navigation (shown in `/tree` selector).
1532
-
1533
- ```
1534
- // Set a label
1535
- pi.setLabel(entryId, "checkpoint-before-refactor");
1536
-
1537
- // Clear a label
1538
- pi.setLabel(entryId, undefined);
1539
-
1540
- // Read labels via sessionManager
1541
- const label = ctx.sessionManager.getLabel(entryId);
1542
- ```
1543
-
1544
- Labels persist in the session and survive restarts. Use them to mark important points (turns, checkpoints) in the conversation tree.
1545
-
1546
- ### pi.registerCommand(name, options)
1547
-
1548
- Register a command.
1549
-
1550
- If multiple extensions register the same command name, pi keeps them all and assigns numeric invocation suffixes in load order, for example `/review:1` and `/review:2`.
1551
-
1552
- ```
1553
- pi.registerCommand("stats", {
1554
- description: "Show session statistics",
1555
- handler: async (args, ctx) => {
1556
- const count = ctx.sessionManager.getEntries().length;
1557
- ctx.ui.notify(`${count} entries`, "info");
1558
- }
1559
- });
1560
- ```
1561
-
1562
- Optional: add argument auto-completion for `/command ...`:
1563
-
1564
- ```
1565
- import type { AutocompleteItem } from "@earendil-works/pi-tui";
1566
-
1567
- pi.registerCommand("deploy", {
1568
- description: "Deploy to an environment",
1569
- getArgumentCompletions: (prefix: string): AutocompleteItem[] | null => {
1570
- const envs = ["dev", "staging", "prod"];
1571
- const items = envs.map((e) => ({ value: e, label: e }));
1572
- const filtered = items.filter((i) => i.value.startsWith(prefix));
1573
- return filtered.length > 0 ? filtered : null;
1574
- },
1575
- handler: async (args, ctx) => {
1576
- ctx.ui.notify(`Deploying: ${args}`, "info");
1577
- },
1578
- });
1579
- ```
1580
-
1581
- ### pi.getCommands()
1582
-
1583
- Get the slash commands available for invocation via `prompt` in the current session. Includes extension commands, prompt templates, and skill commands.
1584
- The list matches the RPC `get_commands` ordering: extensions first, then templates, then skills.
1585
-
1586
- ```
1587
- const commands = pi.getCommands();
1588
- const bySource = commands.filter((command) => command.source === "extension");
1589
- const userScoped = commands.filter((command) => command.sourceInfo.scope === "user");
1590
- ```
1591
-
1592
- Each entry has this shape:
1593
-
1594
- ```
1595
- {
1596
- name: string; // Invokable command name without the leading slash. May be suffixed like "review:1"
1597
- description?: string;
1598
- source: "extension" | "prompt" | "skill";
1599
- sourceInfo: {
1600
- path: string;
1601
- source: string;
1602
- scope: "user" | "project" | "temporary";
1603
- origin: "package" | "top-level";
1604
- baseDir?: string;
1605
- };
1606
- }
1607
- ```
1608
-
1609
- Use `sourceInfo` as the canonical provenance field. Do not infer ownership from command names or from ad hoc path parsing.
1610
-
1611
- Built-in interactive commands (like `/model` and `/settings`) are not included here. They are handled only in interactive
1612
- mode and would not execute if sent via `prompt`.
1613
-
1614
- ### pi.registerMessageRenderer(customType, renderer)
1615
-
1616
- Register a custom TUI renderer for custom messages with your `customType`. Custom messages are created with `pi.sendMessage()` and participate in LLM context. See [Custom UI](#custom-ui).
1617
-
1618
- ### pi.registerMarkdownTransformer(transformer)
1619
-
1620
- Register a transformer for the Markdown in normal user text, assistant text, and thinking blocks. Transformers run in extension load order, and each transformer receives the Markdown returned by the previous transformer. After the chain finishes, Pi renders the transformed content with its built-in renderer.
1621
-
1622
- The transformer receives the Markdown string and a context with:
1623
-
1624
- - `messageType` — `"user"`, `"assistant"`, or `"assistant-thinking"`
1625
- - `isStreaming` — `true` for partial assistant updates; `false` for user, finalized assistant, and restored messages
1626
- - `availableWidth` — exact terminal columns available for the transformed Markdown content
1627
-
1628
- Return the transformed Markdown:
1629
-
1630
- ```
1631
- pi.registerMarkdownTransformer((markdown, { messageType, isStreaming }) => {
1632
- if (isStreaming || messageType === "assistant-thinking") return markdown;
1633
- return markdown.replaceAll("-->", "→");
1634
- });
1635
- ```
1636
-
1637
- If a transformer throws, Pi keeps the Markdown produced so far and continues with the next transformer. The hook is display-only: the original message remains unchanged in the session and model context. It runs for new user messages, assistant streaming updates, restored session messages, and terminal width changes, so transformers should remain synchronous and inexpensive.
1638
-
1639
- ### pi.registerEntryRenderer(customType, renderer)
1640
-
1641
- Register a custom TUI renderer for custom entries with your `customType`. Custom entries are created with `pi.appendEntry()` and do not participate in LLM context.
1642
-
1643
- ```
1644
- import { Box, Text } from "@earendil-works/pi-tui";
1645
-
1646
- pi.registerEntryRenderer("status-card", (entry, { expanded }, theme) => {
1647
- const data = entry.data as { title: string; count: number };
1648
- const box = new Box(1, 1, (text) => theme.bg("customMessageBg", text));
1649
- box.addChild(new Text(`${theme.bold(data.title)}: ${data.count}`));
1650
- if (expanded) {
1651
- box.addChild(new Text(theme.fg("dim", JSON.stringify(data, null, 2))));
1652
- }
1653
- return box;
1654
- });
1655
-
1656
- pi.appendEntry("status-card", { title: "Indexed files", count: 17 });
1657
- ```
1658
-
1659
- ### pi.registerShortcut(shortcut, options)
1660
-
1661
- Register a keyboard shortcut. See [keybindings.md](/docs/latest/keybindings) for the shortcut format and built-in keybindings.
1662
-
1663
- ```
1664
- pi.registerShortcut("ctrl+shift+p", {
1665
- description: "Toggle plan mode",
1666
- handler: async (ctx) => {
1667
- ctx.ui.notify("Toggled!");
1668
- },
1669
- });
1670
- ```
1671
-
1672
- ### pi.registerFlag(name, options)
1673
-
1674
- Register a CLI flag.
1675
-
1676
- ```
1677
- pi.registerFlag("plan", {
1678
- description: "Start in plan mode",
1679
- type: "boolean",
1680
- default: false,
1681
- });
1682
-
1683
- // Check value
1684
- if (pi.getFlag("plan")) {
1685
- // Plan mode enabled
1686
- }
1687
- ```
1688
-
1689
- ### pi.exec(command, args, options?)
1690
-
1691
- Execute a shell command.
1692
-
1693
- ```
1694
- const result = await pi.exec("git", ["status"], { signal, timeout: 5000 });
1695
- // result.stdout, result.stderr, result.code, result.killed
1696
- ```
1697
-
1698
- ### pi.getActiveTools() / pi.getAllTools() / pi.setActiveTools(names)
1699
-
1700
- Manage active tools. This works for both built-in tools and dynamically registered tools. `pi.getActiveTools()` returns the active tool names as `string[]`; `pi.getAllTools()` returns metadata for all configured tools.
1701
-
1702
- ```
1703
- const active = pi.getActiveTools(); // ["read", "bash", ...]
1704
- const all = pi.getAllTools();
1705
- // all = [{
1706
- // name: "read",
1707
- // description: "Read file contents...",
1708
- // parameters: ...,
1709
- // promptGuidelines: ["Use read to examine files instead of cat or sed."],
1710
- // sourceInfo: { path: "<builtin:read>", source: "builtin", scope: "temporary", origin: "top-level" }
1711
- // }, ...]
1712
- const builtinTools = all.filter((t) => t.sourceInfo.source === "builtin");
1713
- const extensionTools = all.filter((t) => t.sourceInfo.source !== "builtin" && t.sourceInfo.source !== "sdk");
1714
- pi.setActiveTools([...new Set([...active, "my_custom_tool"])]); // Keep current tools and enable my_custom_tool
1715
- pi.setActiveTools(["read", "bash"]); // Switch to read-only
1716
- ```
1717
-
1718
- `pi.getAllTools()` returns `name`, `description`, `parameters`, `promptGuidelines`, and `sourceInfo`.
1719
-
1720
- Typical `sourceInfo.source` values:
1721
-
1722
- - `builtin` for built-in tools
1723
- - `sdk` for tools passed via `createAgentSession({ customTools })`
1724
- - extension source metadata for tools registered by extensions
1725
-
1726
- ### pi.setModel(model)
1727
-
1728
- Set the model for the current session. The change is recorded in session history and restored when that session is resumed, but it does not change the configured `defaultProvider` or `defaultModel` used by new sessions. Returns `false` if authentication is not configured for the model's provider. See [models.md](/docs/latest/models) for configuring custom models.
1729
-
1730
- ```
1731
- const model = ctx.modelRegistry.find("anthropic", "claude-sonnet-4-5");
1732
- if (model) {
1733
- const success = await pi.setModel(model);
1734
- if (!success) {
1735
- ctx.ui.notify("No API key for this model", "error");
1736
- }
1737
- }
1738
- ```
1739
-
1740
- ### pi.getThinkingLevel() / pi.setThinkingLevel(level)
1741
-
1742
- Get the current thinking level. Level is clamped to model capabilities (non-reasoning models always use "off"). Changes emit `thinking_level_select`.
1743
-
1744
- `pi.setThinkingLevel()` changes the thinking level for the current session. The change is recorded in session history and restored when that session is resumed, but it does not change the configured default used by new sessions.
1745
-
1746
- ```
1747
- const current = pi.getThinkingLevel(); // "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max"
1748
- pi.setThinkingLevel("high");
1749
- ```
1750
-
1751
- ### pi.events
1752
-
1753
- Shared event bus for communication between extensions:
1754
-
1755
- ```
1756
- pi.events.on("my:event", (data) => { ... });
1757
- pi.events.emit("my:event", { ... });
1758
- ```
1759
-
1760
- ### pi.registerProvider(name, config)
1761
-
1762
- Register or override a model provider dynamically. Useful for proxies, custom endpoints, or team-wide model configurations.
1763
-
1764
- Calls made during the extension factory function are queued and applied once the runner initialises. Calls made after that — for example from a command handler following a user setup flow — take effect immediately without requiring a `/reload`.
1765
-
1766
- Dynamic providers can implement `refreshModels`. Pi calls it during model refresh, publishes the returned list synchronously through the provider, and passes the canonical credential/stored-catalog/network/signal context. The extension decides whether to persist catalog metadata through generation-checked `context.publish({ persist: entry })`; live servers such as llama.cpp can return models without persisting them.
1767
-
1768
- `context.signal` is always a concrete signal and provider callbacks must pass it to blocking I/O. Public `ModelRuntime.refresh()` and `ModelRegistry.refresh()` calls accept an optional signal and are unbounded when it is omitted; extensions and applications choose their own deadlines. Cancellation stops the caller waiting even if a provider ignores the signal, but cooperation is still required to stop the underlying work.
1769
-
1770
- Extensions that need native provider auth, filtering, refresh, or stream behavior can register a complete `Provider` from `@earendil-works/pi-ai`. The provider becomes the composition base and `models.json` overrides still apply above it.
1771
-
1772
- ```
1773
- import { createProvider, openAICompletionsApi } from "@earendil-works/pi-ai";
1774
-
1775
- const provider = createProvider({
1776
- id: "local-server",
1777
- name: "Local Server",
1778
- baseUrl: "http://localhost:8080/v1",
1779
- auth: {
1780
- apiKey: {
1781
- name: "Local server setup",
1782
- async login(interaction) {
1783
- return {
1784
- type: "api_key",
1785
- key: await interaction.prompt({ type: "secret", message: "API key" }),
1786
- };
1787
- },
1788
- async resolve({ credential }) {
1789
- return credential?.key
1790
- ? { auth: { apiKey: credential.key }, source: "stored API key" }
1791
- : undefined;
1792
- },
1793
- },
1794
- },
1795
- models: [],
1796
- api: openAICompletionsApi(),
1797
- });
1798
-
1799
- pi.registerProvider(provider);
1800
-
1801
- // Register a new provider with custom models
1802
- pi.registerProvider("my-proxy", {
1803
- name: "My Proxy",
1804
- baseUrl: "https://proxy.example.com",
1805
- apiKey: "$PROXY_API_KEY", // env var reference
1806
- api: "anthropic-messages",
1807
- models: [
1808
- {
1809
- id: "claude-sonnet-4-20250514",
1810
- name: "Claude 4 Sonnet (proxy)",
1811
- reasoning: false,
1812
- input: ["text", "image"],
1813
- cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
1814
- contextWindow: 200000,
1815
- maxTokens: 16384
1816
- }
1817
- ]
1818
- });
1819
-
1820
- // Register a live llama.cpp catalog without persisting discovered models
1821
- pi.registerProvider("llama.cpp", {
1822
- baseUrl: "http://localhost:8080/v1",
1823
- apiKey: "local",
1824
- api: "openai-completions",
1825
- async refreshModels({ signal }) {
1826
- const response = await fetch("http://localhost:8080/v1/models", { signal });
1827
- const { data } = await response.json();
1828
- return data.map(({ id }) => ({
1829
- id,
1830
- name: id,
1831
- reasoning: false,
1832
- input: ["text"],
1833
- cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
1834
- contextWindow: 128000,
1835
- maxTokens: 16384
1836
- }));
1837
- }
1838
- });
1839
-
1840
- // Override baseUrl for an existing provider (keeps all models)
1841
- pi.registerProvider("anthropic", {
1842
- baseUrl: "https://proxy.example.com"
1843
- });
1844
-
1845
- // Register provider with OAuth support for /login
1846
- pi.registerProvider("corporate-ai", {
1847
- baseUrl: "https://ai.corp.com",
1848
- api: "openai-responses",
1849
- models: [...],
1850
- oauth: {
1851
- name: "Corporate AI (SSO)",
1852
- async login(callbacks) {
1853
- // Custom OAuth flow
1854
- callbacks.onAuth({ url: "https://sso.corp.com/..." });
1855
- const code = await callbacks.onPrompt({ message: "Enter code:" });
1856
- return { refresh: code, access: code, expires: Date.now() + 3600000 };
1857
- },
1858
- async refreshToken(credentials, signal) {
1859
- signal.throwIfAborted();
1860
- // Refresh logic
1861
- return credentials;
1862
- },
1863
- getApiKey(credentials) {
1864
- return credentials.access;
1865
- }
1866
- }
1867
- });
1868
- ```
1869
-
1870
- The object form accepts a complete pi-ai `Provider`, including native `auth`, `getModels`, `refreshModels`, `filterModels`, `stream`, and `streamSimple` behavior.
1871
-
1872
- **Legacy config options:**
1873
-
1874
- - `name` - Display name for the provider in UI such as `/login`.
1875
- - `baseUrl` - API endpoint URL. Required when defining models.
1876
- - `apiKey` - API key literal, environment interpolation (`$ENV_VAR` or `${ENV_VAR}`), or leading `!command`. Required when defining models (unless `oauth` provided). `$$` escapes `$`, and `$!` escapes a literal `!` without triggering command execution.
1877
- - `api` - API type: `"anthropic-messages"`, `"openai-completions"`, `"openai-responses"`, etc.
1878
- - `headers` - Custom headers to include in requests.
1879
- - `authHeader` - If true, adds `Authorization: Bearer` header automatically.
1880
- - `models` - Array of model definitions. If provided, replaces all existing models for this provider. Model definitions can set `baseUrl` to override the provider endpoint for that model.
1881
- - `refreshModels` - Async dynamic discovery callback. Its returned models replace extension-provided models. `context.stored` contains the persisted provider snapshot; use generation-checked `context.publish({ persist: entry })` only when updated catalog data should persist. Use `persist: null` to delete that snapshot.
1882
- - `oauth` - OAuth provider config for `/login` support. When provided, the provider appears in the login menu.
1883
- - `streamSimple` - Custom streaming implementation for non-standard APIs.
1884
-
1885
- See [custom-provider.md](/docs/latest/custom-provider) for advanced topics: custom streaming APIs, OAuth details, model definition reference.
1886
-
1887
- ### pi.unregisterProvider(name)
1888
-
1889
- Remove a previously registered provider and its models. Built-in models that were overridden by the provider are restored. Has no effect if the provider was not registered.
1890
-
1891
- Like `registerProvider`, this takes effect immediately when called after the initial load phase, so a `/reload` is not required.
1892
-
1893
- ```
1894
- pi.registerCommand("my-setup-teardown", {
1895
- description: "Remove the custom proxy provider",
1896
- handler: async (_args, _ctx) => {
1897
- pi.unregisterProvider("my-proxy");
1898
- },
1899
- });
1900
- ```
1901
-
1902
- ## State Management
1903
-
1904
- Extensions with state should store it in tool result `details` for proper branching support:
1905
-
1906
- ```
1907
- export default function (pi: ExtensionAPI) {
1908
- let items: string[] = [];
1909
-
1910
- // Reconstruct state from session
1911
- pi.on("session_start", async (_event, ctx) => {
1912
- items = [];
1913
- for (const entry of ctx.sessionManager.getBranch()) {
1914
- if (entry.type === "message" && entry.message.role === "toolResult") {
1915
- if (entry.message.toolName === "my_tool") {
1916
- items = entry.message.details?.items ?? [];
1917
- }
1918
- }
1919
- }
1920
- });
1921
-
1922
- pi.registerTool({
1923
- name: "my_tool",
1924
- // ...
1925
- async execute(toolCallId, params, signal, onUpdate, ctx) {
1926
- items.push("new item");
1927
- return {
1928
- content: [{ type: "text", text: "Added" }],
1929
- details: { items: [...items] }, // Store for reconstruction
1930
- };
1931
- },
1932
- });
1933
- }
1934
- ```
1935
-
1936
- ## Custom Tools
1937
-
1938
- Register tools the LLM can call via `pi.registerTool()`. Tools appear in the system prompt and can have custom rendering.
1939
-
1940
- Use `promptSnippet` for a short one-line entry in the `Available tools` section in the default system prompt. If omitted, custom tools are left out of that section.
1941
-
1942
- Use `promptGuidelines` to add tool-specific bullets to the default system prompt `Guidelines` section. These bullets are included only while the tool is active (for example, after `pi.setActiveTools([...])`).
1943
-
1944
- **Important:** `promptGuidelines` bullets are appended flat to the `Guidelines` section with no tool name prefix or grouping. Each guideline must name the tool it refers to — avoid "Use this tool when..." because the LLM cannot tell which tool "this" means. Write "Use my\_tool when..." instead.
1945
-
1946
- Note: Some models are idiots and include the @ prefix in tool path arguments. Built-in tools strip a leading @ before resolving paths. If your custom tool accepts a path, normalize a leading @ as well.
1947
-
1948
- If your custom tool mutates files, use `withFileMutationQueue()` so it participates in the same per-file queue as built-in `edit` and `write`. This matters because tool calls run in parallel by default. Without the queue, two tools can read the same old file contents, compute different updates, and then whichever write lands last overwrites the other.
1949
-
1950
- Example failure case: your custom tool edits `foo.ts` while built-in `edit` also changes `foo.ts` in the same assistant turn. If your tool does not participate in the queue, both can read the original `foo.ts`, apply separate changes, and one of those changes is lost.
1951
-
1952
- Pass the real target file path to `withFileMutationQueue()`, not the raw user argument. Resolve it to an absolute path first, relative to `ctx.cwd` or your tool's working directory. For existing files, the helper canonicalizes through `realpath()`, so symlink aliases for the same file share one queue. For new files, it falls back to the resolved absolute path because there is nothing to `realpath()` yet.
1953
-
1954
- Queue the entire mutation window on that target path. That includes read-modify-write logic, not just the final write.
1955
-
1956
- ```
1957
- import { withFileMutationQueue } from "@earendil-works/pi-coding-agent";
1958
- import { mkdir, readFile, writeFile } from "node:fs/promises";
1959
- import { dirname, resolve } from "node:path";
1960
-
1961
- async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
1962
- const absolutePath = resolve(ctx.cwd, params.path);
1963
-
1964
- return withFileMutationQueue(absolutePath, async () => {
1965
- await mkdir(dirname(absolutePath), { recursive: true });
1966
- const current = await readFile(absolutePath, "utf8");
1967
- const next = current.replace(params.oldText, params.newText);
1968
- await writeFile(absolutePath, next, "utf8");
1969
-
1970
- return {
1971
- content: [{ type: "text", text: `Updated ${params.path}` }],
1972
- details: {},
1973
- };
1974
- });
1975
- }
1976
- ```
1977
-
1978
- ### Tool Definition
1979
-
1980
- ```
1981
- import { Type } from "typebox";
1982
- import { StringEnum } from "@earendil-works/pi-ai";
1983
- import { Text } from "@earendil-works/pi-tui";
1984
-
1985
- pi.registerTool({
1986
- name: "my_tool",
1987
- label: "My Tool",
1988
- description: "What this tool does (shown to LLM)",
1989
- promptSnippet: "List or add items in the project todo list",
1990
- promptGuidelines: [
1991
- "Use my_tool for todo planning instead of direct file edits when the user asks for a task list."
1992
- ],
1993
- parameters: Type.Object({
1994
- action: StringEnum(["list", "add"] as const), // Use StringEnum for Google compatibility
1995
- text: Type.Optional(Type.String()),
1996
- }),
1997
- prepareArguments(args) {
1998
- if (!args || typeof args !== "object") return args;
1999
- const input = args as { action?: string; oldAction?: string };
2000
- if (typeof input.oldAction === "string" && input.action === undefined) {
2001
- return { ...input, action: input.oldAction };
2002
- }
2003
- return args;
2004
- },
2005
-
2006
- async execute(toolCallId, params, signal, onUpdate, ctx) {
2007
- // Check for cancellation
2008
- if (signal?.aborted) {
2009
- return { content: [{ type: "text", text: "Cancelled" }] };
2010
- }
2011
-
2012
- // Stream progress updates
2013
- onUpdate?.({
2014
- content: [{ type: "text", text: "Working..." }],
2015
- details: { progress: 50 },
2016
- });
2017
-
2018
- // Run commands via pi.exec (captured from extension closure)
2019
- const result = await pi.exec("some-command", [], { signal });
2020
-
2021
- // Return result
2022
- return {
2023
- content: [{ type: "text", text: "Done" }], // Sent to LLM
2024
- details: { data: result }, // For rendering & state
2025
- // usage: nestedModelResponse.usage, // Optional nested LLM usage
2026
- // Optional: stop after this tool batch when every finalized tool result
2027
- // in the batch also returns terminate: true.
2028
- terminate: true,
2029
- };
2030
- },
2031
-
2032
- // Optional: Custom rendering
2033
- renderCall(args, theme, context) { ... },
2034
- renderResult(result, options, theme, context) { ... },
2035
- });
2036
- ```
2037
-
2038
- **Usage accounting:** If a tool makes nested LLM calls, return their combined `Usage` as `usage`. Pi persists it on the tool result and includes it in footer, `/session`, and RPC session totals. `tool_result` handlers can inspect or replace this value.
2039
-
2040
- **Signaling errors:** To mark a tool execution as failed (sets `isError: true` on the result and reports it to the LLM), throw an error from `execute`. Returning a value never sets the error flag regardless of what properties you include in the return object.
2041
-
2042
- **Early termination:** Return `terminate: true` from `execute()` to hint that the automatic follow-up LLM call should be skipped after the current tool batch. This only takes effect when every finalized tool result in that batch is terminating. See [examples/extensions/structured-output.ts](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/examples/extensions/structured-output.ts) for a minimal example where the agent ends on a final structured-output tool call.
2043
-
2044
- ```
2045
- // Correct: throw to signal an error
2046
- async execute(toolCallId, params) {
2047
- if (!isValid(params.input)) {
2048
- throw new Error(`Invalid input: ${params.input}`);
2049
- }
2050
- return { content: [{ type: "text", text: "OK" }], details: {} };
2051
- }
2052
- ```
2053
-
2054
- **Important:** Use `StringEnum` from `@earendil-works/pi-ai` for string enums. `Type.Union`/`Type.Literal` doesn't work with Google's API.
2055
-
2056
- **Argument preparation:** `prepareArguments(args)` is optional. If defined, it runs before schema validation and before `execute()`. Use it to mimic an older accepted input shape when pi resumes an older session whose stored tool call arguments no longer match the current schema. Return the object you want validated against `parameters`. Keep the public schema strict. Do not add deprecated compatibility fields to `parameters` just to keep old resumed sessions working.
2057
-
2058
- Example: an older session may contain an `edit` tool call with top-level `oldText` and `newText`, while the current schema only accepts `edits: [{ oldText, newText }]`.
2059
-
2060
- ```
2061
- pi.registerTool({
2062
- name: "edit",
2063
- label: "Edit",
2064
- description: "Edit a single file using exact text replacement",
2065
- parameters: Type.Object({
2066
- path: Type.String(),
2067
- edits: Type.Array(
2068
- Type.Object({
2069
- oldText: Type.String(),
2070
- newText: Type.String(),
2071
- }),
2072
- ),
2073
- }),
2074
- prepareArguments(args) {
2075
- if (!args || typeof args !== "object") return args;
2076
-
2077
- const input = args as {
2078
- path?: string;
2079
- edits?: Array<{ oldText: string; newText: string }>;
2080
- oldText?: unknown;
2081
- newText?: unknown;
2082
- };
2083
-
2084
- if (typeof input.oldText !== "string" || typeof input.newText !== "string") {
2085
- return args;
2086
- }
2087
-
2088
- return {
2089
- ...input,
2090
- edits: [...(input.edits ?? []), { oldText: input.oldText, newText: input.newText }],
2091
- };
2092
- },
2093
- async execute(toolCallId, params, signal, onUpdate, ctx) {
2094
- // params now matches the current schema
2095
- return {
2096
- content: [{ type: "text", text: `Applying ${params.edits.length} edit block(s)` }],
2097
- details: {},
2098
- };
2099
- },
2100
- });
2101
- ```
2102
-
2103
- ### Overriding Built-in Tools
2104
-
2105
- Extensions can override built-in tools (`read`, `bash`, `powershell`, `edit`, `write`, `grep`, `find`, `ls`) by registering a tool with the same name. Interactive mode displays a warning when this happens.
2106
-
2107
- ```
2108
- # Extension's read tool replaces built-in read
2109
- pi -e ./tool-override.ts
2110
- ```
2111
-
2112
- Alternatively, use `--no-builtin-tools` to start without any built-in tools while keeping extension tools enabled:
2113
-
2114
- ```
2115
- # No built-in tools, only extension tools
2116
- pi --no-builtin-tools -e ./my-extension.ts
2117
- ```
2118
-
2119
- See [examples/extensions/tool-override.ts](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/examples/extensions/tool-override.ts) for a complete example that overrides `read` with logging and access control.
2120
-
2121
- **Rendering:** Built-in renderer inheritance is resolved per slot. Execution override and rendering override are independent. If your override omits `renderCall`, the built-in `renderCall` is used. If your override omits `renderResult`, the built-in `renderResult` is used. If your override omits both, the built-in renderer is used automatically (syntax highlighting, diffs, etc.). This lets you wrap built-in tools for logging or access control without reimplementing the UI.
2122
-
2123
- **Prompt metadata:** `promptSnippet` and `promptGuidelines` are not inherited from the built-in tool. If your override should keep those prompt instructions, define them on the override explicitly.
2124
-
2125
- **Your implementation must match the exact result shape**, including the `details` type. The UI and session logic depend on these shapes for rendering and state tracking.
2126
-
2127
- Built-in tool implementations:
2128
-
2129
- - [read.ts](https://github.com/earendil-works/pi-mono/blob/main/packages/coding-agent/src/core/tools/read.ts) - `ReadToolDetails`
2130
- - [bash.ts](https://github.com/earendil-works/pi-mono/blob/main/packages/coding-agent/src/core/tools/bash.ts) - `BashToolDetails`
2131
- - [powershell.ts](https://github.com/earendil-works/pi-mono/blob/main/packages/coding-agent/src/core/tools/powershell.ts) - `PowerShellToolDetails`
2132
- - [edit.ts](https://github.com/earendil-works/pi-mono/blob/main/packages/coding-agent/src/core/tools/edit.ts)
2133
- - [write.ts](https://github.com/earendil-works/pi-mono/blob/main/packages/coding-agent/src/core/tools/write.ts)
2134
- - [grep.ts](https://github.com/earendil-works/pi-mono/blob/main/packages/coding-agent/src/core/tools/grep.ts) - `GrepToolDetails`
2135
- - [find.ts](https://github.com/earendil-works/pi-mono/blob/main/packages/coding-agent/src/core/tools/find.ts) - `FindToolDetails`
2136
- - [ls.ts](https://github.com/earendil-works/pi-mono/blob/main/packages/coding-agent/src/core/tools/ls.ts) - `LsToolDetails`
2137
-
2138
- ### Remote Execution
2139
-
2140
- Built-in tools support pluggable operations for delegating to remote systems (SSH, containers, etc.):
2141
-
2142
- ```
2143
- import { createReadTool, createBashTool, type ReadOperations } from "@earendil-works/pi-coding-agent";
2144
-
2145
- // Create tool with custom operations
2146
- const remoteRead = createReadTool(cwd, {
2147
- operations: {
2148
- readFile: (path) => sshExec(remote, `cat ${path}`),
2149
- access: (path) => sshExec(remote, `test -r ${path}`).then(() => {}),
2150
- }
2151
- });
2152
-
2153
- // Register, checking flag at execution time
2154
- pi.registerTool({
2155
- ...remoteRead,
2156
- async execute(id, params, signal, onUpdate, _ctx) {
2157
- const ssh = getSshConfig();
2158
- if (ssh) {
2159
- const tool = createReadTool(cwd, { operations: createRemoteOps(ssh) });
2160
- return tool.execute(id, params, signal, onUpdate);
2161
- }
2162
- return localRead.execute(id, params, signal, onUpdate);
2163
- },
2164
- });
2165
- ```
2166
-
2167
- **Operations interfaces:** `ReadOperations`, `WriteOperations`, `EditOperations`, `BashOperations`, `PowerShellOperations`, `LsOperations`, `GrepOperations`, `FindOperations`
2168
-
2169
- For `user_bash`, extensions can reuse pi's local shell backend via `createLocalBashOperations()` instead of reimplementing local process spawning, shell resolution, and process-tree termination.
2170
-
2171
- The `bash` and `powershell` tools also support a spawn hook to adjust the command, cwd, or env before execution:
2172
-
2173
- ```
2174
- import { createBashTool } from "@earendil-works/pi-coding-agent";
2175
-
2176
- const bashTool = createBashTool(cwd, {
2177
- spawnHook: ({ command, cwd, env }) => ({
2178
- command: `source ~/.profile\n${command}`,
2179
- cwd: `/mnt/sandbox${cwd}`,
2180
- env: { ...env, CI: "1" },
2181
- }),
2182
- });
2183
- ```
2184
-
2185
- `createBashTool()` and `createPowerShellTool()` expose the current session to commands through `PI_SESSION_ID`, `PI_SESSION_FILE`, `PI_PROVIDER`, `PI_MODEL`, and `PI_REASONING_LEVEL`. Injection happens before `spawnHook`, so hooks receive these values in `env` and preserve them when they spread the existing environment as above. Set `exposeSessionEnvironment: false` to disable them:
2186
-
2187
- ```
2188
- const bashTool = createBashTool(cwd, {
2189
- exposeSessionEnvironment: false,
2190
- });
2191
- ```
2192
-
2193
- See [Shell tool session environment](/docs/latest/environment-variables#shell-tool-session-environment) for variable semantics. See [examples/extensions/ssh.ts](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/examples/extensions/ssh.ts) for a complete SSH example with `--ssh` flag.
2194
-
2195
- ### Output Truncation
2196
-
2197
- **Tools MUST truncate their output** to avoid overwhelming the LLM context. Large outputs can cause:
2198
-
2199
- - Context overflow errors (prompt too long)
2200
- - Compaction failures
2201
- - Degraded model performance
2202
-
2203
- The built-in limit is **50KB** (~10k tokens) and **2000 lines**, whichever is hit first. Use the exported truncation utilities:
2204
-
2205
- ```
2206
- import {
2207
- truncateHead, // Keep first N lines/bytes (good for file reads, search results)
2208
- truncateTail, // Keep last N lines/bytes (good for logs, command output)
2209
- truncateLine, // Truncate a single line to maxBytes with ellipsis
2210
- formatSize, // Human-readable size (e.g., "50KB", "1.5MB")
2211
- DEFAULT_MAX_BYTES, // 50KB
2212
- DEFAULT_MAX_LINES, // 2000
2213
- } from "@earendil-works/pi-coding-agent";
2214
-
2215
- async execute(toolCallId, params, signal, onUpdate, ctx) {
2216
- const output = await runCommand();
2217
-
2218
- // Apply truncation
2219
- const truncation = truncateHead(output, {
2220
- maxLines: DEFAULT_MAX_LINES,
2221
- maxBytes: DEFAULT_MAX_BYTES,
2222
- });
2223
-
2224
- let result = truncation.content;
2225
-
2226
- if (truncation.truncated) {
2227
- // Write full output to temp file
2228
- const tempFile = writeTempFile(output);
2229
-
2230
- // Inform the LLM where to find complete output
2231
- result += `\n\n[Output truncated: ${truncation.outputLines} of ${truncation.totalLines} lines`;
2232
- result += ` (${formatSize(truncation.outputBytes)} of ${formatSize(truncation.totalBytes)}).`;
2233
- result += ` Full output saved to: ${tempFile}]`;
2234
- }
2235
-
2236
- return { content: [{ type: "text", text: result }] };
2237
- }
2238
- ```
2239
-
2240
- **Key points:**
2241
-
2242
- - Use `truncateHead` for content where the beginning matters (search results, file reads)
2243
- - Use `truncateTail` for content where the end matters (logs, command output)
2244
- - Always inform the LLM when output is truncated and where to find the full version
2245
- - Document the truncation limits in your tool's description
2246
-
2247
- See [examples/extensions/truncated-tool.ts](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/examples/extensions/truncated-tool.ts) for a complete example wrapping `rg` (ripgrep) with proper truncation.
2248
-
2249
- ### Multiple Tools
2250
-
2251
- One extension can register multiple tools with shared state:
2252
-
2253
- ```
2254
- export default function (pi: ExtensionAPI) {
2255
- let connection = null;
2256
-
2257
- pi.registerTool({ name: "db_connect", ... });
2258
- pi.registerTool({ name: "db_query", ... });
2259
- pi.registerTool({ name: "db_close", ... });
2260
-
2261
- pi.on("session_shutdown", async () => {
2262
- connection?.close();
2263
- });
2264
- }
2265
- ```
2266
-
2267
- ### Custom Rendering
2268
-
2269
- Tools can provide `renderCall` and `renderResult` for custom TUI display. See [tui.md](/docs/latest/tui) for the full component API and [tool-execution.ts](https://github.com/earendil-works/pi-mono/blob/main/packages/coding-agent/src/modes/interactive/components/tool-execution.ts) for how tool rows are composed.
2270
-
2271
- By default, tool output is wrapped in a `Box` that handles padding and background. A defined `renderCall` or `renderResult` must return a `Component`. If a slot renderer is not defined, `tool-execution.ts` uses fallback rendering for that slot.
2272
-
2273
- Set `renderShell: "self"` when the tool should render its own shell instead of using the default `Box`. This is useful for tools that need complete control over framing or background behavior, for example large previews that must stay visually stable after the tool settles.
2274
-
2275
- ```
2276
- pi.registerTool({
2277
- name: "my_tool",
2278
- label: "My Tool",
2279
- description: "Custom shell example",
2280
- parameters: Type.Object({}),
2281
- renderShell: "self",
2282
- async execute() {
2283
- return { content: [{ type: "text", text: "ok" }], details: undefined };
2284
- },
2285
- renderCall(args, theme, context) {
2286
- return new Text(theme.fg("accent", "my custom shell"), 0, 0);
2287
- },
2288
- });
2289
- ```
2290
-
2291
- `renderCall` and `renderResult` each receive a `context` object with:
2292
-
2293
- - `args` - the current tool call arguments
2294
- - `state` - shared row-local state across `renderCall` and `renderResult`
2295
- - `lastComponent` - the previously returned component for that slot, if any
2296
- - `invalidate()` - request a rerender of this tool row
2297
- - `toolCallId`, `cwd`, `executionStarted`, `argsComplete`, `isPartial`, `expanded`, `showImages`, `isError`
2298
-
2299
- Use `context.state` for cross-slot shared state. Keep slot-local caches on the returned component instance when you want to reuse and mutate the same component across renders.
2300
-
2301
- #### renderCall
2302
-
2303
- Renders the tool call or header:
2304
-
2305
- ```
2306
- import { Text } from "@earendil-works/pi-tui";
2307
-
2308
- renderCall(args, theme, context) {
2309
- const text = (context.lastComponent as Text | undefined) ?? new Text("", 0, 0);
2310
- let content = theme.fg("toolTitle", theme.bold("my_tool "));
2311
- content += theme.fg("muted", args.action);
2312
- if (args.text) {
2313
- content += " " + theme.fg("dim", `"${args.text}"`);
2314
- }
2315
- text.setText(content);
2316
- return text;
2317
- }
2318
- ```
2319
-
2320
- #### renderResult
2321
-
2322
- Renders the tool result or output:
2323
-
2324
- ```
2325
- renderResult(result, { expanded, isPartial }, theme, context) {
2326
- if (isPartial) {
2327
- return new Text(theme.fg("warning", "Processing..."), 0, 0);
2328
- }
2329
-
2330
- if (result.details?.error) {
2331
- return new Text(theme.fg("error", `Error: ${result.details.error}`), 0, 0);
2332
- }
2333
-
2334
- let text = theme.fg("success", "✓ Done");
2335
- if (expanded && result.details?.items) {
2336
- for (const item of result.details.items) {
2337
- text += "\n " + theme.fg("dim", item);
2338
- }
2339
- }
2340
- return new Text(text, 0, 0);
2341
- }
2342
- ```
2343
-
2344
- If a slot intentionally has no visible content, return an empty `Component` such as an empty `Container`.
2345
-
2346
- #### Keybinding Hints
2347
-
2348
- Use `keyHint()` to display keybinding hints that respect the active keybinding configuration:
2349
-
2350
- ```
2351
- import { keyHint } from "@earendil-works/pi-coding-agent";
2352
-
2353
- renderResult(result, { expanded }, theme, context) {
2354
- let text = theme.fg("success", "✓ Done");
2355
- if (!expanded) {
2356
- text += ` (${keyHint("app.tools.expand", "to expand")})`;
2357
- }
2358
- return new Text(text, 0, 0);
2359
- }
2360
- ```
2361
-
2362
- Available functions:
2363
-
2364
- - `keyHint(keybinding, description)` - Formats a configured keybinding id such as `"app.tools.expand"` or `"tui.select.confirm"`
2365
- - `keyText(keybinding)` - Returns the raw configured key text for a keybinding id
2366
- - `rawKeyHint(key, description)` - Format a raw key string
2367
-
2368
- Use namespaced keybinding ids:
2369
-
2370
- - Coding-agent ids use the `app.*` namespace, for example `app.tools.expand`, `app.editor.external`, `app.session.rename`
2371
- - Shared TUI ids use the `tui.*` namespace, for example `tui.select.confirm`, `tui.select.cancel`, `tui.input.tab`
2372
-
2373
- For the exhaustive list of keybinding ids and defaults, see [keybindings.md](/docs/latest/keybindings). `keybindings.json` uses those same namespaced ids.
2374
-
2375
- Custom editors and `ctx.ui.custom()` components receive `keybindings: KeybindingsManager` as an injected argument. They should use that injected manager directly instead of calling `getKeybindings()` or `setKeybindings()`.
2376
-
2377
- #### Best Practices
2378
-
2379
- - Use `Text` with padding `(0, 0)`. The default Box handles padding.
2380
- - Use `\n` for multi-line content.
2381
- - Handle `isPartial` for streaming progress.
2382
- - Support `expanded` for detail on demand.
2383
- - Keep default view compact.
2384
- - Read `context.args` in `renderResult` instead of copying args into `context.state`.
2385
- - Use `context.state` only for data that must be shared across call and result slots.
2386
- - Reuse `context.lastComponent` when the same component instance can be updated in place.
2387
- - Use `renderShell: "self"` only when the default boxed shell gets in the way. In self-shell mode the tool is responsible for its own framing, padding, and background.
2388
-
2389
- #### Fallback
2390
-
2391
- If a slot renderer is not defined or throws:
2392
-
2393
- - `renderCall`: Shows the tool name
2394
- - `renderResult`: Shows raw text from `content`
2395
-
2396
- ### Dynamic Tool Loading
2397
-
2398
- Extensions can register many tools while keeping only a small initial set active. A tool can then add more tools with `pi.setActiveTools()` during execution. Pi detects purely additive changes, records the newly available tool names on that tool result, and applies the updated active set before the next model request.
2399
-
2400
- This works with every model. Models with native deferred-loading support preserve the stable prompt prefix and load the new definitions at the tool-result position. Other models use the fallback described below.
2401
-
2402
- The lifecycle is:
2403
-
2404
- 1. Register every tool with `pi.registerTool()` so it appears in `pi.getAllTools()`.
2405
- 2. Keep loader tools, such as `search_tools`, active and leave searchable tools inactive.
2406
- 3. During loader execution, call `pi.setActiveTools([...currentTools, ...matchingTools])`. The change must be additive: do not remove currently active tools in the same call.
2407
- 4. Pi records which tools were added on the loader's tool result.
2408
- 5. Before the next model response, Pi exposes the added definitions using native deferred loading when supported, or the normal active tool list otherwise.
2409
-
2410
- You do not need to return provider-specific tool references or mark the loader as a special search tool. The active-tool change is the signal. Names passed to `pi.setActiveTools()` must already be registered; unknown names are ignored.
2411
-
2412
- #### Models with native deferred loading
2413
-
2414
- - **Anthropic**
2415
- - **Models:** Sonnet, Opus, Fable version 4.5 or newer (without Haiku)
2416
- - **Native representation:** Deferred definitions use `defer_loading`; the load point uses `tool_reference` content.
2417
- - **OpenAI**
2418
- - **Models:** `gpt-5.4` and newer family
2419
- - **Native representation:** Pi adds completed client `tool_search_call` and `tool_search_output` items at the load point.
2420
-
2421
- For a verified custom model or proxy, native handling can be enabled with `compat.supportsToolReferences: true` for `anthropic-messages`, or `compat.supportsToolSearch: true` for `openai-responses` and `openai-codex-responses`. Leave these disabled unless the endpoint and model accept the corresponding native protocol.
2422
-
2423
- #### Fallback behavior
2424
-
2425
- For all other models and providers, dynamic activation still works: Pi sends the complete current active tool list normally on the next request. The model can call the newly activated tools, but adding their definitions may invalidate the provider's cached prompt prefix.
2426
-
2427
- Pi also uses this safe fallback when the active set is not purely additive, such as replacing one group of tools with another. Tool removals therefore work, but they do not use deferred loading.
2428
-
2429
- For the best cache behavior, keep the loader tool active for the whole session and add tools instead of replacing the active set. Also note that activating a tool with `promptSnippet` or `promptGuidelines` rebuilds the system prompt; that system-prompt change can invalidate the prefix even when the provider supports deferred schemas. Lazily loaded tools should usually rely on their tool `description` and omit active-only prompt metadata.
2430
-
2431
- #### Search tool example
2432
-
2433
- The following extension registers two searchable tools, removes them from the initial active set, and keeps only `search_tools` as their loader. The example uses simple keyword matching, but the search implementation could use BM25, embeddings, a remote catalog, or project-specific routing.
2434
-
2435
- ```
2436
- import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
2437
- import { Type } from "typebox";
2438
-
2439
- const SEARCHABLE_TOOL_NAMES = new Set(["lookup_weather", "search_issues"]);
2440
-
2441
- export default function (pi: ExtensionAPI) {
2442
- pi.registerTool({
2443
- name: "lookup_weather",
2444
- label: "Lookup Weather",
2445
- description: "Look up the current weather for a city",
2446
- parameters: Type.Object({ city: Type.String() }),
2447
- async execute(_toolCallId, params) {
2448
- return {
2449
- content: [{ type: "text", text: `Weather for ${params.city}: sunny` }],
2450
- details: {},
2451
- };
2452
- },
2453
- });
2454
-
2455
- pi.registerTool({
2456
- name: "search_issues",
2457
- label: "Search Issues",
2458
- description: "Search project issues by keyword",
2459
- parameters: Type.Object({ query: Type.String() }),
2460
- async execute(_toolCallId, params) {
2461
- return {
2462
- content: [{ type: "text", text: `No open issues matching ${params.query}` }],
2463
- details: {},
2464
- };
2465
- },
2466
- });
2467
-
2468
- pi.registerTool({
2469
- name: "search_tools",
2470
- label: "Search Tools",
2471
- description: "Search for and enable tools relevant to a task",
2472
- promptSnippet: "Search for additional tools when the active tools cannot perform the task",
2473
- promptGuidelines: [
2474
- "Use search_tools when a task requires a capability that is not currently available.",
2475
- ],
2476
- parameters: Type.Object({
2477
- query: Type.String({ description: "Capability or task to search for" }),
2478
- limit: Type.Optional(Type.Integer({ minimum: 1, maximum: 10 })),
2479
- }),
2480
- async execute(_toolCallId, params) {
2481
- const terms = params.query.toLowerCase().split(/[^a-z0-9]+/).filter(Boolean);
2482
- const matches = pi.getAllTools()
2483
- .filter((tool) => SEARCHABLE_TOOL_NAMES.has(tool.name))
2484
- .map((tool) => ({
2485
- tool,
2486
- score: terms.reduce(
2487
- (score, term) =>
2488
- score + (`${tool.name} ${tool.description}`.toLowerCase().includes(term) ? 1 : 0),
2489
- 0,
2490
- ),
2491
- }))
2492
- .filter((match) => match.score > 0)
2493
- .sort((a, b) => b.score - a.score)
2494
- .slice(0, params.limit ?? 3)
2495
- .map((match) => match.tool.name);
2496
-
2497
- if (matches.length === 0) {
2498
- return {
2499
- content: [{ type: "text", text: `No tools found for: ${params.query}` }],
2500
- details: { matches: [] },
2501
- };
2502
- }
2503
-
2504
- const active = pi.getActiveTools();
2505
- const added = matches.filter((name) => !active.includes(name));
2506
- pi.setActiveTools([...new Set([...active, ...added])]);
2507
-
2508
- return {
2509
- content: [{
2510
- type: "text",
2511
- text: added.length > 0
2512
- ? `Loaded tools: ${added.join(", ")}`
2513
- : `Matching tools already active: ${matches.join(", ")}`,
2514
- }],
2515
- details: { matches, added },
2516
- };
2517
- },
2518
- });
2519
-
2520
- pi.on("session_start", () => {
2521
- // Keep searchable tools registered but initially inactive. Preserve built-ins
2522
- // and tools owned by other extensions, and keep the loader itself active.
2523
- const initialTools = pi.getActiveTools().filter(
2524
- (name) => !SEARCHABLE_TOOL_NAMES.has(name),
2525
- );
2526
- pi.setActiveTools([...new Set([...initialTools, "search_tools"])]);
2527
- });
2528
- }
2529
- ```
2530
-
2531
- When `search_tools` adds a match, the model receives that definition on the immediately following request. On a native-capable model the definition is anchored after the search result without changing the initial tool-schema prefix. On other models it appears in the normal tool list on that same following request.
2532
-
2533
- ## Custom UI
2534
-
2535
- Extensions can interact with users via `ctx.ui` methods and customize how messages/tools render.
2536
-
2537
- **For custom components, see [tui.md](/docs/latest/tui)** which has copy-paste patterns for:
2538
-
2539
- - Selection dialogs (SelectList)
2540
- - Async operations with cancel (BorderedLoader)
2541
- - Settings toggles (SettingsList)
2542
- - Status indicators (setStatus)
2543
- - Working message, visibility, and indicator during streaming (`setWorkingMessage`, `setWorkingVisible`, `setWorkingIndicator`)
2544
- - Widgets above/below editor (setWidget)
2545
- - Autocomplete providers layered on top of built-in slash/path completion (addAutocompleteProvider)
2546
- - Custom footers (setFooter)
2547
-
2548
- ### Dialogs
2549
-
2550
- ```
2551
- // Select from options
2552
- const choice = await ctx.ui.select("Pick one:", ["A", "B", "C"]);
2553
-
2554
- // Confirm dialog
2555
- const ok = await ctx.ui.confirm("Delete?", "This cannot be undone");
2556
-
2557
- // Text input
2558
- const name = await ctx.ui.input("Name:", "placeholder");
2559
-
2560
- // Multi-line editor
2561
- const text = await ctx.ui.editor("Edit:", "prefilled text");
2562
-
2563
- // Notification (non-blocking)
2564
- ctx.ui.notify("Done!", "info"); // "info" | "warning" | "error"
2565
- ```
2566
-
2567
- #### Timed Dialogs with Countdown
2568
-
2569
- Dialogs support a `timeout` option that auto-dismisses with a live countdown display:
2570
-
2571
- ```
2572
- // Dialog shows "Title (5s)" → "Title (4s)" → ... → auto-dismisses at 0
2573
- const confirmed = await ctx.ui.confirm(
2574
- "Timed Confirmation",
2575
- "This dialog will auto-cancel in 5 seconds. Confirm?",
2576
- { timeout: 5000 }
2577
- );
2578
-
2579
- if (confirmed) {
2580
- // User confirmed
2581
- } else {
2582
- // User cancelled or timed out
2583
- }
2584
- ```
2585
-
2586
- **Return values on timeout:**
2587
-
2588
- - `select()` returns `undefined`
2589
- - `confirm()` returns `false`
2590
- - `input()` returns `undefined`
2591
-
2592
- #### Manual Dismissal with AbortSignal
2593
-
2594
- For more control (e.g., to distinguish timeout from user cancel), use `AbortSignal`:
2595
-
2596
- ```
2597
- const controller = new AbortController();
2598
- const timeoutId = setTimeout(() => controller.abort(), 5000);
2599
-
2600
- const confirmed = await ctx.ui.confirm(
2601
- "Timed Confirmation",
2602
- "This dialog will auto-cancel in 5 seconds. Confirm?",
2603
- { signal: controller.signal }
2604
- );
2605
-
2606
- clearTimeout(timeoutId);
2607
-
2608
- if (confirmed) {
2609
- // User confirmed
2610
- } else if (controller.signal.aborted) {
2611
- // Dialog timed out
2612
- } else {
2613
- // User cancelled (pressed Escape or selected "No")
2614
- }
2615
- ```
2616
-
2617
- See [examples/extensions/timed-confirm.ts](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/examples/extensions/timed-confirm.ts) for complete examples.
2618
-
2619
- ### Widgets, Status, and Footer
2620
-
2621
- ```
2622
- // Status in footer (persistent until cleared)
2623
- ctx.ui.setStatus("my-ext", "Processing...");
2624
- ctx.ui.setStatus("my-ext", undefined); // Clear
2625
-
2626
- // Working loader (shown during streaming)
2627
- ctx.ui.setWorkingMessage("Thinking deeply...");
2628
- ctx.ui.setWorkingMessage(); // Restore default
2629
- ctx.ui.setWorkingVisible(false); // Hide the built-in working loader row entirely
2630
- ctx.ui.setWorkingVisible(true); // Show the built-in working loader row
2631
-
2632
- // Working indicator (shown during streaming)
2633
- ctx.ui.setWorkingIndicator({ frames: [ctx.ui.theme.fg("accent", "●")] }); // Static dot
2634
- ctx.ui.setWorkingIndicator({
2635
- frames: [
2636
- ctx.ui.theme.fg("dim", "·"),
2637
- ctx.ui.theme.fg("muted", "•"),
2638
- ctx.ui.theme.fg("accent", "●"),
2639
- ctx.ui.theme.fg("muted", "•"),
2640
- ],
2641
- intervalMs: 120,
2642
- });
2643
- ctx.ui.setWorkingIndicator({ frames: [] }); // Hide indicator
2644
- ctx.ui.setWorkingIndicator(); // Restore default spinner
2645
-
2646
- // Widget above editor (default)
2647
- ctx.ui.setWidget("my-widget", ["Line 1", "Line 2"]);
2648
- // Widget below editor
2649
- ctx.ui.setWidget("my-widget", ["Line 1", "Line 2"], { placement: "belowEditor" });
2650
- ctx.ui.setWidget("my-widget", (tui, theme) => new Text(theme.fg("accent", "Custom"), 0, 0));
2651
- ctx.ui.setWidget("my-widget", undefined); // Clear
2652
-
2653
- // Custom footer (replaces built-in footer entirely)
2654
- ctx.ui.setFooter((tui, theme) => ({
2655
- render(width) { return [theme.fg("dim", "Custom footer")]; },
2656
- invalidate() {},
2657
- }));
2658
- ctx.ui.setFooter(undefined); // Restore built-in footer
2659
-
2660
- // Terminal title
2661
- ctx.ui.setTitle("pi - my-project");
2662
-
2663
- // Editor text
2664
- ctx.ui.setEditorText("Prefill text");
2665
- const current = ctx.ui.getEditorText();
2666
-
2667
- // Paste into editor (triggers paste handling, including collapse for large content)
2668
- ctx.ui.pasteToEditor("pasted content");
2669
-
2670
- // Stack custom autocomplete behavior on top of the built-in provider
2671
- ctx.ui.addAutocompleteProvider((current) => ({
2672
- triggerCharacters: ["#"],
2673
- async getSuggestions(lines, line, col, options) {
2674
- const beforeCursor = (lines[line] ?? "").slice(0, col);
2675
- const match = beforeCursor.match(/(?:^|[ \t])#([^\s#]*)$/);
2676
- if (!match) {
2677
- return current.getSuggestions(lines, line, col, options);
2678
- }
2679
-
2680
- return {
2681
- prefix: `#${match[1] ?? ""}`,
2682
- items: [{ value: "#2983", label: "#2983", description: "Extension API for autocomplete" }],
2683
- };
2684
- },
2685
- applyCompletion(lines, line, col, item, prefix) {
2686
- return current.applyCompletion(lines, line, col, item, prefix);
2687
- },
2688
- shouldTriggerFileCompletion(lines, line, col) {
2689
- return current.shouldTriggerFileCompletion?.(lines, line, col) ?? true;
2690
- },
2691
- }));
2692
-
2693
- // Tool output expansion
2694
- const wasExpanded = ctx.ui.getToolsExpanded();
2695
- ctx.ui.setToolsExpanded(true);
2696
- ctx.ui.setToolsExpanded(wasExpanded);
2697
-
2698
- // Custom editor (vim mode, emacs mode, etc.)
2699
- ctx.ui.setEditorComponent((tui, theme, keybindings) => new VimEditor(tui, theme, keybindings));
2700
- const currentEditor = ctx.ui.getEditorComponent();
2701
- ctx.ui.setEditorComponent((tui, theme, keybindings) =>
2702
- new WrappedEditor(tui, theme, keybindings, currentEditor?.(tui, theme, keybindings))
2703
- );
2704
- ctx.ui.setEditorComponent(undefined); // Restore default editor
2705
-
2706
- // Theme management (see themes.md for creating themes)
2707
- const themes = ctx.ui.getAllThemes(); // [{ name: "dark", path: "/..." | undefined }, ...]
2708
- const lightTheme = ctx.ui.getTheme("light"); // Load without switching
2709
- const result = ctx.ui.setTheme("light"); // Switch by name
2710
- if (!result.success) {
2711
- ctx.ui.notify(`Failed: ${result.error}`, "error");
2712
- }
2713
- ctx.ui.setTheme(lightTheme!); // Or switch by Theme object
2714
- ctx.ui.theme.fg("accent", "styled text"); // Access current theme
2715
- ```
2716
-
2717
- Custom working-indicator frames are rendered verbatim. If you want colors, add them to the frame strings yourself, for example with `ctx.ui.theme.fg(...)`.
2718
-
2719
- ### Autocomplete Providers
2720
-
2721
- Use `ctx.ui.addAutocompleteProvider()` to stack custom autocomplete logic on top of the built-in slash-command and path provider. Set `triggerCharacters` for custom natural triggers such as `$`.
2722
-
2723
- Typical pattern:
2724
-
2725
- - inspect the text before the cursor
2726
- - return your own suggestions when your extension-specific syntax matches
2727
- - otherwise delegate to `current.getSuggestions(...)`
2728
- - delegate `applyCompletion(...)` unless you need custom insertion behavior
2729
-
2730
- ```
2731
- pi.on("session_start", (_event, ctx) => {
2732
- ctx.ui.addAutocompleteProvider((current) => ({
2733
- triggerCharacters: ["#"],
2734
- async getSuggestions(lines, cursorLine, cursorCol, options) {
2735
- const line = lines[cursorLine] ?? "";
2736
- const beforeCursor = line.slice(0, cursorCol);
2737
- const match = beforeCursor.match(/(?:^|[ \t])#([^\s#]*)$/);
2738
- if (!match) {
2739
- return current.getSuggestions(lines, cursorLine, cursorCol, options);
2740
- }
2741
-
2742
- return {
2743
- prefix: `#${match[1] ?? ""}`,
2744
- items: [
2745
- { value: "#2983", label: "#2983", description: "Extension API for registering custom @ autocomplete providers" },
2746
- { value: "#2753", label: "#2753", description: "Reload stale resource settings" },
2747
- ],
2748
- };
2749
- },
2750
-
2751
- applyCompletion(lines, cursorLine, cursorCol, item, prefix) {
2752
- return current.applyCompletion(lines, cursorLine, cursorCol, item, prefix);
2753
- },
2754
-
2755
- shouldTriggerFileCompletion(lines, cursorLine, cursorCol) {
2756
- return current.shouldTriggerFileCompletion?.(lines, cursorLine, cursorCol) ?? true;
2757
- },
2758
- }));
2759
- });
2760
- ```
2761
-
2762
- See [github-issue-autocomplete.ts](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/examples/extensions/github-issue-autocomplete.ts) for a complete example that preloads the latest open GitHub issues with `gh issue list` and filters them locally for fast `#...` completion. It requires GitHub CLI (`gh`) and a GitHub repository checkout.
2763
-
2764
- ### Custom Components
2765
-
2766
- For complex UI, use `ctx.ui.custom()`. This temporarily replaces the editor with your component until `done()` is called:
2767
-
2768
- ```
2769
- import { Text, Component } from "@earendil-works/pi-tui";
2770
-
2771
- const result = await ctx.ui.custom<boolean>((tui, theme, keybindings, done) => {
2772
- const text = new Text("Press Enter to confirm, Escape to cancel", 1, 1);
2773
-
2774
- text.onKey = (key) => {
2775
- if (key === "return") done(true);
2776
- if (key === "escape") done(false);
2777
- return true;
2778
- };
2779
-
2780
- return text;
2781
- });
2782
-
2783
- if (result) {
2784
- // User pressed Enter
2785
- }
2786
- ```
2787
-
2788
- The callback receives:
2789
-
2790
- - `tui` - TUI instance (for screen dimensions, focus management)
2791
- - `theme` - Current theme for styling
2792
- - `keybindings` - App keybinding manager (for checking shortcuts)
2793
- - `done(value)` - Call to close component and return value
2794
-
2795
- See [tui.md](/docs/latest/tui) for the full component API.
2796
-
2797
- #### Overlay Mode (Experimental)
2798
-
2799
- Pass `{ overlay: true }` to render the component as a floating modal on top of existing content, without clearing the screen:
2800
-
2801
- ```
2802
- const result = await ctx.ui.custom<string | null>(
2803
- (tui, theme, keybindings, done) => new MyOverlayComponent({ onClose: done }),
2804
- { overlay: true }
2805
- );
2806
- ```
2807
-
2808
- For advanced positioning (anchors, margins, percentages, responsive visibility), pass `overlayOptions`. Use `onHandle` to control focus or visibility programmatically:
2809
-
2810
- ```
2811
- const result = await ctx.ui.custom<string | null>(
2812
- (tui, theme, keybindings, done) => new MyOverlayComponent({ onClose: done }),
2813
- {
2814
- overlay: true,
2815
- overlayOptions: { anchor: "top-right", width: "50%", margin: 2 },
2816
- onHandle: (handle) => {
2817
- handle.focus(); // focus this overlay and bring it to the visual front
2818
- // handle.unfocus({ target: editorComponent }); // release input to a specific component
2819
- // handle.setHidden(true/false); // toggle visibility
2820
- // handle.hide(); // permanently remove
2821
- }
2822
- }
2823
- );
2824
- ```
2825
-
2826
- A focused visible overlay can reclaim input after temporary non-overlay custom UI closes. If you intentionally want another component to keep input while the overlay stays visible, call `handle.unfocus({ target })`. Passing `{ target: null }` releases the overlay without focusing another component.
2827
-
2828
- See [tui.md](/docs/latest/tui) for the full `OverlayOptions` and `OverlayHandle` API and [overlay-qa-tests.ts](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/examples/extensions/overlay-qa-tests.ts) for examples.
2829
-
2830
- ### Custom Editor
2831
-
2832
- Replace the main input editor with a custom implementation (vim mode, emacs mode, etc.):
2833
-
2834
- ```
2835
- import { CustomEditor, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
2836
- import { matchesKey } from "@earendil-works/pi-tui";
2837
-
2838
- class VimEditor extends CustomEditor {
2839
- private mode: "normal" | "insert" = "insert";
2840
-
2841
- handleInput(data: string): void {
2842
- if (matchesKey(data, "escape") && this.mode === "insert") {
2843
- this.mode = "normal";
2844
- return;
2845
- }
2846
- if (this.mode === "normal" && data === "i") {
2847
- this.mode = "insert";
2848
- return;
2849
- }
2850
- super.handleInput(data); // App keybindings + text editing
2851
- }
2852
- }
2853
-
2854
- export default function (pi: ExtensionAPI) {
2855
- pi.on("session_start", (_event, ctx) => {
2856
- ctx.ui.setEditorComponent((tui, theme, keybindings) =>
2857
- new VimEditor(tui, theme, keybindings)
2858
- );
2859
- });
2860
- }
2861
- ```
2862
-
2863
- **Key points:**
2864
-
2865
- - Extend `CustomEditor` (not base `Editor`) to get app keybindings (escape to abort, ctrl+d, model switching)
2866
- - Call `super.handleInput(data)` for keys you don't handle
2867
- - Custom editors keep the standalone working row by default. Pass `{ embedWorkingStatus: true }` as the fourth `CustomEditor` constructor argument to use the built-in editor-border spinner instead.
2868
- - Factory receives `tui`, `theme`, and `keybindings` from the app
2869
- - Use `ctx.ui.getEditorComponent()` before `setEditorComponent()` to wrap the previously configured custom editor
2870
- - Pass `undefined` to restore default: `ctx.ui.setEditorComponent(undefined)`
2871
-
2872
- To compose with another extension that already replaced the editor, capture the previous factory before setting yours:
2873
-
2874
- ```
2875
- const previous = ctx.ui.getEditorComponent();
2876
- ctx.ui.setEditorComponent((tui, theme, keybindings) =>
2877
- new MyEditor(tui, theme, keybindings, { base: previous?.(tui, theme, keybindings) })
2878
- );
2879
- ```
2880
-
2881
- See [tui.md](/docs/latest/tui) Pattern 7 for a complete example with mode indicator.
2882
-
2883
- ### Message and Entry Rendering
2884
-
2885
- Register a custom renderer for messages with your `customType`. Use message renderers for content that should participate in LLM context:
2886
-
2887
- ```
2888
- import { Text } from "@earendil-works/pi-tui";
2889
-
2890
- pi.registerMessageRenderer("my-extension", (message, options, theme) => {
2891
- const { expanded, outputPad } = options;
2892
- let text = theme.fg("accent", `[${message.customType}] `);
2893
- text += message.content;
2894
-
2895
- if (expanded && message.details) {
2896
- text += "\n" + theme.fg("dim", JSON.stringify(message.details, null, 2));
2897
- }
2898
-
2899
- return new Text(text, outputPad, 0);
2900
- });
2901
- ```
2902
-
2903
- Messages are sent via `pi.sendMessage()`:
2904
-
2905
- ```
2906
- pi.sendMessage({
2907
- customType: "my-extension", // Matches registerMessageRenderer
2908
- content: "Status update",
2909
- display: true, // Show in TUI
2910
- details: { ... }, // Available in renderer
2911
- });
2912
- ```
2913
-
2914
- For TUI-only content that should not be sent to the LLM, render custom entries instead:
2915
-
2916
- ```
2917
- pi.registerEntryRenderer("my-card", (entry, options, theme) => {
2918
- return new Text(theme.fg("accent", JSON.stringify(entry.data)));
2919
- });
2920
-
2921
- pi.appendEntry("my-card", { status: "done" });
2922
- ```
2923
-
2924
- ### Theme Colors
2925
-
2926
- All render functions receive a `theme` object. See [themes.md](/docs/latest/themes) for creating custom themes and the full color palette.
2927
-
2928
- ```
2929
- // Foreground colors
2930
- theme.fg("toolTitle", text) // Tool names
2931
- theme.fg("accent", text) // Highlights
2932
- theme.fg("success", text) // Success (green)
2933
- theme.fg("error", text) // Errors (red)
2934
- theme.fg("warning", text) // Warnings (yellow)
2935
- theme.fg("muted", text) // Secondary text
2936
- theme.fg("dim", text) // Tertiary text
2937
-
2938
- // Text styles
2939
- theme.bold(text)
2940
- theme.italic(text)
2941
- theme.strikethrough(text)
2942
- ```
2943
-
2944
- For syntax highlighting in custom tool renderers:
2945
-
2946
- ```
2947
- import { highlightCode, getLanguageFromPath } from "@earendil-works/pi-coding-agent";
2948
-
2949
- // Highlight code with explicit language
2950
- const highlighted = highlightCode("const x = 1;", "typescript", theme);
2951
-
2952
- // Auto-detect language from file path
2953
- const lang = getLanguageFromPath("/path/to/file.rs"); // "rust"
2954
- const highlighted = highlightCode(code, lang, theme);
2955
- ```
2956
-
2957
- ## Error Handling
2958
-
2959
- - Extension errors are logged, agent continues
2960
- - `tool_call` errors block the tool (fail-safe)
2961
- - Tool `execute` errors must be signaled by throwing; the thrown error is caught, reported to the LLM with `isError: true`, and execution continues
2962
-
2963
- ## Mode Behavior
2964
-
2965
- | Mode | `ctx.mode` | `ctx.hasUI` | Notes |
2966
- | --- | --- | --- | --- |
2967
- | Interactive | `"tui"` | `true` | Full TUI with terminal rendering |
2968
- | RPC (`--mode rpc`) | `"rpc"` | `true` | Dialogs and notifications via JSON protocol; `custom()` returns `undefined`. See [rpc.md](/docs/latest/rpc) |
2969
- | JSON (`--mode json`) | `"json"` | `false` | Event stream to stdout; UI methods are no-ops |
2970
- | Print (`-p`) | `"print"` | `false` | Extensions run but can't prompt |
2971
-
2972
- Use `ctx.mode === "tui"` before TUI-specific features (`custom()`, component factories, terminal input). Use `ctx.hasUI` before dialog and notification methods that work in both TUI and RPC modes.
2973
-
2974
- ## Examples Reference
2975
-
2976
- All examples in [examples/extensions/](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/examples/extensions).
2977
-
2978
- | Example | Description | Key APIs |
2979
- | --- | --- | --- |
2980
- | **Tools** | | |
2981
- | `hello.ts` | Minimal tool registration | `registerTool` |
2982
- | `question.ts` | Tool with user interaction | `registerTool`, `ui.select` |
2983
- | `questionnaire.ts` | Multi-step wizard tool | `registerTool`, `ui.custom` |
2984
- | `todo.ts` | Stateful tool with persistence | `registerTool`, `appendEntry`, `renderResult`, session events |
2985
- | `dynamic-tools.ts` | Register tools after startup and during commands | `registerTool`, `session_start`, `registerCommand` |
2986
- | `structured-output.ts` | Final structured-output tool with `terminate: true` | `registerTool`, terminating tool results |
2987
- | `truncated-tool.ts` | Output truncation example | `registerTool`, `truncateHead` |
2988
- | `tool-override.ts` | Override built-in read tool | `registerTool` (same name as built-in) |
2989
- | **Commands** | | |
2990
- | `pirate.ts` | Modify system prompt per-turn | `registerCommand`, `before_agent_start` |
2991
- | `summarize.ts` | Conversation summary command | `registerCommand`, `ui.custom` |
2992
- | `handoff.ts` | Cross-provider model handoff | `registerCommand`, `ui.editor`, `ui.custom` |
2993
- | `qna.ts` | Q&A with custom UI | `registerCommand`, `ui.custom`, `setEditorText` |
2994
- | `send-user-message.ts` | Inject user messages | `registerCommand`, `sendUserMessage` |
2995
- | `reload-runtime.ts` | Reload command and LLM tool handoff | `registerCommand`, `ctx.reload()`, `sendUserMessage` |
2996
- | `shutdown-command.ts` | Graceful shutdown command | `registerCommand`, `shutdown()` |
2997
- | **Events & Gates** | | |
2998
- | `permission-gate.ts` | Block dangerous commands | `on("tool_call")`, `ui.confirm` |
2999
- | `project-trust.ts` | Decide or defer project trust from a user/global or CLI extension | `on("project_trust")`, trust UI, required trust result |
3000
- | `protected-paths.ts` | Block writes to specific paths | `on("tool_call")` |
3001
- | `confirm-destructive.ts` | Confirm session changes | `on("session_before_switch")`, `on("session_before_fork")` |
3002
- | `dirty-repo-guard.ts` | Warn on dirty git repo | `on("session_before_*")`, `exec` |
3003
- | `input-transform.ts` | Transform user input | `on("input")` |
3004
- | `input-transform-streaming.ts` | Streaming-aware input transform | `on("input")`, `streamingBehavior` |
3005
- | `model-status.ts` | React to model changes | `on("model_select")`, `setStatus` |
3006
- | `provider-payload.ts` | Inspect payloads and provider response headers | `on("before_provider_request")`, `on("after_provider_response")` |
3007
- | `system-prompt-header.ts` | Display system prompt info | `on("agent_start")`, `getSystemPrompt` |
3008
- | `claude-rules.ts` | Load rules from files | `on("session_start")`, `on("before_agent_start")` |
3009
- | `prompt-customizer.ts` | Add context-aware tool guidance using `systemPromptOptions` | `on("before_agent_start")`, `BuildSystemPromptOptions` |
3010
- | `file-trigger.ts` | File watcher triggers messages | `sendMessage` |
3011
- | **Compaction & Sessions** | | |
3012
- | `custom-compaction.ts` | Custom compaction summary | `on("session_before_compact")` |
3013
- | `trigger-compact.ts` | Trigger compaction manually | `compact()` |
3014
- | `git-checkpoint.ts` | Git stash on turns | `on("turn_start")`, `on("session_before_fork")`, `exec` |
3015
- | `git-merge-and-resolve.ts` | Fetch, merge, and resolve conflicts | `on("agent_end")`, `exec`, `sendUserMessage` |
3016
- | `auto-commit-on-exit.ts` | Commit on shutdown | `on("session_shutdown")`, `exec` |
3017
- | **UI Components** | | |
3018
- | `status-line.ts` | Footer status indicator | `setStatus`, session events |
3019
- | `working-indicator.ts` | Customize the streaming working indicator | `setWorkingIndicator`, `registerCommand` |
3020
- | `github-issue-autocomplete.ts` | Add `#1234` issue completions on top of built-in autocomplete by preloading recent open issues from `gh issue list` | `addAutocompleteProvider`, `on("session_start")`, `exec` |
3021
- | `custom-footer.ts` | Replace footer entirely | `registerCommand`, `setFooter` |
3022
- | `custom-header.ts` | Replace startup header | `on("session_start")`, `setHeader` |
3023
- | `modal-editor.ts` | Vim-style modal editor | `setEditorComponent`, `CustomEditor` |
3024
- | `rainbow-editor.ts` | Custom editor styling | `setEditorComponent` |
3025
- | `widget-placement.ts` | Widget above/below editor | `setWidget` |
3026
- | `overlay-test.ts` | Overlay components | `ui.custom` with overlay options |
3027
- | `overlay-qa-tests.ts` | Comprehensive overlay tests | `ui.custom`, all overlay options |
3028
- | `notify.ts` | Simple notifications | `ui.notify` |
3029
- | `timed-confirm.ts` | Dialogs with timeout | `ui.confirm` with timeout/signal |
3030
- | `mac-system-theme.ts` | Auto-switch theme | `setTheme`, `exec` |
3031
- | **Complex Extensions** | | |
3032
- | `plan-mode/` | Full plan mode implementation | All event types, `registerCommand`, `registerShortcut`, `registerFlag`, `setStatus`, `setWidget`, `sendMessage`, `setActiveTools` |
3033
- | `preset.ts` | Saveable presets (model, tools, thinking) | `registerCommand`, `registerShortcut`, `registerFlag`, `setModel`, `setActiveTools`, `setThinkingLevel`, `appendEntry` |
3034
- | `tools.ts` | Toggle tools on/off UI | `registerCommand`, `setActiveTools`, `SettingsList`, session events |
3035
- | **Remote & Sandbox** | | |
3036
- | `ssh.ts` | SSH remote execution | `registerFlag`, `on("user_bash")`, `on("before_agent_start")`, tool operations |
3037
- | `interactive-shell.ts` | Persistent shell session | `on("user_bash")` |
3038
- | `sandbox/` | Sandboxed tool execution | Tool operations |
3039
- | `gondolin/` | Route built-in tools and `!` commands into a Gondolin micro-VM | Tool operations, built-in tool overrides, `on("user_bash")` |
3040
- | `subagent/` | Spawn sub-agents | `registerTool`, `exec` |
3041
- | **Games** | | |
3042
- | `snake.ts` | Snake game | `registerCommand`, `ui.custom`, keyboard handling |
3043
- | `space-invaders.ts` | Space Invaders game | `registerCommand`, `ui.custom` |
3044
- | `doom-overlay/` | Doom in overlay | `ui.custom` with overlay |
3045
- | **Providers** | | |
3046
- | `custom-provider-anthropic/` | Custom Anthropic proxy | `registerProvider` |
3047
- | `custom-provider-gitlab-duo/` | GitLab Duo integration | `registerProvider` with OAuth |
3048
- | **Messages & Communication** | | |
3049
- | `message-renderer.ts` | Custom message rendering | `registerMessageRenderer`, `sendMessage` |
3050
- | `entry-renderer.ts` | TUI-only custom entry rendering | `registerEntryRenderer`, `appendEntry` |
3051
- | `event-bus.ts` | Inter-extension events | `pi.events` |
3052
- | **Session Metadata** | | |
3053
- | `session-name.ts` | Name sessions for selector | `setSessionName`, `getSessionName` |
3054
- | `bookmark.ts` | Bookmark entries for /tree | `setLabel` |
3055
- | **Misc** | | |
3056
- | `inline-bash.ts` | Inline bash in tool calls | `on("tool_call")` |
3057
- | `bash-spawn-hook.ts` | Adjust bash command, cwd, and env before execution | `createBashTool`, `spawnHook` |
3058
- | `with-deps/` | Extension with npm dependencies | Package structure with `package.json` |