gloomberb 0.20.0 → 0.20.2

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 (481) hide show
  1. package/README.md +16 -26
  2. package/README.zh-CN.md +21 -65
  3. package/package.json +1 -1
  4. package/patches/electrobun-devkit@2.0.5.patch +268 -8
  5. package/src/account/auth-model.ts +20 -1
  6. package/src/account/upgrade-dialog.tsx +8 -4
  7. package/src/api-client/askg.ts +7 -1
  8. package/src/api-client/auth.ts +27 -0
  9. package/src/api-client/catalysts.ts +2 -0
  10. package/src/api-client/company-kpis.ts +2 -1
  11. package/src/api-client/cot.ts +14 -2
  12. package/src/api-client/crypto-markets.ts +20 -2
  13. package/src/api-client/data.ts +3 -2
  14. package/src/api-client/earnings.ts +46 -3
  15. package/src/api-client/fund-facts.ts +23 -1
  16. package/src/api-client/futures-curve.ts +17 -0
  17. package/src/api-client/index.ts +4 -1
  18. package/src/api-client/one-tap-reasons.ts +42 -0
  19. package/src/api-client/perps.ts +2 -1
  20. package/src/api-client/request.ts +3 -1
  21. package/src/api-client/research-activity.ts +16 -3
  22. package/src/api-client/types/filings-and-calls.ts +9 -0
  23. package/src/api-client/types/search.ts +3 -0
  24. package/src/app/keybindings/chord.ts +153 -9
  25. package/src/app/keybindings/index.ts +1 -1
  26. package/src/app/keybindings/labels.ts +49 -6
  27. package/src/app/runtime/desktop-deeplink.ts +73 -8
  28. package/src/app/runtime/plugin-seed.ts +119 -0
  29. package/src/app/runtime/startup.ts +45 -9
  30. package/src/app.tsx +8 -1
  31. package/src/architecture/core-builtin-allowlist.json +1 -2
  32. package/src/architecture/pane-tabs-allowlist.json +2 -1
  33. package/src/architecture/shortcut-labels-allowlist.json +11 -0
  34. package/src/architecture/ui-literals-allowlist.json +8 -8
  35. package/src/brokers/broker-portfolio-sync.ts +1 -1
  36. package/src/cli/bank-section.ts +26 -12
  37. package/src/cli/board-coins.ts +38 -5
  38. package/src/cli/commands/crypto-hints.ts +8 -1
  39. package/src/cli/commands/market.ts +294 -100
  40. package/src/cli/commands/overview.ts +13 -6
  41. package/src/cli/commands/ticker.ts +73 -21
  42. package/src/cli/company-name-hint.ts +19 -0
  43. package/src/cli/desktop-pane-shot-browser.ts +47 -31
  44. package/src/cli/desktop-pane-shot.ts +15 -0
  45. package/src/cli/entry.ts +15 -4
  46. package/src/cli/export-source.ts +7 -1
  47. package/src/cli/freshness.ts +0 -16
  48. package/src/cli/fx-pair.ts +64 -12
  49. package/src/cli/fx-quote-rate.ts +144 -0
  50. package/src/cli/glossary.ts +30 -0
  51. package/src/cli/helpers.ts +4 -2
  52. package/src/cli/history-back-adjust.ts +122 -0
  53. package/src/cli/history-rows.ts +114 -10
  54. package/src/cli/index.ts +4 -1
  55. package/src/cli/known-gaps.ts +45 -3
  56. package/src/cli/listing-arg.ts +48 -4
  57. package/src/cli/name-entries.ts +25 -5
  58. package/src/cli/not-a-ticker.ts +26 -1
  59. package/src/cli/pane-functions/catalog.ts +12 -2
  60. package/src/cli/pane-functions/dom.ts +4 -2
  61. package/src/cli/pane-functions/freshness.ts +45 -29
  62. package/src/cli/pane-functions/headless.ts +8 -5
  63. package/src/cli/pane-functions/index.ts +3 -0
  64. package/src/cli/pane-functions/market-session.ts +14 -5
  65. package/src/cli/pane-functions/resolver.ts +4 -1
  66. package/src/cli/pane-functions/screenshot-assessment.ts +15 -3
  67. package/src/cli/pane-functions/screenshot-payload.ts +130 -66
  68. package/src/cli/pane-functions/screenshot-render.ts +14 -2
  69. package/src/cli/pane-functions/screenshot-types.ts +4 -0
  70. package/src/cli/restore-plugins.ts +164 -51
  71. package/src/cli/symbol-rows.ts +22 -2
  72. package/src/cli/ticker-resolution.ts +74 -17
  73. package/src/components/chart/composite/axis-overlays.tsx +13 -3
  74. package/src/components/chart/composite/composite-chart.tsx +8 -1
  75. package/src/components/chart/composite/format.ts +16 -1
  76. package/src/components/chart/composite/legend.tsx +4 -3
  77. package/src/components/chart/composite/panel-labels.ts +2 -1
  78. package/src/components/chart/composite/panel-surface.tsx +33 -4
  79. package/src/components/chart/composite/time-scale.ts +1 -1
  80. package/src/components/chart/composite/toolbar.tsx +8 -4
  81. package/src/components/chart/composite/types.ts +17 -1
  82. package/src/components/chart/composite/use-composite-chart-keyboard.ts +15 -5
  83. package/src/components/chart/composite/use-composite-viewport.ts +31 -8
  84. package/src/components/chart/static/scatter-chart-surface.tsx +25 -9
  85. package/src/components/chart-table/axis.ts +11 -0
  86. package/src/components/chart-table/header.tsx +10 -1
  87. package/src/components/chart-table/layout.ts +14 -5
  88. package/src/components/command-bar/assist/inventory.ts +3 -2
  89. package/src/components/command-bar/commands/collection-list.ts +3 -2
  90. package/src/components/command-bar/panel/index.tsx +13 -0
  91. package/src/components/command-bar/panel/layout.ts +15 -1
  92. package/src/components/command-bar/panel/prompt-width.ts +34 -0
  93. package/src/components/command-bar/panel/runtime.ts +1 -0
  94. package/src/components/command-bar/panel/state.ts +4 -0
  95. package/src/components/command-bar/panel/types.ts +2 -0
  96. package/src/components/command-bar/routes/root/search-providers.ts +3 -2
  97. package/src/components/command-bar/routes/root/search-report.ts +2 -2
  98. package/src/components/command-bar/workflow/ticker-listing-picker.ts +1 -0
  99. package/src/components/company-logo.tsx +2 -2
  100. package/src/components/data-table/view.tsx +11 -2
  101. package/src/components/feed-data-table/stack-view.tsx +20 -6
  102. package/src/components/feedback-dialog.tsx +3 -1
  103. package/src/components/form-modal/field-row.tsx +1 -1
  104. package/src/components/form-modal/routes.ts +1 -0
  105. package/src/components/index.ts +1 -1
  106. package/src/components/layout/header.tsx +12 -3
  107. package/src/components/layout/market-summary.ts +2 -1
  108. package/src/components/layout/pane/footer/index.tsx +9 -5
  109. package/src/components/layout/pane/footer/model.ts +26 -10
  110. package/src/components/layout/pane/footer/registration.tsx +60 -1
  111. package/src/components/layout/pane/header-tabs.tsx +17 -3
  112. package/src/components/layout/pane/header.tsx +5 -2
  113. package/src/components/layout/pane/pane-tabs.tsx +57 -3
  114. package/src/components/layout/shell/active-drag.ts +38 -30
  115. package/src/components/layout/shell/drag/index.ts +51 -21
  116. package/src/components/layout/shell/menu.ts +3 -5
  117. package/src/components/layout/shell/pane/actions.ts +4 -1
  118. package/src/components/layout/shell/pane/ask.ts +5 -2
  119. package/src/components/layout/status-bar.tsx +59 -54
  120. package/src/components/markdown-text.tsx +35 -10
  121. package/src/components/onboarding/first-run-workspace.ts +25 -23
  122. package/src/components/onboarding/onboarding-keyboard.ts +6 -1
  123. package/src/components/onboarding/onboarding-wizard.tsx +12 -2
  124. package/src/components/onboarding/portfolio-step/positions-panel.tsx +3 -3
  125. package/src/components/onboarding/use-onboarding-broker-form.ts +2 -1
  126. package/src/components/onboarding/use-onboarding-progress.ts +11 -4
  127. package/src/components/onboarding/use-onboarding-upgrade.ts +3 -2
  128. package/src/components/onboarding/wizard-positions.ts +8 -1
  129. package/src/components/pane-notice-seen.ts +125 -0
  130. package/src/components/pane-settings-dialog/field-dialogs.tsx +2 -1
  131. package/src/components/pane-settings-dialog.tsx +7 -6
  132. package/src/components/sign-in-code-panel.tsx +3 -2
  133. package/src/components/speedometer-gauge/terminal.tsx +30 -9
  134. package/src/components/ticker/list-table-view.tsx +39 -3
  135. package/src/components/ui/confirm-dialog.tsx +2 -1
  136. package/src/components/ui/data-table/index.tsx +4 -2
  137. package/src/components/ui/data-table/opentui/index.tsx +15 -5
  138. package/src/components/ui/data-table/types.ts +8 -0
  139. package/src/components/ui/external-link.tsx +4 -1
  140. package/src/components/ui/field-grid.tsx +1 -1
  141. package/src/components/ui/index.ts +2 -0
  142. package/src/components/ui/inline-quick-add.tsx +5 -0
  143. package/src/components/ui/multi-select/dialog.tsx +10 -9
  144. package/src/components/ui/pane-link-chip.tsx +354 -0
  145. package/src/components/ui/query-bar.tsx +22 -13
  146. package/src/components/ui/ratio-bar.tsx +24 -1
  147. package/src/components/ui/select-button.tsx +2 -1
  148. package/src/components/ui/shortcut-hint.tsx +6 -3
  149. package/src/components/ui/table-layout.ts +81 -0
  150. package/src/components/ui/tabs.tsx +45 -6
  151. package/src/components/use-pane-notice-footer.tsx +12 -4
  152. package/src/core/app-service-ports.ts +1 -1
  153. package/src/data/plugin-state-store.ts +44 -8
  154. package/src/docs/snapshot.json +53 -32
  155. package/src/i18n/es.ts +28 -6
  156. package/src/i18n/ja.ts +28 -5
  157. package/src/i18n/ko.ts +28 -5
  158. package/src/i18n/zh-cn.ts +28 -5
  159. package/src/i18n/zh-tw.ts +28 -5
  160. package/src/layout/pane-manager/gridlock-inference.ts +2 -1
  161. package/src/layout/pane-manager/gridlock.ts +47 -2
  162. package/src/layout-marketplace/api.ts +1 -0
  163. package/src/layout-marketplace/gallery.tsx +4 -3
  164. package/src/layout-marketplace/linked.ts +6 -4
  165. package/src/layout-marketplace/model.ts +3 -2
  166. package/src/market-data/fund-facts.ts +7 -1
  167. package/src/market-data/futures-contract.ts +77 -31
  168. package/src/market-data/fx-closes.ts +5 -2
  169. package/src/market-data/hooks.tsx +23 -0
  170. package/src/market-data/market/change-basis.ts +92 -14
  171. package/src/market-data/market/format.ts +81 -13
  172. package/src/market-data/market/futures-week.ts +3 -1
  173. package/src/market-data/market/globex-day.ts +73 -0
  174. package/src/market-data/market/index-level.ts +10 -1
  175. package/src/market-data/quotes/intraday-bar.ts +1 -1
  176. package/src/market-data/quotes/session-split.ts +28 -0
  177. package/src/plugins/builtin/account-management/pane.tsx +1 -1
  178. package/src/plugins/builtin/analytics/account-returns.ts +1 -1
  179. package/src/plugins/builtin/analytics/index.tsx +10 -3
  180. package/src/plugins/builtin/analytics/pane-model.ts +1 -1
  181. package/src/plugins/builtin/analytics/risk-client.ts +4 -1
  182. package/src/plugins/builtin/analytics/risk-episodes.ts +422 -0
  183. package/src/plugins/builtin/analytics/risk-fx.ts +1 -1
  184. package/src/plugins/builtin/analytics/risk-headless.ts +28 -10
  185. package/src/plugins/builtin/analytics/risk-math.ts +1 -1
  186. package/src/plugins/builtin/analytics/risk-model.ts +115 -26
  187. package/src/plugins/builtin/analytics/risk-pane.tsx +201 -23
  188. package/src/plugins/builtin/analytics/sharpe-cadence.ts +1 -1
  189. package/src/plugins/builtin/backtest/format.ts +14 -0
  190. package/src/plugins/builtin/backtest/pane.tsx +3 -3
  191. package/src/plugins/builtin/backtest/report.ts +5 -3
  192. package/src/plugins/builtin/broker-manager/add-request.ts +10 -1
  193. package/src/plugins/builtin/broker-trading/pane.tsx +20 -2
  194. package/src/plugins/builtin/buildout/company/flow.tsx +5 -5
  195. package/src/plugins/builtin/buildout/company/model.ts +14 -2
  196. package/src/plugins/builtin/catalysts/detail.tsx +2 -2
  197. package/src/plugins/builtin/catalysts/model.ts +7 -2
  198. package/src/plugins/builtin/catalysts/pane.tsx +2 -2
  199. package/src/plugins/builtin/chart-composer/headless.ts +57 -17
  200. package/src/plugins/builtin/chart-composer/session-range.ts +82 -3
  201. package/src/plugins/builtin/chat/message/pane-chip.tsx +36 -208
  202. package/src/plugins/builtin/cloud/askg/answer-follow-ups.tsx +61 -0
  203. package/src/plugins/builtin/cloud/askg/answer-sources.tsx +102 -0
  204. package/src/plugins/builtin/cloud/askg/controller.ts +7 -1
  205. package/src/plugins/builtin/cloud/askg/host.ts +57 -0
  206. package/src/plugins/builtin/cloud/askg/model.ts +45 -5
  207. package/src/plugins/builtin/cloud/askg/pane.tsx +304 -25
  208. package/src/plugins/builtin/cloud/askg/protocol.ts +26 -1
  209. package/src/plugins/builtin/cloud/askg/sources.ts +466 -0
  210. package/src/plugins/builtin/cloud/one-tap/controller.ts +309 -0
  211. package/src/plugins/builtin/cloud/one-tap/google-identity.ts +142 -0
  212. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +101 -0
  213. package/src/plugins/builtin/cloud/plugin.tsx +7 -1
  214. package/src/plugins/builtin/company-kpis/client.ts +4 -3
  215. package/src/plugins/builtin/company-kpis/model.ts +34 -3
  216. package/src/plugins/builtin/correlation/compute.ts +8 -2
  217. package/src/plugins/builtin/correlation/headless.ts +10 -9
  218. package/src/plugins/builtin/correlation/history.ts +30 -0
  219. package/src/plugins/builtin/correlation/index.tsx +39 -167
  220. package/src/plugins/builtin/correlation/matrix/grid.tsx +285 -0
  221. package/src/plugins/builtin/correlation/matrix/model.ts +10 -10
  222. package/src/plugins/builtin/correlation/relationship/model.ts +3 -6
  223. package/src/plugins/builtin/correlation/relationship/pane.tsx +7 -9
  224. package/src/plugins/builtin/correlation/relationship/view-model.ts +14 -5
  225. package/src/plugins/builtin/cot/client.ts +8 -3
  226. package/src/plugins/builtin/cot/headless.ts +65 -12
  227. package/src/plugins/builtin/cot/pane.tsx +11 -5
  228. package/src/plugins/builtin/crypto-board/client.ts +6 -1
  229. package/src/plugins/builtin/crypto-board/defi-view.tsx +12 -1
  230. package/src/plugins/builtin/crypto-board/defi.ts +44 -7
  231. package/src/plugins/builtin/crypto-board/headless.ts +83 -12
  232. package/src/plugins/builtin/crypto-board/model.ts +30 -6
  233. package/src/plugins/builtin/crypto-board/pane.tsx +13 -2
  234. package/src/plugins/builtin/earnings/client.ts +40 -6
  235. package/src/plugins/builtin/earnings/fiscal-quarter.ts +54 -0
  236. package/src/plugins/builtin/earnings/headless.ts +47 -11
  237. package/src/plugins/builtin/earnings/history-model.ts +136 -24
  238. package/src/plugins/builtin/earnings/history-table.ts +42 -10
  239. package/src/plugins/builtin/earnings/history.tsx +23 -8
  240. package/src/plugins/builtin/earnings-ripple/client.ts +5 -2
  241. package/src/plugins/builtin/earnings-ripple/headless.ts +8 -3
  242. package/src/plugins/builtin/earnings-ripple/model.ts +21 -0
  243. package/src/plugins/builtin/earnings-ripple/pane.tsx +2 -3
  244. package/src/plugins/builtin/econ/index.tsx +5 -4
  245. package/src/plugins/builtin/econ-statistics/stats.ts +13 -5
  246. package/src/plugins/builtin/equity-screener/headless.ts +2 -1
  247. package/src/plugins/builtin/filing-events/feed.ts +56 -18
  248. package/src/plugins/builtin/filing-events/pane.tsx +8 -2
  249. package/src/plugins/builtin/futures/index.tsx +32 -10
  250. package/src/plugins/builtin/futures/model.ts +93 -6
  251. package/src/plugins/builtin/futures/returns.ts +29 -7
  252. package/src/plugins/builtin/futures/table.tsx +59 -17
  253. package/src/plugins/builtin/futures/use-front-returns.ts +32 -6
  254. package/src/plugins/builtin/futures-curve/client.ts +12 -2
  255. package/src/plugins/builtin/futures-curve/headless.ts +58 -17
  256. package/src/plugins/builtin/futures-curve/model.ts +111 -15
  257. package/src/plugins/builtin/futures-curve/pane.tsx +11 -6
  258. package/src/plugins/builtin/fx-matrix/amount.ts +132 -0
  259. package/src/plugins/builtin/fx-matrix/headless.ts +53 -13
  260. package/src/plugins/builtin/fx-matrix/index.tsx +205 -42
  261. package/src/plugins/builtin/fx-matrix/pairs.ts +10 -8
  262. package/src/plugins/builtin/fx-matrix/settings.ts +22 -1
  263. package/src/plugins/builtin/help/index.tsx +68 -61
  264. package/src/plugins/builtin/holders/format.ts +7 -2
  265. package/src/plugins/builtin/holders/pane.tsx +11 -3
  266. package/src/plugins/builtin/holders/report-header.ts +5 -4
  267. package/src/plugins/builtin/holders/report-rows.ts +4 -1
  268. package/src/plugins/builtin/holders/treemap.tsx +5 -3
  269. package/src/plugins/builtin/insider/signals-model.ts +4 -5
  270. package/src/plugins/builtin/ipo-calendar/headless.ts +18 -7
  271. package/src/plugins/builtin/ipo-calendar/listing-ipo.ts +3 -1
  272. package/src/plugins/builtin/ipo-calendar/model.ts +28 -8
  273. package/src/plugins/builtin/ipo-calendar/pane.tsx +2 -1
  274. package/src/plugins/builtin/kelly-sizer/headless.ts +4 -0
  275. package/src/plugins/builtin/perps/headless.ts +81 -19
  276. package/src/plugins/builtin/perps/index.tsx +3 -1
  277. package/src/plugins/builtin/perps/model.ts +1 -1
  278. package/src/plugins/builtin/perps/pane.tsx +2 -0
  279. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  280. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +20 -1
  281. package/src/plugins/builtin/portfolio-list/cli/import-positions.ts +260 -0
  282. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +154 -0
  283. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +64 -22
  284. package/src/plugins/builtin/portfolio-list/cli/render.ts +18 -7
  285. package/src/plugins/builtin/portfolio-list/cli/watchlist-command.ts +5 -3
  286. package/src/plugins/builtin/portfolio-list/grid.tsx +56 -12
  287. package/src/plugins/builtin/portfolio-list/headless.ts +128 -0
  288. package/src/plugins/builtin/portfolio-list/pane/index.tsx +42 -4
  289. package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +124 -0
  290. package/src/plugins/builtin/portfolio-list/period-pnl.ts +179 -0
  291. package/src/plugins/builtin/portfolio-list/positions-import/dialog.tsx +445 -0
  292. package/src/plugins/builtin/portfolio-list/positions-import/index.tsx +255 -0
  293. package/src/plugins/builtin/portfolio-list/positions-import/lookup.ts +78 -0
  294. package/src/plugins/builtin/portfolio-list/positions-import/read-file.ts +32 -0
  295. package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +186 -50
  296. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +118 -4
  297. package/src/plugins/builtin/portfolio-list/settings.ts +25 -0
  298. package/src/plugins/builtin/portfolio-list/summary/index.tsx +16 -1
  299. package/src/plugins/builtin/portfolio-list/summary/totals.ts +7 -5
  300. package/src/plugins/builtin/portfolio-list/table.tsx +105 -6
  301. package/src/plugins/builtin/power/headless.ts +47 -9
  302. package/src/plugins/builtin/research/relative-valuation-model.ts +8 -3
  303. package/src/plugins/builtin/research-search/article.ts +12 -2
  304. package/src/plugins/builtin/research-search/data.ts +5 -2
  305. package/src/plugins/builtin/research-search/document-view.tsx +1 -1
  306. package/src/plugins/builtin/research-search/model.ts +47 -3
  307. package/src/plugins/builtin/research-search/pane.tsx +3 -2
  308. package/src/plugins/builtin/reverse-dcf/model.ts +7 -4
  309. package/src/plugins/builtin/risk-factors/headless.ts +3 -2
  310. package/src/plugins/builtin/risk-factors/index.tsx +2 -28
  311. package/src/plugins/builtin/risk-factors/lock-note.ts +58 -0
  312. package/src/plugins/builtin/risk-factors/pane.tsx +14 -5
  313. package/src/plugins/builtin/scanner/flow-model.ts +17 -13
  314. package/src/plugins/builtin/scanner/flow-pane.tsx +8 -9
  315. package/src/plugins/builtin/scanner/flow-session.ts +2 -9
  316. package/src/plugins/builtin/scanner/hilo-model.ts +4 -3
  317. package/src/plugins/builtin/sec/filing-display.tsx +0 -5
  318. package/src/plugins/builtin/sec/forms.ts +19 -0
  319. package/src/plugins/builtin/sec/fund-facts.ts +45 -11
  320. package/src/plugins/builtin/sec/headless.ts +37 -12
  321. package/src/plugins/builtin/sec/index.tsx +37 -8
  322. package/src/plugins/builtin/shared/earnings-calendar.ts +6 -3
  323. package/src/plugins/builtin/shared/earnings-report.ts +1 -1
  324. package/src/plugins/builtin/shared/fx-rate-freshness.ts +0 -35
  325. package/src/plugins/builtin/shared/pro-lock-note.ts +5 -1
  326. package/src/plugins/builtin/shared/use-quote-board.ts +42 -27
  327. package/src/plugins/builtin/supply-chain/graph-model.ts +7 -1
  328. package/src/plugins/builtin/supply-chain/headless.ts +20 -10
  329. package/src/plugins/builtin/supply-chain/model.ts +117 -20
  330. package/src/plugins/builtin/supply-chain/pane.tsx +22 -15
  331. package/src/plugins/builtin/supply-chain/row-evidence.tsx +1 -1
  332. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart-model.ts +69 -0
  333. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart.tsx +118 -0
  334. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +1 -1
  335. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +103 -40
  336. package/src/plugins/builtin/ticker-detail/headless-schema.ts +10 -1
  337. package/src/plugins/builtin/ticker-detail/headless.ts +8 -1
  338. package/src/plugins/builtin/ticker-detail/overview/components.tsx +2 -1
  339. package/src/plugins/builtin/ticker-detail/overview/model.ts +18 -8
  340. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +11 -8
  341. package/src/plugins/builtin/ticker-detail/pane.tsx +95 -20
  342. package/src/plugins/builtin/ticker-detail/research-groups.ts +89 -0
  343. package/src/plugins/builtin/ticker-detail/settings.ts +4 -3
  344. package/src/plugins/builtin/time-sales/headless.ts +23 -7
  345. package/src/plugins/builtin/time-sales/index.tsx +2 -2
  346. package/src/plugins/builtin/volatility/charts.tsx +2 -2
  347. package/src/plugins/extracted-plugins.ts +49 -24
  348. package/src/plugins/host-resolver.ts +3 -2
  349. package/src/plugins/installer.ts +220 -31
  350. package/src/plugins/running-installs.ts +34 -0
  351. package/src/plugins/seed-progress.ts +72 -0
  352. package/src/portfolio/column-values.ts +42 -8
  353. package/src/portfolio/futures-positions.ts +10 -2
  354. package/src/portfolio/mutations.ts +4 -3
  355. package/src/portfolio/period-pnl.ts +119 -0
  356. package/src/portfolio/positions-import/describe.ts +89 -0
  357. package/src/portfolio/positions-import/parse.ts +682 -0
  358. package/src/portfolio/positions-import/plan.ts +295 -0
  359. package/src/{plugins/builtin/analytics/metrics.ts → portfolio/return-metrics.ts} +24 -11
  360. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  361. package/src/react/jsx-dev-fallback.ts +62 -0
  362. package/src/renderers/browser/cloud-transport.ts +1 -1
  363. package/src/renderers/browser/config-host.ts +3 -1
  364. package/src/renderers/browser/deeplink-bridge.ts +8 -1
  365. package/src/renderers/browser/http-proxy-transport.ts +9 -2
  366. package/src/renderers/browser/main.tsx +2 -1
  367. package/src/renderers/browser/research-entry.ts +12 -0
  368. package/src/renderers/cloudflare/http-proxy.ts +8 -2
  369. package/src/renderers/cloudflare/proxy-session.ts +1 -0
  370. package/src/renderers/cloudflare/worker.ts +12 -3
  371. package/src/renderers/dom/desktop/audio-player.tsx +2 -2
  372. package/src/renderers/dom/desktop/controls.tsx +1 -1
  373. package/src/renderers/dom/desktop/dialog-actions.tsx +10 -24
  374. package/src/renderers/dom/desktop/icons.tsx +4 -2
  375. package/src/renderers/dom/desktop/query-bar.tsx +23 -19
  376. package/src/renderers/dom/dom-host-providers.tsx +7 -2
  377. package/src/renderers/dom/host/box.tsx +2 -2
  378. package/src/renderers/dom/host/input.tsx +13 -0
  379. package/src/renderers/dom/key-event.ts +1 -0
  380. package/src/renderers/dom/styles.css +3 -0
  381. package/src/renderers/electrobun/bun/context-menu/click.ts +1 -0
  382. package/src/renderers/electrobun/bun/desktop/backend.ts +15 -0
  383. package/src/renderers/electrobun/bun/desktop/capability-bridge.ts +5 -4
  384. package/src/renderers/electrobun/bun/desktop/host-requests.ts +19 -11
  385. package/src/renderers/electrobun/bun/desktop/http-fetch.ts +1 -0
  386. package/src/renderers/electrobun/bun/desktop/http-stream.ts +1 -1
  387. package/src/renderers/electrobun/bun/desktop/initialization.ts +27 -15
  388. package/src/renderers/electrobun/bun/desktop/install-records.ts +4 -1
  389. package/src/renderers/electrobun/bun/desktop/installer-folder.ts +5 -2
  390. package/src/renderers/electrobun/bun/desktop/macos-objc.ts +3 -1
  391. package/src/renderers/electrobun/bun/desktop/screen-setup-file.ts +9 -4
  392. package/src/renderers/electrobun/bun/desktop/update.ts +27 -13
  393. package/src/renderers/electrobun/bun/desktop/windows-script.ts +6 -2
  394. package/src/renderers/electrobun/bun/index.ts +5 -0
  395. package/src/renderers/electrobun/bun/window/attention.ts +1 -0
  396. package/src/renderers/electrobun/bun/window/boot-frame.ts +1 -0
  397. package/src/renderers/electrobun/bun/window/context-menu-thread.ts +84 -0
  398. package/src/renderers/electrobun/bun/window/create.ts +1 -0
  399. package/src/renderers/electrobun/bun/window/electrobun-window-host.ts +13 -8
  400. package/src/renderers/electrobun/bun/window/native-call-thread.ts +224 -0
  401. package/src/renderers/electrobun/bun/window/native-min-size.ts +1 -1
  402. package/src/renderers/electrobun/bun/window/native-timing.ts +10 -0
  403. package/src/renderers/electrobun/bun/window/remembered-frame.ts +1 -0
  404. package/src/renderers/electrobun/bun/window/script-for-webview.ts +15 -0
  405. package/src/renderers/electrobun/bun/window/webview-script-thread.ts +82 -0
  406. package/src/renderers/electrobun/bun/window/windows-native.ts +3 -1
  407. package/src/renderers/electrobun/bun/window/windows-quit.ts +3 -1
  408. package/src/renderers/electrobun/shared/protocol.ts +13 -2
  409. package/src/renderers/electrobun/view/app-badge-host.ts +2 -1
  410. package/src/renderers/electrobun/view/backend-rpc.ts +7 -0
  411. package/src/renderers/electrobun/view/capability-subscription.ts +2 -1
  412. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +7 -10
  413. package/src/renderers/electrobun/view/cli-pane-shot-frame.tsx +1 -1
  414. package/src/renderers/electrobun/view/cli-pane-shot-mutations.ts +36 -0
  415. package/src/renderers/electrobun/view/http-fetch.ts +2 -1
  416. package/src/renderers/electrobun/view/main.tsx +13 -7
  417. package/src/renderers/electrobun/view/remote/capability-invoker.ts +6 -3
  418. package/src/renderers/electrobun/view/remote/persistence.ts +63 -27
  419. package/src/renderers/electrobun/view/rpc-timeout.ts +1 -0
  420. package/src/renderers/electrobun/view/ui-host.tsx +3 -2
  421. package/src/renderers/electrobun/view/window-fullscreen.ts +3 -1
  422. package/src/renderers/opentui/browser-open.ts +2 -1
  423. package/src/renderers/opentui/dialog-host.tsx +1 -1
  424. package/src/renderers/opentui/interaction-performance.ts +3 -1
  425. package/src/renderers/opentui/start.tsx +5 -1
  426. package/src/renderers/opentui/terminal-media.ts +11 -6
  427. package/src/renderers/opentui/ui-host.tsx +5 -8
  428. package/src/shares/open.ts +22 -1
  429. package/src/shares/pane.ts +2 -1
  430. package/src/sources/gloomberb-cloud/normalizers.ts +3 -0
  431. package/src/sync/analytics-payload.ts +194 -0
  432. package/src/sync/baseline.ts +19 -9
  433. package/src/sync/broker-identity.ts +171 -0
  434. package/src/sync/broker-instances.ts +137 -0
  435. package/src/sync/collections-contributor.ts +173 -0
  436. package/src/sync/config-contributor.ts +100 -0
  437. package/src/sync/config-merge.ts +229 -0
  438. package/src/sync/controller.ts +139 -28
  439. package/src/sync/core-contributors.ts +8 -1583
  440. package/src/sync/history-memo.ts +32 -0
  441. package/src/sync/layout-merge.ts +259 -0
  442. package/src/sync/sanitize.ts +114 -0
  443. package/src/sync/ticker-merge.ts +208 -0
  444. package/src/sync/ticker-payload.ts +81 -0
  445. package/src/sync/types.ts +15 -1
  446. package/src/telemetry/attention-setting.ts +1 -1
  447. package/src/telemetry/stall-reports.ts +21 -4
  448. package/src/telemetry/usage-counts.ts +16 -0
  449. package/src/test-support/preload.ts +5 -0
  450. package/src/theme/color-utils.ts +10 -0
  451. package/src/theme/font-scale.ts +34 -3
  452. package/src/theme/series-colors.ts +44 -0
  453. package/src/theme/themes.ts +2 -1
  454. package/src/tickers/batched-lookups.ts +263 -6
  455. package/src/tickers/company-name-listing.ts +44 -2
  456. package/src/tickers/company-name.ts +7 -2
  457. package/src/tickers/search/upsert.ts +16 -1
  458. package/src/time-series/base-series.ts +18 -4
  459. package/src/time-series/studies/indicators.ts +3 -1
  460. package/src/time-series/studies/resolve.ts +1 -1
  461. package/src/time-series/types.ts +6 -0
  462. package/src/types/financials.ts +18 -0
  463. package/src/types/headless.ts +11 -0
  464. package/src/ui/host.tsx +26 -3
  465. package/src/ui/index.tsx +1 -0
  466. package/src/utils/concurrency.ts +6 -0
  467. package/src/utils/currency-pair.ts +56 -4
  468. package/src/utils/datetime-format.ts +11 -0
  469. package/src/utils/decimal-comma.ts +9 -6
  470. package/src/utils/exchanges.ts +32 -0
  471. package/src/utils/fundamentals.ts +41 -0
  472. package/src/utils/main-thread-stall.ts +21 -5
  473. package/src/utils/markdown.ts +4 -2
  474. package/src/utils/pasted-lines.ts +14 -0
  475. package/src/utils/perf-marks.ts +88 -9
  476. package/src/utils/price-window.ts +2 -1
  477. package/src/utils/reported-money.ts +9 -2
  478. package/src/utils/sec-filings.ts +17 -0
  479. package/src/utils/sec.ts +37 -25
  480. package/src/utils/shortcut-labels.ts +6 -30
  481. package/src/plugins/seed-notice.ts +0 -20
