gsd-pi 2.29.0-next.1 → 2.30.0-dev.54ac83b

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 (467) hide show
  1. package/README.md +27 -12
  2. package/dist/cli.js +66 -9
  3. package/dist/extension-registry.d.ts +63 -0
  4. package/dist/extension-registry.js +166 -0
  5. package/dist/headless-query.d.ts +4 -0
  6. package/dist/headless-query.js +22 -4
  7. package/dist/headless.js +4 -0
  8. package/dist/help-text.js +35 -0
  9. package/dist/loader.js +10 -1
  10. package/dist/resource-loader.js +91 -9
  11. package/dist/resources/extensions/async-jobs/extension-manifest.json +13 -0
  12. package/dist/resources/extensions/aws-auth/index.ts +144 -0
  13. package/dist/resources/extensions/bg-shell/extension-manifest.json +14 -0
  14. package/dist/resources/extensions/bg-shell/process-manager.ts +13 -0
  15. package/dist/resources/extensions/browser-tools/capture.ts +34 -2
  16. package/dist/resources/extensions/browser-tools/extension-manifest.json +37 -0
  17. package/dist/resources/extensions/browser-tools/tests/browser-tools-integration.test.mjs +1 -1
  18. package/dist/resources/extensions/browser-tools/tests/browser-tools-unit.test.cjs +3 -3
  19. package/dist/resources/extensions/browser-tools/tools/screenshot.ts +28 -10
  20. package/dist/resources/extensions/context7/extension-manifest.json +12 -0
  21. package/dist/resources/extensions/google-search/extension-manifest.json +12 -0
  22. package/dist/resources/extensions/google-search/index.ts +21 -8
  23. package/dist/resources/extensions/gsd/auto/session.ts +2 -0
  24. package/dist/resources/extensions/gsd/auto-dashboard.ts +109 -2
  25. package/dist/resources/extensions/gsd/auto-dispatch.ts +32 -3
  26. package/dist/resources/extensions/gsd/auto-post-unit.ts +53 -16
  27. package/dist/resources/extensions/gsd/auto-prompts.ts +51 -17
  28. package/dist/resources/extensions/gsd/auto-recovery.ts +35 -24
  29. package/dist/resources/extensions/gsd/auto-start.ts +68 -54
  30. package/dist/resources/extensions/gsd/auto-verification.ts +41 -7
  31. package/dist/resources/extensions/gsd/auto-worktree.ts +54 -183
  32. package/dist/resources/extensions/gsd/auto.ts +101 -31
  33. package/dist/resources/extensions/gsd/captures.ts +4 -10
  34. package/dist/resources/extensions/gsd/commands-extensions.ts +328 -0
  35. package/dist/resources/extensions/gsd/commands-handlers.ts +5 -12
  36. package/dist/resources/extensions/gsd/commands-logs.ts +536 -0
  37. package/dist/resources/extensions/gsd/commands-prefs-wizard.ts +90 -47
  38. package/dist/resources/extensions/gsd/commands-workflow-templates.ts +544 -0
  39. package/dist/resources/extensions/gsd/commands.ts +200 -33
  40. package/dist/resources/extensions/gsd/dashboard-overlay.ts +7 -2
  41. package/dist/resources/extensions/gsd/detection.ts +2 -1
  42. package/dist/resources/extensions/gsd/dispatch-guard.ts +4 -0
  43. package/dist/resources/extensions/gsd/doctor-checks.ts +49 -1
  44. package/dist/resources/extensions/gsd/doctor-types.ts +16 -1
  45. package/dist/resources/extensions/gsd/doctor.ts +2 -6
  46. package/dist/resources/extensions/gsd/export.ts +31 -5
  47. package/dist/resources/extensions/gsd/extension-manifest.json +18 -0
  48. package/dist/resources/extensions/gsd/forensics.ts +2 -2
  49. package/dist/resources/extensions/gsd/git-service.ts +3 -2
  50. package/dist/resources/extensions/gsd/gitignore.ts +9 -63
  51. package/dist/resources/extensions/gsd/gsd-db.ts +12 -157
  52. package/dist/resources/extensions/gsd/guided-flow-queue.ts +4 -0
  53. package/dist/resources/extensions/gsd/guided-flow.ts +37 -8
  54. package/dist/resources/extensions/gsd/index.ts +136 -35
  55. package/dist/resources/extensions/gsd/json-persistence.ts +67 -0
  56. package/dist/resources/extensions/gsd/md-importer.ts +3 -2
  57. package/dist/resources/extensions/gsd/mechanical-completion.ts +430 -0
  58. package/dist/resources/extensions/gsd/metrics.ts +22 -31
  59. package/dist/resources/extensions/gsd/migrate/command.ts +3 -2
  60. package/dist/resources/extensions/gsd/migrate/writer.ts +2 -1
  61. package/dist/resources/extensions/gsd/migrate-external.ts +123 -0
  62. package/dist/resources/extensions/gsd/paths.ts +24 -10
  63. package/dist/resources/extensions/gsd/post-unit-hooks.ts +6 -5
  64. package/dist/resources/extensions/gsd/preferences-models.ts +7 -1
  65. package/dist/resources/extensions/gsd/preferences-validation.ts +2 -1
  66. package/dist/resources/extensions/gsd/preferences.ts +10 -5
  67. package/dist/resources/extensions/gsd/prompts/discuss-headless.md +4 -2
  68. package/dist/resources/extensions/gsd/prompts/discuss.md +10 -0
  69. package/dist/resources/extensions/gsd/prompts/guided-discuss-milestone.md +1 -1
  70. package/dist/resources/extensions/gsd/prompts/plan-milestone.md +26 -2
  71. package/dist/resources/extensions/gsd/prompts/plan-slice.md +15 -1
  72. package/dist/resources/extensions/gsd/prompts/queue.md +30 -0
  73. package/dist/resources/extensions/gsd/prompts/workflow-start.md +28 -0
  74. package/dist/resources/extensions/gsd/queue-order.ts +10 -11
  75. package/dist/resources/extensions/gsd/queue-reorder-ui.ts +14 -1
  76. package/dist/resources/extensions/gsd/quick.ts +18 -15
  77. package/dist/resources/extensions/gsd/repo-identity.ts +148 -0
  78. package/dist/resources/extensions/gsd/resource-version.ts +99 -0
  79. package/dist/resources/extensions/gsd/roadmap-slices.ts +22 -7
  80. package/dist/resources/extensions/gsd/routing-history.ts +13 -17
  81. package/dist/resources/extensions/gsd/session-forensics.ts +4 -3
  82. package/dist/resources/extensions/gsd/session-lock.ts +333 -0
  83. package/dist/resources/extensions/gsd/session-status-io.ts +23 -41
  84. package/dist/resources/extensions/gsd/tests/activity-log.test.ts +2 -2
  85. package/dist/resources/extensions/gsd/tests/all-milestones-complete-merge.test.ts +3 -0
  86. package/dist/resources/extensions/gsd/tests/auto-budget-alerts.test.ts +1 -1
  87. package/dist/resources/extensions/gsd/tests/auto-recovery.test.ts +3 -3
  88. package/dist/resources/extensions/gsd/tests/auto-secrets-gate.test.ts +108 -2
  89. package/dist/resources/extensions/gsd/tests/auto-skip-loop.test.ts +1 -1
  90. package/dist/resources/extensions/gsd/tests/auto-worktree-milestone-merge.test.ts +3 -0
  91. package/dist/resources/extensions/gsd/tests/auto-worktree.test.ts +0 -58
  92. package/dist/resources/extensions/gsd/tests/commands-logs.test.ts +241 -0
  93. package/dist/resources/extensions/gsd/tests/dispatch-guard.test.ts +55 -0
  94. package/dist/resources/extensions/gsd/tests/doctor-runtime.test.ts +3 -4
  95. package/dist/resources/extensions/gsd/tests/export-html-enhancements.test.ts +1 -0
  96. package/dist/resources/extensions/gsd/tests/extension-selector-separator.test.ts +60 -38
  97. package/dist/resources/extensions/gsd/tests/feature-branch-lifecycle-integration.test.ts +8 -18
  98. package/dist/resources/extensions/gsd/tests/git-service.test.ts +10 -37
  99. package/dist/resources/extensions/gsd/tests/gsd-inspect.test.ts +1 -1
  100. package/dist/resources/extensions/gsd/tests/knowledge.test.ts +4 -4
  101. package/dist/resources/extensions/gsd/tests/mechanical-completion.test.ts +356 -0
  102. package/dist/resources/extensions/gsd/tests/milestone-transition-worktree.test.ts +3 -0
  103. package/dist/resources/extensions/gsd/tests/parallel-merge.test.ts +3 -0
  104. package/dist/resources/extensions/gsd/tests/parallel-workers-multi-milestone-e2e.test.ts +1 -1
  105. package/dist/resources/extensions/gsd/tests/plan-slice-prompt.test.ts +1 -0
  106. package/dist/resources/extensions/gsd/tests/reassess-detection.test.ts +154 -0
  107. package/dist/resources/extensions/gsd/tests/session-lock.test.ts +315 -0
  108. package/dist/resources/extensions/gsd/tests/stale-worktree-cwd.test.ts +3 -0
  109. package/dist/resources/extensions/gsd/tests/token-profile.test.ts +14 -16
  110. package/dist/resources/extensions/gsd/tests/validate-milestone.test.ts +55 -0
  111. package/dist/resources/extensions/gsd/tests/verification-evidence.test.ts +26 -24
  112. package/dist/resources/extensions/gsd/tests/verification-gate.test.ts +136 -7
  113. package/dist/resources/extensions/gsd/tests/visualizer-views.test.ts +2 -1
  114. package/dist/resources/extensions/gsd/tests/workflow-templates.test.ts +173 -0
  115. package/dist/resources/extensions/gsd/tests/worktree-e2e.test.ts +3 -0
  116. package/dist/resources/extensions/gsd/tests/write-gate.test.ts +132 -43
  117. package/dist/resources/extensions/gsd/triage-resolution.ts +2 -1
  118. package/dist/resources/extensions/gsd/types.ts +3 -0
  119. package/dist/resources/extensions/gsd/unit-runtime.ts +16 -13
  120. package/dist/resources/extensions/gsd/verification-evidence.ts +2 -0
  121. package/dist/resources/extensions/gsd/verification-gate.ts +16 -4
  122. package/dist/resources/extensions/gsd/workflow-templates/bugfix.md +87 -0
  123. package/dist/resources/extensions/gsd/workflow-templates/dep-upgrade.md +74 -0
  124. package/dist/resources/extensions/gsd/workflow-templates/full-project.md +41 -0
  125. package/dist/resources/extensions/gsd/workflow-templates/hotfix.md +45 -0
  126. package/dist/resources/extensions/gsd/workflow-templates/refactor.md +83 -0
  127. package/dist/resources/extensions/gsd/workflow-templates/registry.json +85 -0
  128. package/dist/resources/extensions/gsd/workflow-templates/security-audit.md +73 -0
  129. package/dist/resources/extensions/gsd/workflow-templates/small-feature.md +81 -0
  130. package/dist/resources/extensions/gsd/workflow-templates/spike.md +69 -0
  131. package/dist/resources/extensions/gsd/workflow-templates.ts +241 -0
  132. package/dist/resources/extensions/gsd/worktree-command.ts +1 -11
  133. package/dist/resources/extensions/gsd/worktree-manager.ts +3 -2
  134. package/dist/resources/extensions/gsd/worktree.ts +42 -5
  135. package/dist/resources/extensions/mac-tools/extension-manifest.json +16 -0
  136. package/dist/resources/extensions/mcp-client/index.ts +459 -0
  137. package/dist/resources/extensions/mcporter/extension-manifest.json +12 -0
  138. package/dist/resources/extensions/remote-questions/discord-adapter.ts +9 -20
  139. package/dist/resources/extensions/remote-questions/extension-manifest.json +11 -0
  140. package/dist/resources/extensions/remote-questions/http-client.ts +76 -0
  141. package/dist/resources/extensions/remote-questions/mod.ts +1 -0
  142. package/dist/resources/extensions/remote-questions/notify.ts +90 -0
  143. package/dist/resources/extensions/remote-questions/slack-adapter.ts +11 -18
  144. package/dist/resources/extensions/remote-questions/telegram-adapter.ts +8 -20
  145. package/dist/resources/extensions/remote-questions/types.ts +3 -0
  146. package/dist/resources/extensions/search-the-web/extension-manifest.json +13 -0
  147. package/dist/resources/extensions/shared/format-utils.ts +9 -0
  148. package/dist/resources/extensions/shared/mod.ts +4 -0
  149. package/dist/resources/extensions/slash-commands/extension-manifest.json +11 -0
  150. package/dist/resources/extensions/subagent/extension-manifest.json +13 -0
  151. package/dist/resources/extensions/ttsr/extension-manifest.json +11 -0
  152. package/dist/resources/extensions/universal-config/extension-manifest.json +13 -0
  153. package/dist/resources/extensions/voice/extension-manifest.json +12 -0
  154. package/dist/resources/skills/create-gsd-extension/SKILL.md +87 -0
  155. package/dist/resources/skills/create-gsd-extension/references/compaction-session-control.md +77 -0
  156. package/dist/resources/skills/create-gsd-extension/references/custom-commands.md +139 -0
  157. package/dist/resources/skills/create-gsd-extension/references/custom-rendering.md +108 -0
  158. package/dist/resources/skills/create-gsd-extension/references/custom-tools.md +183 -0
  159. package/dist/resources/skills/create-gsd-extension/references/custom-ui.md +490 -0
  160. package/dist/resources/skills/create-gsd-extension/references/events-reference.md +126 -0
  161. package/dist/resources/skills/create-gsd-extension/references/extension-lifecycle.md +64 -0
  162. package/dist/resources/skills/create-gsd-extension/references/extensionapi-reference.md +75 -0
  163. package/dist/resources/skills/create-gsd-extension/references/extensioncontext-reference.md +53 -0
  164. package/dist/resources/skills/create-gsd-extension/references/key-rules-gotchas.md +36 -0
  165. package/dist/resources/skills/create-gsd-extension/references/mode-behavior.md +32 -0
  166. package/dist/resources/skills/create-gsd-extension/references/model-provider-management.md +89 -0
  167. package/dist/resources/skills/create-gsd-extension/references/packaging-distribution.md +55 -0
  168. package/dist/resources/skills/create-gsd-extension/references/remote-execution-overrides.md +90 -0
  169. package/dist/resources/skills/create-gsd-extension/references/state-management.md +70 -0
  170. package/dist/resources/skills/create-gsd-extension/references/system-prompt-modification.md +52 -0
  171. package/dist/resources/skills/create-gsd-extension/templates/extension-skeleton.ts +51 -0
  172. package/dist/resources/skills/create-gsd-extension/templates/stateful-tool-skeleton.ts +143 -0
  173. package/dist/resources/skills/create-gsd-extension/workflows/add-capability.md +57 -0
  174. package/dist/resources/skills/create-gsd-extension/workflows/create-extension.md +156 -0
  175. package/dist/resources/skills/create-gsd-extension/workflows/debug-extension.md +74 -0
  176. package/dist/resources/skills/create-skill/SKILL.md +184 -0
  177. package/dist/resources/skills/create-skill/references/api-security.md +226 -0
  178. package/dist/resources/skills/create-skill/references/be-clear-and-direct.md +531 -0
  179. package/dist/resources/skills/create-skill/references/common-patterns.md +595 -0
  180. package/dist/resources/skills/create-skill/references/core-principles.md +437 -0
  181. package/dist/resources/skills/create-skill/references/executable-code.md +175 -0
  182. package/dist/resources/skills/create-skill/references/gsd-skill-ecosystem.md +68 -0
  183. package/dist/resources/skills/create-skill/references/iteration-and-testing.md +474 -0
  184. package/dist/resources/skills/create-skill/references/recommended-structure.md +168 -0
  185. package/dist/resources/skills/create-skill/references/skill-structure.md +372 -0
  186. package/dist/resources/skills/create-skill/references/use-xml-tags.md +466 -0
  187. package/dist/resources/skills/create-skill/references/using-scripts.md +113 -0
  188. package/dist/resources/skills/create-skill/references/using-templates.md +112 -0
  189. package/dist/resources/skills/create-skill/references/workflows-and-validation.md +510 -0
  190. package/dist/resources/skills/create-skill/templates/router-skill.md +73 -0
  191. package/dist/resources/skills/create-skill/templates/simple-skill.md +33 -0
  192. package/dist/resources/skills/create-skill/workflows/add-reference.md +96 -0
  193. package/dist/resources/skills/create-skill/workflows/add-script.md +93 -0
  194. package/dist/resources/skills/create-skill/workflows/add-template.md +74 -0
  195. package/dist/resources/skills/create-skill/workflows/add-workflow.md +120 -0
  196. package/dist/resources/skills/create-skill/workflows/audit-skill.md +148 -0
  197. package/dist/resources/skills/create-skill/workflows/create-new-skill.md +196 -0
  198. package/dist/resources/skills/create-skill/workflows/get-guidance.md +121 -0
  199. package/dist/resources/skills/create-skill/workflows/upgrade-to-router.md +161 -0
  200. package/dist/resources/skills/create-skill/workflows/verify-skill.md +204 -0
  201. package/dist/resources/skills/react-best-practices/SKILL.md +1 -1
  202. package/dist/worktree-cli.d.ts +34 -0
  203. package/dist/worktree-cli.js +294 -0
  204. package/dist/worktree-name-gen.d.ts +7 -0
  205. package/dist/worktree-name-gen.js +44 -0
  206. package/package.json +10 -4
  207. package/packages/native/dist/native.d.ts +2 -0
  208. package/packages/native/dist/native.js +19 -5
  209. package/packages/native/src/native.ts +23 -9
  210. package/packages/pi-coding-agent/dist/core/agent-session.d.ts.map +1 -1
  211. package/packages/pi-coding-agent/dist/core/agent-session.js +14 -0
  212. package/packages/pi-coding-agent/dist/core/agent-session.js.map +1 -1
  213. package/packages/pi-coding-agent/dist/core/extensions/loader.d.ts.map +1 -1
  214. package/packages/pi-coding-agent/dist/core/extensions/loader.js +17 -0
  215. package/packages/pi-coding-agent/dist/core/extensions/loader.js.map +1 -1
  216. package/packages/pi-coding-agent/dist/core/extensions/runner.d.ts.map +1 -1
  217. package/packages/pi-coding-agent/dist/core/extensions/runner.js +1 -0
  218. package/packages/pi-coding-agent/dist/core/extensions/runner.js.map +1 -1
  219. package/packages/pi-coding-agent/dist/core/extensions/types.d.ts +7 -0
  220. package/packages/pi-coding-agent/dist/core/extensions/types.d.ts.map +1 -1
  221. package/packages/pi-coding-agent/dist/core/extensions/types.js.map +1 -1
  222. package/packages/pi-coding-agent/dist/core/lsp/client.d.ts.map +1 -1
  223. package/packages/pi-coding-agent/dist/core/lsp/client.js +3 -0
  224. package/packages/pi-coding-agent/dist/core/lsp/client.js.map +1 -1
  225. package/packages/pi-coding-agent/dist/core/lsp/lspmux.d.ts.map +1 -1
  226. package/packages/pi-coding-agent/dist/core/lsp/lspmux.js +10 -1
  227. package/packages/pi-coding-agent/dist/core/lsp/lspmux.js.map +1 -1
  228. package/packages/pi-coding-agent/dist/core/model-resolver.d.ts.map +1 -1
  229. package/packages/pi-coding-agent/dist/core/model-resolver.js +14 -0
  230. package/packages/pi-coding-agent/dist/core/model-resolver.js.map +1 -1
  231. package/packages/pi-coding-agent/dist/core/settings-manager.d.ts +3 -0
  232. package/packages/pi-coding-agent/dist/core/settings-manager.d.ts.map +1 -1
  233. package/packages/pi-coding-agent/dist/core/settings-manager.js +8 -0
  234. package/packages/pi-coding-agent/dist/core/settings-manager.js.map +1 -1
  235. package/packages/pi-coding-agent/dist/core/system-prompt.d.ts.map +1 -1
  236. package/packages/pi-coding-agent/dist/core/system-prompt.js +10 -0
  237. package/packages/pi-coding-agent/dist/core/system-prompt.js.map +1 -1
  238. package/packages/pi-coding-agent/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  239. package/packages/pi-coding-agent/dist/modes/interactive/interactive-mode.js +4 -1
  240. package/packages/pi-coding-agent/dist/modes/interactive/interactive-mode.js.map +1 -1
  241. package/packages/pi-coding-agent/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  242. package/packages/pi-coding-agent/dist/modes/rpc/rpc-mode.js +12 -2
  243. package/packages/pi-coding-agent/dist/modes/rpc/rpc-mode.js.map +1 -1
  244. package/packages/pi-coding-agent/package.json +1 -1
  245. package/packages/pi-coding-agent/scripts/copy-assets.cjs +39 -8
  246. package/packages/pi-coding-agent/src/core/agent-session.ts +14 -0
  247. package/packages/pi-coding-agent/src/core/extensions/loader.ts +18 -0
  248. package/packages/pi-coding-agent/src/core/extensions/runner.ts +1 -0
  249. package/packages/pi-coding-agent/src/core/extensions/types.ts +8 -0
  250. package/packages/pi-coding-agent/src/core/lsp/client.ts +3 -0
  251. package/packages/pi-coding-agent/src/core/lsp/lspmux.ts +10 -1
  252. package/packages/pi-coding-agent/src/core/model-resolver.ts +14 -0
  253. package/packages/pi-coding-agent/src/core/settings-manager.ts +11 -0
  254. package/packages/pi-coding-agent/src/core/system-prompt.ts +11 -0
  255. package/packages/pi-coding-agent/src/modes/interactive/interactive-mode.ts +4 -1
  256. package/packages/pi-coding-agent/src/modes/rpc/rpc-mode.ts +11 -2
  257. package/packages/pi-tui/dist/autocomplete.d.ts +3 -0
  258. package/packages/pi-tui/dist/autocomplete.d.ts.map +1 -1
  259. package/packages/pi-tui/dist/autocomplete.js +14 -0
  260. package/packages/pi-tui/dist/autocomplete.js.map +1 -1
  261. package/packages/pi-tui/src/autocomplete.ts +19 -1
  262. package/pkg/package.json +1 -1
  263. package/src/resources/extensions/async-jobs/extension-manifest.json +13 -0
  264. package/src/resources/extensions/aws-auth/index.ts +144 -0
  265. package/src/resources/extensions/bg-shell/extension-manifest.json +14 -0
  266. package/src/resources/extensions/bg-shell/process-manager.ts +13 -0
  267. package/src/resources/extensions/browser-tools/capture.ts +34 -2
  268. package/src/resources/extensions/browser-tools/extension-manifest.json +37 -0
  269. package/src/resources/extensions/browser-tools/tests/browser-tools-integration.test.mjs +1 -1
  270. package/src/resources/extensions/browser-tools/tests/browser-tools-unit.test.cjs +3 -3
  271. package/src/resources/extensions/browser-tools/tools/screenshot.ts +28 -10
  272. package/src/resources/extensions/context7/extension-manifest.json +12 -0
  273. package/src/resources/extensions/google-search/extension-manifest.json +12 -0
  274. package/src/resources/extensions/google-search/index.ts +21 -8
  275. package/src/resources/extensions/gsd/auto/session.ts +2 -0
  276. package/src/resources/extensions/gsd/auto-dashboard.ts +109 -2
  277. package/src/resources/extensions/gsd/auto-dispatch.ts +32 -3
  278. package/src/resources/extensions/gsd/auto-post-unit.ts +53 -16
  279. package/src/resources/extensions/gsd/auto-prompts.ts +51 -17
  280. package/src/resources/extensions/gsd/auto-recovery.ts +35 -24
  281. package/src/resources/extensions/gsd/auto-start.ts +68 -54
  282. package/src/resources/extensions/gsd/auto-verification.ts +41 -7
  283. package/src/resources/extensions/gsd/auto-worktree.ts +54 -183
  284. package/src/resources/extensions/gsd/auto.ts +101 -31
  285. package/src/resources/extensions/gsd/captures.ts +4 -10
  286. package/src/resources/extensions/gsd/commands-extensions.ts +328 -0
  287. package/src/resources/extensions/gsd/commands-handlers.ts +5 -12
  288. package/src/resources/extensions/gsd/commands-logs.ts +536 -0
  289. package/src/resources/extensions/gsd/commands-prefs-wizard.ts +90 -47
  290. package/src/resources/extensions/gsd/commands-workflow-templates.ts +544 -0
  291. package/src/resources/extensions/gsd/commands.ts +200 -33
  292. package/src/resources/extensions/gsd/dashboard-overlay.ts +7 -2
  293. package/src/resources/extensions/gsd/detection.ts +2 -1
  294. package/src/resources/extensions/gsd/dispatch-guard.ts +4 -0
  295. package/src/resources/extensions/gsd/doctor-checks.ts +49 -1
  296. package/src/resources/extensions/gsd/doctor-types.ts +16 -1
  297. package/src/resources/extensions/gsd/doctor.ts +2 -6
  298. package/src/resources/extensions/gsd/export.ts +31 -5
  299. package/src/resources/extensions/gsd/extension-manifest.json +18 -0
  300. package/src/resources/extensions/gsd/forensics.ts +2 -2
  301. package/src/resources/extensions/gsd/git-service.ts +3 -2
  302. package/src/resources/extensions/gsd/gitignore.ts +9 -63
  303. package/src/resources/extensions/gsd/gsd-db.ts +12 -157
  304. package/src/resources/extensions/gsd/guided-flow-queue.ts +4 -0
  305. package/src/resources/extensions/gsd/guided-flow.ts +37 -8
  306. package/src/resources/extensions/gsd/index.ts +136 -35
  307. package/src/resources/extensions/gsd/json-persistence.ts +67 -0
  308. package/src/resources/extensions/gsd/md-importer.ts +3 -2
  309. package/src/resources/extensions/gsd/mechanical-completion.ts +430 -0
  310. package/src/resources/extensions/gsd/metrics.ts +22 -31
  311. package/src/resources/extensions/gsd/migrate/command.ts +3 -2
  312. package/src/resources/extensions/gsd/migrate/writer.ts +2 -1
  313. package/src/resources/extensions/gsd/migrate-external.ts +123 -0
  314. package/src/resources/extensions/gsd/paths.ts +24 -10
  315. package/src/resources/extensions/gsd/post-unit-hooks.ts +6 -5
  316. package/src/resources/extensions/gsd/preferences-models.ts +7 -1
  317. package/src/resources/extensions/gsd/preferences-validation.ts +2 -1
  318. package/src/resources/extensions/gsd/preferences.ts +10 -5
  319. package/src/resources/extensions/gsd/prompts/discuss-headless.md +4 -2
  320. package/src/resources/extensions/gsd/prompts/discuss.md +10 -0
  321. package/src/resources/extensions/gsd/prompts/guided-discuss-milestone.md +1 -1
  322. package/src/resources/extensions/gsd/prompts/plan-milestone.md +26 -2
  323. package/src/resources/extensions/gsd/prompts/plan-slice.md +15 -1
  324. package/src/resources/extensions/gsd/prompts/queue.md +30 -0
  325. package/src/resources/extensions/gsd/prompts/workflow-start.md +28 -0
  326. package/src/resources/extensions/gsd/queue-order.ts +10 -11
  327. package/src/resources/extensions/gsd/queue-reorder-ui.ts +14 -1
  328. package/src/resources/extensions/gsd/quick.ts +18 -15
  329. package/src/resources/extensions/gsd/repo-identity.ts +148 -0
  330. package/src/resources/extensions/gsd/resource-version.ts +99 -0
  331. package/src/resources/extensions/gsd/roadmap-slices.ts +22 -7
  332. package/src/resources/extensions/gsd/routing-history.ts +13 -17
  333. package/src/resources/extensions/gsd/session-forensics.ts +4 -3
  334. package/src/resources/extensions/gsd/session-lock.ts +333 -0
  335. package/src/resources/extensions/gsd/session-status-io.ts +23 -41
  336. package/src/resources/extensions/gsd/tests/activity-log.test.ts +2 -2
  337. package/src/resources/extensions/gsd/tests/all-milestones-complete-merge.test.ts +3 -0
  338. package/src/resources/extensions/gsd/tests/auto-budget-alerts.test.ts +1 -1
  339. package/src/resources/extensions/gsd/tests/auto-recovery.test.ts +3 -3
  340. package/src/resources/extensions/gsd/tests/auto-secrets-gate.test.ts +108 -2
  341. package/src/resources/extensions/gsd/tests/auto-skip-loop.test.ts +1 -1
  342. package/src/resources/extensions/gsd/tests/auto-worktree-milestone-merge.test.ts +3 -0
  343. package/src/resources/extensions/gsd/tests/auto-worktree.test.ts +0 -58
  344. package/src/resources/extensions/gsd/tests/commands-logs.test.ts +241 -0
  345. package/src/resources/extensions/gsd/tests/dispatch-guard.test.ts +55 -0
  346. package/src/resources/extensions/gsd/tests/doctor-runtime.test.ts +3 -4
  347. package/src/resources/extensions/gsd/tests/export-html-enhancements.test.ts +1 -0
  348. package/src/resources/extensions/gsd/tests/extension-selector-separator.test.ts +60 -38
  349. package/src/resources/extensions/gsd/tests/feature-branch-lifecycle-integration.test.ts +8 -18
  350. package/src/resources/extensions/gsd/tests/git-service.test.ts +10 -37
  351. package/src/resources/extensions/gsd/tests/gsd-inspect.test.ts +1 -1
  352. package/src/resources/extensions/gsd/tests/knowledge.test.ts +4 -4
  353. package/src/resources/extensions/gsd/tests/mechanical-completion.test.ts +356 -0
  354. package/src/resources/extensions/gsd/tests/milestone-transition-worktree.test.ts +3 -0
  355. package/src/resources/extensions/gsd/tests/parallel-merge.test.ts +3 -0
  356. package/src/resources/extensions/gsd/tests/parallel-workers-multi-milestone-e2e.test.ts +1 -1
  357. package/src/resources/extensions/gsd/tests/plan-slice-prompt.test.ts +1 -0
  358. package/src/resources/extensions/gsd/tests/reassess-detection.test.ts +154 -0
  359. package/src/resources/extensions/gsd/tests/session-lock.test.ts +315 -0
  360. package/src/resources/extensions/gsd/tests/stale-worktree-cwd.test.ts +3 -0
  361. package/src/resources/extensions/gsd/tests/token-profile.test.ts +14 -16
  362. package/src/resources/extensions/gsd/tests/validate-milestone.test.ts +55 -0
  363. package/src/resources/extensions/gsd/tests/verification-evidence.test.ts +26 -24
  364. package/src/resources/extensions/gsd/tests/verification-gate.test.ts +136 -7
  365. package/src/resources/extensions/gsd/tests/visualizer-views.test.ts +2 -1
  366. package/src/resources/extensions/gsd/tests/workflow-templates.test.ts +173 -0
  367. package/src/resources/extensions/gsd/tests/worktree-e2e.test.ts +3 -0
  368. package/src/resources/extensions/gsd/tests/write-gate.test.ts +132 -43
  369. package/src/resources/extensions/gsd/triage-resolution.ts +2 -1
  370. package/src/resources/extensions/gsd/types.ts +3 -0
  371. package/src/resources/extensions/gsd/unit-runtime.ts +16 -13
  372. package/src/resources/extensions/gsd/verification-evidence.ts +2 -0
  373. package/src/resources/extensions/gsd/verification-gate.ts +16 -4
  374. package/src/resources/extensions/gsd/workflow-templates/bugfix.md +87 -0
  375. package/src/resources/extensions/gsd/workflow-templates/dep-upgrade.md +74 -0
  376. package/src/resources/extensions/gsd/workflow-templates/full-project.md +41 -0
  377. package/src/resources/extensions/gsd/workflow-templates/hotfix.md +45 -0
  378. package/src/resources/extensions/gsd/workflow-templates/refactor.md +83 -0
  379. package/src/resources/extensions/gsd/workflow-templates/registry.json +85 -0
  380. package/src/resources/extensions/gsd/workflow-templates/security-audit.md +73 -0
  381. package/src/resources/extensions/gsd/workflow-templates/small-feature.md +81 -0
  382. package/src/resources/extensions/gsd/workflow-templates/spike.md +69 -0
  383. package/src/resources/extensions/gsd/workflow-templates.ts +241 -0
  384. package/src/resources/extensions/gsd/worktree-command.ts +1 -11
  385. package/src/resources/extensions/gsd/worktree-manager.ts +3 -2
  386. package/src/resources/extensions/gsd/worktree.ts +42 -5
  387. package/src/resources/extensions/mac-tools/extension-manifest.json +16 -0
  388. package/src/resources/extensions/mcp-client/index.ts +459 -0
  389. package/src/resources/extensions/mcporter/extension-manifest.json +12 -0
  390. package/src/resources/extensions/remote-questions/discord-adapter.ts +9 -20
  391. package/src/resources/extensions/remote-questions/extension-manifest.json +11 -0
  392. package/src/resources/extensions/remote-questions/http-client.ts +76 -0
  393. package/src/resources/extensions/remote-questions/mod.ts +1 -0
  394. package/src/resources/extensions/remote-questions/notify.ts +90 -0
  395. package/src/resources/extensions/remote-questions/slack-adapter.ts +11 -18
  396. package/src/resources/extensions/remote-questions/telegram-adapter.ts +8 -20
  397. package/src/resources/extensions/remote-questions/types.ts +3 -0
  398. package/src/resources/extensions/search-the-web/extension-manifest.json +13 -0
  399. package/src/resources/extensions/shared/format-utils.ts +9 -0
  400. package/src/resources/extensions/shared/mod.ts +4 -0
  401. package/src/resources/extensions/slash-commands/extension-manifest.json +11 -0
  402. package/src/resources/extensions/subagent/extension-manifest.json +13 -0
  403. package/src/resources/extensions/ttsr/extension-manifest.json +11 -0
  404. package/src/resources/extensions/universal-config/extension-manifest.json +13 -0
  405. package/src/resources/extensions/voice/extension-manifest.json +12 -0
  406. package/src/resources/skills/create-gsd-extension/SKILL.md +87 -0
  407. package/src/resources/skills/create-gsd-extension/references/compaction-session-control.md +77 -0
  408. package/src/resources/skills/create-gsd-extension/references/custom-commands.md +139 -0
  409. package/src/resources/skills/create-gsd-extension/references/custom-rendering.md +108 -0
  410. package/src/resources/skills/create-gsd-extension/references/custom-tools.md +183 -0
  411. package/src/resources/skills/create-gsd-extension/references/custom-ui.md +490 -0
  412. package/src/resources/skills/create-gsd-extension/references/events-reference.md +126 -0
  413. package/src/resources/skills/create-gsd-extension/references/extension-lifecycle.md +64 -0
  414. package/src/resources/skills/create-gsd-extension/references/extensionapi-reference.md +75 -0
  415. package/src/resources/skills/create-gsd-extension/references/extensioncontext-reference.md +53 -0
  416. package/src/resources/skills/create-gsd-extension/references/key-rules-gotchas.md +36 -0
  417. package/src/resources/skills/create-gsd-extension/references/mode-behavior.md +32 -0
  418. package/src/resources/skills/create-gsd-extension/references/model-provider-management.md +89 -0
  419. package/src/resources/skills/create-gsd-extension/references/packaging-distribution.md +55 -0
  420. package/src/resources/skills/create-gsd-extension/references/remote-execution-overrides.md +90 -0
  421. package/src/resources/skills/create-gsd-extension/references/state-management.md +70 -0
  422. package/src/resources/skills/create-gsd-extension/references/system-prompt-modification.md +52 -0
  423. package/src/resources/skills/create-gsd-extension/templates/extension-skeleton.ts +51 -0
  424. package/src/resources/skills/create-gsd-extension/templates/stateful-tool-skeleton.ts +143 -0
  425. package/src/resources/skills/create-gsd-extension/workflows/add-capability.md +57 -0
  426. package/src/resources/skills/create-gsd-extension/workflows/create-extension.md +156 -0
  427. package/src/resources/skills/create-gsd-extension/workflows/debug-extension.md +74 -0
  428. package/src/resources/skills/create-skill/SKILL.md +184 -0
  429. package/src/resources/skills/create-skill/references/api-security.md +226 -0
  430. package/src/resources/skills/create-skill/references/be-clear-and-direct.md +531 -0
  431. package/src/resources/skills/create-skill/references/common-patterns.md +595 -0
  432. package/src/resources/skills/create-skill/references/core-principles.md +437 -0
  433. package/src/resources/skills/create-skill/references/executable-code.md +175 -0
  434. package/src/resources/skills/create-skill/references/gsd-skill-ecosystem.md +68 -0
  435. package/src/resources/skills/create-skill/references/iteration-and-testing.md +474 -0
  436. package/src/resources/skills/create-skill/references/recommended-structure.md +168 -0
  437. package/src/resources/skills/create-skill/references/skill-structure.md +372 -0
  438. package/src/resources/skills/create-skill/references/use-xml-tags.md +466 -0
  439. package/src/resources/skills/create-skill/references/using-scripts.md +113 -0
  440. package/src/resources/skills/create-skill/references/using-templates.md +112 -0
  441. package/src/resources/skills/create-skill/references/workflows-and-validation.md +510 -0
  442. package/src/resources/skills/create-skill/templates/router-skill.md +73 -0
  443. package/src/resources/skills/create-skill/templates/simple-skill.md +33 -0
  444. package/src/resources/skills/create-skill/workflows/add-reference.md +96 -0
  445. package/src/resources/skills/create-skill/workflows/add-script.md +93 -0
  446. package/src/resources/skills/create-skill/workflows/add-template.md +74 -0
  447. package/src/resources/skills/create-skill/workflows/add-workflow.md +120 -0
  448. package/src/resources/skills/create-skill/workflows/audit-skill.md +148 -0
  449. package/src/resources/skills/create-skill/workflows/create-new-skill.md +196 -0
  450. package/src/resources/skills/create-skill/workflows/get-guidance.md +121 -0
  451. package/src/resources/skills/create-skill/workflows/upgrade-to-router.md +161 -0
  452. package/src/resources/skills/create-skill/workflows/verify-skill.md +204 -0
  453. package/src/resources/skills/react-best-practices/SKILL.md +1 -1
  454. package/dist/resources/extensions/gsd/auto-worktree-sync.ts +0 -184
  455. package/dist/resources/extensions/gsd/preferences-hooks.ts +0 -10
  456. package/dist/resources/extensions/gsd/tests/worktree-db-integration.test.ts +0 -205
  457. package/dist/resources/extensions/gsd/tests/worktree-db.test.ts +0 -442
  458. package/dist/resources/extensions/mcporter/index.ts +0 -512
  459. package/dist/resources/extensions/shared/progress-widget.ts +0 -282
  460. package/dist/resources/extensions/shared/thinking-widget.ts +0 -107
  461. package/src/resources/extensions/gsd/auto-worktree-sync.ts +0 -184
  462. package/src/resources/extensions/gsd/preferences-hooks.ts +0 -10
  463. package/src/resources/extensions/gsd/tests/worktree-db-integration.test.ts +0 -205
  464. package/src/resources/extensions/gsd/tests/worktree-db.test.ts +0 -442
  465. package/src/resources/extensions/mcporter/index.ts +0 -512
  466. package/src/resources/extensions/shared/progress-widget.ts +0 -282
  467. package/src/resources/extensions/shared/thinking-widget.ts +0 -107
