@ai-ecoverse/slicc-agent 7.30.3 → 7.32.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (102) hide show
  1. package/README.md +19 -7
  2. package/dist/agent.js +4 -0
  3. package/dist/agent.js.map +2 -2
  4. package/dist/approvals/policy.js +27 -5
  5. package/dist/approvals/policy.js.map +2 -2
  6. package/dist/approvals/published.js +18 -0
  7. package/dist/approvals/published.js.map +7 -0
  8. package/dist/approvals/record.js +4 -1
  9. package/dist/approvals/record.js.map +2 -2
  10. package/dist/approvals/run-licks.js +137 -0
  11. package/dist/approvals/run-licks.js.map +7 -0
  12. package/dist/approvals/run-procs.js +127 -0
  13. package/dist/approvals/run-procs.js.map +7 -0
  14. package/dist/approvals/run.js +468 -0
  15. package/dist/approvals/run.js.map +7 -0
  16. package/dist/approvals/runnable.js +125 -0
  17. package/dist/approvals/runnable.js.map +7 -0
  18. package/dist/approvals/sudo.js +29 -1
  19. package/dist/approvals/sudo.js.map +2 -2
  20. package/dist/client.js +1 -0
  21. package/dist/client.js.map +2 -2
  22. package/dist/control.js +7 -1
  23. package/dist/control.js.map +2 -2
  24. package/dist/freezer/index.js +4 -1
  25. package/dist/freezer/index.js.map +2 -2
  26. package/dist/guests/attribution.js +4 -0
  27. package/dist/guests/attribution.js.map +2 -2
  28. package/dist/guests/guard.js +28 -3
  29. package/dist/guests/guard.js.map +2 -2
  30. package/dist/guests/view.js +20 -4
  31. package/dist/guests/view.js.map +2 -2
  32. package/dist/host.js +69 -16
  33. package/dist/host.js.map +2 -2
  34. package/dist/images/markers.js +2 -7
  35. package/dist/images/markers.js.map +2 -2
  36. package/dist/index.js +14 -0
  37. package/dist/index.js.map +2 -2
  38. package/dist/intent/index.js +75 -0
  39. package/dist/intent/index.js.map +7 -0
  40. package/dist/intent/said.js +26 -0
  41. package/dist/intent/said.js.map +7 -0
  42. package/dist/kernel/with-exec.js +13 -0
  43. package/dist/kernel/with-exec.js.map +7 -0
  44. package/dist/licks/extension.js +1 -0
  45. package/dist/licks/extension.js.map +2 -2
  46. package/dist/licks/lick.js +1 -0
  47. package/dist/licks/lick.js.map +2 -2
  48. package/dist/main.js +15 -6
  49. package/dist/main.js.map +2 -2
  50. package/dist/services.js +7 -2
  51. package/dist/services.js.map +2 -2
  52. package/dist/settings.js +1 -0
  53. package/dist/settings.js.map +2 -2
  54. package/dist/spectrum/agent-port.js +13 -2
  55. package/dist/spectrum/agent-port.js.map +2 -2
  56. package/dist/spectrum/approvals-port.js +69 -0
  57. package/dist/spectrum/approvals-port.js.map +2 -2
  58. package/dist/spectrum/messages.js +35 -16
  59. package/dist/spectrum/messages.js.map +2 -2
  60. package/dist/spectrum/monitor-port.js +2 -1
  61. package/dist/spectrum/monitor-port.js.map +2 -2
  62. package/dist/spectrum/tool-title.js +11 -8
  63. package/dist/spectrum/tool-title.js.map +2 -2
  64. package/dist/titles/cluster.js +15 -4
  65. package/dist/titles/cluster.js.map +2 -2
  66. package/dist/titles/generate.js +6 -2
  67. package/dist/titles/generate.js.map +2 -2
  68. package/dist/titles/labels.js +2 -7
  69. package/dist/titles/labels.js.map +2 -2
  70. package/dist/titles/shown.js +6 -0
  71. package/dist/titles/shown.js.map +2 -2
  72. package/dist/types/agent.d.ts +2 -0
  73. package/dist/types/approvals/policy.d.ts +10 -1
  74. package/dist/types/approvals/published.d.ts +3 -0
  75. package/dist/types/approvals/record.d.ts +44 -1
  76. package/dist/types/approvals/run-licks.d.ts +18 -0
  77. package/dist/types/approvals/run-procs.d.ts +40 -0
  78. package/dist/types/approvals/run.d.ts +60 -0
  79. package/dist/types/approvals/runnable.d.ts +55 -0
  80. package/dist/types/approvals/sudo.d.ts +3 -1
  81. package/dist/types/client.d.ts +2 -0
  82. package/dist/types/guests/attribution.d.ts +5 -0
  83. package/dist/types/guests/guard.d.ts +1 -1
  84. package/dist/types/host.d.ts +10 -0
  85. package/dist/types/index.d.ts +4 -1
  86. package/dist/types/intent/index.d.ts +7 -0
  87. package/dist/types/intent/said.d.ts +4 -0
  88. package/dist/types/kernel/client.d.ts +35 -0
  89. package/dist/types/kernel/with-exec.d.ts +2 -0
  90. package/dist/types/licks/lick.d.ts +1 -1
  91. package/dist/types/licks/triage.d.ts +1 -1
  92. package/dist/types/main.d.ts +2 -1
  93. package/dist/types/services.d.ts +8 -2
  94. package/dist/types/settings.d.ts +1 -0
  95. package/dist/types/spectrum/approvals-port.d.ts +10 -2
  96. package/dist/types/spectrum/messages.d.ts +3 -2
  97. package/dist/types/spectrum/tool-title.d.ts +1 -1
  98. package/dist/types/titles/cluster.d.ts +1 -0
  99. package/dist/types/titles/generate.d.ts +3 -2
  100. package/dist/types/titles/labels.d.ts +1 -1
  101. package/dist/types/titles/shown.d.ts +1 -0
  102. package/package.json +3 -3