@@ -0,0 +1,466 @@
1
+ import type { PaneFunctionCatalog } from "../../../../cli/pane-functions/catalog";
2
+ import { paneFunctionCode } from "../../../../cli/pane-functions/catalog";
3
+ import {
4
+ findCapabilityOption,
5
+ getHeadlessPaneDefinition,
6
+ getPaneFunctionCapability,
7
+ optionChoices,
8
+ optionFlag,
9
+ paneFunctionArgument,
10
+ takesNoArgument,
11
+ } from "../../../../cli/pane-functions/capabilities";
12
+ import type { PaneDef, PaneTemplateDef } from "../../../../types/plugin";
13
+ import { isSourceRef, type ASKGToolRow, type ASKGTurn } from "./model";
14
+ import type { JsonValue } from "./protocol";
15
+ import { resolveRemoteToolBinding } from "./manifest";
16
+
17
+ /**
18
+ * Where a figure in an answer came from, as the person can open it: the
19
+ * function, what it was run on and the options it was run with. Opening it is
20
+ * `fn` and `shot` with the same words, in a pane.
21
+ */
22
+ export interface ASKGSourceCommand {
23
+ /** The function's code as typed: `HP`. */
24
+ code: string;
25
+ /** Ticker, tickers (comma separated) or text, as the function takes it; empty for none. */
26
+ arg: string;
27
+ /** The function's own option keys and their values. */
28
+ options: Record<string, string>;
29
+ }
30
+
31
+ /** `HP NVDA --range 6M`: the words `gloom fn` takes for it. */
32
+ export function formatSourceCommand(command: ASKGSourceCommand): string {
33
+ const options = Object.entries(command.options).map(([key, value]) => (
34
+ `${optionFlag(key)} ${/\s/.test(value) ? JSON.stringify(value) : value}`
35
+ ));
36
+ return [command.code, command.arg, ...options].filter(Boolean).join(" ");
37
+ }
38
+
39
+ function text(value: JsonValue | undefined): string {
40
+ if (typeof value === "string") return value.trim();
41
+ if (typeof value === "number" || typeof value === "boolean") return String(value);
42
+ return "";
43
+ }
44
+
45
+ function symbols(value: JsonValue | undefined): string[] {
46
+ if (Array.isArray(value)) return value.map(text).filter(Boolean);
47
+ const one = text(value);
48
+ return one ? one.split(",").map((entry) => entry.trim()).filter(Boolean) : [];
49
+ }
50
+
51
+ /** A symbol on the venue the call named, as the app writes a listing: `SAN:EPA`. */
52
+ function listing(symbol: string, exchange: JsonValue | undefined): string {
53
+ const venue = text(exchange);
54
+ return venue && !symbol.includes(":") ? `${symbol}:${venue}` : symbol;
55
+ }
56
+
57
+ function command(code: string, arg = "", options: Record<string, string | undefined> = {}): ASKGSourceCommand {
58
+ const kept: Record<string, string> = {};
59
+ for (const [key, value] of Object.entries(options)) if (value) kept[key] = value;
60
+ return { code, arg, options: kept };
61
+ }
62
+
63
+ /** A function run on the call's one ticker; none when the call named no ticker. */
64
+ function onTicker(code: string, key = "symbol", options?: (args: Record<string, JsonValue>) => Record<string, string | undefined>) {
65
+ return (args: Record<string, JsonValue>): ASKGSourceCommand | null => {
66
+ const symbol = text(args[key]);
67
+ return symbol ? command(code, listing(symbol.toUpperCase(), args.exchange), options?.(args)) : null;
68
+ };
69
+ }
70
+
71
+ /**
72
+ * HP's window for a call that named no dates: the range whose bars are the
73
+ * call's (5-minute bars are a day, hourly ones a week) and that holds as many
74
+ * daily bars as it asked for.
75
+ */
76
+ function historyRange(interval: string, points: number): string {
77
+ if (/^\d+min$/.test(interval)) return "1D";
78
+ if (/^\d+h$/.test(interval)) return "1W";
79
+ if (interval === "1week") return "5Y";
80
+ if (interval === "1month") return "ALL";
81
+ if (points <= 23) return "1M";
82
+ if (points <= 66) return "3M";
83
+ if (points <= 130) return "6M";
84
+ return points <= 260 ? "1Y" : "5Y";
85
+ }
86
+
87
+ const SCREENER_LISTS: Record<string, string> = { gainers: "gainers", losers: "losers", "most-active": "actives" };
88
+ const NEWS_FEEDS: Record<string, string> = { latest: "N", top: "TOP", breaking: "FIRST" };
89
+
90
+ type ServerToolSource = (args: Record<string, JsonValue>) => ASKGSourceCommand | null;
91
+
92
+ /**
93
+ * The function that shows what each tool the platform runs reads. A tool
94
+ * missing here, or a call these cannot place (a free-text search), has no
95
+ * pane to open, and its source says so rather than pointing near it.
96
+ */
97
+ const SERVER_TOOL_SOURCES: Record<string, ServerToolSource> = {
98
+ "market.quotes": (args) => {
99
+ const listed = symbols(args.symbols).map((symbol) => listing(symbol.toUpperCase(), args.exchange));
100
+ return listed.length > 0 ? command("QQ", listed.join(",")) : null;
101
+ },
102
+ "market.history": (args) => {
103
+ const symbol = text(args.symbol);
104
+ if (!symbol) return null;
105
+ const from = text(args.startDate);
106
+ const to = text(args.endDate);
107
+ const points = typeof args.limit === "number" ? args.limit : 120;
108
+ return command("HP", listing(symbol.toUpperCase(), args.exchange), from
109
+ ? { from, to }
110
+ : { range: historyRange(text(args.interval) || "1day", points) });
111
+ },
112
+ "market.screener": (args) => {
113
+ const list = SCREENER_LISTS[text(args.category)];
114
+ return list ? command("MOST", "", { list }) : null;
115
+ },
116
+ "company.profile": onTicker("T"),
117
+ "company.statements": onTicker("FA", "symbol", (args) => ({ period: text(args.period) === "quarterly" ? "quarterly" : undefined })),
118
+ "company.financials": onTicker("FA"),
119
+ "company.holders": onTicker("HDS"),
120
+ "company.analyst_research": onTicker("ANR"),
121
+ "company.corporate_actions": onTicker("EVT"),
122
+ "market.options_chain": onTicker("OMON", "symbol", (args) => ({ expiration: text(args.expiration) || undefined })),
123
+ "sec.filings": onTicker("SEC", "ticker"),
124
+ "sec.insider_transactions": onTicker("INS", "ticker"),
125
+ "sec.thirteenf_holders": onTicker("HDS", "ticker"),
126
+ "macro.calendar": () => command("ECO"),
127
+ "macro.series": (args) => {
128
+ const series = text(args.seriesId).toUpperCase();
129
+ return series ? command("G", `FRED:${series}`) : null;
130
+ },
131
+ "macro.yield_curve": () => command("GC"),
132
+ "congress.house_trades": (args) => command("CG", text(args.ticker).toUpperCase(), { chamber: "house" }),
133
+ "congress.senate_trades": (args) => command("CG", text(args.ticker).toUpperCase(), { chamber: "senate" }),
134
+ "market.short_interest": onTicker("SI"),
135
+ "market.options_flow": onTicker("FLOW"),
136
+ "news.stories": (args) => {
137
+ // A search or a topic reads stories no feed pane lists as such.
138
+ if (text(args.query) || symbols(args.topics).length > 0) return null;
139
+ const tickers = symbols(args.tickers);
140
+ if (tickers.length === 1) return command("CN", tickers[0]!.toUpperCase());
141
+ if (tickers.length > 1) return null;
142
+ const feed = NEWS_FEEDS[text(args.feed) || "latest"];
143
+ return feed ? command(feed) : null;
144
+ },
145
+ "social.ticker_posts": onTicker("BUZZ", "ticker"),
146
+ "equity.diagnostic": onTicker("DIAG"),
147
+ "company.hiring": onTicker("JOBS", "ticker"),
148
+ "hiring.momentum": onTicker("HIRE"),
149
+ "apps.attention": onTicker("APPS"),
150
+ };
151
+
152
+ /**
153
+ * Server tools whose pane is the same whatever the call asked (each takes
154
+ * only a row limit), so a call stored without its arguments still opens it:
155
+ * a transcript from before the platform kept them, or a frame that left out
156
+ * arguments too large to send. Every other tool's arguments say what it read
157
+ * (a ticker, a search, a chamber), and without them it opens nothing rather
158
+ * than a pane near what it read, like a bare news feed for a search.
159
+ */
160
+ const SERVER_TOOLS_WITHOUT_ARGS: ReadonlySet<string> = new Set(["macro.calendar", "macro.yield_curve"]);
161
+
162
+ /** The tool names the table above places, for the test that holds each to a real function. */
163
+ export const MAPPED_SERVER_TOOLS: readonly string[] = Object.keys(SERVER_TOOL_SOURCES);
164
+
165
+ /** The function a tool the platform ran shows its data in, or null when none does. */
166
+ export function serverToolCommand(name: string, args: Record<string, JsonValue>): ASKGSourceCommand | null {
167
+ return SERVER_TOOL_SOURCES[name]?.(args) ?? null;
168
+ }
169
+
170
+ interface CatalogFunction {
171
+ template?: PaneTemplateDef;
172
+ pane: PaneDef;
173
+ }
174
+
175
+ /**
176
+ * Functions by the names this client advertises them under: a template's
177
+ * shortcut (or id) lowercased, else the pane's id (manifest.ts). Built once
178
+ * per catalog, since every source of every answer asks.
179
+ */
180
+ function functionsByToolName(catalog: PaneFunctionCatalog): Map<string, CatalogFunction> {
181
+ const byName = new Map<string, CatalogFunction>();
182
+ const templated = new Set<string>();
183
+ for (const template of catalog.paneTemplates.values()) {
184
+ const pane = catalog.panes.get(template.paneId);
185
+ if (!pane) continue;
186
+ templated.add(pane.id);
187
+ const name = (template.shortcut?.prefix ?? template.id).toLowerCase();
188
+ if (!byName.has(name)) byName.set(name, { template, pane });
189
+ }
190
+ for (const pane of catalog.panes.values()) {
191
+ if (!templated.has(pane.id) && !byName.has(pane.id)) byName.set(pane.id, { pane });
192
+ }
193
+ return byName;
194
+ }
195
+
196
+ /** Functions by every code the app opens them by, upper case. */
197
+ function functionsByCode(catalog: PaneFunctionCatalog): Map<string, CatalogFunction> {
198
+ const byCode = new Map<string, CatalogFunction>();
199
+ for (const template of catalog.paneTemplates.values()) {
200
+ const pane = catalog.panes.get(template.paneId);
201
+ if (!pane) continue;
202
+ for (const code of [template.shortcut?.prefix, ...template.shortcut?.aliases ?? []]) {
203
+ const key = code?.trim().toUpperCase();
204
+ if (key && !byCode.has(key)) byCode.set(key, { template, pane });
205
+ }
206
+ }
207
+ return byCode;
208
+ }
209
+
210
+ /** Arguments a client tool takes as its function's argument; every other one is an option. */
211
+ const ARGUMENT_KEYS = new Set(["symbol", "symbols", "text"]);
212
+
213
+ function clientToolCommand(found: CatalogFunction, args: Record<string, JsonValue>): ASKGSourceCommand | null {
214
+ const { template, pane } = found;
215
+ const headless = getHeadlessPaneDefinition(template, pane);
216
+ if (!headless) return null;
217
+ const arg = headless.argument.kind === "ticker"
218
+ ? text(args.symbol)
219
+ : headless.argument.kind === "tickers" || headless.argument.kind === "symbol-list"
220
+ ? symbols(args.symbols).join(",")
221
+ : headless.argument.kind === "free-text"
222
+ ? text(args.text)
223
+ : "";
224
+ const options: Record<string, string> = {};
225
+ for (const [key, value] of Object.entries(args)) {
226
+ if (ARGUMENT_KEYS.has(key)) continue;
227
+ const option = headless.options.find((entry) => entry.key === key);
228
+ // The app ran no call with an option its function lacks.
229
+ if (!option) return null;
230
+ // Only what the pane draws: `--limit` cuts the rows a report reads, not what the pane shows.
231
+ if (option.shot?.reportOnly) continue;
232
+ const typed = text(value);
233
+ if (typed) options[key] = typed;
234
+ }
235
+ return { code: paneFunctionCode(template, pane), arg, options };
236
+ }
237
+
238
+ /**
239
+ * Whether the app opens this command as written: a function it has, an
240
+ * argument it takes and only options it declares, with a value it lists. A
241
+ * command that fails here is never drawn as a link.
242
+ */
243
+ function checkCommand(found: CatalogFunction | undefined, source: ASKGSourceCommand): boolean {
244
+ if (!found) return false;
245
+ if (source.arg && takesNoArgument(paneFunctionArgument(found.template, found.pane))) return false;
246
+ const capability = getPaneFunctionCapability(found.template, found.pane);
247
+ return Object.entries(source.options).every(([key, value]) => {
248
+ const option = findCapabilityOption(capability, key);
249
+ if (!option) return false;
250
+ const choices = optionChoices(option);
251
+ if (option.type !== "enum" || choices.length === 0) return true;
252
+ const wanted = value.toLowerCase();
253
+ return choices.some((choice) => choice.toLowerCase() === wanted)
254
+ || (option.values ?? []).some((entry) => entry.aliases?.some((alias) => alias.toLowerCase() === wanted));
255
+ });
256
+ }
257
+
258
+ /** What a read opens, and what it is called, or why it opens nothing. */
259
+ export type ASKGSourceTarget =
260
+ | { kind: "pane"; command: ASKGSourceCommand; label: string; icon: string }
261
+ | { kind: "none" };
262
+
263
+ /** Named as a chip in chat names the pane a share of it holds, so the two read the same. */
264
+ function paneTarget(found: CatalogFunction, command: ASKGSourceCommand): ASKGSourceTarget {
265
+ return { kind: "pane", command, label: found.pane.name, icon: found.pane.icon ?? "" };
266
+ }
267
+
268
+ export interface ASKGSourceResolver {
269
+ target(row: ASKGToolRow): ASKGSourceTarget;
270
+ }
271
+
272
+ /**
273
+ * Turns the calls behind an answer into the commands that show their data.
274
+ * A call this client ran is its own function by name, with its argument and
275
+ * options; a call the platform ran goes through the table above. Either is
276
+ * checked against the functions this app has, so a link is only ever one the
277
+ * app opens.
278
+ */
279
+ export function createSourceResolver(catalog: PaneFunctionCatalog | null): ASKGSourceResolver {
280
+ const byToolName = catalog ? functionsByToolName(catalog) : new Map<string, CatalogFunction>();
281
+ const byCode = catalog ? functionsByCode(catalog) : new Map<string, CatalogFunction>();
282
+ const none: ASKGSourceTarget = { kind: "none" };
283
+ const cache = new WeakMap<ASKGToolRow, ASKGSourceTarget>();
284
+ const resolve = (row: ASKGToolRow): ASKGSourceTarget => {
285
+ if (!catalog || row.writeTier !== "read") return none;
286
+ // A call without its arguments cannot say what it read.
287
+ if (row.args === undefined && !(row.origin === "server" && SERVER_TOOLS_WITHOUT_ARGS.has(row.name))) return none;
288
+ const args = row.args ?? {};
289
+ if (row.origin === "server") {
290
+ const source = serverToolCommand(row.name, args);
291
+ const found = source ? byCode.get(source.code) : undefined;
292
+ if (!source || !found || !checkCommand(found, source)) return none;
293
+ return paneTarget(found, source);
294
+ }
295
+ // An app action or app state (`app.get_resource`) is no function.
296
+ if (resolveRemoteToolBinding(row.name)) return none;
297
+ const found = byToolName.get(row.name);
298
+ const source = found ? clientToolCommand(found, args) : null;
299
+ if (!found || !source || !checkCommand(found, source)) return none;
300
+ return paneTarget(found, source);
301
+ };
302
+ return {
303
+ target(row) {
304
+ const cached = cache.get(row);
305
+ if (cached) return cached;
306
+ const target = resolve(row);
307
+ cache.set(row, target);
308
+ return target;
309
+ },
310
+ };
311
+ }
312
+
313
+ // --- Citations --------------------------------------------------------------
314
+
315
+ /**
316
+ * `[3]`, `[3][5]` or `[3, 5]` after a figure, never a link's label (`[3](…)`)
317
+ * or a picture. Numbers past three digits are not sources.
318
+ */
319
+ const CITATION_RE = /(?<![!\\])\[(\d{1,3}(?:\s*,\s*\d{1,3})*)\](?!\()/g;
320
+
321
+ function citationRefs(group: string): number[] {
322
+ return group.split(",").map((entry) => Number(entry.trim())).filter(isSourceRef);
323
+ }
324
+
325
+ /** The source numbers an answer cites, in the order it first cites each. */
326
+ export function citedRefs(answer: string): number[] {
327
+ const refs: number[] = [];
328
+ for (const match of withoutCode(withoutWrittenSourceLinks(answer)).matchAll(CITATION_RE)) {
329
+ for (const ref of citationRefs(match[1]!)) if (!refs.includes(ref)) refs.push(ref);
330
+ }
331
+ return refs;
332
+ }
333
+
334
+ /** Code spans blanked to spaces of the same length, so a citation inside one is not read. */
335
+ function withoutCode(answer: string): string {
336
+ return answer.replace(/`[^`\n]*`/g, (span) => " ".repeat(span.length));
337
+ }
338
+
339
+ /** The href a citation link carries; MarkdownText hands it back on a click. */
340
+ export const SOURCE_LINK_SCHEME = "gloom-source:";
341
+
342
+ /** A source link in the answer's own text, `[ 9 ](gloom-source:2)`, outside code. */
343
+ const WRITTEN_SOURCE_LINK_RE = /(?<![!\\])\[((?:\\.|[^[\]\\])*)\]\(gloom-source:([^)\s]*)\)/g;
344
+
345
+ /**
346
+ * The answer with each source link it wrote itself turned back into the
347
+ * citation of the source it opens (`[ 9 ](gloom-source:2)` is `[2]`), or into
348
+ * its label when it opens none. Only `linkCitations` writes these links, from
349
+ * the citations, so what a square shows is always the source it opens.
350
+ */
351
+ function withoutWrittenSourceLinks(answer: string): string {
352
+ if (!answer.includes(SOURCE_LINK_SCHEME)) return answer;
353
+ let result = "";
354
+ let cursor = 0;
355
+ for (const match of withoutCode(answer).matchAll(WRITTEN_SOURCE_LINK_RE)) {
356
+ const index = match.index!;
357
+ const ref = Number(match[2]);
358
+ result += answer.slice(cursor, index);
359
+ result += isSourceRef(ref) ? `[${ref}]` : answer.slice(index + 1, index + 1 + match[1]!.length);
360
+ cursor = index + match[0].length;
361
+ }
362
+ return result + answer.slice(cursor);
363
+ }
364
+
365
+ export function sourceRefFromHref(href: string): number | null {
366
+ if (!href.startsWith(SOURCE_LINK_SCHEME)) return null;
367
+ const ref = Number(href.slice(SOURCE_LINK_SCHEME.length));
368
+ return isSourceRef(ref) ? ref : null;
369
+ }
370
+
371
+ /**
372
+ * The answer with each citation that opens a pane written as a link
373
+ * (`[ 3 ](gloom-source:3)`), which the pane draws as the square of the source
374
+ * chip it opens, as wide as the `[3]` it stands for. A citation of a source
375
+ * that opens nothing, or of no source at all, stays the text it was.
376
+ */
377
+ export function linkCitations(written: string, openable: ReadonlySet<number>): string {
378
+ const answer = withoutWrittenSourceLinks(written);
379
+ if (openable.size === 0) return answer;
380
+ const code = withoutCode(answer);
381
+ let result = "";
382
+ let cursor = 0;
383
+ for (const match of code.matchAll(CITATION_RE)) {
384
+ const refs = citationRefs(match[1]!);
385
+ if (refs.length === 0 || !refs.some((ref) => openable.has(ref))) continue;
386
+ const index = match.index!;
387
+ result += answer.slice(cursor, index);
388
+ result += refs.map((ref) => (
389
+ openable.has(ref) ? `[ ${ref} ](${SOURCE_LINK_SCHEME}${ref})` : `\\[${ref}\\]`
390
+ )).join("");
391
+ cursor = index + match[0].length;
392
+ }
393
+ return result + answer.slice(cursor);
394
+ }
395
+
396
+ /** One source under an answer: the number it is cited by, and what it opens. */
397
+ export interface ASKGAnswerSource {
398
+ /** The number the answer cites it by; null for a read an answer from an older server could not cite. */
399
+ ref: number | null;
400
+ /** The call that read it; null when the answer cites a number no call carries. */
401
+ row: ASKGToolRow | null;
402
+ target: ASKGSourceTarget;
403
+ }
404
+
405
+ /** A read that came back with data, worth listing when the answer cites none. */
406
+ function readSomething(row: ASKGToolRow): boolean {
407
+ return row.writeTier === "read" && (row.status === "ok" || row.status === "partial");
408
+ }
409
+
410
+ /**
411
+ * The sources an answer lists. A cited number is looked up among every call
412
+ * of the conversation up to this turn (numbers run on across it, so a
413
+ * follow-up can cite what an earlier turn read). An answer that cites nothing
414
+ * lists the reads its own turn made, so an answer from an older server, or
415
+ * one that forgot to cite, still opens what it read.
416
+ */
417
+ export function answerSources(
418
+ turns: readonly ASKGTurn[],
419
+ turnIndex: number,
420
+ resolver: ASKGSourceResolver,
421
+ ): ASKGAnswerSource[] {
422
+ const turn = turns[turnIndex];
423
+ if (!turn) return [];
424
+ const refs = citedRefs(turn.answer);
425
+ if (refs.length === 0) {
426
+ return turn.tools
427
+ .filter((row) => readSomething(row) && resolver.target(row).kind === "pane")
428
+ .map((row) => ({ ref: row.ref ?? null, row, target: resolver.target(row) }));
429
+ }
430
+ const byRef = new Map<number, ASKGToolRow>();
431
+ for (const earlier of turns.slice(0, turnIndex + 1)) {
432
+ for (const row of earlier.tools) if (row.ref !== undefined && !byRef.has(row.ref)) byRef.set(row.ref, row);
433
+ }
434
+ return refs.map((ref) => {
435
+ const row = byRef.get(ref) ?? null;
436
+ return { ref, row, target: row ? resolver.target(row) : { kind: "none" } };
437
+ });
438
+ }
439
+
440
+ /**
441
+ * True when an answer gives figures and its turn ran no call to take them
442
+ * from. Only said of a turn the server numbered the reads of: an older
443
+ * server's answer, or a stored one, may have read what it no longer shows,
444
+ * and a turn that ran an app action had a reason to answer without data.
445
+ */
446
+ export function answerReadNothing(turn: ASKGTurn): boolean {
447
+ return turn.numbered === true
448
+ && /\d/.test(turn.answer)
449
+ && citedRefs(turn.answer).length === 0
450
+ && !turn.tools.some((row) => row.status !== "denied" && row.status !== "cancelled");
451
+ }
452
+
453
+ /**
454
+ * An answer as it is shared: its text, then each source on a line of its own
455
+ * with the link that opens it for whoever reads it (`[2] HP NVDA --range 6M
456
+ * <link>`), or what it read when no pane shows it. Chat draws the links as
457
+ * the chips they open.
458
+ */
459
+ export function answerWithSourceLinks(
460
+ answer: string,
461
+ sources: ReadonlyArray<{ label: string; url: string | null }>,
462
+ ): string {
463
+ const text = withoutWrittenSourceLinks(answer).trim();
464
+ const lines = sources.map((source) => (source.url ? `${source.label} ${source.url}` : source.label));
465
+ return lines.length > 0 ? `${text}\n\n${lines.join("\n")}` : text;
466
+ }