@marinoscar/platform-cli 0.1.0-next.23 → 0.1.0-next.25

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 (227) hide show
  1. package/CHANGELOG.md +40 -0
  2. package/README.md +4 -3
  3. package/dist/engine/commands/node.d.ts.map +1 -1
  4. package/dist/engine/commands/node.js +73 -6
  5. package/dist/engine/commands/node.js.map +1 -1
  6. package/dist/engine/conformance.d.ts +3 -0
  7. package/dist/engine/conformance.d.ts.map +1 -1
  8. package/dist/engine/conformance.js +7 -0
  9. package/dist/engine/conformance.js.map +1 -1
  10. package/dist/engine/create-cli.d.ts +21 -0
  11. package/dist/engine/create-cli.d.ts.map +1 -1
  12. package/dist/engine/create-cli.js +11 -0
  13. package/dist/engine/create-cli.js.map +1 -1
  14. package/dist/engine/index.d.ts +26 -3
  15. package/dist/engine/index.d.ts.map +1 -1
  16. package/dist/engine/index.js +13 -1
  17. package/dist/engine/index.js.map +1 -1
  18. package/dist/engine/node/capabilities.d.ts +199 -4
  19. package/dist/engine/node/capabilities.d.ts.map +1 -1
  20. package/dist/engine/node/capabilities.js +292 -11
  21. package/dist/engine/node/capabilities.js.map +1 -1
  22. package/dist/engine/node/daemon-channels.d.ts +66 -0
  23. package/dist/engine/node/daemon-channels.d.ts.map +1 -0
  24. package/dist/engine/node/daemon-channels.js +65 -0
  25. package/dist/engine/node/daemon-channels.js.map +1 -0
  26. package/dist/engine/node/daemon.d.ts.map +1 -1
  27. package/dist/engine/node/daemon.js +52 -0
  28. package/dist/engine/node/daemon.js.map +1 -1
  29. package/dist/engine/node/doctor.d.ts +2 -0
  30. package/dist/engine/node/doctor.d.ts.map +1 -1
  31. package/dist/engine/node/doctor.js +56 -3
  32. package/dist/engine/node/doctor.js.map +1 -1
  33. package/dist/engine/node/executors/credential-hygiene.d.ts +1 -1
  34. package/dist/engine/node/executors/credential-hygiene.d.ts.map +1 -1
  35. package/dist/engine/node/executors/credential-hygiene.js +23 -2
  36. package/dist/engine/node/executors/credential-hygiene.js.map +1 -1
  37. package/dist/engine/node/executors/index.d.ts +52 -7
  38. package/dist/engine/node/executors/index.d.ts.map +1 -1
  39. package/dist/engine/node/executors/index.js +14 -0
  40. package/dist/engine/node/executors/index.js.map +1 -1
  41. package/dist/engine/node/executors/registry.d.ts.map +1 -1
  42. package/dist/engine/node/executors/registry.js +13 -2
  43. package/dist/engine/node/executors/registry.js.map +1 -1
  44. package/dist/engine/node/install-deps.d.ts +164 -6
  45. package/dist/engine/node/install-deps.d.ts.map +1 -1
  46. package/dist/engine/node/install-deps.js +251 -9
  47. package/dist/engine/node/install-deps.js.map +1 -1
  48. package/dist/engine/node/ipc-protocol.d.ts +49 -2
  49. package/dist/engine/node/ipc-protocol.d.ts.map +1 -1
  50. package/dist/engine/node/ipc-protocol.js +39 -0
  51. package/dist/engine/node/ipc-protocol.js.map +1 -1
  52. package/dist/engine/node/lifecycle.js +2 -1
  53. package/dist/engine/node/lifecycle.js.map +1 -1
  54. package/dist/engine/node/logger.d.ts +13 -0
  55. package/dist/engine/node/logger.d.ts.map +1 -1
  56. package/dist/engine/node/logger.js.map +1 -1
  57. package/dist/engine/node/memory-watchdog.d.ts +11 -0
  58. package/dist/engine/node/memory-watchdog.d.ts.map +1 -1
  59. package/dist/engine/node/memory-watchdog.js +28 -4
  60. package/dist/engine/node/memory-watchdog.js.map +1 -1
  61. package/dist/engine/node/models.d.ts +195 -0
  62. package/dist/engine/node/models.d.ts.map +1 -0
  63. package/dist/engine/node/models.js +379 -0
  64. package/dist/engine/node/models.js.map +1 -0
  65. package/dist/engine/node/node-dashboard-source.d.ts +46 -19
  66. package/dist/engine/node/node-dashboard-source.d.ts.map +1 -1
  67. package/dist/engine/node/node-dashboard-source.js +70 -102
  68. package/dist/engine/node/node-dashboard-source.js.map +1 -1
  69. package/dist/engine/node/node-engine.d.ts +20 -2
  70. package/dist/engine/node/node-engine.d.ts.map +1 -1
  71. package/dist/engine/node/node-engine.js +99 -11
  72. package/dist/engine/node/node-engine.js.map +1 -1
  73. package/dist/engine/node/runtime-state.d.ts +24 -0
  74. package/dist/engine/node/runtime-state.d.ts.map +1 -0
  75. package/dist/engine/node/runtime-state.js +19 -0
  76. package/dist/engine/node/runtime-state.js.map +1 -0
  77. package/dist/engine/node/runtime-tuning.d.ts +111 -2
  78. package/dist/engine/node/runtime-tuning.d.ts.map +1 -1
  79. package/dist/engine/node/runtime-tuning.js +133 -4
  80. package/dist/engine/node/runtime-tuning.js.map +1 -1
  81. package/dist/engine/node/service.d.ts.map +1 -1
  82. package/dist/engine/node/service.js +4 -0
  83. package/dist/engine/node/service.js.map +1 -1
  84. package/dist/engine/node/start.d.ts +7 -0
  85. package/dist/engine/node/start.d.ts.map +1 -1
  86. package/dist/engine/node/start.js +71 -3
  87. package/dist/engine/node/start.js.map +1 -1
  88. package/dist/engine/node/worker-env-aliases.d.ts +39 -0
  89. package/dist/engine/node/worker-env-aliases.d.ts.map +1 -0
  90. package/dist/engine/node/worker-env-aliases.js +126 -0
  91. package/dist/engine/node/worker-env-aliases.js.map +1 -0
  92. package/dist/engine/node/worker-env-table.d.ts.map +1 -1
  93. package/dist/engine/node/worker-env-table.js +4 -1
  94. package/dist/engine/node/worker-env-table.js.map +1 -1
  95. package/dist/engine/node/worker-env.d.ts +18 -1
  96. package/dist/engine/node/worker-env.d.ts.map +1 -1
  97. package/dist/engine/node/worker-env.js +13 -0
  98. package/dist/engine/node/worker-env.js.map +1 -1
  99. package/dist/engine/registries.d.ts.map +1 -1
  100. package/dist/engine/registries.js +7 -0
  101. package/dist/engine/registries.js.map +1 -1
  102. package/dist/engine/tui/app.d.ts.map +1 -1
  103. package/dist/engine/tui/app.js +15 -2
  104. package/dist/engine/tui/app.js.map +1 -1
  105. package/dist/engine/tui/builtin-screens.d.ts.map +1 -1
  106. package/dist/engine/tui/builtin-screens.js +6 -0
  107. package/dist/engine/tui/builtin-screens.js.map +1 -1
  108. package/dist/engine/tui/conformance.d.ts +143 -0
  109. package/dist/engine/tui/conformance.d.ts.map +1 -0
  110. package/dist/engine/tui/conformance.js +423 -0
  111. package/dist/engine/tui/conformance.js.map +1 -0
  112. package/dist/engine/tui/dashboard/index.d.ts +8 -0
  113. package/dist/engine/tui/dashboard/index.d.ts.map +1 -0
  114. package/dist/engine/tui/dashboard/index.js +5 -0
  115. package/dist/engine/tui/dashboard/index.js.map +1 -0
  116. package/dist/engine/tui/dashboard/jobs-insights.d.ts +145 -0
  117. package/dist/engine/tui/dashboard/jobs-insights.d.ts.map +1 -0
  118. package/dist/engine/tui/dashboard/jobs-insights.js +63 -0
  119. package/dist/engine/tui/dashboard/jobs-insights.js.map +1 -0
  120. package/dist/engine/tui/dashboard/node-embedded.d.ts +33 -0
  121. package/dist/engine/tui/dashboard/node-embedded.d.ts.map +1 -0
  122. package/dist/engine/tui/dashboard/node-embedded.js +81 -0
  123. package/dist/engine/tui/dashboard/node-embedded.js.map +1 -0
  124. package/dist/engine/tui/dashboard/source.d.ts +274 -0
  125. package/dist/engine/tui/dashboard/source.d.ts.map +1 -0
  126. package/dist/engine/tui/dashboard/source.js +351 -0
  127. package/dist/engine/tui/dashboard/source.js.map +1 -0
  128. package/dist/engine/tui/dashboard/use-dashboard.d.ts +23 -0
  129. package/dist/engine/tui/dashboard/use-dashboard.d.ts.map +1 -0
  130. package/dist/engine/tui/dashboard/use-dashboard.js +32 -0
  131. package/dist/engine/tui/dashboard/use-dashboard.js.map +1 -0
  132. package/dist/engine/tui/layout.d.ts +20 -0
  133. package/dist/engine/tui/layout.d.ts.map +1 -1
  134. package/dist/engine/tui/layout.js +7 -0
  135. package/dist/engine/tui/layout.js.map +1 -1
  136. package/dist/engine/tui/menu-registry.d.ts +124 -0
  137. package/dist/engine/tui/menu-registry.d.ts.map +1 -0
  138. package/dist/engine/tui/menu-registry.js +151 -0
  139. package/dist/engine/tui/menu-registry.js.map +1 -0
  140. package/dist/engine/tui/menu-tree.d.ts +179 -0
  141. package/dist/engine/tui/menu-tree.d.ts.map +1 -0
  142. package/dist/engine/tui/menu-tree.js +250 -0
  143. package/dist/engine/tui/menu-tree.js.map +1 -0
  144. package/dist/engine/tui/screen-registry.d.ts +1 -1
  145. package/dist/engine/tui/screen-registry.d.ts.map +1 -1
  146. package/dist/engine/tui/screen-registry.js +2 -1
  147. package/dist/engine/tui/screen-registry.js.map +1 -1
  148. package/dist/engine/tui/screens/jobs.d.ts +12 -0
  149. package/dist/engine/tui/screens/jobs.d.ts.map +1 -0
  150. package/dist/engine/tui/screens/jobs.js +72 -0
  151. package/dist/engine/tui/screens/jobs.js.map +1 -0
  152. package/dist/engine/tui/screens/menu.d.ts +4 -1
  153. package/dist/engine/tui/screens/menu.d.ts.map +1 -1
  154. package/dist/engine/tui/screens/menu.js +85 -22
  155. package/dist/engine/tui/screens/menu.js.map +1 -1
  156. package/dist/engine/tui/screens/node.d.ts.map +1 -1
  157. package/dist/engine/tui/screens/node.js +82 -37
  158. package/dist/engine/tui/screens/node.js.map +1 -1
  159. package/dist/engine/tui/screens/not-logged-in.d.ts +12 -0
  160. package/dist/engine/tui/screens/not-logged-in.d.ts.map +1 -0
  161. package/dist/engine/tui/screens/not-logged-in.js +14 -0
  162. package/dist/engine/tui/screens/not-logged-in.js.map +1 -0
  163. package/dist/engine/tui/scroll-box.d.ts +15 -0
  164. package/dist/engine/tui/scroll-box.d.ts.map +1 -1
  165. package/dist/engine/tui/scroll-box.js +10 -0
  166. package/dist/engine/tui/scroll-box.js.map +1 -1
  167. package/dist/engine/tui/testing/feeds.d.ts +58 -0
  168. package/dist/engine/tui/testing/feeds.d.ts.map +1 -0
  169. package/dist/engine/tui/testing/feeds.js +67 -0
  170. package/dist/engine/tui/testing/feeds.js.map +1 -0
  171. package/dist/engine/tui/testing/harness.d.ts +241 -0
  172. package/dist/engine/tui/testing/harness.d.ts.map +1 -0
  173. package/dist/engine/tui/testing/harness.js +332 -0
  174. package/dist/engine/tui/testing/harness.js.map +1 -0
  175. package/dist/engine/tui/ui/active-items.d.ts +40 -0
  176. package/dist/engine/tui/ui/active-items.d.ts.map +1 -0
  177. package/dist/engine/tui/ui/active-items.js +38 -0
  178. package/dist/engine/tui/ui/active-items.js.map +1 -0
  179. package/dist/engine/tui/ui/event-log.d.ts +58 -0
  180. package/dist/engine/tui/ui/event-log.d.ts.map +1 -0
  181. package/dist/engine/tui/ui/event-log.js +32 -0
  182. package/dist/engine/tui/ui/event-log.js.map +1 -0
  183. package/dist/engine/tui/ui/index.d.ts +20 -0
  184. package/dist/engine/tui/ui/index.d.ts.map +1 -0
  185. package/dist/engine/tui/ui/index.js +14 -0
  186. package/dist/engine/tui/ui/index.js.map +1 -0
  187. package/dist/engine/tui/ui/meter-legend.d.ts +26 -0
  188. package/dist/engine/tui/ui/meter-legend.d.ts.map +1 -0
  189. package/dist/engine/tui/ui/meter-legend.js +25 -0
  190. package/dist/engine/tui/ui/meter-legend.js.map +1 -0
  191. package/dist/engine/tui/ui/run-summary.d.ts +58 -0
  192. package/dist/engine/tui/ui/run-summary.d.ts.map +1 -0
  193. package/dist/engine/tui/ui/run-summary.js +29 -0
  194. package/dist/engine/tui/ui/run-summary.js.map +1 -0
  195. package/dist/engine/tui/ui/segment-meter.d.ts +72 -0
  196. package/dist/engine/tui/ui/segment-meter.d.ts.map +1 -0
  197. package/dist/engine/tui/ui/segment-meter.js +128 -0
  198. package/dist/engine/tui/ui/segment-meter.js.map +1 -0
  199. package/dist/engine/tui/ui/status-line.d.ts +42 -0
  200. package/dist/engine/tui/ui/status-line.d.ts.map +1 -0
  201. package/dist/engine/tui/ui/status-line.js +35 -0
  202. package/dist/engine/tui/ui/status-line.js.map +1 -0
  203. package/dist/engine/tui/ui/tone.d.ts +46 -0
  204. package/dist/engine/tui/ui/tone.d.ts.map +1 -0
  205. package/dist/engine/tui/ui/tone.js +48 -0
  206. package/dist/engine/tui/ui/tone.js.map +1 -0
  207. package/dist/node/index.d.ts +2 -2
  208. package/dist/node/index.d.ts.map +1 -1
  209. package/dist/node/index.js +1 -1
  210. package/dist/node/index.js.map +1 -1
  211. package/dist/testing/index.d.ts +2 -2
  212. package/dist/testing/index.d.ts.map +1 -1
  213. package/dist/testing/index.js +1 -1
  214. package/dist/testing/index.js.map +1 -1
  215. package/dist/tui/index.d.ts +2 -2
  216. package/dist/tui/index.d.ts.map +1 -1
  217. package/dist/tui/index.js +1 -1
  218. package/dist/tui/index.js.map +1 -1
  219. package/dist/tui/testing/index.d.ts +5 -0
  220. package/dist/tui/testing/index.d.ts.map +1 -0
  221. package/dist/tui/testing/index.js +12 -0
  222. package/dist/tui/testing/index.js.map +1 -0
  223. package/dist/tui/ui/index.d.ts +2 -0
  224. package/dist/tui/ui/index.d.ts.map +1 -0
  225. package/dist/tui/ui/index.js +10 -0
  226. package/dist/tui/ui/index.js.map +1 -0
  227. package/package.json +16 -3
