@ai-ecoverse/slicc-agent 7.22.0 → 7.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. package/README.md +24 -11
  2. package/dist/approvals/attributed.js +13 -0
  3. package/dist/approvals/attributed.js.map +7 -0
  4. package/dist/approvals/index.js +7 -3
  5. package/dist/approvals/index.js.map +2 -2
  6. package/dist/approvals/judge.js +71 -5
  7. package/dist/approvals/judge.js.map +2 -2
  8. package/dist/approvals/policy.js +1 -1
  9. package/dist/approvals/policy.js.map +2 -2
  10. package/dist/approvals/record.js +7 -4
  11. package/dist/approvals/record.js.map +2 -2
  12. package/dist/approvals/sudo-client.js +32 -1
  13. package/dist/approvals/sudo-client.js.map +3 -3
  14. package/dist/approvals/sudo.js +2 -0
  15. package/dist/approvals/sudo.js.map +2 -2
  16. package/dist/guests/capture.js +167 -0
  17. package/dist/guests/capture.js.map +7 -0
  18. package/dist/guests/index.js +18 -5
  19. package/dist/guests/index.js.map +2 -2
  20. package/dist/guests/seats.js.map +2 -2
  21. package/dist/host.js +8 -0
  22. package/dist/host.js.map +2 -2
  23. package/dist/index.js.map +2 -2
  24. package/dist/owner.js +23 -13
  25. package/dist/owner.js.map +2 -2
  26. package/dist/services.js +2 -1
  27. package/dist/services.js.map +2 -2
  28. package/dist/spectrum/approvals-port.js +1 -0
  29. package/dist/spectrum/approvals-port.js.map +2 -2
  30. package/dist/types/approvals/attributed.d.ts +3 -0
  31. package/dist/types/approvals/judge.d.ts +20 -4
  32. package/dist/types/approvals/record.d.ts +19 -3
  33. package/dist/types/approvals/sudo-client.d.ts +8 -0
  34. package/dist/types/approvals/sudo.d.ts +3 -1
  35. package/dist/types/guests/capture.d.ts +33 -0
  36. package/dist/types/guests/seats.d.ts +8 -1
  37. package/dist/types/index.d.ts +4 -2
  38. package/dist/types/owner.d.ts +3 -1
  39. package/dist/types/services.d.ts +1 -1
  40. package/package.json +4 -4
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/approvals/sudo.ts"],
4
- "sourcesContent": ["import type { Context, ReplicatedState } from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { AgentsState } from '../agents.ts';\nimport type { Licks } from '../licks/licks.ts';\nimport { sprinklesOf } from '../sprinkles/cgi.ts';\nimport type { Approvals } from './index.ts';\nimport {\n type Approval,\n type ApprovalRequester,\n cleanReason,\n REASONS,\n type SudoDetail,\n type SudoStdin,\n} from './record.ts';\n\nexport type SudoAnswer = 'once' | 'always' | 'deny';\n\nexport type SudoDenial = { answer: 'deny'; message: string };\n\nexport type SudoReply = SudoAnswer | SudoDenial;\n\nexport interface SudoRequest {\n id: string;\n kind: 'sudo';\n user: string;\n uid?: number;\n target?: string;\n argv: string[];\n path?: string;\n cwd?: string;\n pid?: number;\n tag?: string;\n tags?: string[];\n tty?: string;\n createdAt?: number;\n expiresAt: number;\n always?: boolean;\n stdin?: SudoStdin;\n rootOnly?: Record<string, boolean>;\n}\n\nexport type SudoAsked = { id: string; error: null } | { id: null; error: string };\n\nexport interface AgentSudo {\n readonly approvals: ReplicatedState<Approval[]>;\n request(request: SudoRequest, where: string | null, context: Context): Promise<SudoAsked>;\n withdraw(id: string, reason: string | null, context: Context): Promise<void>;\n}\n\nconst SAFE = /^[\\w@%+=:,./-]+$/;\n\nexport const shellWord = (word: string): string =>\n SAFE.test(word) ? word : `'${word.replaceAll(\"'\", `'\\\\''`)}'`;\n\nconst text = (value: unknown): value is string => typeof value === 'string';\n\nexport function sudoRequest(value: unknown): SudoRequest | null {\n const request = value as Partial<SudoRequest> | null;\n if (typeof request !== 'object' || request === null || request.kind !== 'sudo') return null;\n const { argv, user, expiresAt } = request;\n if (!Array.isArray(argv) || !argv.length || !argv.every(text)) return null;\n if (!text(user) || typeof expiresAt !== 'number' || !Number.isFinite(expiresAt)) return null;\n return request as SudoRequest;\n}\n\nfunction tagOf(tag: unknown): { kind?: unknown; agentId?: unknown; where?: unknown } | null {\n if (!text(tag)) return null;\n try {\n const parsed = JSON.parse(tag);\n return typeof parsed === 'object' && parsed !== null ? parsed : null;\n } catch {\n return null;\n }\n}\n\nconst TERMINAL = 'terminal:';\nconst FOLLOWER = 'follower:';\n\nfunction shownWhere(where: string, given: string | undefined): string {\n if (given) return given;\n if (where.startsWith(TERMINAL)) return 'a terminal';\n if (where.startsWith(FOLLOWER)) return 'a linked device';\n return where;\n}\n\nexport function sudoRequester(\n request: SudoRequest,\n agents: Readonly<AgentsState> | undefined,\n where?: string | null\n): { requester: ApprovalRequester; agentId: string } {\n const tag = tagOf(request.tag);\n const name = request.user;\n const sprinkle = sprinklesOf(Array.isArray(request.tags) ? request.tags.filter(text) : [])[0];\n if (sprinkle)\n return { requester: { kind: 'user', name, where: `the ${sprinkle} sprinkle` }, agentId: '' };\n if (tag?.kind === 'agent' && text(tag.agentId)) {\n const id = tag.agentId.startsWith('cone:') ? tag.agentId.slice('cone:'.length) : tag.agentId;\n const known = agents?.cones[id]?.name ?? agents?.scoops[id]?.name ?? name;\n return { requester: { kind: 'agent', name: known, agentId: id }, agentId: id };\n }\n if (tag?.kind === 'user' && text(tag.where)) {\n const given = cleanReason(where);\n const device = tag.where.startsWith(FOLLOWER) ? tag.where.slice(FOLLOWER.length) : '';\n return {\n requester: {\n kind: 'user',\n name,\n where: shownWhere(tag.where, given),\n ...(device ? { device } : {}),\n },\n agentId: '',\n };\n }\n return { requester: { kind: 'user', name }, agentId: '' };\n}\n\nconst STDIN: readonly unknown[] = ['tty', 'none', 'pipe', 'file'];\n\nfunction rootOnlyOf(value: unknown): Record<string, boolean> | undefined {\n if (typeof value !== 'object' || value === null || Array.isArray(value)) return undefined;\n const kept = Object.entries(value).filter(\n (entry): entry is [string, boolean] => typeof entry[1] === 'boolean'\n );\n return Object.fromEntries(kept);\n}\n\nfunction kernelFacts(request: SudoRequest): Partial<SudoDetail> {\n const rootOnly = rootOnlyOf(request.rootOnly);\n return {\n ...(STDIN.includes(request.stdin) ? { stdin: request.stdin } : {}),\n ...(rootOnly ? { rootOnly } : {}),\n ...(typeof request.always === 'boolean' ? { writable: request.always } : {}),\n };\n}\n\nexport function sudoDetail(request: SudoRequest): SudoDetail {\n const command = [request.path || request.argv[0], ...request.argv.slice(1)]\n .map((word) => shellWord(String(word)))\n .join(' ');\n return {\n command,\n ...(text(request.target) ? { target: request.target } : {}),\n ...(text(request.cwd) ? { cwd: request.cwd } : {}),\n ...(request.always === true ? { alwaysScope: 'cwd' as const } : {}),\n ...kernelFacts(request),\n };\n}\n\nfunction scoopLick(\n id: string,\n agentId: string,\n detail: SudoDetail,\n agents: Readonly<AgentsState> | undefined\n) {\n const scoop = agents?.scoops[agentId];\n if (!scoop) return undefined;\n const { command, target, cwd } = detail;\n const as = target ? ` as ${target}` : '';\n const at = cwd ? ` in ${cwd}` : '';\n return {\n channel: 'sudo-request' as const,\n source: id,\n title: `${scoop.name} waits for sudo`,\n text: `[scoop ${scoop.name} waits for a person to approve sudo]`,\n body: `${scoop.name} asked to run ${command}${as}${at}. A person answers it in the approvals dialog; you can't approve it. It ends when someone answers or it times out.`,\n target: `cone:${scoop.cone}` as const,\n };\n}\n\nexport interface SudoAttach {\n approvals: Approvals;\n agents?: () => Readonly<AgentsState> | undefined;\n licks?: Pick<Licks, 'deliver'>;\n}\n\ntype SudoLick = NonNullable<ReturnType<typeof scoopLick>>;\n\nexport function createSudo(options: SudoAttach): AgentSudo & { close(): void } {\n const { approvals } = options;\n const agents = () => options.agents?.();\n const waiting = new Map<string, SudoLick>();\n const send = (lick: SudoLick) =>\n void options.licks?.deliver(lick, BACKGROUND_CONTEXT).catch(() => undefined);\n const watch = (items: readonly Approval[]) => {\n for (const [id, lick] of waiting) {\n const item = items.find((entry) => entry.id === id);\n if (item?.state === 'pending' && item.tier !== 'user') continue;\n waiting.delete(id);\n if (item?.state === 'pending') send(lick);\n }\n };\n const off = approvals.state.subscribe((items) => watch(items));\n return {\n approvals: approvals.state,\n async request(value, where, context) {\n const request = sudoRequest(value);\n if (!request) return { id: null, error: 'This is not a sudo request.' };\n const { requester, agentId } = sudoRequester(request, agents(), where);\n const detail = sudoDetail(request);\n const item = await approvals.request(\n {\n kind: 'sudo',\n agentId,\n requester,\n tier: 'user',\n always: request.always !== false,\n expiresAt: request.expiresAt,\n detail,\n },\n context\n );\n const lick = scoopLick(item.id, agentId, detail, agents());\n if (lick) {\n waiting.set(item.id, lick);\n watch(approvals.state.value as Approval[]);\n }\n return { id: item.id, error: null };\n },\n async withdraw(id, reason, context) {\n await approvals.withdraw(id, reason, context);\n },\n close() {\n off();\n waiting.clear();\n },\n };\n}\n\nexport function ownedSudo(sudo: AgentSudo): AgentSudo & { release(): void } {\n const mine = new Set<string>();\n const forget = () => {\n const open = new Set(\n (sudo.approvals.value as Approval[])\n .filter((item) => item.state === 'pending')\n .map(({ id }) => id)\n );\n for (const id of mine) if (!open.has(id)) mine.delete(id);\n };\n return {\n approvals: sudo.approvals,\n async request(request, where, context) {\n forget();\n const asked = await sudo.request(request, where, context);\n if (asked.id) mine.add(asked.id);\n return asked;\n },\n async withdraw(id, reason, context) {\n if (!mine.delete(id)) return;\n await sudo.withdraw(id, reason, context);\n },\n release() {\n forget();\n for (const id of mine)\n void sudo.withdraw(id, REASONS.disconnected, BACKGROUND_CONTEXT).catch(() => undefined);\n mine.clear();\n },\n };\n}\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["import type { Context, ReplicatedState } from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { AgentsState } from '../agents.ts';\nimport type { AgentCapture } from '../guests/capture.ts';\nimport type { Licks } from '../licks/licks.ts';\nimport { sprinklesOf } from '../sprinkles/cgi.ts';\nimport type { Approvals } from './index.ts';\nimport {\n type Approval,\n type ApprovalRequester,\n cleanReason,\n REASONS,\n type SudoDetail,\n type SudoStdin,\n} from './record.ts';\n\nexport type SudoAnswer = 'once' | 'always' | 'deny';\n\nexport type SudoDenial = { answer: 'deny'; message: string };\n\nexport type SudoReply = SudoAnswer | SudoDenial;\n\nexport interface SudoRequest {\n id: string;\n kind: 'sudo';\n user: string;\n uid?: number;\n target?: string;\n argv: string[];\n path?: string;\n cwd?: string;\n pid?: number;\n tag?: string;\n tags?: string[];\n tty?: string;\n createdAt?: number;\n expiresAt: number;\n always?: boolean;\n stdin?: SudoStdin;\n rootOnly?: Record<string, boolean>;\n}\n\nexport type SudoAsked = { id: string; error: null } | { id: null; error: string };\n\nexport interface AgentSudo extends AgentCapture {\n readonly approvals: ReplicatedState<Approval[]>;\n request(request: SudoRequest, where: string | null, context: Context): Promise<SudoAsked>;\n withdraw(id: string, reason: string | null, context: Context): Promise<void>;\n}\n\nconst SAFE = /^[\\w@%+=:,./-]+$/;\n\nexport const shellWord = (word: string): string =>\n SAFE.test(word) ? word : `'${word.replaceAll(\"'\", `'\\\\''`)}'`;\n\nconst text = (value: unknown): value is string => typeof value === 'string';\n\nexport function sudoRequest(value: unknown): SudoRequest | null {\n const request = value as Partial<SudoRequest> | null;\n if (typeof request !== 'object' || request === null || request.kind !== 'sudo') return null;\n const { argv, user, expiresAt } = request;\n if (!Array.isArray(argv) || !argv.length || !argv.every(text)) return null;\n if (!text(user) || typeof expiresAt !== 'number' || !Number.isFinite(expiresAt)) return null;\n return request as SudoRequest;\n}\n\nfunction tagOf(tag: unknown): { kind?: unknown; agentId?: unknown; where?: unknown } | null {\n if (!text(tag)) return null;\n try {\n const parsed = JSON.parse(tag);\n return typeof parsed === 'object' && parsed !== null ? parsed : null;\n } catch {\n return null;\n }\n}\n\nconst TERMINAL = 'terminal:';\nconst FOLLOWER = 'follower:';\n\nfunction shownWhere(where: string, given: string | undefined): string {\n if (given) return given;\n if (where.startsWith(TERMINAL)) return 'a terminal';\n if (where.startsWith(FOLLOWER)) return 'a linked device';\n return where;\n}\n\nexport function sudoRequester(\n request: SudoRequest,\n agents: Readonly<AgentsState> | undefined,\n where?: string | null\n): { requester: ApprovalRequester; agentId: string } {\n const tag = tagOf(request.tag);\n const name = request.user;\n const sprinkle = sprinklesOf(Array.isArray(request.tags) ? request.tags.filter(text) : [])[0];\n if (sprinkle)\n return { requester: { kind: 'user', name, where: `the ${sprinkle} sprinkle` }, agentId: '' };\n if (tag?.kind === 'agent' && text(tag.agentId)) {\n const id = tag.agentId.startsWith('cone:') ? tag.agentId.slice('cone:'.length) : tag.agentId;\n const known = agents?.cones[id]?.name ?? agents?.scoops[id]?.name ?? name;\n return { requester: { kind: 'agent', name: known, agentId: id }, agentId: id };\n }\n if (tag?.kind === 'user' && text(tag.where)) {\n const given = cleanReason(where);\n const device = tag.where.startsWith(FOLLOWER) ? tag.where.slice(FOLLOWER.length) : '';\n return {\n requester: {\n kind: 'user',\n name,\n where: shownWhere(tag.where, given),\n ...(device ? { device } : {}),\n },\n agentId: '',\n };\n }\n return { requester: { kind: 'user', name }, agentId: '' };\n}\n\nconst STDIN: readonly unknown[] = ['tty', 'none', 'pipe', 'file'];\n\nfunction rootOnlyOf(value: unknown): Record<string, boolean> | undefined {\n if (typeof value !== 'object' || value === null || Array.isArray(value)) return undefined;\n const kept = Object.entries(value).filter(\n (entry): entry is [string, boolean] => typeof entry[1] === 'boolean'\n );\n return Object.fromEntries(kept);\n}\n\nfunction kernelFacts(request: SudoRequest): Partial<SudoDetail> {\n const rootOnly = rootOnlyOf(request.rootOnly);\n return {\n ...(STDIN.includes(request.stdin) ? { stdin: request.stdin } : {}),\n ...(rootOnly ? { rootOnly } : {}),\n ...(typeof request.always === 'boolean' ? { writable: request.always } : {}),\n };\n}\n\nexport function sudoDetail(request: SudoRequest): SudoDetail {\n const command = [request.path || request.argv[0], ...request.argv.slice(1)]\n .map((word) => shellWord(String(word)))\n .join(' ');\n return {\n command,\n ...(text(request.target) ? { target: request.target } : {}),\n ...(text(request.cwd) ? { cwd: request.cwd } : {}),\n ...(request.always === true ? { alwaysScope: 'cwd' as const } : {}),\n ...kernelFacts(request),\n };\n}\n\nfunction scoopLick(\n id: string,\n agentId: string,\n detail: SudoDetail,\n agents: Readonly<AgentsState> | undefined\n) {\n const scoop = agents?.scoops[agentId];\n if (!scoop) return undefined;\n const { command, target, cwd } = detail;\n const as = target ? ` as ${target}` : '';\n const at = cwd ? ` in ${cwd}` : '';\n return {\n channel: 'sudo-request' as const,\n source: id,\n title: `${scoop.name} waits for sudo`,\n text: `[scoop ${scoop.name} waits for a person to approve sudo]`,\n body: `${scoop.name} asked to run ${command}${as}${at}. A person answers it in the approvals dialog; you can't approve it. It ends when someone answers or it times out.`,\n target: `cone:${scoop.cone}` as const,\n };\n}\n\nexport interface SudoAttach {\n approvals: Approvals;\n capture: AgentCapture;\n agents?: () => Readonly<AgentsState> | undefined;\n licks?: Pick<Licks, 'deliver'>;\n}\n\ntype SudoLick = NonNullable<ReturnType<typeof scoopLick>>;\n\nexport function createSudo(options: SudoAttach): AgentSudo & { close(): void } {\n const { approvals } = options;\n const agents = () => options.agents?.();\n const waiting = new Map<string, SudoLick>();\n const send = (lick: SudoLick) =>\n void options.licks?.deliver(lick, BACKGROUND_CONTEXT).catch(() => undefined);\n const watch = (items: readonly Approval[]) => {\n for (const [id, lick] of waiting) {\n const item = items.find((entry) => entry.id === id);\n if (item?.state === 'pending' && item.tier !== 'user') continue;\n waiting.delete(id);\n if (item?.state === 'pending') send(lick);\n }\n };\n const off = approvals.state.subscribe((items) => watch(items));\n return {\n approvals: approvals.state,\n capture: (request, where, context) => options.capture.capture(request, where, context),\n async request(value, where, context) {\n const request = sudoRequest(value);\n if (!request) return { id: null, error: 'This is not a sudo request.' };\n const { requester, agentId } = sudoRequester(request, agents(), where);\n const detail = sudoDetail(request);\n const item = await approvals.request(\n {\n kind: 'sudo',\n agentId,\n requester,\n tier: 'user',\n always: request.always !== false,\n expiresAt: request.expiresAt,\n detail,\n },\n context\n );\n const lick = scoopLick(item.id, agentId, detail, agents());\n if (lick) {\n waiting.set(item.id, lick);\n watch(approvals.state.value as Approval[]);\n }\n return { id: item.id, error: null };\n },\n async withdraw(id, reason, context) {\n await approvals.withdraw(id, reason, context);\n },\n close() {\n off();\n waiting.clear();\n },\n };\n}\n\nexport function ownedSudo(sudo: AgentSudo): AgentSudo & { release(): void } {\n const mine = new Set<string>();\n const forget = () => {\n const open = new Set(\n (sudo.approvals.value as Approval[])\n .filter((item) => item.state === 'pending')\n .map(({ id }) => id)\n );\n for (const id of mine) if (!open.has(id)) mine.delete(id);\n };\n return {\n approvals: sudo.approvals,\n capture: (request, where, context) => sudo.capture(request, where, context),\n async request(request, where, context) {\n forget();\n const asked = await sudo.request(request, where, context);\n if (asked.id) mine.add(asked.id);\n return asked;\n },\n async withdraw(id, reason, context) {\n if (!mine.delete(id)) return;\n await sudo.withdraw(id, reason, context);\n },\n release() {\n forget();\n for (const id of mine)\n void sudo.withdraw(id, REASONS.disconnected, BACKGROUND_CONTEXT).catch(() => undefined);\n mine.clear();\n },\n };\n}\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -0,0 +1,167 @@
1
+ import { BACKGROUND_CONTEXT } from "@earendil-works/chord/context";
2
+ import { attributed, stampOf, UNATTRIBUTED } from "../approvals/attributed.js";
3
+ import {
4
+ cleanReason,
5
+ REASONS
6
+ } from "../approvals/record.js";
7
+ import { gateKind } from "./policy.js";
8
+ import { GuestsDoc, isGate, liveSeat } from "./seats.js";
9
+ import { taggedTaints } from "./tags.js";
10
+ const NOT_CAPTURE = "capture: not a capture kind";
11
+ const CAPTURE_JUDGED = "capture: denied by the approval judge";
12
+ const CAPTURE_LEFTOVER = "capture: a guest's job or crontab line is still running";
13
+ const PROGRAM = "a program";
14
+ const LABEL_LENGTH = 200;
15
+ const objectOf = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
16
+ const textOf = (value) => {
17
+ if (typeof value !== "string") return void 0;
18
+ const text = value.replace(/[\p{Cc}\p{Cf}]/gu, " ").replace(/\s+/g, " ").trim();
19
+ return text ? text.slice(0, LABEL_LENGTH) : void 0;
20
+ };
21
+ const secondsOf = (value) => typeof value === "number" && Number.isFinite(value) && value > 0 ? { seconds: value } : {};
22
+ const VISUAL = {
23
+ "capture.screen": "screen",
24
+ "capture.camera": "camera"
25
+ };
26
+ function captureDetail(request) {
27
+ const asked = objectOf(request);
28
+ const options = objectOf(asked.options);
29
+ const program = textOf(objectOf(asked.stamp).argv0) ?? PROGRAM;
30
+ const device = textOf(asked.label);
31
+ const named = device ? { device } : {};
32
+ if (asked.kind === "audio.record")
33
+ return { what: "microphone", mode: "audio", ...secondsOf(options.seconds), ...named, program };
34
+ const kind = typeof asked.kind === "string" ? asked.kind : "";
35
+ const what = Object.hasOwn(VISUAL, kind) ? VISUAL[kind] : void 0;
36
+ if (!what) return null;
37
+ const video = typeof options.type === "string" && options.type.startsWith("video/");
38
+ return {
39
+ what,
40
+ mode: video ? "video" : "still",
41
+ ...video ? secondsOf(options.duration) : {},
42
+ ...video && options.system === true ? { system: true } : {},
43
+ ...video && (options.microphone === true || typeof options.microphone === "string") ? { microphone: true } : {},
44
+ ...named,
45
+ program
46
+ };
47
+ }
48
+ const tagsOf = (request) => {
49
+ const { tags } = stampOf(request);
50
+ return Array.isArray(tags) ? tags.filter((tag) => typeof tag === "string") : [];
51
+ };
52
+ const keyOf = (taint) => `${taint.seat}
53
+ ${taint.tier}`;
54
+ const kept = (seat, detail) => seat.alwaysCaptures?.some((rule) => rule.what === detail.what && rule.mode === detail.mode);
55
+ function early(seat, tier, detail, policy, at) {
56
+ if (!isGate(tier)) return "deny";
57
+ if (!policy.allowedToolGates.includes(gateKind(tier))) return "deny";
58
+ if (!liveSeat(seat, at)) return "ended";
59
+ if (tier === "off") return "once";
60
+ return policy.always.tools && kept(seat, detail) ? "always" : null;
61
+ }
62
+ function denialOf(item) {
63
+ if (item.state === "withdrawn" && item.reason === REASONS.revoked) return "ended";
64
+ if (item.state !== "rejected" || item.decidedBy !== "judge") return "deny";
65
+ const reason = item.verdict?.reason;
66
+ return { answer: "deny", message: reason ? `${CAPTURE_JUDGED}: ${reason}` : CAPTURE_JUDGED };
67
+ }
68
+ async function settledOr(host, id, context) {
69
+ try {
70
+ return await host.approvals.settled(id, context);
71
+ } catch (error) {
72
+ await host.approvals.withdraw(id, REASONS.aborted, BACKGROUND_CONTEXT).catch(() => void 0);
73
+ throw error;
74
+ }
75
+ }
76
+ function captureGate(host) {
77
+ const now = host.now ?? Date.now;
78
+ const recentOf = async (request) => {
79
+ if (!host.lineage) return void 0;
80
+ const { pid } = stampOf(request);
81
+ const lineage = await host.lineage(typeof pid === "number" ? pid : null).catch(() => void 0);
82
+ return lineage?.recent;
83
+ };
84
+ const seatOf = async (id, context) => id === null ? void 0 : (await host.harness.snapshot(GuestsDoc, context))?.seats[id];
85
+ const remember = (seat, rule) => host.harness.commit(async (tx) => {
86
+ const record = (await tx.doc(GuestsDoc)).seats[seat];
87
+ if (record?.revoked === null)
88
+ record.alwaysCaptures = [
89
+ ...(record.alwaysCaptures ?? []).filter(
90
+ (entry) => entry.what !== rule.what || entry.mode !== rule.mode
91
+ ),
92
+ rule
93
+ ];
94
+ }, BACKGROUND_CONTEXT);
95
+ const off = async (taint, detail, context) => {
96
+ const seat = await seatOf(taint.seat, context);
97
+ return seat !== void 0 && early(seat, taint.tier, detail, host.policy(), now()) === "once";
98
+ };
99
+ const review = async (taint, detail, where, context) => {
100
+ const seat = await seatOf(taint.seat, context);
101
+ if (!seat) return "deny";
102
+ const settled = early(seat, taint.tier, detail, host.policy(), now());
103
+ if (settled) return settled;
104
+ const asked = await host.approvals.request(
105
+ {
106
+ kind: "capture",
107
+ seat: seat.id,
108
+ agentId: seat.agentId,
109
+ requester: { kind: "guest", name: seat.label, seat: seat.id, ...where ? { where } : {} },
110
+ tier: taint.tier,
111
+ detail
112
+ },
113
+ BACKGROUND_CONTEXT
114
+ );
115
+ if (!liveSeat(await seatOf(seat.id, context), now())) {
116
+ await host.approvals.withdraw(asked.id, REASONS.revoked, BACKGROUND_CONTEXT);
117
+ return "ended";
118
+ }
119
+ const item = asked.state === "pending" ? await settledOr(host, asked.id, context) : asked;
120
+ if (item.state !== "approved") return denialOf(item);
121
+ if (!liveSeat(await seatOf(seat.id, context), now())) return "ended";
122
+ if (item.answer !== "always" || !host.policy().always.tools) return "once";
123
+ const { what, mode } = detail;
124
+ await remember(seat.id, {
125
+ approval: item.id,
126
+ what,
127
+ mode,
128
+ by: item.decidedBy,
129
+ at: item.decidedAt
130
+ });
131
+ return "always";
132
+ };
133
+ const decide = async (taints, own, detail, where, context) => {
134
+ let answer = "always";
135
+ for (const taint of taints) {
136
+ const given = await review(taint, detail, where, context);
137
+ if (given === "once") answer = "once";
138
+ else if (given === "ended" || given === "deny" && !own.has(keyOf(taint)))
139
+ return { answer: "deny", message: CAPTURE_LEFTOVER };
140
+ else if (given !== "always") return given;
141
+ }
142
+ return answer;
143
+ };
144
+ return {
145
+ async capture(request, where, context) {
146
+ const detail = captureDetail(request);
147
+ if (!detail) return { answer: "deny", message: NOT_CAPTURE };
148
+ if (!attributed(request)) return "deny";
149
+ const recent = await recentOf(request);
150
+ if (!recent) return "deny";
151
+ const own = new Set((await taggedTaints(host.harness, tagsOf(request), context)).map(keyOf));
152
+ const taints = await taggedTaints(host.harness, [...tagsOf(request), ...recent], context);
153
+ for (const taint of taints) if (await off(taint, detail, context)) return UNATTRIBUTED;
154
+ return taints.length ? decide(taints, own, detail, cleanReason(where), context) : "once";
155
+ }
156
+ };
157
+ }
158
+ export {
159
+ CAPTURE_JUDGED,
160
+ CAPTURE_LEFTOVER,
161
+ LABEL_LENGTH,
162
+ NOT_CAPTURE,
163
+ PROGRAM,
164
+ captureDetail,
165
+ captureGate
166
+ };
167
+ //# sourceMappingURL=capture.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../src/guests/capture.ts"],
4
+ "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { Harness } from '@earendil-works/pi-durable';\nimport { attributed, stampOf, UNATTRIBUTED } from '../approvals/attributed.ts';\nimport type { Approval, Approvals } from '../approvals/index.ts';\nimport {\n type ApprovalAnswer,\n type CaptureDetail,\n type CaptureWhat,\n cleanReason,\n REASONS,\n} from '../approvals/record.ts';\nimport type { InheritedTaint } from './guard.ts';\nimport { type GuestPolicy, gateKind } from './policy.ts';\nimport { type AlwaysCapture, GuestsDoc, isGate, liveSeat, type SeatRecord } from './seats.ts';\nimport { taggedTaints } from './tags.ts';\n\nexport type CaptureAnswer = ApprovalAnswer;\n\nexport type CaptureDenial = { answer: 'deny'; message: string };\n\nexport type CaptureReply = CaptureAnswer | CaptureDenial;\n\nexport type CaptureLineage = (pid: number | null) => Promise<{ recent: string[] } | undefined>;\n\nexport type CaptureWire = CaptureReply | typeof UNATTRIBUTED;\n\nexport interface AgentCapture {\n capture(request: unknown, where: string | null, context: Context): Promise<CaptureWire>;\n}\n\nexport interface CaptureHost {\n harness: Pick<Harness, 'snapshot' | 'commit'>;\n approvals: Pick<Approvals, 'request' | 'settled' | 'withdraw'>;\n policy(): GuestPolicy;\n lineage?: CaptureLineage;\n now?: () => number;\n}\n\nexport const NOT_CAPTURE = 'capture: not a capture kind';\nexport const CAPTURE_JUDGED = 'capture: denied by the approval judge';\nexport const CAPTURE_LEFTOVER = \"capture: a guest's job or crontab line is still running\";\n\ntype Reviewed = CaptureReply | 'ended';\nexport const PROGRAM = 'a program';\nexport const LABEL_LENGTH = 200;\n\nconst objectOf = (value: unknown): Record<string, unknown> =>\n value && typeof value === 'object' && !Array.isArray(value)\n ? (value as Record<string, unknown>)\n : {};\n\nconst textOf = (value: unknown): string | undefined => {\n if (typeof value !== 'string') return undefined;\n const text = value\n .replace(/[\\p{Cc}\\p{Cf}]/gu, ' ')\n .replace(/\\s+/g, ' ')\n .trim();\n return text ? text.slice(0, LABEL_LENGTH) : undefined;\n};\n\nconst secondsOf = (value: unknown) =>\n typeof value === 'number' && Number.isFinite(value) && value > 0 ? { seconds: value } : {};\n\nconst VISUAL: Record<string, CaptureWhat> = {\n 'capture.screen': 'screen',\n 'capture.camera': 'camera',\n};\n\nexport function captureDetail(request: unknown): CaptureDetail | null {\n const asked = objectOf(request);\n const options = objectOf(asked.options);\n const program = textOf(objectOf(asked.stamp).argv0) ?? PROGRAM;\n const device = textOf(asked.label);\n const named = device ? { device } : {};\n if (asked.kind === 'audio.record')\n return { what: 'microphone', mode: 'audio', ...secondsOf(options.seconds), ...named, program };\n const kind = typeof asked.kind === 'string' ? asked.kind : '';\n const what = Object.hasOwn(VISUAL, kind) ? VISUAL[kind] : undefined;\n if (!what) return null;\n const video = typeof options.type === 'string' && options.type.startsWith('video/');\n return {\n what,\n mode: video ? 'video' : 'still',\n ...(video ? secondsOf(options.duration) : {}),\n ...(video && options.system === true ? { system: true } : {}),\n ...(video && (options.microphone === true || typeof options.microphone === 'string')\n ? { microphone: true }\n : {}),\n ...named,\n program,\n };\n}\n\nconst tagsOf = (request: unknown): string[] => {\n const { tags } = stampOf(request);\n return Array.isArray(tags) ? tags.filter((tag): tag is string => typeof tag === 'string') : [];\n};\n\nconst keyOf = (taint: InheritedTaint) => `${taint.seat}\\n${taint.tier}`;\n\nconst kept = (seat: SeatRecord, detail: CaptureDetail) =>\n seat.alwaysCaptures?.some((rule) => rule.what === detail.what && rule.mode === detail.mode);\n\nfunction early(\n seat: SeatRecord,\n tier: string,\n detail: CaptureDetail,\n policy: GuestPolicy,\n at: number\n): CaptureAnswer | 'ended' | null {\n if (!isGate(tier)) return 'deny';\n if (!policy.allowedToolGates.includes(gateKind(tier))) return 'deny';\n if (!liveSeat(seat, at)) return 'ended';\n if (tier === 'off') return 'once';\n return policy.always.tools && kept(seat, detail) ? 'always' : null;\n}\n\nfunction denialOf(item: Approval): Reviewed {\n if (item.state === 'withdrawn' && item.reason === REASONS.revoked) return 'ended';\n if (item.state !== 'rejected' || item.decidedBy !== 'judge') return 'deny';\n const reason = item.verdict?.reason;\n return { answer: 'deny', message: reason ? `${CAPTURE_JUDGED}: ${reason}` : CAPTURE_JUDGED };\n}\n\nasync function settledOr(host: CaptureHost, id: string, context: Context): Promise<Approval> {\n try {\n return await host.approvals.settled(id, context);\n } catch (error) {\n await host.approvals.withdraw(id, REASONS.aborted, BACKGROUND_CONTEXT).catch(() => undefined);\n throw error;\n }\n}\n\nexport function captureGate(host: CaptureHost): AgentCapture {\n const now = host.now ?? Date.now;\n const recentOf = async (request: unknown): Promise<string[] | undefined> => {\n if (!host.lineage) return undefined;\n const { pid } = stampOf(request);\n const lineage = await host.lineage(typeof pid === 'number' ? pid : null).catch(() => undefined);\n return lineage?.recent;\n };\n const seatOf = async (id: string | null, context: Context) =>\n id === null ? undefined : (await host.harness.snapshot(GuestsDoc, context))?.seats[id];\n const remember = (seat: string, rule: AlwaysCapture) =>\n host.harness.commit(async (tx) => {\n const record = (await tx.doc(GuestsDoc)).seats[seat];\n if (record?.revoked === null)\n record.alwaysCaptures = [\n ...(record.alwaysCaptures ?? []).filter(\n (entry) => entry.what !== rule.what || entry.mode !== rule.mode\n ),\n rule,\n ];\n }, BACKGROUND_CONTEXT);\n const off = async (taint: InheritedTaint, detail: CaptureDetail, context: Context) => {\n const seat = await seatOf(taint.seat, context);\n return seat !== undefined && early(seat, taint.tier, detail, host.policy(), now()) === 'once';\n };\n const review = async (\n taint: InheritedTaint,\n detail: CaptureDetail,\n where: string | undefined,\n context: Context\n ): Promise<Reviewed> => {\n const seat = await seatOf(taint.seat, context);\n if (!seat) return 'deny';\n const settled = early(seat, taint.tier, detail, host.policy(), now());\n if (settled) return settled;\n const asked = await host.approvals.request(\n {\n kind: 'capture',\n seat: seat.id,\n agentId: seat.agentId,\n requester: { kind: 'guest', name: seat.label, seat: seat.id, ...(where ? { where } : {}) },\n tier: taint.tier,\n detail,\n },\n BACKGROUND_CONTEXT\n );\n if (!liveSeat(await seatOf(seat.id, context), now())) {\n await host.approvals.withdraw(asked.id, REASONS.revoked, BACKGROUND_CONTEXT);\n return 'ended';\n }\n const item = asked.state === 'pending' ? await settledOr(host, asked.id, context) : asked;\n if (item.state !== 'approved') return denialOf(item);\n if (!liveSeat(await seatOf(seat.id, context), now())) return 'ended';\n if (item.answer !== 'always' || !host.policy().always.tools) return 'once';\n const { what, mode } = detail;\n await remember(seat.id, {\n approval: item.id,\n what,\n mode,\n by: item.decidedBy,\n at: item.decidedAt as number,\n });\n return 'always';\n };\n const decide = async (\n taints: readonly InheritedTaint[],\n own: ReadonlySet<string>,\n detail: CaptureDetail,\n where: string | undefined,\n context: Context\n ): Promise<CaptureReply> => {\n let answer: CaptureAnswer = 'always';\n for (const taint of taints) {\n const given = await review(taint, detail, where, context);\n if (given === 'once') answer = 'once';\n else if (given === 'ended' || (given === 'deny' && !own.has(keyOf(taint))))\n return { answer: 'deny', message: CAPTURE_LEFTOVER };\n else if (given !== 'always') return given;\n }\n return answer;\n };\n return {\n async capture(request, where, context) {\n const detail = captureDetail(request);\n if (!detail) return { answer: 'deny', message: NOT_CAPTURE };\n if (!attributed(request)) return 'deny';\n const recent = await recentOf(request);\n if (!recent) return 'deny';\n const own = new Set((await taggedTaints(host.harness, tagsOf(request), context)).map(keyOf));\n const taints = await taggedTaints(host.harness, [...tagsOf(request), ...recent], context);\n for (const taint of taints) if (await off(taint, detail, context)) return UNATTRIBUTED;\n return taints.length ? decide(taints, own, detail, cleanReason(where), context) : 'once';\n },\n };\n}\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
@@ -139,9 +139,15 @@ async function place(record, prepared, options, using, at) {
139
139
  function forgotten(harness, id, approval, using) {
140
140
  return harness.commit(async (tx) => {
141
141
  const record = (await tx.doc(GuestsDoc)).seats[id];
142
- const kept = record?.alwaysTools?.filter((rule) => rule.approval !== approval);
143
- if (!record || !kept || kept.length === record.alwaysTools?.length) return { removed: false };
144
- record.alwaysTools = kept;
142
+ if (!record) return { removed: false };
143
+ const tools = record.alwaysTools ?? [];
144
+ const captures = record.alwaysCaptures ?? [];
145
+ const keptTools = tools.filter((rule) => rule.approval !== approval);
146
+ const keptCaptures = captures.filter((rule) => rule.approval !== approval);
147
+ if (keptTools.length + keptCaptures.length === tools.length + captures.length)
148
+ return { removed: false };
149
+ record.alwaysTools = keptTools;
150
+ record.alwaysCaptures = keptCaptures;
145
151
  return { removed: true };
146
152
  }, using);
147
153
  }
@@ -172,7 +178,8 @@ function shownSeats(records, links, at, pendingOf) {
172
178
  gates: { ...record.gates },
173
179
  connected: (links.get(record.id) ?? 0) > 0,
174
180
  pending: pendingOf(record.id),
175
- alwaysTools: (record.alwaysTools ?? []).map(({ argumentsHash: _hash, ...rule }) => rule)
181
+ alwaysTools: (record.alwaysTools ?? []).map(({ argumentsHash: _hash, ...rule }) => rule),
182
+ alwaysCaptures: (record.alwaysCaptures ?? []).map((rule) => ({ ...rule }))
176
183
  }));
