gloomberb 0.20.11 → 0.20.12

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 (242) hide show
  1. package/package.json +2 -1
  2. package/src/api-client/awards.ts +16 -0
  3. package/src/api-client/central-bank-rates.ts +5 -0
  4. package/src/api-client/data.ts +55 -2
  5. package/src/api-client/index.ts +18 -1
  6. package/src/api-client/request.ts +86 -3
  7. package/src/api-client/socket-connection.ts +12 -1
  8. package/src/api-client/socket.ts +21 -3
  9. package/src/api-client/supply-chain-graph.ts +4 -2
  10. package/src/api-client/supply-chain.ts +8 -0
  11. package/src/api-client/types/econ.ts +10 -7
  12. package/src/api-client/types/filings-and-calls.ts +8 -0
  13. package/src/app/global-shortcuts.ts +2 -1
  14. package/src/app/keybindings/actions.ts +19 -0
  15. package/src/app/pane-runtime/index.tsx +18 -3
  16. package/src/app/pane-runtime/layout-placement.ts +63 -0
  17. package/src/app/pane-runtime/ticker-open-runtime.ts +10 -2
  18. package/src/capabilities/chart-series.ts +4 -1
  19. package/src/cli/board-coins.ts +10 -1
  20. package/src/cli/commands/crypto-hints.ts +3 -2
  21. package/src/cli/commands/fred-series.ts +0 -54
  22. package/src/cli/commands/market.ts +209 -31
  23. package/src/cli/commands/overview.ts +47 -14
  24. package/src/cli/commands/search.ts +37 -8
  25. package/src/cli/commands/ticker.ts +15 -4
  26. package/src/cli/desktop-pane-shot.ts +27 -2
  27. package/src/cli/fx-quote-rate.ts +1 -1
  28. package/src/cli/glossary.ts +14 -5
  29. package/src/cli/history-catalog-series.ts +85 -0
  30. package/src/cli/index.ts +1 -1
  31. package/src/cli/list-progress.ts +45 -0
  32. package/src/cli/listing-arg.ts +71 -7
  33. package/src/cli/name-entries.ts +8 -4
  34. package/src/cli/not-a-ticker.ts +2 -2
  35. package/src/cli/pane-functions/freshness.ts +50 -3
  36. package/src/cli/pane-functions/index.ts +7 -4
  37. package/src/cli/pane-functions/market-session.ts +66 -14
  38. package/src/cli/pane-functions/options.ts +5 -0
  39. package/src/cli/pane-functions/resolver.ts +9 -2
  40. package/src/cli/pane-functions/screenshot-assessment.ts +28 -3
  41. package/src/cli/pane-functions/screenshot-types.ts +6 -0
  42. package/src/cli/quote-answer.ts +49 -10
  43. package/src/cli/quote-list-reads.ts +87 -0
  44. package/src/cli/report-tables.ts +70 -13
  45. package/src/cli/result.ts +24 -2
  46. package/src/cli/symbol-list.ts +31 -4
  47. package/src/cli/terminal-code-hints.ts +83 -0
  48. package/src/cli/ticker-resolution.ts +2 -1
  49. package/src/cli/treasury-yields.ts +5 -0
  50. package/src/components/command-bar/action-runtime.ts +2 -0
  51. package/src/components/command-bar/routing/launch-request.ts +2 -1
  52. package/src/components/command-bar/routing/navigation-state.ts +4 -2
  53. package/src/components/command-bar/workflow/types.ts +6 -0
  54. package/src/components/layout/detached-pane-shell.tsx +3 -0
  55. package/src/components/layout/double-escape-close.ts +34 -3
  56. package/src/components/layout/floating-pane.tsx +10 -4
  57. package/src/components/layout/pane/cycle-order.ts +66 -2
  58. package/src/components/layout/pane/header.tsx +140 -31
  59. package/src/components/layout/pane/sidebar.tsx +13 -5
  60. package/src/components/layout/pane/status-footer.ts +3 -1
  61. package/src/components/layout/shell/drag/runtime.ts +5 -0
  62. package/src/components/layout/shell/index.tsx +25 -0
  63. package/src/components/layout/shell/menu.ts +9 -0
  64. package/src/components/layout/shell/pane/actions.ts +36 -0
  65. package/src/components/layout/shell/pane/management-shortcuts.ts +27 -3
  66. package/src/components/layout/shell/pane-occlusion.ts +40 -0
  67. package/src/components/layout/shell/shortcuts.ts +17 -1
  68. package/src/components/layout/shell/terminal-pointer-runtime.ts +39 -6
  69. package/src/components/layout/shell/window-mode/index.ts +5 -16
  70. package/src/components/layout/shell/window-mode/overlays.tsx +3 -1
  71. package/src/components/market-board/index.tsx +14 -5
  72. package/src/components/metric-treemap/index.tsx +3 -1
  73. package/src/components/ui/button.tsx +48 -4
  74. package/src/components/ui/data-table/opentui/index.tsx +24 -9
  75. package/src/components/ui/data-table/types.ts +7 -0
  76. package/src/components/ui/inline-quick-add.tsx +19 -3
  77. package/src/components/ui/list-view.tsx +11 -5
  78. package/src/components/ui/query-bar.tsx +16 -1
  79. package/src/components/ui/selection-fill.ts +39 -0
  80. package/src/core/state/app/layout-reducer.ts +2 -1
  81. package/src/core/state/app/pane-choices.ts +68 -0
  82. package/src/core/state/app/state.ts +14 -6
  83. package/src/core/state/app/types.ts +8 -0
  84. package/src/layout/pane-manager/dock-tree.ts +19 -0
  85. package/src/layout/pane-manager/index.ts +3 -0
  86. package/src/market-data/market/freshness.ts +33 -0
  87. package/src/market-data/market/status.ts +5 -1
  88. package/src/market-data/quotes/contributions.ts +10 -0
  89. package/src/market-data/quotes/freshness.ts +19 -0
  90. package/src/market-data/quotes/live-valuation.ts +31 -4
  91. package/src/market-data/quotes/resolution.ts +4 -0
  92. package/src/market-data/quotes/time.ts +0 -14
  93. package/src/plugins/builtin/account-management/index.tsx +1 -0
  94. package/src/plugins/builtin/awards/detail.tsx +12 -4
  95. package/src/plugins/builtin/awards/headless.ts +29 -8
  96. package/src/plugins/builtin/awards/model.ts +36 -2
  97. package/src/plugins/builtin/awards/pane.tsx +7 -4
  98. package/src/plugins/builtin/broker-manager/index.tsx +1 -0
  99. package/src/plugins/builtin/broker-trading/index.tsx +1 -1
  100. package/src/plugins/builtin/central-bank-rates/headless.ts +6 -6
  101. package/src/plugins/builtin/central-bank-rates/index.tsx +1 -1
  102. package/src/plugins/builtin/central-bank-rates/model.ts +21 -3
  103. package/src/plugins/builtin/central-bank-rates/pane.tsx +15 -5
  104. package/src/plugins/builtin/chart-composer/headless.ts +5 -1
  105. package/src/plugins/builtin/chart-composer/pane.tsx +1 -0
  106. package/src/plugins/builtin/chat/content/handle-prompt.tsx +4 -0
  107. package/src/plugins/builtin/chat/controller/realtime.ts +17 -1
  108. package/src/plugins/builtin/chat/message/terminal.tsx +4 -1
  109. package/src/plugins/builtin/chat/sidebar.tsx +3 -4
  110. package/src/plugins/builtin/cloud/askg/pane.tsx +4 -0
  111. package/src/plugins/builtin/cloud/plugin.tsx +1 -0
  112. package/src/plugins/builtin/cloud/team/module.tsx +1 -0
  113. package/src/plugins/builtin/cloud/thesis/detail.tsx +9 -4
  114. package/src/plugins/builtin/commodity-balances/pane.tsx +13 -5
  115. package/src/plugins/builtin/company-kpis/model.ts +3 -3
  116. package/src/plugins/builtin/connections/index.ts +1 -0
  117. package/src/plugins/builtin/credit-boards/cdx-pane.tsx +9 -5
  118. package/src/plugins/builtin/credit-boards/client.ts +5 -0
  119. package/src/plugins/builtin/credit-boards/headless.ts +1 -6
  120. package/src/plugins/builtin/credit-boards/model.ts +0 -6
  121. package/src/plugins/builtin/credit-boards/series.ts +19 -8
  122. package/src/plugins/builtin/credit-boards/sovr-pane.tsx +9 -5
  123. package/src/plugins/builtin/crypto-etf-flows/headless.ts +23 -13
  124. package/src/plugins/builtin/crypto-etf-flows/pane.tsx +8 -3
  125. package/src/plugins/builtin/debt-maturities/headless.ts +16 -7
  126. package/src/plugins/builtin/debt-maturities/model.ts +9 -15
  127. package/src/plugins/builtin/debt-maturities/pane.tsx +9 -10
  128. package/src/plugins/builtin/earnings/board-model.ts +33 -4
  129. package/src/plugins/builtin/earnings/board.tsx +15 -3
  130. package/src/plugins/builtin/earnings/calendar.tsx +10 -6
  131. package/src/plugins/builtin/earnings/client.ts +0 -9
  132. package/src/plugins/builtin/earnings/headless.ts +10 -7
  133. package/src/plugins/builtin/earnings/history.tsx +21 -14
  134. package/src/plugins/builtin/earnings-calls/data.ts +24 -4
  135. package/src/plugins/builtin/earnings-calls/format.ts +23 -5
  136. package/src/plugins/builtin/earnings-calls/headless.ts +23 -3
  137. package/src/plugins/builtin/earnings-calls/index.tsx +1 -0
  138. package/src/plugins/builtin/earnings-calls/model.ts +11 -1
  139. package/src/plugins/builtin/earnings-calls/pane.tsx +2 -5
  140. package/src/plugins/builtin/econ/calendar-model.ts +27 -0
  141. package/src/plugins/builtin/econ/fred-catalog.ts +3 -0
  142. package/src/plugins/builtin/econ/index.tsx +9 -2
  143. package/src/plugins/builtin/econ-statistics/headless.ts +3 -1
  144. package/src/plugins/builtin/econ-statistics/index.tsx +1 -1
  145. package/src/plugins/builtin/fear-greed/headless.ts +16 -13
  146. package/src/plugins/builtin/fear-greed/pane.tsx +12 -4
  147. package/src/plugins/builtin/filing-events/index.tsx +1 -0
  148. package/src/plugins/builtin/fx-matrix/index.tsx +30 -19
  149. package/src/plugins/builtin/insider/table.tsx +10 -7
  150. package/src/plugins/builtin/insider/tickers.tsx +1 -1
  151. package/src/plugins/builtin/iv-history/headless.ts +9 -8
  152. package/src/plugins/builtin/jobs/index.tsx +1 -0
  153. package/src/plugins/builtin/macro-day/headless.ts +3 -3
  154. package/src/plugins/builtin/macro-day/model.ts +1 -1
  155. package/src/plugins/builtin/macro-day/releases.ts +25 -16
  156. package/src/plugins/builtin/market-movers/index.tsx +20 -8
  157. package/src/plugins/builtin/market-movers/model.ts +5 -0
  158. package/src/plugins/builtin/market-movers/session-body.tsx +2 -1
  159. package/src/plugins/builtin/money-markets/headless.ts +12 -2
  160. package/src/plugins/builtin/money-markets/pane.tsx +10 -1
  161. package/src/plugins/builtin/options/view.tsx +1 -0
  162. package/src/plugins/builtin/options-positioning/pane.tsx +1 -1
  163. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +4 -31
  164. package/src/plugins/builtin/portfolio-list/pane/index.tsx +6 -1
  165. package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +22 -8
  166. package/src/plugins/builtin/portfolio-list/summary/index.tsx +6 -8
  167. package/src/plugins/builtin/portfolio-list/table.tsx +10 -1
  168. package/src/plugins/builtin/realized-vol/headless.ts +28 -2
  169. package/src/plugins/builtin/risk-factors/index.tsx +1 -0
  170. package/src/plugins/builtin/shared/source-footer.ts +70 -0
  171. package/src/plugins/builtin/short-interest/publications-pane.tsx +5 -1
  172. package/src/plugins/builtin/short-volume/pane.tsx +5 -1
  173. package/src/plugins/builtin/social-mentions/outliers.tsx +10 -1
  174. package/src/plugins/builtin/social-mentions/pane.tsx +7 -0
  175. package/src/plugins/builtin/supply-chain/client.ts +3 -1
  176. package/src/plugins/builtin/supply-chain/flow.tsx +25 -8
  177. package/src/plugins/builtin/supply-chain/graph-client.ts +1 -1
  178. package/src/plugins/builtin/supply-chain/graph-evidence.ts +1 -1
  179. package/src/plugins/builtin/supply-chain/graph-model.ts +12 -1
  180. package/src/plugins/builtin/supply-chain/graph-pane.tsx +9 -8
  181. package/src/plugins/builtin/supply-chain/graph.tsx +12 -6
  182. package/src/plugins/builtin/supply-chain/headless.ts +13 -7
  183. package/src/plugins/builtin/supply-chain/model.ts +68 -11
  184. package/src/plugins/builtin/supply-chain/pane.tsx +9 -6
  185. package/src/plugins/builtin/supply-chain/row-evidence.tsx +5 -5
  186. package/src/plugins/builtin/ticker-detail/overview/components.tsx +14 -1
  187. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +2 -0
  188. package/src/plugins/builtin/ticker-detail/pane.tsx +48 -24
  189. package/src/plugins/builtin/ticker-detail/quote-footer.ts +5 -0
  190. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +6 -3
  191. package/src/plugins/builtin/treasury-auctions/after.ts +50 -23
  192. package/src/plugins/builtin/treasury-auctions/cache.ts +23 -5
  193. package/src/plugins/builtin/treasury-auctions/headless.ts +226 -37
  194. package/src/plugins/builtin/treasury-auctions/hk-headless.ts +11 -5
  195. package/src/plugins/builtin/treasury-auctions/hk-view.tsx +27 -25
  196. package/src/plugins/builtin/treasury-auctions/hk.ts +60 -8
  197. package/src/plugins/builtin/treasury-auctions/index.tsx +3 -0
  198. package/src/plugins/builtin/treasury-auctions/keys.ts +27 -0
  199. package/src/plugins/builtin/treasury-auctions/like.ts +137 -0
  200. package/src/plugins/builtin/treasury-auctions/model.ts +100 -22
  201. package/src/plugins/builtin/treasury-auctions/pane.tsx +39 -11
  202. package/src/plugins/builtin/vol-surface/heat-grid.tsx +4 -2
  203. package/src/plugins/builtin/vol-surface/pane.tsx +5 -2
  204. package/src/plugins/runtime/index.tsx +1 -0
  205. package/src/plugins/runtime/state.ts +20 -0
  206. package/src/portfolio/column-values.ts +8 -2
  207. package/src/public/__snapshots__/public-api.test.ts.snap +5 -0
  208. package/src/public/react.ts +7 -0
  209. package/src/react/auto-refresh.ts +29 -0
  210. package/src/renderers/browser/deeplink-bridge.ts +24 -3
  211. package/src/renderers/dom/desktop/query-bar.tsx +229 -60
  212. package/src/renderers/dom/host/overflow-fade-px.ts +2 -0
  213. package/src/renderers/dom/host/overflow-fade.ts +1 -2
  214. package/src/renderers/dom/styles.css +25 -5
  215. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +2 -1
  216. package/src/series/types.ts +2 -0
  217. package/src/sources/gloomberb-cloud/fred-attribution.ts +86 -0
  218. package/src/sources/gloomberb-cloud/index.ts +25 -1
  219. package/src/sources/gloomberb-cloud/normalizers.ts +22 -3
  220. package/src/sources/provider-errors.ts +64 -1
  221. package/src/sources/provider-router/batches.ts +19 -0
  222. package/src/sources/provider-router/index.ts +7 -1
  223. package/src/state/app/context/index.tsx +24 -1
  224. package/src/state/pane-unsent-work.ts +47 -0
  225. package/src/test-support/shell-pane-keys.tsx +5 -0
  226. package/src/test-support/telemetry-guard.ts +83 -0
  227. package/src/test-support/test-env.ts +12 -0
  228. package/src/theme/colors.ts +17 -1
  229. package/src/theme/ui-tokens.ts +50 -1
  230. package/src/tickers/listing-venues.ts +11 -1
  231. package/src/tickers/search/japanese-names.json +1 -0
  232. package/src/tickers/search/japanese-names.ts +152 -0
  233. package/src/tickers/terminal-codes.ts +55 -6
  234. package/src/time-series/base-series.ts +3 -0
  235. package/src/types/data-provider.ts +6 -0
  236. package/src/types/financials.ts +11 -0
  237. package/src/types/plugin-contributions.ts +7 -0
  238. package/src/types/plugin-panes.ts +7 -0
  239. package/src/ui/host.tsx +6 -0
  240. package/src/utils/double-escape-close.ts +42 -0
  241. package/src/utils/fx-status.ts +30 -7
  242. package/src/utils/network-failure.ts +23 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "gloomberb",