@@ -0,0 +1,145 @@
1
+ import type { DashboardReducer } from './source.js';
2
+ /**
3
+ * Per-status job counts.
4
+ *
5
+ * @stability experimental
6
+ */
7
+ export interface JobsStatusCounts {
8
+ /** Waiting to run. */
9
+ pending: number;
10
+ /** Running now. */
11
+ running: number;
12
+ /** Finished successfully. */
13
+ succeeded: number;
14
+ /** Failed for good. */
15
+ failed: number;
16
+ }
17
+ /**
18
+ * The part of `GET /api/admin/jobs/stats` the dashboard reads. The server
19
+ * sends more; the rest is ignored.
20
+ *
21
+ * @stability experimental
22
+ */
23
+ export interface JobsStats {
24
+ /** Counts per status. */
25
+ byStatus: JobsStatusCounts;
26
+ /** Pending jobs waiting out a backoff. */
27
+ scheduled: number;
28
+ /** Running jobs the lease reaper would reclaim now. */
29
+ stuckRunning: number;
30
+ /** The age, in minutes, past which a running job counts as stuck. */
31
+ stuckThresholdMinutes: number;
32
+ }
33
+ /**
34
+ * One job type's completion estimate.
35
+ *
36
+ * @stability experimental
37
+ */
38
+ export interface JobsEta {
39
+ /** The type's display label. */
40
+ label: string;
41
+ /** Jobs waiting. */
42
+ pending: number;
43
+ /** Jobs running. */
44
+ running: number;
45
+ /** Jobs still to finish. */
46
+ remaining: number;
47
+ /** Estimated time to finish them, in milliseconds. */
48
+ estimatedMs: number;
49
+ }
50
+ /**
51
+ * The part of `GET /api/admin/jobs/insights` the dashboard reads.
52
+ *
53
+ * @stability experimental
54
+ */
55
+ export interface JobsInsights {
56
+ /** Days of history the percentiles cover. */
57
+ windowDays: number;
58
+ /** Duration and throughput over succeeded jobs in the window. */
59
+ history: {
60
+ /** All types together. */
61
+ overall: {
62
+ /** Jobs finished per minute. */
63
+ throughputPerMin: number;
64
+ /** Median duration in milliseconds; null with no samples. */
65
+ p50Ms: number | null;
66
+ /** 95th-percentile duration in milliseconds; null with no samples. */
67
+ p95Ms: number | null;
68
+ };
69
+ };
70
+ /** Completion estimate per type. */
71
+ eta: JobsEta[];
72
+ }
73
+ /**
74
+ * What one poll returns. A refusal is a result, not an exception.
75
+ *
76
+ * @stability experimental
77
+ */
78
+ export type JobsPollResult = {
79
+ /** The server answered. */
80
+ kind: 'ok';
81
+ /** When the poll finished (ISO 8601). */
82
+ at: string;
83
+ /** The queue summary. */
84
+ stats: JobsStats;
85
+ /** Throughput and estimates. */
86
+ insights: JobsInsights;
87
+ } | {
88
+ /** The server refused (403: no `jobs:read`). */
89
+ kind: 'forbidden';
90
+ /** When the poll finished (ISO 8601). */
91
+ at: string;
92
+ /** What to tell the user. */
93
+ message: string;
94
+ };
95
+ /**
96
+ * The jobs dashboard's data.
97
+ *
98
+ * @stability experimental
99
+ */
100
+ export interface JobsDashboardData {
101
+ /** The last queue summary. */
102
+ stats: JobsStats | undefined;
103
+ /** The last throughput report. */
104
+ insights: JobsInsights | undefined;
105
+ /** When the last successful poll finished. */
106
+ updatedAt: string | undefined;
107
+ /** Set when the server answered 403: the caller lacks `jobs:read`. */
108
+ forbidden: string | undefined;
109
+ }
110
+ /**
111
+ * The jobs dashboard's reducer. `hydrate` and `log` are not used by a poll;
112
+ * a poll result replaces the previous one.
113
+ *
114
+ * @stability experimental
115
+ */
116
+ export declare const jobsInsightsReducer: DashboardReducer<JobsDashboardData, JobsPollResult>;
117
+ /**
118
+ * The slice of the CLI's API client the poll needs.
119
+ *
120
+ * @stability experimental
121
+ */
122
+ export interface JobsApi {
123
+ /** A GET returning the unwrapped payload. */
124
+ get<T>(path: string, options?: {
125
+ signal?: AbortSignal | undefined;
126
+ query?: Record<string, string | number | undefined>;
127
+ }): Promise<T>;
128
+ }
129
+ /**
130
+ * One poll of the admin jobs API: `stats` and `insights` together.
131
+ *
132
+ * A 403 becomes `{ kind: 'forbidden' }` so the screen can say that the caller
133
+ * lacks `jobs:read` and keep polling (a grant takes effect without a
134
+ * restart); every other failure throws and the feed reports it.
135
+ *
136
+ * @param api - The CLI's API client (`ApiClient`).
137
+ * @param options - `windowDays` for the percentile window; `now` for tests.
138
+ * @returns A function suitable for `pollFeed`.
139
+ * @stability experimental
140
+ */
141
+ export declare function fetchJobsInsights(api: JobsApi, options?: {
142
+ windowDays?: number | undefined;
143
+ now?: (() => Date) | undefined;
144
+ }): (signal: AbortSignal) => Promise<JobsPollResult>;
145
+ //# sourceMappingURL=jobs-insights.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jobs-insights.d.ts","sourceRoot":"","sources":["../../../../src/engine/tui/dashboard/jobs-insights.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,63 @@
1
+ import { ApiError } from '../../errors.js';
2
+ function isRecord(value) {
3
+ return value !== null && typeof value === 'object' && !Array.isArray(value);
4
+ }
5
+ /**
6
+ * The jobs dashboard's reducer. `hydrate` and `log` are not used by a poll;
7
+ * a poll result replaces the previous one.
8
+ *
9
+ * @stability experimental
10
+ */
11
+ export const jobsInsightsReducer = {
12
+ initial: () => ({ stats: undefined, insights: undefined, updatedAt: undefined, forbidden: undefined }),
13
+ hydrate: (state) => state,
14
+ reduce: (state, result) => result.kind === 'ok'
15
+ ? { stats: result.stats, insights: result.insights, updatedAt: result.at, forbidden: undefined }
16
+ : { ...state, forbidden: result.message },
17
+ parseEvent: (frame) => {
18
+ if (!isRecord(frame))
19
+ return undefined;
20
+ if (frame.kind === 'ok' && isRecord(frame.stats) && isRecord(frame.insights) && typeof frame.at === 'string') {
21
+ return frame;
22
+ }
23
+ if (frame.kind === 'forbidden' && typeof frame.message === 'string' && typeof frame.at === 'string') {
24
+ return frame;
25
+ }
26
+ return undefined;
27
+ },
28
+ };
29
+ /**
30
+ * One poll of the admin jobs API: `stats` and `insights` together.
31
+ *
32
+ * A 403 becomes `{ kind: 'forbidden' }` so the screen can say that the caller
33
+ * lacks `jobs:read` and keep polling (a grant takes effect without a
34
+ * restart); every other failure throws and the feed reports it.
35
+ *
36
+ * @param api - The CLI's API client (`ApiClient`).
37
+ * @param options - `windowDays` for the percentile window; `now` for tests.
38
+ * @returns A function suitable for `pollFeed`.
39
+ * @stability experimental
40
+ */
41
+ export function fetchJobsInsights(api, options = {}) {
42
+ const now = options.now ?? (() => new Date());
43
+ return async (signal) => {
44
+ try {
45
+ const [stats, insights] = await Promise.all([
46
+ api.get('/admin/jobs/stats', { signal }),
47
+ api.get('/admin/jobs/insights', { signal, query: { windowDays: options.windowDays } }),
48
+ ]);
49
+ return { kind: 'ok', at: now().toISOString(), stats, insights };
50
+ }
51
+ catch (error) {
52
+ if (error instanceof ApiError && error.status === 403) {
53
+ return {
54
+ kind: 'forbidden',
55
+ at: now().toISOString(),
56
+ message: 'Your account does not have the jobs:read permission, so the queue cannot be shown.',
57
+ };
58
+ }
59
+ throw error;
60
+ }
61
+ };
62
+ }
63
+ //# sourceMappingURL=jobs-insights.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jobs-insights.js","sourceRoot":"","sources":["../../../../src/engine/tui/dashboard/jobs-insights.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAqI3C,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAwD;IACtF,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;IACtG,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK;IACzB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CACxB,MAAM,CAAC,IAAI,KAAK,IAAI;QAClB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE;QAChG,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE;IAC7C,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE;QACpB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACvC,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC7G,OAAO,KAAkC,CAAC;QAC5C,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YACpG,OAAO,KAAkC,CAAC;QAC5C,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF,CAAC;AAYF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAY,EACZ,UAA+E,EAAE;IAEjF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC1C,GAAG,CAAC,GAAG,CAAY,mBAAmB,EAAE,EAAE,MAAM,EAAE,CAAC;gBACnD,GAAG,CAAC,GAAG,CAAe,sBAAsB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;aACrG,CAAC,CAAC;YACH,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAClE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACtD,OAAO;oBACL,IAAI,EAAE,WAAW;oBACjB,EAAE,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;oBACvB,OAAO,EAAE,oFAAoF;iBAC9F,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,33 @@
1
+ import { connectToDaemon } from '../../node/daemon.js';
2
+ import type { NodeEngineEvent } from '../../node/node-events.js';
3
+ import { type StartedNode, type StartNodeOptions } from '../../node/start.js';
4
+ import { type DashboardFeed } from './source.js';
5
+ /** Options of {@link embeddedNodeFeed}. */
6
+ export interface EmbeddedNodeFeedOptions {
7
+ /** Forwarded to `startNode` (paths, env, test seams). */
8
+ start?: Omit<StartNodeOptions, 'onEvent' | 'stderr' | 'installSignalHandlers' | 'selfTest' | 'headless'> | undefined;
9
+ /** Test seam: replaces `startNode`. */
10
+ startNode?: ((options: StartNodeOptions) => Promise<StartedNode>) | undefined;
11
+ }
12
+ /**
13
+ * A feed that starts the worker engine in this process when it starts, feeds
14
+ * the dashboard from its events and stops it (without deregistering) when it
15
+ * stops. Never writes to stderr (it would corrupt the ink frame) and never
16
+ * installs signal handlers (ink owns Ctrl-C).
17
+ *
18
+ * @param options - `start` options for `startNode`, and a test seam.
19
+ * @returns A feed in `embedded` mode. A failure to start is reported as a disconnect, not thrown.
20
+ * @stability experimental
21
+ */
22
+ export declare function embeddedNodeFeed(options?: EmbeddedNodeFeedOptions): DashboardFeed<NodeEngineEvent>;
23
+ /**
24
+ * Whether something is already listening on the worker socket. A probe that
25
+ * connects and hangs up; it sends nothing.
26
+ *
27
+ * @param socketPath - The daemon socket.
28
+ * @param connect - Test seam.
29
+ * @returns `true` when a daemon accepted the connection.
30
+ * @stability experimental
31
+ */
32
+ export declare function isDaemonListening(socketPath: string, connect?: typeof connectToDaemon): Promise<boolean>;
33
+ //# sourceMappingURL=node-embedded.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node-embedded.d.ts","sourceRoot":"","sources":["../../../../src/engine/tui/dashboard/node-embedded.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAa,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACzF,OAAO,EAAiB,KAAK,aAAa,EAA6B,MAAM,aAAa,CAAC;AAqB3F,2CAA2C;AAC3C,MAAM,WAAW,uBAAuB;IACtC,yDAAyD;IACzD,KAAK,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,QAAQ,GAAG,uBAAuB,GAAG,UAAU,GAAG,UAAU,CAAC,GAAG,SAAS,CAAC;IACrH,uCAAuC;IACvC,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,SAAS,CAAC;CAC/E;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,aAAa,CAAC,eAAe,CAAC,CA6CtG;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,OAAO,eAAiC,GAChD,OAAO,CAAC,OAAO,CAAC,CAQlB"}
@@ -0,0 +1,81 @@
1
+ import { EventEmitter } from 'node:events';
2
+ import { connectToDaemon } from '../../node/daemon.js';
3
+ import { startNode } from '../../node/start.js';
4
+ import { inProcessFeed } from './source.js';
5
+ /**
6
+ * A feed that starts the worker engine in this process when it starts, feeds
7
+ * the dashboard from its events and stops it (without deregistering) when it
8
+ * stops. Never writes to stderr (it would corrupt the ink frame) and never
9
+ * installs signal handlers (ink owns Ctrl-C).
10
+ *
11
+ * @param options - `start` options for `startNode`, and a test seam.
12
+ * @returns A feed in `embedded` mode. A failure to start is reported as a disconnect, not thrown.
13
+ * @stability experimental
14
+ */
15
+ export function embeddedNodeFeed(options = {}) {
16
+ const run = options.startNode ?? startNode;
17
+ const emitter = new EventEmitter();
18
+ let inner;
19
+ let started;
20
+ let stopped = false;
21
+ const shutdown = (node) => {
22
+ // `finished` rejects when the run loop errors; it is already logged.
23
+ void node.engine.stop({ deregister: false }).catch(() => { });
24
+ void node.finished.catch(() => { });
25
+ };
26
+ return {
27
+ mode: 'embedded',
28
+ async start(emit) {
29
+ emit({ kind: 'attempt' });
30
+ try {
31
+ const node = await run({
32
+ ...(options.start ?? {}),
33
+ headless: false,
34
+ selfTest: false,
35
+ stderr: { write: () => true },
36
+ installSignalHandlers: () => { },
37
+ onEvent: (event) => emitter.emit('event', event),
38
+ });
39
+ if (stopped) {
40
+ shutdown(node);
41
+ return;
42
+ }
43
+ started = node;
44
+ inner = inProcessFeed(emitter, { snapshot: () => node.engine.getSnapshot() });
45
+ await inner.start(emit);
46
+ }
47
+ catch (error) {
48
+ emit({ kind: 'disconnected', error: error instanceof Error ? error.message : String(error) });
49
+ }
50
+ },
51
+ stop() {
52
+ if (stopped)
53
+ return;
54
+ stopped = true;
55
+ inner?.stop();
56
+ if (started !== undefined)
57
+ shutdown(started);
58
+ started = undefined;
59
+ },
60
+ };
61
+ }
62
+ /**
63
+ * Whether something is already listening on the worker socket. A probe that
64
+ * connects and hangs up; it sends nothing.
65
+ *
66
+ * @param socketPath - The daemon socket.
67
+ * @param connect - Test seam.
68
+ * @returns `true` when a daemon accepted the connection.
69
+ * @stability experimental
70
+ */
71
+ export async function isDaemonListening(socketPath, connect = connectToDaemon) {
72
+ try {
73
+ const client = await connect({ socketPath, timeoutMs: 500, onMessage: () => { } });
74
+ client.close();
75
+ return true;
76
+ }
77
+ catch {
78
+ return false;
79
+ }
80
+ }
81
+ //# sourceMappingURL=node-embedded.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"node-embedded.js","sourceRoot":"","sources":["../../../../src/engine/tui/dashboard/node-embedded.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,274 @@
1
+ import { connectToDaemon } from '../../node/daemon.js';
2
+ import type { LogRecord } from '../../node/logger.js';
3
+ /**
4
+ * How a dashboard turns what a feed delivers into state. Every method is pure.
5
+ *
6
+ * @typeParam S - The dashboard's data (without the connection fields).
7
+ * @typeParam E - One event, as the reducer understands it.
8
+ * @stability experimental
9
+ * @extensionPoint hook
10
+ */
11
+ export interface DashboardReducer<S, E> {
12
+ /** The state before anything has arrived. */
13
+ initial(): S;
14
+ /** Folds the snapshot the feed delivers on connect (the daemon's snapshot frame). */
15
+ hydrate(state: S, snapshot: unknown): S;
16
+ /** Folds one event. */
17
+ reduce(state: S, event: E): S;
18
+ /** Folds a log tail, when the dashboard shows one. */
19
+ log?(state: S, lines: LogRecord[]): S;
20
+ /** Validates a raw frame from the wire; `undefined` drops it. */
21
+ parseEvent(frame: unknown): E | undefined;
22
+ }
23
+ /**
24
+ * Where a dashboard's data comes from.
25
+ *
26
+ * @stability experimental
27
+ */
28
+ export type DashboardMode = 'attached' | 'embedded' | 'poll';
29
+ /**
30
+ * What a feed tells its source.
31
+ *
32
+ * `frame` carries an unvalidated wire value (the source runs it through
33
+ * `reducer.parseEvent`); `event` carries one already typed (an in-process
34
+ * emitter, a poll result).
35
+ *
36
+ * @stability experimental
37
+ */
38
+ export type DashboardFeedMessage<E> = {
39
+ /** A connection or poll attempt began. */
40
+ kind: 'attempt';
41
+ } | {
42
+ /** The feed is reaching its source. */
43
+ kind: 'connected';
44
+ } | {
45
+ /** The feed lost its source (a closed socket, a failed poll). */
46
+ kind: 'disconnected';
47
+ /** Why, for the frame's notice line. */
48
+ error?: string | undefined;
49
+ } | {
50
+ /** The state to hydrate from (the daemon's on-connect snapshot). */
51
+ kind: 'snapshot';
52
+ /** The raw snapshot; the reducer validates it. */
53
+ snapshot: unknown;
54
+ } | {
55
+ /** An unvalidated wire value. */
56
+ kind: 'frame';
57
+ /** The raw value; the reducer's `parseEvent` validates it. */
58
+ frame: unknown;
59
+ } | {
60
+ /** An event already typed. */
61
+ kind: 'event';
62
+ /** The event. */
63
+ event: E;
64
+ } | {
65
+ /** A log tail. */
66
+ kind: 'logs';
67
+ /** The new log lines. */
68
+ lines: LogRecord[];
69
+ } | {
70
+ /** A message from the source itself (the daemon's `error` frame). */
71
+ kind: 'error';
72
+ /** The message. */
73
+ message: string;
74
+ };
75
+ /**
76
+ * A source of dashboard data. `start` resolves once the first attempt has
77
+ * settled; `stop` is idempotent and ends every timer and connection.
78
+ *
79
+ * @stability experimental
80
+ */
81
+ export interface DashboardFeed<E> {
82
+ /** Where the data comes from. */
83
+ readonly mode: DashboardMode;
84
+ /** Begins feeding `emit`; resolves once the first attempt has settled. */
85
+ start(emit: (message: DashboardFeedMessage<E>) => void): Promise<void>;
86
+ /** Ends every connection, request and timer. Idempotent. */
87
+ stop(): void;
88
+ }
89
+ /**
90
+ * The connection fields every dashboard state carries.
91
+ *
92
+ * @stability experimental
93
+ */
94
+ export interface DashboardConnection {
95
+ /** Whether the feed is reaching its source right now. */
96
+ connected: boolean;
97
+ /** Whether the feed was ever reached. Distinguishes "starting" from "gone". */
98
+ everConnected: boolean;
99
+ /** The last failure, for the frame's notice line. */
100
+ error: string | undefined;
101
+ /** Connection or poll attempts so far. */
102
+ attempts: number;
103
+ /** The feed's transport. */
104
+ mode: DashboardMode;
105
+ }
106
+ /**
107
+ * Options of {@link DashboardSource}.
108
+ *
109
+ * @stability experimental
110
+ */
111
+ export interface DashboardSourceOptions<S> {
112
+ /** Called with every new state (in addition to `subscribe`). */
113
+ onChange?: ((state: S & DashboardConnection) => void) | undefined;
114
+ }
115
+ /**
116
+ * Owns a dashboard's state: applies the reducer to what the feed emits.
117
+ *
118
+ * @typeParam S - The dashboard's data.
119
+ * @typeParam E - One event.
120
+ * @stability experimental
121
+ * @example
122
+ * ```ts
123
+ * const source = new DashboardSource(myReducer, daemonAttachFeed({ socketPath, channel: 'backup' }));
124
+ * // in a screen: const state = useDashboard(source);
125
+ * ```
126
+ */
127
+ export declare class DashboardSource<S, E> {
128
+ private readonly reducer;
129
+ private readonly feed;
130
+ private readonly options;
131
+ private inner;
132
+ private connection;
133
+ private current;
134
+ private readonly subscribers;
135
+ private stopped;
136
+ private started;
137
+ constructor(reducer: DashboardReducer<S, E>, feed: DashboardFeed<E>, options?: DashboardSourceOptions<S>);
138
+ /** The current state. A NEW object after every change, so React sees it. */
139
+ getState: () => S & DashboardConnection;
140
+ /** Registers a listener; returns the unsubscribe. */
141
+ subscribe: (listener: (state: S & DashboardConnection) => void) => (() => void);
142
+ /** Starts the feed. Resolves once its first attempt has settled. Idempotent. */
143
+ start(): Promise<void>;
144
+ /**
145
+ * Stops the feed and ignores anything it says afterwards. Idempotent. The
146
+ * daemon (or server) is not told and is not affected in any way.
147
+ */
148
+ stop(): void;
149
+ private receive;
150
+ private publish;
151
+ }
152
+ /**
153
+ * Options of {@link daemonAttachFeed}.
154
+ *
155
+ * @stability experimental
156
+ */
157
+ export interface DaemonAttachFeedOptions {
158
+ /** The daemon's socket. */
159
+ socketPath: string;
160
+ /** Which engine's frames to read. Default `node` (the frames with no `channel` field). */
161
+ channel?: string | undefined;
162
+ /** Wait between reconnect attempts. Default 2000. */
163
+ reconnectMs?: number | undefined;
164
+ /** @internal Test seam. */
165
+ connect?: typeof connectToDaemon | undefined;
166
+ /** @internal Test seam. */
167
+ setTimer?: ((fn: () => void, ms: number) => unknown) | undefined;
168
+ /** @internal Test seam. */
169
+ clearTimer?: ((handle: unknown) => void) | undefined;
170
+ }
171
+ /**
172
+ * Attaches read-only to a worker daemon's socket and keeps re-attaching until
173
+ * `stop()`. Never sends a frame.
174
+ *
175
+ * @typeParam E - The event type the reducer expects after `parseEvent`.
176
+ * @param options - The socket path and, to read an app's second engine, its channel id.
177
+ * @returns A feed in `attached` mode.
178
+ * @stability experimental
179
+ */
180
+ export declare function daemonAttachFeed<E = unknown>(options: DaemonAttachFeedOptions): DashboardFeed<E>;
181
+ /**
182
+ * The slice of an emitter {@link inProcessFeed} needs. Node's `EventEmitter`
183
+ * satisfies it.
184
+ *
185
+ * @stability experimental
186
+ */
187
+ export interface DashboardEmitter {
188
+ /** Adds a listener. (`any` because Node's EventEmitter declares `(...args: any[])`.) */
189
+ on(name: string, listener: (...args: any[]) => void): unknown;
190
+ /** Removes a listener. */
191
+ off(name: string, listener: (...args: any[]) => void): unknown;
192
+ }
193
+ /**
194
+ * Options of {@link inProcessFeed}.
195
+ *
196
+ * @stability experimental
197
+ */
198
+ export interface InProcessFeedOptions {
199
+ /** The engine's current state, delivered on start and after every event. */
200
+ snapshot(): unknown;
201
+ /** The event name on the emitter. Default `event`. */
202
+ eventName?: string | undefined;
203
+ /** An optional second event name carrying one log record or an array of them. */
204
+ logEventName?: string | undefined;
205
+ /** `false` delivers the snapshot once only, like the daemon does. Default `true`. */
206
+ refreshSnapshot?: boolean | undefined;
207
+ }
208
+ /**
209
+ * Feeds a dashboard from an engine running in this process: the snapshot on
210
+ * start, then every event the emitter fires. No socket, no reconnection.
211
+ *
212
+ * @typeParam E - The event type the emitter fires.
213
+ * @param emitter - The engine's emitter.
214
+ * @param options - How to read its snapshot and which event name to follow.
215
+ * @returns A feed in `embedded` mode.
216
+ * @stability experimental
217
+ */
218
+ export declare function inProcessFeed<E = unknown>(emitter: DashboardEmitter, options: InProcessFeedOptions): DashboardFeed<E>;
219
+ /**
220
+ * Options of {@link pollFeed}.
221
+ *
222
+ * @stability experimental
223
+ */
224
+ export interface PollFeedOptions {
225
+ /** Wait between the end of one poll and the start of the next. */
226
+ intervalMs: number;
227
+ /** @internal Test seam. */
228
+ setTimer?: ((fn: () => void, ms: number) => unknown) | undefined;
229
+ /** @internal Test seam. */
230
+ clearTimer?: ((handle: unknown) => void) | undefined;
231
+ }
232
+ /**
233
+ * Polls a server endpoint: one request at a time, the next one `intervalMs`
234
+ * after the last settled. `stop()` aborts the request in flight and clears
235
+ * the timer, so unmounting a screen never leaves either behind.
236
+ *
237
+ * A failed poll is reported as a disconnect with the message and polling
238
+ * continues; a poll that needs to say something specific (a 403) returns it
239
+ * as an event instead of throwing.
240
+ *
241
+ * @typeParam E - What one poll returns; the reducer folds it.
242
+ * @param fetch - Performs one poll. Must honour `signal`.
243
+ * @param options - The interval.
244
+ * @returns A feed in `poll` mode.
245
+ * @stability experimental
246
+ */
247
+ export declare function pollFeed<E>(fetch: (signal: AbortSignal) => Promise<E>, options: PollFeedOptions): DashboardFeed<E>;
248
+ /**
249
+ * Dependencies of {@link selectDashboardFeed}.
250
+ *
251
+ * @stability experimental
252
+ */
253
+ export interface SelectDashboardFeedDeps<E> {
254
+ /** The daemon's socket. */
255
+ socketPath: string;
256
+ /** Which engine's frames to read when attaching. Default `node`. */
257
+ channel?: string | undefined;
258
+ /** Whether a daemon is listening. A probe, never a command. */
259
+ isDaemonRunning(): Promise<boolean>;
260
+ /** Builds the in-process feed. Omit to never run embedded. */
261
+ embedded?: (() => DashboardFeed<E>) | undefined;
262
+ }
263
+ /**
264
+ * Attach when a daemon is running; otherwise run embedded when the caller
265
+ * offers it; otherwise attach anyway (the feed keeps looking and the screen
266
+ * says that no worker is running).
267
+ *
268
+ * @typeParam E - The event type.
269
+ * @param deps - The socket, the probe and the optional embedded builder.
270
+ * @returns The feed to hand to a {@link DashboardSource}.
271
+ * @stability experimental
272
+ */
273
+ export declare function selectDashboardFeed<E>(deps: SelectDashboardFeedDeps<E>): Promise<DashboardFeed<E>>;
274
+ //# sourceMappingURL=source.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../../src/engine/tui/dashboard/source.ts"],"names":[],"mappings":"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"}