@ai-ecoverse/slicc-agent 7.30.3 → 7.32.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (102) hide show
  1. package/README.md +19 -7
  2. package/dist/agent.js +4 -0
  3. package/dist/agent.js.map +2 -2
  4. package/dist/approvals/policy.js +27 -5
  5. package/dist/approvals/policy.js.map +2 -2
  6. package/dist/approvals/published.js +18 -0
  7. package/dist/approvals/published.js.map +7 -0
  8. package/dist/approvals/record.js +4 -1
  9. package/dist/approvals/record.js.map +2 -2
  10. package/dist/approvals/run-licks.js +137 -0
  11. package/dist/approvals/run-licks.js.map +7 -0
  12. package/dist/approvals/run-procs.js +127 -0
  13. package/dist/approvals/run-procs.js.map +7 -0
  14. package/dist/approvals/run.js +468 -0
  15. package/dist/approvals/run.js.map +7 -0
  16. package/dist/approvals/runnable.js +125 -0
  17. package/dist/approvals/runnable.js.map +7 -0
  18. package/dist/approvals/sudo.js +29 -1
  19. package/dist/approvals/sudo.js.map +2 -2
  20. package/dist/client.js +1 -0
  21. package/dist/client.js.map +2 -2
  22. package/dist/control.js +7 -1
  23. package/dist/control.js.map +2 -2
  24. package/dist/freezer/index.js +4 -1
  25. package/dist/freezer/index.js.map +2 -2
  26. package/dist/guests/attribution.js +4 -0
  27. package/dist/guests/attribution.js.map +2 -2
  28. package/dist/guests/guard.js +28 -3
  29. package/dist/guests/guard.js.map +2 -2
  30. package/dist/guests/view.js +20 -4
  31. package/dist/guests/view.js.map +2 -2
  32. package/dist/host.js +69 -16
  33. package/dist/host.js.map +2 -2
  34. package/dist/images/markers.js +2 -7
  35. package/dist/images/markers.js.map +2 -2
  36. package/dist/index.js +14 -0
  37. package/dist/index.js.map +2 -2
  38. package/dist/intent/index.js +75 -0
  39. package/dist/intent/index.js.map +7 -0
  40. package/dist/intent/said.js +26 -0
  41. package/dist/intent/said.js.map +7 -0
  42. package/dist/kernel/with-exec.js +13 -0
  43. package/dist/kernel/with-exec.js.map +7 -0
  44. package/dist/licks/extension.js +1 -0
  45. package/dist/licks/extension.js.map +2 -2
  46. package/dist/licks/lick.js +1 -0
  47. package/dist/licks/lick.js.map +2 -2
  48. package/dist/main.js +15 -6
  49. package/dist/main.js.map +2 -2
  50. package/dist/services.js +7 -2
  51. package/dist/services.js.map +2 -2
  52. package/dist/settings.js +1 -0
  53. package/dist/settings.js.map +2 -2
  54. package/dist/spectrum/agent-port.js +13 -2
  55. package/dist/spectrum/agent-port.js.map +2 -2
  56. package/dist/spectrum/approvals-port.js +69 -0
  57. package/dist/spectrum/approvals-port.js.map +2 -2
  58. package/dist/spectrum/messages.js +35 -16
  59. package/dist/spectrum/messages.js.map +2 -2
  60. package/dist/spectrum/monitor-port.js +2 -1
  61. package/dist/spectrum/monitor-port.js.map +2 -2
  62. package/dist/spectrum/tool-title.js +11 -8
  63. package/dist/spectrum/tool-title.js.map +2 -2
  64. package/dist/titles/cluster.js +15 -4
  65. package/dist/titles/cluster.js.map +2 -2
  66. package/dist/titles/generate.js +6 -2
  67. package/dist/titles/generate.js.map +2 -2
  68. package/dist/titles/labels.js +2 -7
  69. package/dist/titles/labels.js.map +2 -2
  70. package/dist/titles/shown.js +6 -0
  71. package/dist/titles/shown.js.map +2 -2
  72. package/dist/types/agent.d.ts +2 -0
  73. package/dist/types/approvals/policy.d.ts +10 -1
  74. package/dist/types/approvals/published.d.ts +3 -0
  75. package/dist/types/approvals/record.d.ts +44 -1
  76. package/dist/types/approvals/run-licks.d.ts +18 -0
  77. package/dist/types/approvals/run-procs.d.ts +40 -0
  78. package/dist/types/approvals/run.d.ts +60 -0
  79. package/dist/types/approvals/runnable.d.ts +55 -0
  80. package/dist/types/approvals/sudo.d.ts +3 -1
  81. package/dist/types/client.d.ts +2 -0
  82. package/dist/types/guests/attribution.d.ts +5 -0
  83. package/dist/types/guests/guard.d.ts +1 -1
  84. package/dist/types/host.d.ts +10 -0
  85. package/dist/types/index.d.ts +4 -1
  86. package/dist/types/intent/index.d.ts +7 -0
  87. package/dist/types/intent/said.d.ts +4 -0
  88. package/dist/types/kernel/client.d.ts +35 -0
  89. package/dist/types/kernel/with-exec.d.ts +2 -0
  90. package/dist/types/licks/lick.d.ts +1 -1
  91. package/dist/types/licks/triage.d.ts +1 -1
  92. package/dist/types/main.d.ts +2 -1
  93. package/dist/types/services.d.ts +8 -2
  94. package/dist/types/settings.d.ts +1 -0
  95. package/dist/types/spectrum/approvals-port.d.ts +10 -2
  96. package/dist/types/spectrum/messages.d.ts +3 -2
  97. package/dist/types/spectrum/tool-title.d.ts +1 -1
  98. package/dist/types/titles/cluster.d.ts +1 -0
  99. package/dist/types/titles/generate.d.ts +3 -2
  100. package/dist/types/titles/labels.d.ts +1 -1
  101. package/dist/types/titles/shown.d.ts +1 -0
  102. package/package.json +3 -3
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/titles/labels.ts"],
4
- "sourcesContent": ["import {\n type Context,\n type MutableReplicatedState,\n type ReplicatedState,\n replicatedState,\n} from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { AssistantMessage, Usage } from '@earendil-works/pi-ai';\nimport {\n type ConversationId,\n type ConversationView,\n defineDoc,\n type Harness,\n LiveDoc,\n type LiveState,\n type Tx,\n UsageDoc,\n} from '@earendil-works/pi-durable';\nimport type { Agents } from '../agents.ts';\nimport { boundedDeltas } from '../checkpoints.ts';\nimport type { VaultState } from '../secrets/vault.ts';\nimport { vaultHold } from '../secrets/view.ts';\nimport { callIdsOf, clusterOf, describe, describeStep } from './cluster.ts';\nimport { type Labeler, STEP_PROMPT, scrubbed } from './generate.ts';\nimport { callIdsOfKey, labelKey, shownLabel, stepKey } from './shown.ts';\n\nexport type LabelsState = { labels: Record<string, string> };\n\nexport const LabelsDoc = defineDoc<LabelsState>({\n kind: 'slicc.labels',\n checkpointWhen: boundedDeltas,\n version: 1,\n scope: 'session',\n initial: () => ({ labels: {} }),\n});\n\nexport const LABELS_KEPT = 1000;\nexport const LABELS_PER_MINUTE = 6;\nexport const STEP_LABELS_PER_MINUTE = 30;\nconst MINUTE = 60_000;\nconst LABEL_WORDS = 8;\nconst LABEL_LENGTH = 80;\nconst RESERVED = 2;\nconst POLL_MS = 1000;\nconst SETTLE_MS = 600_000;\nconst STEP_POLL_MS = 250;\nconst STEP_ID = /^\\S{1,256}$/;\nexport const STEP_WAITERS = 8;\nexport const STEP_WAITS_PER_MINUTE = 60;\nexport const STEP_WATCHERS = 32;\n\nexport const LABEL_WAIT_MS = 30_000;\n\nexport function visibleLabels(\n labels: ReplicatedState<Record<string, string>>,\n sources: readonly ReplicatedState<unknown>[],\n views: () => readonly ConversationView[]\n) {\n const pick = () => {\n const ids = callIdsOf(views());\n return Object.fromEntries(\n Object.entries(labels.value as Record<string, string>).filter(([key]) =>\n callIdsOfKey(key).every((id) => ids.has(id))\n )\n );\n };\n const state = replicatedState<Record<string, string>>(pick());\n let queued = false;\n const update = () => {\n if (queued) return;\n queued = true;\n queueMicrotask(() => {\n queued = false;\n const next = pick();\n const before = state.value;\n const keys = Object.keys(next);\n if (\n keys.length !== Object.keys(before).length ||\n keys.some((key) => before[key] !== next[key])\n )\n state.replace(BACKGROUND_CONTEXT, next);\n });\n };\n const offs = [labels, ...sources].map((source) => source.subscribe(update));\n return {\n state,\n dispose() {\n for (const off of offs) off();\n },\n };\n}\n\nexport function watchLabel(\n labels: ReplicatedState<Record<string, string>>,\n waitMs = LABEL_WAIT_MS\n) {\n return (_agentId: string, callIds: readonly string[]): Promise<string | null> => {\n const found = shownLabel(labels.value, callIds);\n if (found !== undefined || !callIds.length) return Promise.resolve(found ?? null);\n return new Promise((resolve) => {\n const done = (label: string | null) => {\n clearTimeout(timer);\n off();\n resolve(label);\n };\n const timer = setTimeout(() => done(null), waitMs);\n const off = labels.subscribe(() => {\n const label = shownLabel(labels.value, callIds);\n if (label !== undefined) done(label);\n });\n });\n };\n}\n\nexport function stepId(callId: unknown): callId is string {\n return typeof callId === 'string' && STEP_ID.test(callId);\n}\n\nexport function watchStep(labels: ReplicatedState<Record<string, string>>, waitMs = LABEL_WAIT_MS) {\n const watch = watchLabel(labels, waitMs);\n const watching = new Map<string, Promise<string | null>>();\n return (agentId: string, callId: string): Promise<string | null> => {\n if (!stepId(callId)) return Promise.resolve(null);\n const key = stepKey(callId);\n const shown = shownLabel(labels.value, [key]);\n if (shown !== undefined) return Promise.resolve(shown);\n const known = watching.get(key);\n if (known !== undefined) return known;\n if (watching.size >= STEP_WATCHERS) return Promise.resolve(null);\n const waiting = watch(agentId, [key]).finally(() => watching.delete(key));\n watching.set(key, waiting);\n return waiting;\n };\n}\n\nexport function cleanLabel(text: string): string {\n return text\n .replace(/\\s+/g, ' ')\n .trim()\n .replace(/^[\"'\u201C\u201D]+|[\"'\u201C\u201D]+$/g, '')\n .replace(/\\.+$/, '')\n .trim()\n .split(' ')\n .slice(0, LABEL_WORDS)\n .join(' ')\n .slice(0, LABEL_LENGTH);\n}\n\ntype Counted = Record<'input' | 'output' | 'cacheRead' | 'cacheWrite' | 'totalTokens', number> & {\n cost: Record<'input' | 'output' | 'cacheRead' | 'cacheWrite' | 'total', number>;\n};\n\nexport async function spend(\n tx: Tx,\n conversation: ConversationId,\n answer: Pick<AssistantMessage, 'provider' | 'model' | 'usage'>\n) {\n const models = (await tx.doc(UsageDoc, conversation)).models as unknown as Record<\n string,\n Counted\n >;\n const key = `${answer.provider}/${answer.model}`;\n const usage = answer.usage as Usage;\n const total = Object.hasOwn(models, key) ? models[key] : undefined;\n if (!total) {\n models[key] = JSON.parse(JSON.stringify(usage)) as Counted;\n return;\n }\n for (const field of ['input', 'output', 'cacheRead', 'cacheWrite', 'totalTokens'] as const)\n total[field] += usage[field];\n for (const field of ['input', 'output', 'cacheRead', 'cacheWrite', 'total'] as const)\n total.cost[field] += usage.cost[field];\n}\n\nexport interface LabelsAttach {\n harness: Pick<Harness, 'commit' | 'snapshot'>;\n agents: Pick<Agents, 'conversation'>;\n label: Labeler;\n vault?: Pick<ReplicatedState<VaultState>, 'value'>;\n now?: () => number;\n perMinute?: number;\n stepsPerMinute?: number;\n stepWaitMs?: number;\n pollMs?: number;\n settleMs?: number;\n}\n\nexport interface LabelsRuntime {\n labels: ReplicatedState<Record<string, string>>;\n label(agentId: string, callIds: readonly string[], context: Context): Promise<string | null>;\n step(agentId: string, callId: string, context: Context): Promise<string | null>;\n}\n\nfunction modelName(model: { provider: string; modelId: string } | undefined): string {\n return model ? `${model.provider}/${model.modelId}` : '';\n}\n\nconst wait = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));\n\nfunction recentIn(books: Map<string, number[]>, agentId: string, at: number): number[] {\n const recent = (books.get(agentId) ?? []).filter((time) => at - time < MINUTE);\n books.set(agentId, recent);\n return recent;\n}\n\ntype Kept = Record<string, string>;\n\ninterface StepsAttach\n extends Pick<\n LabelsAttach,\n 'harness' | 'agents' | 'label' | 'vault' | 'stepsPerMinute' | 'stepWaitMs'\n > {\n labels: MutableReplicatedState<Kept>;\n keep(key: string, label: string, id: ConversationId, answer: AssistantMessage): Promise<Kept>;\n now: () => number;\n started: number;\n pollMs: number;\n}\n\ntype Said = { content?: { type?: string; id?: string }[] };\n\nexport function pendingIn(live: Readonly<LiveState> | undefined, callId: string): boolean {\n if (!live?.run) return false;\n const said = live.generation?.message as Said | undefined;\n return (\n (said?.content ?? []).some((block) => block.type === 'toolCall' && block.id === callId) ||\n (live.tools ?? []).some((slot) => slot.callId === callId)\n );\n}\n\nfunction stepLabels(options: StepsAttach): LabelsRuntime['step'] {\n const { agents, labels, now, harness } = options;\n const spent = new Map<string, number[]>();\n const waits = new Map<string, number[]>();\n const waiters = new Map<string, number>();\n const flying = new Map<string, Promise<string | null>>();\n const cap = options.stepsPerMinute ?? STEP_LABELS_PER_MINUTE;\n const poll = Math.min(options.pollMs, STEP_POLL_MS);\n const rounds = Math.ceil((options.stepWaitMs ?? LABEL_WAIT_MS) / poll);\n const admit = (agentId: string) => () => {\n const recent = recentIn(spent, agentId, now());\n if (recent.length >= cap) return false;\n recent.push(now());\n return true;\n };\n const room = (agentId: string) => {\n const recent = recentIn(waits, agentId, now());\n if ((waiters.get(agentId) ?? 0) >= STEP_WAITERS || recent.length >= STEP_WAITS_PER_MINUTE)\n return false;\n recent.push(now());\n return true;\n };\n const appeared = async (agentId: string, callId: string) => {\n const conversation = await agents.conversation(agentId, BACKGROUND_CONTEXT);\n if (!conversation) return undefined;\n const look = async () =>\n clusterOf((await conversation.context(BACKGROUND_CONTEXT)).entries, [callId]);\n const pending = async () =>\n pendingIn(await harness.snapshot(LiveDoc, conversation.id, BACKGROUND_CONTEXT), callId);\n const first = await look();\n if (first) return { conversation, cluster: first };\n if (!(await pending()) || !room(agentId)) return undefined;\n waiters.set(agentId, (waiters.get(agentId) ?? 0) + 1);\n try {\n for (let round = 0; round < rounds; round++) {\n await wait(poll);\n const cluster = await look();\n if (cluster) return { conversation, cluster };\n if (!(await pending())) return undefined;\n }\n return undefined;\n } finally {\n waiters.set(agentId, (waiters.get(agentId) as number) - 1);\n }\n };\n const make = async (agentId: string, callId: string, key: string) => {\n const found = await appeared(agentId, callId);\n if (!found || found.cluster.at < options.started) return null;\n if (vaultHold(options.vault?.value)) return null;\n const text = await scrubbed(found.cluster.runs.map(describeStep).join('\\n'));\n const model = modelName((await found.conversation.agent(BACKGROUND_CONTEXT)).model);\n const asked = await options.label(text, model, BACKGROUND_CONTEXT, admit(agentId), STEP_PROMPT);\n if (!asked) return null;\n const label = cleanLabel(asked.text);\n labels.replace(\n BACKGROUND_CONTEXT,\n await options.keep(key, label, found.conversation.id, asked.answer)\n );\n return label || null;\n };\n return (agentId, callId) => {\n if (!stepId(callId)) return Promise.resolve(null);\n const key = stepKey(callId);\n const shown = shownLabel(labels.value, [key]);\n if (shown !== undefined) return Promise.resolve(shown);\n const known = flying.get(key);\n if (known !== undefined) return known;\n const made = make(agentId, callId, key)\n .catch(() => null)\n .finally(() => flying.delete(key));\n flying.set(key, made);\n return made;\n };\n}\n\nexport async function attachLabels(\n options: LabelsAttach,\n context: Context = BACKGROUND_CONTEXT\n): Promise<LabelsRuntime> {\n const { harness, agents } = options;\n const now = options.now ?? Date.now;\n const started = now();\n const cap = options.perMinute ?? LABELS_PER_MINUTE;\n const loaded = await harness.commit(\n async (tx) => ({ ...(await tx.doc(LabelsDoc)).labels }),\n context\n );\n const labels = replicatedState<Record<string, string>>(loaded);\n const flying = new Map<string, Promise<string | null>>();\n const waiting = new Set<string>();\n const spent = new Map<string, number[]>();\n const pollMs = options.pollMs ?? POLL_MS;\n const rounds = Math.ceil((options.settleMs ?? SETTLE_MS) / pollMs);\n const sleep = () => wait(pollMs);\n const used = (agentId: string) => recentIn(spent, agentId, now());\n const admit = (agentId: string, settle: boolean) => () => {\n const recent = used(agentId);\n if (recent.length >= (settle ? cap : cap - RESERVED)) return false;\n recent.push(now());\n return true;\n };\n const room = async (agentId: string) => {\n for (let round = 0; round < rounds && used(agentId).length >= cap; round++) await sleep();\n };\n const keep = (\n key: string,\n label: string,\n conversation: ConversationId,\n answer: AssistantMessage\n ) =>\n harness.commit(async (tx) => {\n const doc = await tx.doc(LabelsDoc);\n doc.labels[key] = label;\n const keys = Object.keys(doc.labels);\n for (const old of keys.slice(0, Math.max(0, keys.length - LABELS_KEPT)))\n delete doc.labels[old];\n await spend(tx, conversation, answer);\n return { ...doc.labels };\n }, BACKGROUND_CONTEXT);\n const read = async (agentId: string, callIds: readonly string[]) => {\n const conversation = await agents.conversation(agentId, BACKGROUND_CONTEXT);\n if (!conversation) return undefined;\n const cluster = clusterOf((await conversation.context(BACKGROUND_CONTEXT)).entries, callIds);\n return cluster ? { conversation, cluster } : undefined;\n };\n type Read = NonNullable<Awaited<ReturnType<typeof read>>>;\n const ask = async (agentId: string, key: string, found: Read, settle: boolean) => {\n if (vaultHold(options.vault?.value)) return null;\n if (settle) await room(agentId);\n const text = await scrubbed(describe(found.cluster.runs));\n const model = modelName((await found.conversation.agent(BACKGROUND_CONTEXT)).model);\n const asked = await options.label(text, model, BACKGROUND_CONTEXT, admit(agentId, settle));\n if (!asked) return null;\n const label = cleanLabel(asked.text);\n labels.replace(BACKGROUND_CONTEXT, await keep(key, label, found.conversation.id, asked.answer));\n return label || null;\n };\n const longer = (key: string) =>\n [...flying.keys(), ...waiting, ...Object.keys(labels.value)].some((other) =>\n other.startsWith(`${key} `)\n );\n const prefixOf = (callIds: readonly string[]) => {\n for (let size = callIds.length - 1; size > 0; size--) {\n const part = callIds.slice(0, size);\n const key = labelKey(part);\n const shown = flying.get(key) ?? shownLabel(labels.value, part);\n if (shown !== undefined) return Promise.resolve(shown);\n if (waiting.has(key)) return Promise.resolve(null);\n }\n return undefined;\n };\n const settled = async (agentId: string, callIds: readonly string[], key: string) => {\n for (let round = 0; round < rounds; round++) {\n await sleep();\n if (longer(key)) return undefined;\n const found = await read(agentId, callIds);\n if (found?.cluster.settled) return found;\n }\n return undefined;\n };\n const relabel = async (agentId: string, callIds: readonly string[], key: string) => {\n const found = await settled(agentId, callIds, key);\n return found ? ask(agentId, key, found, true) : undefined;\n };\n const make = async (agentId: string, callIds: readonly string[], key: string) => {\n const found = await read(agentId, callIds);\n if (!found || found.cluster.at < started) return null;\n const prefix = prefixOf(callIds);\n if (longer(key)) return (await prefix) ?? null;\n if (found.cluster.settled) return ask(agentId, key, found, prefix !== undefined);\n if (prefix !== undefined) {\n const shown = await prefix;\n return (await relabel(agentId, callIds, key)) ?? shown;\n }\n const first = await ask(agentId, key, found, false);\n waiting.add(key);\n void relabel(agentId, callIds, key)\n .catch(() => undefined)\n .finally(() => waiting.delete(key));\n return first;\n };\n return {\n labels,\n step: stepLabels({ ...options, labels, keep, now, started, pollMs }),\n label(agentId, callIds, _context) {\n if (!callIds.length) return Promise.resolve(null);\n const key = labelKey(callIds);\n const found = shownLabel(labels.value, callIds);\n if (found !== undefined) return Promise.resolve(found);\n const known = flying.get(key);\n if (known !== undefined) return known;\n const made = make(agentId, callIds, key)\n .catch(() => null)\n .finally(() => flying.delete(key));\n flying.set(key, made);\n return made;\n },\n };\n}\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["import {\n type Context,\n type MutableReplicatedState,\n type ReplicatedState,\n replicatedState,\n} from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { AssistantMessage, Usage } from '@earendil-works/pi-ai';\nimport {\n type ConversationId,\n type ConversationView,\n defineDoc,\n type Harness,\n LiveDoc,\n type LiveState,\n type Tx,\n UsageDoc,\n} from '@earendil-works/pi-durable';\nimport type { Agents } from '../agents.ts';\nimport { boundedDeltas } from '../checkpoints.ts';\nimport type { VaultState } from '../secrets/vault.ts';\nimport { vaultHold } from '../secrets/view.ts';\nimport { callIdsOf, clusterOf, describe, describeStep } from './cluster.ts';\nimport { type Labeler, STEP_PROMPT, scrubbed } from './generate.ts';\nimport { callIdsOfKey, cleanLabel, labelKey, shownLabel, stepKey } from './shown.ts';\n\nexport type LabelsState = { labels: Record<string, string> };\n\nexport const LabelsDoc = defineDoc<LabelsState>({\n kind: 'slicc.labels',\n checkpointWhen: boundedDeltas,\n version: 1,\n scope: 'session',\n initial: () => ({ labels: {} }),\n});\n\nexport const LABELS_KEPT = 1000;\nexport const LABELS_PER_MINUTE = 6;\nexport const STEP_LABELS_PER_MINUTE = 30;\nconst MINUTE = 60_000;\nconst RESERVED = 2;\nconst POLL_MS = 1000;\nconst SETTLE_MS = 600_000;\nconst STEP_POLL_MS = 250;\nconst STEP_ID = /^\\S{1,256}$/;\nexport const STEP_WAITERS = 8;\nexport const STEP_WAITS_PER_MINUTE = 60;\nexport const STEP_WATCHERS = 32;\n\nexport const LABEL_WAIT_MS = 30_000;\n\nexport function visibleLabels(\n labels: ReplicatedState<Record<string, string>>,\n sources: readonly ReplicatedState<unknown>[],\n views: () => readonly ConversationView[]\n) {\n const pick = () => {\n const ids = callIdsOf(views());\n return Object.fromEntries(\n Object.entries(labels.value as Record<string, string>).filter(([key]) =>\n callIdsOfKey(key).every((id) => ids.has(id))\n )\n );\n };\n const state = replicatedState<Record<string, string>>(pick());\n let queued = false;\n const update = () => {\n if (queued) return;\n queued = true;\n queueMicrotask(() => {\n queued = false;\n const next = pick();\n const before = state.value;\n const keys = Object.keys(next);\n if (\n keys.length !== Object.keys(before).length ||\n keys.some((key) => before[key] !== next[key])\n )\n state.replace(BACKGROUND_CONTEXT, next);\n });\n };\n const offs = [labels, ...sources].map((source) => source.subscribe(update));\n return {\n state,\n dispose() {\n for (const off of offs) off();\n },\n };\n}\n\nexport function watchLabel(\n labels: ReplicatedState<Record<string, string>>,\n waitMs = LABEL_WAIT_MS\n) {\n return (_agentId: string, callIds: readonly string[]): Promise<string | null> => {\n const found = shownLabel(labels.value, callIds);\n if (found !== undefined || !callIds.length) return Promise.resolve(found ?? null);\n return new Promise((resolve) => {\n const done = (label: string | null) => {\n clearTimeout(timer);\n off();\n resolve(label);\n };\n const timer = setTimeout(() => done(null), waitMs);\n const off = labels.subscribe(() => {\n const label = shownLabel(labels.value, callIds);\n if (label !== undefined) done(label);\n });\n });\n };\n}\n\nexport function stepId(callId: unknown): callId is string {\n return typeof callId === 'string' && STEP_ID.test(callId);\n}\n\nexport function watchStep(labels: ReplicatedState<Record<string, string>>, waitMs = LABEL_WAIT_MS) {\n const watch = watchLabel(labels, waitMs);\n const watching = new Map<string, Promise<string | null>>();\n return (agentId: string, callId: string): Promise<string | null> => {\n if (!stepId(callId)) return Promise.resolve(null);\n const key = stepKey(callId);\n const shown = shownLabel(labels.value, [key]);\n if (shown !== undefined) return Promise.resolve(shown);\n const known = watching.get(key);\n if (known !== undefined) return known;\n if (watching.size >= STEP_WATCHERS) return Promise.resolve(null);\n const waiting = watch(agentId, [key]).finally(() => watching.delete(key));\n watching.set(key, waiting);\n return waiting;\n };\n}\n\ntype Counted = Record<'input' | 'output' | 'cacheRead' | 'cacheWrite' | 'totalTokens', number> & {\n cost: Record<'input' | 'output' | 'cacheRead' | 'cacheWrite' | 'total', number>;\n};\n\nexport async function spend(\n tx: Tx,\n conversation: ConversationId,\n answer: Pick<AssistantMessage, 'provider' | 'model' | 'usage'>\n) {\n const models = (await tx.doc(UsageDoc, conversation)).models as unknown as Record<\n string,\n Counted\n >;\n const key = `${answer.provider}/${answer.model}`;\n const usage = answer.usage as Usage;\n const total = Object.hasOwn(models, key) ? models[key] : undefined;\n if (!total) {\n models[key] = JSON.parse(JSON.stringify(usage)) as Counted;\n return;\n }\n for (const field of ['input', 'output', 'cacheRead', 'cacheWrite', 'totalTokens'] as const)\n total[field] += usage[field];\n for (const field of ['input', 'output', 'cacheRead', 'cacheWrite', 'total'] as const)\n total.cost[field] += usage.cost[field];\n}\n\nexport interface LabelsAttach {\n harness: Pick<Harness, 'commit' | 'snapshot'>;\n agents: Pick<Agents, 'conversation'>;\n label: Labeler;\n vault?: Pick<ReplicatedState<VaultState>, 'value'>;\n now?: () => number;\n perMinute?: number;\n stepsPerMinute?: number;\n stepWaitMs?: number;\n pollMs?: number;\n settleMs?: number;\n intents?: boolean;\n}\n\nexport interface LabelsRuntime {\n labels: ReplicatedState<Record<string, string>>;\n label(agentId: string, callIds: readonly string[], context: Context): Promise<string | null>;\n step(agentId: string, callId: string, context: Context): Promise<string | null>;\n}\n\nfunction modelName(model: { provider: string; modelId: string } | undefined): string {\n return model ? `${model.provider}/${model.modelId}` : '';\n}\n\nconst wait = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));\n\nfunction recentIn(books: Map<string, number[]>, agentId: string, at: number): number[] {\n const recent = (books.get(agentId) ?? []).filter((time) => at - time < MINUTE);\n books.set(agentId, recent);\n return recent;\n}\n\ntype Kept = Record<string, string>;\n\ninterface StepsAttach\n extends Pick<\n LabelsAttach,\n 'harness' | 'agents' | 'label' | 'vault' | 'stepsPerMinute' | 'stepWaitMs' | 'intents'\n > {\n labels: MutableReplicatedState<Kept>;\n keep(key: string, label: string, id: ConversationId, answer: AssistantMessage): Promise<Kept>;\n now: () => number;\n started: number;\n pollMs: number;\n}\n\ntype Said = { content?: { type?: string; id?: string }[] };\n\nexport function pendingIn(live: Readonly<LiveState> | undefined, callId: string): boolean {\n if (!live?.run) return false;\n const said = live.generation?.message as Said | undefined;\n return (\n (said?.content ?? []).some((block) => block.type === 'toolCall' && block.id === callId) ||\n (live.tools ?? []).some((slot) => slot.callId === callId)\n );\n}\n\nfunction stepLabels(options: StepsAttach): LabelsRuntime['step'] {\n const { agents, labels, now, harness } = options;\n const spent = new Map<string, number[]>();\n const waits = new Map<string, number[]>();\n const waiters = new Map<string, number>();\n const flying = new Map<string, Promise<string | null>>();\n const cap = options.stepsPerMinute ?? STEP_LABELS_PER_MINUTE;\n const poll = Math.min(options.pollMs, STEP_POLL_MS);\n const rounds = Math.ceil((options.stepWaitMs ?? LABEL_WAIT_MS) / poll);\n const admit = (agentId: string) => () => {\n const recent = recentIn(spent, agentId, now());\n if (recent.length >= cap) return false;\n recent.push(now());\n return true;\n };\n const room = (agentId: string) => {\n const recent = recentIn(waits, agentId, now());\n if ((waiters.get(agentId) ?? 0) >= STEP_WAITERS || recent.length >= STEP_WAITS_PER_MINUTE)\n return false;\n recent.push(now());\n return true;\n };\n const appeared = async (agentId: string, callId: string) => {\n const conversation = await agents.conversation(agentId, BACKGROUND_CONTEXT);\n if (!conversation) return undefined;\n const look = async () =>\n clusterOf((await conversation.context(BACKGROUND_CONTEXT)).entries, [callId]);\n const pending = async () =>\n pendingIn(await harness.snapshot(LiveDoc, conversation.id, BACKGROUND_CONTEXT), callId);\n const first = await look();\n if (first) return { conversation, cluster: first };\n if (!(await pending()) || !room(agentId)) return undefined;\n waiters.set(agentId, (waiters.get(agentId) ?? 0) + 1);\n try {\n for (let round = 0; round < rounds; round++) {\n await wait(poll);\n const cluster = await look();\n if (cluster) return { conversation, cluster };\n if (!(await pending())) return undefined;\n }\n return undefined;\n } finally {\n waiters.set(agentId, (waiters.get(agentId) as number) - 1);\n }\n };\n const make = async (agentId: string, callId: string, key: string) => {\n const found = await appeared(agentId, callId);\n if (!found || found.cluster.at < options.started) return null;\n if (options.intents && found.cluster.runs[0]?.intent) return null;\n if (vaultHold(options.vault?.value)) return null;\n const text = await scrubbed(found.cluster.runs.map(describeStep).join('\\n'));\n const model = modelName((await found.conversation.agent(BACKGROUND_CONTEXT)).model);\n const asked = await options.label(text, model, BACKGROUND_CONTEXT, admit(agentId), STEP_PROMPT);\n if (!asked) return null;\n const label = cleanLabel(asked.text);\n labels.replace(\n BACKGROUND_CONTEXT,\n await options.keep(key, label, found.conversation.id, asked.answer)\n );\n return label || null;\n };\n return (agentId, callId) => {\n if (!stepId(callId)) return Promise.resolve(null);\n const key = stepKey(callId);\n const shown = shownLabel(labels.value, [key]);\n if (shown !== undefined) return Promise.resolve(shown);\n const known = flying.get(key);\n if (known !== undefined) return known;\n const made = make(agentId, callId, key)\n .catch(() => null)\n .finally(() => flying.delete(key));\n flying.set(key, made);\n return made;\n };\n}\n\nexport async function attachLabels(\n options: LabelsAttach,\n context: Context = BACKGROUND_CONTEXT\n): Promise<LabelsRuntime> {\n const { harness, agents } = options;\n const now = options.now ?? Date.now;\n const started = now();\n const cap = options.perMinute ?? LABELS_PER_MINUTE;\n const loaded = await harness.commit(\n async (tx) => ({ ...(await tx.doc(LabelsDoc)).labels }),\n context\n );\n const labels = replicatedState<Record<string, string>>(loaded);\n const flying = new Map<string, Promise<string | null>>();\n const waiting = new Set<string>();\n const spent = new Map<string, number[]>();\n const pollMs = options.pollMs ?? POLL_MS;\n const rounds = Math.ceil((options.settleMs ?? SETTLE_MS) / pollMs);\n const sleep = () => wait(pollMs);\n const used = (agentId: string) => recentIn(spent, agentId, now());\n const admit = (agentId: string, settle: boolean) => () => {\n const recent = used(agentId);\n if (recent.length >= (settle ? cap : cap - RESERVED)) return false;\n recent.push(now());\n return true;\n };\n const room = async (agentId: string) => {\n for (let round = 0; round < rounds && used(agentId).length >= cap; round++) await sleep();\n };\n const keep = (\n key: string,\n label: string,\n conversation: ConversationId,\n answer: AssistantMessage\n ) =>\n harness.commit(async (tx) => {\n const doc = await tx.doc(LabelsDoc);\n doc.labels[key] = label;\n const keys = Object.keys(doc.labels);\n for (const old of keys.slice(0, Math.max(0, keys.length - LABELS_KEPT)))\n delete doc.labels[old];\n await spend(tx, conversation, answer);\n return { ...doc.labels };\n }, BACKGROUND_CONTEXT);\n const read = async (agentId: string, callIds: readonly string[]) => {\n const conversation = await agents.conversation(agentId, BACKGROUND_CONTEXT);\n if (!conversation) return undefined;\n const cluster = clusterOf((await conversation.context(BACKGROUND_CONTEXT)).entries, callIds);\n return cluster ? { conversation, cluster } : undefined;\n };\n type Read = NonNullable<Awaited<ReturnType<typeof read>>>;\n const ask = async (agentId: string, key: string, found: Read, settle: boolean) => {\n if (vaultHold(options.vault?.value)) return null;\n if (settle) await room(agentId);\n const text = await scrubbed(describe(found.cluster.runs));\n const model = modelName((await found.conversation.agent(BACKGROUND_CONTEXT)).model);\n const asked = await options.label(text, model, BACKGROUND_CONTEXT, admit(agentId, settle));\n if (!asked) return null;\n const label = cleanLabel(asked.text);\n labels.replace(BACKGROUND_CONTEXT, await keep(key, label, found.conversation.id, asked.answer));\n return label || null;\n };\n const longer = (key: string) =>\n [...flying.keys(), ...waiting, ...Object.keys(labels.value)].some((other) =>\n other.startsWith(`${key} `)\n );\n const prefixOf = (callIds: readonly string[]) => {\n for (let size = callIds.length - 1; size > 0; size--) {\n const part = callIds.slice(0, size);\n const key = labelKey(part);\n const shown = flying.get(key) ?? shownLabel(labels.value, part);\n if (shown !== undefined) return Promise.resolve(shown);\n if (waiting.has(key)) return Promise.resolve(null);\n }\n return undefined;\n };\n const settled = async (agentId: string, callIds: readonly string[], key: string) => {\n for (let round = 0; round < rounds; round++) {\n await sleep();\n if (longer(key)) return undefined;\n const found = await read(agentId, callIds);\n if (found?.cluster.settled) return found;\n }\n return undefined;\n };\n const relabel = async (agentId: string, callIds: readonly string[], key: string) => {\n const found = await settled(agentId, callIds, key);\n return found ? ask(agentId, key, found, true) : undefined;\n };\n const make = async (agentId: string, callIds: readonly string[], key: string) => {\n const found = await read(agentId, callIds);\n if (!found || found.cluster.at < started) return null;\n const prefix = prefixOf(callIds);\n if (longer(key)) return (await prefix) ?? null;\n if (found.cluster.settled) return ask(agentId, key, found, prefix !== undefined);\n if (prefix !== undefined) {\n const shown = await prefix;\n return (await relabel(agentId, callIds, key)) ?? shown;\n }\n const first = await ask(agentId, key, found, false);\n waiting.add(key);\n void relabel(agentId, callIds, key)\n .catch(() => undefined)\n .finally(() => waiting.delete(key));\n return first;\n };\n return {\n labels,\n step: stepLabels({ ...options, labels, keep, now, started, pollMs }),\n label(agentId, callIds, _context) {\n if (!callIds.length) return Promise.resolve(null);\n const key = labelKey(callIds);\n const found = shownLabel(labels.value, callIds);\n if (found !== undefined) return Promise.resolve(found);\n const known = flying.get(key);\n if (known !== undefined) return known;\n const made = make(agentId, callIds, key)\n .catch(() => null)\n .finally(() => flying.delete(key));\n flying.set(key, made);\n return made;\n },\n };\n}\n"],
5
+ "mappings": "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",
6
6
  "names": []
