@ai-ecoverse/slicc-agent 7.18.4 → 7.19.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.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/licks/licks.ts"],
4
- "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport {\n type Conversation,\n defineDoc,\n type Harness,\n type SubmissionId,\n} from '@earendil-works/pi-durable';\nimport { boundedDeltas } from '../checkpoints.ts';\nimport { distinctTaints, type InheritedTaint, LickTaintDoc } from '../guests/guard.ts';\nimport { scrubTexts } from '../secrets/scrub.ts';\nimport {\n clip,\n formatLick,\n type Lick,\n type LickAction,\n type LickChannel,\n type LickSeverity,\n type LickTarget,\n lickId,\n} from './lick.ts';\nimport { entryLick, LICK_STATE_KIND, type LickDecision, lickDecisions } from './state.ts';\nimport { skipEntry, skips, type Triage, type Verdict } from './triage.ts';\n\nexport interface LickEvent {\n channel: LickChannel;\n source: string;\n title: string;\n text: string;\n body?: string;\n items?: string[];\n count?: number;\n target: LickTarget;\n coalesce?: boolean;\n severity?: LickSeverity;\n eventId?: string;\n at?: number;\n triage?: string;\n summary?: string;\n report?: string;\n taints?: readonly InheritedTaint[];\n}\n\nfunction card(event: LickEvent): Pick<Lick, 'summary' | 'report'> {\n return {\n ...(event.summary ? { summary: event.summary } : {}),\n ...(event.report ? { report: event.report } : {}),\n };\n}\n\ntype Pending = {\n lick: Lick;\n items: string[];\n body: string | null;\n taints?: InheritedTaint[];\n};\n\nfunction tainted(taints: readonly InheritedTaint[]): Pick<Pending, 'taints'> {\n return taints.length ? { taints: distinctTaints(taints) } : {};\n}\n\ntype Queue = {\n submission: number | null;\n pending: Pending | null;\n};\n\ntype OutboxState = {\n queues: Record<string, Queue>;\n events: Record<string, string[]>;\n};\n\nexport const LicksOutbox = defineDoc<OutboxState>({\n kind: 'slicc.licks',\n checkpointWhen: boundedDeltas,\n version: 1,\n scope: 'session',\n initial: () => ({ queues: {}, events: {} }),\n});\n\nexport interface LickHandler {\n confirm?(lick: Lick, reason: string | undefined, context: Context): Promise<string | undefined>;\n dismiss?(lick: Lick, reason: string | undefined, context: Context): Promise<string | undefined>;\n}\n\nexport interface LickFound {\n lick: Lick;\n decision: LickDecision | undefined;\n}\n\nexport interface Licks {\n deliver(event: LickEvent, context: Context): Promise<void>;\n flush(context: Context): Promise<void>;\n find(conversation: Conversation, id: string, context: Context): Promise<LickFound | undefined>;\n decide(\n conversation: Conversation,\n id: string,\n action: LickAction,\n reason: string | undefined,\n context: Context\n ): Promise<string>;\n handle(channel: LickChannel, handler: LickHandler): void;\n pending(context: Context): Promise<number>;\n forget(target: LickTarget, channel: LickChannel, source: string, context: Context): Promise<void>;\n guard(check: (target: LickTarget) => Blocked | undefined): void;\n triage(judge: Triage): void;\n}\n\nexport type Blocked = { id: string; name: string; at: number };\n\nexport function frozenNotice(event: LickEvent, blocked: Blocked): LickEvent {\n return {\n channel: event.channel,\n source: `frozen:${event.source}`,\n title: `${blocked.name} is frozen`,\n text: `${event.title} was skipped`,\n body: `${event.target} belongs to ${blocked.name}, which is frozen (${blocked.id}). Thaw it in the Freezer to get its licks again.`,\n target: 'cone',\n severity: 'warn',\n eventId: `${blocked.id}|${event.target}|${event.channel}|${event.source}|${blocked.at}`,\n ...(event.taints ? { taints: event.taints } : {}),\n };\n}\n\nexport interface LicksHost {\n harness: Harness;\n resolve(target: LickTarget, channel: LickChannel, context: Context): Promise<Conversation>;\n runnable?(conversation: Conversation, context: Context): Promise<boolean>;\n}\n\nexport const MAX_ITEMS = 50;\nexport const MAX_EVENTS = 64;\n\nexport function render(pending: Pending): Lick {\n const shown = pending.items.slice(0, MAX_ITEMS);\n const more = pending.items.length - shown.length;\n const lines = [\n ...(pending.body ? [pending.body] : []),\n ...shown,\n ...(more > 0 ? [`\u2026 and ${more} more`] : []),\n ];\n const { body: _, ...lick } = pending.lick;\n return lines.length ? { ...lick, body: lines.join('\\n') } : lick;\n}\n\nconst RANK: Record<LickSeverity, number> = { warn: 1, error: 2 };\n\nexport function strongest(\n a: LickSeverity | undefined,\n b: LickSeverity | undefined\n): LickSeverity | undefined {\n if (!a) return b;\n if (!b) return a;\n return RANK[b] > RANK[a] ? b : a;\n}\n\nfunction merge(pending: Pending, event: LickEvent, now: number): Pending {\n const items = [...pending.items];\n for (const item of event.items ?? []) if (!items.includes(item)) items.push(item);\n const { severity: _, summary: __, report: ___, ...lick } = pending.lick;\n const severity = strongest(pending.lick.severity, event.severity);\n const taints = tainted([...(pending.taints ?? []), ...(event.taints ?? [])]);\n return {\n lick: {\n ...lick,\n title: event.title,\n text: event.text,\n count: pending.lick.count + (event.count ?? 1),\n at: event.at ?? now,\n ...(severity ? { severity } : {}),\n ...card(event),\n },\n items,\n body: event.body ?? pending.body,\n ...taints,\n };\n}\n\nfunction fresh(event: LickEvent, now: number, listed: LickAction[] | undefined): Pending {\n return {\n lick: {\n id: lickId(),\n channel: event.channel,\n source: event.source,\n title: event.title,\n text: event.text,\n count: event.count ?? 1,\n at: now,\n ...(listed ? { actions: listed } : {}),\n ...(event.severity ? { severity: event.severity } : {}),\n ...card(event),\n },\n items: [...new Set(event.items ?? [])],\n body: event.body ?? null,\n ...tainted(event.taints ?? []),\n };\n}\n\nfunction keyOf(event: LickEvent): string {\n const base = `${event.target}|${event.channel}|${event.source}`;\n return event.coalesce === false ? `${base}|${event.eventId ?? lickId()}` : base;\n}\n\nexport async function scrubbedLick(event: LickEvent): Promise<LickEvent> {\n const fields = (['title', 'text', 'body', 'triage', 'summary', 'report'] as const).filter(\n (key) => event[key] !== undefined\n );\n const items = event.items ?? [];\n const scrubbed = await scrubTexts([...fields.map((key) => event[key] as string), ...items]);\n const out: LickEvent = { ...event };\n fields.forEach((key, at) => {\n out[key] = scrubbed[at] as string;\n });\n if (event.items) out.items = scrubbed.slice(fields.length);\n if (out.summary !== undefined) out.summary = clip(out.summary);\n return out;\n}\n\nasync function marked(harness: Harness, pending: Pending, id: string, context: Context) {\n const taints = pending.taints;\n if (!taints) return;\n await harness.commit(async (tx) => {\n (await tx.doc(LickTaintDoc)).licks[id] = taints;\n }, context);\n}\n\nexport function createLicks(host: Promise<LicksHost>): Licks {\n const handlers = new Map<LickChannel, LickHandler>();\n let lock: Promise<unknown> = Promise.resolve();\n const serial = <T>(operation: () => Promise<T>): Promise<T> => {\n const run = lock.then(operation, operation);\n lock = run.catch(() => undefined);\n return run;\n };\n\n const actions = (channel: LickChannel): LickAction[] | undefined => {\n const handler = handlers.get(channel);\n const list: LickAction[] = [];\n if (handler?.confirm) list.push('confirm');\n if (handler?.dismiss) list.push('dismiss');\n return list.length ? list : undefined;\n };\n\n async function previous(\n harness: Harness,\n id: number | null,\n context: Context\n ): Promise<'queued' | 'withdrawn' | 'gone'> {\n if (id === null) return 'gone';\n const submission = await harness.submission(id as SubmissionId, context);\n const record = await submission?.status(context);\n if (record?.status === 'queued') return 'queued';\n return record?.status === 'unanswered' && record.reason === 'aborted' ? 'withdrawn' : 'gone';\n }\n\n async function settled(key: string, context: Context): Promise<Queue | undefined> {\n const { harness } = await host;\n const queue = (await harness.snapshot(LicksOutbox, context))?.queues[key];\n if (!queue) return undefined;\n const before = await previous(harness, queue.submission, context);\n if (before === 'queued') return undefined;\n if (queue.pending && before === 'gone') return queue;\n await harness.commit(async (tx) => {\n const doc = await tx.doc(LicksOutbox);\n if (doc.queues[key]?.submission === queue.submission) delete doc.queues[key];\n }, context);\n return undefined;\n }\n\n async function flushKey(key: string, context: Context): Promise<void> {\n const { harness, resolve, runnable } = await host;\n const queue = await settled(key, context);\n if (!queue?.pending) return;\n const lick = render(queue.pending);\n const target = key.split('|')[0] as LickTarget;\n const conversation = await resolve(target, queue.pending.lick.channel, context);\n if (runnable && !(await runnable(conversation, context))) return;\n await marked(harness, queue.pending, lick.id, context);\n const submission = await conversation.submit(\n {\n type: 'input',\n content: formatLick(lick),\n whenBusy: 'steer',\n requestId: `lick:${lick.id}`,\n },\n context\n );\n await harness.commit(async (tx) => {\n const doc = await tx.doc(LicksOutbox);\n doc.queues[key] = { submission: submission.id, pending: null };\n }, context);\n }\n\n async function flushAll(context: Context): Promise<void> {\n const { harness } = await host;\n const keys = Object.keys((await harness.snapshot(LicksOutbox, context))?.queues ?? {});\n for (const key of keys) await flushKey(key, context);\n }\n\n async function find(\n conversation: Conversation,\n id: string,\n context: Context\n ): Promise<LickFound | undefined> {\n const { entries } = await conversation.context(context);\n const lick = entries.map(entryLick).find((candidate) => candidate?.id === id);\n if (!lick) return undefined;\n return { lick, decision: lickDecisions(entries).get(id) };\n }\n\n async function judged(event: LickEvent, context: Context): Promise<Verdict | undefined> {\n if (!judge || !event.triage) return undefined;\n return judge(event, context).catch(() => undefined);\n }\n\n async function seenBefore(event: LickEvent, context: Context): Promise<boolean> {\n if (event.eventId === undefined) return false;\n const { harness } = await host;\n const events = (await harness.snapshot(LicksOutbox, context))?.events ?? {};\n return (events[`${event.channel}|${event.source}`] ?? []).includes(event.eventId);\n }\n\n async function record(event: LickEvent, verdict: Verdict, now: number, context: Context) {\n const conversation = await (await host).resolve(event.target, event.channel, context);\n await conversation.submit(skipEntry(event, verdict, now), context);\n }\n\n let check: ((target: LickTarget) => Blocked | undefined) | undefined;\n let judge: Triage | undefined;\n return {\n guard(next) {\n check = next;\n },\n triage(next) {\n judge = next;\n },\n async deliver(raw, context) {\n const incoming = await scrubbedLick(raw);\n const blocked = check?.(incoming.target);\n const event = blocked ? frozenNotice(incoming, blocked) : incoming;\n if (judge && event.triage && (await seenBefore(event, context))) return;\n const verdict = await judged(event, context);\n const skipped = skips(verdict);\n return serial(async () => {\n const { harness } = await host;\n const key = keyOf(event);\n await settled(key, context);\n const stream = `${event.channel}|${event.source}`;\n const now = event.at ?? Date.now();\n if (skipped) {\n if (await seenBefore(event, context)) return;\n await record(event, verdict, now, context);\n }\n const accepted = await harness.commit(async (tx) => {\n const doc = await tx.doc(LicksOutbox);\n const seen = doc.events[stream] ?? [];\n if (event.eventId !== undefined) {\n if (seen.includes(event.eventId)) return false;\n doc.events[stream] = [...seen, event.eventId].slice(-MAX_EVENTS);\n }\n if (skipped) return false;\n const queue = doc.queues[key] ?? { submission: null, pending: null };\n queue.pending = queue.pending\n ? merge(queue.pending, event, now)\n : fresh(event, now, actions(event.channel));\n doc.queues[key] = queue;\n return true;\n }, context);\n if (accepted) await flushKey(key, context);\n });\n },\n flush: (context) => serial(() => flushAll(context)),\n find,\n async decide(conversation, id, action, reason, context) {\n const found = await find(conversation, id, context);\n if (!found) throw new Error(`There is no lick ${id} in this conversation.`);\n if (found.decision) throw new Error(`Lick ${id} is already ${found.decision}.`);\n if (!found.lick.actions?.includes(action))\n throw new Error(`Lick ${id} (${found.lick.channel}) has no ${action} action.`);\n const run = handlers.get(found.lick.channel)?.[action];\n if (!run) throw new Error(`Lick ${id} (${found.lick.channel}) has no ${action} action.`);\n return (await run(found.lick, reason, context)) ?? `Lick ${id} ${action}ed.`;\n },\n handle(channel, handler) {\n handlers.set(channel, handler);\n },\n forget(target, channel, source, context) {\n return serial(async () => {\n const { harness } = await host;\n const key = `${target}|${channel}|${source}`;\n await harness.commit(async (tx) => {\n const doc = await tx.doc(LicksOutbox);\n const queue = doc.queues[key];\n if (queue?.pending) queue.pending = null;\n }, context);\n });\n },\n async pending(context) {\n const { harness } = await host;\n const queues = (await harness.snapshot(LicksOutbox, context))?.queues ?? {};\n return Object.values(queues).filter((queue) => queue.submission !== null || queue.pending)\n .length;\n },\n };\n}\n\nexport { LICK_STATE_KIND };\n"],
5
- "mappings": "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",
6
- "names": ["record"]
4
+ "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport {\n type Conversation,\n defineDoc,\n type Harness,\n type SubmissionId,\n} from '@earendil-works/pi-durable';\nimport { boundedDeltas } from '../checkpoints.ts';\nimport { distinctTaints, type InheritedTaint, LickTaintDoc } from '../guests/guard.ts';\nimport { scrubTexts } from '../secrets/scrub.ts';\nimport {\n clip,\n formatLick,\n type Lick,\n type LickAction,\n type LickChannel,\n type LickSeverity,\n type LickTarget,\n lickId,\n} from './lick.ts';\nimport { entryLick, LICK_STATE_KIND, type LickDecision, lickDecisions } from './state.ts';\nimport { skipEntry, skips, type Triage, type Verdict } from './triage.ts';\n\nexport interface LickEvent {\n channel: LickChannel;\n source: string;\n title: string;\n text: string;\n body?: string;\n items?: string[];\n count?: number;\n target: LickTarget;\n coalesce?: boolean;\n severity?: LickSeverity;\n eventId?: string;\n at?: number;\n triage?: string;\n summary?: string;\n report?: string;\n taints?: readonly InheritedTaint[];\n followUp?: boolean;\n}\n\nfunction card(event: LickEvent): Pick<Lick, 'summary' | 'report'> {\n return {\n ...(event.summary ? { summary: event.summary } : {}),\n ...(event.report ? { report: event.report } : {}),\n };\n}\n\ntype Pending = {\n lick: Lick;\n items: string[];\n body: string | null;\n taints?: InheritedTaint[];\n followUp?: boolean;\n};\n\nfunction tainted(taints: readonly InheritedTaint[]): Pick<Pending, 'taints'> {\n return taints.length ? { taints: distinctTaints(taints) } : {};\n}\n\ntype Queue = {\n submission: number | null;\n pending: Pending | null;\n};\n\ntype OutboxState = {\n queues: Record<string, Queue>;\n events: Record<string, string[]>;\n};\n\nexport const LicksOutbox = defineDoc<OutboxState>({\n kind: 'slicc.licks',\n checkpointWhen: boundedDeltas,\n version: 1,\n scope: 'session',\n initial: () => ({ queues: {}, events: {} }),\n});\n\nexport interface LickHandler {\n confirm?(lick: Lick, reason: string | undefined, context: Context): Promise<string | undefined>;\n dismiss?(lick: Lick, reason: string | undefined, context: Context): Promise<string | undefined>;\n}\n\nexport interface LickFound {\n lick: Lick;\n decision: LickDecision | undefined;\n}\n\nexport interface Licks {\n deliver(event: LickEvent, context: Context): Promise<void>;\n flush(context: Context): Promise<void>;\n find(conversation: Conversation, id: string, context: Context): Promise<LickFound | undefined>;\n decide(\n conversation: Conversation,\n id: string,\n action: LickAction,\n reason: string | undefined,\n context: Context\n ): Promise<string>;\n handle(channel: LickChannel, handler: LickHandler): void;\n pending(context: Context): Promise<number>;\n forget(target: LickTarget, channel: LickChannel, source: string, context: Context): Promise<void>;\n waiting(\n target: LickTarget,\n channel: LickChannel,\n source: string,\n context: Context\n ): Promise<number>;\n guard(check: (target: LickTarget) => Blocked | undefined): void;\n triage(judge: Triage): void;\n}\n\nexport type Blocked = { id: string; name: string; at: number };\n\nexport function frozenNotice(event: LickEvent, blocked: Blocked): LickEvent {\n return {\n channel: event.channel,\n source: `frozen:${event.source}`,\n title: `${blocked.name} is frozen`,\n text: `${event.title} was skipped`,\n body: `${event.target} belongs to ${blocked.name}, which is frozen (${blocked.id}). Thaw it in the Freezer to get its licks again.`,\n target: 'cone',\n severity: 'warn',\n eventId: `${blocked.id}|${event.target}|${event.channel}|${event.source}|${blocked.at}`,\n ...(event.taints ? { taints: event.taints } : {}),\n };\n}\n\nexport interface LicksHost {\n harness: Harness;\n resolve(target: LickTarget, channel: LickChannel, context: Context): Promise<Conversation>;\n runnable?(conversation: Conversation, context: Context): Promise<boolean>;\n}\n\nexport const MAX_ITEMS = 50;\nexport const MAX_EVENTS = 64;\n\nexport function render(pending: Pending): Lick {\n const shown = pending.items.slice(0, MAX_ITEMS);\n const more = pending.items.length - shown.length;\n const lines = [\n ...(pending.body ? [pending.body] : []),\n ...shown,\n ...(more > 0 ? [`\u2026 and ${more} more`] : []),\n ];\n const { body: _, ...lick } = pending.lick;\n return lines.length ? { ...lick, body: lines.join('\\n') } : lick;\n}\n\nconst RANK: Record<LickSeverity, number> = { warn: 1, error: 2 };\n\nexport function strongest(\n a: LickSeverity | undefined,\n b: LickSeverity | undefined\n): LickSeverity | undefined {\n if (!a) return b;\n if (!b) return a;\n return RANK[b] > RANK[a] ? b : a;\n}\n\nfunction merge(pending: Pending, event: LickEvent, now: number): Pending {\n const items = [...pending.items];\n for (const item of event.items ?? []) if (!items.includes(item)) items.push(item);\n const { severity: _, summary: __, report: ___, ...lick } = pending.lick;\n const severity = strongest(pending.lick.severity, event.severity);\n const taints = tainted([...(pending.taints ?? []), ...(event.taints ?? [])]);\n return {\n lick: {\n ...lick,\n title: event.title,\n text: event.text,\n count: pending.lick.count + (event.count ?? 1),\n at: event.at ?? now,\n ...(severity ? { severity } : {}),\n ...card(event),\n },\n items,\n body: event.body ?? pending.body,\n ...taints,\n };\n}\n\nfunction fresh(event: LickEvent, now: number, listed: LickAction[] | undefined): Pending {\n return {\n lick: {\n id: lickId(),\n channel: event.channel,\n source: event.source,\n title: event.title,\n text: event.text,\n count: event.count ?? 1,\n at: now,\n ...(listed ? { actions: listed } : {}),\n ...(event.severity ? { severity: event.severity } : {}),\n ...card(event),\n },\n items: [...new Set(event.items ?? [])],\n body: event.body ?? null,\n ...tainted(event.taints ?? []),\n ...(event.followUp ? { followUp: true } : {}),\n };\n}\n\nfunction keyOf(event: LickEvent): string {\n const base = `${event.target}|${event.channel}|${event.source}`;\n return event.coalesce === false ? `${base}|${event.eventId ?? lickId()}` : base;\n}\n\nexport async function scrubbedLick(event: LickEvent): Promise<LickEvent> {\n const fields = (['title', 'text', 'body', 'triage', 'summary', 'report'] as const).filter(\n (key) => event[key] !== undefined\n );\n const items = event.items ?? [];\n const scrubbed = await scrubTexts([...fields.map((key) => event[key] as string), ...items]);\n const out: LickEvent = { ...event };\n fields.forEach((key, at) => {\n out[key] = scrubbed[at] as string;\n });\n if (event.items) out.items = scrubbed.slice(fields.length);\n if (out.summary !== undefined) out.summary = clip(out.summary);\n return out;\n}\n\nasync function marked(harness: Harness, pending: Pending, id: string, context: Context) {\n const taints = pending.taints;\n if (!taints) return;\n await harness.commit(async (tx) => {\n (await tx.doc(LickTaintDoc)).licks[id] = taints;\n }, context);\n}\n\nasync function previous(\n harness: Harness,\n id: number | null,\n context: Context\n): Promise<'queued' | 'withdrawn' | 'gone'> {\n if (id === null) return 'gone';\n const submission = await harness.submission(id as SubmissionId, context);\n const record = await submission?.status(context);\n if (record?.status === 'queued') return 'queued';\n return record?.status === 'unanswered' && record.reason === 'aborted' ? 'withdrawn' : 'gone';\n}\n\nasync function countWaiting(\n harness: Harness,\n prefix: string,\n settle: (key: string, context: Context) => Promise<unknown>,\n context: Context\n): Promise<number> {\n const keys = async () =>\n Object.keys((await harness.snapshot(LicksOutbox, context))?.queues ?? {}).filter((key) =>\n key.startsWith(prefix)\n );\n for (const key of await keys()) await settle(key, context);\n return (await keys()).length;\n}\n\nexport function createLicks(host: Promise<LicksHost>): Licks {\n const handlers = new Map<LickChannel, LickHandler>();\n let lock: Promise<unknown> = Promise.resolve();\n const serial = <T>(operation: () => Promise<T>): Promise<T> => {\n const run = lock.then(operation, operation);\n lock = run.catch(() => undefined);\n return run;\n };\n\n const actions = (channel: LickChannel): LickAction[] | undefined => {\n const handler = handlers.get(channel);\n const list: LickAction[] = [];\n if (handler?.confirm) list.push('confirm');\n if (handler?.dismiss) list.push('dismiss');\n return list.length ? list : undefined;\n };\n\n async function settled(key: string, context: Context): Promise<Queue | undefined> {\n const { harness } = await host;\n const queue = (await harness.snapshot(LicksOutbox, context))?.queues[key];\n if (!queue) return undefined;\n const before = await previous(harness, queue.submission, context);\n if (before === 'queued') return undefined;\n if (queue.pending && before === 'gone') return queue;\n await harness.commit(async (tx) => {\n const doc = await tx.doc(LicksOutbox);\n if (doc.queues[key]?.submission === queue.submission) delete doc.queues[key];\n }, context);\n return undefined;\n }\n\n async function flushKey(key: string, context: Context): Promise<void> {\n const { harness, resolve, runnable } = await host;\n const queue = await settled(key, context);\n if (!queue?.pending) return;\n const lick = render(queue.pending);\n const target = key.split('|')[0] as LickTarget;\n const conversation = await resolve(target, queue.pending.lick.channel, context);\n if (runnable && !(await runnable(conversation, context))) return;\n await marked(harness, queue.pending, lick.id, context);\n const submission = await conversation.submit(\n {\n type: 'input',\n content: formatLick(lick),\n whenBusy: queue.pending.followUp ? 'followUp' : 'steer',\n requestId: `lick:${lick.id}`,\n },\n context\n );\n await harness.commit(async (tx) => {\n const doc = await tx.doc(LicksOutbox);\n doc.queues[key] = { submission: submission.id, pending: null };\n }, context);\n }\n\n async function flushAll(context: Context): Promise<void> {\n const { harness } = await host;\n const keys = Object.keys((await harness.snapshot(LicksOutbox, context))?.queues ?? {});\n for (const key of keys) await flushKey(key, context);\n }\n\n async function find(\n conversation: Conversation,\n id: string,\n context: Context\n ): Promise<LickFound | undefined> {\n const { entries } = await conversation.context(context);\n const lick = entries.map(entryLick).find((candidate) => candidate?.id === id);\n if (!lick) return undefined;\n return { lick, decision: lickDecisions(entries).get(id) };\n }\n\n async function judged(event: LickEvent, context: Context): Promise<Verdict | undefined> {\n if (!judge || !event.triage) return undefined;\n return judge(event, context).catch(() => undefined);\n }\n\n async function seenBefore(event: LickEvent, context: Context): Promise<boolean> {\n if (event.eventId === undefined) return false;\n const { harness } = await host;\n const events = (await harness.snapshot(LicksOutbox, context))?.events ?? {};\n return (events[`${event.channel}|${event.source}`] ?? []).includes(event.eventId);\n }\n\n async function record(event: LickEvent, verdict: Verdict, now: number, context: Context) {\n const conversation = await (await host).resolve(event.target, event.channel, context);\n await conversation.submit(skipEntry(event, verdict, now), context);\n }\n\n let check: ((target: LickTarget) => Blocked | undefined) | undefined;\n let judge: Triage | undefined;\n return {\n guard(next) {\n check = next;\n },\n triage(next) {\n judge = next;\n },\n async deliver(raw, context) {\n const incoming = await scrubbedLick(raw);\n const blocked = check?.(incoming.target);\n const event = blocked ? frozenNotice(incoming, blocked) : incoming;\n if (judge && event.triage && (await seenBefore(event, context))) return;\n const verdict = await judged(event, context);\n const skipped = skips(verdict);\n return serial(async () => {\n const { harness } = await host;\n const key = keyOf(event);\n await settled(key, context);\n const stream = `${event.channel}|${event.source}`;\n const now = event.at ?? Date.now();\n if (skipped) {\n if (await seenBefore(event, context)) return;\n await record(event, verdict, now, context);\n }\n const accepted = await harness.commit(async (tx) => {\n const doc = await tx.doc(LicksOutbox);\n const seen = doc.events[stream] ?? [];\n if (event.eventId !== undefined) {\n if (seen.includes(event.eventId)) return false;\n doc.events[stream] = [...seen, event.eventId].slice(-MAX_EVENTS);\n }\n if (skipped) return false;\n const queue = doc.queues[key] ?? { submission: null, pending: null };\n queue.pending = queue.pending\n ? merge(queue.pending, event, now)\n : fresh(event, now, actions(event.channel));\n doc.queues[key] = queue;\n return true;\n }, context);\n if (accepted) await flushKey(key, context);\n });\n },\n flush: (context) => serial(() => flushAll(context)),\n find,\n async decide(conversation, id, action, reason, context) {\n const found = await find(conversation, id, context);\n if (!found) throw new Error(`There is no lick ${id} in this conversation.`);\n if (found.decision) throw new Error(`Lick ${id} is already ${found.decision}.`);\n if (!found.lick.actions?.includes(action))\n throw new Error(`Lick ${id} (${found.lick.channel}) has no ${action} action.`);\n const run = handlers.get(found.lick.channel)?.[action];\n if (!run) throw new Error(`Lick ${id} (${found.lick.channel}) has no ${action} action.`);\n return (await run(found.lick, reason, context)) ?? `Lick ${id} ${action}ed.`;\n },\n handle(channel, handler) {\n handlers.set(channel, handler);\n },\n forget(target, channel, source, context) {\n return serial(async () => {\n const { harness } = await host;\n const key = `${target}|${channel}|${source}`;\n await harness.commit(async (tx) => {\n const doc = await tx.doc(LicksOutbox);\n const queue = doc.queues[key];\n if (queue?.pending) queue.pending = null;\n }, context);\n });\n },\n waiting: (target, channel, source, context) =>\n serial(async () =>\n countWaiting((await host).harness, `${target}|${channel}|${source}|`, settled, context)\n ),\n async pending(context) {\n const { harness } = await host;\n const queues = (await harness.snapshot(LicksOutbox, context))?.queues ?? {};\n return Object.values(queues).filter((queue) => queue.submission !== null || queue.pending)\n .length;\n },\n };\n}\n\nexport { LICK_STATE_KIND };\n"],
5
+ "mappings": "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",
6
+ "names": []
7
7
  }
