@rikalabs/akter 0.1.0-alpha.0 → 0.1.0-alpha.3

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 (308) hide show
  1. package/CHANGELOG.md +46 -3
  2. package/README.md +2 -2
  3. package/dist/actor/definition.d.ts +13 -9
  4. package/dist/actor/descriptor.d.ts +2 -2
  5. package/dist/actor/descriptor.js +4 -4
  6. package/dist/client/calls.js +1 -1
  7. package/dist/client/index.d.ts +1 -1
  8. package/dist/client/index.js +1 -1
  9. package/dist/errors/actor.d.ts +12 -42
  10. package/dist/errors/actor.js +13 -42
  11. package/dist/index.d.ts +1 -1
  12. package/dist/index.js +1 -1
  13. package/dist/members/payload.d.ts +1 -1
  14. package/dist/protocol/inspection.d.ts +221 -1
  15. package/dist/protocol/inspection.js +151 -2
  16. package/dist/protocol/wire.d.ts +6 -49
  17. package/dist/protocol/wire.js +1 -10
  18. package/dist/runtime/actors.d.ts +3 -0
  19. package/dist/runtime/adoption/backfill.js +1 -1
  20. package/dist/runtime/adoption/enforce.js +2 -2
  21. package/dist/runtime/adoption/observe.js +1 -1
  22. package/dist/runtime/adoption/plan.d.ts +1 -1
  23. package/dist/runtime/adoption/startup.js +1 -1
  24. package/dist/runtime/adoption/status.d.ts +1 -1
  25. package/dist/runtime/app.d.ts +65 -0
  26. package/dist/runtime/app.js +38 -0
  27. package/dist/runtime/connections/holder.d.ts +11 -1
  28. package/dist/runtime/connections/holder.js +8 -4
  29. package/dist/runtime/connections/streams.d.ts +4 -4
  30. package/dist/runtime/content/store.js +15 -11
  31. package/dist/runtime/database/bounded.d.ts +4 -18
  32. package/dist/runtime/database/bounded.js +36 -22
  33. package/dist/runtime/database/coordination.d.ts +12 -3
  34. package/dist/runtime/database/coordination.js +29 -36
  35. package/dist/runtime/database/migrations.d.ts +61 -29
  36. package/dist/runtime/database/migrations.js +375 -139
  37. package/dist/runtime/database/replica.d.ts +4 -1
  38. package/dist/runtime/database/replica.js +4 -1
  39. package/dist/runtime/database/schema.d.ts +13 -0
  40. package/dist/runtime/database/schema.js +13 -0
  41. package/dist/runtime/database/shards.d.ts +31 -13
  42. package/dist/runtime/database/shards.js +38 -26
  43. package/dist/runtime/entity/register.d.ts +8 -1
  44. package/dist/runtime/entity/register.js +58 -7
  45. package/dist/runtime/fleet/checks.js +4 -4
  46. package/dist/runtime/fleet/maintainer.d.ts +1 -1
  47. package/dist/runtime/fleet/maintainer.js +1 -1
  48. package/dist/runtime/index.d.ts +2 -0
  49. package/dist/runtime/index.js +1 -0
  50. package/dist/runtime/inspector/layer.d.ts +20 -0
  51. package/dist/runtime/inspector/layer.js +224 -5
  52. package/dist/runtime/inspector/queries.d.ts +54 -8
  53. package/dist/runtime/inspector/queries.js +84 -15
  54. package/dist/runtime/layer.d.ts +48 -39
  55. package/dist/runtime/layer.js +124 -56
  56. package/dist/runtime/operators/audit.d.ts +3 -0
  57. package/dist/runtime/operators/audit.js +6 -2
  58. package/dist/runtime/operators/repair.js +30 -10
  59. package/dist/runtime/operators/seed.js +4 -2
  60. package/dist/runtime/payloads/versions.d.ts +4 -4
  61. package/dist/runtime/payloads/versions.js +24 -15
  62. package/dist/runtime/queries.js +4 -2
  63. package/dist/runtime/registration.d.ts +5 -2
  64. package/dist/runtime/registration.js +3 -3
  65. package/dist/runtime/runner.d.ts +12 -0
  66. package/dist/runtime/runner.js +12 -0
  67. package/dist/runtime/storage/codec.d.ts +19 -7
  68. package/dist/runtime/storage/codec.js +23 -7
  69. package/dist/runtime/storage/placements.d.ts +6 -1
  70. package/dist/runtime/storage/placements.js +98 -6
  71. package/dist/runtime/storage/retention.d.ts +6 -0
  72. package/dist/runtime/storage/retention.js +25 -13
  73. package/dist/runtime/subscriptions/relay.js +47 -44
  74. package/dist/runtime/subscriptions/storage.d.ts +3 -2
  75. package/dist/runtime/subscriptions/storage.js +9 -6
  76. package/dist/runtime/telemetry/live.d.ts +255 -0
  77. package/dist/runtime/telemetry/live.js +540 -0
  78. package/dist/runtime/telemetry/metrics.d.ts +2 -0
  79. package/dist/runtime/telemetry/metrics.js +4 -1
  80. package/dist/runtime/telemetry/sampler.js +33 -13
  81. package/dist/runtime/telemetry/spans.d.ts +1 -1
  82. package/dist/runtime/telemetry/spans.js +1 -1
  83. package/dist/runtime/topology/locks.d.ts +6 -3
  84. package/dist/runtime/topology/locks.js +27 -4
  85. package/dist/runtime/turn/execute.d.ts +2 -0
  86. package/dist/runtime/turn/execute.js +5 -2
  87. package/dist/runtime/turn/pipeline.d.ts +5 -12
  88. package/dist/runtime/turn/pipeline.js +11 -11
  89. package/dist/runtime/turn/relay.d.ts +13 -3
  90. package/dist/runtime/turn/relay.js +27 -14
  91. package/dist/runtime/turn/rows.js +4 -4
  92. package/dist/runtime/workflows/compatibility.d.ts +1 -1
  93. package/dist/runtime/workflows/compatibility.js +85 -31
  94. package/dist/runtime/workflows/engine.js +20 -17
  95. package/dist/serve/layer.js +3 -2
  96. package/dist/tables/owned.d.ts +1 -1
  97. package/dist/tables/owned.js +1 -1
  98. package/dist/testing/actor-test.d.ts +2 -24
  99. package/dist/testing/actor-test.js +1 -27
  100. package/dist/testing/index.d.ts +0 -12
  101. package/dist/testing/index.js +0 -6
  102. package/package.json +1 -1
  103. package/dist/runtime/database/neki/migrations.d.ts +0 -31
  104. package/dist/runtime/database/neki/migrations.js +0 -276
  105. package/dist/runtime/database/neki/session.d.ts +0 -23
  106. package/dist/runtime/database/neki/session.js +0 -31
  107. package/dist/testing/cluster.d.ts +0 -93
  108. package/dist/testing/cluster.js +0 -296
  109. package/dist/testing/conformance/access.d.ts +0 -5
  110. package/dist/testing/conformance/access.js +0 -531
  111. package/dist/testing/conformance/admission.d.ts +0 -11
  112. package/dist/testing/conformance/admission.js +0 -182
  113. package/dist/testing/conformance/adoption.d.ts +0 -2
  114. package/dist/testing/conformance/adoption.js +0 -1019
  115. package/dist/testing/conformance/assertions.d.ts +0 -202
  116. package/dist/testing/conformance/assertions.js +0 -849
  117. package/dist/testing/conformance/batches.d.ts +0 -41
  118. package/dist/testing/conformance/batches.js +0 -388
  119. package/dist/testing/conformance/blobs.d.ts +0 -14
  120. package/dist/testing/conformance/blobs.js +0 -405
  121. package/dist/testing/conformance/capacity.d.ts +0 -8
  122. package/dist/testing/conformance/capacity.js +0 -433
  123. package/dist/testing/conformance/client.d.ts +0 -5
  124. package/dist/testing/conformance/client.js +0 -719
  125. package/dist/testing/conformance/cold-serve.d.ts +0 -16
  126. package/dist/testing/conformance/cold-serve.js +0 -254
  127. package/dist/testing/conformance/connections/actors.d.ts +0 -1143
  128. package/dist/testing/conformance/connections/actors.js +0 -180
  129. package/dist/testing/conformance/connections/harness.d.ts +0 -1754
  130. package/dist/testing/conformance/connections/harness.js +0 -142
  131. package/dist/testing/conformance/connections/holders.d.ts +0 -4
  132. package/dist/testing/conformance/connections/holders.js +0 -165
  133. package/dist/testing/conformance/connections/lifecycle.d.ts +0 -4
  134. package/dist/testing/conformance/connections/lifecycle.js +0 -113
  135. package/dist/testing/conformance/connections/limits.d.ts +0 -4
  136. package/dist/testing/conformance/connections/limits.js +0 -127
  137. package/dist/testing/conformance/connections/reauthorization.d.ts +0 -4
  138. package/dist/testing/conformance/connections/reauthorization.js +0 -170
  139. package/dist/testing/conformance/connections/resync.d.ts +0 -4
  140. package/dist/testing/conformance/connections/resync.js +0 -360
  141. package/dist/testing/conformance/connections/takeover.d.ts +0 -4
  142. package/dist/testing/conformance/connections/takeover.js +0 -287
  143. package/dist/testing/conformance/connections.d.ts +0 -4
  144. package/dist/testing/conformance/connections.js +0 -15
  145. package/dist/testing/conformance/content-blobs.d.ts +0 -16
  146. package/dist/testing/conformance/content-blobs.js +0 -534
  147. package/dist/testing/conformance/counter.d.ts +0 -16
  148. package/dist/testing/conformance/counter.js +0 -813
  149. package/dist/testing/conformance/cron.d.ts +0 -5
  150. package/dist/testing/conformance/cron.js +0 -665
  151. package/dist/testing/conformance/drain.d.ts +0 -26
  152. package/dist/testing/conformance/drain.js +0 -540
  153. package/dist/testing/conformance/effect-control.d.ts +0 -38
  154. package/dist/testing/conformance/effect-control.js +0 -1059
  155. package/dist/testing/conformance/effects.d.ts +0 -23
  156. package/dist/testing/conformance/effects.js +0 -432
  157. package/dist/testing/conformance/events.d.ts +0 -28
  158. package/dist/testing/conformance/events.js +0 -335
  159. package/dist/testing/conformance/export.d.ts +0 -2
  160. package/dist/testing/conformance/export.js +0 -368
  161. package/dist/testing/conformance/fleet.d.ts +0 -444
  162. package/dist/testing/conformance/fleet.js +0 -1009
  163. package/dist/testing/conformance/groups.d.ts +0 -7
  164. package/dist/testing/conformance/groups.js +0 -353
  165. package/dist/testing/conformance/heap.d.ts +0 -3
  166. package/dist/testing/conformance/heap.js +0 -149
  167. package/dist/testing/conformance/http.d.ts +0 -2809
  168. package/dist/testing/conformance/http.js +0 -1234
  169. package/dist/testing/conformance/inspection-views.d.ts +0 -8
  170. package/dist/testing/conformance/inspection-views.js +0 -272
  171. package/dist/testing/conformance/inspector.d.ts +0 -7
  172. package/dist/testing/conformance/inspector.js +0 -650
  173. package/dist/testing/conformance/mint.d.ts +0 -58
  174. package/dist/testing/conformance/mint.js +0 -692
  175. package/dist/testing/conformance/multi-runner.d.ts +0 -8
  176. package/dist/testing/conformance/multi-runner.js +0 -403
  177. package/dist/testing/conformance/neki/plan.d.ts +0 -19
  178. package/dist/testing/conformance/neki/plan.js +0 -30
  179. package/dist/testing/conformance/observability.d.ts +0 -3
  180. package/dist/testing/conformance/observability.js +0 -343
  181. package/dist/testing/conformance/offline.d.ts +0 -4
  182. package/dist/testing/conformance/offline.js +0 -474
  183. package/dist/testing/conformance/operator-harness.d.ts +0 -57
  184. package/dist/testing/conformance/operator-harness.js +0 -78
  185. package/dist/testing/conformance/operator.d.ts +0 -3
  186. package/dist/testing/conformance/operator.js +0 -379
  187. package/dist/testing/conformance/outbox-cross-shard.d.ts +0 -14
  188. package/dist/testing/conformance/outbox-cross-shard.js +0 -160
  189. package/dist/testing/conformance/outbox.d.ts +0 -36
  190. package/dist/testing/conformance/outbox.js +0 -437
  191. package/dist/testing/conformance/payload-migrations.d.ts +0 -3
  192. package/dist/testing/conformance/payload-migrations.js +0 -612
  193. package/dist/testing/conformance/pipeline.d.ts +0 -3
  194. package/dist/testing/conformance/pipeline.js +0 -1040
  195. package/dist/testing/conformance/placement.d.ts +0 -22
  196. package/dist/testing/conformance/placement.js +0 -539
  197. package/dist/testing/conformance/platform.d.ts +0 -40
  198. package/dist/testing/conformance/platform.js +0 -101
  199. package/dist/testing/conformance/progress.d.ts +0 -39
  200. package/dist/testing/conformance/progress.js +0 -666
  201. package/dist/testing/conformance/properties.d.ts +0 -6
  202. package/dist/testing/conformance/properties.js +0 -295
  203. package/dist/testing/conformance/protocols.d.ts +0 -4
  204. package/dist/testing/conformance/protocols.js +0 -618
  205. package/dist/testing/conformance/provider/advertise.d.ts +0 -21
  206. package/dist/testing/conformance/provider/advertise.js +0 -44
  207. package/dist/testing/conformance/read-your-writes.d.ts +0 -20
  208. package/dist/testing/conformance/read-your-writes.js +0 -192
  209. package/dist/testing/conformance/reducers.d.ts +0 -8
  210. package/dist/testing/conformance/reducers.js +0 -258
  211. package/dist/testing/conformance/relay.d.ts +0 -42
  212. package/dist/testing/conformance/relay.js +0 -1115
  213. package/dist/testing/conformance/restore.d.ts +0 -43
  214. package/dist/testing/conformance/restore.js +0 -341
  215. package/dist/testing/conformance/retention.d.ts +0 -14
  216. package/dist/testing/conformance/retention.js +0 -463
  217. package/dist/testing/conformance/rls.d.ts +0 -24
  218. package/dist/testing/conformance/rls.js +0 -576
  219. package/dist/testing/conformance/simulation.d.ts +0 -31
  220. package/dist/testing/conformance/simulation.js +0 -167
  221. package/dist/testing/conformance/single-shard.d.ts +0 -2
  222. package/dist/testing/conformance/single-shard.js +0 -125
  223. package/dist/testing/conformance/singleton.d.ts +0 -3
  224. package/dist/testing/conformance/singleton.js +0 -293
  225. package/dist/testing/conformance/statements.d.ts +0 -60
  226. package/dist/testing/conformance/statements.js +0 -108
  227. package/dist/testing/conformance/streams.d.ts +0 -7
  228. package/dist/testing/conformance/streams.js +0 -280
  229. package/dist/testing/conformance/subscriptions/access.d.ts +0 -4
  230. package/dist/testing/conformance/subscriptions/access.js +0 -98
  231. package/dist/testing/conformance/subscriptions/actors.d.ts +0 -4910
  232. package/dist/testing/conformance/subscriptions/actors.js +0 -372
  233. package/dist/testing/conformance/subscriptions/cluster.d.ts +0 -4
  234. package/dist/testing/conformance/subscriptions/cluster.js +0 -89
  235. package/dist/testing/conformance/subscriptions/delivery.d.ts +0 -4
  236. package/dist/testing/conformance/subscriptions/delivery.js +0 -253
  237. package/dist/testing/conformance/subscriptions/deploys.d.ts +0 -4
  238. package/dist/testing/conformance/subscriptions/deploys.js +0 -162
  239. package/dist/testing/conformance/subscriptions/epochs.d.ts +0 -4
  240. package/dist/testing/conformance/subscriptions/epochs.js +0 -169
  241. package/dist/testing/conformance/subscriptions/failures.d.ts +0 -4
  242. package/dist/testing/conformance/subscriptions/failures.js +0 -108
  243. package/dist/testing/conformance/subscriptions/feeds.d.ts +0 -4
  244. package/dist/testing/conformance/subscriptions/feeds.js +0 -218
  245. package/dist/testing/conformance/subscriptions/harness.d.ts +0 -124
  246. package/dist/testing/conformance/subscriptions/harness.js +0 -143
  247. package/dist/testing/conformance/subscriptions/operator.d.ts +0 -4
  248. package/dist/testing/conformance/subscriptions/operator.js +0 -128
  249. package/dist/testing/conformance/subscriptions/retention.d.ts +0 -4
  250. package/dist/testing/conformance/subscriptions/retention.js +0 -288
  251. package/dist/testing/conformance/subscriptions/routing.d.ts +0 -4
  252. package/dist/testing/conformance/subscriptions/routing.js +0 -179
  253. package/dist/testing/conformance/subscriptions.d.ts +0 -4
  254. package/dist/testing/conformance/subscriptions.js +0 -19
  255. package/dist/testing/conformance/tables.d.ts +0 -125
  256. package/dist/testing/conformance/tables.js +0 -664
  257. package/dist/testing/conformance/transports/actors.d.ts +0 -1907
  258. package/dist/testing/conformance/transports/actors.js +0 -163
  259. package/dist/testing/conformance/transports/client.d.ts +0 -3
  260. package/dist/testing/conformance/transports/client.js +0 -237
  261. package/dist/testing/conformance/transports/feeds.d.ts +0 -3
  262. package/dist/testing/conformance/transports/feeds.js +0 -232
  263. package/dist/testing/conformance/transports/harness.d.ts +0 -93
  264. package/dist/testing/conformance/transports/harness.js +0 -84
  265. package/dist/testing/conformance/transports/streams.d.ts +0 -3
  266. package/dist/testing/conformance/transports/streams.js +0 -96
  267. package/dist/testing/conformance/transports/websocket.d.ts +0 -3
  268. package/dist/testing/conformance/transports/websocket.js +0 -384
  269. package/dist/testing/conformance/transports/wire.d.ts +0 -141
  270. package/dist/testing/conformance/transports/wire.js +0 -204
  271. package/dist/testing/conformance/transports.d.ts +0 -3
  272. package/dist/testing/conformance/transports.js +0 -11
  273. package/dist/testing/conformance/watch.d.ts +0 -59
  274. package/dist/testing/conformance/watch.js +0 -879
  275. package/dist/testing/conformance/workflow-engine.d.ts +0 -97
  276. package/dist/testing/conformance/workflow-engine.js +0 -253
  277. package/dist/testing/conformance/workflow-versions.d.ts +0 -3
  278. package/dist/testing/conformance/workflow-versions.js +0 -545
  279. package/dist/testing/conformance/workflows/access.d.ts +0 -4
  280. package/dist/testing/conformance/workflows/access.js +0 -147
  281. package/dist/testing/conformance/workflows/actors.d.ts +0 -2317
  282. package/dist/testing/conformance/workflows/actors.js +0 -305
  283. package/dist/testing/conformance/workflows/basics.d.ts +0 -4
  284. package/dist/testing/conformance/workflows/basics.js +0 -144
  285. package/dist/testing/conformance/workflows/engine.d.ts +0 -4
  286. package/dist/testing/conformance/workflows/engine.js +0 -80
  287. package/dist/testing/conformance/workflows/guards.d.ts +0 -4
  288. package/dist/testing/conformance/workflows/guards.js +0 -172
  289. package/dist/testing/conformance/workflows/harness.d.ts +0 -14
  290. package/dist/testing/conformance/workflows/harness.js +0 -44
  291. package/dist/testing/conformance/workflows/recovery.d.ts +0 -4
  292. package/dist/testing/conformance/workflows/recovery.js +0 -181
  293. package/dist/testing/conformance/workflows/starts.d.ts +0 -4
  294. package/dist/testing/conformance/workflows/starts.js +0 -57
  295. package/dist/testing/conformance/workflows/suspension.d.ts +0 -4
  296. package/dist/testing/conformance/workflows/suspension.js +0 -106
  297. package/dist/testing/conformance/workflows/waits.d.ts +0 -4
  298. package/dist/testing/conformance/workflows/waits.js +0 -284
  299. package/dist/testing/conformance/workflows.d.ts +0 -4
  300. package/dist/testing/conformance/workflows.js +0 -19
  301. package/dist/testing/conformance.d.ts +0 -330
  302. package/dist/testing/conformance.js +0 -364
  303. package/dist/testing/foundation.d.ts +0 -41
  304. package/dist/testing/foundation.js +0 -517
  305. package/dist/testing/simulate-cluster.d.ts +0 -112
  306. package/dist/testing/simulate-cluster.js +0 -257
  307. package/dist/testing/simulate.d.ts +0 -90
  308. package/dist/testing/simulate.js +0 -127
