@oh-my-pi/pi-coding-agent 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (337) hide show
  1. package/CHANGELOG.md +1629 -0
  2. package/README.md +1041 -0
  3. package/docs/compaction.md +403 -0
  4. package/docs/config-usage.md +113 -0
  5. package/docs/custom-tools.md +541 -0
  6. package/docs/extension-loading.md +1004 -0
  7. package/docs/hooks.md +867 -0
  8. package/docs/rpc.md +1040 -0
  9. package/docs/sdk.md +994 -0
  10. package/docs/session-tree-plan.md +441 -0
  11. package/docs/session.md +240 -0
  12. package/docs/skills.md +290 -0
  13. package/docs/theme.md +670 -0
  14. package/docs/tree.md +197 -0
  15. package/docs/tui.md +341 -0
  16. package/examples/README.md +21 -0
  17. package/examples/custom-tools/README.md +124 -0
  18. package/examples/custom-tools/hello/index.ts +20 -0
  19. package/examples/custom-tools/question/index.ts +84 -0
  20. package/examples/custom-tools/subagent/README.md +172 -0
  21. package/examples/custom-tools/subagent/agents/planner.md +37 -0
  22. package/examples/custom-tools/subagent/agents/scout.md +50 -0
  23. package/examples/custom-tools/subagent/agents/worker.md +24 -0
  24. package/examples/custom-tools/subagent/agents.ts +156 -0
  25. package/examples/custom-tools/subagent/commands/implement-and-review.md +10 -0
  26. package/examples/custom-tools/subagent/commands/implement.md +10 -0
  27. package/examples/custom-tools/subagent/commands/scout-and-plan.md +9 -0
  28. package/examples/custom-tools/subagent/index.ts +1002 -0
  29. package/examples/custom-tools/todo/index.ts +212 -0
  30. package/examples/hooks/README.md +56 -0
  31. package/examples/hooks/auto-commit-on-exit.ts +49 -0
  32. package/examples/hooks/confirm-destructive.ts +59 -0
  33. package/examples/hooks/custom-compaction.ts +116 -0
  34. package/examples/hooks/dirty-repo-guard.ts +52 -0
  35. package/examples/hooks/file-trigger.ts +41 -0
  36. package/examples/hooks/git-checkpoint.ts +53 -0
  37. package/examples/hooks/handoff.ts +150 -0
  38. package/examples/hooks/permission-gate.ts +34 -0
  39. package/examples/hooks/protected-paths.ts +30 -0
  40. package/examples/hooks/qna.ts +119 -0
  41. package/examples/hooks/snake.ts +343 -0
  42. package/examples/hooks/status-line.ts +40 -0
  43. package/examples/sdk/01-minimal.ts +22 -0
  44. package/examples/sdk/02-custom-model.ts +49 -0
  45. package/examples/sdk/03-custom-prompt.ts +44 -0
  46. package/examples/sdk/04-skills.ts +44 -0
  47. package/examples/sdk/05-tools.ts +90 -0
  48. package/examples/sdk/06-hooks.ts +61 -0
  49. package/examples/sdk/07-context-files.ts +36 -0
  50. package/examples/sdk/08-slash-commands.ts +42 -0
  51. package/examples/sdk/09-api-keys-and-oauth.ts +55 -0
  52. package/examples/sdk/10-settings.ts +38 -0
  53. package/examples/sdk/11-sessions.ts +48 -0
  54. package/examples/sdk/12-full-control.ts +95 -0
  55. package/examples/sdk/README.md +154 -0
  56. package/package.json +89 -0
  57. package/src/bun-imports.d.ts +16 -0
  58. package/src/capability/context-file.ts +40 -0
  59. package/src/capability/extension.ts +48 -0
  60. package/src/capability/hook.ts +40 -0
  61. package/src/capability/index.ts +616 -0
  62. package/src/capability/instruction.ts +37 -0
  63. package/src/capability/mcp.ts +52 -0
  64. package/src/capability/prompt.ts +35 -0
  65. package/src/capability/rule.ts +56 -0
  66. package/src/capability/settings.ts +35 -0
  67. package/src/capability/skill.ts +49 -0
  68. package/src/capability/slash-command.ts +40 -0
  69. package/src/capability/system-prompt.ts +35 -0
  70. package/src/capability/tool.ts +38 -0
  71. package/src/capability/types.ts +166 -0
  72. package/src/cli/args.ts +259 -0
  73. package/src/cli/file-processor.ts +121 -0
  74. package/src/cli/list-models.ts +104 -0
  75. package/src/cli/plugin-cli.ts +661 -0
  76. package/src/cli/session-picker.ts +41 -0
  77. package/src/cli/update-cli.ts +274 -0
  78. package/src/cli.ts +10 -0
  79. package/src/config.ts +391 -0
  80. package/src/core/agent-session.ts +2178 -0
  81. package/src/core/auth-storage.ts +258 -0
  82. package/src/core/bash-executor.ts +197 -0
  83. package/src/core/compaction/branch-summarization.ts +315 -0
  84. package/src/core/compaction/compaction.ts +664 -0
  85. package/src/core/compaction/index.ts +7 -0
  86. package/src/core/compaction/utils.ts +153 -0
  87. package/src/core/custom-commands/bundled/review/index.ts +156 -0
  88. package/src/core/custom-commands/index.ts +15 -0
  89. package/src/core/custom-commands/loader.ts +226 -0
  90. package/src/core/custom-commands/types.ts +112 -0
  91. package/src/core/custom-tools/index.ts +22 -0
  92. package/src/core/custom-tools/loader.ts +248 -0
  93. package/src/core/custom-tools/types.ts +185 -0
  94. package/src/core/custom-tools/wrapper.ts +29 -0
  95. package/src/core/exec.ts +139 -0
  96. package/src/core/export-html/index.ts +159 -0
  97. package/src/core/export-html/template.css +774 -0
  98. package/src/core/export-html/template.generated.ts +2 -0
  99. package/src/core/export-html/template.html +45 -0
  100. package/src/core/export-html/template.js +1185 -0
  101. package/src/core/export-html/template.macro.ts +24 -0
  102. package/src/core/file-mentions.ts +54 -0
  103. package/src/core/hooks/index.ts +16 -0
  104. package/src/core/hooks/loader.ts +288 -0
  105. package/src/core/hooks/runner.ts +434 -0
  106. package/src/core/hooks/tool-wrapper.ts +98 -0
  107. package/src/core/hooks/types.ts +770 -0
  108. package/src/core/index.ts +53 -0
  109. package/src/core/logger.ts +112 -0
  110. package/src/core/mcp/client.ts +185 -0
  111. package/src/core/mcp/config.ts +248 -0
  112. package/src/core/mcp/index.ts +45 -0
  113. package/src/core/mcp/loader.ts +99 -0
  114. package/src/core/mcp/manager.ts +235 -0
  115. package/src/core/mcp/tool-bridge.ts +156 -0
  116. package/src/core/mcp/transports/http.ts +316 -0
  117. package/src/core/mcp/transports/index.ts +6 -0
  118. package/src/core/mcp/transports/stdio.ts +252 -0
  119. package/src/core/mcp/types.ts +228 -0
  120. package/src/core/messages.ts +211 -0
  121. package/src/core/model-registry.ts +334 -0
  122. package/src/core/model-resolver.ts +494 -0
  123. package/src/core/plugins/doctor.ts +67 -0
  124. package/src/core/plugins/index.ts +38 -0
  125. package/src/core/plugins/installer.ts +189 -0
  126. package/src/core/plugins/loader.ts +339 -0
  127. package/src/core/plugins/manager.ts +672 -0
  128. package/src/core/plugins/parser.ts +105 -0
  129. package/src/core/plugins/paths.ts +37 -0
  130. package/src/core/plugins/types.ts +190 -0
  131. package/src/core/sdk.ts +900 -0
  132. package/src/core/session-manager.ts +1837 -0
  133. package/src/core/settings-manager.ts +860 -0
  134. package/src/core/skills.ts +352 -0
  135. package/src/core/slash-commands.ts +132 -0
  136. package/src/core/system-prompt.ts +442 -0
  137. package/src/core/timings.ts +25 -0
  138. package/src/core/title-generator.ts +110 -0
  139. package/src/core/tools/ask.ts +193 -0
  140. package/src/core/tools/bash-interceptor.ts +120 -0
  141. package/src/core/tools/bash.ts +91 -0
  142. package/src/core/tools/context.ts +32 -0
  143. package/src/core/tools/edit-diff.ts +487 -0
  144. package/src/core/tools/edit.ts +140 -0
  145. package/src/core/tools/exa/company.ts +59 -0
  146. package/src/core/tools/exa/index.ts +63 -0
  147. package/src/core/tools/exa/linkedin.ts +59 -0
  148. package/src/core/tools/exa/mcp-client.ts +368 -0
  149. package/src/core/tools/exa/render.ts +200 -0
  150. package/src/core/tools/exa/researcher.ts +90 -0
  151. package/src/core/tools/exa/search.ts +338 -0
  152. package/src/core/tools/exa/types.ts +167 -0
  153. package/src/core/tools/exa/websets.ts +248 -0
  154. package/src/core/tools/find.ts +244 -0
  155. package/src/core/tools/grep.ts +584 -0
  156. package/src/core/tools/index.ts +283 -0
  157. package/src/core/tools/ls.ts +142 -0
  158. package/src/core/tools/lsp/client.ts +767 -0
  159. package/src/core/tools/lsp/clients/biome-client.ts +207 -0
  160. package/src/core/tools/lsp/clients/index.ts +49 -0
  161. package/src/core/tools/lsp/clients/lsp-linter-client.ts +98 -0
  162. package/src/core/tools/lsp/config.ts +845 -0
  163. package/src/core/tools/lsp/edits.ts +110 -0
  164. package/src/core/tools/lsp/index.ts +1364 -0
  165. package/src/core/tools/lsp/render.ts +560 -0
  166. package/src/core/tools/lsp/rust-analyzer.ts +145 -0
  167. package/src/core/tools/lsp/types.ts +495 -0
  168. package/src/core/tools/lsp/utils.ts +526 -0
  169. package/src/core/tools/notebook.ts +182 -0
  170. package/src/core/tools/output.ts +198 -0
  171. package/src/core/tools/path-utils.ts +61 -0
  172. package/src/core/tools/read.ts +507 -0
  173. package/src/core/tools/renderers.ts +820 -0
  174. package/src/core/tools/review.ts +275 -0
  175. package/src/core/tools/rulebook.ts +124 -0
  176. package/src/core/tools/task/agents.ts +158 -0
  177. package/src/core/tools/task/artifacts.ts +114 -0
  178. package/src/core/tools/task/commands.ts +157 -0
  179. package/src/core/tools/task/discovery.ts +217 -0
  180. package/src/core/tools/task/executor.ts +531 -0
  181. package/src/core/tools/task/index.ts +548 -0
  182. package/src/core/tools/task/model-resolver.ts +176 -0
  183. package/src/core/tools/task/parallel.ts +38 -0
  184. package/src/core/tools/task/render.ts +502 -0
  185. package/src/core/tools/task/subprocess-tool-registry.ts +89 -0
  186. package/src/core/tools/task/types.ts +142 -0
  187. package/src/core/tools/truncate.ts +265 -0
  188. package/src/core/tools/web-fetch.ts +2511 -0
  189. package/src/core/tools/web-search/auth.ts +199 -0
  190. package/src/core/tools/web-search/index.ts +583 -0
  191. package/src/core/tools/web-search/providers/anthropic.ts +198 -0
  192. package/src/core/tools/web-search/providers/exa.ts +196 -0
  193. package/src/core/tools/web-search/providers/perplexity.ts +195 -0
  194. package/src/core/tools/web-search/render.ts +372 -0
  195. package/src/core/tools/web-search/types.ts +180 -0
  196. package/src/core/tools/write.ts +63 -0
  197. package/src/core/ttsr.ts +211 -0
  198. package/src/core/utils.ts +187 -0
  199. package/src/discovery/agents-md.ts +75 -0
  200. package/src/discovery/builtin.ts +647 -0
  201. package/src/discovery/claude.ts +623 -0
  202. package/src/discovery/cline.ts +104 -0
  203. package/src/discovery/codex.ts +571 -0
  204. package/src/discovery/cursor.ts +266 -0
  205. package/src/discovery/gemini.ts +368 -0
  206. package/src/discovery/github.ts +120 -0
  207. package/src/discovery/helpers.test.ts +127 -0
  208. package/src/discovery/helpers.ts +249 -0
  209. package/src/discovery/index.ts +84 -0
  210. package/src/discovery/mcp-json.ts +127 -0
  211. package/src/discovery/vscode.ts +99 -0
  212. package/src/discovery/windsurf.ts +219 -0
  213. package/src/index.ts +192 -0
  214. package/src/main.ts +507 -0
  215. package/src/migrations.ts +156 -0
  216. package/src/modes/cleanup.ts +23 -0
  217. package/src/modes/index.ts +48 -0
  218. package/src/modes/interactive/components/armin.ts +382 -0
  219. package/src/modes/interactive/components/assistant-message.ts +86 -0
  220. package/src/modes/interactive/components/bash-execution.ts +199 -0
  221. package/src/modes/interactive/components/bordered-loader.ts +41 -0
  222. package/src/modes/interactive/components/branch-summary-message.ts +42 -0
  223. package/src/modes/interactive/components/compaction-summary-message.ts +45 -0
  224. package/src/modes/interactive/components/custom-editor.ts +122 -0
  225. package/src/modes/interactive/components/diff.ts +147 -0
  226. package/src/modes/interactive/components/dynamic-border.ts +25 -0
  227. package/src/modes/interactive/components/extensions/extension-dashboard.ts +296 -0
  228. package/src/modes/interactive/components/extensions/extension-list.ts +479 -0
  229. package/src/modes/interactive/components/extensions/index.ts +9 -0
  230. package/src/modes/interactive/components/extensions/inspector-panel.ts +313 -0
  231. package/src/modes/interactive/components/extensions/state-manager.ts +558 -0
  232. package/src/modes/interactive/components/extensions/types.ts +191 -0
  233. package/src/modes/interactive/components/hook-editor.ts +117 -0
  234. package/src/modes/interactive/components/hook-input.ts +64 -0
  235. package/src/modes/interactive/components/hook-message.ts +96 -0
  236. package/src/modes/interactive/components/hook-selector.ts +91 -0
  237. package/src/modes/interactive/components/model-selector.ts +560 -0
  238. package/src/modes/interactive/components/oauth-selector.ts +136 -0
  239. package/src/modes/interactive/components/plugin-settings.ts +481 -0
  240. package/src/modes/interactive/components/queue-mode-selector.ts +56 -0
  241. package/src/modes/interactive/components/session-selector.ts +220 -0
  242. package/src/modes/interactive/components/settings-defs.ts +597 -0
  243. package/src/modes/interactive/components/settings-selector.ts +545 -0
  244. package/src/modes/interactive/components/show-images-selector.ts +45 -0
  245. package/src/modes/interactive/components/status-line/index.ts +4 -0
  246. package/src/modes/interactive/components/status-line/presets.ts +94 -0
  247. package/src/modes/interactive/components/status-line/segments.ts +350 -0
  248. package/src/modes/interactive/components/status-line/separators.ts +55 -0
  249. package/src/modes/interactive/components/status-line/types.ts +81 -0
  250. package/src/modes/interactive/components/status-line-segment-editor.ts +357 -0
  251. package/src/modes/interactive/components/status-line.ts +384 -0
  252. package/src/modes/interactive/components/theme-selector.ts +62 -0
  253. package/src/modes/interactive/components/thinking-selector.ts +64 -0
  254. package/src/modes/interactive/components/tool-execution.ts +946 -0
  255. package/src/modes/interactive/components/tree-selector.ts +877 -0
  256. package/src/modes/interactive/components/ttsr-notification.ts +82 -0
  257. package/src/modes/interactive/components/user-message-selector.ts +159 -0
  258. package/src/modes/interactive/components/user-message.ts +18 -0
  259. package/src/modes/interactive/components/visual-truncate.ts +50 -0
  260. package/src/modes/interactive/components/welcome.ts +228 -0
  261. package/src/modes/interactive/interactive-mode.ts +2669 -0
  262. package/src/modes/interactive/theme/dark.json +102 -0
  263. package/src/modes/interactive/theme/defaults/dark-arctic.json +111 -0
  264. package/src/modes/interactive/theme/defaults/dark-catppuccin.json +106 -0
  265. package/src/modes/interactive/theme/defaults/dark-cyberpunk.json +109 -0
  266. package/src/modes/interactive/theme/defaults/dark-dracula.json +105 -0
  267. package/src/modes/interactive/theme/defaults/dark-forest.json +103 -0
  268. package/src/modes/interactive/theme/defaults/dark-github.json +112 -0
  269. package/src/modes/interactive/theme/defaults/dark-gruvbox.json +119 -0
  270. package/src/modes/interactive/theme/defaults/dark-monochrome.json +101 -0
  271. package/src/modes/interactive/theme/defaults/dark-monokai.json +105 -0
  272. package/src/modes/interactive/theme/defaults/dark-nord.json +104 -0
  273. package/src/modes/interactive/theme/defaults/dark-ocean.json +108 -0
  274. package/src/modes/interactive/theme/defaults/dark-one.json +107 -0
  275. package/src/modes/interactive/theme/defaults/dark-retro.json +99 -0
  276. package/src/modes/interactive/theme/defaults/dark-rose-pine.json +95 -0
  277. package/src/modes/interactive/theme/defaults/dark-solarized.json +96 -0
  278. package/src/modes/interactive/theme/defaults/dark-sunset.json +106 -0
  279. package/src/modes/interactive/theme/defaults/dark-synthwave.json +102 -0
  280. package/src/modes/interactive/theme/defaults/dark-tokyo-night.json +108 -0
  281. package/src/modes/interactive/theme/defaults/index.ts +67 -0
  282. package/src/modes/interactive/theme/defaults/light-arctic.json +106 -0
  283. package/src/modes/interactive/theme/defaults/light-catppuccin.json +105 -0
  284. package/src/modes/interactive/theme/defaults/light-cyberpunk.json +103 -0
  285. package/src/modes/interactive/theme/defaults/light-forest.json +107 -0
  286. package/src/modes/interactive/theme/defaults/light-github.json +114 -0
  287. package/src/modes/interactive/theme/defaults/light-gruvbox.json +115 -0
  288. package/src/modes/interactive/theme/defaults/light-monochrome.json +100 -0
  289. package/src/modes/interactive/theme/defaults/light-ocean.json +106 -0
  290. package/src/modes/interactive/theme/defaults/light-one.json +105 -0
  291. package/src/modes/interactive/theme/defaults/light-retro.json +105 -0
  292. package/src/modes/interactive/theme/defaults/light-solarized.json +101 -0
  293. package/src/modes/interactive/theme/defaults/light-sunset.json +106 -0
  294. package/src/modes/interactive/theme/defaults/light-synthwave.json +105 -0
  295. package/src/modes/interactive/theme/defaults/light-tokyo-night.json +118 -0
  296. package/src/modes/interactive/theme/light.json +99 -0
  297. package/src/modes/interactive/theme/theme-schema.json +424 -0
  298. package/src/modes/interactive/theme/theme.ts +2211 -0
  299. package/src/modes/print-mode.ts +163 -0
  300. package/src/modes/rpc/rpc-client.ts +527 -0
  301. package/src/modes/rpc/rpc-mode.ts +494 -0
  302. package/src/modes/rpc/rpc-types.ts +203 -0
  303. package/src/prompts/architect-plan.md +10 -0
  304. package/src/prompts/branch-summary-preamble.md +3 -0
  305. package/src/prompts/branch-summary.md +28 -0
  306. package/src/prompts/browser.md +71 -0
  307. package/src/prompts/compaction-summary.md +34 -0
  308. package/src/prompts/compaction-turn-prefix.md +16 -0
  309. package/src/prompts/compaction-update-summary.md +41 -0
  310. package/src/prompts/explore.md +82 -0
  311. package/src/prompts/implement-with-critic.md +11 -0
  312. package/src/prompts/implement.md +11 -0
  313. package/src/prompts/init.md +30 -0
  314. package/src/prompts/plan.md +54 -0
  315. package/src/prompts/reviewer.md +81 -0
  316. package/src/prompts/summarization-system.md +3 -0
  317. package/src/prompts/system-prompt.md +27 -0
  318. package/src/prompts/task.md +56 -0
  319. package/src/prompts/title-system.md +8 -0
  320. package/src/prompts/tools/ask.md +24 -0
  321. package/src/prompts/tools/bash.md +23 -0
  322. package/src/prompts/tools/edit.md +9 -0
  323. package/src/prompts/tools/find.md +6 -0
  324. package/src/prompts/tools/grep.md +12 -0
  325. package/src/prompts/tools/lsp.md +14 -0
  326. package/src/prompts/tools/output.md +23 -0
  327. package/src/prompts/tools/read.md +25 -0
  328. package/src/prompts/tools/web-fetch.md +8 -0
  329. package/src/prompts/tools/web-search.md +10 -0
  330. package/src/prompts/tools/write.md +10 -0
  331. package/src/utils/changelog.ts +99 -0
  332. package/src/utils/clipboard.ts +265 -0
  333. package/src/utils/fuzzy.ts +108 -0
  334. package/src/utils/mime.ts +30 -0
  335. package/src/utils/shell-snapshot.ts +218 -0
  336. package/src/utils/shell.ts +364 -0
  337. package/src/utils/tools-manager.ts +265 -0