@@ -1,10 +1,12 @@
1
1
  import { DefaultResourceLoader } from '@gsd/pi-coding-agent';
2
+ import { createHash } from 'node:crypto';
2
3
  import { homedir } from 'node:os';
3
- import { chmodSync, cpSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs';
4
+ import { chmodSync, copyFileSync, cpSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs';
4
5
  import { dirname, join, relative, resolve } from 'node:path';
5
6
  import { fileURLToPath } from 'node:url';
6
7
  import { compareSemver } from './update-check.js';
7
8
  import { discoverExtensionEntryPaths } from './extension-discovery.js';
9
+ import { loadRegistry, readManifestFromEntryPath, isExtensionEnabled, ensureRegistryEntries } from './extension-registry.js';
8
10
  // Resolve resources directory — prefer dist/resources/ (stable, set at build time)
9
11
  // over src/resources/ (live working tree, changes with git branch).
10
12
  //
@@ -41,7 +43,11 @@ function getBundledGsdVersion() {
41
43
  }
42
44
  }
43
45
  function writeManagedResourceManifest(agentDir) {
44
- const manifest = { gsdVersion: getBundledGsdVersion(), syncedAt: Date.now() };
46
+ const manifest = {
47
+ gsdVersion: getBundledGsdVersion(),
48
+ syncedAt: Date.now(),
49
+ contentHash: computeResourceFingerprint(),
50
+ };
45
51
  writeFileSync(getManagedResourceManifestPath(agentDir), JSON.stringify(manifest));
46
52
  }
47
53
  export function readManagedResourceVersion(agentDir) {
@@ -53,6 +59,44 @@ export function readManagedResourceVersion(agentDir) {
53
59
  return null;
54
60
  }
55
61
  }
62
+ function readManagedResourceManifest(agentDir) {
63
+ try {
64
+ return JSON.parse(readFileSync(getManagedResourceManifestPath(agentDir), 'utf-8'));
65
+ }
66
+ catch {
67
+ return null;
68
+ }
69
+ }
70
+ /**
71
+ * Computes a lightweight content fingerprint of the bundled resources directory.
72
+ *
73
+ * Walks all files under resourcesDir and hashes their relative paths + sizes.
74
+ * This catches same-version content changes (npm link dev workflow, hotfixes
75
+ * within a release) without the cost of reading every file's contents.
76
+ *
77
+ * ~1ms for a typical resources tree (~100 files) — just stat calls, no reads.
78
+ */
79
+ function computeResourceFingerprint() {
80
+ const entries = [];
81
+ collectFileEntries(resourcesDir, resourcesDir, entries);
82
+ entries.sort();
83
+ return createHash('sha256').update(entries.join('\n')).digest('hex').slice(0, 16);
84
+ }
85
+ function collectFileEntries(dir, root, out) {
86
+ if (!existsSync(dir))
87
+ return;
88
+ for (const entry of readdirSync(dir, { withFileTypes: true })) {
89
+ const fullPath = join(dir, entry.name);
90
+ if (entry.isDirectory()) {
91
+ collectFileEntries(fullPath, root, out);
92
+ }
93
+ else {
94
+ const rel = relative(root, fullPath);
95
+ const size = statSync(fullPath).size;
96
+ out.push(`${rel}:${size}`);
97
+ }
98
+ }
99
+ }
56
100
  export function getNewerManagedResourceVersion(agentDir, currentVersion) {
57
101
  const managedVersion = readManagedResourceVersion(agentDir);
58
102
  if (!managedVersion) {
@@ -111,10 +155,34 @@ function syncResourceDir(srcDir, destDir) {
111
155
  rmSync(target, { recursive: true, force: true });
112
156
  }
113
157
  }
114
- cpSync(srcDir, destDir, { recursive: true, force: true });
158
+ try {
159
+ cpSync(srcDir, destDir, { recursive: true, force: true });
160
+ }
161
+ catch {
162
+ // Fallback for Windows paths with non-ASCII characters where cpSync
163
+ // fails with the \\?\ extended-length prefix (#1178).
164
+ copyDirRecursive(srcDir, destDir);
165
+ }
115
166
  makeTreeWritable(destDir);
116
167
  }
117
168
  }
