@ai-ecoverse/slicc-agent 7.27.0 → 7.28.1

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.
package/README.md CHANGED
@@ -742,18 +742,19 @@ It prints the tab's stdout and stderr on their own streams and exits with its co
742
742
  Every approval, of a guest's prompt, of a tool call in a run a guest started, of a sudo request, or of a media capture from a run a guest started, is an item in one session document, `slicc.approvals` ([`src/approvals/`](src/approvals/)). That document is the authority: not a lick, which the agent can confirm itself, and not a UI projection, so a settled item stays settled after a reload.
743
743
 
744
744
  - **An item** is `{ id, kind, seat?, agentId, requester, detail, tier, state, decidedBy, device?, answer?, reason?, verdict?, judging?, verdictError?, always, createdAt, expiresAt, decidedAt? }`. `kind` is `guest-message` (`detail: { text, attachments }`), `guest-tool` (`{ tool, summary, arguments?, task? }`) `sudo` (`{ command, target?, cwd?, alwaysScope?, stdin?, rootOnly?, writable?, validate? }`) or `capture` (`{ what, mode, seconds?, system?, microphone?, device?, program }`, see Media capture). `judging` is `true` while the judge runs; `verdictError` says why there is no verdict. `requester` is `{ kind: 'guest' | 'agent' | 'user', name, seat?, agentId?, where?, device? }`.
745
- - **`state`** is `pending`, `approved` (with `answer` `once` or `always`), `rejected` (someone said no), `unanswered` (nobody decided: it timed out or couldn't be routed) or `withdrawn` (the requester went away). `reason` is a field, never a state: a person's own words, or `timeout`, `unknown-tier`, `unroutable`, `unknown-answer`, `restart`, `revoked`, `aborted` or `disconnected`. `decidedBy` is `owner`, `follower`, `judge` or `host`.
745
+ - **`state`** is `pending`, `approved` (with `answer` `once` or `always`), `rejected` (someone said no), `unanswered` (nobody decided: it timed out or couldn't be routed) or `withdrawn` (the requester went away). `reason` is a field, never a state: a person's own words, or `timeout`, `unknown-tier`, `unroutable`, `unknown-answer`, `restart`, `revoked`, `aborted`, `disconnected` or `stopped` (see Deny and stop). `decidedBy` is `owner`, `follower`, `judge` or `host`.
746
746
  - **`tier`** says who answers: `user` (a person, through `decide`), `agent` (the automatic judge), `cone` or `scoop:<name>`. A tier the agent doesn't know settles at once as `unanswered` with `unknown-tier`, and so does `cone` for a guest's tool call or capture (`unroutable`), because a run can't approve its own gate. A person answers only `user` items, the judge only `agent` ones.
747
- - **The rules:** the first decision wins, and a later one, or one past `expiresAt`, is refused ("Someone else already answered this.", "This request timed out.", "This request was withdrawn."). An answer other than `once`, `always` or `deny` is a deny (`unknown-answer`). `always` is `false` for anything a guest triggered unless the approval policy's `guests.always` offers it for that kind (by default it doesn't). A `sudo` or `capture` item starts with `always: false` and gets `true` only from a verdict (see The automatic judge), and `decide(id, 'always')` on an item without it is refused and leaves it pending. For a guest's tool call, Always records an exact rule on the seat (see Guest seats), and for a capture a narrow one (see Media capture).
747
+ - **The rules:** the first decision wins, and a later one, or one past `expiresAt`, is refused ("Someone else already answered this.", "This request timed out.", "This request was withdrawn."). An answer other than `once`, `always`, `deny` or `stop` is a deny (`unknown-answer`). `always` is `false` for anything a guest triggered unless the approval policy's `guests.always` offers it for that kind (by default it doesn't). A `sudo` or `capture` item starts with `always: false` and gets `true` only from a verdict (see The automatic judge), and `decide(id, 'always')` on an item without it is refused and leaves it pending. For a guest's tool call, Always records an exact rule on the seat (see Guest seats), and for a capture a narrow one (see Media capture).
748
+ - **Deny and stop:** `decide(id, 'stop')` denies a `sudo` item and stops the turn of the agent that asked for it, in one step inside the worker. Only a person (`owner` or `follower`) may send it, and only for a pending `sudo` item whose `requester` is an agent with an `agentId` (a cone or a scoop); anything else is refused with an error ("Only a person can stop a turn.", "This request has no turn to stop.") and the item stays pending, and so is one to approvals attached without a way to stop a turn. One write settles the item `rejected` with `reason: 'stopped'` and `decidedBy` the person, withdraws that agent's other pending `sudo` and `capture` items (`withdrawn`, `stopped`), and holds that agent's next `sudo` or `capture` asks; then the worker aborts that agent's conversation (`Conversation.abort()`, as `stopAgent` does), which kills the running command's process tree. A held ask waits until the turn has stopped and is then filed `withdrawn` (`stopped`), so a shell loop that keeps calling `sudo` can't reach a person in between, and `decide` resolves after the turn is idle. A scoop's request stops the scoop's turn, never its cone's: a cone waiting on it in `agent --prompt` gets "the scoop's request ended without an answer: aborted" and carries on, and `agent wait` returns once the scoop is idle. A person's own reason that is the word `stopped` isn't kept, so a plain deny never reads as a stop. A worker from before this answers `stop` as `unknown-answer`, a plain deny.
748
749
  - **Lifetime:** an item waits 5 minutes unless its requester sets `expiresAt`, then settles `unanswered`. Pending guest items survive a reload of the worker; pending `sudo` and `capture` items are withdrawn (`restart`), because a reload ends the kernel's processes and the page's request. The document keeps every pending item and the last 100 settled ones.
749
750
  - **In the worker,** `AgentHost.approvals` has `request(draft, ctx)`, `decide(id, answer, reason, by, ctx)` (`by` is a `DecidedBy`, or `{ by, device }` to record the deciding device), `settled(id, ctx)` (resolves when the item leaves `pending`), `withdraw(id, reason, ctx)` and `withdrawSeat(seat, ctx)`, which withdraws a revoked seat's pending items.