@@ -0,0 +1,479 @@
1
+ /**
2
+ * ExtensionList - Inventory list with Master Switch and fuzzy search.
3
+ *
4
+ * When viewing a specific provider (not "ALL"), Row #0 is the Master Switch
5
+ * that toggles the entire provider. All items below are dimmed when the
6
+ * master switch is off.
7
+ */
8
+
9
+ import {
10
+ type Component,
11
+ isArrowDown,
12
+ isArrowUp,
13
+ isBackspace,
14
+ isEnter,
15
+ truncateToWidth,
16
+ visibleWidth,
17
+ } from "@oh-my-pi/pi-tui";
18
+ import { isProviderEnabled } from "../../../../discovery";
19
+ import { theme } from "../../theme/theme";
20
+ import { applyFilter } from "./state-manager";
21
+ import type { Extension, ExtensionKind, ExtensionState } from "./types";
22
+
23
+ export interface ExtensionListCallbacks {
24
+ /** Called when selection changes */
25
+ onSelectionChange?: (extension: Extension | null) => void;
26
+ /** Called when extension is toggled */
27
+ onToggle?: (extensionId: string, enabled: boolean) => void;
28
+ /** Called when master switch is toggled */
29
+ onMasterToggle?: (providerId: string) => void;
30
+ /** Provider ID for master switch (null = no master switch) */
31
+ masterSwitchProvider?: string | null;
32
+ }
33
+
34
+ const MAX_VISIBLE = 25;
35
+
36
+ /** Flattened list item for rendering */
37
+ type ListItem =
38
+ | { type: "master"; providerId: string; providerName: string; enabled: boolean }
39
+ | { type: "kind-header"; kind: ExtensionKind; label: string; icon: string; count: number }
40
+ | { type: "extension"; item: Extension };
41
+
42
+ export class ExtensionList implements Component {
43
+ private extensions: Extension[] = [];
44
+ private listItems: ListItem[] = [];
45
+ private selectedIndex = 0;
46
+ private scrollOffset = 0;
47
+ private searchQuery = "";
48
+ private focused = false;
49
+ private callbacks: ExtensionListCallbacks;
50
+ private masterSwitchProvider: string | null = null;
51
+
52
+ constructor(extensions: Extension[], callbacks: ExtensionListCallbacks = {}) {
53
+ this.extensions = extensions;
54
+ this.callbacks = callbacks;
55
+ this.masterSwitchProvider = callbacks.masterSwitchProvider ?? null;
56
+ this.rebuildList();
57
+ }
58
+
59
+ setExtensions(extensions: Extension[]): void {
60
+ this.extensions = extensions;
61
+ this.rebuildList();
62
+ this.clampSelection();
63
+ }
64
+
65
+ setFocused(focused: boolean): void {
66
+ this.focused = focused;
67
+ }
68
+
69
+ setMasterSwitchProvider(providerId: string | null): void {
70
+ this.masterSwitchProvider = providerId;
71
+ this.rebuildList();
72
+ }
73
+
74
+ getSearchQuery(): string {
75
+ return this.searchQuery;
76
+ }
77
+
78
+ resetSelection(): void {
79
+ this.selectedIndex = 0;
80
+ this.scrollOffset = 0;
81
+ this.notifySelectionChange();
82
+ }
83
+
84
+ getSelectedExtension(): Extension | null {
85
+ const item = this.listItems[this.selectedIndex];
86
+ return item?.type === "extension" ? item.item : null;
87
+ }
88
+
89
+ /** Get the currently selected kind header (for preview purposes) */
90
+ getSelectedKind(): ExtensionKind | null {
91
+ const item = this.listItems[this.selectedIndex];
92
+ return item?.type === "kind-header" ? item.kind : null;
93
+ }
94
+
95
+ setSearchQuery(query: string): void {
96
+ this.searchQuery = query;
97
+ this.rebuildList();
98
+ this.selectedIndex = 0;
99
+ this.scrollOffset = 0;
100
+ this.notifySelectionChange();
101
+ }
102
+
103
+ clearSearch(): void {
104
+ this.setSearchQuery("");
105
+ }
106
+
107
+ invalidate(): void {}
108
+
109
+ render(width: number): string[] {
110
+ const lines: string[] = [];
111
+
112
+ // Search bar
113
+ const searchPrefix = theme.fg("muted", "Search: ");
114
+ const searchText = this.searchQuery || (this.focused ? "" : theme.fg("dim", "type to filter"));
115
+ const cursor = this.focused ? theme.fg("accent", "_") : "";
116
+ lines.push(searchPrefix + searchText + cursor);
117
+ lines.push("");
118
+
119
+ if (this.listItems.length === 0) {
120
+ lines.push(theme.fg("muted", " No extensions found for this provider."));
121
+ return lines;
122
+ }
123
+
124
+ // Determine if master switch is off (for dimming child items)
125
+ const masterDisabled = this.masterSwitchProvider !== null && !isProviderEnabled(this.masterSwitchProvider);
126
+
127
+ // Calculate visible range
128
+ const startIdx = this.scrollOffset;
129
+ const endIdx = Math.min(startIdx + MAX_VISIBLE, this.listItems.length);
130
+
131
+ // Render visible items
132
+ for (let i = startIdx; i < endIdx; i++) {
133
+ const listItem = this.listItems[i];
134
+ const isSelected = this.focused && i === this.selectedIndex;
135
+
136
+ if (listItem.type === "master") {
137
+ lines.push(this.renderMasterSwitch(listItem, isSelected, width));
138
+ } else if (listItem.type === "kind-header") {
139
+ lines.push(this.renderKindHeader(listItem, isSelected, width));
140
+ } else {
141
+ lines.push(this.renderExtensionRow(listItem.item, isSelected, width, masterDisabled));
142
+ }
143
+ }
144
+
145
+ // Scroll indicator
146
+ if (this.listItems.length > MAX_VISIBLE) {
147
+ const indicator = theme.fg("muted", ` (${this.selectedIndex + 1}/${this.listItems.length})`);
148
+ lines.push(indicator);
149
+ }
150
+
151
+ return lines;
152
+ }
153
+
154
+ private renderMasterSwitch(item: ListItem & { type: "master" }, isSelected: boolean, width: number): string {
155
+ const checkbox = item.enabled
156
+ ? theme.fg("success", theme.checkbox.checked)
157
+ : theme.fg("dim", theme.checkbox.unchecked);
158
+ const icon = theme.icon.package;
159
+ const label = `Enable ${item.providerName}`;
160
+ const badge = theme.fg("warning", "(Master Switch)");
161
+
162
+ let line = `${checkbox} ${icon} ${label} ${badge}`;
163
+
164
+ if (isSelected) {
165
+ line = theme.bold(theme.fg("accent", line));
166
+ line = theme.bg("selectedBg", line);
167
+ } else if (!item.enabled) {
168
+ line = theme.fg("dim", line);
169
+ }
170
+
171
+ return truncateToWidth(line, width);
172
+ }
173
+
174
+ private renderKindHeader(item: ListItem & { type: "kind-header" }, isSelected: boolean, width: number): string {
175
+ const countBadge = theme.fg("muted", `(${item.count})`);
176
+ let line = `${item.icon} ${item.label} ${countBadge}`;
177
+
178
+ if (isSelected) {
179
+ line = theme.bold(theme.fg("accent", line));
180
+ line = theme.bg("selectedBg", line);
181
+ } else {
182
+ line = theme.fg("muted", line);
183
+ }
184
+
185
+ return truncateToWidth(line, width);
186
+ }
187
+
188
+ private renderExtensionRow(ext: Extension, isSelected: boolean, width: number, masterDisabled: boolean): string {
189
+ // When master is disabled, all items appear dimmed
190
+ const effectivelyDisabled = masterDisabled || ext.state === "disabled";
191
+
192
+ // Status icon
193
+ const stateIcon = this.getStateIcon(ext.state, masterDisabled);
194
+
195
+ // Name
196
+ let name = ext.displayName;
197
+ const nameWidth = Math.min(24, width - 16);
198
+
199
+ // Build the line with indentation (visually "inside" the master switch)
200
+ let line = ` ${stateIcon} `;
201
+
202
+ if (isSelected && !masterDisabled) {
203
+ name = theme.bold(theme.fg("accent", name));
204
+ } else if (effectivelyDisabled) {
205
+ name = theme.fg("dim", name);
206
+ } else if (ext.state === "shadowed") {
207
+ name = theme.fg("warning", name);
208
+ }
209
+
210
+ // Pad name
211
+ const namePadded = this.padText(name, nameWidth);
212
+ line += namePadded;
213
+
214
+ // Trigger hint
215
+ if (ext.trigger) {
216
+ const triggerStyle = effectivelyDisabled ? "dim" : "muted";
217
+ const remainingWidth = width - visibleWidth(line) - 2;
218
+ if (remainingWidth > 5) {
219
+ line += ` ${truncateToWidth(theme.fg(triggerStyle as "dim" | "muted", ext.trigger), remainingWidth)}`;
220
+ }
221
+ }
222
+
223
+ // Apply selection background
224
+ if (isSelected) {
225
+ line = theme.bg("selectedBg", line);
226
+ }
227
+
228
+ return truncateToWidth(line, width);
229
+ }
230
+
231
+ private getKindIcon(kind: ExtensionKind): string {
232
+ switch (kind) {
233
+ case "skill":
234
+ return theme.icon.extensionSkill;
235
+ case "tool":
236
+ return theme.icon.extensionTool;
237
+ case "slash-command":
238
+ return theme.icon.extensionSlashCommand;
239
+ case "mcp":
240
+ return theme.icon.extensionMcp;
241
+ case "rule":
242
+ return theme.icon.extensionRule;
243
+ case "hook":
244
+ return theme.icon.extensionHook;
245
+ case "prompt":
246
+ return theme.icon.extensionPrompt;
247
+ case "context-file":
248
+ return theme.icon.extensionContextFile;
249
+ case "instruction":
250
+ return theme.icon.extensionInstruction;
251
+ default:
252
+ return theme.format.bullet;
253
+ }
254
+ }
255
+
256
+ private getStateIcon(state: ExtensionState, masterDisabled: boolean): string {
257
+ if (masterDisabled) {
258
+ return theme.fg("dim", theme.status.disabled);
259
+ }
260
+ switch (state) {
261
+ case "active":
262
+ return theme.fg("success", theme.status.enabled);
263
+ case "disabled":
264
+ return theme.fg("dim", theme.status.disabled);
265
+ case "shadowed":
266
+ return theme.fg("warning", theme.status.shadowed);
267
+ }
268
+ }
269
+
270
+ private padText(text: string, targetWidth: number): string {
271
+ const width = visibleWidth(text);
272
+ if (width >= targetWidth) {
273
+ return truncateToWidth(text, targetWidth);
274
+ }
275
+ return text + " ".repeat(targetWidth - width);
276
+ }
277
+
278
+ private rebuildList(): void {
279
+ this.listItems = [];
280
+
281
+ // Apply search filter
282
+ const filtered = this.searchQuery.length > 0 ? applyFilter(this.extensions, this.searchQuery) : this.extensions;
283
+
284
+ // When searching, show flat list
285
+ if (this.searchQuery.length > 0) {
286
+ for (const ext of filtered) {
287
+ this.listItems.push({ type: "extension", item: ext });
288
+ }
289
+ return;
290
+ }
291
+
292
+ // Provider-specific view: Master switch + flat list
293
+ if (this.masterSwitchProvider) {
294
+ const providerName = filtered[0]?.source.providerName ?? this.masterSwitchProvider;
295
+ const enabled = isProviderEnabled(this.masterSwitchProvider);
296
+
297
+ this.listItems.push({
298
+ type: "master",
299
+ providerId: this.masterSwitchProvider,
300
+ providerName,
301
+ enabled,
302
+ });
303
+
304
+ for (const ext of filtered) {
305
+ this.listItems.push({ type: "extension", item: ext });
306
+ }
307
+ return;
308
+ }
309
+
310
+ // ALL view: Group by kind with headers
311
+ const byKind = new Map<ExtensionKind, Extension[]>();
312
+ for (const ext of filtered) {
313
+ const list = byKind.get(ext.kind) ?? [];
314
+ list.push(ext);
315
+ byKind.set(ext.kind, list);
316
+ }
317
+
318
+ const kindOrder: ExtensionKind[] = [
319
+ "skill",
320
+ "tool",
321
+ "slash-command",
322
+ "rule",
323
+ "mcp",
324
+ "hook",
325
+ "prompt",
326
+ "context-file",
327
+ "instruction",
328
+ ];
329
+
330
+ for (const kind of kindOrder) {
331
+ const items = byKind.get(kind);
332
+ if (!items || items.length === 0) continue;
333
+
334
+ this.listItems.push({
335
+ type: "kind-header",
336
+ kind,
337
+ label: this.getKindLabel(kind),
338
+ icon: this.getKindIcon(kind),
339
+ count: items.length,
340
+ });
341
+
342
+ for (const ext of items) {
343
+ this.listItems.push({ type: "extension", item: ext });
344
+ }
345
+ }
346
+ }
347
+
348
+ private getKindLabel(kind: ExtensionKind): string {
349
+ switch (kind) {
350
+ case "skill":
351
+ return "Skills";
352
+ case "tool":
353
+ return "Tools";
354
+ case "slash-command":
355
+ return "Commands";
356
+ case "rule":
357
+ return "Rules";
358
+ case "mcp":
359
+ return "MCP Servers";
360
+ case "hook":
361
+ return "Hooks";
362
+ case "prompt":
363
+ return "Prompts";
364
+ case "context-file":
365
+ return "Context";
366
+ case "instruction":
367
+ return "Instructions";
368
+ default:
369
+ return kind;
370
+ }
371
+ }
372
+
373
+ private clampSelection(): void {
374
+ if (this.listItems.length === 0) {
375
+ this.selectedIndex = 0;
376
+ this.scrollOffset = 0;
377
+ return;
378
+ }
379
+
380
+ this.selectedIndex = Math.min(this.selectedIndex, this.listItems.length - 1);
381
+ this.selectedIndex = Math.max(0, this.selectedIndex);
382
+
383
+ // Adjust scroll offset
384
+ if (this.selectedIndex < this.scrollOffset) {
385
+ this.scrollOffset = this.selectedIndex;
386
+ } else if (this.selectedIndex >= this.scrollOffset + MAX_VISIBLE) {
387
+ this.scrollOffset = this.selectedIndex - MAX_VISIBLE + 1;
388
+ }
389
+ }
390
+
391
+ handleInput(data: string): void {
392
+ const charCode = data.length === 1 ? data.charCodeAt(0) : -1;
393
+
394
+ // Navigation
395
+ if (isArrowUp(data) || data === "k") {
396
+ this.moveSelectionUp();
397
+ return;
398
+ }
399
+
400
+ if (isArrowDown(data) || data === "j") {
401
+ this.moveSelectionDown();
402
+ return;
403
+ }
404
+
405
+ // Space: Toggle selected item
406
+ if (data === " ") {
407
+ const item = this.listItems[this.selectedIndex];
408
+ if (item?.type === "master") {
409
+ this.callbacks.onMasterToggle?.(item.providerId);
410
+ } else if (item?.type === "extension") {
411
+ // Only allow toggling if master is enabled
412
+ const masterDisabled = this.masterSwitchProvider !== null && !isProviderEnabled(this.masterSwitchProvider);
413
+ if (!masterDisabled) {
414
+ const newEnabled = item.item.state === "disabled";
415
+ this.callbacks.onToggle?.(item.item.id, newEnabled);
416
+ }
417
+ }
418
+ return;
419
+ }
420
+
421
+ // Enter: Same as space - toggle selected item
422
+ if (isEnter(data)) {
423
+ const item = this.listItems[this.selectedIndex];
424
+ if (item?.type === "master") {
425
+ this.callbacks.onMasterToggle?.(item.providerId);
426
+ } else if (item?.type === "extension") {
427
+ const masterDisabled = this.masterSwitchProvider !== null && !isProviderEnabled(this.masterSwitchProvider);
428
+ if (!masterDisabled) {
429
+ const newEnabled = item.item.state === "disabled";
430
+ this.callbacks.onToggle?.(item.item.id, newEnabled);
431
+ }
432
+ }
433
+ return;
434
+ }
435
+
436
+ // Backspace: Delete from search query
437
+ if (isBackspace(data)) {
438
+ if (this.searchQuery.length > 0) {
439
+ this.setSearchQuery(this.searchQuery.slice(0, -1));
440
+ }
441
+ return;
442
+ }
443
+
444
+ // Printable characters -> search
445
+ if (data.length === 1 && charCode > 32 && charCode < 127) {
446
+ // Skip j/k as they're navigation
447
+ if (data === "j" || data === "k") {
448
+ return;
449
+ }
450
+ this.setSearchQuery(this.searchQuery + data);
451
+ return;
452
+ }
453
+ }
454
+
455
+ private moveSelectionUp(): void {
456
+ if (this.selectedIndex > 0) {
457
+ this.selectedIndex--;
458
+ if (this.selectedIndex < this.scrollOffset) {
459
+ this.scrollOffset = this.selectedIndex;
460
+ }
461
+ this.notifySelectionChange();
462
+ }
463
+ }
464
+
465
+ private moveSelectionDown(): void {
466
+ if (this.selectedIndex < this.listItems.length - 1) {
467
+ this.selectedIndex++;
468
+ if (this.selectedIndex >= this.scrollOffset + MAX_VISIBLE) {
469
+ this.scrollOffset = this.selectedIndex - MAX_VISIBLE + 1;
470
+ }
471
+ this.notifySelectionChange();
472
+ }
473
+ }
474
+
475
+ private notifySelectionChange(): void {
476
+ const ext = this.getSelectedExtension();
477
+ this.callbacks.onSelectionChange?.(ext);
478
+ }
479
+ }
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Extension Control Center exports.
3
+ */
4
+
5
+ export { ExtensionDashboard } from "./extension-dashboard";
6
+ export { ExtensionList } from "./extension-list";
7
+ export { InspectorPanel } from "./inspector-panel";
8
+ export * from "./state-manager";
9
+ export * from "./types";