@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,313 @@
1
+ /**
2
+ * InspectorPanel - Detail view for selected extension.
3
+ *
4
+ * Shows name, description, origin, status, and kind-specific preview.
5
+ */
6
+
7
+ import { readFileSync } from "node:fs";
8
+ import { homedir } from "node:os";
9
+ import { type Component, truncateToWidth, wrapTextWithAnsi } from "@oh-my-pi/pi-tui";
10
+ import { theme } from "../../theme/theme";
11
+ import type { Extension, ExtensionState } from "./types";
12
+
13
+ export class InspectorPanel implements Component {
14
+ private extension: Extension | null = null;
15
+
16
+ setExtension(extension: Extension | null): void {
17
+ this.extension = extension;
18
+ }
19
+
20
+ invalidate(): void {}
21
+
22
+ render(width: number): string[] {
23
+ if (!this.extension) {
24
+ return [theme.fg("muted", "Select an extension"), theme.fg("dim", "to view details")];
25
+ }
26
+
27
+ const ext = this.extension;
28
+ const lines: string[] = [];
29
+
30
+ // Name header
31
+ lines.push(theme.bold(theme.fg("accent", ext.displayName)));
32
+ lines.push("");
33
+
34
+ // Kind badge
35
+ lines.push(theme.fg("muted", "Type: ") + this.getKindBadge(ext.kind));
36
+ lines.push("");
37
+
38
+ // Description (wrapped)
39
+ if (ext.description) {
40
+ const wrapped = wrapTextWithAnsi(ext.description, width - 2);
41
+ for (const line of wrapped) {
42
+ lines.push(truncateToWidth(line, width));
43
+ }
44
+ lines.push("");
45
+ }
46
+
47
+ // Origin
48
+ lines.push(theme.fg("muted", "Origin:"));
49
+ const levelLabel = ext.source.level === "user" ? "User" : ext.source.level === "project" ? "Project" : "Native";
50
+ lines.push(` ${theme.italic(`via ${ext.source.providerName} (${levelLabel})`)}`);
51
+ lines.push(` ${theme.fg("dim", this.shortenPath(ext.path))}`);
52
+ lines.push("");
53
+
54
+ // Status badge
55
+ lines.push(theme.fg("muted", "Status:"));
56
+ lines.push(` ${this.getStatusBadge(ext.state, ext.disabledReason, ext.shadowedBy)}`);
57
+ lines.push("");
58
+
59
+ // Preview section (routed based on kind)
60
+ const previewLines = this.renderPreview(ext, width);
61
+ lines.push(...previewLines);
62
+
63
+ return lines;
64
+ }
65
+
66
+ private renderPreview(ext: Extension, width: number): string[] {
67
+ const lines: string[] = [];
68
+ let content: string[] = [];
69
+
70
+ switch (ext.kind) {
71
+ case "context-file":
72
+ content = this.renderFilePreview(ext.path, width);
73
+ break;
74
+ case "tool":
75
+ content = this.renderToolArgs(ext.raw, width);
76
+ break;
77
+ case "skill":
78
+ content = this.renderSkillContent(ext.raw, width);
79
+ break;
80
+ case "mcp":
81
+ content = this.renderMcpDetails(ext.raw, width);
82
+ break;
83
+ default:
84
+ content = this.renderDefaultPreview(ext, width);
85
+ break;
86
+ }
87
+
88
+ if (content.length > 0) {
89
+ lines.push(...content);
90
+ }
91
+
92
+ return lines;
93
+ }
94
+
95
+ private renderFilePreview(path: string, width: number): string[] {
96
+ const lines: string[] = [];
97
+ lines.push(theme.fg("muted", "Preview:"));
98
+ lines.push(theme.fg("dim", theme.boxSharp.horizontal.repeat(Math.min(width - 2, 40))));
99
+
100
+ try {
101
+ const content = readFileSync(path, "utf-8");
102
+ const fileLines = content.split("\n").slice(0, 20);
103
+
104
+ for (const line of fileLines) {
105
+ const highlighted = this.highlightMarkdown(line);
106
+ lines.push(truncateToWidth(highlighted, width - 2));
107
+ }
108
+
109
+ if (content.split("\n").length > 20) {
110
+ lines.push(theme.fg("dim", "(truncated at line 20)"));
111
+ }
112
+ } catch (err) {
113
+ lines.push(theme.fg("error", `Failed to read file: ${err instanceof Error ? err.message : String(err)}`));
114
+ }
115
+
116
+ lines.push("");
117
+ return lines;
118
+ }
119
+
120
+ private highlightMarkdown(line: string): string {
121
+ // Basic markdown syntax highlighting
122
+ let highlighted = line;
123
+
124
+ // Headers
125
+ if (/^#{1,6}\s/.test(highlighted)) {
126
+ highlighted = theme.bold(theme.fg("accent", highlighted));
127
+ }
128
+ // Code blocks
129
+ else if (/^```/.test(highlighted)) {
130
+ highlighted = theme.fg("dim", highlighted);
131
+ }
132
+ // Lists
133
+ else if (/^[\s]*[-*+]\s/.test(highlighted)) {
134
+ highlighted = highlighted.replace(/^([\s]*[-*+]\s)/, theme.fg("accent", "$1"));
135
+ }
136
+ // Numbered lists
137
+ else if (/^[\s]*\d+\.\s/.test(highlighted)) {
138
+ highlighted = highlighted.replace(/^([\s]*\d+\.\s)/, theme.fg("accent", "$1"));
139
+ }
140
+
141
+ return highlighted;
142
+ }
143
+
144
+ private renderToolArgs(raw: unknown, width: number): string[] {
145
+ const lines: string[] = [];
146
+ lines.push(theme.fg("muted", "Arguments:"));
147
+ lines.push(theme.fg("dim", theme.boxSharp.horizontal.repeat(Math.min(width - 2, 40))));
148
+
149
+ try {
150
+ const tool = raw as any;
151
+ const params = tool?.parameters?.properties || tool?.inputSchema?.properties || {};
152
+
153
+ if (Object.keys(params).length === 0) {
154
+ lines.push(theme.fg("dim", " (no arguments)"));
155
+ } else {
156
+ const required = new Set(tool?.parameters?.required || tool?.inputSchema?.required || []);
157
+
158
+ for (const [name, spec] of Object.entries(params)) {
159
+ const param = spec as any;
160
+ const type = param.type || "any";
161
+ const isRequired = required.has(name);
162
+ const defaultVal = param.default !== undefined ? `Default: ${param.default}` : null;
163
+
164
+ const nameCol = theme.fg("accent", name.padEnd(12));
165
+ const typeCol = theme.fg("muted", type.padEnd(10));
166
+ const reqCol = isRequired
167
+ ? theme.fg("warning", "Required")
168
+ : defaultVal
169
+ ? theme.fg("dim", defaultVal)
170
+ : theme.fg("dim", "Optional");
171
+
172
+ lines.push(` ${nameCol} ${typeCol} ${reqCol}`);
173
+ }
174
+ }
175
+ } catch {
176
+ lines.push(theme.fg("dim", " (unable to parse tool definition)"));
177
+ }
178
+
179
+ lines.push("");
180
+ return lines;
181
+ }
182
+
183
+ private renderSkillContent(raw: unknown, width: number): string[] {
184
+ const lines: string[] = [];
185
+ lines.push(theme.fg("muted", "Instruction:"));
186
+ lines.push(theme.fg("dim", theme.boxSharp.horizontal.repeat(Math.min(width - 2, 40))));
187
+
188
+ try {
189
+ const skill = raw as any;
190
+ const instruction = skill?.prompt || skill?.instruction || skill?.content || "";
191
+
192
+ if (!instruction) {
193
+ lines.push(theme.fg("dim", " (no instruction text)"));
194
+ } else {
195
+ const instructionLines = instruction.split("\n").slice(0, 15);
196
+ for (const line of instructionLines) {
197
+ lines.push(truncateToWidth(line, width - 2));
198
+ }
199
+
200
+ if (instruction.split("\n").length > 15) {
201
+ lines.push(theme.fg("dim", "(truncated at line 15)"));
202
+ }
203
+ }
204
+ } catch {
205
+ lines.push(theme.fg("dim", " (unable to parse skill content)"));
206
+ }
207
+
208
+ lines.push("");
209
+ return lines;
210
+ }
211
+
212
+ private renderMcpDetails(raw: unknown, width: number): string[] {
213
+ const lines: string[] = [];
214
+ lines.push(theme.fg("muted", "Connection:"));
215
+ lines.push(theme.fg("dim", theme.boxSharp.horizontal.repeat(Math.min(width - 2, 40))));
216
+
217
+ try {
218
+ const mcp = raw as any;
219
+ const transport = mcp?.transport || mcp?.type || "unknown";
220
+ const command = mcp?.command || mcp?.cmd || "";
221
+ const args = mcp?.args || mcp?.arguments || [];
222
+
223
+ lines.push(` ${theme.fg("muted", "Transport:")} ${theme.fg("accent", transport)}`);
224
+
225
+ if (command) {
226
+ lines.push(` ${theme.fg("muted", "Command:")} ${theme.fg("success", command)}`);
227
+ }
228
+
229
+ if (Array.isArray(args) && args.length > 0) {
230
+ lines.push(` ${theme.fg("muted", "Args:")} ${theme.fg("dim", args.join(" "))}`);
231
+ }
232
+
233
+ // Environment variables if present
234
+ if (mcp?.env && typeof mcp.env === "object") {
235
+ const envCount = Object.keys(mcp.env).length;
236
+ if (envCount > 0) {
237
+ lines.push(` ${theme.fg("muted", "Env vars:")} ${theme.fg("dim", `${envCount} defined`)}`);
238
+ }
239
+ }
240
+ } catch {
241
+ lines.push(theme.fg("dim", " (unable to parse MCP configuration)"));
242
+ }
243
+
244
+ lines.push("");
245
+ return lines;
246
+ }
247
+
248
+ private renderDefaultPreview(ext: Extension, width: number): string[] {
249
+ const lines: string[] = [];
250
+
251
+ // Show trigger pattern if present
252
+ if (ext.trigger) {
253
+ lines.push(theme.fg("muted", "Trigger:"));
254
+ lines.push(theme.fg("dim", theme.boxSharp.horizontal.repeat(Math.min(width - 2, 40))));
255
+ lines.push(` ${theme.fg("accent", ext.trigger)}`);
256
+ lines.push("");
257
+ }
258
+
259
+ return lines;
260
+ }
261
+
262
+ private getKindBadge(kind: string): string {
263
+ const kindColors: Record<string, string> = {
264
+ skill: "accent",
265
+ rule: "success",
266
+ tool: "warning",
267
+ mcp: "accent",
268
+ prompt: "muted",
269
+ hook: "warning",
270
+ "context-file": "dim",
271
+ instruction: "muted",
272
+ "slash-command": "accent",
273
+ };
274
+
275
+ const color = kindColors[kind] || "muted";
276
+ return theme.fg(color as any, kind);
277
+ }
278
+
279
+ private getStatusBadge(state: ExtensionState, reason?: string, shadowedBy?: string): string {
280
+ switch (state) {
281
+ case "active":
282
+ return theme.fg("success", `${theme.status.enabled} Active`);
283
+ case "disabled": {
284
+ const reasonText =
285
+ reason === "provider-disabled"
286
+ ? "provider disabled"
287
+ : reason === "item-disabled"
288
+ ? "manually disabled"
289
+ : "unknown";
290
+ return theme.fg("dim", `${theme.status.disabled} Disabled (${reasonText})`);
291
+ }
292
+ case "shadowed":
293
+ return theme.fg("warning", `${theme.status.shadowed} Shadowed${shadowedBy ? ` by ${shadowedBy}` : ""}`);
294
+ }
295
+ }
296
+
297
+ private shortenPath(path: string): string {
298
+ const home = homedir();
299
+ if (path.startsWith(home)) {
300
+ return `~${path.slice(home.length)}`;
301
+ }
302
+
303
+ // If path is very long, show just the last parts
304
+ if (path.length > 40) {
305
+ const parts = path.split("/");
306
+ if (parts.length > 3) {
307
+ return `.../${parts.slice(-3).join("/")}`;
308
+ }
309
+ }
310
+
311
+ return path;
312
+ }
313
+ }