@@ -10,6 +10,20 @@ import { LICK_CHANNELS } from "../licks/lick.js";
10
10
  import { scopedName } from "../licks/sources.js";
11
11
  import { findRole } from "../roles/roles.js";
12
12
  import { sprinklesOf } from "../sprinkles/cgi.js";
13
+ import {
14
+ addressOf,
15
+ coneLabel,
16
+ crowded,
17
+ describe,
18
+ findCone,
19
+ MESSAGE_CHANNEL,
20
+ printable,
21
+ reachOf,
22
+ reachText,
23
+ readTables,
24
+ refusal,
25
+ tooLong
26
+ } from "./cones.js";
13
27
  import { callerOf as agentOf } from "./identity.js";
14
28
  import { retryEnded } from "./retry.js";
15
29
  import { findScoop, modelOf } from "./service.js";
@@ -24,8 +38,9 @@ const USAGE = `usage:
24
38
  agent [options] (--prompt <text> | --file <path> | -)... run a scoop, wait, print its answer
25
39
  agent --async [options] (--prompt <text> | --file <path> | -)... start a scoop, print its handle
26
40
  agent <cwd> <allowed-commands> <prompt> the same as a synchronous run, in v6's form
27
- agent list [--agents] | status <handle> | rename <handle> <name>
41
+ agent list [--agents | --cones] | status <handle> | rename <handle> <name>
28
42
  agent send <handle> [--follow-up] (<message> | --file <path> | -)
43
+ agent send <cone> [--follow-up] (<message> | --file <path> | -) message a cone: cone (yours), its user or its name
29
44
  agent send <target> --lick=<cron|webhook> [--source <name>] (<message> | --file <path> | -)
30
45
  agent send parent <note> from a scoop: a progress note to its cone
31
46
  agent wait <handle>... [--timeout <seconds>] [--notify]
@@ -38,6 +53,10 @@ options:
38
53
  --tools <a,b> --read-only <path,path> --system-prompt <text> | --system-prompt-file <path>
39
54
  --background-after <seconds> --persist-session | --no-persist-session
40
55
 
56
+ A cone may message its own cone and cones whose user shares a group with it (not root, sudo or users);
57
+ root may message any cone. Any other cone needs sudo -u <its user> agent send <its user> \u2026, which the
58
+ sudoers policy allows or refuses. The message arrives as a cone-message lick that names its sender.
59
+
41
60
  A synchronous run removes the scoop's folder afterwards. Its transcript is archived in
42
61
  /tmp/agent-sessions/<handle>.md, in /home/sessions/<handle>.md with --persist-session, or nowhere
43
62
  with --no-persist-session. subagent is the same command: subagent spawn = agent --async.
@@ -81,8 +100,12 @@ function claimed(agents, caller) {
81
100
  class CallerError extends Error {
82
101
  }
83
102
  async function taintsOf(deps, request, who, context) {
84
- const own = await callerTaints(deps.harness, deps.agents.state(), who, request.caller, context);
85
- return who.tagged ? distinctTaints([...own, ...who.tagged]) : own;
103
+ const state = deps.agents.state();
104
+ const own = await callerTaints(deps.harness, state, who, request.caller, context);
105
+ const via = who.via ? claimed(deps.agents, who.via) : void 0;
106
+ const through = via ? await callerTaints(deps.harness, state, via, "", context) : [];
107
+ const more = [...through, ...who.tagged ?? []];
108
+ return more.length ? distinctTaints([...own, ...more]) : own;
86
109
  }
87
110
  function anonymous(agents) {
88
111
  return { id: null, cone: agents.activeCone(), fromAgent: false, scoop: null, depth: 0 };
@@ -94,18 +117,18 @@ function callerOf(agents, request, lineage) {
94
117
  if (!user || user === ROOT_USER) {
95
118
  if (request.caller && request.caller !== walked)
96
119
  throw new CallerError(
97
- `SLICC_AGENT says ${request.caller}, but this process belongs to ${walked ?? "no agent"}`
120
+ `SLICC_AGENT says ${request.caller}, but this process belongs to ${walked ?? "no agent"}; SLICC_AGENT can't change who you are, sudo -u <user> ${request.as} \u2026 does`
98
121
  );