7
7
  }
@@ -12,9 +12,15 @@ function shownLabel(labels, callIds) {
12
12
  const key = labelKey(callIds);
13
13
  return labels && Object.hasOwn(labels, key) ? labels[key] || null : void 0;
14
14
  }
15
+ const LABEL_WORDS = 8;
16
+ const LABEL_LENGTH = 80;
17
+ function cleanLabel(text) {
18
+ return text.replace(/\s+/g, " ").replace(/[\p{Cc}\p{Cf}]/gu, "").trim().replace(/^["'“”]+|["'“”]+$/g, "").replace(/\.+$/, "").trim().split(" ").slice(0, LABEL_WORDS).join(" ").slice(0, LABEL_LENGTH);
19
+ }
15
20
  export {
16
21
  STEP_KEY,
17
22
  callIdsOfKey,
23
+ cleanLabel,
18
24
  labelKey,
19
25
  shownLabel,
20
26
  stepKey
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/titles/shown.ts"],
4
- "sourcesContent": ["export function labelKey(callIds: readonly string[]): string {\n return callIds.join(' ');\n}\n\nexport const STEP_KEY = 'step:';\n\nexport function stepKey(callId: string): string {\n return `${STEP_KEY}${callId}`;\n}\n\nexport function callIdsOfKey(key: string): string[] {\n return (key.startsWith(STEP_KEY) ? key.slice(STEP_KEY.length) : key).split(' ');\n}\n\nexport function shownLabel(\n labels: Readonly<Record<string, string>> | undefined,\n callIds: readonly string[]\n): string | null | undefined {\n const key = labelKey(callIds);\n return labels && Object.hasOwn(labels, key) ? labels[key] || null : undefined;\n}\n"],
5
- "mappings": "AAAO,SAAS,SAAS,SAAoC;AAC3D,SAAO,QAAQ,KAAK,GAAG;AACzB;AAEO,MAAM,WAAW;AAEjB,SAAS,QAAQ,QAAwB;AAC9C,SAAO,GAAG,QAAQ,GAAG,MAAM;AAC7B;AAEO,SAAS,aAAa,KAAuB;AAClD,UAAQ,IAAI,WAAW,QAAQ,IAAI,IAAI,MAAM,SAAS,MAAM,IAAI,KAAK,MAAM,GAAG;AAChF;AAEO,SAAS,WACd,QACA,SAC2B;AAC3B,QAAM,MAAM,SAAS,OAAO;AAC5B,SAAO,UAAU,OAAO,OAAO,QAAQ,GAAG,IAAI,OAAO,GAAG,KAAK,OAAO;AACtE;",
4
+ "sourcesContent": ["export function labelKey(callIds: readonly string[]): string {\n return callIds.join(' ');\n}\n\nexport const STEP_KEY = 'step:';\n\nexport function stepKey(callId: string): string {\n return `${STEP_KEY}${callId}`;\n}\n\nexport function callIdsOfKey(key: string): string[] {\n return (key.startsWith(STEP_KEY) ? key.slice(STEP_KEY.length) : key).split(' ');\n}\n\nexport function shownLabel(\n labels: Readonly<Record<string, string>> | undefined,\n callIds: readonly string[]\n): string | null | undefined {\n const key = labelKey(callIds);\n return labels && Object.hasOwn(labels, key) ? labels[key] || null : undefined;\n}\n\nconst LABEL_WORDS = 8;\nconst LABEL_LENGTH = 80;\n\nexport function cleanLabel(text: string): string {\n return text\n .replace(/\\s+/g, ' ')\n .replace(/[\\p{Cc}\\p{Cf}]/gu, '')\n .trim()\n .replace(/^[\"'\u201C\u201D]+|[\"'\u201C\u201D]+$/g, '')\n .replace(/\\.+$/, '')\n .trim()\n .split(' ')\n .slice(0, LABEL_WORDS)\n .join(' ')\n .slice(0, LABEL_LENGTH);\n}\n"],
5
+ "mappings": "AAAO,SAAS,SAAS,SAAoC;AAC3D,SAAO,QAAQ,KAAK,GAAG;AACzB;AAEO,MAAM,WAAW;AAEjB,SAAS,QAAQ,QAAwB;AAC9C,SAAO,GAAG,QAAQ,GAAG,MAAM;AAC7B;AAEO,SAAS,aAAa,KAAuB;AAClD,UAAQ,IAAI,WAAW,QAAQ,IAAI,IAAI,MAAM,SAAS,MAAM,IAAI,KAAK,MAAM,GAAG;AAChF;AAEO,SAAS,WACd,QACA,SAC2B;AAC3B,QAAM,MAAM,SAAS,OAAO;AAC5B,SAAO,UAAU,OAAO,OAAO,QAAQ,GAAG,IAAI,OAAO,GAAG,KAAK,OAAO;AACtE;AAEA,MAAM,cAAc;AACpB,MAAM,eAAe;AAEd,SAAS,WAAW,MAAsB;AAC/C,SAAO,KACJ,QAAQ,QAAQ,GAAG,EACnB,QAAQ,oBAAoB,EAAE,EAC9B,KAAK,EACL,QAAQ,sBAAsB,EAAE,EAChC,QAAQ,QAAQ,EAAE,EAClB,KAAK,EACL,MAAM,GAAG,EACT,MAAM,GAAG,WAAW,EACpB,KAAK,GAAG,EACR,MAAM,GAAG,YAAY;AAC1B;",
6
6
  "names": []
7
7
  }
@@ -2,6 +2,7 @@ import type { Context } from '@earendil-works/chord';
2
2
  import type { Models } from '@earendil-works/pi-ai/models';
3
3
  import { type Conversation, Harness, type HarnessOptions, type ModelRef, type Registry, type Storage } from '@earendil-works/pi-durable';
4
4
  import { type Agents } from './agents.ts';
5
+ import { type SudoRuns } from './approvals/run.ts';
5
6
  import type { Clock } from './clock.ts';
6
7
  import type { Cones } from './cone.ts';
7
8
  import { type GuestToolGate } from './guests/guard.ts';
@@ -29,6 +30,7 @@ export interface Agent extends Cones {
29
30
  readonly reviews: GuestReviews;
30
31
  readonly gate: GuestToolGate;
31
32
  readonly scoopReviews: ScoopReviews;
33
+ readonly sudoRuns: SudoRuns;
32
34
  readonly reports: Reports;
33
35
  readonly timings: Timings;
34
36
  onCone(listener: (conversation: Conversation) => void | Promise<void>): () => void;
@@ -2,16 +2,24 @@ import { type Context, type ReplicatedState } from '@earendil-works/chord';
2
2
  import { type Harness, type JsonObject } from '@earendil-works/pi-durable';
3
3
  import { type GuestPolicy, type GuestPolicyChange } from '../guests/policy.ts';
4
4
  import type { ApprovalKind } from './record.ts';
5
+ export type RunLatePolicy = {
6
+ maxAgeMinutes: number;
7
+ };
5
8
  export type SudoPolicy = {
6
9
  approver: 'user' | 'agent';
10
+ runLate: RunLatePolicy;
7
11
  };
8
12
  export type ApprovalPolicy = {
9
13
  guests: GuestPolicy;
10
14
  sudo: SudoPolicy;
11
15
  };
16
+ export type SudoPolicyChange = {
17
+ approver?: SudoPolicy['approver'];
18
+ runLate?: Partial<RunLatePolicy>;
19
+ };
12
20
  export type ApprovalPolicyChange = {
13
21
  guests?: GuestPolicyChange;
14
- sudo?: Partial<SudoPolicy>;
22
+ sudo?: SudoPolicyChange;
15
23
  };
16
24
  export type ApprovalPolicySet = {
17
25
  policy: ApprovalPolicy;
@@ -21,6 +29,7 @@ export type ApprovalPolicySet = {
21
29
  error: string;
22
30
  };
23
31
  export declare const DEFAULT_APPROVAL_POLICY: ApprovalPolicy;
32
+ export declare const MAX_RUN_LATE_MINUTES = 10080;
24
33
  type Overrides = Partial<Record<keyof ApprovalPolicy, JsonObject>>;
25
34
  export declare const ApprovalPolicyDoc: import("@earendil-works/pi-durable").SessionDocToken<{
26
35
  overrides: Overrides;
@@ -0,0 +1,3 @@
1
+ import { type ReplicatedState } from '@earendil-works/chord';
2
+ import type { Approval } from './record.ts';
3
+ export declare function publishedApprovals(state: ReplicatedState<Approval[]>, view: boolean): ReplicatedState<Approval[]>;
@@ -57,6 +57,44 @@ export type SudoDetail = {
57
57
  writable?: boolean;
58
58
  validate?: true;
59
59
  };
60
+ export type SudoFile = {
61
+ path: string;
62
+ sha256: string;
63
+ };
64
+ export type SudoReplay = {
65
+ id: string;
66
+ user: string;
67
+ uid?: number;
68
+ target?: string;
69
+ argv: string[];
70
+ path?: string;
71
+ cwd?: string;
72
+ stdin?: SudoStdin;
73
+ rootOnly?: Record<string, boolean>;
74
+ userWritable?: SudoFile[];
75
+ tag?: string;
76
+ tags?: string[];
77
+ validate?: boolean;
78
+ };
79
+ export type SudoRunState = 'starting' | 'running' | 'done' | 'failed' | 'stopped';
80
+ export type SudoRun = {
81
+ state: SudoRunState;
82
+ by: DecidedBy;
83
+ device?: string;
84
+ at: number;
85
+ pid?: number;
86
+ pgid?: number;
87
+ status?: number;
88
+ signal?: string;
89
+ endedAt?: number;
90
+ error?: string;
91
+ stdout?: string;
92
+ stderr?: string;
93
+ stopBy?: DecidedBy;
94
+ survivors?: number[];
95
+ capped?: number;
96
+ removed?: true;
97
+ };
60
98
  export type CaptureWhat = 'screen' | 'camera' | 'microphone';
61
99
  export type CaptureMode = 'still' | 'video' | 'audio';
62
100
  export type CaptureDetail = {
@@ -99,6 +137,8 @@ export type GuestToolApproval = Base & {
99
137
  export type SudoApproval = Base & {
100
138
  kind: 'sudo';
101
139
  detail: SudoDetail;
140
+ replay?: SudoReplay;
141
+ run?: SudoRun;
102
142
  };
103
143
  export type CaptureApproval = Base & {
104
144
  kind: 'capture';
@@ -111,7 +151,9 @@ type DraftOf<T extends Approval> = Pick<T, 'kind' | 'detail' | 'agentId' | 'requ
111
151
  always?: boolean;
112
152
  expiresAt?: number;
113
153
  };
114
- export type ApprovalDraft = DraftOf<GuestMessageApproval> | DraftOf<GuestToolApproval> | DraftOf<SudoApproval> | DraftOf<CaptureApproval>;
154
+ export type ApprovalDraft = DraftOf<GuestMessageApproval> | DraftOf<GuestToolApproval> | (DraftOf<SudoApproval> & {
155
+ replay?: SudoReplay;
156
+ }) | DraftOf<CaptureApproval>;
115
157
  export type ApprovalsState = {
116
158
  items: Approval[];
117
159
  };
@@ -140,6 +182,7 @@ export declare function route(verdict: ApprovalVerdict | undefined, requester: P
140
182
  export declare function alwaysOffered(item: Approval): boolean;
141
183
  export declare function gone(state: ApprovalState): string;
142
184
  export declare function cleanReason(reason: unknown): string | undefined;
185
+ export declare const runLive: (item: Approval) => boolean;
143
186
  export declare function prune(items: Approval[], kept?: number): Approval[];
144
187
  export type Settle = {
145
188
  state: Exclude<ApprovalState, 'pending'>;
@@ -0,0 +1,18 @@
1
+ import type { Harness } from '@earendil-works/pi-durable';
2
+ import { type AgentsState } from '../agents.ts';
3
+ import type { LickEvent } from '../licks/licks.ts';
4
+ import type { SudoApproval } from './record.ts';
5
+ export declare const KEEP_HOURS = 24;
6
+ export declare const MIB: number;
7
+ export type LickHost = {
8
+ harness: Pick<Harness, 'commit' | 'snapshot'>;
9
+ agents: {
10
+ state(): Readonly<AgentsState>;
11
+ };
12
+ now?: () => number;
13
+ };
14
+ export declare const sized: (bytes: number) => string;
15
+ export declare function clock(at: number, now: number): string;
16
+ export declare function duration(ms: number): string;
17
+ export declare function startLick(host: LickHost, item: SudoApproval): Promise<LickEvent>;
18
+ export declare function endLick(host: LickHost, item: SudoApproval): Promise<LickEvent>;
@@ -0,0 +1,40 @@
1
+ import type { KernelClient } from '../kernel/client.ts';
2
+ export type RunKernel = Pick<KernelClient, 'fs' | 'spawn' | 'ps' | 'kill' | 'sudoRun' | 'trace'>;
3
+ export type Exit = {
4
+ status?: number;
5
+ signal?: string;
6
+ };
7
+ export declare const RUN_TAG = "sudo-run:";
8
+ export declare const RUNS_DIR = ".slicc/sudo-runs";
9
+ export declare const GRACE_MS = 1000;
10
+ export declare const runTag: (id: string) => string;
11
+ type Row = NonNullable<Awaited<ReturnType<NonNullable<RunKernel['ps']>>>>[number];
12
+ export declare function uidOf(kernel: RunKernel, user: string): Promise<number | undefined>;
13
+ export declare function aborted(signal: AbortSignal | undefined): Promise<never>;
14
+ export declare function outputOf(kernel: RunKernel, user: string, id: string, signal?: AbortSignal): Promise<{
15
+ stdout: string;
16
+ stderr: string;
17
+ }>;
18
+ export declare function removeOutput(kernel: RunKernel, user: string, paths: string[]): Promise<void>;
19
+ export declare function outputSize(kernel: RunKernel, paths: string[]): Promise<number>;
20
+ export type Watcher = {
21
+ waitFor(pid: number): Promise<Exit>;
22
+ close(): void;
23
+ };
24
+ export declare function watchExits(kernel: RunKernel, tag: string): Promise<Watcher>;
25
+ export declare const sleep: (ms: number, signal?: AbortSignal) => Promise<void>;
26
+ export declare function gone(kernel: RunKernel, pid: number, ms: number, signal: AbortSignal): Promise<Exit>;
27
+ export declare function tagged(kernel: RunKernel, tag: string): Promise<Row[] | null>;
28
+ export type Signalled = 'sent' | 'none' | 'unknown';
29
+ export declare function signalTree(kernel: RunKernel, tag: string, killMs: number): Promise<Signalled>;
30
+ export declare function adoptable(kernel: RunKernel, tag: string, target: string): Promise<{
31
+ pid: number;
32
+ ppid?: number;
33
+ pgid?: number;
34
+ state?: string;
35
+ argv?: readonly string[];
36
+ uid?: number;
37
+ tag?: string;
38
+ tags?: readonly string[];
39
+ }>;
40
+ export {};
@@ -0,0 +1,60 @@
1
+ import type { Context } from '@earendil-works/chord';
2
+ import { type Extension, type Harness } from '@earendil-works/pi-durable';
3
+ import type { AgentsState } from '../agents.ts';
4
+ import type { Licks } from '../licks/licks.ts';
5
+ import { type DecidedBy } from './record.ts';
6
+ import { type RunKernel } from './run-procs.ts';
7
+ import { type RunGates } from './runnable.ts';
8
+ export { clock, duration, endLick, startLick } from './run-licks.ts';
9
+ export { outputOf, RUN_TAG, RUNS_DIR, type RunKernel, runTag } from './run-procs.ts';
10
+ export declare const SUDO_RUN_TASK = "slicc.sudo-run";
11
+ export declare const SUDO_RUNS = "slicc-sudo-runs";
12
+ export declare const POLL_MS = 5000;
13
+ export declare const KILL_MS = 5000;
14
+ export declare const ADOPT_MS = 250;
15
+ export declare const ADOPT_TRIES = 5;
16
+ export declare const OUTPUT_CAP: number;
17
+ export declare const KEEP_MS: number;
18
+ export declare const RUN_ERRORS: {
19
+ readonly interrupted: 'interrupted before it started';
20
+ readonly reloaded: 'the page reloaded while it ran';
21
+ readonly idle: "This request isn't running.";
22
+ readonly gone: 'Its processes are already gone.';
23
+ readonly unseen: "The kernel's process list isn't available, so it can't be stopped.";
24
+ };
25
+ export interface SudoRunHost {
26
+ kernel: RunKernel;
27
+ harness: Pick<Harness, 'commit' | 'snapshot'>;
28
+ agents: {
29
+ state(): Readonly<AgentsState>;
30
+ };
31
+ licks?: Pick<Licks, 'deliver'>;
32
+ boot: string | null;
33
+ server: string;
34
+ conversation: number;
35
+ now?: () => number;
36
+ pollMs?: number;
37
+ killMs?: number;
38
+ adoptMs?: number;
39
+ outputCap?: number;
40
+ keepMs?: number;
41
+ }
42
+ export type RunAnswer = {
43
+ done: true;
44
+ error: null;
45
+ } | {
46
+ done: false;
47
+ error: string;
48
+ };
49
+ export type Runner = {
50
+ by: DecidedBy;
51
+ device?: string;
52
+ };
53
+ export interface SudoRuns {
54
+ readonly extension: Extension;
55
+ bind(host: SudoRunHost): void;
56
+ claim(id: string, runner: Runner, gates: RunGates, context: Context): Promise<RunAnswer>;
57
+ stop(id: string, runner: Runner, context: Context): Promise<RunAnswer>;
58
+ }
59
+ export declare function messageOf(error: unknown): string;
60
+ export declare function sudoRuns(): SudoRuns;
@@ -0,0 +1,55 @@
1
+ import { type ReplicatedState } from '@earendil-works/chord';
2
+ import { type AgentsState } from '../agents.ts';
3
+ import type { LickTarget } from '../licks/lick.ts';
4
+ import { type Approval } from './record.ts';
5
+ export type Runnable = true | {
6
+ reason: string;
7
+ };
8
+ export type RunGates = {
9
+ maxAgeMinutes: number;
10
+ kernel: true | string;
11
+ frozen?: (agentId: string) => string | undefined;
12
+ gone?: (agentId: string) => boolean;
13
+ };
14
+ export declare const SUDO_RUN_PROTOCOL: readonly [number, number];
15
+ export declare const RUN_REASONS: {
16
+ readonly kind: 'Only a sudo request can run now.';
17
+ readonly open: 'This request is still open: answer it instead.';
18
+ readonly untimed: 'Only a request that timed out can run now.';
19
+ readonly running: 'This request is already running.';
20
+ readonly ran: 'This request already ran.';
21
+ readonly terminal: 'Run it again in the terminal.';
22
+ readonly validate: 'sudo -v has no command to run.';
23
+ readonly stdin: 'Its input is gone, so it must be asked again.';
24
+ readonly old: 'This request is from before Run now, so it must be asked again.';
25
+ readonly off: 'Run now is off in the approval policy.';
26
+ readonly gone: 'The agent that asked is gone, so it must be asked again.';
27
+ readonly kernel: `Needs slicc-kernel protocol ${string} or later.`;
28
+ };
29
+ export declare function tooOld(minutes: number): string;
30
+ export declare const thawFirst: (cone: string) => string;
31
+ export declare function runnable(item: Approval, now: number, gates: RunGates): Runnable;
32
+ export declare function runEnds(item: Approval, maxAgeMinutes: number): number | undefined;
33
+ export declare function agentTarget(state: Readonly<AgentsState>, agentId: string): LickTarget;
34
+ export declare const frozenOf: (state: () => Readonly<AgentsState>) => (agentId: string) => string | undefined;
35
+ export declare const goneOf: (state: () => Readonly<AgentsState>) => (agentId: string) => boolean;
36
+ type Protocol = {
37
+ protocol?: readonly number[];
38
+ sudoRun?: unknown;
39
+ };
40
+ export declare function kernelGate(client: Protocol | undefined): true | string;
41
+ type Watched = {
42
+ subscribe(listener: () => void): () => void;
43
+ };
44
+ export interface RunnableWatch {
45
+ readonly state: ReplicatedState<Record<string, Runnable>>;
46
+ refresh(): void;
47
+ dispose(): void;
48
+ }
49
+ export declare function watchRunnable(approvals: Watched & {
50
+ readonly value: readonly Approval[] | undefined;
51
+ }, changes: readonly Watched[], gates: () => RunGates, clock?: {
52
+ now?: () => number;
53
+ setTimer?: (callback: () => void, ms: number) => () => void;
54
+ }): RunnableWatch;
55
+ export {};
@@ -3,7 +3,7 @@ import type { AgentsState } from '../agents.ts';
3
3
  import type { AgentCapture } from '../guests/capture.ts';
4
4
  import type { Licks } from '../licks/licks.ts';
5
5
  import type { Approvals } from './index.ts';
6
- import { type Approval, type ApprovalRequester, type SudoDetail, type SudoStdin } from './record.ts';
6
+ import { type Approval, type ApprovalRequester, type SudoDetail, type SudoFile, type SudoReplay, type SudoStdin } from './record.ts';
7
7
  export type SudoAnswer = 'once' | 'always' | 'deny';
8
8
  export type SudoDenial = {
9
9
  answer: 'deny';
@@ -32,6 +32,7 @@ export interface SudoRequest {
32
32
  always?: boolean;
33
33
  stdin?: SudoStdin;
34
34
  rootOnly?: Record<string, boolean>;
35
+ userWritable?: SudoFile[];
35
36
  timestamp?: boolean;
36
37
  validate?: boolean;
37
38
  }
@@ -56,6 +57,7 @@ export declare function sudoRequester(request: SudoRequest, agents: Readonly<Age
56
57
  export declare const validating: (request: Pick<SudoRequest, 'validate'>) => boolean;
57
58
  export declare const timestampFor: (user: string) => string;
58
59
  export declare function sudoDetail(request: SudoRequest): SudoDetail;
60
+ export declare function sudoReplay(request: SudoRequest): SudoReplay;
59
61
  export interface SudoAttach {
60
62
  approvals: Approvals;
61
63
  capture: AgentCapture;
@@ -2,6 +2,7 @@ import { type Context, type Host, type ReplicatedState } from '@earendil-works/c
2
2
  import type { ConversationView } from '@earendil-works/pi-durable';
3
3
  import type { ApprovalPolicy } from './approvals/policy.ts';
4
4
  import type { Approval } from './approvals/record.ts';
5
+ import type { Runnable } from './approvals/runnable.ts';
5
6
  import type { ChangesView } from './changes/git.ts';
6
7
  import type { FrozenCone } from './freezer/index.ts';
7
8
  import type { ImportProgress } from './freezer/v6.ts';
@@ -39,6 +40,7 @@ export interface AgentConnection {
39
40
  readonly owner?: boolean;
40
41
  readonly approvals?: ReplicatedState<Approval[]>;
41
42
  readonly approvalPolicy?: ReplicatedState<ApprovalPolicy>;
43
+ readonly approvalRunnable?: ReplicatedState<Record<string, Runnable>>;
42
44
  readonly settings: AgentSettings;
43
45
  readonly remote?: AgentRemote;
44
46
  readonly history?: boolean;
@@ -2,6 +2,11 @@ export declare const GUEST_INPUT_KIND = "slicc.guest-input";
2
2
  export declare const ASKED_KIND = "slicc.guest-asked";
3
3
  export declare const ASKED_CLIP = 200;
4
4
  export declare const REVIEWED_KIND = "slicc.guest-reviewed";
5
+ export declare const TAINTED_KIND = "slicc.tainted";
6
+ export declare const GATED_KIND = "slicc.gated-call";
7
+ export type GatedCall = {
8
+ callId: string;
9
+ };
5
10
  export type GuestAsked = {
6
11
  seat: string;
7
12
  name: string;
@@ -27,7 +27,7 @@ export interface GuestToolGate {
27
27
  readonly extension: Extension;
28
28
  bind(host: GateHost): void;
29
29
  }
30
- type Held = Pick<Harness, 'submission' | 'commit' | 'waitForTask'>;
30
+ type Held = Pick<Harness, 'submission' | 'commit' | 'waitForTask' | 'snapshot'>;
31
31
  type Taint = {
32
32
  seat: SeatRecord | null;
33
33
  tier: string;
@@ -3,6 +3,7 @@ import type { ConversationView } from '@earendil-works/pi-durable';
3
3
  import type { Agent } from './agent.ts';
4
4
  import { type ApprovalJudge, type Approvals, type Attendance, type Decider } from './approvals/index.ts';
5
5
  import { type ApprovalPolicies } from './approvals/policy.ts';
6
+ import type { RunKernel, Runner, SudoRunHost } from './approvals/run.ts';
6
7
  import { type AgentSudo } from './approvals/sudo.ts';
7
8
  import type { ChangesRuntime } from './changes/index.ts';
8
9
  import { type HostLicks, type HostScoops } from './control.ts';
@@ -95,13 +96,21 @@ export type HostOptions = {
95
96
  uploads?: Uploads;
96
97
  thumbnail?: Thumbnail;
97
98
  labels?: LabelsRuntime;
99
+ runs?: {
100
+ kernel: RunKernel & {
101
+ protocol?: readonly number[];
102
+ };
103
+ boot: string | null;
104
+ } & RunTimes;
98
105
  } & ApprovalOptions;
106
+ export type RunTimes = Partial<Pick<SudoRunHost, 'pollMs' | 'killMs' | 'adoptMs' | 'outputCap' | 'keepMs'>>;
99
107
  export declare function hostAgent(agent: Agent, options?: HostOptions): Promise<AgentHost>;
100
108
  interface Served {
101
109
  trusted: AgentControl;
102
110
  viewed: () => AgentControl;
103
111
  transcript: Record<keyof AgentTranscript, ReplicatedState<unknown>>;
104
112
  viewMonitor: ReplicatedState<unknown>;
113
+ viewApprovals: ReplicatedState<unknown>;
105
114
  sudo?: AgentSudo;
106
115
  settings: AgentSettings;
107
116
  remote: AgentRemote;
@@ -112,6 +121,7 @@ interface Served {
112
121
  dispose(): void;
113
122
  } | undefined;
114
123
  decide: (by: Decider) => AgentControl['decide'];
124
+ runs: (runner: Runner) => Pick<AgentControl, 'approvalRun' | 'approvalRunStop'>;
115
125
  owners?: Attendance;
116
126
  }
117
127
  export declare const CLOSED_TO_GUESTS = "a guest seat has only its transcript and propose";
@@ -1,7 +1,10 @@
1
1
  export { ADOBE, ADOBE_PROXY, type AdobeConfig, type AdobeModelInfo, adobeClassifiers, adobeConfig, adobeIdentity, adobeModel, adobeProvider, adobeUsage, type Budget, SESSION_HEADER, VERSION_HEADER, withAdobeIdentity, } from './adobe.ts';
2
2
  export { type Agent, type AgentOptions, answerText, openAgent } from './agent.ts';
3
3
  export { APPROVAL_MS, type Approval, type ApprovalAnswer, type ApprovalDecided, type ApprovalDecision, type ApprovalDraft, type ApprovalJudge, type ApprovalKind, type ApprovalRequester, type ApprovalState, type Approvals, ApprovalsDoc, type ApprovalTier, type ApprovalVerdict, ASK_MIN_MS, approvalJudge, attachApprovals, type CaptureApproval, type CaptureDetail, DEFAULT_POLICY, type DecidedBy, type Decider, JUDGE_ALLOW, JUDGE_KIND, JUDGE_MODEL, JUDGE_QUESTIONS, type Judgement, judgeModelOf, judgeSpender, judgeState, type OwnerIntent, ownerIntent, POLICY_FILE, REASONS, route, seedPolicy, VERDICT_REASONS, verdictOf, verdictRecorder, } from './approvals/index.ts';
4
- export { type ApprovalPolicy, type ApprovalPolicyChange, type ApprovalPolicySet, DEFAULT_APPROVAL_POLICY, type SudoPolicy, } from './approvals/policy.ts';
4
+ export { type ApprovalPolicy, type ApprovalPolicyChange, type ApprovalPolicySet, DEFAULT_APPROVAL_POLICY, type RunLatePolicy, type SudoPolicy, type SudoPolicyChange, } from './approvals/policy.ts';
5
+ export type { SudoFile, SudoReplay, SudoRun, SudoRunState } from './approvals/record.ts';
6
+ export { RUN_ERRORS, type RunAnswer, SUDO_RUN_TASK, } from './approvals/run.ts';
7
+ export { RUN_REASONS, type RunGates, type Runnable, runnable, SUDO_RUN_PROTOCOL, } from './approvals/runnable.ts';
5
8
  export type { AgentSudo, SudoAnswer, SudoDenial, SudoReply, SudoRequest, SudoTimestamp, } from './approvals/sudo.ts';
6
9
  export type { CaptureAsk } from './approvals/sudo-client.ts';
7
10
  export { FILE_LIMIT, IMAGE_LIMIT, type SendAttachment, type ShownAttachment, splitUser, TOTAL_LIMIT, userParts, } from './attachments.ts';
@@ -0,0 +1,7 @@
1
+ import { type Extension, type JsonObject, type ToolRegistration } from '@earendil-works/pi-durable';
2
+ export declare const INTENTS = "slicc-intents";
3
+ export declare const INTENT_ENV = "SLICC_INTENT";
4
+ export declare const INTENT_DESCRIPTION = "What this call does, as 2\u20136 words starting with a present participle, in the user's language, such as \"Backing up the dataset's access list\". At most 80 characters; a longer one is cut. No credentials, secrets or command output.";
5
+ export declare function withIntent(parameters: object): object;
6
+ export declare function inherited(name: string, args: JsonObject, intent: string): JsonObject;
7
+ export declare function intentExtension(tools: readonly ToolRegistration[], on?: boolean): Extension;
@@ -0,0 +1,4 @@
1
+ export declare const INTENT_TOOLS: ReadonlySet<string>;
2
+ export declare function intentOf(name: string, args: unknown): string;
3
+ export declare function withoutIntent<T extends object>(name: string, args: T): T;
4
+ export declare function withoutIntents<T>(content: T): T;