169
+ /**
170
+ * Recursive directory copy using copyFileSync — workaround for cpSync failures
171
+ * on Windows paths containing non-ASCII characters (#1178).
172
+ */
173
+ function copyDirRecursive(src, dest) {
174
+ mkdirSync(dest, { recursive: true });
175
+ for (const entry of readdirSync(src, { withFileTypes: true })) {
176
+ const srcPath = join(src, entry.name);
177
+ const destPath = join(dest, entry.name);
178
+ if (entry.isDirectory()) {
179
+ copyDirRecursive(srcPath, destPath);
180
+ }
181
+ else {
182
+ copyFileSync(srcPath, destPath);
183
+ }
184
+ }
185
+ }
118
186
  /**
119
187
  * Syncs all bundled resources to agentDir (~/.gsd/agent/) on every launch.
120
188
  *
@@ -132,12 +200,17 @@ function syncResourceDir(srcDir, destDir) {
132
200
  */
133
201
  export function initResources(agentDir) {
134
202
  mkdirSync(agentDir, { recursive: true });
135
- // Skip the full copy when the synced version already matches the running version.
136
- // This avoids ~800ms of synchronous rmSync + cpSync on every startup.
203
+ // Skip the full copy when both version AND content fingerprint match.
204
+ // Version-only checks miss same-version content changes (npm link dev workflow,
205
+ // hotfixes within a release). The content hash catches those at ~1ms cost.
137
206
  const currentVersion = getBundledGsdVersion();
138
- const managedVersion = readManagedResourceVersion(agentDir);
139
- if (managedVersion && managedVersion === currentVersion) {
140
- return;
207
+ const manifest = readManagedResourceManifest(agentDir);
208
+ if (manifest && manifest.gsdVersion === currentVersion) {
209
+ // Version matches — check content fingerprint for same-version staleness.
210
+ const currentHash = computeResourceFingerprint();
211
+ if (manifest.contentHash && manifest.contentHash === currentHash) {
212
+ return;
213
+ }
141
214
  }
142
215
  syncResourceDir(bundledExtensionsDir, join(agentDir, 'extensions'));
143
216
  syncResourceDir(join(resourcesDir, 'agents'), join(agentDir, 'agents'));
@@ -146,6 +219,7 @@ export function initResources(agentDir) {
146
219
  // overwrite them (covers extensions, agents, and skills in one walk).
147
220
  makeTreeWritable(agentDir);
148
221
  writeManagedResourceManifest(agentDir);
222
+ ensureRegistryEntries(join(agentDir, 'extensions'));
149
223
  }
150
224
  /**
151
225
  * Constructs a DefaultResourceLoader that loads extensions from both
@@ -162,10 +236,18 @@ function getBundledExtensionKeys() {
162
236
  return _bundledExtensionKeys;
163
237
  }
164
238
  export function buildResourceLoader(agentDir) {
239
+ const registry = loadRegistry();
165
240
  const piAgentDir = join(homedir(), '.pi', 'agent');
166
241
  const piExtensionsDir = join(piAgentDir, 'extensions');
167
242
  const bundledKeys = getBundledExtensionKeys();
168
- const piExtensionPaths = discoverExtensionEntryPaths(piExtensionsDir).filter((entryPath) => !bundledKeys.has(getExtensionKey(entryPath, piExtensionsDir)));
243
+ const piExtensionPaths = discoverExtensionEntryPaths(piExtensionsDir)
244
+ .filter((entryPath) => !bundledKeys.has(getExtensionKey(entryPath, piExtensionsDir)))
245
+ .filter((entryPath) => {
246
+ const manifest = readManifestFromEntryPath(entryPath);
247
+ if (!manifest)
248
+ return true;
249
+ return isExtensionEnabled(registry, manifest.id);
250
+ });
169
251
  return new DefaultResourceLoader({
170
252
  agentDir,
171
253
  additionalExtensionPaths: piExtensionPaths,
@@ -0,0 +1,13 @@
1
+ {
2
+ "id": "async-jobs",
3
+ "name": "Async Jobs",
4
+ "version": "1.0.0",
5
+ "description": "Run bash commands in the background with job tracking and cancellation",
6
+ "tier": "bundled",
7
+ "requires": { "platform": ">=2.29.0" },
8
+ "provides": {
9
+ "tools": ["async_bash", "await_job", "cancel_job"],
10
+ "commands": ["jobs"],
11
+ "hooks": ["session_start"]
12
+ }
13
+ }
@@ -0,0 +1,144 @@
1
+ /**
2
+ * AWS Auth Refresh Extension
3
+ *
4
+ * Automatically refreshes AWS credentials when Bedrock API requests fail
5
+ * with authentication/token errors, then retries the user's message.
6
+ *
7
+ * ## How it works
8
+ *
9
+ * Hooks into `agent_end` to check if the last assistant message failed with
10
+ * an AWS auth error (expired SSO token, missing credentials, etc.). If so:
11
+ *
12
+ * 1. Runs the configured `awsAuthRefresh` command (e.g. `aws sso login`)
13
+ * 2. Streams the SSO auth URL and verification code to the TUI so users
14
+ * can copy/paste if the browser doesn't auto-open
15
+ * 3. Calls `retryLastTurn()` which removes the failed assistant response
16
+ * and re-runs the agent from the user's original message
17
+ *
18
+ * ## Activation
19
+ *
20
+ * This extension is completely inert unless BOTH conditions are met:
21
+ * 1. A Bedrock API request fails with a recognized AWS auth error
22
+ * 2. `awsAuthRefresh` is configured in settings.json
23
+ *
24
+ * Non-Bedrock users and Bedrock users without `awsAuthRefresh` configured
25
+ * are not affected in any way.
26
+ *
27
+ * ## Setup
28
+ *
29
+ * Add to ~/.gsd/agent/settings.json (or project-level .gsd/settings.json):
30
+ *
31
+ * { "awsAuthRefresh": "aws sso login --profile my-profile" }
32
+ *
33
+ * ## Matched error patterns
34
+ *
35
+ * The extension recognizes errors from the AWS SDK, Bedrock, and SSO
36
+ * credential providers including:
37
+ * - ExpiredTokenException / ExpiredToken
38
+ * - The security token included in the request is expired
39
+ * - The SSO session associated with this profile has expired or is invalid
40
+ * - Unable to locate credentials / Could not load credentials
41
+ * - UnrecognizedClientException
42
+ * - Error loading SSO Token / Token does not exist
43
+ * - SSOTokenProviderFailure
44
+ */
45
+
46
+ import { exec } from "node:child_process";
47
+ import { existsSync, readFileSync } from "node:fs";
48
+ import { join } from "node:path";
49
+ import { homedir } from "node:os";
50
+ import type { ExtensionAPI } from "@gsd/pi-coding-agent";
51
+
52
+ /** Matches AWS SDK / Bedrock / SSO credential and token errors. */
53
+ const AWS_AUTH_ERROR_RE =
54
+ /ExpiredToken|security token.*expired|unable to locate credentials|SSO.*(?:session|token).*(?:expired|not found|invalid)|UnrecognizedClient|Could not load credentials|Invalid identity token|token is expired|credentials.*(?:could not|cannot|failed to).*(?:load|resolve|find)|The.*token.*is.*not.*valid|token has expired|SSOTokenProviderFailure|Error loading SSO Token|Token.*does not exist/i;
55
+
56
+ /**
57
+ * Reads the `awsAuthRefresh` command from settings.json.
58
+ * Checks project-level first, then global (~/.gsd/agent/settings.json).
59
+ */
60
+ function getAwsAuthRefreshCommand(): string | undefined {
61
+ const configDir = process.env.PI_CONFIG_DIR || ".gsd";
62
+ const paths = [
63
+ join(process.cwd(), configDir, "settings.json"),
64
+ join(homedir(), configDir, "agent", "settings.json"),
65
+ ];
66
+ for (const settingsPath of paths) {
67
+ if (!existsSync(settingsPath)) continue;
68
+ try {
69
+ const settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
70
+ if (settings.awsAuthRefresh) return settings.awsAuthRefresh;
71
+ } catch {}
72
+ }
73
+ return undefined;
74
+ }
75
+
76
+ /**
77
+ * Runs the refresh command with a 2-minute timeout (for SSO browser flows).
78
+ * Streams stdout/stderr to capture and display the SSO auth URL and
79
+ * verification code in real-time via TUI notifications.
80
+ */
81
+ async function runRefresh(
82
+ command: string,
83
+ notify: (msg: string, level: "info" | "warning" | "error") => void,
84
+ ): Promise<boolean> {
85
+ notify("Refreshing AWS credentials...", "info");
86
+ try {
87
+ await new Promise<void>((resolve, reject) => {
88
+ const child = exec(command, { timeout: 120_000, env: { ...process.env } });
89
+ const onData = (data: Buffer | string) => {
90
+ const text = data.toString();
91
+ const urlMatch = text.match(/https?:\/\/\S+/);
92
+ if (urlMatch) {
93
+ notify(`Open this URL if the browser didn't launch: ${urlMatch[0]}`, "warning");
94
+ }
95
+ const codeMatch = text.match(/code[:\s]+([A-Z]{4}-[A-Z]{4})/i);
96
+ if (codeMatch) {
97
+ notify(`Verification code: ${codeMatch[1]}`, "info");
98
+ }
99
+ };
100
+ child.stdout?.on("data", onData);
101
+ child.stderr?.on("data", onData);
102
+ child.on("close", (code) => {
103
+ if (code === 0) resolve();
104
+ else reject(new Error(`Refresh command exited with code ${code}`));
105
+ });
106
+ child.on("error", reject);
107
+ });
108
+ notify("AWS credentials refreshed successfully ✓", "info");
109
+ return true;
110
+ } catch (error) {
111
+ const msg = error instanceof Error ? error.message : String(error);
112
+ const isTimeout = /timed out|ETIMEDOUT|killed/i.test(msg);
113
+ if (isTimeout) {
114
+ notify("AWS credential refresh timed out. The SSO login may have been cancelled or the browser window was closed.", "error");
115
+ } else {
116
+ notify(`AWS credential refresh failed: ${msg}`, "error");
117
+ }
118
+ return false;
119
+ }
120
+ }
121
+
122
+ export default function (pi: ExtensionAPI) {
123
+ pi.on("agent_end", async (event, ctx) => {
124
+ const refreshCommand = getAwsAuthRefreshCommand();
125
+ if (!refreshCommand) return;
126
+
127
+ const messages = event.messages;
128
+ const lastAssistant = messages[messages.length - 1];
129
+ if (
130
+ !lastAssistant ||
131
+ lastAssistant.role !== "assistant" ||
132
+ !("errorMessage" in lastAssistant) ||
133
+ !lastAssistant.errorMessage ||
134
+ !AWS_AUTH_ERROR_RE.test(lastAssistant.errorMessage)
135
+ ) {
136
+ return;
137
+ }
138
+
139
+ const refreshed = await runRefresh(refreshCommand, (m, level) => ctx.ui.notify(m, level));
140
+ if (!refreshed) return;
141
+
142
+ pi.retryLastTurn();
143
+ });
144
+ }
@@ -0,0 +1,14 @@
1
+ {
2
+ "id": "bg-shell",
3
+ "name": "Background Shell",
4
+ "version": "1.0.0",
5
+ "description": "Run and manage background shell processes with interactive monitoring",
6
+ "tier": "bundled",
7
+ "requires": { "platform": ">=2.29.0" },
8
+ "provides": {
9
+ "tools": ["bg_shell"],
10
+ "commands": ["bg"],
11
+ "hooks": ["session_shutdown"],
12
+ "shortcuts": ["Ctrl+Alt+B"]
13
+ }
14
+ }
@@ -375,6 +375,19 @@ export function cleanupAll(): void {
375
375
  processes.clear();
376
376
  }
377
377
 
378
+ /**
379
+ * Kill all alive, non-persistent bg processes.
380
+ * Called between auto-mode units to prevent orphaned servers from
381
+ * keeping ports bound across task boundaries (#1209).
382
+ */
383
+ export function killSessionProcesses(): void {
384
+ for (const [id, bg] of processes) {
385
+ if (bg.alive && !bg.persistAcrossSessions) {
386
+ killProcess(id, "SIGTERM");
387
+ }
388
+ }
389
+ }
390
+
378
391
  async function waitForProcessExit(bg: BgProcess, timeoutMs: number): Promise<boolean> {
379
392
  if (!bg.alive) return true;
380
393
  await new Promise<void>((resolve) => {
@@ -13,8 +13,40 @@ import { formatCompactStateSummary } from "./utils.js";
13
13
  // Anthropic vision: 1568px is the recommended optimal width. Height is capped
14
14
  // generously at 8000px so tall full-page screenshots remain readable rather
15
15
  // than being squished into a square constraint.
16
- const MAX_SCREENSHOT_WIDTH = 1568;
17
- const MAX_SCREENSHOT_HEIGHT = 8000;
16
+ //
17
+ // Override via environment variables:
18
+ // SCREENSHOT_MAX_WIDTH=0 → uncap width (use raw resolution)
19
+ // SCREENSHOT_MAX_HEIGHT=0 → uncap height
20
+ // SCREENSHOT_FORMAT=png → lossless PNG for all viewport/fullpage screenshots
21
+ // SCREENSHOT_QUALITY=100 → max JPEG quality (1-100, default 80)
22
+ const MAX_SCREENSHOT_WIDTH = parseScreenshotDimension(process.env.SCREENSHOT_MAX_WIDTH, 1568);
23
+ const MAX_SCREENSHOT_HEIGHT = parseScreenshotDimension(process.env.SCREENSHOT_MAX_HEIGHT, 8000);
24
+
25
+ /** Parse a dimension env var: positive int = that value, 0 = Infinity (uncapped), absent/invalid = default. */
26
+ function parseScreenshotDimension(value: string | undefined, fallback: number): number {
27
+ if (value === undefined || value === "") return fallback;
28
+ const n = parseInt(value, 10);
29
+ if (isNaN(n) || n < 0) return fallback;
30
+ if (n === 0) return Infinity;
31
+ return n;
32
+ }
33
+
34
+ /** Return the user-configured screenshot format override, or null for default behavior. */
35
+ export function getScreenshotFormatOverride(): "png" | "jpeg" | null {
36
+ const fmt = process.env.SCREENSHOT_FORMAT?.toLowerCase();
37
+ if (fmt === "png") return "png";
38
+ if (fmt === "jpeg" || fmt === "jpg") return "jpeg";
39
+ return null;
40
+ }
41
+
42
+ /** Return the user-configured default JPEG quality, or the provided fallback. */
43
+ export function getScreenshotQualityDefault(fallback: number): number {
44
+ const q = process.env.SCREENSHOT_QUALITY;
45
+ if (q === undefined || q === "") return fallback;
46
+ const n = parseInt(q, 10);
47
+ if (isNaN(n) || n < 1 || n > 100) return fallback;
48
+ return n;
49
+ }
18
50
 
19
51
  // ---------------------------------------------------------------------------
20
52
  // Compact page state capture
@@ -0,0 +1,37 @@
1
+ {
2
+ "id": "browser-tools",
3
+ "name": "Browser Tools",
4
+ "version": "1.0.0",
5
+ "description": "Playwright-based web automation, screenshots, and analysis",
6
+ "tier": "bundled",
7
+ "requires": { "platform": ">=2.29.0" },
8
+ "provides": {
9
+ "tools": [
10
+ "browser_navigate", "browser_go_back", "browser_go_forward", "browser_reload",
11
+ "browser_click", "browser_drag", "browser_type", "browser_upload_file",
12
+ "browser_scroll", "browser_hover", "browser_key_press", "browser_select_option",
13
+ "browser_set_checked", "browser_screenshot", "browser_wait_for",
14
+ "browser_get_console_logs", "browser_get_network_logs", "browser_get_dialog_logs",
15
+ "browser_evaluate", "browser_get_accessibility_tree", "browser_find",
16
+ "browser_get_page_source", "browser_close",
17
+ "browser_trace_start", "browser_trace_stop", "browser_export_har",
18
+ "browser_timeline", "browser_session_summary", "browser_debug_bundle",
19
+ "browser_assert", "browser_diff", "browser_batch",
20
+ "browser_snapshot_refs", "browser_get_ref", "browser_click_ref",
21
+ "browser_hover_ref", "browser_fill_ref",
22
+ "browser_list_pages", "browser_switch_page", "browser_close_page",
23
+ "browser_list_frames", "browser_select_frame",
24
+ "browser_analyze_form", "browser_fill_form",
25
+ "browser_find_best", "browser_act",
26
+ "browser_save_pdf", "browser_save_state", "browser_restore_state",
27
+ "browser_mock_route", "browser_block_urls", "browser_clear_routes",
28
+ "browser_emulate_device", "browser_extract",
29
+ "browser_visual_diff", "browser_zoom_region",
30
+ "browser_generate_test", "browser_action_cache", "browser_check_injection"
31
+ ],
32
+ "hooks": ["session_shutdown"]
33
+ },
34
+ "dependencies": {
35
+ "runtime": ["playwright"]
36
+ }
37
+ }
@@ -92,7 +92,7 @@ let page;
92
92
 
93
93
  before(async () => {
94
94
  browser = await chromium.launch({ headless: true });
95
- const context = await browser.newContext({ viewport: { width: 1280, height: 720 } });
95
+ const context = await browser.newContext({ viewport: { width: 1280, height: 800 }, deviceScaleFactor: 2 });
96
96
  page = await context.newPage();
97
97
  });
98
98
 
@@ -602,14 +602,14 @@ describe("constrainScreenshot", () => {
602
602
  });
603
603
 
604
604
  it("handles an image where only height exceeds the limit", async () => {
605
- const buf = await createTestJpeg(1000, 2000);
605
+ const buf = await createTestJpeg(1000, 9000);
606
606
  const result = await constrainScreenshot(null, buf, "image/jpeg", 80);
607
607
  const sharp = require("sharp");
608
608
  const meta = await sharp(result).metadata();
609
609
  assert.ok(meta.width <= 1568);
610
- assert.ok(meta.height <= 1568);
610
+ assert.ok(meta.height <= 8000);
611
611
  // Height was the constraining dimension
612
- assert.equal(meta.height, 1568);
612
+ assert.equal(meta.height, 8000);
613
613
  });
614
614
  });
615
615
 
@@ -1,6 +1,7 @@
1
1
  import type { ExtensionAPI } from "@gsd/pi-coding-agent";
2
2
  import { Type } from "@sinclair/typebox";
3
3
  import type { ToolDeps } from "../state.js";
4
+ import { getScreenshotFormatOverride, getScreenshotQualityDefault } from "../capture.js";
4
5
 
5
6
  export function registerScreenshotTools(pi: ExtensionAPI, deps: ToolDeps): void {
6
7
  pi.registerTool({
@@ -32,20 +33,37 @@ export function registerScreenshotTools(pi: ExtensionAPI, deps: ToolDeps): void
32
33
 
33
34
  let screenshotBuffer: Buffer;
34
35
  let mimeType: string;
35
- const quality = params.quality ?? 80;
36
+ const formatOverride = getScreenshotFormatOverride();
37
+ const quality = params.quality ?? getScreenshotQualityDefault(80);
36
38
 
37
39
  if (params.selector) {
40
+ const fmt = formatOverride ?? "png";
38
41
  const locator = p.locator(params.selector).first();
39
- screenshotBuffer = await locator.screenshot({ type: "png", scale: "css" });
40
- mimeType = "image/png";
42
+ if (fmt === "jpeg") {
43
+ screenshotBuffer = await locator.screenshot({ type: "jpeg", quality, scale: "css" });
44
+ mimeType = "image/jpeg";
45
+ } else {
46
+ screenshotBuffer = await locator.screenshot({ type: "png", scale: "css" });
47
+ mimeType = "image/png";
48
+ }
41
49
  } else {
42
- screenshotBuffer = await p.screenshot({
43
- fullPage: params.fullPage ?? false,
44
- type: "jpeg",
45
- quality,
46
- scale: "css",
47
- });
48
- mimeType = "image/jpeg";
50
+ const fmt = formatOverride ?? "jpeg";
51
+ if (fmt === "png") {
52
+ screenshotBuffer = await p.screenshot({
53
+ fullPage: params.fullPage ?? false,
54
+ type: "png",
55
+ scale: "css",
56
+ });
57
+ mimeType = "image/png";
58
+ } else {
59
+ screenshotBuffer = await p.screenshot({
60
+ fullPage: params.fullPage ?? false,
61
+ type: "jpeg",
62
+ quality,
63
+ scale: "css",
64
+ });
65
+ mimeType = "image/jpeg";
66
+ }
49
67
  }
50
68
 
51
69
  screenshotBuffer = await deps.constrainScreenshot(p, screenshotBuffer, mimeType, quality);
@@ -0,0 +1,12 @@
1
+ {
2
+ "id": "context7",
3
+ "name": "Context7",
4
+ "version": "1.0.0",
5
+ "description": "Fetch up-to-date library documentation and code examples from Context7",
6
+ "tier": "bundled",
7
+ "requires": { "platform": ">=2.29.0" },
8
+ "provides": {
9
+ "tools": ["resolve_library", "get_library_docs"],
10
+ "hooks": ["session_start"]
11
+ }
12
+ }
@@ -0,0 +1,12 @@
1
+ {
2
+ "id": "google-search",
3
+ "name": "Google Search",
4
+ "version": "1.0.0",
5
+ "description": "Web search via Google with AI-synthesized answers and source citations",
6
+ "tier": "bundled",
7
+ "requires": { "platform": ">=2.29.0" },
8
+ "provides": {
9
+ "tools": ["google_search"],
10
+ "hooks": ["session_start"]
11
+ }
12
+ }
@@ -265,14 +265,27 @@ export default function (pi: ExtensionAPI) {
265
265
  try {
266
266
  if (process.env.GEMINI_API_KEY) {
267
267
  const ai = await getClient();
268
- const response = await ai.models.generateContent({
269
- model: process.env.GEMINI_SEARCH_MODEL || "gemini-2.5-flash",
270
- contents: params.query,
271
- config: {
272
- tools: [{ googleSearch: {} }],
273
- abortSignal: signal,
274
- },
275
- });
268
+
269
+ // Add a 30-second timeout to prevent hanging (#1100)
270
+ const timeoutController = new AbortController();
271
+ const timeoutId = setTimeout(() => timeoutController.abort(), 30_000);
272
+ const combinedSignal = signal
273
+ ? AbortSignal.any([signal, timeoutController.signal])
274
+ : timeoutController.signal;
275
+
276
+ let response;
277
+ try {
278
+ response = await ai.models.generateContent({
279
+ model: process.env.GEMINI_SEARCH_MODEL || "gemini-2.5-flash",
280
+ contents: params.query,
281
+ config: {
282
+ tools: [{ googleSearch: {} }],
283
+ abortSignal: combinedSignal,
284
+ },
285
+ });
286
+ } finally {
287
+ clearTimeout(timeoutId);
288
+ }
276
289
 
277
290
  // Extract answer text
278
291
  const answer = response.text ?? "";
@@ -69,6 +69,7 @@ export class AutoSession {
69
69
  // ── Lifecycle ────────────────────────────────────────────────────────────
70
70
  active = false;
71
71
  paused = false;
72
+ pausedForSecrets = false;
72
73
  stepMode = false;
73
74
  verbose = false;
74
75
  cmdCtx: ExtensionCommandContext | null = null;
@@ -162,6 +163,7 @@ export class AutoSession {
162
163
  // Lifecycle
163
164
  this.active = false;
164
165
  this.paused = false;
166
+ this.pausedForSecrets = false;
165
167
  this.stepMode = false;
166
168
  this.verbose = false;
167
169
  this.cmdCtx = null;