177
184
  }
178
185
  function openedSeats(harness, using) {
@@ -186,6 +193,12 @@ function openedSeats(harness, using) {
186
193
  return copy(seats);
187
194
  }, using);
188
195
  }
196
+ const revokedAt = (record, at) => Object.assign(record, {
197
+ revoked: at,
198
+ epoch: record.epoch + 1,
199
+ alwaysTools: [],
200
+ alwaysCaptures: []
201
+ });
189
202
  async function createGuests(options) {
190
203
  const { harness, agents } = options;
191
204
  const now = options.now ?? Date.now;
@@ -302,7 +315,7 @@ async function createGuests(options) {
302
315
  const changed = await write((all) => {
303
316
  const record = all[id];
304
317
  if (!record || record.revoked !== null) return void 0;
305
- return Object.assign(record, { revoked: at, epoch: record.epoch + 1, alwaysTools: [] });
318
+ return revokedAt(record, at);
306
319
  });
307
320
  if (!changed) return { revoked: false };
308
321
  records[id] = changed;
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/guests/index.ts"],
4
- "sourcesContent": ["import { type Context, type ReplicatedState, replicatedState } from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport { type Harness, InboxDoc } from '@earendil-works/pi-durable';\nimport type { Agents } from '../agents.ts';\nimport type { Approvals } from '../approvals/index.ts';\nimport type { ApprovalPolicies } from '../approvals/policy.ts';\nimport { scrubText } from '../secrets/scrub.ts';\nimport type { GuestPrincipal } from '../serving.ts';\nimport {\n ASKED_KIND,\n GUEST_INPUT_KIND,\n type GuestAsked,\n type GuestInput,\n guestContent,\n} from './attribution.ts';\nimport { GUEST_REQUEST, sealedRules } from './guard.ts';\nimport { DEFAULT_GUEST_POLICY, type GuestPolicy } from './policy.ts';\nimport {\n endReview,\n type GuestReviews,\n GuestReviewsDoc,\n KEPT_SUBMISSIONS,\n liveReviews,\n MAX_QUEUED,\n pruneReviews,\n type ReviewsState,\n told,\n} from './review.ts';\nimport {\n checkDraft,\n cleanLabel,\n type GuestDraft,\n type GuestSeat,\n GuestsDoc,\n type GuestsState,\n liveSeat,\n MAX_SEAT_MS,\n type SeatRecord,\n} from './seats.ts';\n\nexport type GuestOpened = { seat: GuestSeat; error: null } | { seat: null; error: string };\n\nexport type Proposed =\n | { state: 'submitted'; submissionId: string; reason: null }\n | { state: 'queued'; submissionId: null; review: string; reason: null }\n | { state: 'unanswered'; submissionId: null; reason: string };\n\nexport interface ProposeRequest {\n text: string;\n requestId: string | null;\n}\n\nexport interface Guests {\n readonly seats: ReplicatedState<GuestSeat[]>;\n readonly reviews: ReplicatedState<ReviewsState | null>;\n open(draft: GuestDraft, context: Context): Promise<GuestOpened>;\n revoke(id: string, context: Context): Promise<{ revoked: boolean }>;\n forgetAlways(id: string, approval: string, context: Context): Promise<{ removed: boolean }>;\n admit(id: string, label: string): GuestPrincipal | null;\n record(id: string): SeatRecord | undefined;\n current(guest: GuestPrincipal): SeatRecord | undefined;\n joined(id: string): () => void;\n onEnd(listener: (id: string) => void): () => void;\n propose(guest: GuestPrincipal, request: ProposeRequest, context: Context): Promise<Proposed>;\n policy(): GuestPolicy;\n dispose(): void;\n}\n\nexport interface GuestsOptions {\n harness: Pick<Harness, 'commit' | 'abortSubmission' | 'watchDoc'>;\n agents: Pick<Agents, 'state' | 'conversation'>;\n approvals?: Pick<Approvals, 'state' | 'request' | 'withdrawSeat' | 'expire' | 'withdraw'>;\n policy?: Pick<ApprovalPolicies, 'current'>;\n reviews?: Pick<GuestReviews, 'task' | 'bind'>;\n now?: () => number;\n context?: Context;\n}\n\nexport const MAX_PROPOSAL = 32_000;\nconst MAX_REQUEST = 128;\nconst LONGEST_TIMER = 2 ** 31 - 1;\n\nconst copy = <T>(value: T): T => JSON.parse(JSON.stringify(value)) as T;\n\nconst unanswered = (reason: string): Proposed => ({\n state: 'unanswered',\n submissionId: null,\n reason,\n});\n\nfunction prune(all: Record<string, SeatRecord>, at: number) {\n for (const [id, record] of Object.entries(all)) {\n const over = record.revoked ?? record.expiresAt;\n if (over !== null && at - over > MAX_SEAT_MS) delete all[id];\n }\n}\n\nasync function withdrawQueued(\n harness: GuestsOptions['harness'],\n agents: GuestsOptions['agents'],\n record: SeatRecord,\n using: Context\n) {\n const conversation = await agents.conversation(record.agentId, using);\n if (!conversation) return;\n const queued = await harness.commit(\n async (tx) =>\n (await tx.doc(InboxDoc, conversation.id)).items\n .filter((item) => {\n const entry = item.entry as { kind?: string; data?: { seat?: unknown } } | undefined;\n return entry?.kind === GUEST_INPUT_KIND && entry.data?.seat === record.id;\n })\n .map((item) => item.id),\n using\n );\n for (const id of queued) await harness.abortSubmission(id, using, conversation.id);\n}\n\nasync function deliver(\n record: SeatRecord,\n text: string,\n requestId: string,\n options: GuestsOptions,\n using: Context\n): Promise<Proposed> {\n const conversation = await options.agents.conversation(record.agentId, using);\n if (!conversation) return unanswered('gone');\n const data: GuestInput = { seat: record.id, name: record.label, approval: null };\n const submitted = await conversation.submit(\n {\n type: 'input',\n content: guestContent(record.label, text),\n whenBusy: 'followUp',\n entry: { kind: GUEST_INPUT_KIND, data: { ...data } },\n requestId,\n },\n using\n );\n const id = String(submitted.id);\n await options.harness.commit(async (tx) => {\n const kept = (await tx.doc(GuestsDoc)).seats[record.id];\n if (!kept || kept.submissions?.some((entry) => entry.id === id)) return;\n kept.submissions = [\n ...(kept.submissions ?? []),\n { id, approval: null, tools: record.gates.tools },\n ].slice(-KEPT_SUBMISSIONS);\n }, using);\n return { state: 'submitted', submissionId: id, reason: null };\n}\n\ntype Prepared = { text: string; requestId: string };\n\nasync function prepare(record: SeatRecord, request: ProposeRequest): Promise<Prepared | Proposed> {\n const text = typeof request?.text === 'string' ? request.text.trim() : '';\n if (!text) return unanswered('empty');\n if (text.length > MAX_PROPOSAL) return unanswered('too-long');\n const asked =\n typeof request.requestId === 'string' &&\n request.requestId &&\n request.requestId.length <= MAX_REQUEST\n ? request.requestId\n : crypto.randomUUID();\n return { text: await scrubText(text), requestId: `${GUEST_REQUEST}${record.id}:${asked}` };\n}\n\nasync function place(\n record: SeatRecord,\n prepared: Prepared,\n options: GuestsOptions,\n using: Context,\n at: number\n): Promise<Proposed> {\n const gate = record.gates.messages;\n if (gate === 'off') return deliver(record, prepared.text, prepared.requestId, options, using);\n const { reviews } = options;\n if (!reviews || !options.approvals) return unanswered('unavailable');\n const conversation = await options.agents.conversation(record.agentId, using);\n if (!conversation) return unanswered('gone');\n return options.harness.commit(async (tx): Promise<Proposed> => {\n const doc = await tx.doc(GuestReviewsDoc);\n const again = Object.values(doc.reviews).find(\n (review) => review.seat === record.id && review.request === prepared.requestId\n );\n if (again) return { state: 'queued', submissionId: null, review: again.id, reason: null };\n if (liveReviews(doc, record.id).length > MAX_QUEUED) return unanswered('overflow');\n const id = `apr-${crypto.randomUUID()}`;\n const task = await tx.createTask(\n reviews.task,\n { review: id },\n { ownership: { kind: 'conversation' }, conversationId: conversation.id, background: true }\n );\n doc.reviews[id] = {\n id,\n seat: record.id,\n agentId: record.agentId,\n label: record.label,\n text: prepared.text,\n request: prepared.requestId,\n tier: gate,\n tools: record.gates.tools,\n n: doc.next,\n task: Number(task),\n state: 'queued',\n reason: null,\n createdAt: at,\n decidedAt: null,\n submissionId: null,\n ended: false,\n conversation: Number(conversation.id),\n };\n doc.next += 1;\n pruneReviews(doc);\n const asked: GuestAsked = {\n seat: record.id,\n name: record.label,\n review: id,\n text: prepared.text,\n at,\n };\n await tx.appendEntry(conversation.id, { kind: ASKED_KIND, data: { ...asked } });\n return { state: 'queued', submissionId: null, review: id, reason: null };\n }, using);\n}\n\nfunction forgotten(\n harness: GuestsOptions['harness'],\n id: string,\n approval: string,\n using: Context\n): Promise<{ removed: boolean }> {\n return harness.commit(async (tx) => {\n const record = (await tx.doc(GuestsDoc)).seats[id];\n const kept = record?.alwaysTools?.filter((rule) => rule.approval !== approval);\n if (!record || !kept || kept.length === record.alwaysTools?.length) return { removed: false };\n record.alwaysTools = kept;\n return { removed: true };\n }, using);\n}\n\nfunction keyedLine() {\n const locks = new Map<string, Promise<unknown>>();\n return <T>(id: string, run: () => Promise<T>): Promise<T> => {\n const next = (locks.get(id) ?? Promise.resolve()).then(run, run);\n const settled = next.catch(() => undefined);\n locks.set(id, settled);\n void settled.then(() => {\n if (locks.get(id) === settled) locks.delete(id);\n });\n return next;\n };\n}\n\nfunction replaceSeats(records: Record<string, SeatRecord>, seats: GuestsState['seats']) {\n for (const id of Object.keys(records)) delete records[id];\n Object.assign(records, copy(seats));\n}\n\nconst pendingIn =\n (\n approvals: GuestsOptions['approvals'],\n reviews: { readonly value: ReviewsState | null | undefined }\n ) =>\n (id: string): number =>\n (approvals?.state.value ?? []).filter((item) => item.seat === id && item.state === 'pending')\n .length + liveReviews(reviews.value, id).filter((review) => review.state === 'queued').length;\n\nfunction shownSeats(\n records: Record<string, SeatRecord>,\n links: ReadonlyMap<string, number>,\n at: number,\n pendingOf: (id: string) => number\n): GuestSeat[] {\n return Object.values(records)\n .filter((record) => liveSeat(record, at))\n .sort((a, b) => a.createdAt - b.createdAt || a.id.localeCompare(b.id))\n .map((record) => ({\n id: record.id,\n label: record.label,\n agentId: record.agentId,\n createdAt: record.createdAt,\n expiresAt: record.expiresAt,\n gates: { ...record.gates },\n connected: (links.get(record.id) ?? 0) > 0,\n pending: pendingOf(record.id),\n alwaysTools: (record.alwaysTools ?? []).map(({ argumentsHash: _hash, ...rule }) => rule),\n }));\n}\n\nfunction openedSeats(\n harness: GuestsOptions['harness'],\n using: Context\n): Promise<Record<string, SeatRecord>> {\n return harness.commit(async (tx) => {\n await tx.doc(GuestReviewsDoc);\n const seats = (await tx.doc(GuestsDoc)).seats;\n for (const record of Object.values(seats)) {\n const rules = await sealedRules(record.alwaysTools ?? []);\n if (rules) record.alwaysTools = rules;\n }\n return copy(seats);\n }, using);\n}\n\nexport async function createGuests(options: GuestsOptions): Promise<Guests> {\n const { harness, agents } = options;\n const now = options.now ?? Date.now;\n const context = options.context ?? BACKGROUND_CONTEXT;\n const guestPolicy = () => options.policy?.current().guests ?? DEFAULT_GUEST_POLICY;\n const records = await openedSeats(harness, context);\n const seatsWatch = await harness.watchDoc(GuestsDoc, context);\n if (!seatsWatch) throw new Error('guests document is missing');\n const reviewsWatch = await harness.watchDoc(GuestReviewsDoc, context);\n if (!reviewsWatch) throw new Error('guest reviews document is missing');\n const reviews = replicatedState(copy(reviewsWatch.value));\n const links = new Map<string, number>();\n const ended = new Set<(id: string) => void>();\n const gone = new Map<string, Promise<void>>();\n const shown = () => shownSeats(records, links, now(), pendingIn(options.approvals, reviews));\n const seats = replicatedState<GuestSeat[]>(shown());\n let timer: ReturnType<typeof setTimeout> | undefined;\n const locked = keyedLine();\n const cleanup = (record: SeatRecord, using: Context) =>\n locked(record.id, async () => {\n await withdrawQueued(harness, agents, record, using);\n await harness.commit(async (tx) => {\n const doc = await tx.doc(GuestReviewsDoc);\n for (const review of liveReviews(doc, record.id))\n if (review.state === 'queued') {\n endReview(review, 'withdrawn', 'revoked', now());\n await told(tx, review);\n }\n }, using);\n await options.approvals?.withdrawSeat(record.id, using);\n });\n const end = (id: string, using: Context = context): Promise<void> => {\n const going = gone.get(id);\n if (going !== undefined) return going;\n const cleaning = cleanup(records[id] as SeatRecord, using);\n gone.set(id, cleaning);\n for (const listener of [...ended]) listener(id);\n return cleaning;\n };\n const publish = () => {\n const at = now();\n for (const record of Object.values(records))\n if (!liveSeat(record, at)) void end(record.id).catch(() => undefined);\n seats.replace(context, shown());\n if (timer) clearTimeout(timer);\n timer = undefined;\n const next = Math.min(\n ...Object.values(records)\n .filter((record) => liveSeat(record, at) && record.expiresAt !== null)\n .map((record) => record.expiresAt as number)\n );\n if (Number.isFinite(next))\n timer = setTimeout(publish, Math.min(Math.max(0, next - at), LONGEST_TIMER));\n };\n replaceSeats(records, seatsWatch.value.seats);\n publish();\n seatsWatch.start(async (call) => {\n if (call.kind !== 'value') return;\n replaceSeats(records, call.value.seats);\n publish();\n });\n const write = (change: (seats: Record<string, SeatRecord>) => SeatRecord | undefined) =>\n harness.commit(async (tx) => {\n const doc = await tx.doc(GuestsDoc);\n const changed = change(doc.seats);\n return changed ? copy(changed) : undefined;\n }, context);\n const recount = () => seats.replace(context, shown());\n const offPending = options.approvals?.state.subscribe(recount);\n const offReviews = reviews.subscribe(recount);\n reviewsWatch.start(async (call) => {\n if (call.kind === 'value') reviews.replace(context, copy(call.value));\n });\n options.reviews?.bind({\n approvals: options.approvals as NonNullable<GuestsOptions['approvals']>,\n agents,\n line: locked,\n alwaysAllowed: () => guestPolicy().always.messages,\n });\n const current = (guest: GuestPrincipal) => {\n const record = records[guest.id];\n return record && liveSeat(record, now()) && record.epoch === guest.epoch ? record : undefined;\n };\n return {\n seats,\n reviews,\n async open(draft, using) {\n const at = now();\n const problem = checkDraft(draft, at, guestPolicy());\n if (problem) return { seat: null, error: problem };\n if (!agents.state().cones[draft.agentId])\n return { seat: null, error: `There is no cone ${draft.agentId}.` };\n const record: SeatRecord = {\n id: draft.id,\n label: cleanLabel(draft.label),\n agentId: draft.agentId,\n expiresAt: draft.expiresAt,\n gates: { messages: draft.gates.messages, tools: draft.gates.tools },\n createdAt: at,\n epoch: 1,\n revoked: null,\n };\n const kept = await harness.commit(async (tx) => {\n const doc = await tx.doc(GuestsDoc);\n if (doc.seats[record.id]) return null;\n prune(doc.seats, at);\n doc.seats[record.id] = copy(record);\n return copy(doc.seats);\n }, using);\n if (!kept) return { seat: null, error: 'That guest seat already exists.' };\n for (const id of Object.keys(records)) delete records[id];\n Object.assign(records, kept);\n publish();\n return { seat: shown().find((seat) => seat.id === record.id) as GuestSeat, error: null };\n },\n async revoke(id, using) {\n const at = now();\n const changed = await write((all) => {\n const record = all[id];\n if (!record || record.revoked !== null) return undefined;\n return Object.assign(record, { revoked: at, epoch: record.epoch + 1, alwaysTools: [] });\n });\n if (!changed) return { revoked: false };\n records[id] = changed;\n const ending = end(id, using);\n publish();\n await ending;\n return { revoked: true };\n },\n forgetAlways: (id, approval, using) => forgotten(harness, id, approval, using),\n admit(id, label) {\n const record = records[id];\n if (!record || !liveSeat(record, now()) || record.label !== cleanLabel(label)) return null;\n return { id: record.id, name: record.label, epoch: record.epoch };\n },\n record: (id) => records[id],\n current,\n joined(id) {\n links.set(id, (links.get(id) ?? 0) + 1);\n seats.replace(context, shown());\n let left = false;\n return () => {\n if (left) return;\n left = true;\n links.set(id, (links.get(id) ?? 1) - 1);\n seats.replace(context, shown());\n };\n },\n onEnd(listener) {\n ended.add(listener);\n return () => ended.delete(listener);\n },\n async propose(guest, request, using) {\n const record = current(guest);\n if (!record) return unanswered('revoked');\n const prepared = await prepare(record, request);\n if ('state' in prepared) return prepared;\n return locked(record.id, async () => {\n const still = current(guest);\n return still ? place(still, prepared, options, using, now()) : unanswered('revoked');\n });\n },\n policy: guestPolicy,\n dispose() {\n if (timer) clearTimeout(timer);\n offPending?.();\n offReviews();\n void seatsWatch.stop();\n void reviewsWatch.stop();\n ended.clear();\n },\n };\n}\n"],
5
- "mappings": "AAAA,SAA6C,uBAAuB;AACpE,SAAS,0BAA0B;AACnC,SAAuB,gBAAgB;AAIvC,SAAS,iBAAiB;AAE1B;AAAA,EACE;AAAA,EACA;AAAA,EAGA;AAAA,OACK;AACP,SAAS,eAAe,mBAAmB;AAC3C,SAAS,4BAA8C;AACvD;AAAA,EACE;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EAGA;AAAA,EAEA;AAAA,EACA;AAAA,OAEK;AAwCA,MAAM,eAAe;AAC5B,MAAM,cAAc;AACpB,MAAM,gBAAgB,KAAK,KAAK;AAEhC,MAAM,OAAO,CAAI,UAAgB,KAAK,MAAM,KAAK,UAAU,KAAK,CAAC;AAEjE,MAAM,aAAa,CAAC,YAA8B;AAAA,EAChD,OAAO;AAAA,EACP,cAAc;AAAA,EACd;AACF;AAEA,SAAS,MAAM,KAAiC,IAAY;AAC1D,aAAW,CAAC,IAAI,MAAM,KAAK,OAAO,QAAQ,GAAG,GAAG;AAC9C,UAAM,OAAO,OAAO,WAAW,OAAO;AACtC,QAAI,SAAS,QAAQ,KAAK,OAAO,YAAa,QAAO,IAAI,EAAE;AAAA,EAC7D;AACF;AAEA,eAAe,eACb,SACA,QACA,QACA,OACA;AACA,QAAM,eAAe,MAAM,OAAO,aAAa,OAAO,SAAS,KAAK;AACpE,MAAI,CAAC,aAAc;AACnB,QAAM,SAAS,MAAM,QAAQ;AAAA,IAC3B,OAAO,QACJ,MAAM,GAAG,IAAI,UAAU,aAAa,EAAE,GAAG,MACvC,OAAO,CAAC,SAAS;AAChB,YAAM,QAAQ,KAAK;AACnB,aAAO,OAAO,SAAS,oBAAoB,MAAM,MAAM,SAAS,OAAO;AAAA,IACzE,CAAC,EACA,IAAI,CAAC,SAAS,KAAK,EAAE;AAAA,IAC1B;AAAA,EACF;AACA,aAAW,MAAM,OAAQ,OAAM,QAAQ,gBAAgB,IAAI,OAAO,aAAa,EAAE;AACnF;AAEA,eAAe,QACb,QACA,MACA,WACA,SACA,OACmB;AACnB,QAAM,eAAe,MAAM,QAAQ,OAAO,aAAa,OAAO,SAAS,KAAK;AAC5E,MAAI,CAAC,aAAc,QAAO,WAAW,MAAM;AAC3C,QAAM,OAAmB,EAAE,MAAM,OAAO,IAAI,MAAM,OAAO,OAAO,UAAU,KAAK;AAC/E,QAAM,YAAY,MAAM,aAAa;AAAA,IACnC;AAAA,MACE,MAAM;AAAA,MACN,SAAS,aAAa,OAAO,OAAO,IAAI;AAAA,MACxC,UAAU;AAAA,MACV,OAAO,EAAE,MAAM,kBAAkB,MAAM,EAAE,GAAG,KAAK,EAAE;AAAA,MACnD;AAAA,IACF;AAAA,IACA;AAAA,EACF;AACA,QAAM,KAAK,OAAO,UAAU,EAAE;AAC9B,QAAM,QAAQ,QAAQ,OAAO,OAAO,OAAO;AACzC,UAAM,QAAQ,MAAM,GAAG,IAAI,SAAS,GAAG,MAAM,OAAO,EAAE;AACtD,QAAI,CAAC,QAAQ,KAAK,aAAa,KAAK,CAAC,UAAU,MAAM,OAAO,EAAE,EAAG;AACjE,SAAK,cAAc;AAAA,MACjB,GAAI,KAAK,eAAe,CAAC;AAAA,MACzB,EAAE,IAAI,UAAU,MAAM,OAAO,OAAO,MAAM,MAAM;AAAA,IAClD,EAAE,MAAM,CAAC,gBAAgB;AAAA,EAC3B,GAAG,KAAK;AACR,SAAO,EAAE,OAAO,aAAa,cAAc,IAAI,QAAQ,KAAK;AAC9D;AAIA,eAAe,QAAQ,QAAoB,SAAuD;AAChG,QAAM,OAAO,OAAO,SAAS,SAAS,WAAW,QAAQ,KAAK,KAAK,IAAI;AACvE,MAAI,CAAC,KAAM,QAAO,WAAW,OAAO;AACpC,MAAI,KAAK,SAAS,aAAc,QAAO,WAAW,UAAU;AAC5D,QAAM,QACJ,OAAO,QAAQ,cAAc,YAC7B,QAAQ,aACR,QAAQ,UAAU,UAAU,cACxB,QAAQ,YACR,OAAO,WAAW;AACxB,SAAO,EAAE,MAAM,MAAM,UAAU,IAAI,GAAG,WAAW,GAAG,aAAa,GAAG,OAAO,EAAE,IAAI,KAAK,GAAG;AAC3F;AAEA,eAAe,MACb,QACA,UACA,SACA,OACA,IACmB;AACnB,QAAM,OAAO,OAAO,MAAM;AAC1B,MAAI,SAAS,MAAO,QAAO,QAAQ,QAAQ,SAAS,MAAM,SAAS,WAAW,SAAS,KAAK;AAC5F,QAAM,EAAE,QAAQ,IAAI;AACpB,MAAI,CAAC,WAAW,CAAC,QAAQ,UAAW,QAAO,WAAW,aAAa;AACnE,QAAM,eAAe,MAAM,QAAQ,OAAO,aAAa,OAAO,SAAS,KAAK;AAC5E,MAAI,CAAC,aAAc,QAAO,WAAW,MAAM;AAC3C,SAAO,QAAQ,QAAQ,OAAO,OAAO,OAA0B;AAC7D,UAAM,MAAM,MAAM,GAAG,IAAI,eAAe;AACxC,UAAM,QAAQ,OAAO,OAAO,IAAI,OAAO,EAAE;AAAA,MACvC,CAAC,WAAW,OAAO,SAAS,OAAO,MAAM,OAAO,YAAY,SAAS;AAAA,IACvE;AACA,QAAI,MAAO,QAAO,EAAE,OAAO,UAAU,cAAc,MAAM,QAAQ,MAAM,IAAI,QAAQ,KAAK;AACxF,QAAI,YAAY,KAAK,OAAO,EAAE,EAAE,SAAS,WAAY,QAAO,WAAW,UAAU;AACjF,UAAM,KAAK,OAAO,OAAO,WAAW,CAAC;AACrC,UAAM,OAAO,MAAM,GAAG;AAAA,MACpB,QAAQ;AAAA,MACR,EAAE,QAAQ,GAAG;AAAA,MACb,EAAE,WAAW,EAAE,MAAM,eAAe,GAAG,gBAAgB,aAAa,IAAI,YAAY,KAAK;AAAA,IAC3F;AACA,QAAI,QAAQ,EAAE,IAAI;AAAA,MAChB;AAAA,MACA,MAAM,OAAO;AAAA,MACb,SAAS,OAAO;AAAA,MAChB,OAAO,OAAO;AAAA,MACd,MAAM,SAAS;AAAA,MACf,SAAS,SAAS;AAAA,MAClB,MAAM;AAAA,MACN,OAAO,OAAO,MAAM;AAAA,MACpB,GAAG,IAAI;AAAA,MACP,MAAM,OAAO,IAAI;AAAA,MACjB,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,WAAW;AAAA,MACX,WAAW;AAAA,MACX,cAAc;AAAA,MACd,OAAO;AAAA,MACP,cAAc,OAAO,aAAa,EAAE;AAAA,IACtC;AACA,QAAI,QAAQ;AACZ,iBAAa,GAAG;AAChB,UAAM,QAAoB;AAAA,MACxB,MAAM,OAAO;AAAA,MACb,MAAM,OAAO;AAAA,MACb,QAAQ;AAAA,MACR,MAAM,SAAS;AAAA,MACf;AAAA,IACF;AACA,UAAM,GAAG,YAAY,aAAa,IAAI,EAAE,MAAM,YAAY,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;AAC9E,WAAO,EAAE,OAAO,UAAU,cAAc,MAAM,QAAQ,IAAI,QAAQ,KAAK;AAAA,EACzE,GAAG,KAAK;AACV;AAEA,SAAS,UACP,SACA,IACA,UACA,OAC+B;AAC/B,SAAO,QAAQ,OAAO,OAAO,OAAO;AAClC,UAAM,UAAU,MAAM,GAAG,IAAI,SAAS,GAAG,MAAM,EAAE;AACjD,UAAM,OAAO,QAAQ,aAAa,OAAO,CAAC,SAAS,KAAK,aAAa,QAAQ;AAC7E,QAAI,CAAC,UAAU,CAAC,QAAQ,KAAK,WAAW,OAAO,aAAa,OAAQ,QAAO,EAAE,SAAS,MAAM;AAC5F,WAAO,cAAc;AACrB,WAAO,EAAE,SAAS,KAAK;AAAA,EACzB,GAAG,KAAK;AACV;AAEA,SAAS,YAAY;AACnB,QAAM,QAAQ,oBAAI,IAA8B;AAChD,SAAO,CAAI,IAAY,QAAsC;AAC3D,UAAM,QAAQ,MAAM,IAAI,EAAE,KAAK,QAAQ,QAAQ,GAAG,KAAK,KAAK,GAAG;AAC/D,UAAM,UAAU,KAAK,MAAM,MAAM,MAAS;AAC1C,UAAM,IAAI,IAAI,OAAO;AACrB,SAAK,QAAQ,KAAK,MAAM;AACtB,UAAI,MAAM,IAAI,EAAE,MAAM,QAAS,OAAM,OAAO,EAAE;AAAA,IAChD,CAAC;AACD,WAAO;AAAA,EACT;AACF;AAEA,SAAS,aAAa,SAAqC,OAA6B;AACtF,aAAW,MAAM,OAAO,KAAK,OAAO,EAAG,QAAO,QAAQ,EAAE;AACxD,SAAO,OAAO,SAAS,KAAK,KAAK,CAAC;AACpC;AAEA,MAAM,YACJ,CACE,WACA,YAEF,CAAC,QACE,WAAW,MAAM,SAAS,CAAC,GAAG,OAAO,CAAC,SAAS,KAAK,SAAS,MAAM,KAAK,UAAU,SAAS,EACzF,SAAS,YAAY,QAAQ,OAAO,EAAE,EAAE,OAAO,CAAC,WAAW,OAAO,UAAU,QAAQ,EAAE;AAE7F,SAAS,WACP,SACA,OACA,IACA,WACa;AACb,SAAO,OAAO,OAAO,OAAO,EACzB,OAAO,CAAC,WAAW,SAAS,QAAQ,EAAE,CAAC,EACvC,KAAK,CAAC,GAAG,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,cAAc,EAAE,EAAE,CAAC,EACpE,IAAI,CAAC,YAAY;AAAA,IAChB,IAAI,OAAO;AAAA,IACX,OAAO,OAAO;AAAA,IACd,SAAS,OAAO;AAAA,IAChB,WAAW,OAAO;AAAA,IAClB,WAAW,OAAO;AAAA,IAClB,OAAO,EAAE,GAAG,OAAO,MAAM;AAAA,IACzB,YAAY,MAAM,IAAI,OAAO,EAAE,KAAK,KAAK;AAAA,IACzC,SAAS,UAAU,OAAO,EAAE;AAAA,IAC5B,cAAc,OAAO,eAAe,CAAC,GAAG,IAAI,CAAC,EAAE,eAAe,OAAO,GAAG,KAAK,MAAM,IAAI;AAAA,EACzF,EAAE;AACN;AAEA,SAAS,YACP,SACA,OACqC;AACrC,SAAO,QAAQ,OAAO,OAAO,OAAO;AAClC,UAAM,GAAG,IAAI,eAAe;AAC5B,UAAM,SAAS,MAAM,GAAG,IAAI,SAAS,GAAG;AACxC,eAAW,UAAU,OAAO,OAAO,KAAK,GAAG;AACzC,YAAM,QAAQ,MAAM,YAAY,OAAO,eAAe,CAAC,CAAC;AACxD,UAAI,MAAO,QAAO,cAAc;AAAA,IAClC;AACA,WAAO,KAAK,KAAK;AAAA,EACnB,GAAG,KAAK;AACV;AAEA,eAAsB,aAAa,SAAyC;AAC1E,QAAM,EAAE,SAAS,OAAO,IAAI;AAC5B,QAAM,MAAM,QAAQ,OAAO,KAAK;AAChC,QAAM,UAAU,QAAQ,WAAW;AACnC,QAAM,cAAc,MAAM,QAAQ,QAAQ,QAAQ,EAAE,UAAU;AAC9D,QAAM,UAAU,MAAM,YAAY,SAAS,OAAO;AAClD,QAAM,aAAa,MAAM,QAAQ,SAAS,WAAW,OAAO;AAC5D,MAAI,CAAC,WAAY,OAAM,IAAI,MAAM,4BAA4B;AAC7D,QAAM,eAAe,MAAM,QAAQ,SAAS,iBAAiB,OAAO;AACpE,MAAI,CAAC,aAAc,OAAM,IAAI,MAAM,mCAAmC;AACtE,QAAM,UAAU,gBAAgB,KAAK,aAAa,KAAK,CAAC;AACxD,QAAM,QAAQ,oBAAI,IAAoB;AACtC,QAAM,QAAQ,oBAAI,IAA0B;AAC5C,QAAM,OAAO,oBAAI,IAA2B;AAC5C,QAAM,QAAQ,MAAM,WAAW,SAAS,OAAO,IAAI,GAAG,UAAU,QAAQ,WAAW,OAAO,CAAC;AAC3F,QAAM,QAAQ,gBAA6B,MAAM,CAAC;AAClD,MAAI;AACJ,QAAM,SAAS,UAAU;AACzB,QAAM,UAAU,CAAC,QAAoB,UACnC,OAAO,OAAO,IAAI,YAAY;AAC5B,UAAM,eAAe,SAAS,QAAQ,QAAQ,KAAK;AACnD,UAAM,QAAQ,OAAO,OAAO,OAAO;AACjC,YAAM,MAAM,MAAM,GAAG,IAAI,eAAe;AACxC,iBAAW,UAAU,YAAY,KAAK,OAAO,EAAE;AAC7C,YAAI,OAAO,UAAU,UAAU;AAC7B,oBAAU,QAAQ,aAAa,WAAW,IAAI,CAAC;AAC/C,gBAAM,KAAK,IAAI,MAAM;AAAA,QACvB;AAAA,IACJ,GAAG,KAAK;AACR,UAAM,QAAQ,WAAW,aAAa,OAAO,IAAI,KAAK;AAAA,EACxD,CAAC;AACH,QAAM,MAAM,CAAC,IAAY,QAAiB,YAA2B;AACnE,UAAM,QAAQ,KAAK,IAAI,EAAE;AACzB,QAAI,UAAU,OAAW,QAAO;AAChC,UAAM,WAAW,QAAQ,QAAQ,EAAE,GAAiB,KAAK;AACzD,SAAK,IAAI,IAAI,QAAQ;AACrB,eAAW,YAAY,CAAC,GAAG,KAAK,EAAG,UAAS,EAAE;AAC9C,WAAO;AAAA,EACT;AACA,QAAM,UAAU,MAAM;AACpB,UAAM,KAAK,IAAI;AACf,eAAW,UAAU,OAAO,OAAO,OAAO;AACxC,UAAI,CAAC,SAAS,QAAQ,EAAE,EAAG,MAAK,IAAI,OAAO,EAAE,EAAE,MAAM,MAAM,MAAS;AACtE,UAAM,QAAQ,SAAS,MAAM,CAAC;AAC9B,QAAI,MAAO,cAAa,KAAK;AAC7B,YAAQ;AACR,UAAM,OAAO,KAAK;AAAA,MAChB,GAAG,OAAO,OAAO,OAAO,EACrB,OAAO,CAAC,WAAW,SAAS,QAAQ,EAAE,KAAK,OAAO,cAAc,IAAI,EACpE,IAAI,CAAC,WAAW,OAAO,SAAmB;AAAA,IAC/C;AACA,QAAI,OAAO,SAAS,IAAI;AACtB,cAAQ,WAAW,SAAS,KAAK,IAAI,KAAK,IAAI,GAAG,OAAO,EAAE,GAAG,aAAa,CAAC;AAAA,EAC/E;AACA,eAAa,SAAS,WAAW,MAAM,KAAK;AAC5C,UAAQ;AACR,aAAW,MAAM,OAAO,SAAS;AAC/B,QAAI,KAAK,SAAS,QAAS;AAC3B,iBAAa,SAAS,KAAK,MAAM,KAAK;AACtC,YAAQ;AAAA,EACV,CAAC;AACD,QAAM,QAAQ,CAAC,WACb,QAAQ,OAAO,OAAO,OAAO;AAC3B,UAAM,MAAM,MAAM,GAAG,IAAI,SAAS;AAClC,UAAM,UAAU,OAAO,IAAI,KAAK;AAChC,WAAO,UAAU,KAAK,OAAO,IAAI;AAAA,EACnC,GAAG,OAAO;AACZ,QAAM,UAAU,MAAM,MAAM,QAAQ,SAAS,MAAM,CAAC;AACpD,QAAM,aAAa,QAAQ,WAAW,MAAM,UAAU,OAAO;AAC7D,QAAM,aAAa,QAAQ,UAAU,OAAO;AAC5C,eAAa,MAAM,OAAO,SAAS;AACjC,QAAI,KAAK,SAAS,QAAS,SAAQ,QAAQ,SAAS,KAAK,KAAK,KAAK,CAAC;AAAA,EACtE,CAAC;AACD,UAAQ,SAAS,KAAK;AAAA,IACpB,WAAW,QAAQ;AAAA,IACnB;AAAA,IACA,MAAM;AAAA,IACN,eAAe,MAAM,YAAY,EAAE,OAAO;AAAA,EAC5C,CAAC;AACD,QAAM,UAAU,CAAC,UAA0B;AACzC,UAAM,SAAS,QAAQ,MAAM,EAAE;AAC/B,WAAO,UAAU,SAAS,QAAQ,IAAI,CAAC,KAAK,OAAO,UAAU,MAAM,QAAQ,SAAS;AAAA,EACtF;AACA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,MAAM,KAAK,OAAO,OAAO;AACvB,YAAM,KAAK,IAAI;AACf,YAAM,UAAU,WAAW,OAAO,IAAI,YAAY,CAAC;AACnD,UAAI,QAAS,QAAO,EAAE,MAAM,MAAM,OAAO,QAAQ;AACjD,UAAI,CAAC,OAAO,MAAM,EAAE,MAAM,MAAM,OAAO;AACrC,eAAO,EAAE,MAAM,MAAM,OAAO,oBAAoB,MAAM,OAAO,IAAI;AACnE,YAAM,SAAqB;AAAA,QACzB,IAAI,MAAM;AAAA,QACV,OAAO,WAAW,MAAM,KAAK;AAAA,QAC7B,SAAS,MAAM;AAAA,QACf,WAAW,MAAM;AAAA,QACjB,OAAO,EAAE,UAAU,MAAM,MAAM,UAAU,OAAO,MAAM,MAAM,MAAM;AAAA,QAClE,WAAW;AAAA,QACX,OAAO;AAAA,QACP,SAAS;AAAA,MACX;AACA,YAAM,OAAO,MAAM,QAAQ,OAAO,OAAO,OAAO;AAC9C,cAAM,MAAM,MAAM,GAAG,IAAI,SAAS;AAClC,YAAI,IAAI,MAAM,OAAO,EAAE,EAAG,QAAO;AACjC,cAAM,IAAI,OAAO,EAAE;AACnB,YAAI,MAAM,OAAO,EAAE,IAAI,KAAK,MAAM;AAClC,eAAO,KAAK,IAAI,KAAK;AAAA,MACvB,GAAG,KAAK;AACR,UAAI,CAAC,KAAM,QAAO,EAAE,MAAM,MAAM,OAAO,kCAAkC;AACzE,iBAAW,MAAM,OAAO,KAAK,OAAO,EAAG,QAAO,QAAQ,EAAE;AACxD,aAAO,OAAO,SAAS,IAAI;AAC3B,cAAQ;AACR,aAAO,EAAE,MAAM,MAAM,EAAE,KAAK,CAAC,SAAS,KAAK,OAAO,OAAO,EAAE,GAAgB,OAAO,KAAK;AAAA,IACzF;AAAA,IACA,MAAM,OAAO,IAAI,OAAO;AACtB,YAAM,KAAK,IAAI;AACf,YAAM,UAAU,MAAM,MAAM,CAAC,QAAQ;AACnC,cAAM,SAAS,IAAI,EAAE;AACrB,YAAI,CAAC,UAAU,OAAO,YAAY,KAAM,QAAO;AAC/C,eAAO,OAAO,OAAO,QAAQ,EAAE,SAAS,IAAI,OAAO,OAAO,QAAQ,GAAG,aAAa,CAAC,EAAE,CAAC;AAAA,MACxF,CAAC;AACD,UAAI,CAAC,QAAS,QAAO,EAAE,SAAS,MAAM;AACtC,cAAQ,EAAE,IAAI;AACd,YAAM,SAAS,IAAI,IAAI,KAAK;AAC5B,cAAQ;AACR,YAAM;AACN,aAAO,EAAE,SAAS,KAAK;AAAA,IACzB;AAAA,IACA,cAAc,CAAC,IAAI,UAAU,UAAU,UAAU,SAAS,IAAI,UAAU,KAAK;AAAA,IAC7E,MAAM,IAAI,OAAO;AACf,YAAM,SAAS,QAAQ,EAAE;AACzB,UAAI,CAAC,UAAU,CAAC,SAAS,QAAQ,IAAI,CAAC,KAAK,OAAO,UAAU,WAAW,KAAK,EAAG,QAAO;AACtF,aAAO,EAAE,IAAI,OAAO,IAAI,MAAM,OAAO,OAAO,OAAO,OAAO,MAAM;AAAA,IAClE;AAAA,IACA,QAAQ,CAAC,OAAO,QAAQ,EAAE;AAAA,IAC1B;AAAA,IACA,OAAO,IAAI;AACT,YAAM,IAAI,KAAK,MAAM,IAAI,EAAE,KAAK,KAAK,CAAC;AACtC,YAAM,QAAQ,SAAS,MAAM,CAAC;AAC9B,UAAI,OAAO;AACX,aAAO,MAAM;AACX,YAAI,KAAM;AACV,eAAO;AACP,cAAM,IAAI,KAAK,MAAM,IAAI,EAAE,KAAK,KAAK,CAAC;AACtC,cAAM,QAAQ,SAAS,MAAM,CAAC;AAAA,MAChC;AAAA,IACF;AAAA,IACA,MAAM,UAAU;AACd,YAAM,IAAI,QAAQ;AAClB,aAAO,MAAM,MAAM,OAAO,QAAQ;AAAA,IACpC;AAAA,IACA,MAAM,QAAQ,OAAO,SAAS,OAAO;AACnC,YAAM,SAAS,QAAQ,KAAK;AAC5B,UAAI,CAAC,OAAQ,QAAO,WAAW,SAAS;AACxC,YAAM,WAAW,MAAM,QAAQ,QAAQ,OAAO;AAC9C,UAAI,WAAW,SAAU,QAAO;AAChC,aAAO,OAAO,OAAO,IAAI,YAAY;AACnC,cAAM,QAAQ,QAAQ,KAAK;AAC3B,eAAO,QAAQ,MAAM,OAAO,UAAU,SAAS,OAAO,IAAI,CAAC,IAAI,WAAW,SAAS;AAAA,MACrF,CAAC;AAAA,IACH;AAAA,IACA,QAAQ;AAAA,IACR,UAAU;AACR,UAAI,MAAO,cAAa,KAAK;AAC7B,mBAAa;AACb,iBAAW;AACX,WAAK,WAAW,KAAK;AACrB,WAAK,aAAa,KAAK;AACvB,YAAM,MAAM;AAAA,IACd;AAAA,EACF;AACF;",
4
+ "sourcesContent": ["import { type Context, type ReplicatedState, replicatedState } from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport { type Harness, InboxDoc } from '@earendil-works/pi-durable';\nimport type { Agents } from '../agents.ts';\nimport type { Approvals } from '../approvals/index.ts';\nimport type { ApprovalPolicies } from '../approvals/policy.ts';\nimport { scrubText } from '../secrets/scrub.ts';\nimport type { GuestPrincipal } from '../serving.ts';\nimport {\n ASKED_KIND,\n GUEST_INPUT_KIND,\n type GuestAsked,\n type GuestInput,\n guestContent,\n} from './attribution.ts';\nimport { GUEST_REQUEST, sealedRules } from './guard.ts';\nimport { DEFAULT_GUEST_POLICY, type GuestPolicy } from './policy.ts';\nimport {\n endReview,\n type GuestReviews,\n GuestReviewsDoc,\n KEPT_SUBMISSIONS,\n liveReviews,\n MAX_QUEUED,\n pruneReviews,\n type ReviewsState,\n told,\n} from './review.ts';\nimport {\n checkDraft,\n cleanLabel,\n type GuestDraft,\n type GuestSeat,\n GuestsDoc,\n type GuestsState,\n liveSeat,\n MAX_SEAT_MS,\n type SeatRecord,\n} from './seats.ts';\n\nexport type GuestOpened = { seat: GuestSeat; error: null } | { seat: null; error: string };\n\nexport type Proposed =\n | { state: 'submitted'; submissionId: string; reason: null }\n | { state: 'queued'; submissionId: null; review: string; reason: null }\n | { state: 'unanswered'; submissionId: null; reason: string };\n\nexport interface ProposeRequest {\n text: string;\n requestId: string | null;\n}\n\nexport interface Guests {\n readonly seats: ReplicatedState<GuestSeat[]>;\n readonly reviews: ReplicatedState<ReviewsState | null>;\n open(draft: GuestDraft, context: Context): Promise<GuestOpened>;\n revoke(id: string, context: Context): Promise<{ revoked: boolean }>;\n forgetAlways(id: string, approval: string, context: Context): Promise<{ removed: boolean }>;\n admit(id: string, label: string): GuestPrincipal | null;\n record(id: string): SeatRecord | undefined;\n current(guest: GuestPrincipal): SeatRecord | undefined;\n joined(id: string): () => void;\n onEnd(listener: (id: string) => void): () => void;\n propose(guest: GuestPrincipal, request: ProposeRequest, context: Context): Promise<Proposed>;\n policy(): GuestPolicy;\n dispose(): void;\n}\n\nexport interface GuestsOptions {\n harness: Pick<Harness, 'commit' | 'abortSubmission' | 'watchDoc'>;\n agents: Pick<Agents, 'state' | 'conversation'>;\n approvals?: Pick<Approvals, 'state' | 'request' | 'withdrawSeat' | 'expire' | 'withdraw'>;\n policy?: Pick<ApprovalPolicies, 'current'>;\n reviews?: Pick<GuestReviews, 'task' | 'bind'>;\n now?: () => number;\n context?: Context;\n}\n\nexport const MAX_PROPOSAL = 32_000;\nconst MAX_REQUEST = 128;\nconst LONGEST_TIMER = 2 ** 31 - 1;\n\nconst copy = <T>(value: T): T => JSON.parse(JSON.stringify(value)) as T;\n\nconst unanswered = (reason: string): Proposed => ({\n state: 'unanswered',\n submissionId: null,\n reason,\n});\n\nfunction prune(all: Record<string, SeatRecord>, at: number) {\n for (const [id, record] of Object.entries(all)) {\n const over = record.revoked ?? record.expiresAt;\n if (over !== null && at - over > MAX_SEAT_MS) delete all[id];\n }\n}\n\nasync function withdrawQueued(\n harness: GuestsOptions['harness'],\n agents: GuestsOptions['agents'],\n record: SeatRecord,\n using: Context\n) {\n const conversation = await agents.conversation(record.agentId, using);\n if (!conversation) return;\n const queued = await harness.commit(\n async (tx) =>\n (await tx.doc(InboxDoc, conversation.id)).items\n .filter((item) => {\n const entry = item.entry as { kind?: string; data?: { seat?: unknown } } | undefined;\n return entry?.kind === GUEST_INPUT_KIND && entry.data?.seat === record.id;\n })\n .map((item) => item.id),\n using\n );\n for (const id of queued) await harness.abortSubmission(id, using, conversation.id);\n}\n\nasync function deliver(\n record: SeatRecord,\n text: string,\n requestId: string,\n options: GuestsOptions,\n using: Context\n): Promise<Proposed> {\n const conversation = await options.agents.conversation(record.agentId, using);\n if (!conversation) return unanswered('gone');\n const data: GuestInput = { seat: record.id, name: record.label, approval: null };\n const submitted = await conversation.submit(\n {\n type: 'input',\n content: guestContent(record.label, text),\n whenBusy: 'followUp',\n entry: { kind: GUEST_INPUT_KIND, data: { ...data } },\n requestId,\n },\n using\n );\n const id = String(submitted.id);\n await options.harness.commit(async (tx) => {\n const kept = (await tx.doc(GuestsDoc)).seats[record.id];\n if (!kept || kept.submissions?.some((entry) => entry.id === id)) return;\n kept.submissions = [\n ...(kept.submissions ?? []),\n { id, approval: null, tools: record.gates.tools },\n ].slice(-KEPT_SUBMISSIONS);\n }, using);\n return { state: 'submitted', submissionId: id, reason: null };\n}\n\ntype Prepared = { text: string; requestId: string };\n\nasync function prepare(record: SeatRecord, request: ProposeRequest): Promise<Prepared | Proposed> {\n const text = typeof request?.text === 'string' ? request.text.trim() : '';\n if (!text) return unanswered('empty');\n if (text.length > MAX_PROPOSAL) return unanswered('too-long');\n const asked =\n typeof request.requestId === 'string' &&\n request.requestId &&\n request.requestId.length <= MAX_REQUEST\n ? request.requestId\n : crypto.randomUUID();\n return { text: await scrubText(text), requestId: `${GUEST_REQUEST}${record.id}:${asked}` };\n}\n\nasync function place(\n record: SeatRecord,\n prepared: Prepared,\n options: GuestsOptions,\n using: Context,\n at: number\n): Promise<Proposed> {\n const gate = record.gates.messages;\n if (gate === 'off') return deliver(record, prepared.text, prepared.requestId, options, using);\n const { reviews } = options;\n if (!reviews || !options.approvals) return unanswered('unavailable');\n const conversation = await options.agents.conversation(record.agentId, using);\n if (!conversation) return unanswered('gone');\n return options.harness.commit(async (tx): Promise<Proposed> => {\n const doc = await tx.doc(GuestReviewsDoc);\n const again = Object.values(doc.reviews).find(\n (review) => review.seat === record.id && review.request === prepared.requestId\n );\n if (again) return { state: 'queued', submissionId: null, review: again.id, reason: null };\n if (liveReviews(doc, record.id).length > MAX_QUEUED) return unanswered('overflow');\n const id = `apr-${crypto.randomUUID()}`;\n const task = await tx.createTask(\n reviews.task,\n { review: id },\n { ownership: { kind: 'conversation' }, conversationId: conversation.id, background: true }\n );\n doc.reviews[id] = {\n id,\n seat: record.id,\n agentId: record.agentId,\n label: record.label,\n text: prepared.text,\n request: prepared.requestId,\n tier: gate,\n tools: record.gates.tools,\n n: doc.next,\n task: Number(task),\n state: 'queued',\n reason: null,\n createdAt: at,\n decidedAt: null,\n submissionId: null,\n ended: false,\n conversation: Number(conversation.id),\n };\n doc.next += 1;\n pruneReviews(doc);\n const asked: GuestAsked = {\n seat: record.id,\n name: record.label,\n review: id,\n text: prepared.text,\n at,\n };\n await tx.appendEntry(conversation.id, { kind: ASKED_KIND, data: { ...asked } });\n return { state: 'queued', submissionId: null, review: id, reason: null };\n }, using);\n}\n\nfunction forgotten(\n harness: GuestsOptions['harness'],\n id: string,\n approval: string,\n using: Context\n): Promise<{ removed: boolean }> {\n return harness.commit(async (tx) => {\n const record = (await tx.doc(GuestsDoc)).seats[id];\n if (!record) return { removed: false };\n const tools = record.alwaysTools ?? [];\n const captures = record.alwaysCaptures ?? [];\n const keptTools = tools.filter((rule) => rule.approval !== approval);\n const keptCaptures = captures.filter((rule) => rule.approval !== approval);\n if (keptTools.length + keptCaptures.length === tools.length + captures.length)\n return { removed: false };\n record.alwaysTools = keptTools;\n record.alwaysCaptures = keptCaptures;\n return { removed: true };\n }, using);\n}\n\nfunction keyedLine() {\n const locks = new Map<string, Promise<unknown>>();\n return <T>(id: string, run: () => Promise<T>): Promise<T> => {\n const next = (locks.get(id) ?? Promise.resolve()).then(run, run);\n const settled = next.catch(() => undefined);\n locks.set(id, settled);\n void settled.then(() => {\n if (locks.get(id) === settled) locks.delete(id);\n });\n return next;\n };\n}\n\nfunction replaceSeats(records: Record<string, SeatRecord>, seats: GuestsState['seats']) {\n for (const id of Object.keys(records)) delete records[id];\n Object.assign(records, copy(seats));\n}\n\nconst pendingIn =\n (\n approvals: GuestsOptions['approvals'],\n reviews: { readonly value: ReviewsState | null | undefined }\n ) =>\n (id: string): number =>\n (approvals?.state.value ?? []).filter((item) => item.seat === id && item.state === 'pending')\n .length + liveReviews(reviews.value, id).filter((review) => review.state === 'queued').length;\n\nfunction shownSeats(\n records: Record<string, SeatRecord>,\n links: ReadonlyMap<string, number>,\n at: number,\n pendingOf: (id: string) => number\n): GuestSeat[] {\n return Object.values(records)\n .filter((record) => liveSeat(record, at))\n .sort((a, b) => a.createdAt - b.createdAt || a.id.localeCompare(b.id))\n .map((record) => ({\n id: record.id,\n label: record.label,\n agentId: record.agentId,\n createdAt: record.createdAt,\n expiresAt: record.expiresAt,\n gates: { ...record.gates },\n connected: (links.get(record.id) ?? 0) > 0,\n pending: pendingOf(record.id),\n alwaysTools: (record.alwaysTools ?? []).map(({ argumentsHash: _hash, ...rule }) => rule),\n alwaysCaptures: (record.alwaysCaptures ?? []).map((rule) => ({ ...rule })),\n }));\n}\n\nfunction openedSeats(\n harness: GuestsOptions['harness'],\n using: Context\n): Promise<Record<string, SeatRecord>> {\n return harness.commit(async (tx) => {\n await tx.doc(GuestReviewsDoc);\n const seats = (await tx.doc(GuestsDoc)).seats;\n for (const record of Object.values(seats)) {\n const rules = await sealedRules(record.alwaysTools ?? []);\n if (rules) record.alwaysTools = rules;\n }\n return copy(seats);\n }, using);\n}\n\nconst revokedAt = (record: SeatRecord, at: number) =>\n Object.assign(record, {\n revoked: at,\n epoch: record.epoch + 1,\n alwaysTools: [],\n alwaysCaptures: [],\n });\n\nexport async function createGuests(options: GuestsOptions): Promise<Guests> {\n const { harness, agents } = options;\n const now = options.now ?? Date.now;\n const context = options.context ?? BACKGROUND_CONTEXT;\n const guestPolicy = () => options.policy?.current().guests ?? DEFAULT_GUEST_POLICY;\n const records = await openedSeats(harness, context);\n const seatsWatch = await harness.watchDoc(GuestsDoc, context);\n if (!seatsWatch) throw new Error('guests document is missing');\n const reviewsWatch = await harness.watchDoc(GuestReviewsDoc, context);\n if (!reviewsWatch) throw new Error('guest reviews document is missing');\n const reviews = replicatedState(copy(reviewsWatch.value));\n const links = new Map<string, number>();\n const ended = new Set<(id: string) => void>();\n const gone = new Map<string, Promise<void>>();\n const shown = () => shownSeats(records, links, now(), pendingIn(options.approvals, reviews));\n const seats = replicatedState<GuestSeat[]>(shown());\n let timer: ReturnType<typeof setTimeout> | undefined;\n const locked = keyedLine();\n const cleanup = (record: SeatRecord, using: Context) =>\n locked(record.id, async () => {\n await withdrawQueued(harness, agents, record, using);\n await harness.commit(async (tx) => {\n const doc = await tx.doc(GuestReviewsDoc);\n for (const review of liveReviews(doc, record.id))\n if (review.state === 'queued') {\n endReview(review, 'withdrawn', 'revoked', now());\n await told(tx, review);\n }\n }, using);\n await options.approvals?.withdrawSeat(record.id, using);\n });\n const end = (id: string, using: Context = context): Promise<void> => {\n const going = gone.get(id);\n if (going !== undefined) return going;\n const cleaning = cleanup(records[id] as SeatRecord, using);\n gone.set(id, cleaning);\n for (const listener of [...ended]) listener(id);\n return cleaning;\n };\n const publish = () => {\n const at = now();\n for (const record of Object.values(records))\n if (!liveSeat(record, at)) void end(record.id).catch(() => undefined);\n seats.replace(context, shown());\n if (timer) clearTimeout(timer);\n timer = undefined;\n const next = Math.min(\n ...Object.values(records)\n .filter((record) => liveSeat(record, at) && record.expiresAt !== null)\n .map((record) => record.expiresAt as number)\n );\n if (Number.isFinite(next))\n timer = setTimeout(publish, Math.min(Math.max(0, next - at), LONGEST_TIMER));\n };\n replaceSeats(records, seatsWatch.value.seats);\n publish();\n seatsWatch.start(async (call) => {\n if (call.kind !== 'value') return;\n replaceSeats(records, call.value.seats);\n publish();\n });\n const write = (change: (seats: Record<string, SeatRecord>) => SeatRecord | undefined) =>\n harness.commit(async (tx) => {\n const doc = await tx.doc(GuestsDoc);\n const changed = change(doc.seats);\n return changed ? copy(changed) : undefined;\n }, context);\n const recount = () => seats.replace(context, shown());\n const offPending = options.approvals?.state.subscribe(recount);\n const offReviews = reviews.subscribe(recount);\n reviewsWatch.start(async (call) => {\n if (call.kind === 'value') reviews.replace(context, copy(call.value));\n });\n options.reviews?.bind({\n approvals: options.approvals as NonNullable<GuestsOptions['approvals']>,\n agents,\n line: locked,\n alwaysAllowed: () => guestPolicy().always.messages,\n });\n const current = (guest: GuestPrincipal) => {\n const record = records[guest.id];\n return record && liveSeat(record, now()) && record.epoch === guest.epoch ? record : undefined;\n };\n return {\n seats,\n reviews,\n async open(draft, using) {\n const at = now();\n const problem = checkDraft(draft, at, guestPolicy());\n if (problem) return { seat: null, error: problem };\n if (!agents.state().cones[draft.agentId])\n return { seat: null, error: `There is no cone ${draft.agentId}.` };\n const record: SeatRecord = {\n id: draft.id,\n label: cleanLabel(draft.label),\n agentId: draft.agentId,\n expiresAt: draft.expiresAt,\n gates: { messages: draft.gates.messages, tools: draft.gates.tools },\n createdAt: at,\n epoch: 1,\n revoked: null,\n };\n const kept = await harness.commit(async (tx) => {\n const doc = await tx.doc(GuestsDoc);\n if (doc.seats[record.id]) return null;\n prune(doc.seats, at);\n doc.seats[record.id] = copy(record);\n return copy(doc.seats);\n }, using);\n if (!kept) return { seat: null, error: 'That guest seat already exists.' };\n for (const id of Object.keys(records)) delete records[id];\n Object.assign(records, kept);\n publish();\n return { seat: shown().find((seat) => seat.id === record.id) as GuestSeat, error: null };\n },\n async revoke(id, using) {\n const at = now();\n const changed = await write((all) => {\n const record = all[id];\n if (!record || record.revoked !== null) return undefined;\n return revokedAt(record, at);\n });\n if (!changed) return { revoked: false };\n records[id] = changed;\n const ending = end(id, using);\n publish();\n await ending;\n return { revoked: true };\n },\n forgetAlways: (id, approval, using) => forgotten(harness, id, approval, using),\n admit(id, label) {\n const record = records[id];\n if (!record || !liveSeat(record, now()) || record.label !== cleanLabel(label)) return null;\n return { id: record.id, name: record.label, epoch: record.epoch };\n },\n record: (id) => records[id],\n current,\n joined(id) {\n links.set(id, (links.get(id) ?? 0) + 1);\n seats.replace(context, shown());\n let left = false;\n return () => {\n if (left) return;\n left = true;\n links.set(id, (links.get(id) ?? 1) - 1);\n seats.replace(context, shown());\n };\n },\n onEnd(listener) {\n ended.add(listener);\n return () => ended.delete(listener);\n },\n async propose(guest, request, using) {\n const record = current(guest);\n if (!record) return unanswered('revoked');\n const prepared = await prepare(record, request);\n if ('state' in prepared) return prepared;\n return locked(record.id, async () => {\n const still = current(guest);\n return still ? place(still, prepared, options, using, now()) : unanswered('revoked');\n });\n },\n policy: guestPolicy,\n dispose() {\n if (timer) clearTimeout(timer);\n offPending?.();\n offReviews();\n void seatsWatch.stop();\n void reviewsWatch.stop();\n ended.clear();\n },\n };\n}\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/guests/seats.ts"],
4
- "sourcesContent": ["import { defineDoc } from '@earendil-works/pi-durable';\nimport type { ApprovalTier, DecidedBy } from '../approvals/record.ts';\nimport { boundedDeltas } from '../checkpoints.ts';\nimport {\n DAY_MS,\n DEFAULT_GUEST_POLICY,\n type GuestPolicy,\n gateKind,\n gateRefusal,\n MAX_SEAT_DAYS,\n} from './policy.ts';\n\nexport type GuestGate = ApprovalTier | 'off';\n\nexport type GuestGates = {\n messages: GuestGate;\n tools: GuestGate;\n};\n\nexport type GuestDraft = {\n id: string;\n label: string;\n agentId: string;\n expiresAt: number | null;\n gates: GuestGates;\n};\n\nexport type SeatSubmission = { id: string; approval: string | null; tools: GuestGate };\n\nexport type AlwaysTool = {\n approval: string;\n tool: string;\n argumentsHash: string;\n arguments: string;\n by: DecidedBy | null;\n at: number;\n};\n\nexport type ShownAlwaysTool = Omit<AlwaysTool, 'argumentsHash'>;\n\nexport type SeatRecord = GuestDraft & {\n createdAt: number;\n epoch: number;\n revoked: number | null;\n delivered?: string[];\n submissions?: SeatSubmission[];\n always?: { by: DecidedBy | null; approval: string; at: number };\n alwaysTools?: AlwaysTool[];\n};\n\nexport interface GuestSeat {\n id: string;\n label: string;\n agentId: string;\n createdAt: number;\n expiresAt: number | null;\n gates: GuestGates;\n connected: boolean;\n pending: number;\n alwaysTools: ShownAlwaysTool[];\n}\n\nexport type GuestsState = { seats: Record<string, SeatRecord> };\n\nexport const GuestsDoc = defineDoc<GuestsState>({\n kind: 'slicc.guests',\n checkpointWhen: boundedDeltas,\n version: 1,\n scope: 'session',\n initial: () => ({ seats: {} }),\n});\n\nexport const MAX_SEAT_MS = MAX_SEAT_DAYS * DAY_MS;\nexport const MAX_LABEL = 64;\nconst MAX_ID = 256;\n\nexport function cleanLabel(raw: unknown): string {\n return String(raw ?? '')\n .replace(/[\\p{Cc}\\p{Cf}]/gu, ' ')\n .replace(/\\s+/g, ' ')\n .trim()\n .slice(0, MAX_LABEL);\n}\n\nexport function isGate(value: unknown): value is GuestGate {\n if (typeof value !== 'string') return false;\n if (value === 'user' || value === 'agent' || value === 'cone' || value === 'off') return true;\n return /^scoop:\\S+$/.test(value);\n}\n\nexport function checkDraft(\n draft: GuestDraft,\n now: number,\n policy: GuestPolicy = DEFAULT_GUEST_POLICY\n): string | null {\n if (typeof draft?.id !== 'string' || !draft.id || draft.id.length > MAX_ID)\n return 'A guest seat needs an id from the tray hub.';\n if (!cleanLabel(draft.label)) return 'A guest seat needs a label.';\n if (!isGate(draft.gates?.messages) || !isGate(draft.gates?.tools))\n return 'A guest seat needs a known gate for messages and for tools.';\n if (!policy.allowedMessageGates.includes(gateKind(draft.gates.messages)))\n return gateRefusal(\"a guest's messages\", policy.allowedMessageGates);\n if (!policy.allowedToolGates.includes(gateKind(draft.gates.tools)))\n return gateRefusal(\"a guest's tool calls\", policy.allowedToolGates);\n const { expiresAt } = draft;\n if (expiresAt !== null && (typeof expiresAt !== 'number' || !Number.isFinite(expiresAt)))\n return 'A guest seat expires at a time, or never.';\n if (expiresAt !== null && expiresAt <= now) return 'That expiry has already passed.';\n const days = policy.maxSeatDays;\n if (expiresAt !== null && expiresAt - now > days * DAY_MS)\n return `A guest seat lasts at most ${days} ${days === 1 ? 'day' : 'days'}.`;\n return null;\n}\n\nexport function liveSeat(seat: SeatRecord | undefined, now: number): boolean {\n return Boolean(\n seat && seat.revoked === null && (seat.expiresAt === null || seat.expiresAt > now)\n );\n}\n"],
5
- "mappings": "AAAA,SAAS,iBAAiB;AAE1B,SAAS,qBAAqB;AAC9B;AAAA,EACE;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAsDA,MAAM,YAAY,UAAuB;AAAA,EAC9C,MAAM;AAAA,EACN,gBAAgB;AAAA,EAChB,SAAS;AAAA,EACT,OAAO;AAAA,EACP,SAAS,OAAO,EAAE,OAAO,CAAC,EAAE;AAC9B,CAAC;AAEM,MAAM,cAAc,gBAAgB;AACpC,MAAM,YAAY;AACzB,MAAM,SAAS;AAER,SAAS,WAAW,KAAsB;AAC/C,SAAO,OAAO,OAAO,EAAE,EACpB,QAAQ,oBAAoB,GAAG,EAC/B,QAAQ,QAAQ,GAAG,EACnB,KAAK,EACL,MAAM,GAAG,SAAS;AACvB;AAEO,SAAS,OAAO,OAAoC;AACzD,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,MAAI,UAAU,UAAU,UAAU,WAAW,UAAU,UAAU,UAAU,MAAO,QAAO;AACzF,SAAO,cAAc,KAAK,KAAK;AACjC;AAEO,SAAS,WACd,OACA,KACA,SAAsB,sBACP;AACf,MAAI,OAAO,OAAO,OAAO,YAAY,CAAC,MAAM,MAAM,MAAM,GAAG,SAAS;AAClE,WAAO;AACT,MAAI,CAAC,WAAW,MAAM,KAAK,EAAG,QAAO;AACrC,MAAI,CAAC,OAAO,MAAM,OAAO,QAAQ,KAAK,CAAC,OAAO,MAAM,OAAO,KAAK;AAC9D,WAAO;AACT,MAAI,CAAC,OAAO,oBAAoB,SAAS,SAAS,MAAM,MAAM,QAAQ,CAAC;AACrE,WAAO,YAAY,sBAAsB,OAAO,mBAAmB;AACrE,MAAI,CAAC,OAAO,iBAAiB,SAAS,SAAS,MAAM,MAAM,KAAK,CAAC;AAC/D,WAAO,YAAY,wBAAwB,OAAO,gBAAgB;AACpE,QAAM,EAAE,UAAU,IAAI;AACtB,MAAI,cAAc,SAAS,OAAO,cAAc,YAAY,CAAC,OAAO,SAAS,SAAS;AACpF,WAAO;AACT,MAAI,cAAc,QAAQ,aAAa,IAAK,QAAO;AACnD,QAAM,OAAO,OAAO;AACpB,MAAI,cAAc,QAAQ,YAAY,MAAM,OAAO;AACjD,WAAO,8BAA8B,IAAI,IAAI,SAAS,IAAI,QAAQ,MAAM;AAC1E,SAAO;AACT;AAEO,SAAS,SAAS,MAA8B,KAAsB;AAC3E,SAAO;AAAA,IACL,QAAQ,KAAK,YAAY,SAAS,KAAK,cAAc,QAAQ,KAAK,YAAY;AAAA,EAChF;AACF;",
4
+ "sourcesContent": ["import { defineDoc } from '@earendil-works/pi-durable';\nimport type { ApprovalTier, CaptureDetail, DecidedBy } from '../approvals/record.ts';\nimport { boundedDeltas } from '../checkpoints.ts';\nimport {\n DAY_MS,\n DEFAULT_GUEST_POLICY,\n type GuestPolicy,\n gateKind,\n gateRefusal,\n MAX_SEAT_DAYS,\n} from './policy.ts';\n\nexport type GuestGate = ApprovalTier | 'off';\n\nexport type GuestGates = {\n messages: GuestGate;\n tools: GuestGate;\n};\n\nexport type GuestDraft = {\n id: string;\n label: string;\n agentId: string;\n expiresAt: number | null;\n gates: GuestGates;\n};\n\nexport type SeatSubmission = { id: string; approval: string | null; tools: GuestGate };\n\nexport type AlwaysTool = {\n approval: string;\n tool: string;\n argumentsHash: string;\n arguments: string;\n by: DecidedBy | null;\n at: number;\n};\n\nexport type ShownAlwaysTool = Omit<AlwaysTool, 'argumentsHash'>;\n\nexport type AlwaysCapture = Pick<CaptureDetail, 'what' | 'mode'> & {\n approval: string;\n by: DecidedBy | null;\n at: number;\n};\n\nexport type SeatRecord = GuestDraft & {\n createdAt: number;\n epoch: number;\n revoked: number | null;\n delivered?: string[];\n submissions?: SeatSubmission[];\n always?: { by: DecidedBy | null; approval: string; at: number };\n alwaysTools?: AlwaysTool[];\n alwaysCaptures?: AlwaysCapture[];\n};\n\nexport interface GuestSeat {\n id: string;\n label: string;\n agentId: string;\n createdAt: number;\n expiresAt: number | null;\n gates: GuestGates;\n connected: boolean;\n pending: number;\n alwaysTools: ShownAlwaysTool[];\n alwaysCaptures: AlwaysCapture[];\n}\n\nexport type GuestsState = { seats: Record<string, SeatRecord> };\n\nexport const GuestsDoc = defineDoc<GuestsState>({\n kind: 'slicc.guests',\n checkpointWhen: boundedDeltas,\n version: 1,\n scope: 'session',\n initial: () => ({ seats: {} }),\n});\n\nexport const MAX_SEAT_MS = MAX_SEAT_DAYS * DAY_MS;\nexport const MAX_LABEL = 64;\nconst MAX_ID = 256;\n\nexport function cleanLabel(raw: unknown): string {\n return String(raw ?? '')\n .replace(/[\\p{Cc}\\p{Cf}]/gu, ' ')\n .replace(/\\s+/g, ' ')\n .trim()\n .slice(0, MAX_LABEL);\n}\n\nexport function isGate(value: unknown): value is GuestGate {\n if (typeof value !== 'string') return false;\n if (value === 'user' || value === 'agent' || value === 'cone' || value === 'off') return true;\n return /^scoop:\\S+$/.test(value);\n}\n\nexport function checkDraft(\n draft: GuestDraft,\n now: number,\n policy: GuestPolicy = DEFAULT_GUEST_POLICY\n): string | null {\n if (typeof draft?.id !== 'string' || !draft.id || draft.id.length > MAX_ID)\n return 'A guest seat needs an id from the tray hub.';\n if (!cleanLabel(draft.label)) return 'A guest seat needs a label.';\n if (!isGate(draft.gates?.messages) || !isGate(draft.gates?.tools))\n return 'A guest seat needs a known gate for messages and for tools.';\n if (!policy.allowedMessageGates.includes(gateKind(draft.gates.messages)))\n return gateRefusal(\"a guest's messages\", policy.allowedMessageGates);\n if (!policy.allowedToolGates.includes(gateKind(draft.gates.tools)))\n return gateRefusal(\"a guest's tool calls\", policy.allowedToolGates);\n const { expiresAt } = draft;\n if (expiresAt !== null && (typeof expiresAt !== 'number' || !Number.isFinite(expiresAt)))\n return 'A guest seat expires at a time, or never.';\n if (expiresAt !== null && expiresAt <= now) return 'That expiry has already passed.';\n const days = policy.maxSeatDays;\n if (expiresAt !== null && expiresAt - now > days * DAY_MS)\n return `A guest seat lasts at most ${days} ${days === 1 ? 'day' : 'days'}.`;\n return null;\n}\n\nexport function liveSeat(seat: SeatRecord | undefined, now: number): boolean {\n return Boolean(\n seat && seat.revoked === null && (seat.expiresAt === null || seat.expiresAt > now)\n );\n}\n"],
5
+ "mappings": "AAAA,SAAS,iBAAiB;AAE1B,SAAS,qBAAqB;AAC9B;AAAA,EACE;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AA8DA,MAAM,YAAY,UAAuB;AAAA,EAC9C,MAAM;AAAA,EACN,gBAAgB;AAAA,EAChB,SAAS;AAAA,EACT,OAAO;AAAA,EACP,SAAS,OAAO,EAAE,OAAO,CAAC,EAAE;AAC9B,CAAC;AAEM,MAAM,cAAc,gBAAgB;AACpC,MAAM,YAAY;AACzB,MAAM,SAAS;AAER,SAAS,WAAW,KAAsB;AAC/C,SAAO,OAAO,OAAO,EAAE,EACpB,QAAQ,oBAAoB,GAAG,EAC/B,QAAQ,QAAQ,GAAG,EACnB,KAAK,EACL,MAAM,GAAG,SAAS;AACvB;AAEO,SAAS,OAAO,OAAoC;AACzD,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,MAAI,UAAU,UAAU,UAAU,WAAW,UAAU,UAAU,UAAU,MAAO,QAAO;AACzF,SAAO,cAAc,KAAK,KAAK;AACjC;AAEO,SAAS,WACd,OACA,KACA,SAAsB,sBACP;AACf,MAAI,OAAO,OAAO,OAAO,YAAY,CAAC,MAAM,MAAM,MAAM,GAAG,SAAS;AAClE,WAAO;AACT,MAAI,CAAC,WAAW,MAAM,KAAK,EAAG,QAAO;AACrC,MAAI,CAAC,OAAO,MAAM,OAAO,QAAQ,KAAK,CAAC,OAAO,MAAM,OAAO,KAAK;AAC9D,WAAO;AACT,MAAI,CAAC,OAAO,oBAAoB,SAAS,SAAS,MAAM,MAAM,QAAQ,CAAC;AACrE,WAAO,YAAY,sBAAsB,OAAO,mBAAmB;AACrE,MAAI,CAAC,OAAO,iBAAiB,SAAS,SAAS,MAAM,MAAM,KAAK,CAAC;AAC/D,WAAO,YAAY,wBAAwB,OAAO,gBAAgB;AACpE,QAAM,EAAE,UAAU,IAAI;AACtB,MAAI,cAAc,SAAS,OAAO,cAAc,YAAY,CAAC,OAAO,SAAS,SAAS;AACpF,WAAO;AACT,MAAI,cAAc,QAAQ,aAAa,IAAK,QAAO;AACnD,QAAM,OAAO,OAAO;AACpB,MAAI,cAAc,QAAQ,YAAY,MAAM,OAAO;AACjD,WAAO,8BAA8B,IAAI,IAAI,SAAS,IAAI,QAAQ,MAAM;AAC1E,SAAO;AACT;AAEO,SAAS,SAAS,MAA8B,KAAsB;AAC3E,SAAO;AAAA,IACL,QAAQ,KAAK,YAAY,SAAS,KAAK,cAAc,QAAQ,KAAK,YAAY;AAAA,EAChF;AACF;",
6
6
  "names": []
7
7
  }
package/dist/host.js CHANGED
@@ -14,6 +14,7 @@ import { createSudo, ownedSudo } from "./approvals/sudo.js";
14
14
  import { createAgentControl } from "./control.js";
15
15
  import { trackDeliveries } from "./deliveries.js";
16
16
  import { IDLE } from "./freezer/v6.js";
17
+ import { captureGate } from "./guests/capture.js";
17
18
  import { createGuests } from "./guests/index.js";
18
19
  import { admitGuest, guestOpener } from "./guests/serve.js";
19
20
  import { createInventory } from "./inventory.js";
@@ -203,6 +204,12 @@ const inventoryOf = (agent, views, context) => createInventory({
203
204
  context
204
205
  });
205
206
  const noRevision = () => replicatedState({ revision: 0 });
207
+ const captureOf = (agent, approvals, guests, options) => captureGate({
208
+ harness: agent.harness,
209
+ approvals,
210
+ policy: () => guests.policy(),
211
+ ...options.scoops ? { lineage: options.scoops.scoops.lineage } : {}
212
+ });
206
213
  async function hostAgent(agent, options = {}) {
207
214
  const context = options.context ?? BACKGROUND_CONTEXT;
208
215
  const serverId = options.serverId ?? crypto.randomUUID();
@@ -289,6 +296,7 @@ async function hostAgent(agent, options = {}) {
289
296
  };
290
297
  const sudo = createSudo({
291
298
  approvals,
299
+ capture: captureOf(agent, approvals, guests, options),
292
300
  agents: () => agent.agents.state(),
293
301
  ...options.licks ? { licks: options.licks.licks } : {}
294
302
  });