99
122
  return (walked ? claimed(agents, walked) : void 0) ?? anonymous(agents);
100
123
  }
101
124
  const own = agentOfUser(agents.state(), user);
102
125
  if (request.caller && request.caller !== own)
103
- throw new CallerError(`SLICC_AGENT says ${request.caller}, but you are ${user}`);
104
- if (walked && walked !== own)
105
- throw new CallerError(`you are ${user}, but this process belongs to ${walked}`);
126
+ throw new CallerError(
127
+ `SLICC_AGENT says ${request.caller}, but you are ${user}; SLICC_AGENT can't change who you are, sudo -u <user> ${request.as} \u2026 does`
128
+ );
106
129
  const found = own ? claimed(agents, own) : void 0;
107
130
  if (!found) throw new CallerError(`${user} is no cone or live scoop`);
108
- return found;
131
+ return walked && walked !== own ? { ...found, via: walked } : found;
109
132
  }
110
133
  const UNCHECKED = /* @__PURE__ */ new Set(["__cancel", "__detach"]);
111
134
  function unchecked(request) {
@@ -131,7 +154,9 @@ async function attested(deps, request, context) {
131
154
  if (!runsCommand(lineage.argv, request))
132
155
  throw new CallerError(`process ${request.pid} is not this ${request.as} call`);
133
156
  if (request.user && lineage.uid !== await uidOf(deps, request.user, context))
134
- throw new CallerError(`process ${request.pid} does not run as ${request.user}`);
157
+ throw new CallerError(
158
+ `process ${request.pid} does not run as ${request.user}; USER doesn't choose who you are, sudo -u ${request.user} ${request.as} \u2026 does`
159
+ );
135
160
  return lineage;
136
161
  }
137
162
  async function tagTaints(deps, lineage, context) {
@@ -141,6 +166,9 @@ async function tagTaints(deps, lineage, context) {
141
166
  function withTags(who, tagged) {
142
167
  return tagged.length ? { ...who, tagged: [...tagged] } : who;
143
168
  }
169
+ function withSudo(who, lineage) {
170
+ return lineage?.hop ? { ...who, hop: lineage.hop.uid } : who;
171
+ }
144
172
  async function readText(deps, value, request, context) {
145
173
  const env = await deps.layout.envFor(request.user ?? null, context) ?? deps.env;
146
174
  const read = await env.readTextFile(resolve(request.cwd, value), context);
@@ -279,25 +307,38 @@ async function listAgents(deps) {
279
307
  `
280
308
  );
281
309
  }
310
+ async function listCones(deps, request, who, context) {
311
+ if (who.scoop) return fail(SCOOP_SENDS);
312
+ const state = deps.agents.state();
313
+ const tables = await readTables(deps.env, context);
314
+ const sender = request.user ?? ROOT_USER;
315
+ const rows = Object.entries(state.cones).map(([id, record]) => {
316
+ const how = who.fromAgent && id === who.cone ? "you" : reachText(reachOf(tables, sender, id), id);
317
+ return `${addressOf(id, who.cone)} ${printable(record.name)} ${how}`;
318
+ });
319
+ return ok(`${rows.join("\n")}
320
+ `);
321
+ }
282
322
  async function list(deps, request, who, context) {
283
323
  if (request.argv.includes("--agents")) return listAgents(deps);
324
+ if (request.argv.includes("--cones")) return listCones(deps, request, who, context);
284
325
  const rows = await deps.scoops.list(who.cone, context);
285
326
  if (!rows.length) return ok("no scoops\n");
286
327
  return ok(
287
- `${rows.map((row) => `${row.folder} ${row.name} ${row.role ?? "-"} ${row.busy ? "working" : "idle"}`).join("\n")}
328
+ `${rows.map((row) => `${row.folder} ${printable(row.name)} ${printable(row.role ?? "-")} ${row.busy ? "working" : "idle"}`).join("\n")}
288
329
  `
289
330
  );
290
331
  }
291
332
  async function status(deps, request, who, context) {
292
333
  const found = handle(deps, who, request.argv[1]);
293
- if (!found) return fail(noScoop(deps.agents.state(), request.argv[1] ?? ""));
334
+ if (!found) return fail(noTarget(deps, who, request.argv[1] ?? ""));
294
335
  const [, record] = found;
295
336
  const busy = await deps.scoops.busy(record.conversation, context);
296
337
  return ok(
297
338
  `${[
298
339
  `handle: ${record.folder}`,
299
- `name: ${record.name}`,
300
- `role: ${record.role ?? "-"}`,
340
+ `name: ${printable(record.name)}`,
341
+ `role: ${printable(record.role ?? "-")}`,
301
342
  `kind: ${record.kind}`,
302
343
  `state: ${busy ? "working" : "idle"}`,
303
344
  `folder: ${deps.layout.scoopRoot(record.folder)}`,
@@ -311,22 +352,97 @@ async function message(deps, parsed, request, context) {
311
352
  if (file) return readText(deps, file, request, context);
312
353
  return parsed.rest.includes("-") ? request.stdin : parsed.rest.join(" ");
313
354
  }
355
+ const SCOOP_SENDS = "a scoop can only send to its parent: agent send parent \u2026; its cone can message other cones";
356
+ function senderOf(deps, request, who, tables) {
357
+ const user = request.user ?? ROOT_USER;
358
+ if (who.hop === void 0) return { user, agent: who.id };
359
+ const by = tables.names.get(who.hop) ?? String(who.hop);
360
+ const root = user === ROOT_USER;
361
+ const walked = root ? who.id : who.via;
362
+ return {
363
+ user,
364
+ agent: root ? null : who.id,
365
+ hop: {
366
+ user: by,
367
+ agent: walked ?? agentOfUser(deps.agents.state(), by) ?? null,
368
+ sudo: who.hop !== 0
369
+ }
370
+ };
371
+ }
372
+ async function coneSend(deps, request, who, target, followUp, text, context) {
373
+ if (!deps.licks) return fail("licks are not available in this agent, so it can't message cones");
374
+ const long = tooLong(text);
375
+ if (long) return fail(long, 2);
376
+ const state = deps.agents.state();
377
+ const tables = await readTables(deps.env, context);
378
+ const sender = senderOf(deps, request, who, tables);
379
+ const reach = reachOf(tables, sender.user, target.id);
380
+ if (reach.kind === "sudo") return fail(refusal(state, sender.user, target.id));
381
+ const { source, ...shown } = describe(state, sender);
382
+ const waiting = await deps.licks.waiting(
383
+ `${CONE_PREFIX}${target.id}`,
384
+ MESSAGE_CHANNEL,
385
+ source,
386
+ context
387
+ );
388
+ const full = crowded(state, target.id, waiting);
389
+ if (full) return fail(full);
390
+ const taints = await taintsOf(deps, request, who, context);
391
+ await deps.licks.deliver(
392
+ {
393
+ channel: MESSAGE_CHANNEL,
394
+ source,
395
+ ...shown,
396
+ body: text.trimEnd(),
397
+ target: `${CONE_PREFIX}${target.id}`,
398
+ coalesce: false,
399
+ eventId: request.id,
400
+ ...followUp ? { followUp } : {},
401
+ ...taints.length ? { taints } : {}
402
+ },
403
+ context
404
+ );
405
+ const own = reach.kind === "self" && !sender.hop ? ", your own cone" : "";
406
+ return ok(`sent to ${coneLabel(state, target.id)}${own}
407
+ `);
408
+ }
409
+ function noTarget(deps, who, name) {
410
+ const state = deps.agents.state();
411
+ const missing = noScoop(state, name);
412
+ const cone = name.startsWith("scoop:") ? void 0 : findCone(state, name, who.cone);
413
+ if (!cone || "error" in cone) return missing;
414
+ return `${missing}; ${printable(name)} is the cone ${coneLabel(state, cone.id)}, and agent send ${addressOf(cone.id, who.cone)} \u2026 messages it`;
415
+ }
416
+ function unknownTarget(state, name) {
417
+ const missing = noScoop(state, name);
418
+ if (missing !== `there is no scoop ${printable(name)}`) return missing;
419
+ return `there is no scoop or cone ${printable(name)}; agent list shows your scoops, agent list --cones the cones you can message`;
420
+ }
314
421
  async function send(deps, request, who, context) {
315
422
  const parsed = flags(request.argv.slice(2), ["--file"]);
316
423
  const unknown = [...parsed.switches].find((flag) => flag !== "--follow-up");
317
424
  if (unknown) return fail(`unknown option ${unknown}`, 2);
318
425
  const text = await message(deps, parsed, request, context);
319
426
  if (!text.trim()) return fail("send needs a message, --file or -", 2);
320
- if (request.argv[1] === "parent") {
427
+ const name = request.argv[1] ?? "";
428
+ if (name === "parent") {
321
429
  if (!who.scoop) return fail("only a scoop has a parent to send to");
322
430
  return deps.scoops.note(who.scoop, text, await taintsOf(deps, request, who, context), context);
323
431
  }
324
- if (who.scoop) return fail("a scoop can only send to its parent");
325
- const found = handle(deps, who, request.argv[1]);
326
- if (!found) return fail(noScoop(deps.agents.state(), request.argv[1] ?? ""));
432
+ if (who.scoop) return fail(SCOOP_SENDS);
433
+ const state = deps.agents.state();
434
+ const found = handle(deps, who, name);
435
+ const cone = name.startsWith("scoop:") ? void 0 : findCone(state, name, who.cone);
436
+ const followUp = parsed.switches.has("--follow-up");
437
+ if (found && cone && !("error" in cone))
438
+ return fail(
439
+ `${printable(name)} is both the scoop ${found[1].folder} and the cone ${coneLabel(state, cone.id)}; send to scoop:${found[1].folder} or ${CONE_PREFIX}${cone.id}`
440
+ );
441
+ if (!found && cone)
442
+ return "error" in cone ? fail(cone.error) : coneSend(deps, request, who, cone, followUp, text, context);
443
+ if (!found) return fail(unknownTarget(state, name));
327
444
  const refused = await reviewing(deps, who, found, context);
328
445
  if (refused) return refused;
329
- const followUp = parsed.switches.has("--follow-up");
330
446
  const taints = await taintsOf(deps, request, who, context);
331
447
  return deps.scoops.feed(
332
448
  found[0],
@@ -352,6 +468,7 @@ function cronTarget(deps, request, name) {
352
468
  return findScoop(state, name, cone)?.[0] ?? home;
353
469
  }
354
470
  const PROCESS_LICKS = ["cron", "webhook"];
471
+ const PLAIN_SEND = "to message a cone, leave out --lick: agent send <cone> \u2026";
355
472
  function expanded(argv) {
356
473
  return argv.flatMap((arg) => {
357
474
  const at = arg.indexOf("=");
@@ -363,15 +480,19 @@ function refusedChannel(channel) {
363
480
  const own = LICK_CHANNELS.includes(channel);
364
481
  const what = own ? `--lick=${channel} is the agent's own channel` : `there is no lick channel "${channel}"`;
365
482
  return fail(
366
- `${what}; a process may send ${PROCESS_LICKS.map((name) => `--lick=${name}`).join(" or ")}`,
483
+ `${what}; a process may send ${PROCESS_LICKS.map((name) => `--lick=${name}`).join(" or ")}; ${PLAIN_SEND}`,
367
484
  2
368
485
  );
369
486
  }
370
487
  async function cronSend(deps, licks, request, parsed, sender, context) {
371
488
  if (!request.cron)
372
- return fail("--lick=cron only works inside a cron job, which sets SLICC_CRON_JOB");
489
+ return fail(
490
+ `--lick=cron only works inside a cron job, which sets SLICC_CRON_JOB; ${PLAIN_SEND}`
491
+ );
373
492
  if (sender.spawned)
374
- return fail("--lick=cron only works inside a cron job, and an agent's bash started this one");
493
+ return fail(
494
+ `--lick=cron only works inside a cron job, and an agent's bash started this one; ${PLAIN_SEND}`
495
+ );
375
496
  if (last(parsed, "--source") !== void 0)
376
497
  return fail("--source is for --lick=webhook; a cron lick is named by its job's # name:", 2);
377
498
  const target = cronTarget(deps, request, parsed.rest[0] ?? "");
@@ -457,8 +578,7 @@ async function latest(deps, record, context) {
457
578
  function waitTargets(deps, who, rest) {
458
579
  if (!rest.length) return fail("wait needs at least one handle", 2);
459
580
  const missing = rest.filter((name) => !handle(deps, who, name));
460
- if (missing.length)
461
- return fail(missing.map((name) => noScoop(deps.agents.state(), name)).join("; "));
581
+ if (missing.length) return fail(missing.map((name) => noTarget(deps, who, name)).join("; "));
462
582
  return rest.map((name) => handle(deps, who, name)[0]);
463
583
  }
464
584
  async function block(deps, ids, seconds, context) {
@@ -505,7 +625,7 @@ async function wait(deps, request, who, context) {
505
625
  async function stop(deps, request, who, context) {
506
626
  if (who.scoop) return fail("a scoop cannot stop scoops");
507
627
  const found = handle(deps, who, request.argv[1]);
508
- if (!found) return fail(noScoop(deps.agents.state(), request.argv[1] ?? ""));
628
+ if (!found) return fail(noTarget(deps, who, request.argv[1] ?? ""));
509
629
  const refused = await reviewing(deps, who, found, context);
510
630
  if (refused) return refused;
511
631
  return deps.scoops.stop(found[0], who.fromAgent, context);
@@ -513,10 +633,11 @@ async function stop(deps, request, who, context) {
513
633
  async function rename(deps, request, who, context) {
514
634
  if (who.scoop) return fail("a scoop cannot rename scoops");
515
635
  const found = handle(deps, who, request.argv[1]);
516
- if (!found) return fail(noScoop(deps.agents.state(), request.argv[1] ?? ""));
636
+ if (!found) return fail(noTarget(deps, who, request.argv[1] ?? ""));
517
637
  const refused = await reviewing(deps, who, found, context);
518
638
  if (refused) return refused;
519
- return deps.scoops.rename(found[0], request.argv.slice(2).join(" "), context);
639
+ const taints = await taintsOf(deps, request, who, context);
640
+ return deps.scoops.rename(found[0], request.argv.slice(2).join(" "), taints, context);
520
641
  }
521
642
  const retry = async (_deps, request, who) => retryEnded(request.argv[1], who.fromAgent);
522
643
  const help = async () => ok(USAGE);
@@ -546,8 +667,9 @@ function noScoop(state, name) {
546
667
  (candidate) => candidate.frozen && candidate.name === name
547
668
  );
548
669
  const frozen = record?.frozen ? state.frozen?.[record.frozen] : void 0;
549
- if (frozen) return `scoop ${name} is frozen with cone ${frozen.name}; thaw the cone first`;
550
- return `there is no scoop ${name}`.trim();
670
+ if (frozen)
671
+ return `scoop ${printable(name)} is frozen with cone ${printable(frozen.name)}; thaw the cone first`;
672
+ return `there is no scoop ${printable(name)}`.trim();
551
673
  }
552
674
  function panelCaller(request, who) {
553
675
  const agentId = who.scoop ?? (who.fromAgent ? who.cone : null);
@@ -613,7 +735,7 @@ function createCli(options) {
613
735
  const argv = expanded(request.argv);
614
736
  if (request.as === "agent" && argv[0] === "send" && argv.includes("--lick"))
615
737
  return await lickSend(deps, { ...request, argv }, lineage, tagged, context);
616
- const who = withTags(callerOf(deps.agents, request, lineage), tagged);
738
+ const who = withSudo(withTags(callerOf(deps.agents, request, lineage), tagged), lineage);
617
739
  return await dispatch(deps, request, who, context);
618
740
  } catch (error) {
619
741
  return fail(error.message);