750
751
  - **Over the link,** `AgentTranscript.approvals` replicates the items, and `AgentControl.decide(id, decision, reason, ctx)` answers one, for every owner device: the owner's pages and followers with or without Control, all with the same powers. `decidedBy` comes from the link's seat (`owner` for the owner's pages, `follower` for the others), and is only a record of who answered. A guest never gets `decide`.
751
- - **In spectrum** (1.112 on, which shows approvals in `<slicc-approvals>` with Always allow when `always` is true, as notices without `decide`, and the verdict's level), `createAgentModel` returns `approvals`, an `ApprovalsAdapter` for `SliccModel.approvals`. `list()` has the pending `user` items, oldest first, as spectrum's `Approval`s, with the cone's name as `agentName` and the item's own `always`, so a guest approval offers Always allow only when the policy did when it was asked. Every approval carries the judge's `verdict` once it lands, as `{ level?, aligned?, reason }` (spectrum 1.112 on shows the level; `aligned` is `true` at P over 0.8, or the chat model's answer), `judging: true` while the check runs and `verdictError` when there is none. Its `always` is the item's, so Always allow shows up only when a level 1 verdict offers it. `decide(id, decision, reason?)` rejects with the agent's message, and `ended` reports `answered`, `expired` or `withdrawn` for an item that left without this tab's decision. Every owner device's adapter has `decide`; a guest connection's doesn't. So a notice instead of a dialog shows only where nothing can answer. A `capture` item is a `CaptureApproval`, with the guest items' `agentId`, `agentName`, `always` and verdict fields and the item's `detail` as it is (`what`, `mode`, `seconds?`, `system?`, `microphone?`, `device?`, `program`), which spectrum 2.4.1 on shows as its capture line. A `guest-tool` approval also carries `args`, the call's arguments pretty-printed as JSON (two-space indent), so spectrum can show them uncut when `summary` is empty. The worker runs every string in the arguments through the secrets scrub before it files the item, so `summary`, `detail.arguments` and `args` show a secret as its placeholder; the seat's Always rules still match the call's own arguments. `args` is capped at 64 KiB (65,536 UTF-16 code units, `ARGS_LENGTH`, never splitting a surrogate pair): longer arguments are sent as that prefix with `argsTruncated: true`, and spectrum must then offer only Deny and Always deny, never Allow, because the end wasn't seen.
752
+ - **In spectrum** (1.112 on, which shows approvals in `<slicc-approvals>` with Always allow when `always` is true, as notices without `decide`, and the verdict's level), `createAgentModel` returns `approvals`, an `ApprovalsAdapter` for `SliccModel.approvals`. `list()` has the pending `user` items, oldest first, as spectrum's `Approval`s, with the cone's name as `agentName` and the item's own `always`, so a guest approval offers Always allow only when the policy did when it was asked. Every approval carries the judge's `verdict` once it lands, as `{ level?, aligned?, reason }` (spectrum 1.112 on shows the level; `aligned` is `true` at P over 0.8, or the chat model's answer), `judging: true` while the check runs and `verdictError` when there is none. Its `always` is the item's, so Always allow shows up only when a level 1 verdict offers it. A `sudo` approval from a cone or a scoop (`requester.kind` `agent` with an `agentId`) carries `stoppable: true`, and spectrum then offers Deny and stop, sent as `decide(id, 'stop')`; a terminal's, a sprinkle's or a linked device's never does. `decide(id, decision, reason?)` rejects with the agent's message, and `ended` reports `answered`, `expired` or `withdrawn` for an item that left without this tab's decision. Every owner device's adapter has `decide`; a guest connection's doesn't. So a notice instead of a dialog shows only where nothing can answer. A `capture` item is a `CaptureApproval`, with the guest items' `agentId`, `agentName`, `always` and verdict fields and the item's `detail` as it is (`what`, `mode`, `seconds?`, `system?`, `microphone?`, `device?`, `program`), which spectrum 2.4.1 on shows as its capture line. A `guest-tool` approval also carries `args`, the call's arguments pretty-printed as JSON (two-space indent), so spectrum can show them uncut when `summary` is empty. The worker runs every string in the arguments through the secrets scrub before it files the item, so `summary`, `detail.arguments` and `args` show a secret as its placeholder; the seat's Always rules still match the call's own arguments. `args` is capped at 64 KiB (65,536 UTF-16 code units, `ARGS_LENGTH`, never splitting a surrogate pair): longer arguments are sent as that prefix with `argsTruncated: true`, and spectrum must then offer only Deny and Always deny, never Allow, because the end wasn't seen.
752
753
  - **Kernel sudo:** `AgentOwner.approve(req, { signal, where? })` from `startAgent` takes slicc-kernel's sudo request as it comes to the kernel's `approve` hook and resolves `once`, `always` or `deny`. bios hands its hook to it while the agent runs, and to its own dialog otherwise. It rejects with `code: 'EAGAIN'` before anything is recorded when the agent can't take the request (released, restarting, or an older worker) or when the request's `kind` isn't `sudo`, such as a program's secret `ask`, so that's when to fall back; any other rejection is a deny. The request goes through `slicc.agent.sudo`, a service only the owner's pages get, and becomes a `sudo` item on the `user` tier with the kernel's `expiresAt`:
753
754
  - **Requester** comes from the kernel's process tag: `{ kind: 'agent', agentId }` is the cone or scoop by its name, `{ kind: 'user', where }` is the kernel user with `where` (`terminal:…` reads "a terminal", `follower:<device>` the `where` the page passes, such as "on Pat's phone", or "a linked device", with the device id kept as `requester.device`), and anything else is the kernel user alone.
754
755
  - **Detail:** the command as the kernel resolved it (`path` and the arguments, shell-quoted), `target`, `cwd`, `alwaysScope: 'cwd'` when `req.always === true`, since the kernel's Always writes a rule for that directory, and the kernel's facts for the judge: `stdin` (`tty`, `none`, `pipe` or `file`), `rootOnly` (for each path on the line, whether only root can change it) and `writable` (`req.always`, whether the kernel can record the line). Requests without them still work; `req.always: false` or `writable: false` means no Always.
755
- - **Answers:** `approved` resolves its answer, a judge's rejection resolves a `SudoDenial`, `{ answer: 'deny', message: 'sudo: denied by the approval judge: <reason>' }` (the prefix is `JUDGE_DENIED`), so the shell can say who refused, and anything else `deny`. A kernel that doesn't know the object denies it as it denies any answer but `once` and `always`. Every device of the owner answers with the same powers: a follower, with or without Control, sees the same item, Always included when the verdict offers it, and its `always` counts as the owner tab's would. `device` on the item names the device that answered, from `owner.port({ device })`.
756
- - **Timestamps:** a kernel that keeps sudo timestamps (`Defaults timestamp_timeout`) says so with `req.timestamp: true`. To such a request, an approval decided by a person (`decidedBy` `owner` or `follower`) resolves `SudoTimestamp`, `{ answer: 'once' | 'always', timestamp: true }`, which lets the kernel open or refresh the timestamp, so that shell isn't asked again until it runs out. The judge's and the host's approvals stay plain `once`, and a scoop can't approve sudo at all, so none of them open the window. Denials don't change. A request without `timestamp: true` always gets the plain string, because an older kernel denies any object that isn't a denial.
756
+ - **Answers:** `approved` resolves its answer, a judge's rejection resolves a `SudoDenial`, `{ answer: 'deny', message: 'sudo: denied by the approval judge: <reason>' }` (the prefix is `JUDGE_DENIED`), so the shell can say who refused, a deny and stop resolves `{ answer: 'deny', message: 'sudo: denied, and the owner stopped this turn' }` (`STOPPED`), and anything else `deny`. A kernel that doesn't know the object denies it as it denies any answer but `once` and `always`. Every device of the owner answers with the same powers: a follower, with or without Control, sees the same item, Always included when the verdict offers it, and its `always` counts as the owner tab's would. `device` on the item names the device that answered, from `owner.port({ device })`.
757
+ - **Timestamps:** a kernel that keeps sudo timestamps (`Defaults timestamp_timeout`, slicc-kernel 1.177.0 or later) says so with `req.timestamp: true`. To such a request, an approval decided by a person (`decidedBy` `owner` or `follower`) resolves `SudoTimestamp`, `{ answer: 'once' | 'always', timestamp: true }`, which lets the kernel open or refresh the timestamp, so that shell isn't asked again until it runs out. The judge's and the host's approvals stay plain `once`, and a scoop can't approve sudo at all, so none of them open the window. Denials don't change. A request without `timestamp: true` always gets the plain string, because an older kernel denies any object that isn't a denial.
757
758
  - **`sudo -v`:** a request with `validate: true` has no command (argv may be empty). It is always on the `user` tier, whatever `sudo.approver` says, the judge never sees it, and it never offers Always (`writable: false`). Its `detail` is only `{ command: 'start a sudo timestamp for <user> (no command)', validate: true, writable: false }`, and a scoop's lick says it asked to start a sudo timestamp. Any other request with an empty argv is refused.
758
759
  - **Ends:** when the kernel aborts `signal` (`withdrawn`) the item is withdrawn, and on `expired` the page keeps its link until the record's own timeout settles it (`unanswered`), so it never reads as withdrawn. When the page's link closes the worker withdraws its open sudo items (`disconnected`). A restart or release of the owner first ends the old worker, then denies the requests still waiting, so the old worker never sees their links close, and the next worker withdraws their items (`restart`). The kernel already allows one pending request per user.
759
760
  - **Scoops:** a scoop's request sends its cone a `sudo-request` lick without actions once a person has to answer it (at once on the `user` tier, after the judge hands it on with the `agent` policy, never when the judge decides), so the cone knows the scoop waits and can't approve it itself. A cone that asks gets none: it waits in its own command.
@@ -68,6 +68,59 @@ const withdrawIn = (match, reason, now) => (doc) => {
68
68
  mark(item, { state: "withdrawn", by: "host", ...reason ? { reason } : {} }, now());
69
69
  return hit.map((item) => copy([item])[0]);
70
70
  };
71
+ const NO_STOP = "This agent can't stop a turn.";
72
+ function haltsOf(stop) {
73
+ const stopping = /* @__PURE__ */ new Map();
74
+ const of = (agentId) => [...stopping.values()].filter((entry) => entry.agentId === agentId);
75
+ const drop = (token) => {
76
+ stopping.get(token)?.release();
77
+ stopping.delete(token);
78
+ };
79
+ return {
80
+ halted: (agentId) => of(agentId).length > 0,
81
+ async idle(agentId) {
82
+ while (of(agentId).length) await Promise.all(of(agentId).map((entry) => entry.done));
83
+ },
84
+ able: (ruling) => ruling.stop && !stop ? { error: NO_STOP } : ruling,
85
+ begin(token, agentId) {
86
+ let release = () => {
87
+ };
88
+ const done = new Promise((resolve) => {
89
+ release = resolve;
90
+ });
91
+ drop(token);
92
+ stopping.set(token, { agentId, done, release });
93
+ },
94
+ drop,
95
+ async end(token) {
96
+ const entry = stopping.get(token);
97
+ if (!entry) return;
98
+ await Promise.resolve().then(() => stop?.(entry.agentId, BACKGROUND_CONTEXT)).catch(() => void 0);
99
+ drop(token);
100
+ }
101
+ };
102
+ }
103
+ const decidedIn = (id, { token, by, device, ruling: rule, halts, now }) => (doc) => {
104
+ halts.drop(token);
105
+ const item = doc.items.find((entry) => entry.id === id);
106
+ const ruling = item ? rule(item) : { error: `There is no approval ${id}.` };
107
+ if (item && ruling.settle) {
108
+ if (ruling.answer) item.answer = ruling.answer;
109
+ if (device && ruling.settle.by === by) item.device = device;
110
+ mark(item, ruling.settle, now());
111
+ }
112
+ if (ruling.error) return { done: false, state: null, error: ruling.error };
113
+ if (ruling.stop) {
114
+ halts.begin(token, ruling.stop);
115
+ stoppedIn(ruling.stop, id, now)(doc);
116
+ }
117
+ return { done: true, state: item.state, error: null };
118
+ };
119
+ const stoppedIn = (agentId, id, now) => withdrawIn(
120
+ (item) => item.id !== id && item.agentId === agentId && heldKind(item.kind),
121
+ REASONS.stopped,
122
+ now
123
+ );
71
124
  const routeOf = (item, { judgement, present }) => route(judgement.verdict, item.requester, gateOf(item.tier), present);
72
125
  const judgedIn = (id, judged, now) => (doc) => {
73
126
  const { judgement } = judged;
@@ -168,6 +221,7 @@ async function attachApprovals(options, context = BACKGROUND_CONTEXT) {
168
221
  const ttl = options.ttlMs ?? APPROVAL_MS;
169
222
  const setTimer = options.setTimer ?? systemTimer;
170
223
  const timers = /* @__PURE__ */ new Map();
224
+ const halts = haltsOf(options.stop);
171
225
  let line = Promise.resolve();
172
226
  let closed = false;
173
227
  const settle = (item, how) => mark(item, how, now());
@@ -256,6 +310,8 @@ async function attachApprovals(options, context = BACKGROUND_CONTEXT) {
256
310
  state,
257
311
  async request(draft, using) {
258
312
  let created = true;
313
+ const held = heldKind(draft.kind) && halts.halted(draft.agentId);
314
+ if (held) await halts.idle(draft.agentId);
259
315
  const made = await serial((doc) => {
260
316
  const kept = draft.id && doc.items.find((entry) => entry.id === draft.id);
261
317
  if (kept) {
@@ -263,6 +319,8 @@ async function attachApprovals(options, context = BACKGROUND_CONTEXT) {
263
319
  return copy([kept])[0];
264
320
  }
265
321
  const item = fresh(draft, now(), ttl, options);
322
+ if (item.state === "pending" && heldKind(item.kind) && (held || halts.halted(item.agentId)))
323
+ settle(item, { state: "withdrawn", by: "host", reason: REASONS.stopped });
266
324
  doc.items.push(item);
267
325
  return copy([item])[0];
268
326
  }, using);
@@ -271,20 +329,17 @@ async function attachApprovals(options, context = BACKGROUND_CONTEXT) {
271
329
  if (created) toScoop(made);
272
330
  return made;
273
331
  },
274
- decide(id, answer, reason, decider, using) {
332
+ async decide(id, answer, reason, decider, using) {
275
333
  const { by, device } = deciderOf(decider);
276
- return serial((doc) => {
277
- const item = doc.items.find((entry) => entry.id === id);
278
- const ruling = item ? ruled(item, answer, reason, by, now()) : { error: `There is no approval ${id}.` };
279
- if (item && ruling.settle) {
280
- if (ruling.answer) item.answer = ruling.answer;
281
- if (device && ruling.settle.by === by) item.device = device;
282
- settle(item, ruling.settle);
283
- }
284
- if ("error" in ruling && ruling.error)
285
- return { done: false, state: null, error: ruling.error };
286
- return { done: true, state: item.state, error: null };
287
- }, using);
334
+ const token = {};
335
+ const ruling = (item) => halts.able(ruled(item, answer, reason, by, now()));
336
+ const deciding = { token, by, device, ruling, halts, now };
337
+ const decided = await serial(decidedIn(id, deciding), using).catch((error) => {
338
+ halts.drop(token);
339
+ throw error;
340
+ });
341
+ await halts.end(token);
342
+ return decided;
288
343
  },
289
344
  settled: (id, using) => settledIn(state, id, using),
290
345
  assign(id, reviewer, using) {
@@ -324,6 +379,7 @@ async function attachApprovals(options, context = BACKGROUND_CONTEXT) {
324
379
  };
325
380
  }
326
381
  export {
382
+ NO_STOP,
327
383
  attachApprovals
328
384
  };
329
385
  //# sourceMappingURL=index.js.map
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/approvals/index.ts"],
4
- "sourcesContent": ["import {\n type Context,\n type ReplicatedState,\n replicatedState,\n type WatchHandle,\n} from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { Harness } from '@earendil-works/pi-durable';\nimport type { Clock } from '../clock.ts';\nimport { type ApprovalJudge, ASK_MIN_MS, JUDGE_RESTARTED, type Judgement } from './judge.ts';\nimport {\n APPROVAL_MS,\n type Approval,\n type ApprovalDraft,\n type ApprovalKind,\n type ApprovalState,\n ApprovalsDoc,\n type ApprovalsState,\n alwaysOffered,\n cleanReason,\n type DecidedBy,\n gateOf,\n guestKind,\n heldKind,\n knownTier,\n MAX_DELAY,\n personOnly,\n prune,\n REASONS,\n type Routed,\n routable,\n route,\n ruled,\n type Settle,\n scoopTier,\n sudoApprover,\n tierOf,\n} from './record.ts';\n\nexport * from './intent.ts';\nexport * from './judge.ts';\nexport * from './present.ts';\nexport * from './record.ts';\n\nexport type ApprovalDecided =\n | { done: true; state: ApprovalState; error: null }\n | { done: false; state: null; error: string };\n\nexport type Decider = DecidedBy | { by: DecidedBy; device?: string };\n\nconst deciderOf = (decider: Decider) => (typeof decider === 'string' ? { by: decider } : decider);\n\nexport interface Approvals {\n readonly state: ReplicatedState<Approval[]>;\n request(draft: ApprovalDraft & { id?: string }, context: Context): Promise<Approval>;\n decide(\n id: string,\n answer: unknown,\n reason: string | null,\n by: Decider,\n context: Context\n ): Promise<ApprovalDecided>;\n settled(id: string, context: Context): Promise<Approval>;\n assign(id: string, reviewer: string, context: Context): Promise<Approval | undefined>;\n withdraw(id: string, reason: string | null, context: Context): Promise<Approval | undefined>;\n withdrawSeat(seat: string, context: Context): Promise<number>;\n expire(id: string, context: Context): Promise<Approval | undefined>;\n close(): void;\n}\n\nexport interface ScoopRouter {\n route(item: Approval): Promise<void>;\n}\n\nexport interface ApprovalsAttach {\n harness: Pick<Harness, 'commit' | 'watchDoc'>;\n now?: () => number;\n setTimer?: Clock['setTimer'];\n ttlMs?: number;\n judge?: ApprovalJudge;\n scoops?: ScoopRouter;\n guestAlways?: (kind: ApprovalKind) => boolean;\n sudoApprover?: () => unknown;\n present?: (item: Approval, context: Context) => Promise<boolean>;\n}\n\nconst copy = (items: readonly Approval[]): Approval[] => JSON.parse(JSON.stringify(items));\n\nfunction mark(item: Approval, how: Settle, at: number) {\n item.state = how.state;\n item.decidedBy = how.by;\n item.decidedAt = at;\n delete item.judging;\n if (how.reason) item.reason = how.reason;\n}\n\nconst offered = (options: ApprovalsAttach, draft: ApprovalDraft): boolean =>\n guestKind(draft.kind) && draft.kind !== 'capture'\n ? options.guestAlways?.(draft.kind) === true\n : false;\n\nconst judgedKind = (item: Pick<ApprovalDraft, 'kind' | 'detail'>, tier: string) =>\n !personOnly(item) && (item.kind === 'sudo' || tier === 'agent' || tier === 'user');\n\nfunction detailOf(draft: ApprovalDraft): ApprovalDraft['detail'] {\n if (draft.kind !== 'sudo' || draft.always !== false) return draft.detail;\n return { ...draft.detail, writable: false };\n}\n\nfunction fresh(\n draft: ApprovalDraft & { id?: string },\n at: number,\n ttl: number,\n options: ApprovalsAttach\n): Approval {\n const tier = tierOf(draft, sudoApprover(options.sudoApprover?.()));\n const item = {\n ...draft,\n detail: detailOf(draft),\n tier,\n id: draft.id ?? `apr-${crypto.randomUUID()}`,\n state: 'pending',\n decidedBy: null,\n always: offered(options, draft),\n ...(options.judge && judgedKind(draft, tier) ? { judging: true } : {}),\n createdAt: at,\n expiresAt: draft.expiresAt ?? at + ttl,\n } as Approval;\n if (!knownTier(item.tier))\n mark(item, { state: 'unanswered', by: 'host', reason: REASONS.unknownTier }, at);\n else if (!routable(draft.kind, item.tier))\n mark(item, { state: 'unanswered', by: 'host', reason: REASONS.unroutable }, at);\n return item;\n}\n\nconst withdrawIn =\n (match: (item: Approval) => boolean, reason: string | undefined, now: () => number) =>\n (doc: ApprovalsState) => {\n const hit = doc.items.filter((item) => item.state === 'pending' && match(item));\n for (const item of hit)\n mark(item, { state: 'withdrawn', by: 'host', ...(reason ? { reason } : {}) }, now());\n return hit.map((item) => copy([item])[0] as Approval);\n };\n\ntype Judged = { judgement: Judgement; present: boolean; offer?: boolean };\n\nconst routeOf = (item: Approval, { judgement, present }: Judged): Routed =>\n route(judgement.verdict, item.requester, gateOf(item.tier), present);\n\nconst judgedIn = (id: string, judged: Judged, now: () => number) => (doc: ApprovalsState) => {\n const { judgement } = judged;\n const item = doc.items.find((entry) => entry.id === id);\n if (!item) return undefined;\n const late = item.state === 'unanswered' && item.reason === REASONS.timeout && !item.verdict;\n if (item.state !== 'pending' && !(late && judgement.verdict)) return undefined;\n delete item.judging;\n if (judgement.verdict) item.verdict = judgement.verdict;\n else item.verdictError = judgement.error ?? 'the judge gave no verdict';\n if (late) return copy([item])[0] as Approval;\n const routed = routeOf(item, judged);\n if (routed === 'ask') {\n item.tier = 'user';\n if (item.kind === 'sudo') item.always = alwaysOffered(item);\n if (item.kind === 'capture') item.always = alwaysOffered(item) && judged.offer === true;\n return copy([item])[0] as Approval;\n }\n const at = now();\n const ruling = ruled(item, routed === 'approve' ? 'once' : 'deny', null, 'judge', at);\n if (ruling.answer) item.answer = ruling.answer;\n if (ruling.settle) mark(item, ruling.settle, at);\n return copy([item])[0] as Approval;\n};\n\nasync function judgedBy(\n judge: ApprovalJudge,\n present: ApprovalsAttach['present'],\n item: Approval,\n using: Context,\n now: () => number\n): Promise<Judged> {\n const judgement = await judge\n .judge(item, using)\n .catch((error: unknown): Judgement => ({ error: String(error) }));\n if (judgement.verdict?.level !== 3 || !present || item.tier !== 'agent')\n return { judgement, present: false };\n const there = await present(item, using).catch(() => false);\n return { judgement, present: there && item.expiresAt - now() >= ASK_MIN_MS };\n}\n\ntype Serial = <R>(change: (doc: ApprovalsState) => R, using: Context) => Promise<R>;\n\nfunction judgeRunner(run: {\n serial: Serial;\n present: ApprovalsAttach['present'];\n guestAlways: ApprovalsAttach['guestAlways'];\n now: () => number;\n closed: () => boolean;\n}) {\n const { serial, now } = run;\n return async (judge: ApprovalJudge, item: Approval, using: Context) => {\n const signal = using.abortSignal;\n let gone = false;\n const abort = () => {\n gone = true;\n void serial(\n withdrawIn((entry) => entry.id === item.id && entry.tier === 'agent', REASONS.aborted, now),\n BACKGROUND_CONTEXT\n ).catch(() => undefined);\n };\n if (signal?.aborted) return abort();\n signal?.addEventListener('abort', abort, { once: true });\n const found = await judgedBy(judge, run.present, item, using, now);\n signal?.removeEventListener('abort', abort);\n if (gone || run.closed()) return;\n const judged = { ...found, offer: run.guestAlways?.(item.kind) === true };\n const after = await serial(judgedIn(item.id, judged, now), BACKGROUND_CONTEXT).catch(\n () => undefined\n );\n if (!after) return;\n await judge.record?.(after, judged.judgement, BACKGROUND_CONTEXT).catch(() => undefined);\n };\n}\n\nfunction following(\n watch: WatchHandle<Readonly<ApprovalsState>>,\n changed: (using: Context, items: Approval[]) => void\n) {\n const items = () => watch.value.items;\n let shown = items();\n return (using: Context) => {\n const now = items();\n if (now === shown) return;\n shown = now;\n changed(using, copy(now));\n };\n}\n\nfunction settledIn(\n state: ReplicatedState<Approval[]>,\n id: string,\n using: Context\n): Promise<Approval> {\n return new Promise((resolve, reject) => {\n const signal = using.abortSignal;\n let done = false;\n let off: (() => void) | undefined;\n const finish = (end: () => void) => {\n done = true;\n off?.();\n signal?.removeEventListener('abort', abort);\n end();\n };\n const abort = () => finish(() => reject(signal?.reason));\n const check = (items: readonly Approval[] | undefined) => {\n const item = items?.find((entry) => entry.id === id);\n if (!item) finish(() => reject(new Error(`There is no approval ${id}.`)));\n else if (item.state !== 'pending') finish(() => resolve(item));\n };\n if (signal?.aborted) return abort();\n check(state.value);\n if (done) return;\n signal?.addEventListener('abort', abort, { once: true });\n off = state.subscribe((items) => check(items));\n });\n}\n\nconst systemTimer: Clock['setTimer'] = (callback, delayMs) => {\n const timer = setTimeout(callback, delayMs);\n return () => clearTimeout(timer);\n};\n\nexport async function attachApprovals(\n options: ApprovalsAttach,\n context: Context = BACKGROUND_CONTEXT\n): Promise<Approvals> {\n const { harness } = options;\n const now = options.now ?? Date.now;\n const ttl = options.ttlMs ?? APPROVAL_MS;\n const setTimer = options.setTimer ?? systemTimer;\n const timers = new Map<string, () => void>();\n let line: Promise<unknown> = Promise.resolve();\n let closed = false;\n const settle = (item: Approval, how: Settle) => mark(item, how, now());\n const write = <R>(\n change: (doc: ApprovalsState) => R,\n using: Context\n ): Promise<{ result: R; items: Approval[] }> =>\n harness.commit(async (tx) => {\n const doc = await tx.doc(ApprovalsDoc);\n const result = change(doc);\n doc.items = prune(doc.items);\n return { result, items: copy(doc.items) };\n }, using);\n const startup = await write((doc) => {\n for (const item of doc.items) {\n if (item.state !== 'pending') continue;\n if (heldKind(item.kind))\n settle(item, { state: 'withdrawn', by: 'host', reason: REASONS.restart });\n else if (item.expiresAt <= now())\n settle(item, { state: 'unanswered', by: 'host', reason: REASONS.timeout });\n else if (options.judge && item.tier === 'agent') item.tier = 'user';\n if (item.state === 'pending' && item.judging) {\n delete item.judging;\n item.verdictError = JUDGE_RESTARTED;\n }\n }\n }, context);\n const state = replicatedState<Approval[]>(startup.items);\n const watch = await harness.watchDoc(ApprovalsDoc, context);\n if (!watch) throw new Error('approvals document is missing');\n const follow = following(watch, (using, items) => {\n state.replace(using, items);\n arm(items);\n });\n follow(context);\n watch.start(async (call, using) => {\n if (call.kind === 'value') follow(using);\n });\n const serial = <R>(change: (doc: ApprovalsState) => R, using: Context): Promise<R> => {\n const run = line.then(async () => {\n const { result } = await write(change, using);\n follow(using);\n return result;\n });\n line = run.catch(() => undefined);\n return run;\n };\n const expire = (id: string) => {\n timers.delete(id);\n const due = (state.value as Approval[]).find((entry) => entry.id === id);\n if (due?.state === 'pending' && due.expiresAt > now()) return arm(state.value as Approval[]);\n void serial((doc) => {\n const item = doc.items.find((entry) => entry.id === id);\n if (item?.state === 'pending' && item.expiresAt <= now())\n settle(item, { state: 'unanswered', by: 'host', reason: REASONS.timeout });\n }, BACKGROUND_CONTEXT).catch(() => undefined);\n };\n function arm(items: readonly Approval[]) {\n const pending = new Set<string>();\n for (const item of items) {\n if (item.state !== 'pending') continue;\n pending.add(item.id);\n if (timers.has(item.id) || closed) continue;\n timers.set(\n item.id,\n setTimer(() => expire(item.id), Math.min(MAX_DELAY, Math.max(0, item.expiresAt - now())))\n );\n }\n for (const [id, timer] of timers)\n if (!pending.has(id)) {\n timer();\n timers.delete(id);\n }\n }\n arm(startup.items);\n const toScoop = (item: Approval) => {\n if (options.scoops && item.state === 'pending' && scoopTier(item.tier))\n void options.scoops.route(item).catch(() => undefined);\n };\n for (const item of startup.items) toScoop(item);\n const withdrawWhere = (match: (item: Approval) => boolean, reason: string | undefined) =>\n withdrawIn(match, reason, now);\n const judging = judgeRunner({\n serial,\n present: options.present,\n guestAlways: options.guestAlways,\n now,\n closed: () => closed,\n });\n return {\n state,\n async request(draft, using) {\n let created = true;\n const made = await serial((doc) => {\n const kept = draft.id && doc.items.find((entry) => entry.id === draft.id);\n if (kept) {\n created = false;\n return copy([kept])[0] as Approval;\n }\n const item = fresh(draft, now(), ttl, options);\n doc.items.push(item);\n return copy([item])[0] as Approval;\n }, using);\n if (created && options.judge && made.state === 'pending' && judgedKind(made, made.tier))\n void judging(options.judge, made, made.tier === 'agent' ? using : BACKGROUND_CONTEXT);\n if (created) toScoop(made);\n return made;\n },\n decide(id, answer, reason, decider, using) {\n const { by, device } = deciderOf(decider);\n return serial((doc): ApprovalDecided => {\n const item = doc.items.find((entry) => entry.id === id);\n const ruling = item\n ? ruled(item, answer, reason, by, now())\n : { error: `There is no approval ${id}.` };\n if (item && ruling.settle) {\n if (ruling.answer) item.answer = ruling.answer;\n if (device && ruling.settle.by === by) item.device = device;\n settle(item, ruling.settle);\n }\n if ('error' in ruling && ruling.error)\n return { done: false, state: null, error: ruling.error };\n return { done: true, state: (item as Approval).state, error: null };\n }, using);\n },\n settled: (id, using) => settledIn(state, id, using),\n assign(id, reviewer, using) {\n return serial((doc) => {\n const item = doc.items.find((entry) => entry.id === id);\n if (item?.state === 'pending' && scoopTier(item.tier)) item.reviewer ??= reviewer;\n return item ? (copy([item])[0] as Approval) : undefined;\n }, using);\n },\n async withdraw(id, reason, using) {\n const [hit] = await serial(\n withdrawWhere((item) => item.id === id, cleanReason(reason)),\n using\n );\n return hit;\n },\n async withdrawSeat(seat, using) {\n return (\n await serial(\n withdrawWhere((item) => item.seat === seat, REASONS.revoked),\n using\n )\n ).length;\n },\n async expire(id, using) {\n return serial((doc) => {\n const item = doc.items.find((entry) => entry.id === id);\n if (item?.state === 'pending' && item.expiresAt <= now())\n settle(item, { state: 'unanswered', by: 'host', reason: REASONS.timeout });\n return item ? (copy([item])[0] as Approval) : undefined;\n }, using);\n },\n close() {\n closed = true;\n for (const timer of timers.values()) timer();\n timers.clear();\n void watch.stop();\n },\n };\n}\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["import {\n type Context,\n type ReplicatedState,\n replicatedState,\n type WatchHandle,\n} from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { Harness } from '@earendil-works/pi-durable';\nimport type { Clock } from '../clock.ts';\nimport { type ApprovalJudge, ASK_MIN_MS, JUDGE_RESTARTED, type Judgement } from './judge.ts';\nimport {\n APPROVAL_MS,\n type Approval,\n type ApprovalDraft,\n type ApprovalKind,\n type ApprovalState,\n ApprovalsDoc,\n type ApprovalsState,\n alwaysOffered,\n cleanReason,\n type DecidedBy,\n gateOf,\n guestKind,\n heldKind,\n knownTier,\n MAX_DELAY,\n personOnly,\n prune,\n REASONS,\n type Routed,\n type Ruling,\n routable,\n route,\n ruled,\n type Settle,\n scoopTier,\n sudoApprover,\n tierOf,\n} from './record.ts';\n\nexport * from './intent.ts';\nexport * from './judge.ts';\nexport * from './present.ts';\nexport * from './record.ts';\n\nexport type ApprovalDecided =\n | { done: true; state: ApprovalState; error: null }\n | { done: false; state: null; error: string };\n\nexport type Decider = DecidedBy | { by: DecidedBy; device?: string };\n\nconst deciderOf = (decider: Decider) => (typeof decider === 'string' ? { by: decider } : decider);\n\nexport interface Approvals {\n readonly state: ReplicatedState<Approval[]>;\n request(draft: ApprovalDraft & { id?: string }, context: Context): Promise<Approval>;\n decide(\n id: string,\n answer: unknown,\n reason: string | null,\n by: Decider,\n context: Context\n ): Promise<ApprovalDecided>;\n settled(id: string, context: Context): Promise<Approval>;\n assign(id: string, reviewer: string, context: Context): Promise<Approval | undefined>;\n withdraw(id: string, reason: string | null, context: Context): Promise<Approval | undefined>;\n withdrawSeat(seat: string, context: Context): Promise<number>;\n expire(id: string, context: Context): Promise<Approval | undefined>;\n close(): void;\n}\n\nexport interface ScoopRouter {\n route(item: Approval): Promise<void>;\n}\n\nexport interface ApprovalsAttach {\n harness: Pick<Harness, 'commit' | 'watchDoc'>;\n now?: () => number;\n setTimer?: Clock['setTimer'];\n ttlMs?: number;\n judge?: ApprovalJudge;\n scoops?: ScoopRouter;\n guestAlways?: (kind: ApprovalKind) => boolean;\n sudoApprover?: () => unknown;\n present?: (item: Approval, context: Context) => Promise<boolean>;\n stop?: (agentId: string, context: Context) => Promise<void>;\n}\n\nconst copy = (items: readonly Approval[]): Approval[] => JSON.parse(JSON.stringify(items));\n\nfunction mark(item: Approval, how: Settle, at: number) {\n item.state = how.state;\n item.decidedBy = how.by;\n item.decidedAt = at;\n delete item.judging;\n if (how.reason) item.reason = how.reason;\n}\n\nconst offered = (options: ApprovalsAttach, draft: ApprovalDraft): boolean =>\n guestKind(draft.kind) && draft.kind !== 'capture'\n ? options.guestAlways?.(draft.kind) === true\n : false;\n\nconst judgedKind = (item: Pick<ApprovalDraft, 'kind' | 'detail'>, tier: string) =>\n !personOnly(item) && (item.kind === 'sudo' || tier === 'agent' || tier === 'user');\n\nfunction detailOf(draft: ApprovalDraft): ApprovalDraft['detail'] {\n if (draft.kind !== 'sudo' || draft.always !== false) return draft.detail;\n return { ...draft.detail, writable: false };\n}\n\nfunction fresh(\n draft: ApprovalDraft & { id?: string },\n at: number,\n ttl: number,\n options: ApprovalsAttach\n): Approval {\n const tier = tierOf(draft, sudoApprover(options.sudoApprover?.()));\n const item = {\n ...draft,\n detail: detailOf(draft),\n tier,\n id: draft.id ?? `apr-${crypto.randomUUID()}`,\n state: 'pending',\n decidedBy: null,\n always: offered(options, draft),\n ...(options.judge && judgedKind(draft, tier) ? { judging: true } : {}),\n createdAt: at,\n expiresAt: draft.expiresAt ?? at + ttl,\n } as Approval;\n if (!knownTier(item.tier))\n mark(item, { state: 'unanswered', by: 'host', reason: REASONS.unknownTier }, at);\n else if (!routable(draft.kind, item.tier))\n mark(item, { state: 'unanswered', by: 'host', reason: REASONS.unroutable }, at);\n return item;\n}\n\nconst withdrawIn =\n (match: (item: Approval) => boolean, reason: string | undefined, now: () => number) =>\n (doc: ApprovalsState) => {\n const hit = doc.items.filter((item) => item.state === 'pending' && match(item));\n for (const item of hit)\n mark(item, { state: 'withdrawn', by: 'host', ...(reason ? { reason } : {}) }, now());\n return hit.map((item) => copy([item])[0] as Approval);\n };\n\nexport const NO_STOP = \"This agent can't stop a turn.\";\n\ntype Halts = ReturnType<typeof haltsOf>;\n\ntype Halt = { agentId: string; done: Promise<void>; release: () => void };\n\nfunction haltsOf(stop: ApprovalsAttach['stop']) {\n const stopping = new Map<object, Halt>();\n const of = (agentId: string) =>\n [...stopping.values()].filter((entry) => entry.agentId === agentId);\n const drop = (token: object) => {\n stopping.get(token)?.release();\n stopping.delete(token);\n };\n return {\n halted: (agentId: string) => of(agentId).length > 0,\n async idle(agentId: string) {\n while (of(agentId).length) await Promise.all(of(agentId).map((entry) => entry.done));\n },\n able: (ruling: Ruling): Ruling => (ruling.stop && !stop ? { error: NO_STOP } : ruling),\n begin(token: object, agentId: string) {\n let release = () => {};\n const done = new Promise<void>((resolve) => {\n release = resolve;\n });\n drop(token);\n stopping.set(token, { agentId, done, release });\n },\n drop,\n async end(token: object) {\n const entry = stopping.get(token);\n if (!entry) return;\n await Promise.resolve()\n .then(() => stop?.(entry.agentId, BACKGROUND_CONTEXT))\n .catch(() => undefined);\n drop(token);\n },\n };\n}\n\ntype Deciding = {\n token: object;\n by: DecidedBy;\n device: string | undefined;\n ruling: (item: Approval) => Ruling;\n halts: Halts;\n now: () => number;\n};\n\nconst decidedIn =\n (id: string, { token, by, device, ruling: rule, halts, now }: Deciding) =>\n (doc: ApprovalsState): ApprovalDecided => {\n halts.drop(token);\n const item = doc.items.find((entry) => entry.id === id);\n const ruling: Ruling = item ? rule(item) : { error: `There is no approval ${id}.` };\n if (item && ruling.settle) {\n if (ruling.answer) item.answer = ruling.answer;\n if (device && ruling.settle.by === by) item.device = device;\n mark(item, ruling.settle, now());\n }\n if (ruling.error) return { done: false, state: null, error: ruling.error };\n if (ruling.stop) {\n halts.begin(token, ruling.stop);\n stoppedIn(ruling.stop, id, now)(doc);\n }\n return { done: true, state: (item as Approval).state, error: null };\n };\n\nconst stoppedIn = (agentId: string, id: string, now: () => number) =>\n withdrawIn(\n (item) => item.id !== id && item.agentId === agentId && heldKind(item.kind),\n REASONS.stopped,\n now\n );\n\ntype Judged = { judgement: Judgement; present: boolean; offer?: boolean };\n\nconst routeOf = (item: Approval, { judgement, present }: Judged): Routed =>\n route(judgement.verdict, item.requester, gateOf(item.tier), present);\n\nconst judgedIn = (id: string, judged: Judged, now: () => number) => (doc: ApprovalsState) => {\n const { judgement } = judged;\n const item = doc.items.find((entry) => entry.id === id);\n if (!item) return undefined;\n const late = item.state === 'unanswered' && item.reason === REASONS.timeout && !item.verdict;\n if (item.state !== 'pending' && !(late && judgement.verdict)) return undefined;\n delete item.judging;\n if (judgement.verdict) item.verdict = judgement.verdict;\n else item.verdictError = judgement.error ?? 'the judge gave no verdict';\n if (late) return copy([item])[0] as Approval;\n const routed = routeOf(item, judged);\n if (routed === 'ask') {\n item.tier = 'user';\n if (item.kind === 'sudo') item.always = alwaysOffered(item);\n if (item.kind === 'capture') item.always = alwaysOffered(item) && judged.offer === true;\n return copy([item])[0] as Approval;\n }\n const at = now();\n const ruling = ruled(item, routed === 'approve' ? 'once' : 'deny', null, 'judge', at);\n if (ruling.answer) item.answer = ruling.answer;\n if (ruling.settle) mark(item, ruling.settle, at);\n return copy([item])[0] as Approval;\n};\n\nasync function judgedBy(\n judge: ApprovalJudge,\n present: ApprovalsAttach['present'],\n item: Approval,\n using: Context,\n now: () => number\n): Promise<Judged> {\n const judgement = await judge\n .judge(item, using)\n .catch((error: unknown): Judgement => ({ error: String(error) }));\n if (judgement.verdict?.level !== 3 || !present || item.tier !== 'agent')\n return { judgement, present: false };\n const there = await present(item, using).catch(() => false);\n return { judgement, present: there && item.expiresAt - now() >= ASK_MIN_MS };\n}\n\ntype Serial = <R>(change: (doc: ApprovalsState) => R, using: Context) => Promise<R>;\n\nfunction judgeRunner(run: {\n serial: Serial;\n present: ApprovalsAttach['present'];\n guestAlways: ApprovalsAttach['guestAlways'];\n now: () => number;\n closed: () => boolean;\n}) {\n const { serial, now } = run;\n return async (judge: ApprovalJudge, item: Approval, using: Context) => {\n const signal = using.abortSignal;\n let gone = false;\n const abort = () => {\n gone = true;\n void serial(\n withdrawIn((entry) => entry.id === item.id && entry.tier === 'agent', REASONS.aborted, now),\n BACKGROUND_CONTEXT\n ).catch(() => undefined);\n };\n if (signal?.aborted) return abort();\n signal?.addEventListener('abort', abort, { once: true });\n const found = await judgedBy(judge, run.present, item, using, now);\n signal?.removeEventListener('abort', abort);\n if (gone || run.closed()) return;\n const judged = { ...found, offer: run.guestAlways?.(item.kind) === true };\n const after = await serial(judgedIn(item.id, judged, now), BACKGROUND_CONTEXT).catch(\n () => undefined\n );\n if (!after) return;\n await judge.record?.(after, judged.judgement, BACKGROUND_CONTEXT).catch(() => undefined);\n };\n}\n\nfunction following(\n watch: WatchHandle<Readonly<ApprovalsState>>,\n changed: (using: Context, items: Approval[]) => void\n) {\n const items = () => watch.value.items;\n let shown = items();\n return (using: Context) => {\n const now = items();\n if (now === shown) return;\n shown = now;\n changed(using, copy(now));\n };\n}\n\nfunction settledIn(\n state: ReplicatedState<Approval[]>,\n id: string,\n using: Context\n): Promise<Approval> {\n return new Promise((resolve, reject) => {\n const signal = using.abortSignal;\n let done = false;\n let off: (() => void) | undefined;\n const finish = (end: () => void) => {\n done = true;\n off?.();\n signal?.removeEventListener('abort', abort);\n end();\n };\n const abort = () => finish(() => reject(signal?.reason));\n const check = (items: readonly Approval[] | undefined) => {\n const item = items?.find((entry) => entry.id === id);\n if (!item) finish(() => reject(new Error(`There is no approval ${id}.`)));\n else if (item.state !== 'pending') finish(() => resolve(item));\n };\n if (signal?.aborted) return abort();\n check(state.value);\n if (done) return;\n signal?.addEventListener('abort', abort, { once: true });\n off = state.subscribe((items) => check(items));\n });\n}\n\nconst systemTimer: Clock['setTimer'] = (callback, delayMs) => {\n const timer = setTimeout(callback, delayMs);\n return () => clearTimeout(timer);\n};\n\nexport async function attachApprovals(\n options: ApprovalsAttach,\n context: Context = BACKGROUND_CONTEXT\n): Promise<Approvals> {\n const { harness } = options;\n const now = options.now ?? Date.now;\n const ttl = options.ttlMs ?? APPROVAL_MS;\n const setTimer = options.setTimer ?? systemTimer;\n const timers = new Map<string, () => void>();\n const halts = haltsOf(options.stop);\n let line: Promise<unknown> = Promise.resolve();\n let closed = false;\n const settle = (item: Approval, how: Settle) => mark(item, how, now());\n const write = <R>(\n change: (doc: ApprovalsState) => R,\n using: Context\n ): Promise<{ result: R; items: Approval[] }> =>\n harness.commit(async (tx) => {\n const doc = await tx.doc(ApprovalsDoc);\n const result = change(doc);\n doc.items = prune(doc.items);\n return { result, items: copy(doc.items) };\n }, using);\n const startup = await write((doc) => {\n for (const item of doc.items) {\n if (item.state !== 'pending') continue;\n if (heldKind(item.kind))\n settle(item, { state: 'withdrawn', by: 'host', reason: REASONS.restart });\n else if (item.expiresAt <= now())\n settle(item, { state: 'unanswered', by: 'host', reason: REASONS.timeout });\n else if (options.judge && item.tier === 'agent') item.tier = 'user';\n if (item.state === 'pending' && item.judging) {\n delete item.judging;\n item.verdictError = JUDGE_RESTARTED;\n }\n }\n }, context);\n const state = replicatedState<Approval[]>(startup.items);\n const watch = await harness.watchDoc(ApprovalsDoc, context);\n if (!watch) throw new Error('approvals document is missing');\n const follow = following(watch, (using, items) => {\n state.replace(using, items);\n arm(items);\n });\n follow(context);\n watch.start(async (call, using) => {\n if (call.kind === 'value') follow(using);\n });\n const serial = <R>(change: (doc: ApprovalsState) => R, using: Context): Promise<R> => {\n const run = line.then(async () => {\n const { result } = await write(change, using);\n follow(using);\n return result;\n });\n line = run.catch(() => undefined);\n return run;\n };\n const expire = (id: string) => {\n timers.delete(id);\n const due = (state.value as Approval[]).find((entry) => entry.id === id);\n if (due?.state === 'pending' && due.expiresAt > now()) return arm(state.value as Approval[]);\n void serial((doc) => {\n const item = doc.items.find((entry) => entry.id === id);\n if (item?.state === 'pending' && item.expiresAt <= now())\n settle(item, { state: 'unanswered', by: 'host', reason: REASONS.timeout });\n }, BACKGROUND_CONTEXT).catch(() => undefined);\n };\n function arm(items: readonly Approval[]) {\n const pending = new Set<string>();\n for (const item of items) {\n if (item.state !== 'pending') continue;\n pending.add(item.id);\n if (timers.has(item.id) || closed) continue;\n timers.set(\n item.id,\n setTimer(() => expire(item.id), Math.min(MAX_DELAY, Math.max(0, item.expiresAt - now())))\n );\n }\n for (const [id, timer] of timers)\n if (!pending.has(id)) {\n timer();\n timers.delete(id);\n }\n }\n arm(startup.items);\n const toScoop = (item: Approval) => {\n if (options.scoops && item.state === 'pending' && scoopTier(item.tier))\n void options.scoops.route(item).catch(() => undefined);\n };\n for (const item of startup.items) toScoop(item);\n const withdrawWhere = (match: (item: Approval) => boolean, reason: string | undefined) =>\n withdrawIn(match, reason, now);\n const judging = judgeRunner({\n serial,\n present: options.present,\n guestAlways: options.guestAlways,\n now,\n closed: () => closed,\n });\n return {\n state,\n async request(draft, using) {\n let created = true;\n const held = heldKind(draft.kind) && halts.halted(draft.agentId);\n if (held) await halts.idle(draft.agentId);\n const made = await serial((doc) => {\n const kept = draft.id && doc.items.find((entry) => entry.id === draft.id);\n if (kept) {\n created = false;\n return copy([kept])[0] as Approval;\n }\n const item = fresh(draft, now(), ttl, options);\n if (item.state === 'pending' && heldKind(item.kind) && (held || halts.halted(item.agentId)))\n settle(item, { state: 'withdrawn', by: 'host', reason: REASONS.stopped });\n doc.items.push(item);\n return copy([item])[0] as Approval;\n }, using);\n if (created && options.judge && made.state === 'pending' && judgedKind(made, made.tier))\n void judging(options.judge, made, made.tier === 'agent' ? using : BACKGROUND_CONTEXT);\n if (created) toScoop(made);\n return made;\n },\n async decide(id, answer, reason, decider, using) {\n const { by, device } = deciderOf(decider);\n const token = {};\n const ruling = (item: Approval) => halts.able(ruled(item, answer, reason, by, now()));\n const deciding = { token, by, device, ruling, halts, now };\n const decided = await serial(decidedIn(id, deciding), using).catch((error: unknown) => {\n halts.drop(token);\n throw error;\n });\n await halts.end(token);\n return decided;\n },\n settled: (id, using) => settledIn(state, id, using),\n assign(id, reviewer, using) {\n return serial((doc) => {\n const item = doc.items.find((entry) => entry.id === id);\n if (item?.state === 'pending' && scoopTier(item.tier)) item.reviewer ??= reviewer;\n return item ? (copy([item])[0] as Approval) : undefined;\n }, using);\n },\n async withdraw(id, reason, using) {\n const [hit] = await serial(\n withdrawWhere((item) => item.id === id, cleanReason(reason)),\n using\n );\n return hit;\n },\n async withdrawSeat(seat, using) {\n return (\n await serial(\n withdrawWhere((item) => item.seat === seat, REASONS.revoked),\n using\n )\n ).length;\n },\n async expire(id, using) {\n return serial((doc) => {\n const item = doc.items.find((entry) => entry.id === id);\n if (item?.state === 'pending' && item.expiresAt <= now())\n settle(item, { state: 'unanswered', by: 'host', reason: REASONS.timeout });\n return item ? (copy([item])[0] as Approval) : undefined;\n }, using);\n },\n close() {\n closed = true;\n for (const timer of timers.values()) timer();\n timers.clear();\n void watch.stop();\n },\n };\n}\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -0,0 +1,19 @@
1
+ const REASONS = {
2
+ timeout: "timeout",
3
+ unknownTier: "unknown-tier",
4
+ unroutable: "unroutable",
5
+ unknownAnswer: "unknown-answer",
6
+ restart: "restart",
7
+ revoked: "revoked",
8
+ aborted: "aborted",
9
+ disconnected: "disconnected",
10
+ noScoop: "no-scoop",
11
+ scoopStopped: "scoop-stopped",
12
+ scoopAsked: "scoop-asked",
13
+ scoopUndecided: "scoop-undecided",
14
+ stopped: "stopped"
15
+ };
16
+ export {
17
+ REASONS
18
+ };
19
+ //# sourceMappingURL=reasons.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../src/approvals/reasons.ts"],
4
+ "sourcesContent": ["export const REASONS = {\n timeout: 'timeout',\n unknownTier: 'unknown-tier',\n unroutable: 'unroutable',\n unknownAnswer: 'unknown-answer',\n restart: 'restart',\n revoked: 'revoked',\n aborted: 'aborted',\n disconnected: 'disconnected',\n noScoop: 'no-scoop',\n scoopStopped: 'scoop-stopped',\n scoopAsked: 'scoop-asked',\n scoopUndecided: 'scoop-undecided',\n stopped: 'stopped',\n} as const;\n"],
5
+ "mappings": "AAAO,MAAM,UAAU;AAAA,EACrB,SAAS;AAAA,EACT,aAAa;AAAA,EACb,YAAY;AAAA,EACZ,eAAe;AAAA,EACf,SAAS;AAAA,EACT,SAAS;AAAA,EACT,SAAS;AAAA,EACT,cAAc;AAAA,EACd,SAAS;AAAA,EACT,cAAc;AAAA,EACd,YAAY;AAAA,EACZ,gBAAgB;AAAA,EAChB,SAAS;AACX;",
6
+ "names": []
7
+ }
@@ -2,6 +2,8 @@ import { defineDoc } from "@earendil-works/pi-durable";
2
2
  import { boundedDeltas } from "../checkpoints.js";
3
3
  import { clears, fits, JUDGE_ALLOW, JUDGE_LOW, reaches } from "./aligned.js";
4
4
  import { personal } from "./people.js";
5
+ import { REASONS } from "./reasons.js";
6
+ import { stoppable } from "./stoppable.js";
5
7
  const ApprovalsDoc = defineDoc({
6
8
  kind: "slicc.approvals",
7
9
  checkpointWhen: boundedDeltas,
@@ -13,20 +15,6 @@ const APPROVAL_MS = 3e5;
13
15
  const APPROVALS_KEPT = 100;
14
16
  const MAX_DELAY = 2147483647;
15
17
  const REASON_LENGTH = 500;
16
- const REASONS = {
17
- timeout: "timeout",
18
- unknownTier: "unknown-tier",
19
- unroutable: "unroutable",
20
- unknownAnswer: "unknown-answer",
21
- restart: "restart",
22
- revoked: "revoked",
23
- aborted: "aborted",
24
- disconnected: "disconnected",
25
- noScoop: "no-scoop",
26
- scoopStopped: "scoop-stopped",
27
- scoopAsked: "scoop-asked",
28
- scoopUndecided: "scoop-undecided"
29
- };
30
18
  const guestKind = (kind) => kind !== "sudo";
31
19
  const scoopTier = (tier) => typeof tier === "string" && /^scoop:\S+$/.test(tier);
32
20
  function knownTier(tier) {
@@ -38,7 +26,7 @@ function routable(kind, tier) {
38
26
  return !((kind === "guest-tool" || kind === "capture") && tier === "cone");
39
27
  }
40
28
  function answerOf(value) {
41
- return value === "once" || value === "always" || value === "deny" ? value : null;
29
+ return value === "once" || value === "always" || value === "deny" || value === "stop" ? value : null;
42
30
  }
43
31
  function answerer(by, item) {
44
32
  if (personal(by)) return item.tier === "user";
@@ -85,7 +73,15 @@ function prune(items, kept = APPROVALS_KEPT) {
85
73
  const drop = new Set(settled.slice(0, Math.max(0, settled.length - kept)));
86
74
  return items.filter((item) => !drop.has(item));
87
75
  }
88
- const why = (reason) => reason ? { reason } : {};
76
+ function stopped(item, by) {
77
+ if (!personal(by)) return { error: "Only a person can stop a turn." };
78
+ if (!stoppable(item)) return { error: "This request has no turn to stop." };
79
+ return {
80
+ settle: { state: "rejected", by, reason: REASONS.stopped },
81
+ stop: item.requester.agentId
82
+ };
83
+ }
84
+ const why = (reason) => reason && reason !== REASONS.stopped ? { reason } : {};
89
85
  function ruled(item, answer, reason, by, at) {
90
86
  if (item.state !== "pending") return { error: gone(item.state) };
91
87
  if (item.expiresAt <= at)
@@ -101,6 +97,7 @@ function ruled(item, answer, reason, by, at) {
101
97
  if (known === "always" && !item.always)
102
98
  return { error: "Always isn't offered for this request." };
103
99
  if (!known) return { settle: { state: "rejected", by, reason: REASONS.unknownAnswer } };
100
+ if (known === "stop") return stopped(item, by);
104
101
  const given = why(cleanReason(reason));
105
102
  if (known === "deny") return { settle: { state: "rejected", by, ...given } };
106
103
  return { settle: { state: "approved", by, ...given }, answer: known };
@@ -131,6 +128,7 @@ export {
131
128
  route,
132
129
  ruled,
133
130
  scoopTier,
131
+ stoppable,
134
132
  sudoApprover,
135
133
  tierOf,
136
134
  vetoed
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/approvals/record.ts"],
4
- "sourcesContent": ["import { defineDoc } from '@earendil-works/pi-durable';\nimport { boundedDeltas } from '../checkpoints.ts';\nimport { clears, fits, JUDGE_ALLOW, JUDGE_LOW, reaches } from './aligned.ts';\nimport { personal } from './people.ts';\n\nexport { fits, JUDGE_ALLOW, personal };\n\nexport type ApprovalKind = 'guest-message' | 'guest-tool' | 'sudo' | 'capture';\n\nexport type ApprovalState = 'pending' | 'approved' | 'rejected' | 'unanswered' | 'withdrawn';\n\nexport type ApprovalTier = 'user' | 'agent' | 'cone' | `scoop:${string}`;\n\nexport type ApprovalAnswer = 'once' | 'always' | 'deny';\n\nexport type DecidedBy = 'owner' | 'follower' | 'judge' | 'host' | `scoop:${string}`;\n\nexport type ApprovalRequester = {\n kind: 'guest' | 'agent' | 'user';\n name: string;\n seat?: string;\n agentId?: string;\n where?: string;\n device?: string;\n};\n\nexport type ApprovalLevel = 1 | 2 | 3;\n\nexport type ApprovalVerdict = {\n level?: ApprovalLevel;\n routine?: number;\n aligned?: number | boolean;\n always?: boolean;\n reason: string;\n via?: 'classifier' | 'chat';\n risk?: number;\n model?: string;\n actions?: Record<string, number>;\n intent?: Record<string, number>;\n forbidden?: number | boolean;\n};\n\nexport type ApprovalAttachment = { name: string; mimeType: string; size: number };\n\nexport type GuestMessageDetail = { text: string; attachments: ApprovalAttachment[] };\n\nexport type GuestToolDetail = { tool: string; summary: string; arguments?: string; task?: number };\n\nexport type SudoStdin = 'tty' | 'none' | 'pipe' | 'file';\n\nexport type SudoDetail = {\n command: string;\n target?: string;\n cwd?: string;\n alwaysScope?: 'cwd';\n stdin?: SudoStdin;\n rootOnly?: Record<string, boolean>;\n writable?: boolean;\n validate?: true;\n};\n\nexport type CaptureWhat = 'screen' | 'camera' | 'microphone';\n\nexport type CaptureMode = 'still' | 'video' | 'audio';\n\nexport type CaptureDetail = {\n what: CaptureWhat;\n mode: CaptureMode;\n seconds?: number;\n system?: boolean;\n microphone?: boolean;\n device?: string;\n program: string;\n};\n\ntype Base = {\n id: string;\n seat?: string;\n agentId: string;\n requester: ApprovalRequester;\n tier: string;\n state: ApprovalState;\n decidedBy: DecidedBy | null;\n device?: string;\n answer?: 'once' | 'always';\n reviewer?: string;\n reason?: string;\n verdict?: ApprovalVerdict;\n judging?: boolean;\n verdictError?: string;\n always: boolean;\n createdAt: number;\n expiresAt: number;\n decidedAt?: number;\n};\n\nexport type GuestMessageApproval = Base & { kind: 'guest-message'; detail: GuestMessageDetail };\nexport type GuestToolApproval = Base & { kind: 'guest-tool'; detail: GuestToolDetail };\nexport type SudoApproval = Base & { kind: 'sudo'; detail: SudoDetail };\nexport type CaptureApproval = Base & { kind: 'capture'; detail: CaptureDetail };\n\nexport type Approval = GuestMessageApproval | GuestToolApproval | SudoApproval | CaptureApproval;\n\ntype DraftOf<T extends Approval> = Pick<T, 'kind' | 'detail' | 'agentId' | 'requester'> & {\n seat?: string;\n tier: string;\n always?: boolean;\n expiresAt?: number;\n};\n\nexport type ApprovalDraft =\n | DraftOf<GuestMessageApproval>\n | DraftOf<GuestToolApproval>\n | DraftOf<SudoApproval>\n | DraftOf<CaptureApproval>;\n\nexport type ApprovalsState = { items: Approval[] };\n\nexport const ApprovalsDoc = defineDoc<ApprovalsState>({\n kind: 'slicc.approvals',\n checkpointWhen: boundedDeltas,\n version: 1,\n scope: 'session',\n initial: () => ({ items: [] }),\n});\n\nexport const APPROVAL_MS = 300_000;\nexport const APPROVALS_KEPT = 100;\nexport const MAX_DELAY = 2_147_483_647;\nexport const REASON_LENGTH = 500;\n\nexport const REASONS = {\n timeout: 'timeout',\n unknownTier: 'unknown-tier',\n unroutable: 'unroutable',\n unknownAnswer: 'unknown-answer',\n restart: 'restart',\n revoked: 'revoked',\n aborted: 'aborted',\n disconnected: 'disconnected',\n noScoop: 'no-scoop',\n scoopStopped: 'scoop-stopped',\n scoopAsked: 'scoop-asked',\n scoopUndecided: 'scoop-undecided',\n} as const;\n\nexport const guestKind = (kind: ApprovalKind): boolean => kind !== 'sudo';\n\nexport const scoopTier = (tier: unknown): tier is `scoop:${string}` =>\n typeof tier === 'string' && /^scoop:\\S+$/.test(tier);\n\nexport function knownTier(tier: unknown): tier is ApprovalTier {\n if (tier === 'user' || tier === 'agent' || tier === 'cone') return true;\n return scoopTier(tier);\n}\n\nexport const heldKind = (kind: ApprovalKind): boolean => kind === 'sudo' || kind === 'capture';\n\nexport function routable(kind: ApprovalKind, tier: ApprovalTier): boolean {\n return !((kind === 'guest-tool' || kind === 'capture') && tier === 'cone');\n}\n\nexport function answerOf(value: unknown): ApprovalAnswer | null {\n return value === 'once' || value === 'always' || value === 'deny' ? value : null;\n}\n\nexport function answerer(by: DecidedBy, item: Pick<Approval, 'tier' | 'reviewer'>): boolean {\n if (personal(by)) return item.tier === 'user';\n if (by === 'judge') return item.tier === 'agent';\n if (scoopTier(by)) return scoopTier(item.tier) && item.reviewer === by;\n return true;\n}\n\nexport type SudoApprover = 'user' | 'agent';\n\nexport const sudoApprover = (value: unknown): SudoApprover =>\n value === 'agent' ? 'agent' : 'user';\n\nexport const personOnly = (item: Pick<ApprovalDraft, 'kind' | 'detail'>): boolean =>\n item.kind === 'sudo' && (item.detail as SudoDetail).validate === true;\n\nexport const tierOf = (\n draft: Pick<ApprovalDraft, 'kind' | 'detail' | 'tier'>,\n sudo: SudoApprover\n) => (draft.kind !== 'sudo' ? draft.tier : personOnly(draft) ? 'user' : sudo);\n\nexport type Gate = 'person' | 'judge';\n\nexport type Routed = 'approve' | 'deny' | 'ask';\n\nexport const gateOf = (tier: string): Gate => (tier === 'agent' ? 'judge' : 'person');\n\nexport const vetoed = ({ forbidden }: ApprovalVerdict): boolean =>\n forbidden === true || (typeof forbidden === 'number' && reaches(forbidden, JUDGE_LOW));\n\nexport function approvable(verdict: ApprovalVerdict): boolean {\n const sure =\n verdict.routine === undefined ? verdict.via === 'chat' : clears(verdict.routine, JUDGE_ALLOW);\n return verdict.level === 1 && sure && fits(verdict.aligned);\n}\n\nexport function route(\n verdict: ApprovalVerdict | undefined,\n requester: Pick<ApprovalRequester, 'kind'>,\n gate: Gate,\n present: boolean\n): Routed {\n if (gate !== 'judge' || !verdict?.level) return 'ask';\n if (approvable(verdict) && !vetoed(verdict)) return 'approve';\n if (verdict.level === 3 && requester.kind !== 'user' && !present) return 'deny';\n return 'ask';\n}\n\nexport function alwaysOffered(item: Approval): boolean {\n if ((item.kind !== 'sudo' && item.kind !== 'capture') || item.tier !== 'user') return false;\n if (personOnly(item)) return false;\n const { verdict } = item;\n const writable = item.kind !== 'sudo' || item.detail.writable !== false;\n return verdict?.level === 1 && verdict.always === true && writable;\n}\n\nexport function gone(state: ApprovalState): string {\n if (state === 'unanswered') return 'This request timed out.';\n if (state === 'withdrawn') return 'This request was withdrawn.';\n return 'Someone else already answered this.';\n}\n\nexport function cleanReason(reason: unknown): string | undefined {\n if (typeof reason !== 'string') return undefined;\n const text = reason.trim().slice(0, REASON_LENGTH);\n return text || undefined;\n}\n\nconst decided = (item: Approval) => item.decidedAt ?? item.createdAt;\n\nexport function prune(items: Approval[], kept = APPROVALS_KEPT): Approval[] {\n const settled = items.filter((item) => item.state !== 'pending');\n settled.sort((a, b) => decided(a) - decided(b));\n const drop = new Set(settled.slice(0, Math.max(0, settled.length - kept)));\n return items.filter((item) => !drop.has(item));\n}\n\nexport type Settle = { state: Exclude<ApprovalState, 'pending'>; by: DecidedBy; reason?: string };\n\nexport type Ruling = { error?: string; settle?: Settle; answer?: 'once' | 'always' };\n\nconst why = (reason: string | undefined) => (reason ? { reason } : {});\n\nexport function ruled(\n item: Approval,\n answer: unknown,\n reason: unknown,\n by: DecidedBy,\n at: number\n): Ruling {\n if (item.state !== 'pending') return { error: gone(item.state) };\n if (item.expiresAt <= at)\n return {\n error: gone('unanswered'),\n settle: { state: 'unanswered', by: 'host', reason: REASONS.timeout },\n };\n if (!answerer(by, item)) return { error: \"This request isn't yours to answer.\" };\n const known = answerOf(answer);\n if (known === 'always' && scoopTier(by)) return { error: 'A scoop answers once or deny.' };\n if (known === 'always' && !personal(by))\n return { error: 'Always can only be answered by a person.' };\n if (known === 'always' && !item.always)\n return { error: \"Always isn't offered for this request.\" };\n if (!known) return { settle: { state: 'rejected', by, reason: REASONS.unknownAnswer } };\n const given = why(cleanReason(reason));\n if (known === 'deny') return { settle: { state: 'rejected', by, ...given } };\n return { settle: { state: 'approved', by, ...given }, answer: known };\n}\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["import { defineDoc } from '@earendil-works/pi-durable';\nimport { boundedDeltas } from '../checkpoints.ts';\nimport { clears, fits, JUDGE_ALLOW, JUDGE_LOW, reaches } from './aligned.ts';\nimport { personal } from './people.ts';\nimport { REASONS } from './reasons.ts';\nimport { stoppable } from './stoppable.ts';\n\nexport { fits, JUDGE_ALLOW, personal, REASONS, stoppable };\n\nexport type ApprovalKind = 'guest-message' | 'guest-tool' | 'sudo' | 'capture';\n\nexport type ApprovalState = 'pending' | 'approved' | 'rejected' | 'unanswered' | 'withdrawn';\n\nexport type ApprovalTier = 'user' | 'agent' | 'cone' | `scoop:${string}`;\n\nexport type ApprovalAnswer = 'once' | 'always' | 'deny';\n\nexport type ApprovalDecision = ApprovalAnswer | 'stop';\n\nexport type DecidedBy = 'owner' | 'follower' | 'judge' | 'host' | `scoop:${string}`;\n\nexport type ApprovalRequester = {\n kind: 'guest' | 'agent' | 'user';\n name: string;\n seat?: string;\n agentId?: string;\n where?: string;\n device?: string;\n};\n\nexport type ApprovalLevel = 1 | 2 | 3;\n\nexport type ApprovalVerdict = {\n level?: ApprovalLevel;\n routine?: number;\n aligned?: number | boolean;\n always?: boolean;\n reason: string;\n via?: 'classifier' | 'chat';\n risk?: number;\n model?: string;\n actions?: Record<string, number>;\n intent?: Record<string, number>;\n forbidden?: number | boolean;\n};\n\nexport type ApprovalAttachment = { name: string; mimeType: string; size: number };\n\nexport type GuestMessageDetail = { text: string; attachments: ApprovalAttachment[] };\n\nexport type GuestToolDetail = { tool: string; summary: string; arguments?: string; task?: number };\n\nexport type SudoStdin = 'tty' | 'none' | 'pipe' | 'file';\n\nexport type SudoDetail = {\n command: string;\n target?: string;\n cwd?: string;\n alwaysScope?: 'cwd';\n stdin?: SudoStdin;\n rootOnly?: Record<string, boolean>;\n writable?: boolean;\n validate?: true;\n};\n\nexport type CaptureWhat = 'screen' | 'camera' | 'microphone';\n\nexport type CaptureMode = 'still' | 'video' | 'audio';\n\nexport type CaptureDetail = {\n what: CaptureWhat;\n mode: CaptureMode;\n seconds?: number;\n system?: boolean;\n microphone?: boolean;\n device?: string;\n program: string;\n};\n\ntype Base = {\n id: string;\n seat?: string;\n agentId: string;\n requester: ApprovalRequester;\n tier: string;\n state: ApprovalState;\n decidedBy: DecidedBy | null;\n device?: string;\n answer?: 'once' | 'always';\n reviewer?: string;\n reason?: string;\n verdict?: ApprovalVerdict;\n judging?: boolean;\n verdictError?: string;\n always: boolean;\n createdAt: number;\n expiresAt: number;\n decidedAt?: number;\n};\n\nexport type GuestMessageApproval = Base & { kind: 'guest-message'; detail: GuestMessageDetail };\nexport type GuestToolApproval = Base & { kind: 'guest-tool'; detail: GuestToolDetail };\nexport type SudoApproval = Base & { kind: 'sudo'; detail: SudoDetail };\nexport type CaptureApproval = Base & { kind: 'capture'; detail: CaptureDetail };\n\nexport type Approval = GuestMessageApproval | GuestToolApproval | SudoApproval | CaptureApproval;\n\ntype DraftOf<T extends Approval> = Pick<T, 'kind' | 'detail' | 'agentId' | 'requester'> & {\n seat?: string;\n tier: string;\n always?: boolean;\n expiresAt?: number;\n};\n\nexport type ApprovalDraft =\n | DraftOf<GuestMessageApproval>\n | DraftOf<GuestToolApproval>\n | DraftOf<SudoApproval>\n | DraftOf<CaptureApproval>;\n\nexport type ApprovalsState = { items: Approval[] };\n\nexport const ApprovalsDoc = defineDoc<ApprovalsState>({\n kind: 'slicc.approvals',\n checkpointWhen: boundedDeltas,\n version: 1,\n scope: 'session',\n initial: () => ({ items: [] }),\n});\n\nexport const APPROVAL_MS = 300_000;\nexport const APPROVALS_KEPT = 100;\nexport const MAX_DELAY = 2_147_483_647;\nexport const REASON_LENGTH = 500;\n\nexport const guestKind = (kind: ApprovalKind): boolean => kind !== 'sudo';\n\nexport const scoopTier = (tier: unknown): tier is `scoop:${string}` =>\n typeof tier === 'string' && /^scoop:\\S+$/.test(tier);\n\nexport function knownTier(tier: unknown): tier is ApprovalTier {\n if (tier === 'user' || tier === 'agent' || tier === 'cone') return true;\n return scoopTier(tier);\n}\n\nexport const heldKind = (kind: ApprovalKind): boolean => kind === 'sudo' || kind === 'capture';\n\nexport function routable(kind: ApprovalKind, tier: ApprovalTier): boolean {\n return !((kind === 'guest-tool' || kind === 'capture') && tier === 'cone');\n}\n\nexport function answerOf(value: unknown): ApprovalDecision | null {\n return value === 'once' || value === 'always' || value === 'deny' || value === 'stop'\n ? value\n : null;\n}\n\nexport function answerer(by: DecidedBy, item: Pick<Approval, 'tier' | 'reviewer'>): boolean {\n if (personal(by)) return item.tier === 'user';\n if (by === 'judge') return item.tier === 'agent';\n if (scoopTier(by)) return scoopTier(item.tier) && item.reviewer === by;\n return true;\n}\n\nexport type SudoApprover = 'user' | 'agent';\n\nexport const sudoApprover = (value: unknown): SudoApprover =>\n value === 'agent' ? 'agent' : 'user';\n\nexport const personOnly = (item: Pick<ApprovalDraft, 'kind' | 'detail'>): boolean =>\n item.kind === 'sudo' && (item.detail as SudoDetail).validate === true;\n\nexport const tierOf = (\n draft: Pick<ApprovalDraft, 'kind' | 'detail' | 'tier'>,\n sudo: SudoApprover\n) => (draft.kind !== 'sudo' ? draft.tier : personOnly(draft) ? 'user' : sudo);\n\nexport type Gate = 'person' | 'judge';\n\nexport type Routed = 'approve' | 'deny' | 'ask';\n\nexport const gateOf = (tier: string): Gate => (tier === 'agent' ? 'judge' : 'person');\n\nexport const vetoed = ({ forbidden }: ApprovalVerdict): boolean =>\n forbidden === true || (typeof forbidden === 'number' && reaches(forbidden, JUDGE_LOW));\n\nexport function approvable(verdict: ApprovalVerdict): boolean {\n const sure =\n verdict.routine === undefined ? verdict.via === 'chat' : clears(verdict.routine, JUDGE_ALLOW);\n return verdict.level === 1 && sure && fits(verdict.aligned);\n}\n\nexport function route(\n verdict: ApprovalVerdict | undefined,\n requester: Pick<ApprovalRequester, 'kind'>,\n gate: Gate,\n present: boolean\n): Routed {\n if (gate !== 'judge' || !verdict?.level) return 'ask';\n if (approvable(verdict) && !vetoed(verdict)) return 'approve';\n if (verdict.level === 3 && requester.kind !== 'user' && !present) return 'deny';\n return 'ask';\n}\n\nexport function alwaysOffered(item: Approval): boolean {\n if ((item.kind !== 'sudo' && item.kind !== 'capture') || item.tier !== 'user') return false;\n if (personOnly(item)) return false;\n const { verdict } = item;\n const writable = item.kind !== 'sudo' || item.detail.writable !== false;\n return verdict?.level === 1 && verdict.always === true && writable;\n}\n\nexport function gone(state: ApprovalState): string {\n if (state === 'unanswered') return 'This request timed out.';\n if (state === 'withdrawn') return 'This request was withdrawn.';\n return 'Someone else already answered this.';\n}\n\nexport function cleanReason(reason: unknown): string | undefined {\n if (typeof reason !== 'string') return undefined;\n const text = reason.trim().slice(0, REASON_LENGTH);\n return text || undefined;\n}\n\nconst decided = (item: Approval) => item.decidedAt ?? item.createdAt;\n\nexport function prune(items: Approval[], kept = APPROVALS_KEPT): Approval[] {\n const settled = items.filter((item) => item.state !== 'pending');\n settled.sort((a, b) => decided(a) - decided(b));\n const drop = new Set(settled.slice(0, Math.max(0, settled.length - kept)));\n return items.filter((item) => !drop.has(item));\n}\n\nexport type Settle = { state: Exclude<ApprovalState, 'pending'>; by: DecidedBy; reason?: string };\n\nexport type Ruling = {\n error?: string;\n settle?: Settle;\n answer?: 'once' | 'always';\n stop?: string;\n};\n\nfunction stopped(item: Approval, by: DecidedBy): Ruling {\n if (!personal(by)) return { error: 'Only a person can stop a turn.' };\n if (!stoppable(item)) return { error: 'This request has no turn to stop.' };\n return {\n settle: { state: 'rejected', by, reason: REASONS.stopped },\n stop: item.requester.agentId as string,\n };\n}\n\nconst why = (reason: string | undefined) =>\n reason && reason !== REASONS.stopped ? { reason } : {};\n\nexport function ruled(\n item: Approval,\n answer: unknown,\n reason: unknown,\n by: DecidedBy,\n at: number\n): Ruling {\n if (item.state !== 'pending') return { error: gone(item.state) };\n if (item.expiresAt <= at)\n return {\n error: gone('unanswered'),\n settle: { state: 'unanswered', by: 'host', reason: REASONS.timeout },\n };\n if (!answerer(by, item)) return { error: \"This request isn't yours to answer.\" };\n const known = answerOf(answer);\n if (known === 'always' && scoopTier(by)) return { error: 'A scoop answers once or deny.' };\n if (known === 'always' && !personal(by))\n return { error: 'Always can only be answered by a person.' };\n if (known === 'always' && !item.always)\n return { error: \"Always isn't offered for this request.\" };\n if (!known) return { settle: { state: 'rejected', by, reason: REASONS.unknownAnswer } };\n if (known === 'stop') return stopped(item, by);\n const given = why(cleanReason(reason));\n if (known === 'deny') return { settle: { state: 'rejected', by, ...given } };\n return { settle: { state: 'approved', by, ...given }, answer: known };\n}\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -0,0 +1,5 @@
1
+ const stoppable = (item) => item.kind === "sudo" && item.requester.kind === "agent" && Boolean(item.requester.agentId);
2
+ export {
3
+ stoppable
4
+ };
5
+ //# sourceMappingURL=stoppable.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../src/approvals/stoppable.ts"],
4
+ "sourcesContent": ["import type { Approval } from './record.ts';\n\nexport const stoppable = (item: Approval): boolean =>\n item.kind === 'sudo' && item.requester.kind === 'agent' && Boolean(item.requester.agentId);\n"],
5
+ "mappings": "AAEO,MAAM,YAAY,CAAC,SACxB,KAAK,SAAS,UAAU,KAAK,UAAU,SAAS,WAAW,QAAQ,KAAK,UAAU,OAAO;",
6
+ "names": []
7
+ }
@@ -5,6 +5,7 @@ import { bound } from "../serving.js";
5
5
  import { PortLink } from "../wire.js";
6
6
  import { attributed, UNATTRIBUTED } from "./attributed.js";
7
7
  import { personal } from "./people.js";
8
+ import { REASONS } from "./reasons.js";
8
9
  const UNAVAILABLE = "The agent can't take this sudo request.";
9
10
  const unavailable = (cause) => Object.assign(new Error(UNAVAILABLE), { code: "EAGAIN", ...cause ? { cause } : {} });
10
11
  const missing = () => () => Promise.reject(unavailable());
@@ -13,8 +14,11 @@ function answerOf(item) {
13
14
  return item.state === "approved" && item.answer ? item.answer : "deny";
14
15
  }
15
16
  const JUDGE_DENIED = "sudo: denied by the approval judge";
17
+ const STOPPED = "sudo: denied, and the owner stopped this turn";
16
18
  function replyOf(item, stamps = false) {
17
19
  const answer = answerOf(item);
20
+ if (answer === "deny" && item?.reason === REASONS.stopped)
21
+ return { answer: "deny", message: STOPPED };
18
22
  const by = item?.decidedBy;
19
23
  if (stamps && answer !== null && answer !== "deny" && by && personal(by))
20
24
  return { answer, timestamp: true };
@@ -152,6 +156,7 @@ async function askSudo(endpoint, request, options = {}, stop) {
152
156
  }
153
157
  export {
154
158
  JUDGE_DENIED,
159
+ STOPPED,
155
160
  UNAVAILABLE,
156
161
  WITHDRAW_MS,
157
162
  answerOf,
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/approvals/sudo-client.ts"],
4
- "sourcesContent": ["import type { Readable } from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT, withAbortSignal } from '@earendil-works/chord/context';\nimport { clientHost, holding } from '../client.ts';\nimport type { CaptureReply } from '../guests/capture.ts';\nimport { AgentSudoService, SUDO_METHODS } from '../services.ts';\nimport { bound, type Remote, type Root } from '../serving.ts';\nimport { type PortEndpoint, PortLink } from '../wire.ts';\nimport { attributed, UNATTRIBUTED } from './attributed.ts';\nimport { personal } from './people.ts';\nimport type { Approval } from './record.ts';\nimport type { AgentSudo, SudoAnswer, SudoDenial, SudoReply, SudoRequest } from './sudo.ts';\n\nexport interface ApproveOptions {\n signal?: AbortSignal;\n where?: string;\n}\n\nexport const UNAVAILABLE = \"The agent can't take this sudo request.\";\n\nexport const unavailable = (cause?: unknown): Error =>\n Object.assign(new Error(UNAVAILABLE), { code: 'EAGAIN', ...(cause ? { cause } : {}) });\n\nconst missing = () => () => Promise.reject(unavailable());\n\nexport function answerOf(item: Approval | undefined): SudoAnswer | null {\n if (!item || item.state === 'pending') return null;\n return item.state === 'approved' && item.answer ? item.answer : 'deny';\n}\n\nexport const JUDGE_DENIED = 'sudo: denied by the approval judge';\n\nexport function replyOf(item: Approval | undefined, stamps = false): SudoReply | null {\n const answer = answerOf(item);\n const by = item?.decidedBy;\n if (stamps && answer !== null && answer !== 'deny' && by && personal(by))\n return { answer, timestamp: true };\n if (answer !== 'deny' || item?.state !== 'rejected' || item.decidedBy !== 'judge') return answer;\n const reason = item.verdict?.reason;\n const denial: SudoDenial = {\n answer: 'deny',\n message: reason ? `${JUDGE_DENIED}: ${reason}` : JUDGE_DENIED,\n };\n return denial;\n}\n\nfunction halted(stop: AbortSignal | undefined): Promise<never> {\n return new Promise((_, reject) => {\n if (stop?.aborted) reject(unavailable());\n stop?.addEventListener('abort', () => reject(unavailable()), { once: true });\n });\n}\n\nasync function open(endpoint: PortEndpoint, stop: AbortSignal | undefined) {\n const link = new PortLink(endpoint);\n let host: ReturnType<typeof clientHost> | undefined;\n const close = async () => {\n link.close('closed');\n await host?.close().catch(() => undefined);\n };\n const ended = link.ended.then((reason) => {\n throw reason ?? new Error('the agent closed the link');\n });\n ended.catch(() => undefined);\n const stopped = halted(stop);\n stopped.catch(() => undefined);\n try {\n await Promise.race([link.hello, ended, stopped]);\n const client = clientHost(link, 'sudo');\n host = client;\n const [handle] = (await Promise.race([holding(client, link, [AgentSudoService]), stopped])) as [\n Remote,\n ];\n if (handle.variant !== 'sudo') throw unavailable();\n const root: Root = (run, options) => client.root(run, options);\n const sudo = bound<Omit<AgentSudo, 'approvals'>>(handle, root, SUDO_METHODS, missing);\n return { sudo, approvals: handle.approvals as Readable<Approval[]>, ended, close };\n } catch (error) {\n await close();\n throw (error as { code?: unknown })?.code === 'EAGAIN' ? error : unavailable(error);\n }\n}\n\nfunction settled(\n approvals: Readable<Approval[]>,\n id: string,\n signals: { signal: AbortSignal | undefined; stop: AbortSignal | undefined; stamps: boolean },\n ended: Promise<never>\n): Promise<{ answer: SudoReply; aborted: unknown }> {\n const { signal, stop, stamps } = signals;\n return new Promise((resolve) => {\n let off: () => void = () => undefined;\n let done = false;\n const finish = (answer: SudoReply, aborted: unknown = null) => {\n if (done) return;\n done = true;\n off();\n signal?.removeEventListener('abort', abort);\n stop?.removeEventListener('abort', halt);\n resolve({ answer, aborted });\n };\n const abort = () => finish('deny', signal?.reason ?? 'withdrawn');\n const halt = () => finish('deny');\n if (signal?.aborted) return abort();\n if (stop?.aborted) return halt();\n signal?.addEventListener('abort', abort, { once: true });\n stop?.addEventListener('abort', halt, { once: true });\n ended.catch(() => finish('deny'));\n off = approvals.subscribe((items) => {\n const answer = replyOf(\n items?.find((item) => item.id === id),\n stamps\n );\n if (answer) finish(answer);\n });\n if (done) off();\n });\n}\n\nexport const WITHDRAW_MS = 5000;\n\nconst delay = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));\n\nfunction timedOut(\n link: { approvals: Readable<Approval[]>; ended: Promise<never> },\n id: string,\n expiresAt: number\n): Promise<unknown> {\n let off: () => void = () => undefined;\n const left = new Promise<void>((resolve) => {\n off = link.approvals.subscribe((items) => {\n if (answerOf(items?.find((item) => item.id === id))) resolve();\n });\n });\n const wait = Math.max(0, expiresAt - Date.now()) + WITHDRAW_MS;\n return Promise.race([left, link.ended.catch(() => undefined), delay(wait)]).finally(() => off());\n}\n\nexport interface CaptureAsk {\n kind: string;\n options?: Record<string, unknown>;\n stamp?: Record<string, unknown>;\n label?: string;\n}\n\nconst isEagain = (error: unknown) => (error as { code?: unknown })?.code === 'EAGAIN';\n\nexport async function askCapture(\n endpoint: PortEndpoint,\n request: CaptureAsk,\n options: ApproveOptions = {},\n stop?: AbortSignal\n): Promise<CaptureReply> {\n if (!attributed(request)) throw unavailable();\n const { signal } = options;\n const link = await open(endpoint, stop);\n const ending = new AbortController();\n const end = () => ending.abort();\n signal?.addEventListener('abort', end, { once: true });\n stop?.addEventListener('abort', end, { once: true });\n const using = withAbortSignal(ending.signal, BACKGROUND_CONTEXT);\n try {\n if (signal?.aborted || stop?.aborted) return 'deny';\n const asked = link.sudo.capture(request, options.where ?? null, using);\n const gone = link.ended.catch(() => 'deny' as const);\n const halted = new Promise<'deny'>((resolve) =>\n ending.signal.addEventListener('abort', () => resolve('deny'), { once: true })\n );\n const answer = await Promise.race([asked, gone, halted]);\n if (answer === UNATTRIBUTED) throw unavailable();\n return answer;\n } catch (error) {\n if (isEagain(error)) throw error;\n return 'deny';\n } finally {\n signal?.removeEventListener('abort', end);\n stop?.removeEventListener('abort', end);\n await link.close();\n }\n}\n\nexport async function askSudo(\n endpoint: PortEndpoint,\n request: SudoRequest,\n options: ApproveOptions = {},\n stop?: AbortSignal\n): Promise<SudoReply> {\n const { signal } = options;\n const link = await open(endpoint, stop);\n try {\n if (signal?.aborted || stop?.aborted) return 'deny';\n const asked = await link.sudo.request(request, options.where ?? null, BACKGROUND_CONTEXT);\n if (asked.id === null) throw new Error(asked.error);\n const signals = { signal, stop, stamps: request.timestamp === true };\n const { answer, aborted } = await settled(link.approvals, asked.id, signals, link.ended);\n if (aborted === 'expired') await timedOut(link, asked.id, request.expiresAt);\n else if (aborted)\n await Promise.race([\n link.sudo.withdraw(asked.id, String(aborted), BACKGROUND_CONTEXT),\n delay(WITHDRAW_MS),\n ]);\n return answer;\n } finally {\n await link.close();\n }\n}\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["import type { Readable } from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT, withAbortSignal } from '@earendil-works/chord/context';\nimport { clientHost, holding } from '../client.ts';\nimport type { CaptureReply } from '../guests/capture.ts';\nimport { AgentSudoService, SUDO_METHODS } from '../services.ts';\nimport { bound, type Remote, type Root } from '../serving.ts';\nimport { type PortEndpoint, PortLink } from '../wire.ts';\nimport { attributed, UNATTRIBUTED } from './attributed.ts';\nimport { personal } from './people.ts';\nimport { REASONS } from './reasons.ts';\nimport type { Approval } from './record.ts';\nimport type { AgentSudo, SudoAnswer, SudoDenial, SudoReply, SudoRequest } from './sudo.ts';\n\nexport interface ApproveOptions {\n signal?: AbortSignal;\n where?: string;\n}\n\nexport const UNAVAILABLE = \"The agent can't take this sudo request.\";\n\nexport const unavailable = (cause?: unknown): Error =>\n Object.assign(new Error(UNAVAILABLE), { code: 'EAGAIN', ...(cause ? { cause } : {}) });\n\nconst missing = () => () => Promise.reject(unavailable());\n\nexport function answerOf(item: Approval | undefined): SudoAnswer | null {\n if (!item || item.state === 'pending') return null;\n return item.state === 'approved' && item.answer ? item.answer : 'deny';\n}\n\nexport const JUDGE_DENIED = 'sudo: denied by the approval judge';\n\nexport const STOPPED = 'sudo: denied, and the owner stopped this turn';\n\nexport function replyOf(item: Approval | undefined, stamps = false): SudoReply | null {\n const answer = answerOf(item);\n if (answer === 'deny' && item?.reason === REASONS.stopped)\n return { answer: 'deny', message: STOPPED };\n const by = item?.decidedBy;\n if (stamps && answer !== null && answer !== 'deny' && by && personal(by))\n return { answer, timestamp: true };\n if (answer !== 'deny' || item?.state !== 'rejected' || item.decidedBy !== 'judge') return answer;\n const reason = item.verdict?.reason;\n const denial: SudoDenial = {\n answer: 'deny',\n message: reason ? `${JUDGE_DENIED}: ${reason}` : JUDGE_DENIED,\n };\n return denial;\n}\n\nfunction halted(stop: AbortSignal | undefined): Promise<never> {\n return new Promise((_, reject) => {\n if (stop?.aborted) reject(unavailable());\n stop?.addEventListener('abort', () => reject(unavailable()), { once: true });\n });\n}\n\nasync function open(endpoint: PortEndpoint, stop: AbortSignal | undefined) {\n const link = new PortLink(endpoint);\n let host: ReturnType<typeof clientHost> | undefined;\n const close = async () => {\n link.close('closed');\n await host?.close().catch(() => undefined);\n };\n const ended = link.ended.then((reason) => {\n throw reason ?? new Error('the agent closed the link');\n });\n ended.catch(() => undefined);\n const stopped = halted(stop);\n stopped.catch(() => undefined);\n try {\n await Promise.race([link.hello, ended, stopped]);\n const client = clientHost(link, 'sudo');\n host = client;\n const [handle] = (await Promise.race([holding(client, link, [AgentSudoService]), stopped])) as [\n Remote,\n ];\n if (handle.variant !== 'sudo') throw unavailable();\n const root: Root = (run, options) => client.root(run, options);\n const sudo = bound<Omit<AgentSudo, 'approvals'>>(handle, root, SUDO_METHODS, missing);\n return { sudo, approvals: handle.approvals as Readable<Approval[]>, ended, close };\n } catch (error) {\n await close();\n throw (error as { code?: unknown })?.code === 'EAGAIN' ? error : unavailable(error);\n }\n}\n\nfunction settled(\n approvals: Readable<Approval[]>,\n id: string,\n signals: { signal: AbortSignal | undefined; stop: AbortSignal | undefined; stamps: boolean },\n ended: Promise<never>\n): Promise<{ answer: SudoReply; aborted: unknown }> {\n const { signal, stop, stamps } = signals;\n return new Promise((resolve) => {\n let off: () => void = () => undefined;\n let done = false;\n const finish = (answer: SudoReply, aborted: unknown = null) => {\n if (done) return;\n done = true;\n off();\n signal?.removeEventListener('abort', abort);\n stop?.removeEventListener('abort', halt);\n resolve({ answer, aborted });\n };\n const abort = () => finish('deny', signal?.reason ?? 'withdrawn');\n const halt = () => finish('deny');\n if (signal?.aborted) return abort();\n if (stop?.aborted) return halt();\n signal?.addEventListener('abort', abort, { once: true });\n stop?.addEventListener('abort', halt, { once: true });\n ended.catch(() => finish('deny'));\n off = approvals.subscribe((items) => {\n const answer = replyOf(\n items?.find((item) => item.id === id),\n stamps\n );\n if (answer) finish(answer);\n });\n if (done) off();\n });\n}\n\nexport const WITHDRAW_MS = 5000;\n\nconst delay = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));\n\nfunction timedOut(\n link: { approvals: Readable<Approval[]>; ended: Promise<never> },\n id: string,\n expiresAt: number\n): Promise<unknown> {\n let off: () => void = () => undefined;\n const left = new Promise<void>((resolve) => {\n off = link.approvals.subscribe((items) => {\n if (answerOf(items?.find((item) => item.id === id))) resolve();\n });\n });\n const wait = Math.max(0, expiresAt - Date.now()) + WITHDRAW_MS;\n return Promise.race([left, link.ended.catch(() => undefined), delay(wait)]).finally(() => off());\n}\n\nexport interface CaptureAsk {\n kind: string;\n options?: Record<string, unknown>;\n stamp?: Record<string, unknown>;\n label?: string;\n}\n\nconst isEagain = (error: unknown) => (error as { code?: unknown })?.code === 'EAGAIN';\n\nexport async function askCapture(\n endpoint: PortEndpoint,\n request: CaptureAsk,\n options: ApproveOptions = {},\n stop?: AbortSignal\n): Promise<CaptureReply> {\n if (!attributed(request)) throw unavailable();\n const { signal } = options;\n const link = await open(endpoint, stop);\n const ending = new AbortController();\n const end = () => ending.abort();\n signal?.addEventListener('abort', end, { once: true });\n stop?.addEventListener('abort', end, { once: true });\n const using = withAbortSignal(ending.signal, BACKGROUND_CONTEXT);\n try {\n if (signal?.aborted || stop?.aborted) return 'deny';\n const asked = link.sudo.capture(request, options.where ?? null, using);\n const gone = link.ended.catch(() => 'deny' as const);\n const halted = new Promise<'deny'>((resolve) =>\n ending.signal.addEventListener('abort', () => resolve('deny'), { once: true })\n );\n const answer = await Promise.race([asked, gone, halted]);\n if (answer === UNATTRIBUTED) throw unavailable();\n return answer;\n } catch (error) {\n if (isEagain(error)) throw error;\n return 'deny';\n } finally {\n signal?.removeEventListener('abort', end);\n stop?.removeEventListener('abort', end);\n await link.close();\n }\n}\n\nexport async function askSudo(\n endpoint: PortEndpoint,\n request: SudoRequest,\n options: ApproveOptions = {},\n stop?: AbortSignal\n): Promise<SudoReply> {\n const { signal } = options;\n const link = await open(endpoint, stop);\n try {\n if (signal?.aborted || stop?.aborted) return 'deny';\n const asked = await link.sudo.request(request, options.where ?? null, BACKGROUND_CONTEXT);\n if (asked.id === null) throw new Error(asked.error);\n const signals = { signal, stop, stamps: request.timestamp === true };\n const { answer, aborted } = await settled(link.approvals, asked.id, signals, link.ended);\n if (aborted === 'expired') await timedOut(link, asked.id, request.expiresAt);\n else if (aborted)\n await Promise.race([\n link.sudo.withdraw(asked.id, String(aborted), BACKGROUND_CONTEXT),\n delay(WITHDRAW_MS),\n ]);\n return answer;\n } finally {\n await link.close();\n }\n}\n"],
5
+ "mappings": "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",
6
6
  "names": ["halted"]
7
7
  }