@@ -0,0 +1,468 @@
1
+ import { BACKGROUND_CONTEXT } from "@earendil-works/chord/context";
2
+ import {
3
+ defineExtension,
4
+ defineTask
5
+ } from "@earendil-works/pi-durable";
6
+ import {
7
+ ApprovalsDoc,
8
+ MAX_DELAY,
9
+ runLive
10
+ } from "./record.js";
11
+ import { endLick, KEEP_HOURS, MIB, startLick } from "./run-licks.js";
12
+ import {
13
+ aborted,
14
+ adoptable,
15
+ gone,
16
+ outputOf,
17
+ outputSize,
18
+ removeOutput,
19
+ runTag,
20
+ signalTree,
21
+ sleep,
22
+ tagged,
23
+ watchExits
24
+ } from "./run-procs.js";
25
+ import { RUN_REASONS, runnable } from "./runnable.js";
26
+ import { clock, duration, endLick as endLick2, startLick as startLick2 } from "./run-licks.js";
27
+ import { outputOf as outputOf2, RUN_TAG, RUNS_DIR, runTag as runTag2 } from "./run-procs.js";
28
+ const SUDO_RUN_TASK = "slicc.sudo-run";
29
+ const SUDO_RUNS = "slicc-sudo-runs";
30
+ const POLL_MS = 5e3;
31
+ const KILL_MS = 5e3;
32
+ const ADOPT_MS = 250;
33
+ const ADOPT_TRIES = 5;
34
+ const OUTPUT_CAP = 32 * MIB;
35
+ const KEEP_MS = KEEP_HOURS * 36e5;
36
+ const RUN_ERRORS = {
37
+ interrupted: "interrupted before it started",
38
+ reloaded: "the page reloaded while it ran",
39
+ idle: "This request isn't running.",
40
+ gone: "Its processes are already gone.",
41
+ unseen: "The kernel's process list isn't available, so it can't be stopped."
42
+ };
43
+ const DONE = { status: "terminal", outcome: { status: "completed", result: null } };
44
+ const next = (checkpoint) => ({ status: "running", checkpoint });
45
+ const sudoIn = (items, id) => {
46
+ const item = items?.find((entry) => entry.id === id);
47
+ return item?.kind === "sudo" ? item : void 0;
48
+ };
49
+ async function itemOf(runtime, id, context) {
50
+ return sudoIn((await runtime.snapshot(ApprovalsDoc, context))?.items, id);
51
+ }
52
+ async function claimed(runtime, id, context) {
53
+ const item = await itemOf(runtime, id, context);
54
+ if (item?.replay && item.run?.state === "starting") return item;
55
+ await runtime.commit(async () => DONE, context);
56
+ return void 0;
57
+ }
58
+ function edit(runtime, id, change, then, context) {
59
+ return runtime.commit(async (tx) => {
60
+ const item = sudoIn((await tx.doc(ApprovalsDoc)).items, id);
61
+ if (item?.run) change(item.run, item);
62
+ return then;
63
+ }, context);
64
+ }
65
+ const ended = (run, state, at, error) => {
66
+ run.state = state;
67
+ run.endedAt = at;
68
+ if (error) run.error = error;
69
+ };
70
+ function messageOf(error) {
71
+ if (error?.code === "ENOSYS") return RUN_REASONS.kernel;
72
+ const text = error instanceof Error ? error.message : String(error);
73
+ return text.trim() || "the kernel refused to run it";
74
+ }
75
+ async function tell(host, made) {
76
+ const event = await made.catch(() => void 0);
77
+ if (event) await host.licks?.deliver(event, BACKGROUND_CONTEXT).catch(() => void 0);
78
+ }
79
+ const stopTree = (host, id) => signalTree(host.kernel, runTag(id), host.killMs ?? KILL_MS);
80
+ const nowOf = (host) => host.now?.() ?? Date.now();
81
+ const knownBoots = (a, b) => a !== null && b !== null;
82
+ function memory() {
83
+ const calling = /* @__PURE__ */ new Set();
84
+ const ends = /* @__PURE__ */ new Map();
85
+ const watchers = /* @__PURE__ */ new Map();
86
+ return {
87
+ calling,
88
+ ends,
89
+ watcher(host, id) {
90
+ const found = watchers.get(id) ?? watchExits(host.kernel, runTag(id));
91
+ watchers.set(id, found);
92
+ return found;
93
+ },
94
+ async release(id) {
95
+ const found = watchers.get(id);
96
+ watchers.delete(id);
97
+ ends.delete(id);
98
+ calling.delete(id);
99
+ (await found)?.close();
100
+ }
101
+ };
102
+ }
103
+ function starting(lookup, mem) {
104
+ const { calling, ends, watcher, release } = mem;
105
+ const now = nowOf;
106
+ async function prepare(id, runtime, context) {
107
+ const host = await lookup();
108
+ const item = await claimed(runtime, id, context);
109
+ if (!item) return;
110
+ const place = await outputOf(host.kernel, item.replay.user, id, context.abortSignal).catch(
111
+ (error) => {
112
+ if (context.abortSignal?.aborted) throw error;
113
+ return messageOf(error);
114
+ }
115
+ );
116
+ if (typeof place === "string")
117
+ return edit(runtime, id, (kept) => ended(kept, "failed", now(host), place), DONE, context);
118
+ return edit(
119
+ runtime,
120
+ id,
121
+ (kept) => Object.assign(kept, place),
122
+ next({ phase: "call", server: host.server, boot: host.boot }),
123
+ context
124
+ );
125
+ }
126
+ async function adopt(id, boot, runtime, context) {
127
+ const host = await lookup();
128
+ const item = await itemOf(runtime, id, context);
129
+ const target = item?.replay?.target ?? "root";
130
+ let lead = await adoptable(host.kernel, runTag(id), target);
131
+ for (let attempt = 0; !lead && attempt < ADOPT_TRIES - 1; attempt++) {
132
+ await sleep((host.adoptMs ?? ADOPT_MS) * 2 ** attempt, context.abortSignal);
133
+ lead = await adoptable(host.kernel, runTag(id), target);
134
+ }
135
+ if (!lead)
136
+ return edit(
137
+ runtime,
138
+ id,
139
+ (kept) => ended(kept, "failed", now(host), RUN_ERRORS.interrupted),
140
+ DONE,
141
+ context
142
+ );
143
+ const pgid = lead.pgid ?? lead.pid;
144
+ return edit(
145
+ runtime,
146
+ id,
147
+ (kept) => Object.assign(kept, { state: "running", pid: lead.pid, pgid }),
148
+ next({ phase: "started", pid: lead.pid, pgid, boot }),
149
+ context
150
+ );
151
+ }
152
+ async function call(id, at, runtime, context) {
153
+ const host = await lookup();
154
+ if (at.server !== host.server || calling.has(id)) return adopt(id, at.boot, runtime, context);
155
+ calling.add(id);
156
+ const item = await claimed(runtime, id, context);
157
+ if (!item) return;
158
+ const { run } = item;
159
+ if (run.stopBy)
160
+ return edit(runtime, id, (kept) => ended(kept, "stopped", now(host)), DONE, context);
161
+ await watcher(host, id);
162
+ let started;
163
+ try {
164
+ if (!host.kernel.sudoRun)
165
+ throw Object.assign(new Error(RUN_REASONS.kernel), { code: "ENOSYS" });
166
+ const asked = host.kernel.sudoRun(item.replay, {
167
+ stdout: run.stdout,
168
+ stderr: run.stderr,
169
+ tag: runTag(id)
170
+ });
171
+ started = await Promise.race([asked, aborted(context.abortSignal)]);
172
+ } catch (error) {
173
+ await release(id);
174
+ if (context.abortSignal?.aborted) throw error;
175
+ const why = messageOf(error);
176
+ return edit(runtime, id, (kept) => ended(kept, "failed", now(host), why), DONE, context);
177
+ }
178
+ ends.set(id, started.ended);
179
+ started.ended.catch(() => void 0);
180
+ const { pid, pgid } = started;
181
+ return edit(
182
+ runtime,
183
+ id,
184
+ (kept) => Object.assign(kept, { state: "running", pid, pgid }),
185
+ next({ phase: "started", pid, pgid, boot: at.boot }),
186
+ context
187
+ );
188
+ }
189
+ async function begun(id, at, runtime, context) {
190
+ const host = await lookup();
191
+ const item = await itemOf(runtime, id, context);
192
+ if (item?.run) {
193
+ await tell(host, startLick(host, item));
194
+ if (item.run.stopBy) await stopTree(host, id);
195
+ }
196
+ const { pid, pgid, boot } = at;
197
+ await runtime.commit(async () => next({ phase: "wait", pid, pgid, boot }), context);
198
+ }
199
+ return { prepare, call, begun };
200
+ }
201
+ function watchdog(host, id, paths, signal) {
202
+ const cap = host.outputCap ?? OUTPUT_CAP;
203
+ return (async () => {
204
+ for (; ; ) {
205
+ await sleep(host.pollMs ?? POLL_MS, signal);
206
+ if (await outputSize(host.kernel, paths) <= cap) continue;
207
+ await stopTree(host, id);
208
+ return cap;
209
+ }
210
+ })().catch(() => void 0);
211
+ }
212
+ function finishing(lookup, mem, swept) {
213
+ const { ends, watcher, release } = mem;
214
+ const now = nowOf;
215
+ async function exitOf(host, id, pid, paths, context) {
216
+ const seen = await watcher(host, id);
217
+ const end = ends.get(id)?.then(
218
+ (exit) => ({ status: exit.status, ...exit.signal ? { signal: exit.signal } : {} }),
219
+ () => new Promise(() => void 0)
220
+ );
221
+ const polling = new AbortController();
222
+ const signal = context.abortSignal;
223
+ const quit = () => polling.abort(signal?.reason);
224
+ signal?.addEventListener("abort", quit, { once: true });
225
+ if (signal?.aborted) quit();
226
+ const capped = watchdog(host, id, paths, polling.signal);
227
+ try {
228
+ const exit = await Promise.race([
229
+ seen.waitFor(pid),
230
+ ...end ? [end] : [],
231
+ gone(host.kernel, pid, host.pollMs ?? POLL_MS, polling.signal)
232
+ ]);
233
+ polling.abort();
234
+ return { exit, cap: await capped };
235
+ } finally {
236
+ signal?.removeEventListener("abort", quit);
237
+ polling.abort();
238
+ }
239
+ }
240
+ async function wait(id, at, runtime, context) {
241
+ const host = await lookup();
242
+ if (knownBoots(at.boot, host.boot) && at.boot !== host.boot) {
243
+ const left = await tagged(host.kernel, runTag(id));
244
+ if (left?.length)
245
+ return runtime.commit(async () => next({ ...at, phase: "wait", boot: host.boot }), context);
246
+ await release(id);
247
+ return edit(
248
+ runtime,
249
+ id,
250
+ (kept) => ended(kept, "failed", now(host), RUN_ERRORS.reloaded),
251
+ next({ phase: "ended" }),
252
+ context
253
+ );
254
+ }
255
+ try {
256
+ const item = await itemOf(runtime, id, context);
257
+ const paths = [item?.run?.stdout, item?.run?.stderr].filter((path) => !!path);
258
+ const { exit, cap } = await exitOf(host, id, at.pid, paths, context);
259
+ const left = (await tagged(host.kernel, runTag(id)) ?? []).map((row) => row.pid).filter((pid) => pid !== at.pid);
260
+ await edit(
261
+ runtime,
262
+ id,
263
+ (kept) => {
264
+ ended(kept, kept.stopBy || cap ? "stopped" : "done", now(host));
265
+ if (exit.status !== void 0) kept.status = exit.status;
266
+ if (exit.signal) kept.signal = exit.signal;
267
+ if (cap) kept.capped = cap;
268
+ if (left.length) kept.survivors = left;
269
+ },
270
+ next({ phase: "ended" }),
271
+ context
272
+ );
273
+ } finally {
274
+ await release(id);
275
+ }
276
+ }
277
+ async function report(id, runtime, context) {
278
+ const host = await lookup();
279
+ const item = await itemOf(runtime, id, context);
280
+ if (item?.run) await tell(host, endLick(host, item));
281
+ const lingering = !!item?.run?.survivors?.length;
282
+ await runtime.commit(async () => lingering ? next({ phase: "linger" }) : DONE, context);
283
+ if (!lingering) swept(host);
284
+ }
285
+ async function abort(id, runtime, context) {
286
+ const host = await lookup();
287
+ const item = await itemOf(runtime, id, context);
288
+ if (item && (runLive(item) || item.run?.survivors?.length)) await stopTree(host, id);
289
+ await release(id);
290
+ await runtime.commit(async (tx) => {
291
+ const kept = sudoIn((await tx.doc(ApprovalsDoc)).items, id);
292
+ if (kept?.run && runLive(kept)) ended(kept.run, "stopped", now(host));
293
+ return { status: "terminal", outcome: { status: "aborted" } };
294
+ }, context);
295
+ const after = await itemOf(runtime, id, context);
296
+ if (after?.run?.pid) await tell(host, endLick(host, after));
297
+ }
298
+ return { wait, report, abort };
299
+ }
300
+ async function linger(lookup, swept, id, runtime, context) {
301
+ const host = await lookup();
302
+ const item = await itemOf(runtime, id, context);
303
+ let shown = (item?.run?.survivors ?? []).join(",");
304
+ for (; ; ) {
305
+ await sleep(host.pollMs ?? POLL_MS, context.abortSignal);
306
+ const rows = await tagged(host.kernel, runTag(id));
307
+ if (!rows) continue;
308
+ const pids = rows.map((row) => row.pid);
309
+ if (pids.join(",") === shown) continue;
310
+ shown = pids.join(",");
311
+ const done = !pids.length;
312
+ await edit(
313
+ runtime,
314
+ id,
315
+ (kept) => {
316
+ if (done) delete kept.survivors;
317
+ else kept.survivors = pids;
318
+ },
319
+ done ? DONE : void 0,
320
+ context
321
+ );
322
+ if (!done) continue;
323
+ swept(host);
324
+ return;
325
+ }
326
+ }
327
+ function sweeper() {
328
+ let timer;
329
+ const sweep = async (host) => {
330
+ if (timer) clearTimeout(timer);
331
+ timer = void 0;
332
+ const keep = host.keepMs ?? KEEP_MS;
333
+ const at = nowOf(host);
334
+ const items = (await host.harness.snapshot(ApprovalsDoc, BACKGROUND_CONTEXT))?.items ?? [];
335
+ const kept = items.filter(
336
+ (item) => item.kind === "sudo" && !!item.run?.stdout && !item.run.removed && item.run.endedAt !== void 0 && !runLive(item) && !item.run.survivors?.length
337
+ );
338
+ const due = kept.filter((item) => at - item.run.endedAt >= keep);
339
+ for (const item of due) {
340
+ const paths = [item.run.stdout, item.run.stderr].filter((path) => !!path);
341
+ const user = item.replay?.user;
342
+ if (user) await removeOutput(host.kernel, user, paths);
343
+ }
344
+ if (due.length)
345
+ await host.harness.commit(async (tx) => {
346
+ for (const item of due) {
347
+ const found = sudoIn((await tx.doc(ApprovalsDoc)).items, item.id)?.run;
348
+ if (!found) continue;
349
+ delete found.stdout;
350
+ delete found.stderr;
351
+ found.removed = true;
352
+ }
353
+ }, BACKGROUND_CONTEXT);
354
+ const later = kept.filter((item) => !due.includes(item)).map((item) => item.run.endedAt + keep - at);
355
+ if (!later.length) return;
356
+ timer = setTimeout(
357
+ () => void sweep(host).catch(() => void 0),
358
+ Math.min(MAX_DELAY, Math.max(0, Math.min(...later)))
359
+ );
360
+ timer.unref?.();
361
+ };
362
+ return (host) => void sweep(host).catch(() => void 0);
363
+ }
364
+ function sudoRuns() {
365
+ let bind = () => void 0;
366
+ let held;
367
+ const bound = new Promise((resolve) => {
368
+ bind = (host) => {
369
+ held = host;
370
+ resolve(host);
371
+ };
372
+ });
373
+ const swept = sweeper();
374
+ const mem = memory();
375
+ const lookup = () => bound;
376
+ const run = {
377
+ ...starting(lookup, mem),
378
+ ...finishing(lookup, mem, swept),
379
+ linger: (id, runtime, context) => linger(lookup, swept, id, runtime, context)
380
+ };
381
+ const task = defineTask({
382
+ name: SUDO_RUN_TASK,
383
+ version: 1,
384
+ initial: () => ({ phase: "prepare" }),
385
+ phases: {
386
+ prepare: (task2, runtime, context) => run.prepare(task2.input.approval, runtime, context),
387
+ call: (task2, runtime, context) => run.call(task2.input.approval, task2.state.checkpoint, runtime, context),
388
+ started: (task2, runtime, context) => run.begun(task2.input.approval, task2.state.checkpoint, runtime, context),
389
+ wait: (task2, runtime, context) => run.wait(task2.input.approval, task2.state.checkpoint, runtime, context),
390
+ ended: (task2, runtime, context) => run.report(task2.input.approval, runtime, context),
391
+ linger: (task2, runtime, context) => run.linger(task2.input.approval, runtime, context)
392
+ },
393
+ abort: (task2, runtime, context) => run.abort(task2.input.approval, runtime, context)
394
+ });
395
+ return {
396
+ extension: defineExtension({ name: SUDO_RUNS, tasks: [task] }),
397
+ bind: (host) => {
398
+ bind(host);
399
+ swept(host);
400
+ },
401
+ async claim(id, runner, gates, context) {
402
+ const host = held;
403
+ if (!host) return { done: false, error: RUN_REASONS.kernel };
404
+ const at = host.now?.() ?? Date.now();
405
+ return host.harness.commit(async (tx) => {
406
+ const item = (await tx.doc(ApprovalsDoc)).items.find((entry) => entry.id === id);
407
+ if (!item) return { done: false, error: `There is no approval ${id}.` };
408
+ const able = runnable(item, at, gates);
409
+ if (able !== true) return { done: false, error: able.reason };
410
+ item.run = {
411
+ state: "starting",
412
+ by: runner.by,
413
+ ...runner.device ? { device: runner.device } : {},
414
+ at
415
+ };
416
+ await tx.createTask(
417
+ task,
418
+ { approval: id },
419
+ {
420
+ ownership: { kind: "conversation" },
421
+ conversationId: host.conversation,
422
+ background: true
423
+ }
424
+ );
425
+ return { done: true, error: null };
426
+ }, context);
427
+ },
428
+ async stop(id, runner, context) {
429
+ const host = held;
430
+ if (!host) return { done: false, error: RUN_ERRORS.idle };
431
+ const found = await host.harness.commit(async (tx) => {
432
+ const item = sudoIn((await tx.doc(ApprovalsDoc)).items, id);
433
+ if (!item?.run) return null;
434
+ const live = runLive(item);
435
+ if (live) item.run.stopBy = runner.by;
436
+ return { live, pid: item.run.pid };
437
+ }, context);
438
+ if (!found) return { done: false, error: RUN_ERRORS.idle };
439
+ if (found.live && found.pid === void 0) return { done: true, error: null };
440
+ const sent = await stopTree(host, id);
441
+ if (sent === "sent") return { done: true, error: null };
442
+ if (sent === "unknown") return { done: false, error: RUN_ERRORS.unseen };
443
+ return { done: false, error: found.live ? RUN_ERRORS.gone : RUN_ERRORS.idle };
444
+ }
445
+ };
446
+ }
447
+ export {
448
+ ADOPT_MS,
449
+ ADOPT_TRIES,
450
+ KEEP_MS,
451
+ KILL_MS,
452
+ OUTPUT_CAP,
453
+ POLL_MS,
454
+ RUNS_DIR,
455
+ RUN_ERRORS,
456
+ RUN_TAG,
457
+ SUDO_RUNS,
458
+ SUDO_RUN_TASK,
459
+ clock,
460
+ duration,
461
+ endLick2 as endLick,
462
+ messageOf,
463
+ outputOf2 as outputOf,
464
+ runTag2 as runTag,
465
+ startLick2 as startLick,
466
+ sudoRuns
467
+ };
468
+ //# sourceMappingURL=run.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../src/approvals/run.ts"],
4
+ "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport {\n type ConversationId,\n defineExtension,\n defineTask,\n type Extension,\n type Harness,\n type NextTaskState,\n type TaskRuntime,\n} from '@earendil-works/pi-durable';\nimport type { AgentsState } from '../agents.ts';\nimport type { SudoRunning } from '../kernel/client.ts';\nimport type { LickEvent, Licks } from '../licks/licks.ts';\nimport {\n type Approval,\n ApprovalsDoc,\n type DecidedBy,\n MAX_DELAY,\n runLive,\n type SudoApproval,\n type SudoRun,\n} from './record.ts';\nimport { endLick, KEEP_HOURS, MIB, startLick } from './run-licks.ts';\nimport {\n aborted,\n adoptable,\n type Exit,\n gone,\n outputOf,\n outputSize,\n type RunKernel,\n removeOutput,\n runTag,\n signalTree,\n sleep,\n tagged,\n type Watcher,\n watchExits,\n} from './run-procs.ts';\nimport { RUN_REASONS, type RunGates, runnable } from './runnable.ts';\n\nexport { clock, duration, endLick, startLick } from './run-licks.ts';\nexport { outputOf, RUN_TAG, RUNS_DIR, type RunKernel, runTag } from './run-procs.ts';\n\nexport const SUDO_RUN_TASK = 'slicc.sudo-run';\nexport const SUDO_RUNS = 'slicc-sudo-runs';\nexport const POLL_MS = 5000;\nexport const KILL_MS = 5000;\nexport const ADOPT_MS = 250;\nexport const ADOPT_TRIES = 5;\nexport const OUTPUT_CAP = 32 * MIB;\nexport const KEEP_MS = KEEP_HOURS * 3_600_000;\n\nexport const RUN_ERRORS = {\n interrupted: 'interrupted before it started',\n reloaded: 'the page reloaded while it ran',\n idle: \"This request isn't running.\",\n gone: 'Its processes are already gone.',\n unseen: \"The kernel's process list isn't available, so it can't be stopped.\",\n} as const;\n\nexport interface SudoRunHost {\n kernel: RunKernel;\n harness: Pick<Harness, 'commit' | 'snapshot'>;\n agents: { state(): Readonly<AgentsState> };\n licks?: Pick<Licks, 'deliver'>;\n boot: string | null;\n server: string;\n conversation: number;\n now?: () => number;\n pollMs?: number;\n killMs?: number;\n adoptMs?: number;\n outputCap?: number;\n keepMs?: number;\n}\n\nexport type RunAnswer = { done: true; error: null } | { done: false; error: string };\n\nexport type Runner = { by: DecidedBy; device?: string };\n\nexport interface SudoRuns {\n readonly extension: Extension;\n bind(host: SudoRunHost): void;\n claim(id: string, runner: Runner, gates: RunGates, context: Context): Promise<RunAnswer>;\n stop(id: string, runner: Runner, context: Context): Promise<RunAnswer>;\n}\n\ntype Input = { approval: string };\ntype Phase =\n | { phase: 'prepare' }\n | { phase: 'call'; server: string; boot: string | null }\n | { phase: 'started'; pid: number; pgid: number; boot: string | null }\n | { phase: 'wait'; pid: number; pgid: number; boot: string | null }\n | { phase: 'ended' }\n | { phase: 'linger' };\ntype Runtime = TaskRuntime<Input, Phase, null, object>;\ntype Next = NextTaskState<Phase, null>;\n\nconst DONE: Next = { status: 'terminal', outcome: { status: 'completed', result: null } };\n\nconst next = (checkpoint: Phase): Next => ({ status: 'running', checkpoint });\n\nconst sudoIn = (items: readonly Approval[] | undefined, id: string) => {\n const item = items?.find((entry) => entry.id === id);\n return item?.kind === 'sudo' ? item : undefined;\n};\n\nasync function itemOf(runtime: Runtime, id: string, context: Context) {\n return sudoIn((await runtime.snapshot(ApprovalsDoc, context))?.items, id);\n}\n\ntype Claimed = SudoApproval & { replay: NonNullable<SudoApproval['replay']>; run: SudoRun };\n\nasync function claimed(runtime: Runtime, id: string, context: Context) {\n const item = await itemOf(runtime, id, context);\n if (item?.replay && item.run?.state === 'starting') return item as Claimed;\n await runtime.commit(async () => DONE, context);\n return undefined;\n}\n\nfunction edit(\n runtime: Runtime,\n id: string,\n change: (run: SudoRun, item: SudoApproval) => void,\n then: Next | undefined,\n context: Context\n): Promise<void> {\n return runtime.commit(async (tx) => {\n const item = sudoIn((await tx.doc(ApprovalsDoc)).items, id);\n if (item?.run) change(item.run, item);\n return then;\n }, context);\n}\n\nconst ended = (run: SudoRun, state: SudoRun['state'], at: number, error?: string) => {\n run.state = state;\n run.endedAt = at;\n if (error) run.error = error;\n};\n\nexport function messageOf(error: unknown): string {\n if ((error as { code?: unknown })?.code === 'ENOSYS') return RUN_REASONS.kernel;\n const text = error instanceof Error ? error.message : String(error);\n return text.trim() || 'the kernel refused to run it';\n}\n\nasync function tell(host: SudoRunHost, made: Promise<LickEvent>) {\n const event = await made.catch(() => undefined);\n if (event) await host.licks?.deliver(event, BACKGROUND_CONTEXT).catch(() => undefined);\n}\n\nconst stopTree = (host: SudoRunHost, id: string) =>\n signalTree(host.kernel, runTag(id), host.killMs ?? KILL_MS);\n\ntype Lookup = () => Promise<SudoRunHost>;\n\nconst nowOf = (host: SudoRunHost) => host.now?.() ?? Date.now();\n\nconst knownBoots = (a: string | null, b: string | null) => a !== null && b !== null;\n\nfunction memory() {\n const calling = new Set<string>();\n const ends = new Map<string, SudoRunning['ended']>();\n const watchers = new Map<string, Promise<Watcher>>();\n return {\n calling,\n ends,\n watcher(host: SudoRunHost, id: string) {\n const found = watchers.get(id) ?? watchExits(host.kernel, runTag(id));\n watchers.set(id, found);\n return found;\n },\n async release(id: string) {\n const found = watchers.get(id);\n watchers.delete(id);\n ends.delete(id);\n calling.delete(id);\n (await found)?.close();\n },\n };\n}\n\ntype Memory = ReturnType<typeof memory>;\n\nfunction starting(lookup: Lookup, mem: Memory) {\n const { calling, ends, watcher, release } = mem;\n const now = nowOf;\n\n async function prepare(id: string, runtime: Runtime, context: Context) {\n const host = await lookup();\n const item = await claimed(runtime, id, context);\n if (!item) return;\n const place = await outputOf(host.kernel, item.replay.user, id, context.abortSignal).catch(\n (error: unknown) => {\n if (context.abortSignal?.aborted) throw error;\n return messageOf(error);\n }\n );\n if (typeof place === 'string')\n return edit(runtime, id, (kept) => ended(kept, 'failed', now(host), place), DONE, context);\n return edit(\n runtime,\n id,\n (kept) => Object.assign(kept, place),\n next({ phase: 'call', server: host.server, boot: host.boot }),\n context\n );\n }\n\n async function adopt(id: string, boot: string | null, runtime: Runtime, context: Context) {\n const host = await lookup();\n const item = await itemOf(runtime, id, context);\n const target = item?.replay?.target ?? 'root';\n let lead = await adoptable(host.kernel, runTag(id), target);\n for (let attempt = 0; !lead && attempt < ADOPT_TRIES - 1; attempt++) {\n await sleep((host.adoptMs ?? ADOPT_MS) * 2 ** attempt, context.abortSignal);\n lead = await adoptable(host.kernel, runTag(id), target);\n }\n if (!lead)\n return edit(\n runtime,\n id,\n (kept) => ended(kept, 'failed', now(host), RUN_ERRORS.interrupted),\n DONE,\n context\n );\n const pgid = lead.pgid ?? lead.pid;\n return edit(\n runtime,\n id,\n (kept) => Object.assign(kept, { state: 'running', pid: lead.pid, pgid }),\n next({ phase: 'started', pid: lead.pid, pgid, boot }),\n context\n );\n }\n\n async function call(\n id: string,\n at: { server: string; boot: string | null },\n runtime: Runtime,\n context: Context\n ) {\n const host = await lookup();\n if (at.server !== host.server || calling.has(id)) return adopt(id, at.boot, runtime, context);\n calling.add(id);\n const item = await claimed(runtime, id, context);\n if (!item) return;\n const { run } = item;\n if (run.stopBy)\n return edit(runtime, id, (kept) => ended(kept, 'stopped', now(host)), DONE, context);\n await watcher(host, id);\n let started: SudoRunning;\n try {\n if (!host.kernel.sudoRun)\n throw Object.assign(new Error(RUN_REASONS.kernel), { code: 'ENOSYS' });\n const asked = host.kernel.sudoRun(item.replay, {\n stdout: run.stdout as string,\n stderr: run.stderr as string,\n tag: runTag(id),\n });\n started = await Promise.race([asked, aborted(context.abortSignal)]);\n } catch (error) {\n await release(id);\n if (context.abortSignal?.aborted) throw error;\n const why = messageOf(error);\n return edit(runtime, id, (kept) => ended(kept, 'failed', now(host), why), DONE, context);\n }\n ends.set(id, started.ended);\n started.ended.catch(() => undefined);\n const { pid, pgid } = started;\n return edit(\n runtime,\n id,\n (kept) => Object.assign(kept, { state: 'running', pid, pgid }),\n next({ phase: 'started', pid, pgid, boot: at.boot }),\n context\n );\n }\n\n async function begun(\n id: string,\n at: { pid: number; pgid: number; boot: string | null },\n runtime: Runtime,\n context: Context\n ) {\n const host = await lookup();\n const item = await itemOf(runtime, id, context);\n if (item?.run) {\n await tell(host, startLick(host, item));\n if (item.run.stopBy) await stopTree(host, id);\n }\n const { pid, pgid, boot } = at;\n await runtime.commit(async () => next({ phase: 'wait', pid, pgid, boot }), context);\n }\n\n return { prepare, call, begun };\n}\n\nfunction watchdog(host: SudoRunHost, id: string, paths: string[], signal: AbortSignal) {\n const cap = host.outputCap ?? OUTPUT_CAP;\n return (async () => {\n for (;;) {\n await sleep(host.pollMs ?? POLL_MS, signal);\n if ((await outputSize(host.kernel, paths)) <= cap) continue;\n await stopTree(host, id);\n return cap;\n }\n })().catch(() => undefined);\n}\n\nfunction finishing(lookup: Lookup, mem: Memory, swept: (host: SudoRunHost) => void) {\n const { ends, watcher, release } = mem;\n const now = nowOf;\n\n async function exitOf(\n host: SudoRunHost,\n id: string,\n pid: number,\n paths: string[],\n context: Context\n ) {\n const seen = await watcher(host, id);\n const end = ends.get(id)?.then(\n (exit) => ({ status: exit.status, ...(exit.signal ? { signal: exit.signal } : {}) }),\n () => new Promise<Exit>(() => undefined)\n );\n const polling = new AbortController();\n const signal = context.abortSignal;\n const quit = () => polling.abort(signal?.reason);\n signal?.addEventListener('abort', quit, { once: true });\n if (signal?.aborted) quit();\n const capped = watchdog(host, id, paths, polling.signal);\n try {\n const exit = await Promise.race([\n seen.waitFor(pid),\n ...(end ? [end] : []),\n gone(host.kernel, pid, host.pollMs ?? POLL_MS, polling.signal),\n ]);\n polling.abort();\n return { exit, cap: await capped };\n } finally {\n signal?.removeEventListener('abort', quit);\n polling.abort();\n }\n }\n\n async function wait(\n id: string,\n at: { pid: number; pgid: number; boot: string | null },\n runtime: Runtime,\n context: Context\n ) {\n const host = await lookup();\n if (knownBoots(at.boot, host.boot) && at.boot !== host.boot) {\n const left = await tagged(host.kernel, runTag(id));\n if (left?.length)\n return runtime.commit(async () => next({ ...at, phase: 'wait', boot: host.boot }), context);\n await release(id);\n return edit(\n runtime,\n id,\n (kept) => ended(kept, 'failed', now(host), RUN_ERRORS.reloaded),\n next({ phase: 'ended' }),\n context\n );\n }\n try {\n const item = await itemOf(runtime, id, context);\n const paths = [item?.run?.stdout, item?.run?.stderr].filter((path): path is string => !!path);\n const { exit, cap } = await exitOf(host, id, at.pid, paths, context);\n const left = ((await tagged(host.kernel, runTag(id))) ?? [])\n .map((row) => row.pid)\n .filter((pid) => pid !== at.pid);\n await edit(\n runtime,\n id,\n (kept) => {\n ended(kept, kept.stopBy || cap ? 'stopped' : 'done', now(host));\n if (exit.status !== undefined) kept.status = exit.status;\n if (exit.signal) kept.signal = exit.signal;\n if (cap) kept.capped = cap;\n if (left.length) kept.survivors = left;\n },\n next({ phase: 'ended' }),\n context\n );\n } finally {\n await release(id);\n }\n }\n\n async function report(id: string, runtime: Runtime, context: Context) {\n const host = await lookup();\n const item = await itemOf(runtime, id, context);\n if (item?.run) await tell(host, endLick(host, item));\n const lingering = !!item?.run?.survivors?.length;\n await runtime.commit(async () => (lingering ? next({ phase: 'linger' }) : DONE), context);\n if (!lingering) swept(host);\n }\n\n async function abort(id: string, runtime: Runtime, context: Context) {\n const host = await lookup();\n const item = await itemOf(runtime, id, context);\n if (item && (runLive(item) || item.run?.survivors?.length)) await stopTree(host, id);\n await release(id);\n await runtime.commit(async (tx) => {\n const kept = sudoIn((await tx.doc(ApprovalsDoc)).items, id);\n if (kept?.run && runLive(kept)) ended(kept.run, 'stopped', now(host));\n return { status: 'terminal', outcome: { status: 'aborted' } };\n }, context);\n const after = await itemOf(runtime, id, context);\n if (after?.run?.pid) await tell(host, endLick(host, after));\n }\n\n return { wait, report, abort };\n}\n\nasync function linger(\n lookup: Lookup,\n swept: (host: SudoRunHost) => void,\n id: string,\n runtime: Runtime,\n context: Context\n) {\n const host = await lookup();\n const item = await itemOf(runtime, id, context);\n let shown = (item?.run?.survivors ?? []).join(',');\n for (;;) {\n await sleep(host.pollMs ?? POLL_MS, context.abortSignal);\n const rows = await tagged(host.kernel, runTag(id));\n if (!rows) continue;\n const pids = rows.map((row) => row.pid);\n if (pids.join(',') === shown) continue;\n shown = pids.join(',');\n const done = !pids.length;\n await edit(\n runtime,\n id,\n (kept) => {\n if (done) delete kept.survivors;\n else kept.survivors = pids;\n },\n done ? DONE : undefined,\n context\n );\n if (!done) continue;\n swept(host);\n return;\n }\n}\n\nfunction sweeper() {\n let timer: ReturnType<typeof setTimeout> | undefined;\n const sweep = async (host: SudoRunHost) => {\n if (timer) clearTimeout(timer);\n timer = undefined;\n const keep = host.keepMs ?? KEEP_MS;\n const at = nowOf(host);\n const items = (await host.harness.snapshot(ApprovalsDoc, BACKGROUND_CONTEXT))?.items ?? [];\n const kept = items.filter(\n (item): item is SudoApproval & { run: SudoRun } =>\n item.kind === 'sudo' &&\n !!item.run?.stdout &&\n !item.run.removed &&\n item.run.endedAt !== undefined &&\n !runLive(item) &&\n !item.run.survivors?.length\n );\n const due = kept.filter((item) => at - (item.run.endedAt as number) >= keep);\n for (const item of due) {\n const paths = [item.run.stdout, item.run.stderr].filter((path): path is string => !!path);\n const user = item.replay?.user;\n if (user) await removeOutput(host.kernel, user, paths);\n }\n if (due.length)\n await host.harness.commit(async (tx) => {\n for (const item of due) {\n const found = sudoIn((await tx.doc(ApprovalsDoc)).items, item.id)?.run;\n if (!found) continue;\n delete found.stdout;\n delete found.stderr;\n found.removed = true;\n }\n }, BACKGROUND_CONTEXT);\n const later = kept\n .filter((item) => !due.includes(item))\n .map((item) => (item.run.endedAt as number) + keep - at);\n if (!later.length) return;\n timer = setTimeout(\n () => void sweep(host).catch(() => undefined),\n Math.min(MAX_DELAY, Math.max(0, Math.min(...later)))\n );\n (timer as { unref?: () => void }).unref?.();\n };\n return (host: SudoRunHost) => void sweep(host).catch(() => undefined);\n}\n\nexport function sudoRuns(): SudoRuns {\n let bind: (host: SudoRunHost) => void = () => undefined;\n let held: SudoRunHost | undefined;\n const bound = new Promise<SudoRunHost>((resolve) => {\n bind = (host) => {\n held = host;\n resolve(host);\n };\n });\n const swept = sweeper();\n const mem = memory();\n const lookup = () => bound;\n const run = {\n ...starting(lookup, mem),\n ...finishing(lookup, mem, swept),\n linger: (id: string, runtime: Runtime, context: Context) =>\n linger(lookup, swept, id, runtime, context),\n };\n const task = defineTask<Input, Phase, null>({\n name: SUDO_RUN_TASK,\n version: 1,\n initial: () => ({ phase: 'prepare' }),\n phases: {\n prepare: (task, runtime, context) => run.prepare(task.input.approval, runtime, context),\n call: (task, runtime, context) =>\n run.call(task.input.approval, task.state.checkpoint, runtime, context),\n started: (task, runtime, context) =>\n run.begun(task.input.approval, task.state.checkpoint, runtime, context),\n wait: (task, runtime, context) =>\n run.wait(task.input.approval, task.state.checkpoint, runtime, context),\n ended: (task, runtime, context) => run.report(task.input.approval, runtime, context),\n linger: (task, runtime, context) => run.linger(task.input.approval, runtime, context),\n },\n abort: (task, runtime, context) => run.abort(task.input.approval, runtime, context),\n });\n return {\n extension: defineExtension({ name: SUDO_RUNS, tasks: [task] }),\n bind: (host) => {\n bind(host);\n swept(host);\n },\n async claim(id, runner, gates, context) {\n const host = held;\n if (!host) return { done: false, error: RUN_REASONS.kernel };\n const at = host.now?.() ?? Date.now();\n return host.harness.commit(async (tx): Promise<RunAnswer> => {\n const item = (await tx.doc(ApprovalsDoc)).items.find((entry) => entry.id === id);\n if (!item) return { done: false, error: `There is no approval ${id}.` };\n const able = runnable(item, at, gates);\n if (able !== true) return { done: false, error: able.reason };\n (item as SudoApproval).run = {\n state: 'starting',\n by: runner.by,\n ...(runner.device ? { device: runner.device } : {}),\n at,\n };\n await tx.createTask(\n task,\n { approval: id },\n {\n ownership: { kind: 'conversation' },\n conversationId: host.conversation as ConversationId,\n background: true,\n }\n );\n return { done: true, error: null };\n }, context);\n },\n async stop(id, runner, context) {\n const host = held;\n if (!host) return { done: false, error: RUN_ERRORS.idle };\n const found = await host.harness.commit(async (tx) => {\n const item = sudoIn((await tx.doc(ApprovalsDoc)).items, id);\n if (!item?.run) return null;\n const live = runLive(item);\n if (live) item.run.stopBy = runner.by;\n return { live, pid: item.run.pid };\n }, context);\n if (!found) return { done: false, error: RUN_ERRORS.idle };\n if (found.live && found.pid === undefined) return { done: true, error: null };\n const sent = await stopTree(host, id);\n if (sent === 'sent') return { done: true, error: null };\n if (sent === 'unknown') return { done: false, error: RUN_ERRORS.unseen };\n return { done: false, error: found.live ? RUN_ERRORS.gone : RUN_ERRORS.idle };\n },\n };\n}\n"],
5
+ "mappings": "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",
6
+ "names": ["endLick", "startLick", "outputOf", "runTag", "task"]
7
+ }
@@ -0,0 +1,125 @@
1
+ import { replicatedState } from "@earendil-works/chord";
2
+ import { BACKGROUND_CONTEXT } from "@earendil-works/chord/context";
3
+ import { live } from "../agents.js";
4
+ import { frozenTarget } from "../freezer/index.js";
5
+ import { MAX_DELAY, REASONS } from "./record.js";
6
+ const SUDO_RUN_PROTOCOL = [1, 16];
7
+ const RUN_REASONS = {
8
+ kind: "Only a sudo request can run now.",
9
+ open: "This request is still open: answer it instead.",
10
+ untimed: "Only a request that timed out can run now.",
11
+ running: "This request is already running.",
12
+ ran: "This request already ran.",
13
+ terminal: "Run it again in the terminal.",
14
+ validate: "sudo -v has no command to run.",
15
+ stdin: "Its input is gone, so it must be asked again.",
16
+ old: "This request is from before Run now, so it must be asked again.",
17
+ off: "Run now is off in the approval policy.",
18
+ gone: "The agent that asked is gone, so it must be asked again.",
19
+ kernel: `Needs slicc-kernel protocol ${SUDO_RUN_PROTOCOL.join(".")} or later.`
20
+ };
21
+ const MINUTE = 6e4;
22
+ function tooOld(minutes) {
23
+ const hours = minutes / 60;
24
+ const span = Number.isInteger(hours) ? `${hours} h` : `${minutes} min`;
25
+ return `It timed out over ${span} ago, so it must be asked again.`;
26
+ }
27
+ const thawFirst = (cone) => `Thaw ${cone} first.`;
28
+ function runnable(item, now, gates) {
29
+ if (item.kind !== "sudo") return { reason: RUN_REASONS.kind };
30
+ if (item.state === "pending") return { reason: RUN_REASONS.open };
31
+ if (item.state !== "unanswered" || item.reason !== REASONS.timeout)
32
+ return { reason: RUN_REASONS.untimed };
33
+ if (item.run)
34
+ return {
35
+ reason: item.run.state === "starting" || item.run.state === "running" ? RUN_REASONS.running : RUN_REASONS.ran
36
+ };
37
+ const agentId = item.requester.agentId;
38
+ if (item.requester.kind !== "agent" || !agentId) return { reason: RUN_REASONS.terminal };
39
+ if (item.detail.validate || item.replay?.validate) return { reason: RUN_REASONS.validate };
40
+ const stdin = item.replay?.stdin ?? item.detail.stdin;
41
+ if (stdin === "pipe" || stdin === "file") return { reason: RUN_REASONS.stdin };
42
+ if (!item.replay?.rootOnly) return { reason: RUN_REASONS.old };
43
+ if (gates.maxAgeMinutes <= 0) return { reason: RUN_REASONS.off };
44
+ const since = item.decidedAt ?? item.expiresAt;
45
+ if (now - since > gates.maxAgeMinutes * MINUTE) return { reason: tooOld(gates.maxAgeMinutes) };
46
+ const frozen = gates.frozen?.(agentId);
47
+ if (frozen) return { reason: thawFirst(frozen) };
48
+ if (gates.gone?.(agentId)) return { reason: RUN_REASONS.gone };
49
+ if (gates.kernel !== true) return { reason: gates.kernel };
50
+ return true;
51
+ }
52
+ function runEnds(item, maxAgeMinutes) {
53
+ if (item.kind !== "sudo" || item.state !== "unanswered" || item.run || maxAgeMinutes <= 0)
54
+ return void 0;
55
+ return (item.decidedAt ?? item.expiresAt) + maxAgeMinutes * MINUTE + 1;
56
+ }
57
+ function agentTarget(state, agentId) {
58
+ if (!agentId.startsWith("scoop:")) return `cone:${agentId}`;
59
+ const scoop = state.scoops[agentId];
60
+ return scoop && !live(scoop) && !scoop.frozen ? `cone:${scoop.cone}` : agentId;
61
+ }
62
+ const frozenOf = (state) => (agentId) => frozenTarget(state(), agentTarget(state(), agentId))?.name;
63
+ const goneOf = (state) => (agentId) => {
64
+ const now = state();
65
+ const target = agentTarget(now, agentId);
66
+ return target.startsWith("cone:") ? !now.cones[target.slice(5)] : !now.scoops[agentId];
67
+ };
68
+ function kernelGate(client) {
69
+ if (typeof client?.sudoRun !== "function") return RUN_REASONS.kernel;
70
+ const [major = 0, minor = 0] = client.protocol ?? SUDO_RUN_PROTOCOL;
71
+ const [needMajor, needMinor] = SUDO_RUN_PROTOCOL;
72
+ return major > needMajor || major === needMajor && minor >= needMinor ? true : RUN_REASONS.kernel;
73
+ }
74
+ const listed = (item) => item.kind === "sudo" && item.state === "unanswered" && item.reason === REASONS.timeout;
75
+ function watchRunnable(approvals, changes, gates, clock = {}) {
76
+ const now = clock.now ?? Date.now;
77
+ const setTimer = clock.setTimer ?? ((callback, ms) => {
78
+ const timer = setTimeout(callback, ms);
79
+ return () => clearTimeout(timer);
80
+ });
81
+ const state = replicatedState({});
82
+ let shown = "{}";
83
+ let disarm = () => void 0;
84
+ const refresh = () => {
85
+ disarm();
86
+ const at = now();
87
+ const given = gates();
88
+ const items = (approvals.value ?? []).filter(listed);
89
+ const map = Object.fromEntries(items.map((item) => [item.id, runnable(item, at, given)]));
90
+ const text = JSON.stringify(map);
91
+ if (text !== shown) {
92
+ shown = text;
93
+ state.replace(BACKGROUND_CONTEXT, map);
94
+ }
95
+ const due = items.map((item) => runEnds(item, given.maxAgeMinutes)).filter((end) => end !== void 0 && end > at);
96
+ if (due.length) disarm = setTimer(refresh, Math.min(MAX_DELAY, Math.min(...due) - at));
97
+ };
98
+ const offs = [
99
+ approvals.subscribe(refresh),
100
+ ...changes.map((watched) => watched.subscribe(refresh))
101
+ ];
102
+ refresh();
103
+ return {
104
+ state,
105
+ refresh,
106
+ dispose() {
107
+ disarm();
108
+ for (const off of offs) off();
109
+ }
110
+ };
111
+ }
112
+ export {
113
+ RUN_REASONS,
114
+ SUDO_RUN_PROTOCOL,
115
+ agentTarget,
116
+ frozenOf,
117
+ goneOf,
118
+ kernelGate,
119
+ runEnds,
120
+ runnable,
121
+ thawFirst,
122
+ tooOld,
123
+ watchRunnable
124
+ };
125
+ //# sourceMappingURL=runnable.js.map