@@ -0,0 +1,255 @@
1
+ import { Context, Data, Effect, Stream } from "effect";
2
+ /** How far back an activity or latency read reaches, ending now. */
3
+ export type LiveWindow = "1h" | "24h" | "7d";
4
+ /** The most tenants one runner records turns for; past it the least recently active is dropped. */
5
+ export declare const MAX_RECORDED_TENANTS = 64;
6
+ /** The most command streams one tenant may hold open on one runner. */
7
+ export declare const MAX_TENANT_STREAMS = 4;
8
+ /** The most command streams one runner holds open. */
9
+ export declare const MAX_STREAMS = 64;
10
+ /** The entries a watched tenant's ring keeps for a reconnecting stream. */
11
+ export declare const STREAM_RING = 256;
12
+ /** The entries one stream buffers before it ends with a gap. */
13
+ export declare const STREAM_BUFFER = 1024;
14
+ /** How long a tenant keeps recording stream entries after its last stream ended, so a reconnect resumes. */
15
+ export declare const STREAM_GRACE_MS = 60000;
16
+ /** The longest payload preview, in characters. */
17
+ export declare const PREVIEW_CHARACTERS = 256;
18
+ /** The longest encoded payload or failure a preview or error tag is read from; a longer one has none. */
19
+ export declare const PREVIEW_INPUT_CHARACTERS = 16384;
20
+ /**
21
+ * A short, redacted rendering of a payload encoded as `{ "value": ... }`,
22
+ * null when it carries none or is longer than `PREVIEW_INPUT_CHARACTERS`. A
23
+ * top-level string is never shown, since nothing names what it holds. It is
24
+ * built on the runner, so the payload itself never leaves it.
25
+ */
26
+ export declare const payloadPreview: (encoded: string) => string | null;
27
+ /** One committed command as a stream carries it; `id` is the stream's epoch and sequence. */
28
+ export interface StreamEntry {
29
+ readonly id: string;
30
+ readonly seq: number;
31
+ readonly commandId: string;
32
+ readonly atMs: number;
33
+ readonly durationMs: number;
34
+ readonly actorType: string;
35
+ readonly actorId: string;
36
+ readonly command: string;
37
+ readonly callerKey: string;
38
+ readonly failed: boolean;
39
+ readonly errorTag: string | null;
40
+ readonly payloadPreview: string | null;
41
+ }
42
+ /** What a stream's subscriber receives: a committed command, or a gap after which entries are missing. */
43
+ export type StreamMessage = Data.TaggedEnum<{
44
+ command: {
45
+ readonly entry: StreamEntry;
46
+ };
47
+ gap: {};
48
+ }>;
49
+ export declare const StreamMessage: {
50
+ readonly $is: <Tag extends "command" | "gap">(tag: Tag) => (u: unknown) => u is Extract<{
51
+ readonly _tag: "command";
52
+ readonly entry: StreamEntry;
53
+ }, {
54
+ readonly _tag: Tag;
55
+ }> | Extract<{
56
+ readonly _tag: "gap";
57
+ }, {
58
+ readonly _tag: Tag;
59
+ }>;
60
+ readonly $match: {
61
+ <Cases extends { readonly [Tag in "command" | "gap"]: (args: Extract<{
62
+ readonly _tag: "command";
63
+ readonly entry: StreamEntry;
64
+ } | {
65
+ readonly _tag: "gap";
66
+ }, {
67
+ readonly _tag: Tag;
68
+ }>) => any; }>(cases: Cases): (value: {
69
+ readonly _tag: "command";
70
+ readonly entry: StreamEntry;
71
+ } | {
72
+ readonly _tag: "gap";
73
+ }) => import("effect/Unify").Unify<ReturnType<Cases["command" | "gap"]>>;
74
+ <Cases extends { readonly [Tag in "command" | "gap"]: (args: Extract<{
75
+ readonly _tag: "command";
76
+ readonly entry: StreamEntry;
77
+ } | {
78
+ readonly _tag: "gap";
79
+ }, {
80
+ readonly _tag: Tag;
81
+ }>) => any; }>(value: {
82
+ readonly _tag: "command";
83
+ readonly entry: StreamEntry;
84
+ } | {
85
+ readonly _tag: "gap";
86
+ }, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["command" | "gap"]>>;
87
+ };
88
+ readonly command: Data.TaggedEnum.ConstructorFrom<{
89
+ readonly _tag: "command";
90
+ readonly entry: StreamEntry;
91
+ }, "_tag">;
92
+ readonly gap: Data.TaggedEnum.ConstructorFrom<{
93
+ readonly _tag: "gap";
94
+ }, "_tag">;
95
+ };
96
+ /** Which committed commands a stream sends: one actor type, failures or successes, or all. */
97
+ export interface StreamFilter {
98
+ readonly actorType?: string | undefined;
99
+ readonly failed?: boolean | undefined;
100
+ }
101
+ /** The fields of a committed command its stream entry is built from, read only when the tenant is watched. */
102
+ export interface StreamSource {
103
+ readonly commandId: string;
104
+ readonly atMs: number;
105
+ readonly durationMs: number;
106
+ readonly actorType: string;
107
+ readonly actorId: string;
108
+ readonly command: string;
109
+ readonly callerKey: string;
110
+ readonly failed: boolean;
111
+ /** The command's encoded payload. */
112
+ readonly payload: string;
113
+ /** The declared failure's encoded value, when the command failed. */
114
+ readonly failure: string | undefined;
115
+ }
116
+ /** Activity over a window: commands per second at each covered slot, oldest first, and each command's volume. */
117
+ export interface Activity {
118
+ readonly since: number;
119
+ readonly points: ReadonlyArray<{
120
+ readonly atMs: number;
121
+ readonly perSecond: number;
122
+ }>;
123
+ readonly commands: ReadonlyArray<{
124
+ readonly command: string;
125
+ readonly count: number;
126
+ readonly perSecond: number;
127
+ }>;
128
+ }
129
+ /** Turn latency over a window: counts per duration bound (the last unbounded) and quantiles. */
130
+ export interface Latency {
131
+ readonly since: number;
132
+ readonly count: number;
133
+ readonly buckets: ReadonlyArray<{
134
+ readonly upToMs: number | null;
135
+ readonly count: number;
136
+ }>;
137
+ readonly p50Ms: number | null;
138
+ readonly p95Ms: number | null;
139
+ readonly p99Ms: number | null;
140
+ }
141
+ /** A type's recent rate and quantiles, or all types' together. */
142
+ export interface Rates {
143
+ /** Commands per second over the current minute and the four before it, from `since`. */
144
+ readonly perSecond: number;
145
+ /** The median turn time over the last hour, from `since`; null with no turn. */
146
+ readonly p50Ms: number | null;
147
+ /** The 99th percentile turn time over the last hour, from `since`; null with no turn. */
148
+ readonly p99Ms: number | null;
149
+ }
150
+ /**
151
+ * Committed turns of this runner, by tenant and actor type, in minute slots
152
+ * for an hour and hour slots for 7 days, and the live command stream. Every
153
+ * read is one tenant's. Nothing here survives the process. A tenant costs a
154
+ * few typed arrays per actor type it ran (about 20 KiB, and under 1 KiB per
155
+ * command), and at most `MAX_RECORDED_TENANTS` are kept.
156
+ */
157
+ export declare const liveRecorder: (options: {
158
+ readonly startedAtMs: number;
159
+ readonly epoch: string;
160
+ }) => {
161
+ startedAtMs: number;
162
+ /** How many command streams this runner holds open now. */
163
+ streams: () => number;
164
+ /** How many tenants this runner holds a stream ring for now. */
165
+ watched: () => number;
166
+ /** Whether a new stream of `tenant` would be refused now. */
167
+ full: (tenant: string) => boolean;
168
+ /**
169
+ * A window's points are the slots it spans whose time this runner
170
+ * observed: a slot before `since` has none, and a slot's rate divides its
171
+ * count by the seconds of it observed, so the current slot and the one
172
+ * `since` falls in are not diluted.
173
+ */
174
+ activity: (tenant: string, actorType: string | undefined, window: LiveWindow, nowMs: number) => Activity | undefined;
175
+ latency: (tenant: string, actorType: string | undefined, window: LiveWindow, nowMs: number) => Latency | undefined;
176
+ rates: (tenant: string, actorType: string | undefined, nowMs: number) => Rates | undefined;
177
+ /** The actor types `tenant` committed a turn of on this runner. */
178
+ actorTypes: (tenant: string) => string[];
179
+ /**
180
+ * Counts one command that wrote a receipt. `durationMs` is its turn's
181
+ * transaction time; `nowMs` is the runner's clock when its batch was
182
+ * published, which places it in its minute and hour.
183
+ */
184
+ record: (tenant: string, actorType: string, command: string, durationMs: number, nowMs: number) => void;
185
+ /**
186
+ * Hands one committed command to the tenant's streams. Unless the tenant
187
+ * has a stream open, or had one within `STREAM_GRACE_MS`, this is one map
188
+ * lookup and `source` is never called. The payload preview is built only
189
+ * when an open stream takes the command, so the ring kept for a reconnect
190
+ * during the grace holds none.
191
+ */
192
+ publish: (tenant: string, nowMs: number, source: () => StreamSource) => void;
193
+ /**
194
+ * One of `tenant`'s command streams. Its slot is taken only when the
195
+ * stream starts and given back when it ends however it ends, so a request
196
+ * interrupted before its body starts holds none. `after` is the id of the
197
+ * last entry a previous stream sent: entries the ring still holds after it
198
+ * are sent first, and an id from another epoch, or one the ring no longer
199
+ * reaches, sends a gap and ends. A stream that falls `STREAM_BUFFER`
200
+ * entries behind ends with a gap, and so does one opened when this runner
201
+ * already holds `MAX_TENANT_STREAMS` for the tenant or `MAX_STREAMS` in all.
202
+ */
203
+ subscribe: (tenant: string, filter: StreamFilter, after: string | undefined) => Stream.Stream<StreamMessage>;
204
+ };
205
+ /** The recorder `liveRecorder` builds. */
206
+ export type LiveRecorder = ReturnType<typeof liveRecorder>;
207
+ /** One activation resident on this runner. */
208
+ export interface Resident {
209
+ readonly actorType: string;
210
+ readonly actorId: string;
211
+ /** Commands waiting in its mailbox, not yet taken into a batch. */
212
+ readonly mailbox: number;
213
+ }
214
+ /** One open connection this runner holds or serves. */
215
+ export interface OpenConnection {
216
+ readonly actorType: string;
217
+ readonly actorId: string;
218
+ readonly kind: "socket" | "feed" | "watch" | "stream";
219
+ /** A feed's event names; empty for any other kind. */
220
+ readonly events: ReadonlyArray<string>;
221
+ }
222
+ /** One cron entry a registered actor type declares. */
223
+ export interface DeclaredSchedule {
224
+ readonly actorType: string;
225
+ readonly key: string;
226
+ readonly command: string;
227
+ }
228
+ declare const LiveRuntime_base: Context.ServiceClass<LiveRuntime, "@rikalabs/akter/runtime/telemetry/live/LiveRuntime", {
229
+ /** The recorder, or undefined until `enable` ran. */
230
+ readonly recorder: () => LiveRecorder | undefined;
231
+ /** Builds the recorder on first use and returns it; it counts from then on. */
232
+ readonly enable: Effect.Effect<LiveRecorder>;
233
+ readonly resident: (tenant: string) => ReadonlyArray<Resident>;
234
+ readonly connections: (tenant: string) => ReadonlyArray<OpenConnection>;
235
+ readonly schedules: () => ReadonlyArray<DeclaredSchedule>;
236
+ /** Other runners the cluster's runner storage lists, healthy or not; undefined when unknown. */
237
+ readonly peers: Effect.Effect<number | undefined>;
238
+ /** Counts one served SSE stream member until the returned release runs. */
239
+ readonly streamOpened: (ref: {
240
+ readonly tenant: string;
241
+ readonly actor: string;
242
+ readonly id: string;
243
+ }) => () => void;
244
+ }>;
245
+ /**
246
+ * What this runner knows only in memory, for the inspector's live reads:
247
+ * its recorder, the activations resident on it and their mailboxes, the
248
+ * connections it holds, the cron entries it registers, and how many other
249
+ * runners the cluster lists. Each read names one tenant. The recorder exists
250
+ * only once `enable` ran, which `Inspector.serve` does when it is mounted, so
251
+ * a runtime nobody inspects counts nothing.
252
+ */
253
+ export declare class LiveRuntime extends LiveRuntime_base {
254
+ }
255
+ export {};