3
- "version": "0.20.11",
3
+ "version": "0.20.12",
4
4
  "packageManager": "bun@1.3.14",
5
5
  "description": "Market research and portfolio tracker for the terminal",
6
6
  "module": "src/public/index.ts",
@@ -67,6 +67,7 @@
67
67
  "desktop:sync": "electrobun sync && bun run scripts/patch-electrobun-devkit.ts",
68
68
  "docs:snapshot": "bun run scripts/update-docs-snapshot.ts",
69
69
  "listings:snapshot": "bun run scripts/update-major-listings.ts",
70
+ "japanese-names:snapshot": "bun run scripts/update-japanese-names.ts",
70
71
  "plugins:manifest": "bun run scripts/generate-plugin-manifest.ts",
71
72
  "plugins:manifest:check": "bun run scripts/generate-plugin-manifest.ts --check",
72
73
  "plugins:registry:check": "bun run scripts/check-registry-plugins.ts",
@@ -40,6 +40,12 @@ export interface AwardInput {
40
40
  ceilingAmount?: string | null
41
41
  /** Face value for awards; action amount for modification records. */
42
42
  awardAmount?: string | null
43
+ /**
44
+ * Why the source's printed amount is served as none: GeBIZ's "under
45
+ * S$6,000" or "printed alike for 4 suppliers of the tender". Absent when
46
+ * none was printed, and from an older server.
47
+ */
48
+ amountWithheld?: string | null
43
49
  recipient: AwardRecipient
44
50
  agency: { id?: string | null; name: string; parentName?: string | null }
45
51
  parentAwardId?: string | null
@@ -156,6 +162,12 @@ interface AwardSourceState {
156
162
  * dated by the server's last read; absent for a source that asks for none.
157
163
  */
158
164
  attribution?: string
165
+ /**
166
+ * How to read the source's amounts, where it stores some as none: GeBIZ
167
+ * withholds an amount under S$6,000 or one that several suppliers of a
168
+ * tender print alike. Absent for a source whose missing amount is unreported.
169
+ */
170
+ amountNotice?: string
159
171
  }
160
172
  interface AwardCoverage {
161
173
  source: string
@@ -217,4 +229,8 @@ export interface AwardDetailPayload {
217
229
  edges: AwardEdge[]
218
230
  access: "full" | "preview"
219
231
  locked: boolean
232
+ /** The row's source's licence statement, as the board's source states carry it; absent from an older server. */
233
+ attribution?: string
234
+ /** How to read the row's source's amounts (AwardSourceState.amountNotice). */
235
+ amountNotice?: string
220
236
  }
@@ -46,6 +46,11 @@ export interface CentralBankRow {
46
46
  nextMeetingStatus?: "scheduled" | "not-published" | "not-verified" | "no-policy-rate"
47
47
  /** The BIS series definition and breaks, also in `notes`: history a citation of the latest rate leaves out. */
48
48
  seriesNotes?: string[]
49
+ /**
50
+ * Whose published rates the board computed the move in basis points and the percentile from, where the bank's terms
51
+ * ask that a derived figure say so: "CBE's published rates". Absent elsewhere and from older servers.
52
+ */
53
+ computedFrom?: string
49
54
  }
50
55
 
51
56
  export interface CentralBankRatesPayload {
@@ -212,6 +212,19 @@ function batchAnswers<K extends string, T>(response: CloudMarketResponse<CloudBa
212
212
  /** How long a listing read waits before asking again after the service said its source failed. */
213
213
  const LISTING_RETRY_DELAY_MS = 400;
214
214
 
215
+ /**
216
+ * How long the service's answer that it has no quote for a listing stands.
217
+ * Resolving the symbol, quoting it and checking whether it stopped trading
218
+ * each ask about a symbol nothing lists: one answer serves them all, so an
219
+ * unknown symbol fails at once instead of after each asks the service again.
220
+ */
221
+ const QUOTE_NOT_FOUND_MS = 60_000;
222
+ /** The most quote paths remembered as not found: a list of mistyped symbols must not grow the memory without end. */
223
+ const QUOTE_NOT_FOUND_ENTRIES = 256;
224
+
225
+ const isNotFound = (answer: { status?: string; reasonCode?: string } | null | undefined) =>
226
+ answer?.status === "empty" && answer.reasonCode === "NOT_FOUND";
227
+
215
228
  /**
216
229
  * Whether a failed listing read is asked again: the service answered that its
217
230
  * own source failed (`retryable_error`, or the catch-all `fatal_error`, with no
@@ -281,6 +294,26 @@ export class CloudDataApi {
281
294
  */
282
295
  private readonly histories = this.historyCoalescer(false);
283
296
 
297
+ /** Each quote path the service said it has no quote for, and when (`QUOTE_NOT_FOUND_MS`), oldest first, at most QUOTE_NOT_FOUND_ENTRIES. */
298
+ private readonly quotesNotFound = new Map<string, number>();
299
+
300
+ private rememberQuoteNotFound(path: string): void {
301
+ this.quotesNotFound.delete(path);
302
+ this.quotesNotFound.set(path, Date.now());
303
+ for (const oldest of this.quotesNotFound.keys()) {
304
+ if (this.quotesNotFound.size <= QUOTE_NOT_FOUND_ENTRIES) break;
305
+ this.quotesNotFound.delete(oldest);
306
+ }
307
+ }
308
+
309
+ private quoteNotFound(path: string): CloudMarketResponse<CloudQuotePayload> | null {
310
+ const said = this.quotesNotFound.get(path);
311
+ if (said == null) return null;
312
+ if (Date.now() - said < QUOTE_NOT_FOUND_MS) return { status: "empty", reasonCode: "NOT_FOUND", data: null };
313
+ this.quotesNotFound.delete(path);
314
+ return null;
315
+ }
316
+
284
317
  /**
285
318
  * The same over one window of dates (a portfolio's holdings over the risk
286
319
  * model's months or the stress episodes' years). A service from before
@@ -572,7 +605,12 @@ export class CloudDataApi {
572
605
  symbol: string,
573
606
  exchange?: string,
574
607
  ): Promise<CloudMarketResponse<CloudQuotePayload>> {
575
- return this.readListing(() => this.requestMarketSymbol("/market/quote", symbol, exchange));
608
+ const path = cloudMarketSymbolPath("/market/quote", symbol, exchange);
609
+ const known = this.quoteNotFound(path);
610
+ if (known) return known;
611
+ const answer = await this.readListing(() => this.request<CloudMarketResponse<CloudQuotePayload>>(path));
612
+ if (isNotFound(answer)) this.rememberQuoteNotFound(path);
613
+ return answer;
576
614
  }
577
615
 
578
616
  async getCloudQuotesBatch(
@@ -580,7 +618,22 @@ export class CloudDataApi {
580
618
  mode: "cache-first" | "refresh" = "cache-first",
581
619
  options: { signal?: AbortSignal } = {},
582
620
  ): Promise<CloudMarketResponse<CloudMarketBatchPayload<CloudQuotePayload>>> {
583
- return this.readListing(() => this.postMarketBatch("/market/quotes/batch", targets, mode, options.signal), options.signal);
621
+ const answer = await this.readListing(() => this.postMarketBatch<CloudQuotePayload>("/market/quotes/batch", targets, mode, options.signal), options.signal);
622
+ this.rememberBatchNotFound(targets, answer);
623
+ return answer;
624
+ }
625
+
626
+ /**
627
+ * A batch's "not found" for a listing is the quote route's too: the router asks each listing a batch missed once
628
+ * more alone, and that read is answered from the batch instead of a second round trip to say the same.
629
+ */
630
+ private rememberBatchNotFound(targets: CloudMarketBatchTarget[], answer: CloudMarketResponse<CloudMarketBatchPayload<CloudQuotePayload>>): void {
631
+ const items = answer.data?.items;
632
+ for (const item of Array.isArray(items) ? items : []) {
633
+ if (!isNotFound(item)) continue;
634
+ const asked = targets.find((target) => target.symbol === item.symbol && (target.exchange ?? "") === (item.exchange ?? ""));
635
+ if (asked) this.rememberQuoteNotFound(cloudMarketSymbolPath("/market/quote", asked.symbol, asked.exchange));
636
+ }
584
637
  }
585
638
 
586
639
  async getCloudWorldVenues(): Promise<
@@ -91,6 +91,17 @@ function capAssistArgOptions(command: AssistCommandDescriptor): AssistCommandDes
91
91
  return { ...command, arg: fits ? { ...arg, options: capped } : arg };
92
92
  }
93
93
 
94
+ /** Whether a socket's account fields differ from the user held now; a field it leaves out changes nothing. */
95
+ function changesUser(current: AuthUser, update: Partial<AuthUser>): boolean {
96
+ const held = current as unknown as Record<string, unknown>;
97
+ return Object.entries(update).some(([key, value]) => {
98
+ const before = held[key];
99
+ if (Object.is(before, value)) return false;
100
+ if (!before || !value || typeof before !== "object" || typeof value !== "object") return true;
101
+ return JSON.stringify(before) !== JSON.stringify(value);
102
+ });
103
+ }
104
+
94
105
  interface PendingSessionRequest {
95
106
  promise: Promise<AuthUser | null>;
96
107
  consumers: Array<() => boolean>;
@@ -142,7 +153,13 @@ class GloomApiClient {
142
153
  this.emitCurrentUserChange();
143
154
  }
144
155
  },
145
- updateCurrentUserFromSocket: (user) => {
156
+ updateCurrentUserFromSocket: (user, { resync }) => {
157
+ // Every connection's hello repeats the account. A reconnect that changes
158
+ // nothing must not tell every listener the user changed: each would load
159
+ // its data again (teams, theses, sync), and after a server restart every
160
+ // client reconnects at once. After a long silence they do load again, for
161
+ // what changed while nothing arrived.
162
+ if (!this.currentUser || (!resync && !changesUser(this.currentUser, user))) return;
146
163
  this.updateCurrentUser((currentUser) => ({
147
164
  ...currentUser,
148
165
  ...user,
@@ -16,7 +16,7 @@ import {
16
16
  type ConnectionHealthRegistry,
17
17
  } from "../core/connection-health";
18
18
  import { SESSION_COOKIE_NAMES } from "./session-cookie";
19
- import { asDataServiceFailure, DataServiceUnreachableError } from "../utils/network-failure";
19
+ import { asDataServiceFailure, DataServiceUnreachableError, isDroppedConnection } from "../utils/network-failure";
20
20
 
21
21
  /** The public Gloom Cloud API, which the web app's same-origin `/api` path forwards to. */
22
22
  export const DEFAULT_API_URL = "https://api.gloom.sh";
@@ -71,6 +71,43 @@ const RESEARCH_MARKET_PATHS = new Set([
71
71
  "/market/heatmap", "/market/earnings-calendar", "/market/search/batch",
72
72
  ]);
73
73
 
74
+ /**
75
+ * A read cut off by a server restart is sent once more after a pause in this
76
+ * range (`sendAgainIfCutOff`): the next connection reaches a server that
77
+ * answers. Spread so the requests a restart dropped together are not all sent
78
+ * again in the same instant.
79
+ */
80
+ const DROPPED_RETRY_MIN_MS = 100;
81
+ const DROPPED_RETRY_SPREAD_MS = 400;
82
+
83
+ /**
84
+ * Whether asking twice is harmless: a GET or HEAD, or a POST under the market
85
+ * paths, which are batch reads. Writes are never sent twice: the first may
86
+ * have reached the server before its connection dropped.
87
+ */
88
+ function isRepeatableRead(method: string, path: string): boolean {
89
+ return method === "GET" || method === "HEAD" || (method === "POST" && path.startsWith("/market/"));
90
+ }
91
+
92
+ /** Waits `ms`, or rejects with the signal's reason once it aborts. */
93
+ function pause(ms: number, signal: AbortSignal | null | undefined): Promise<void> {
94
+ return new Promise((resolve, reject) => {
95
+ if (signal?.aborted) {
96
+ reject(signal.reason);
97
+ return;
98
+ }
99
+ const onAbort = () => {
100
+ clearTimeout(timer);
101
+ reject(signal?.reason);
102
+ };
103
+ const timer = setTimeout(() => {
104
+ signal?.removeEventListener("abort", onAbort);
105
+ resolve();
106
+ }, ms);
107
+ signal?.addEventListener("abort", onAbort, { once: true });
108
+ });
109
+ }
110
+
74
111
  /** When a request gives up: without any answer from the service, and in all. */
75
112
  interface RequestDeadline {
76
113
  answerMs: number;
@@ -288,6 +325,45 @@ function throwIfRequestAborted(signal: AbortSignal | null | undefined): void {
288
325
  );
289
326
  }
290
327
 
328
+ /**
329
+ * Whether an answer says the server that took the request is going away: the
330
+ * proxy in front could not get an answer from it (a 502 that is not the
331
+ * API's own JSON), or the server refused new work while it stops (503 with a
332
+ * Retry-After of at most a second). The API's other 502s and 503s say what an
333
+ * upstream or the service does not have, and stand.
334
+ */
335
+ function isRestartAnswer(response: CloudApiResponse): boolean {
336
+ if (response.status === 502) return !(response.headers.get("Content-Type") ?? "").includes("json");
337
+ if (response.status !== 503) return false;
338
+ const retryAfter = response.headers.get("Retry-After");
339
+ return retryAfter != null && retryAfter.trim() !== "" && Number(retryAfter) <= 1;
340
+ }
341
+
342
+ /**
343
+ * Sends a read, and once more after a short pause when its connection
344
+ * dropped before the answer began (`isDroppedConnection`), or the answer
345
+ * says its server is going away (`isRestartAnswer`). Only once: a second
346
+ * failure is the service's state, and is reported as before.
347
+ */
348
+ async function sendAgainIfCutOff(
349
+ sendOnce: () => Promise<CloudApiResponse>,
350
+ signal: AbortSignal | null | undefined,
351
+ ): Promise<CloudApiResponse> {
352
+ let first: CloudApiResponse;
353
+ try {
354
+ first = await sendOnce();
355
+ } catch (error) {
356
+ if (signal?.aborted || !isDroppedConnection(error)) throw error;
357
+ await pause(DROPPED_RETRY_MIN_MS + Math.random() * DROPPED_RETRY_SPREAD_MS, signal);
358
+ return sendOnce();
359
+ }
360
+ if (!isRestartAnswer(first)) return first;
361
+ // Read and drop the replaced answer's body, so its connection is released.
362
+ first.text().catch(() => { /* Intentional ignore: this answer is replaced by the next. */ });
363
+ await pause(DROPPED_RETRY_MIN_MS + Math.random() * DROPPED_RETRY_SPREAD_MS, signal);
364
+ return sendOnce();
365
+ }
366
+
291
367
  export class CloudApiRequestTransport {
292
368
  private sessionToken: string | null = null;
293
369
  private sessionCookieName: SessionCookieName | null = null;
@@ -774,13 +850,20 @@ export class CloudApiRequestTransport {
774
850
 
775
851
  const operation = `${options?.method ?? "GET"} ${path.split("?")[0]}`;
776
852
  const url = `${this.baseUrl}${path}`;
853
+ const repeatable = !send && isRepeatableRead(method, path);
777
854
  const read = async (signal: AbortSignal | null | undefined): Promise<CloudApiAnswer> => {
778
- const response = await this.reachService(() => (send ?? this.fetchTransport ?? cloudApiFetchTransport)(url, {
855
+ const sendOnce = () => (send ?? this.fetchTransport ?? cloudApiFetchTransport)(url, {
779
856
  ...options,
780
857
  headers,
781
858
  credentials: "include",
782
859
  signal,
783
- }), signal, isBackgroundRequest(path));
860
+ });
861
+ // Inside the reach check: a read that gets through on its second try was answered, not an outage.
862
+ const response = await this.reachService(
863
+ () => (repeatable ? sendAgainIfCutOff(sendOnce, signal) : sendOnce()),
864
+ signal,
865
+ isBackgroundRequest(path),
866
+ );
784
867
  throwIfRequestAborted(signal);
785
868
  const text = response.text();
786
869
  text.catch(() => { /* Intentional ignore: every caller awaits this body after reading the headers. */ });
@@ -26,6 +26,17 @@ const SOCKET_SILENCE_CHECK_MS = 2_500;
26
26
  /** The first reconnect waits about this long; each failure doubles it, up to RECONNECT_MAX_DELAY_MS. */
27
27
  const RECONNECT_FIRST_DELAY_MS = 1000;
28
28
  const RECONNECT_MAX_DELAY_MS = 10_000;
29
+ /**
30
+ * Each reconnect waits its delay times a random factor in this range: the
31
+ * first one 0.25 to 2.25 s. A server restart or a proxy reload drops every
32
+ * client in the same second; spread over two seconds, their reconnects do
33
+ * not arrive as one burst. The first one still lands inside the quote
34
+ * stream's grace (QUOTE_STREAM_DOWN_GRACE_MS), so nothing reads as stale.
35
+ */
36
+ const RECONNECT_JITTER_MIN = 0.25;
37
+ const RECONNECT_JITTER_SPAN = 2;
38
+ /** The longest the first reconnect after a drop waits. */
39
+ export const SOCKET_FIRST_RECONNECT_MAX_MS = RECONNECT_FIRST_DELAY_MS * (RECONNECT_JITTER_MIN + RECONNECT_JITTER_SPAN);
29
40
  /** Outgoing frames worth a debug log line: the subscription changes. */
30
41
  const LOGGED_FRAME_TYPES = new Set<unknown>([
31
42
  "market.subscribe",
@@ -265,7 +276,7 @@ export class SocketConnection {
265
276
  if (this.reconnectTimer || !this.owner.wanted()) return;
266
277
  // Jittered so clients dropped together by a server restart do not all
267
278
  // come back in the same instant.
268
- const delay = Math.round(this.reconnectDelayMs * (0.5 + Math.random()));
279
+ const delay = Math.round(this.reconnectDelayMs * (RECONNECT_JITTER_MIN + RECONNECT_JITTER_SPAN * Math.random()));
269
280
  this.reconnectTimer = setTimeout(() => {
270
281
  this.reconnectTimer = null;
271
282
  this.reconnectDelayMs = Math.min(this.reconnectDelayMs * 2, RECONNECT_MAX_DELAY_MS);
@@ -21,10 +21,18 @@ import { SocketListeners } from "./socket-listeners";
21
21
  import { QuoteStreamSubscriptions } from "./socket-quotes";
22
22
 
23
23
  export { CHAT_ATTACHMENTS_FEATURE, TERMINAL_RELAY_FEATURE } from "./socket-features";
24
- export { SOCKET_CONNECT_TIMEOUT_MS, SOCKET_PING_ANSWER_MS, SOCKET_QUIET_PING_MS } from "./socket-connection";
24
+ export { SOCKET_CONNECT_TIMEOUT_MS, SOCKET_FIRST_RECONNECT_MAX_MS, SOCKET_PING_ANSWER_MS, SOCKET_QUIET_PING_MS } from "./socket-connection";
25
25
 
26
26
  const cloudApiLog = debugLog.createLogger("cloud-api");
27
27
 
28
+ /**
29
+ * A hello after this long without any frame (a laptop asleep, an outage)
30
+ * says what changed meanwhile was missed, and the account's listeners load
31
+ * their data again. A deploy's reconnect, a few seconds without frames, does
32
+ * not: every client reconnects then, and each reloading would come at once.
33
+ */
34
+ export const SOCKET_RESYNC_AFTER_SILENCE_MS = 60_000;
35
+
28
36
  type ChatNotificationListener = (notification: ChatNotification) => void;
29
37
  type ChatChannelStateListener = (state: ChatChannelState) => void;
30
38
  type ChatPresenceListener = (onlineCount: number) => void;
@@ -41,7 +49,8 @@ type CloudApiSocketDelegate = {
41
49
  isUsingWebSocketToken: () => boolean;
42
50
  clearWebSocketTokenForFallback: () => boolean;
43
51
  markCurrentUserUnverified: () => void;
44
- updateCurrentUserFromSocket: (user: Partial<AuthUser>) => void;
52
+ /** `resync`: the socket was silent long enough that changes were missed (`SOCKET_RESYNC_AFTER_SILENCE_MS`). */
53
+ updateCurrentUserFromSocket: (user: Partial<AuthUser>, options: { resync: boolean }) => void;
45
54
  /** The service answered on this connection (it opened, or sent a frame); see `CloudApiRequestTransport.noteServiceAnswered`. */
46
55
  onServiceAnswered?: () => void;
47
56
  };
@@ -71,6 +80,10 @@ export class CloudApiSocket {
71
80
  private readonly quotes: QuoteStreamSubscriptions;
72
81
  private readonly features: SocketFeatures;
73
82
  private readonly frameRoutes: SocketFrameRoutes;
83
+ /** When the last frame arrived, on this connection or the one before. */
84
+ private lastFrameAt: number | null = null;
85
+ /** How long nothing arrived before the frame being handled. */
86
+ private silenceBeforeFrameMs = 0;
74
87
 
75
88
  constructor(
76
89
  private readonly delegate: CloudApiSocketDelegate,
@@ -297,6 +310,9 @@ export class CloudApiSocket {
297
310
  }
298
311
 
299
312
  async handleSocketMessage(raw: string): Promise<void> {
313
+ const now = Date.now();
314
+ this.silenceBeforeFrameMs = this.lastFrameAt == null ? 0 : now - this.lastFrameAt;
315
+ this.lastFrameAt = now;
300
316
  dispatchSocketFrame(raw, this.frameRoutes);
301
317
  }
302
318
 
@@ -306,7 +322,9 @@ export class CloudApiSocket {
306
322
  cloudApiLog.info("websocket ready", {
307
323
  emailVerified: frame.user.emailVerified === true,
308
324
  });
309
- this.delegate.updateCurrentUserFromSocket(frame.user);
325
+ this.delegate.updateCurrentUserFromSocket(frame.user, {
326
+ resync: this.silenceBeforeFrameMs >= SOCKET_RESYNC_AFTER_SILENCE_MS,
327
+ });
310
328
  }
311
329
  this.listeners.connection.emit("ready");
312
330
  }
@@ -7,7 +7,7 @@ export interface GraphOptions {
7
7
  minPct: number; minConfidence: number; limit: number; ranking: "score" | "shortest"; asOf?: string;
8
8
  }
9
9
  export const DEFAULT_GRAPH_OPTIONS: GraphOptions = { depth: 2, direction: "both", roles: [], sources: [], tiers: [], minPct: 0, minConfidence: 0, limit: 50, ranking: "score" };
10
- export interface GraphEvidence extends Pick<SupplyRow, "claimType" | "corroboration" | "leadStatus" | "firstSeenAt" | "lastSeenAt" | "lastConfirmedAt" | "whyUnconfirmed" | "evidence" | "nativeAmount" | "nativeCurrency" | "nativeScale" | "entityScope" | "quoteGloss" | "sectionRef" | "sourceAttribution" | "periodMonths"> {
10
+ export interface GraphEvidence extends Pick<SupplyRow, "claimType" | "corroboration" | "leadStatus" | "firstSeenAt" | "lastSeenAt" | "lastConfirmedAt" | "whyUnconfirmed" | "evidence" | "nativeAmount" | "nativeCurrency" | "nativeScale" | "entityScope" | "relatedParty" | "quoteGloss" | "sectionRef" | "sourceAttribution" | "periodMonths"> {
11
11
  /** Source trust tier, distinct from the graph evidence class in tier. */
12
12
  trustTier?: SupplyTier;
13
13
  id: string; fromEntity: string; toEntity: string; reportingEntity: string;
@@ -25,7 +25,9 @@ interface GraphLink {
25
25
  }
26
26
  export interface GraphPath {
27
27
  id: string; nodeIds: string[]; linkIds: string[]; hops: number; score: number; confidence: number;
28
- exposure: { pct: number; basis: NonNullable<SupplyRow["pctBasis"]>; period: string; periodMonths?: number | null; denominatorEntityId: string; estimated: true } | null;
28
+ exposure: { pct: number; basis: NonNullable<SupplyRow["pctBasis"]>; period: string; periodMonths?: number | null; denominatorEntityId: string;
29
+ /** True for a product of shares along a longer route; false for one hop, whose share is the one its report files. */
30
+ estimated: boolean } | null;
29
31
  }
30
32
  interface GraphReach { entityId: string; direction: "upstream" | "downstream"; hops: number; bestPath: GraphPath; shortestPath: GraphPath; }
31
33
  export interface GraphPayload {
@@ -25,6 +25,8 @@ export interface SupplyEvidenceItem {
25
25
  value: number | null;
26
26
  valueUnit: string | null;
27
27
  currency: string | null;
28
+ /** A related-party (connected) trade the report prints, with its actual amount. Absent from older servers. */
29
+ relatedParty?: boolean;
28
30
  }
29
31
  export interface SupplyEntity {
30
32
  id: string;
@@ -54,6 +56,12 @@ export interface SupplyRow {
54
56
  nativeScale?: number | null;
55
57
  jurisdiction?: string | null;
56
58
  entityScope?: "entity" | "group" | "anonymous" | "aggregate" | null;
59
+ /**
60
+ * Every disclosure behind the row is a related-party (connected) trade: the
61
+ * counterparty is the company's parent, its group or a company under the
62
+ * same control, never a plain supplier or customer. Absent from older servers.
63
+ */
64
+ relatedParty?: boolean;
57
65
  period: string;
58
66
  /** Months every figure on the row covers: 0 a balance at the period end, 3 a quarter, 12 a year. Null or absent when the source does not say or the figures differ in length. */
59
67
  periodMonths?: number | null;
@@ -103,17 +103,20 @@ export interface CloudMacroReleaseDaysPayload {
103
103
  /** The last New York day the lists are complete for. */
104
104
  coveredThrough: string;
105
105
  sources: string[];
106
- /** New York dates, oldest first. Brazil's IPCA days when the server can vouch for them, and the ECB's decision days. */
107
- releases: Record<"cpi" | "jobs" | "fomc", string[]> & { ipca?: string[]; ecb?: string[] };
106
+ /**
107
+ * New York dates, oldest first. Brazil's IPCA days when the server can vouch for them, and the ECB's decision days;
108
+ * the BoJ's decision days are its own Tokyo days.
109
+ */
110
+ releases: Record<"cpi" | "jobs" | "fomc", string[]> & { ipca?: string[]; ecb?: string[]; boj?: string[] };
108
111
  /** Each kind's figures by New York release day, for the days they are known. */
109
- figures?: Partial<Record<"cpi" | "jobs" | "fomc" | "ipca" | "ecb", Record<string, {
112
+ figures?: Partial<Record<"cpi" | "jobs" | "fomc" | "ipca" | "ecb" | "boj", Record<string, {
110
113
  event: string;
111
114
  actual: string | null;
112
115
  forecast: string | null;
113
116
  prior: string | null;
114
117
  /** Above the consensus (hot), below it (cool), at it (in-line); null without both. */
115
118
  surprise: "hot" | "cool" | "in-line" | null;
116
- /** An FOMC or ECB day's move in the rate: "held", "cut 25bp", "raised 50bp". */
119
+ /** An FOMC, ECB or BoJ day's move in the rate: "held", "cut 25bp", "raised 50bp". */
117
120
  decision?: string;
118
121
  /** How the actual was computed where the calendar lists none: a CPI's year-on-year change from the index. */
119
122
  computed?: string;
@@ -123,9 +126,9 @@ export interface CloudMacroReleaseDaysPayload {
123
126
  /** The first day the kept economic calendar holds, the one `econ` names: days before it have no figures. */
124
127
  figuresFrom?: string;
125
128
  /** Why a release day from `figuresFrom` on has no figures, by kind and day. */
126
- figureGaps?: Partial<Record<"cpi" | "jobs" | "fomc" | "ecb", Record<string, string>>>;
127
- /** The next day of a kind its publisher schedules ahead: the ECB's next decision. */
128
- scheduled?: { ecb?: string };
129
+ figureGaps?: Partial<Record<"cpi" | "jobs" | "fomc" | "ecb" | "boj", Record<string, string>>>;
130
+ /** The next day of a kind its publisher schedules ahead: the ECB's and the BoJ's next decisions. */
131
+ scheduled?: { ecb?: string; boj?: string };
129
132
  }
130
133
 
131
134
  export interface CloudFredObservationPayload {
@@ -6,6 +6,12 @@ export interface CloudEarningsCallPayload {
6
6
  companyName: string | null;
7
7
  fiscalYear: number | null;
8
8
  fiscalQuarter: number | null;
9
+ /**
10
+ * 1 for a half year's results ("H1 2026", a Hong Kong interim results
11
+ * briefing), stored with no quarter as a year's results are. Absent for any
12
+ * other call, and from a server that predates it.
13
+ */
14
+ fiscalHalf?: number;
9
15
  callAt: string | null;
10
16
  status: string;
11
17
  durationSeconds: number | null;
@@ -253,6 +259,8 @@ export interface CloudEarningsTranscriptPayload {
253
259
  companyName: string | null;
254
260
  fiscalYear: number | null;
255
261
  fiscalQuarter: number | null;
262
+ /** 1 for a half year's results (CloudEarningsCallPayload.fiscalHalf). */
263
+ fiscalHalf?: number;
256
264
  /**
257
265
  * "other" for an event that is not an earnings call (a deal call, a
258
266
  * conference, an investor day), named by eventLabel and with no fiscal
@@ -9,7 +9,7 @@ import type { TickerRecord } from "../types/ticker";
9
9
  import { findPaneInstance } from "../types/config";
10
10
  import type { ReleaseInfo } from "../updater";
11
11
  import { canRestartToApply, canRetryUpdate } from "../updater";
12
- import { getVisiblePaneCycleOrder } from "../components/layout/pane/cycle-order";
12
+ import { coveredDockedPaneIds, getVisiblePaneCycleOrder } from "../components/layout/pane/cycle-order";
13
13
  import { requestFunctionHelp, useFunctionHelpHost } from "../plugins/builtin/help/function-card";
14
14
  import { buildRegistryHelpIndex, helpFunctionForPane } from "../plugins/builtin/help/function-index";
15
15
  import { recordFunctionOpen } from "../telemetry/usage-counts";
@@ -239,6 +239,7 @@ export function useAppGlobalShortcuts({
239
239
  state.config.layout,
240
240
  pluginRegistry,
241
241
  state.config.disabledPlugins,
242
+ { covered: coveredDockedPaneIds(), focusedPaneId: state.focusedPaneId },
242
243
  );
243
244
  if (paneOrder.length === 0) return;
244
245
 
@@ -18,6 +18,8 @@ export type CoreKeybindingActionId =
18
18
  | "notification-dismiss"
19
19
  | "quit"
20
20
  | "pane-menu"
21
+ | "pane-next-tab"
22
+ | "pane-prev-tab"
21
23
  | "pane-close"
22
24
  | "close-floating-panes"
23
25
  | "pane-settings"
@@ -54,6 +56,8 @@ export interface KeybindingActionDef {
54
56
 
55
57
  export const PANE_ACTION_IDS = new Set<CoreKeybindingActionId>([
56
58
  "pane-menu",
59
+ "pane-next-tab",
60
+ "pane-prev-tab",
57
61
  "pane-close",
58
62
  "close-floating-panes",
59
63
  "pane-settings",
@@ -176,6 +180,21 @@ export const KEYBINDING_ACTIONS: readonly KeybindingActionDef[] = [
176
180
  // the platform keys for a context menu, and this is the pane's.
177
181
  defaults: [".", "Shift+F10", "ContextMenu"],
178
182
  },
183
+ {
184
+ id: "pane-next-tab",
185
+ category: "Pane Management",
186
+ description: "Show the next tab of the focused pane's stack.",
187
+ // Tab moves between panes and passes the tabs a stack hides; these step
188
+ // through them. Ctrl+PageDown is the tab key of browsers and editors and
189
+ // reaches most terminals; Ctrl+Tab, where the host can tell it from Tab.
190
+ defaults: ["Ctrl+PageDown", "Ctrl+Tab"],
191
+ },
192
+ {
193
+ id: "pane-prev-tab",
194
+ category: "Pane Management",
195
+ description: "Show the previous tab of the focused pane's stack.",
196
+ defaults: ["Ctrl+PageUp", "Ctrl+Shift+Tab"],
197
+ },
179
198
  {
180
199
  id: "pane-close",
181
200
  category: "Pane Management",
@@ -1,4 +1,4 @@
1
- import { useCallback, type Dispatch } from "react";
1
+ import { useCallback, useRef, type Dispatch } from "react";
2
2
  import type { AppTickerRepositoryPort } from "../../core/app-service-ports";
3
3
  import {
4
4
  addPaneFloating,
@@ -39,6 +39,8 @@ import type {
39
39
  } from "../../types/plugin";
40
40
  import type { DialogApi } from "../../ui/dialog";
41
41
  import {
42
+ gridDockTarget,
43
+ utilityWindowsOf,
42
44
  resolvePaneShowTarget,
43
45
  resolvePaneTarget as resolvePaneTargetInLayout,
44
46
  selectEdgeAnchor,
@@ -170,6 +172,9 @@ export function useAppPaneRuntime({
170
172
  if (isPaneDetached(nextLayout, paneId)) focusDetachedPane?.(paneId);
171
173
  }, [activatePane, focusDetachedPane, persistLayout, state.config.layout]);
172
174
 
175
+ /** The layouts this window has been filling from empty, which a new pane docks into as a grid (gridDockTarget). */
176
+ const gridLayouts = useRef(new Set<string>());
177
+
173
178
  const placePaneInstance = useCallback((
174
179
  instance: PaneInstanceConfig,
175
180
  paneDef: PaneDef,
@@ -178,7 +183,8 @@ export function useAppPaneRuntime({
178
183
  const { width, height } = pluginRegistry.getTermSize();
179
184
  // Templates can await ticker resolution before placing their pane, so the
180
185
  // layout from the render that started the request may be out of date.
181
- const { config: { layout }, focusedPaneId } = stateRef.current;
186
+ const { config, focusedPaneId } = stateRef.current;
187
+ const { layout } = config;
182
188
  const relativeTo = options?.relativeToPaneId
183
189
  ? resolvePaneTarget(options.relativeToPaneId, layout)
184
190
  : (focusedPaneId && isPaneInLayout(layout, focusedPaneId) ? focusedPaneId : null);
@@ -186,7 +192,15 @@ export function useAppPaneRuntime({
186
192
  let nextLayout = layout;
187
193
  const dockedPaneIds = getDockedPaneIds(nextLayout);
188
194
 
189
- if (options?.placement === "floating" || (options?.placement !== "docked" && paneDef.defaultMode === "floating")) {
195
+ const floating = options?.placement === "floating" || (options?.placement !== "docked" && paneDef.defaultMode === "floating");
196
+ // A pane that would float, as most functions ask to, docks into a layout being built as a grid; one placed
197
+ // beside a given pane goes there, and a utility window (account, brokers, Ask Gloom, team) floats.
198
+ const grid = floating && !options?.relativeToPaneId && !paneDef.utilityWindow
199
+ ? gridDockTarget(gridLayouts.current, config, instance.instanceId, { width, height },
200
+ utilityWindowsOf(layout, (paneId) => !!pluginRegistry.panes.get(paneId)?.utilityWindow)) : null;
201
+ if (grid) {
202
+ nextLayout = addPaneToLayout(nextLayout, instance, grid);
203
+ } else if (floating) {
190
204
  nextLayout = addPaneFloating(nextLayout, instance, width, height, paneDef, { focusedPaneId });
191
205
  } else if (relativeTo && findDockLeaf(nextLayout, relativeTo)) {
192
206
  nextLayout = addPaneToLayout(nextLayout, instance, { relativeTo, position: relativePosition });
@@ -286,6 +300,7 @@ export function useAppPaneRuntime({
286
300
  dataProvider,
287
301
  dispatch,
288
302
  focusVisiblePane,
303
+ gridLayouts: gridLayouts.current,
289
304
  persistLayout,
290
305
  pluginRegistry,
291
306
  stateRef,