@ai-ecoverse/slicc-agent 7.16.0 → 7.17.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.
- package/README.md +17 -15
- package/dist/approvals/index.js +88 -42
- package/dist/approvals/index.js.map +2 -2
- package/dist/approvals/intent.js +6 -2
- package/dist/approvals/intent.js.map +2 -2
- package/dist/approvals/judge.js +257 -83
- package/dist/approvals/judge.js.map +2 -2
- package/dist/approvals/present.js +1 -6
- package/dist/approvals/present.js.map +2 -2
- package/dist/approvals/record.js +20 -0
- package/dist/approvals/record.js.map +2 -2
- package/dist/approvals/sudo.js +19 -2
- package/dist/approvals/sudo.js.map +2 -2
- package/dist/index.js +2 -4
- package/dist/index.js.map +2 -2
- package/dist/sprinkles/cgi-run.js +3 -5
- package/dist/sprinkles/cgi-run.js.map +2 -2
- package/dist/titles/generate.js +19 -19
- package/dist/titles/generate.js.map +2 -2
- package/dist/types/approvals/intent.d.ts +4 -1
- package/dist/types/approvals/judge.d.ts +52 -25
- package/dist/types/approvals/present.d.ts +2 -2
- package/dist/types/approvals/record.d.ts +20 -2
- package/dist/types/approvals/sudo.d.ts +3 -1
- package/dist/types/index.d.ts +1 -1
- package/dist/types/titles/generate.d.ts +5 -2
- package/package.json +6 -6
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../src/approvals/record.ts"],
|
|
4
|
-
"sourcesContent": ["import { defineDoc } from '@earendil-works/pi-durable';\nimport { boundedDeltas } from '../checkpoints.ts';\n\nexport type ApprovalKind = 'guest-message' | 'guest-tool' | 'sudo';\n\nexport type ApprovalState = 'pending' | 'approved' | 'rejected' | 'unanswered' | 'withdrawn';\n\nexport type ApprovalTier = 'user' | 'agent' | 'cone' | `scoop:${string}`;\n\nexport type ApprovalAnswer = 'once' | 'always' | 'deny';\n\nexport type DecidedBy = 'owner' | 'follower' | 'judge' | 'host' | `scoop:${string}`;\n\nexport type ApprovalRequester = {\n kind: 'guest' | 'agent' | 'user';\n name: string;\n seat?: string;\n agentId?: string;\n where?: string;\n device?: string;\n};\n\nexport type ApprovalVerdict = {\n decision: 'allow' | 'deny' | 'unsure';\n
|
|
5
|
-
"mappings": "AAAA,SAAS,iBAAiB;AAC1B,SAAS,qBAAqB;
|
|
4
|
+
"sourcesContent": ["import { defineDoc } from '@earendil-works/pi-durable';\nimport { boundedDeltas } from '../checkpoints.ts';\n\nexport type ApprovalKind = 'guest-message' | 'guest-tool' | 'sudo';\n\nexport type ApprovalState = 'pending' | 'approved' | 'rejected' | 'unanswered' | 'withdrawn';\n\nexport type ApprovalTier = 'user' | 'agent' | 'cone' | `scoop:${string}`;\n\nexport type ApprovalAnswer = 'once' | 'always' | 'deny';\n\nexport type DecidedBy = 'owner' | 'follower' | 'judge' | 'host' | `scoop:${string}`;\n\nexport type ApprovalRequester = {\n kind: 'guest' | 'agent' | 'user';\n name: string;\n seat?: string;\n agentId?: string;\n where?: string;\n device?: string;\n};\n\nexport type ApprovalLevel = 1 | 2 | 3;\n\nexport type ApprovalVerdict = {\n level?: ApprovalLevel;\n routine?: number;\n aligned?: number | boolean;\n always?: boolean;\n reason: string;\n via?: 'classifier' | 'chat';\n decision: 'allow' | 'deny' | 'unsure';\n risk?: number;\n model?: string;\n};\n\nexport type ApprovalAttachment = { name: string; mimeType: string; size: number };\n\nexport type GuestMessageDetail = { text: string; attachments: ApprovalAttachment[] };\n\nexport type GuestToolDetail = { tool: string; summary: string; arguments?: string; task?: number };\n\nexport type SudoStdin = 'tty' | 'none' | 'pipe' | 'file';\n\nexport type SudoDetail = {\n command: string;\n target?: string;\n cwd?: string;\n alwaysScope?: 'cwd';\n stdin?: SudoStdin;\n rootOnly?: Record<string, boolean>;\n writable?: boolean;\n};\n\ntype Base = {\n id: string;\n seat?: string;\n agentId: string;\n requester: ApprovalRequester;\n tier: string;\n state: ApprovalState;\n decidedBy: DecidedBy | null;\n device?: string;\n answer?: 'once' | 'always';\n reviewer?: string;\n reason?: string;\n verdict?: ApprovalVerdict;\n judging?: boolean;\n verdictError?: string;\n always: boolean;\n createdAt: number;\n expiresAt: number;\n decidedAt?: number;\n};\n\nexport type GuestMessageApproval = Base & { kind: 'guest-message'; detail: GuestMessageDetail };\nexport type GuestToolApproval = Base & { kind: 'guest-tool'; detail: GuestToolDetail };\nexport type SudoApproval = Base & { kind: 'sudo'; detail: SudoDetail };\n\nexport type Approval = GuestMessageApproval | GuestToolApproval | SudoApproval;\n\ntype DraftOf<T extends Approval> = Pick<T, 'kind' | 'detail' | 'agentId' | 'requester'> & {\n seat?: string;\n tier: string;\n always?: boolean;\n expiresAt?: number;\n};\n\nexport type ApprovalDraft =\n | DraftOf<GuestMessageApproval>\n | DraftOf<GuestToolApproval>\n | DraftOf<SudoApproval>;\n\nexport type ApprovalsState = { items: Approval[] };\n\nexport const ApprovalsDoc = defineDoc<ApprovalsState>({\n kind: 'slicc.approvals',\n checkpointWhen: boundedDeltas,\n version: 1,\n scope: 'session',\n initial: () => ({ items: [] }),\n});\n\nexport const APPROVAL_MS = 300_000;\nexport const APPROVALS_KEPT = 100;\nexport const MAX_DELAY = 2_147_483_647;\nexport const REASON_LENGTH = 500;\n\nexport const REASONS = {\n timeout: 'timeout',\n unknownTier: 'unknown-tier',\n unroutable: 'unroutable',\n unknownAnswer: 'unknown-answer',\n restart: 'restart',\n revoked: 'revoked',\n aborted: 'aborted',\n disconnected: 'disconnected',\n noScoop: 'no-scoop',\n scoopStopped: 'scoop-stopped',\n scoopAsked: 'scoop-asked',\n scoopUndecided: 'scoop-undecided',\n} as const;\n\nexport const guestKind = (kind: ApprovalKind): boolean => kind !== 'sudo';\n\nexport const scoopTier = (tier: unknown): tier is `scoop:${string}` =>\n typeof tier === 'string' && /^scoop:\\S+$/.test(tier);\n\nexport function knownTier(tier: unknown): tier is ApprovalTier {\n if (tier === 'user' || tier === 'agent' || tier === 'cone') return true;\n return scoopTier(tier);\n}\n\nexport function routable(kind: ApprovalKind, tier: ApprovalTier): boolean {\n return !(kind === 'guest-tool' && tier === 'cone');\n}\n\nexport function answerOf(value: unknown): ApprovalAnswer | null {\n return value === 'once' || value === 'always' || value === 'deny' ? value : null;\n}\n\nexport const personal = (by: DecidedBy): boolean => by === 'owner' || by === 'follower';\n\nexport function answerer(by: DecidedBy, item: Pick<Approval, 'tier' | 'reviewer'>): boolean {\n if (personal(by)) return item.tier === 'user';\n if (by === 'judge') return item.tier === 'agent';\n if (scoopTier(by)) return scoopTier(item.tier) && item.reviewer === by;\n return true;\n}\n\nexport type SudoApprover = 'user' | 'agent';\n\nexport const sudoApprover = (value: unknown): SudoApprover =>\n value === 'agent' ? 'agent' : 'user';\n\nexport const tierOf = (kind: ApprovalKind, tier: string, sudo: SudoApprover): string =>\n kind === 'sudo' ? sudo : tier;\n\nexport const JUDGE_ALLOW = 0.8;\n\nexport type Gate = 'person' | 'judge';\n\nexport type Routed = 'approve' | 'deny' | 'ask';\n\nexport const gateOf = (tier: string): Gate => (tier === 'agent' ? 'judge' : 'person');\n\nexport const fits = (aligned: ApprovalVerdict['aligned']): boolean =>\n aligned === true || (typeof aligned === 'number' && aligned >= JUDGE_ALLOW);\n\nexport function route(\n verdict: ApprovalVerdict | undefined,\n requester: Pick<ApprovalRequester, 'kind'>,\n gate: Gate,\n present: boolean\n): Routed {\n if (gate !== 'judge' || !verdict?.level) return 'ask';\n const sure = verdict.via === 'chat' || (verdict.routine ?? 0) >= JUDGE_ALLOW;\n if (verdict.level === 1 && sure && fits(verdict.aligned)) return 'approve';\n if (verdict.level === 3 && requester.kind !== 'user' && !present) return 'deny';\n return 'ask';\n}\n\nexport function alwaysOffered(item: Approval): boolean {\n if (item.kind !== 'sudo' || item.tier !== 'user') return false;\n const { verdict, detail } = item;\n return verdict?.level === 1 && verdict.always === true && detail.writable !== false;\n}\n\nexport function gone(state: ApprovalState): string {\n if (state === 'unanswered') return 'This request timed out.';\n if (state === 'withdrawn') return 'This request was withdrawn.';\n return 'Someone else already answered this.';\n}\n\nexport function cleanReason(reason: unknown): string | undefined {\n if (typeof reason !== 'string') return undefined;\n const text = reason.trim().slice(0, REASON_LENGTH);\n return text || undefined;\n}\n\nconst decided = (item: Approval) => item.decidedAt ?? item.createdAt;\n\nexport function prune(items: Approval[], kept = APPROVALS_KEPT): Approval[] {\n const settled = items.filter((item) => item.state !== 'pending');\n settled.sort((a, b) => decided(a) - decided(b));\n const drop = new Set(settled.slice(0, Math.max(0, settled.length - kept)));\n return items.filter((item) => !drop.has(item));\n}\n\nexport type Settle = { state: Exclude<ApprovalState, 'pending'>; by: DecidedBy; reason?: string };\n\nexport type Ruling = { error?: string; settle?: Settle; answer?: 'once' | 'always' };\n\nconst why = (reason: string | undefined) => (reason ? { reason } : {});\n\nexport function ruled(\n item: Approval,\n answer: unknown,\n reason: unknown,\n by: DecidedBy,\n at: number\n): Ruling {\n if (item.state !== 'pending') return { error: gone(item.state) };\n if (item.expiresAt <= at)\n return {\n error: gone('unanswered'),\n settle: { state: 'unanswered', by: 'host', reason: REASONS.timeout },\n };\n if (!answerer(by, item)) return { error: \"This request isn't yours to answer.\" };\n const known = answerOf(answer);\n if (known === 'always' && scoopTier(by)) return { error: 'A scoop answers once or deny.' };\n if (known === 'always' && !personal(by))\n return { error: 'Always can only be answered by a person.' };\n if (known === 'always' && !item.always)\n return { error: \"Always isn't offered for this request.\" };\n if (!known) return { settle: { state: 'rejected', by, reason: REASONS.unknownAnswer } };\n const given = why(cleanReason(reason));\n if (known === 'deny') return { settle: { state: 'rejected', by, ...given } };\n return { settle: { state: 'approved', by, ...given }, answer: known };\n}\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
package/dist/approvals/sudo.js
CHANGED
|
@@ -58,13 +58,30 @@ function sudoRequester(request, agents, where) {
|
|
|
58
58
|
}
|
|
59
59
|
return { requester: { kind: "user", name }, agentId: "" };
|
|
60
60
|
}
|
|
61
|
+
const STDIN = ["tty", "none", "pipe", "file"];
|
|
62
|
+
function rootOnlyOf(value) {
|
|
63
|
+
if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
|
|
64
|
+
const kept = Object.entries(value).filter(
|
|
65
|
+
(entry) => typeof entry[1] === "boolean"
|
|
66
|
+
);
|
|
67
|
+
return Object.fromEntries(kept);
|
|
68
|
+
}
|
|
69
|
+
function kernelFacts(request) {
|
|
70
|
+
const rootOnly = rootOnlyOf(request.rootOnly);
|
|
71
|
+
return {
|
|
72
|
+
...STDIN.includes(request.stdin) ? { stdin: request.stdin } : {},
|
|
73
|
+
...rootOnly ? { rootOnly } : {},
|
|
74
|
+
...typeof request.always === "boolean" ? { writable: request.always } : {}
|
|
75
|
+
};
|
|
76
|
+
}
|
|
61
77
|
function sudoDetail(request) {
|
|
62
78
|
const command = [request.path || request.argv[0], ...request.argv.slice(1)].map((word) => shellWord(String(word))).join(" ");
|
|
63
79
|
return {
|
|
64
80
|
command,
|
|
65
81
|
...text(request.target) ? { target: request.target } : {},
|
|
66
82
|
...text(request.cwd) ? { cwd: request.cwd } : {},
|
|
67
|
-
...request.always === true ? { alwaysScope: "cwd" } : {}
|
|
83
|
+
...request.always === true ? { alwaysScope: "cwd" } : {},
|
|
84
|
+
...kernelFacts(request)
|
|
68
85
|
};
|
|
69
86
|
}
|
|
70
87
|
function scoopLick(id, agentId, detail, agents) {
|
|
@@ -109,7 +126,7 @@ function createSudo(options) {
|
|
|
109
126
|
agentId,
|
|
110
127
|
requester,
|
|
111
128
|
tier: "user",
|
|
112
|
-
always: request.always
|
|
129
|
+
always: request.always !== false,
|
|
113
130
|
expiresAt: request.expiresAt,
|
|
114
131
|
detail
|
|
115
132
|
},
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../src/approvals/sudo.ts"],
|
|
4
|
-
"sourcesContent": ["import type { Context, ReplicatedState } from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { AgentsState } from '../agents.ts';\nimport type { Licks } from '../licks/licks.ts';\nimport { sprinklesOf } from '../sprinkles/cgi.ts';\nimport type { Approvals } from './index.ts';\nimport {\n type Approval,\n type ApprovalRequester,\n cleanReason,\n REASONS,\n type SudoDetail,\n} from './record.ts';\n\nexport type SudoAnswer = 'once' | 'always' | 'deny';\n\nexport type SudoDenial = { answer: 'deny'; message: string };\n\nexport type SudoReply = SudoAnswer | SudoDenial;\n\nexport interface SudoRequest {\n id: string;\n kind: 'sudo';\n user: string;\n uid?: number;\n target?: string;\n argv: string[];\n path?: string;\n cwd?: string;\n pid?: number;\n tag?: string;\n tags?: string[];\n tty?: string;\n createdAt?: number;\n expiresAt: number;\n always?: boolean;\n}\n\nexport type SudoAsked = { id: string; error: null } | { id: null; error: string };\n\nexport interface AgentSudo {\n readonly approvals: ReplicatedState<Approval[]>;\n request(request: SudoRequest, where: string | null, context: Context): Promise<SudoAsked>;\n withdraw(id: string, reason: string | null, context: Context): Promise<void>;\n}\n\nconst SAFE = /^[\\w@%+=:,./-]+$/;\n\nexport const shellWord = (word: string): string =>\n SAFE.test(word) ? word : `'${word.replaceAll(\"'\", `'\\\\''`)}'`;\n\nconst text = (value: unknown): value is string => typeof value === 'string';\n\nexport function sudoRequest(value: unknown): SudoRequest | null {\n const request = value as Partial<SudoRequest> | null;\n if (typeof request !== 'object' || request === null) return null;\n const { argv, user, expiresAt } = request;\n if (!Array.isArray(argv) || !argv.length || !argv.every(text)) return null;\n if (!text(user) || typeof expiresAt !== 'number' || !Number.isFinite(expiresAt)) return null;\n return request as SudoRequest;\n}\n\nfunction tagOf(tag: unknown): { kind?: unknown; agentId?: unknown; where?: unknown } | null {\n if (!text(tag)) return null;\n try {\n const parsed = JSON.parse(tag);\n return typeof parsed === 'object' && parsed !== null ? parsed : null;\n } catch {\n return null;\n }\n}\n\nconst TERMINAL = 'terminal:';\nconst FOLLOWER = 'follower:';\n\nfunction shownWhere(where: string, given: string | undefined): string {\n if (given) return given;\n if (where.startsWith(TERMINAL)) return 'a terminal';\n if (where.startsWith(FOLLOWER)) return 'a linked device';\n return where;\n}\n\nexport function sudoRequester(\n request: SudoRequest,\n agents: Readonly<AgentsState> | undefined,\n where?: string | null\n): { requester: ApprovalRequester; agentId: string } {\n const tag = tagOf(request.tag);\n const name = request.user;\n const sprinkle = sprinklesOf(Array.isArray(request.tags) ? request.tags.filter(text) : [])[0];\n if (sprinkle)\n return { requester: { kind: 'user', name, where: `the ${sprinkle} sprinkle` }, agentId: '' };\n if (tag?.kind === 'agent' && text(tag.agentId)) {\n const id = tag.agentId.startsWith('cone:') ? tag.agentId.slice('cone:'.length) : tag.agentId;\n const known = agents?.cones[id]?.name ?? agents?.scoops[id]?.name ?? name;\n return { requester: { kind: 'agent', name: known, agentId: id }, agentId: id };\n }\n if (tag?.kind === 'user' && text(tag.where)) {\n const given = cleanReason(where);\n const device = tag.where.startsWith(FOLLOWER) ? tag.where.slice(FOLLOWER.length) : '';\n return {\n requester: {\n kind: 'user',\n name,\n where: shownWhere(tag.where, given),\n ...(device ? { device } : {}),\n },\n agentId: '',\n };\n }\n return { requester: { kind: 'user', name }, agentId: '' };\n}\n\nexport function sudoDetail(request: SudoRequest): SudoDetail {\n const command = [request.path || request.argv[0], ...request.argv.slice(1)]\n .map((word) => shellWord(String(word)))\n .join(' ');\n return {\n command,\n ...(text(request.target) ? { target: request.target } : {}),\n ...(text(request.cwd) ? { cwd: request.cwd } : {}),\n ...(request.always === true ? { alwaysScope: 'cwd' as const } : {}),\n };\n}\n\nfunction scoopLick(\n id: string,\n agentId: string,\n detail: SudoDetail,\n agents: Readonly<AgentsState> | undefined\n) {\n const scoop = agents?.scoops[agentId];\n if (!scoop) return undefined;\n const { command, target, cwd } = detail;\n const as = target ? ` as ${target}` : '';\n const at = cwd ? ` in ${cwd}` : '';\n return {\n channel: 'sudo-request' as const,\n source: id,\n title: `${scoop.name} waits for sudo`,\n text: `[scoop ${scoop.name} waits for a person to approve sudo]`,\n body: `${scoop.name} asked to run ${command}${as}${at}. A person answers it in the approvals dialog; you can't approve it. It ends when someone answers or it times out.`,\n target: `cone:${scoop.cone}` as const,\n };\n}\n\nexport interface SudoAttach {\n approvals: Approvals;\n agents?: () => Readonly<AgentsState> | undefined;\n licks?: Pick<Licks, 'deliver'>;\n}\n\ntype SudoLick = NonNullable<ReturnType<typeof scoopLick>>;\n\nexport function createSudo(options: SudoAttach): AgentSudo & { close(): void } {\n const { approvals } = options;\n const agents = () => options.agents?.();\n const waiting = new Map<string, SudoLick>();\n const send = (lick: SudoLick) =>\n void options.licks?.deliver(lick, BACKGROUND_CONTEXT).catch(() => undefined);\n const watch = (items: readonly Approval[]) => {\n for (const [id, lick] of waiting) {\n const item = items.find((entry) => entry.id === id);\n if (item?.state === 'pending' && item.tier !== 'user') continue;\n waiting.delete(id);\n if (item?.state === 'pending') send(lick);\n }\n };\n const off = approvals.state.subscribe((items) => watch(items));\n return {\n approvals: approvals.state,\n async request(value, where, context) {\n const request = sudoRequest(value);\n if (!request) return { id: null, error: 'This is not a sudo request.' };\n const { requester, agentId } = sudoRequester(request, agents(), where);\n const detail = sudoDetail(request);\n const item = await approvals.request(\n {\n kind: 'sudo',\n agentId,\n requester,\n tier: 'user',\n always: request.always
|
|
5
|
-
"mappings": "AACA,SAAS,0BAA0B;AAGnC,SAAS,mBAAmB;AAE5B;AAAA,EAGE;AAAA,EACA;AAAA,
|
|
4
|
+
"sourcesContent": ["import type { Context, ReplicatedState } from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { AgentsState } from '../agents.ts';\nimport type { Licks } from '../licks/licks.ts';\nimport { sprinklesOf } from '../sprinkles/cgi.ts';\nimport type { Approvals } from './index.ts';\nimport {\n type Approval,\n type ApprovalRequester,\n cleanReason,\n REASONS,\n type SudoDetail,\n type SudoStdin,\n} from './record.ts';\n\nexport type SudoAnswer = 'once' | 'always' | 'deny';\n\nexport type SudoDenial = { answer: 'deny'; message: string };\n\nexport type SudoReply = SudoAnswer | SudoDenial;\n\nexport interface SudoRequest {\n id: string;\n kind: 'sudo';\n user: string;\n uid?: number;\n target?: string;\n argv: string[];\n path?: string;\n cwd?: string;\n pid?: number;\n tag?: string;\n tags?: string[];\n tty?: string;\n createdAt?: number;\n expiresAt: number;\n always?: boolean;\n stdin?: SudoStdin;\n rootOnly?: Record<string, boolean>;\n}\n\nexport type SudoAsked = { id: string; error: null } | { id: null; error: string };\n\nexport interface AgentSudo {\n readonly approvals: ReplicatedState<Approval[]>;\n request(request: SudoRequest, where: string | null, context: Context): Promise<SudoAsked>;\n withdraw(id: string, reason: string | null, context: Context): Promise<void>;\n}\n\nconst SAFE = /^[\\w@%+=:,./-]+$/;\n\nexport const shellWord = (word: string): string =>\n SAFE.test(word) ? word : `'${word.replaceAll(\"'\", `'\\\\''`)}'`;\n\nconst text = (value: unknown): value is string => typeof value === 'string';\n\nexport function sudoRequest(value: unknown): SudoRequest | null {\n const request = value as Partial<SudoRequest> | null;\n if (typeof request !== 'object' || request === null) return null;\n const { argv, user, expiresAt } = request;\n if (!Array.isArray(argv) || !argv.length || !argv.every(text)) return null;\n if (!text(user) || typeof expiresAt !== 'number' || !Number.isFinite(expiresAt)) return null;\n return request as SudoRequest;\n}\n\nfunction tagOf(tag: unknown): { kind?: unknown; agentId?: unknown; where?: unknown } | null {\n if (!text(tag)) return null;\n try {\n const parsed = JSON.parse(tag);\n return typeof parsed === 'object' && parsed !== null ? parsed : null;\n } catch {\n return null;\n }\n}\n\nconst TERMINAL = 'terminal:';\nconst FOLLOWER = 'follower:';\n\nfunction shownWhere(where: string, given: string | undefined): string {\n if (given) return given;\n if (where.startsWith(TERMINAL)) return 'a terminal';\n if (where.startsWith(FOLLOWER)) return 'a linked device';\n return where;\n}\n\nexport function sudoRequester(\n request: SudoRequest,\n agents: Readonly<AgentsState> | undefined,\n where?: string | null\n): { requester: ApprovalRequester; agentId: string } {\n const tag = tagOf(request.tag);\n const name = request.user;\n const sprinkle = sprinklesOf(Array.isArray(request.tags) ? request.tags.filter(text) : [])[0];\n if (sprinkle)\n return { requester: { kind: 'user', name, where: `the ${sprinkle} sprinkle` }, agentId: '' };\n if (tag?.kind === 'agent' && text(tag.agentId)) {\n const id = tag.agentId.startsWith('cone:') ? tag.agentId.slice('cone:'.length) : tag.agentId;\n const known = agents?.cones[id]?.name ?? agents?.scoops[id]?.name ?? name;\n return { requester: { kind: 'agent', name: known, agentId: id }, agentId: id };\n }\n if (tag?.kind === 'user' && text(tag.where)) {\n const given = cleanReason(where);\n const device = tag.where.startsWith(FOLLOWER) ? tag.where.slice(FOLLOWER.length) : '';\n return {\n requester: {\n kind: 'user',\n name,\n where: shownWhere(tag.where, given),\n ...(device ? { device } : {}),\n },\n agentId: '',\n };\n }\n return { requester: { kind: 'user', name }, agentId: '' };\n}\n\nconst STDIN: readonly unknown[] = ['tty', 'none', 'pipe', 'file'];\n\nfunction rootOnlyOf(value: unknown): Record<string, boolean> | undefined {\n if (typeof value !== 'object' || value === null || Array.isArray(value)) return undefined;\n const kept = Object.entries(value).filter(\n (entry): entry is [string, boolean] => typeof entry[1] === 'boolean'\n );\n return Object.fromEntries(kept);\n}\n\nfunction kernelFacts(request: SudoRequest): Partial<SudoDetail> {\n const rootOnly = rootOnlyOf(request.rootOnly);\n return {\n ...(STDIN.includes(request.stdin) ? { stdin: request.stdin } : {}),\n ...(rootOnly ? { rootOnly } : {}),\n ...(typeof request.always === 'boolean' ? { writable: request.always } : {}),\n };\n}\n\nexport function sudoDetail(request: SudoRequest): SudoDetail {\n const command = [request.path || request.argv[0], ...request.argv.slice(1)]\n .map((word) => shellWord(String(word)))\n .join(' ');\n return {\n command,\n ...(text(request.target) ? { target: request.target } : {}),\n ...(text(request.cwd) ? { cwd: request.cwd } : {}),\n ...(request.always === true ? { alwaysScope: 'cwd' as const } : {}),\n ...kernelFacts(request),\n };\n}\n\nfunction scoopLick(\n id: string,\n agentId: string,\n detail: SudoDetail,\n agents: Readonly<AgentsState> | undefined\n) {\n const scoop = agents?.scoops[agentId];\n if (!scoop) return undefined;\n const { command, target, cwd } = detail;\n const as = target ? ` as ${target}` : '';\n const at = cwd ? ` in ${cwd}` : '';\n return {\n channel: 'sudo-request' as const,\n source: id,\n title: `${scoop.name} waits for sudo`,\n text: `[scoop ${scoop.name} waits for a person to approve sudo]`,\n body: `${scoop.name} asked to run ${command}${as}${at}. A person answers it in the approvals dialog; you can't approve it. It ends when someone answers or it times out.`,\n target: `cone:${scoop.cone}` as const,\n };\n}\n\nexport interface SudoAttach {\n approvals: Approvals;\n agents?: () => Readonly<AgentsState> | undefined;\n licks?: Pick<Licks, 'deliver'>;\n}\n\ntype SudoLick = NonNullable<ReturnType<typeof scoopLick>>;\n\nexport function createSudo(options: SudoAttach): AgentSudo & { close(): void } {\n const { approvals } = options;\n const agents = () => options.agents?.();\n const waiting = new Map<string, SudoLick>();\n const send = (lick: SudoLick) =>\n void options.licks?.deliver(lick, BACKGROUND_CONTEXT).catch(() => undefined);\n const watch = (items: readonly Approval[]) => {\n for (const [id, lick] of waiting) {\n const item = items.find((entry) => entry.id === id);\n if (item?.state === 'pending' && item.tier !== 'user') continue;\n waiting.delete(id);\n if (item?.state === 'pending') send(lick);\n }\n };\n const off = approvals.state.subscribe((items) => watch(items));\n return {\n approvals: approvals.state,\n async request(value, where, context) {\n const request = sudoRequest(value);\n if (!request) return { id: null, error: 'This is not a sudo request.' };\n const { requester, agentId } = sudoRequester(request, agents(), where);\n const detail = sudoDetail(request);\n const item = await approvals.request(\n {\n kind: 'sudo',\n agentId,\n requester,\n tier: 'user',\n always: request.always !== false,\n expiresAt: request.expiresAt,\n detail,\n },\n context\n );\n const lick = scoopLick(item.id, agentId, detail, agents());\n if (lick) {\n waiting.set(item.id, lick);\n watch(approvals.state.value as Approval[]);\n }\n return { id: item.id, error: null };\n },\n async withdraw(id, reason, context) {\n await approvals.withdraw(id, reason, context);\n },\n close() {\n off();\n waiting.clear();\n },\n };\n}\n\nexport function ownedSudo(sudo: AgentSudo): AgentSudo & { release(): void } {\n const mine = new Set<string>();\n const forget = () => {\n const open = new Set(\n (sudo.approvals.value as Approval[])\n .filter((item) => item.state === 'pending')\n .map(({ id }) => id)\n );\n for (const id of mine) if (!open.has(id)) mine.delete(id);\n };\n return {\n approvals: sudo.approvals,\n async request(request, where, context) {\n forget();\n const asked = await sudo.request(request, where, context);\n if (asked.id) mine.add(asked.id);\n return asked;\n },\n async withdraw(id, reason, context) {\n if (!mine.delete(id)) return;\n await sudo.withdraw(id, reason, context);\n },\n release() {\n forget();\n for (const id of mine)\n void sudo.withdraw(id, REASONS.disconnected, BACKGROUND_CONTEXT).catch(() => undefined);\n mine.clear();\n },\n };\n}\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
package/dist/index.js
CHANGED
|
@@ -20,7 +20,6 @@ import {
|
|
|
20
20
|
attachApprovals,
|
|
21
21
|
DEFAULT_POLICY,
|
|
22
22
|
JUDGE_ALLOW,
|
|
23
|
-
JUDGE_DENY,
|
|
24
23
|
JUDGE_KIND,
|
|
25
24
|
JUDGE_MODEL,
|
|
26
25
|
JUDGE_QUESTIONS,
|
|
@@ -30,7 +29,7 @@ import {
|
|
|
30
29
|
ownerIntent,
|
|
31
30
|
POLICY_FILE,
|
|
32
31
|
REASONS,
|
|
33
|
-
|
|
32
|
+
route,
|
|
34
33
|
seedPolicy,
|
|
35
34
|
VERDICT_REASONS,
|
|
36
35
|
verdictOf,
|
|
@@ -132,7 +131,6 @@ export {
|
|
|
132
131
|
IMAGE_LIMIT,
|
|
133
132
|
INVENTORY_STATUSES,
|
|
134
133
|
JUDGE_ALLOW,
|
|
135
|
-
JUDGE_DENY,
|
|
136
134
|
JUDGE_KIND,
|
|
137
135
|
JUDGE_MODEL,
|
|
138
136
|
JUDGE_QUESTIONS,
|
|
@@ -178,7 +176,7 @@ export {
|
|
|
178
176
|
ownerIntent,
|
|
179
177
|
preferredModel,
|
|
180
178
|
resolveDefaultModel,
|
|
181
|
-
|
|
179
|
+
route,
|
|
182
180
|
runAgentWorker,
|
|
183
181
|
seedPolicy,
|
|
184
182
|
serveAdmin,
|
package/dist/index.js.map
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../src/index.ts"],
|
|
4
|
-
"sourcesContent": ["export {\n ADOBE,\n ADOBE_PROXY,\n type AdobeConfig,\n type AdobeModelInfo,\n adobeClassifiers,\n adobeConfig,\n adobeIdentity,\n adobeModel,\n adobeProvider,\n adobeUsage,\n type Budget,\n SESSION_HEADER,\n VERSION_HEADER,\n withAdobeIdentity,\n} from './adobe.ts';\nexport { type Agent, type AgentOptions, answerText, openAgent } from './agent.ts';\nexport {\n APPROVAL_MS,\n type Approval,\n type ApprovalAnswer,\n type ApprovalDecided,\n type ApprovalDraft,\n type ApprovalJudge,\n type ApprovalKind,\n type ApprovalRequester,\n type ApprovalState,\n type Approvals,\n ApprovalsDoc,\n type ApprovalTier,\n type ApprovalVerdict,\n ASK_MIN_MS,\n approvalJudge,\n attachApprovals,\n DEFAULT_POLICY,\n type DecidedBy,\n type Decider,\n JUDGE_ALLOW,\n
|
|
5
|
-
"mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EAGA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAwC,YAAY,iBAAiB;AACrE;AAAA,EACE;AAAA,EAUA;AAAA,EAGA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAGA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,
|
|
4
|
+
"sourcesContent": ["export {\n ADOBE,\n ADOBE_PROXY,\n type AdobeConfig,\n type AdobeModelInfo,\n adobeClassifiers,\n adobeConfig,\n adobeIdentity,\n adobeModel,\n adobeProvider,\n adobeUsage,\n type Budget,\n SESSION_HEADER,\n VERSION_HEADER,\n withAdobeIdentity,\n} from './adobe.ts';\nexport { type Agent, type AgentOptions, answerText, openAgent } from './agent.ts';\nexport {\n APPROVAL_MS,\n type Approval,\n type ApprovalAnswer,\n type ApprovalDecided,\n type ApprovalDraft,\n type ApprovalJudge,\n type ApprovalKind,\n type ApprovalRequester,\n type ApprovalState,\n type Approvals,\n ApprovalsDoc,\n type ApprovalTier,\n type ApprovalVerdict,\n ASK_MIN_MS,\n approvalJudge,\n attachApprovals,\n DEFAULT_POLICY,\n type DecidedBy,\n type Decider,\n JUDGE_ALLOW,\n JUDGE_KIND,\n JUDGE_MODEL,\n JUDGE_QUESTIONS,\n type Judgement,\n judgeModelOf,\n judgeSpender,\n judgeState,\n type OwnerIntent,\n ownerIntent,\n POLICY_FILE,\n REASONS,\n route,\n seedPolicy,\n VERDICT_REASONS,\n verdictOf,\n verdictRecorder,\n} from './approvals/index.ts';\nexport {\n type ApprovalPolicy,\n type ApprovalPolicyChange,\n type ApprovalPolicySet,\n DEFAULT_APPROVAL_POLICY,\n type SudoPolicy,\n} from './approvals/policy.ts';\nexport type {\n AgentSudo,\n SudoAnswer,\n SudoDenial,\n SudoReply,\n SudoRequest,\n} from './approvals/sudo.ts';\nexport {\n FILE_LIMIT,\n IMAGE_LIMIT,\n type SendAttachment,\n type ShownAttachment,\n splitUser,\n TOTAL_LIMIT,\n userParts,\n} from './attachments.ts';\nexport { type AgentConnection, connectAgent } from './client.ts';\nexport type { Clock } from './clock.ts';\nexport { createAgentControl } from './control.ts';\nexport {\n connectGuest,\n GUEST_ONLY,\n type GuestConnection,\n SEAT_REFUSED,\n} from './guests/client.ts';\nexport type { GuestOpened, Proposed, ProposeRequest } from './guests/index.ts';\nexport type { GateKind, GuestPolicy } from './guests/policy.ts';\nexport type { GuestDraft, GuestGate, GuestGates, GuestSeat } from './guests/seats.ts';\nexport { type AgentHost, type ConnectOptions, hostAgent } from './host.ts';\nexport type {\n KernelClient,\n KernelFs,\n KernelProcess,\n KernelStat,\n SpawnOptions,\n} from './kernel/client.ts';\nexport { HOME, type KernelEnvOptions, kernelEnvironment, SliccKernelEnv } from './kernel/env.ts';\nexport {\n adminOver,\n type KernelAdmin,\n type KernelGroup,\n type KernelGroups,\n type KernelUser,\n type KernelUsers,\n serveAdmin,\n type UserClient,\n type UserClients,\n type UserConnect,\n type UserSpec,\n userClients,\n} from './kernel/users.ts';\nexport {\n type AgentWorkerOptions,\n type AgentWorkerScope,\n type KernelAttach,\n runAgentWorker,\n} from './main.ts';\nexport {\n type Loopback,\n type Transport,\n type TransportResponse,\n transportFetch,\n} from './net.ts';\nexport {\n AGENT_LOCK,\n type AgentOwner,\n type AgentWorker,\n type KernelSource,\n type OwnerOptions,\n startAgent,\n} from './owner.ts';\nexport { SliccPrompt, sliccPrompt } from './prompt.ts';\nexport {\n type AgentPages,\n createPages,\n type PageBatch,\n type PageCaller,\n type PageRequest,\n type PageResult,\n type Pages,\n type PagesOpened,\n type PageTab,\n} from './remote/pages.ts';\nexport {\n type AccountState,\n AgentControl,\n type AgentInventory,\n AgentInventoryService,\n AgentPagesService,\n AgentSettings,\n type AgentSettingsChange,\n AgentTranscript,\n type BudgetState,\n INVENTORY_STATUSES,\n type InventoryAgent,\n type InventoryRow,\n type InventorySnapshot,\n type InventoryState,\n type InventoryStatus,\n type McpEdit,\n type McpRefusal,\n type McpRefusalCode,\n type McpRefusals,\n type ModelChoice,\n type OperationError,\n type PromptResult,\n type SendMode,\n type SendRequest,\n type SendResponse,\n type SettingsState,\n type SignIn,\n} from './services.ts';\nexport {\n BEDROCK,\n createAgentSettings,\n createSliccModels,\n DEFAULT_MODEL,\n DEFAULT_REGIONS,\n PREFERRED_MODELS,\n preferredModel,\n resolveDefaultModel,\n sliccProviders,\n withDefaultRegions,\n} from './settings.ts';\nexport {\n AGENT_DIRECTORY,\n type OpfsSqliteOptions,\n openMemorySqliteStorage,\n openOpfsSqliteStorage,\n WasmSqliteDatabase,\n} from './sqlite.ts';\nexport { type SystemFacts, systemSection } from './system.ts';\nexport { UPLOADS, type Uploads, upload } from './uploads.ts';\nexport { type PortEndpoint, PortLink } from './wire.ts';\nexport {\n type KernelPorts,\n kernelPort,\n kernelPorts,\n serveConnections,\n type WorkerScope,\n} from './worker.ts';\n"],
|
|
5
|
+
"mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EAGA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAwC,YAAY,iBAAiB;AACrE;AAAA,EACE;AAAA,EAUA;AAAA,EAGA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAGA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EAIE;AAAA,OAEK;AAQP;AAAA,EACE;AAAA,EACA;AAAA,EAGA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAA+B,oBAAoB;AAEnD,SAAS,0BAA0B;AACnC;AAAA,EACE;AAAA,EACA;AAAA,EAEA;AAAA,OACK;AAIP,SAA8C,iBAAiB;AAQ/D,SAAS,MAA6B,mBAAmB,sBAAsB;AAC/E;AAAA,EACE;AAAA,EAMA;AAAA,EAKA;AAAA,OACK;AACP;AAAA,EAIE;AAAA,OACK;AACP;AAAA,EAIE;AAAA,OACK;AACP;AAAA,EACE;AAAA,EAKA;AAAA,OACK;AACP,SAAS,aAAa,mBAAmB;AACzC;AAAA,EAEE;AAAA,OAQK;AACP;AAAA,EAEE;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EAEA;AAAA,OAkBK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAA2B,qBAAqB;AAChD,SAAS,SAAuB,cAAc;AAC9C,SAA4B,gBAAgB;AAC5C;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
|
@@ -253,7 +253,6 @@ function cgiRunner(limits = CGI_LIMITS, now = () => /* @__PURE__ */ new Date())
|
|
|
253
253
|
sprinkle: site.id,
|
|
254
254
|
user: kernel.user
|
|
255
255
|
});
|
|
256
|
-
count(site.id, 1);
|
|
257
256
|
const ended = (code) => {
|
|
258
257
|
count(site.id, -1);
|
|
259
258
|
log(fs, site.folder, script, run.end(code));
|
|
@@ -293,12 +292,11 @@ function cgiRunner(limits = CGI_LIMITS, now = () => /* @__PURE__ */ new Date())
|
|
|
293
292
|
return cgiReply(503, `${site.id} runs ${limits.parallel} scripts already`, [
|
|
294
293
|
["Retry-After", "1"]
|
|
295
294
|
]);
|
|
295
|
+
count(site.id, 1);
|
|
296
296
|
const fs = kernel.client.fs;
|
|
297
|
-
const found = await uidOf(fs, kernel.user).then(
|
|
298
|
-
(uid) => locate(fs, site.folder, parts.script, uid),
|
|
299
|
-
(error) => ({ status: 403, reason: error.message })
|
|
300
|
-
);
|
|
297
|
+
const found = await uidOf(fs, kernel.user).then((uid) => locate(fs, site.folder, parts.script, uid)).catch((error) => ({ status: 403, reason: error.message }));
|
|
301
298
|
if (!("status" in found)) return found.path;
|
|
299
|
+
count(site.id, -1);
|
|
302
300
|
if (found.status === 403) log(fs, site.folder, parts.script, found.reason);
|
|
303
301
|
return cgiReply(found.status, found.reason);
|
|
304
302
|
};
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../src/sprinkles/cgi-run.ts"],
|
|
4
|
-
"sourcesContent": ["import type { KernelClient, KernelFs, KernelProcess, SpawnOptions } from '../kernel/client.ts';\nimport { dirname } from '../kernel/paths.ts';\nimport {\n CGI_DIR,\n CGI_LIMITS,\n type CgiHead,\n type CgiHeaders,\n type CgiRequest,\n cgiEnv,\n inside,\n methodOf,\n openTo,\n parseHead,\n REASONS,\n scriptOf,\n shebang,\n tagOf,\n toBase64,\n} from './cgi.ts';\n\nexport interface CgiKernel {\n client: KernelClient;\n user: string;\n}\n\nexport interface CgiSite {\n id: string;\n folder: string;\n owner: string;\n}\n\nexport interface CgiReply {\n status: number;\n statusText: string;\n headers: CgiHeaders;\n body: string;\n done: boolean;\n stream: string | null;\n}\n\nexport interface CgiChunk {\n body: string;\n done: boolean;\n}\n\nexport interface CgiRunner {\n start(site: CgiSite, kernel: CgiKernel, request: CgiRequest): Promise<CgiReply>;\n read(stream: string, sprinkle: string): Promise<CgiChunk>;\n close(stream: string, sprinkle: string): void;\n stop(): void;\n}\n\nexport type CgiLimits = typeof CGI_LIMITS;\n\ntype Found = { path: string } | { status: 403 | 404; reason: string };\n\nconst missing = (reason: string): Found => ({ status: 404, reason });\n\nasync function real(fs: KernelFs, path: string): Promise<string | undefined> {\n return fs.realpath(path).catch(() => undefined);\n}\n\nexport async function locate(\n fs: KernelFs,\n folder: string,\n script: string,\n uid: number\n): Promise<Found> {\n const root = await real(fs, folder);\n if (!root) return missing(`${folder} is gone`);\n const bin = await real(fs, `${folder}/${CGI_DIR}`);\n if (!bin || !inside(bin, root)) return missing(`${folder} has no ${CGI_DIR}/`);\n const path = await real(fs, `${folder}/${CGI_DIR}/${script}`);\n if (!path || !inside(path, root)) return missing(`${CGI_DIR}/${script} isn't there`);\n const stat = await fs.stat(path).catch(() => undefined);\n if (!stat?.isFile) return missing(`${CGI_DIR}/${script} is no file`);\n for (const each of new Set([root, bin, dirname(path), path])) {\n const why = openTo(await fs.stat(each), uid);\n if (why) return { status: 403, reason: `${each} is refused: ${why}` };\n }\n return { path };\n}\n\nexport async function uidOf(fs: KernelFs, user: string): Promise<number> {\n if (user === 'root') return 0;\n const passwd = await fs.readText('/etc/passwd').catch(() => '');\n const line = passwd.split('\\n').find((entry) => entry.startsWith(`${user}:`));\n const uid = Number(line?.split(':')[2] ?? Number.NaN);\n if (!Number.isInteger(uid)) throw new Error(`there is no kernel user ${user}`);\n return uid;\n}\n\nasync function launch(\n client: KernelClient,\n path: string,\n options: SpawnOptions\n): Promise<KernelProcess> {\n try {\n return await client.spawn([path], options);\n } catch (error) {\n if ((error as { code?: unknown }).code !== 'EACCES') throw error;\n const line = shebang(await client.fs.readFile(path));\n if (!line) throw new Error(`${path} can't run: it has no #! line`);\n return client.spawn([...line, path], options);\n }\n}\n\nfunction joined(parts: readonly Uint8Array[]): Uint8Array {\n const out = new Uint8Array(parts.reduce((sum, part) => sum + part.length, 0));\n let at = 0;\n for (const part of parts) {\n out.set(part, at);\n at += part.length;\n }\n return out;\n}\n\nexport function cgiReply(status: number, text: string, more: CgiHeaders = []): CgiReply {\n return {\n status,\n statusText: REASONS[status] ?? '',\n headers: [['Content-Type', 'text/plain; charset=utf-8'], ...more],\n body: toBase64(new TextEncoder().encode(text ? `${text}\\n` : '')),\n done: true,\n stream: null,\n };\n}\n\nfunction plain(status: number): CgiHead {\n return { status, statusText: REASONS[status] ?? '', headers: [['Content-Type', 'text/plain']] };\n}\n\nexport async function appendLog(fs: KernelFs, path: string, text: string, max: number) {\n const old = await fs.readFile(path).catch(() => new Uint8Array());\n let all = joined([old, new TextEncoder().encode(text)]);\n if (all.length > max) {\n const cut = all.indexOf(10, all.length - Math.floor(max / 2));\n all = all.subarray(cut < 0 ? all.length - Math.floor(max / 2) : cut + 1);\n }\n await fs.writeFile(path, all);\n}\n\nfunction lines(at: Date, script: string, text: string): string {\n const stamp = at.toISOString();\n return text\n .split('\\n')\n .filter((line) => line.trim())\n .map((line) => `[${stamp}] ${script}: ${line}\\n`)\n .join('');\n}\n\nconst encode = (text: string) => new TextEncoder().encode(text);\n\nexport class CgiRun {\n readonly sprinkle: string;\n readonly answered: Promise<CgiReply>;\n process: KernelProcess | undefined;\n ended = false;\n why: string | undefined;\n readonly #limits: CgiLimits;\n readonly #publish: (run: CgiRun) => string;\n readonly #settle: (reply: CgiReply) => void;\n #early: Uint8Array[] = [];\n #queue: Uint8Array[] = [];\n #total = 0;\n #errors: Uint8Array[] = [];\n #errorBytes = 0;\n #head: CgiHead | undefined;\n #waiting: (() => void)[] = [];\n readonly #bodiless: boolean;\n\n constructor(\n sprinkle: string,\n limits: CgiLimits,\n publish: (run: CgiRun) => string,\n bodiless = false\n ) {\n this.sprinkle = sprinkle;\n this.#bodiless = bodiless;\n this.#limits = limits;\n this.#publish = publish;\n const { promise, resolve } = Promise.withResolvers<CgiReply>();\n this.answered = promise;\n this.#settle = resolve;\n }\n\n stop(why: string): void {\n this.why ??= why;\n void this.process?.signal('SIGKILL');\n }\n\n fail(message: string): void {\n this.#settle(cgiReply(500, message));\n }\n\n readonly out = (bytes: Uint8Array): void => {\n if (this.ended || this.why) return;\n this.#total += bytes.length;\n if (this.#total > this.#limits.output) {\n this.stop(`its output passed ${this.#limits.output} bytes`);\n return;\n }\n if (this.#head) {\n this.#queue.push(bytes);\n this.#wake();\n return;\n }\n this.#early.push(bytes);\n this.#headed(false);\n };\n\n readonly err = (bytes: Uint8Array): void => {\n const room = this.#limits.stderr - this.#errorBytes;\n if (room <= 0) return;\n const kept = bytes.subarray(0, room);\n this.#errors.push(kept);\n this.#errorBytes += kept.length;\n };\n\n end(code: number | undefined): string {\n this.ended = true;\n const stderr = new TextDecoder().decode(joined(this.#errors));\n if (!this.#head && this.#total === 0) this.#silent(code, stderr);\n else this.#headed(true);\n this.#wake();\n const timeout = `timed out after ${this.#limits.timeoutMs / 1000} s`;\n return [\n stderr,\n this.why === 'timeout' ? timeout : this.why,\n code === undefined || code === 0 ? undefined : `exited ${code}`,\n ]\n .filter(Boolean)\n .join('\\n');\n }\n\n drain(): string {\n const body = this.#bodiless ? '' : toBase64(joined(this.#queue));\n this.#queue = [];\n return body;\n }\n\n get pending(): boolean {\n return this.#queue.length > 0;\n }\n\n wait(ms: number, later: (ms: number, run: () => void) => () => void): Promise<void> {\n if (this.pending || this.ended) return Promise.resolve();\n return new Promise((resolve) => {\n const cancel = later(ms, resolve);\n this.#waiting.push(() => {\n cancel();\n resolve();\n });\n });\n }\n\n #wake(): void {\n for (const resolve of this.#waiting.splice(0)) resolve();\n }\n\n #silent(code: number | undefined, stderr: string): void {\n const status = this.why === 'timeout' ? 504 : code === undefined ? 502 : code ? 500 : 200;\n this.#head = plain(status);\n const said = stderr || (this.why === 'timeout' ? 'timed out\\n' : `exit ${code ?? '?'}\\n`);\n if (status !== 200) this.#queue.push(encode(said));\n this.#answer();\n }\n\n #headed(ended: boolean): void {\n if (this.#head) return;\n const bytes = joined(this.#early);\n const parsed = parseHead(bytes, ended);\n if (parsed.kind === 'more') return;\n this.#early = [];\n if (parsed.kind === 'head') {\n this.#head = parsed.head;\n if (parsed.body.length) this.#queue.push(parsed.body);\n } else if (parsed.kind === 'body') {\n this.#head = plain(200);\n this.#queue.push(bytes);\n } else {\n this.#head = plain(502);\n this.#queue.push(encode(`${parsed.reason}\\n`));\n this.stop(parsed.reason);\n }\n this.#answer();\n }\n\n #answer(): void {\n const head = this.#head as CgiHead;\n const done = this.ended && !this.pending;\n const stream = done ? null : this.#publish(this);\n this.#settle({ ...head, body: this.drain(), done, stream });\n }\n}\n\nexport function cgiRunner(\n limits: CgiLimits = CGI_LIMITS,\n now: () => Date = () => new Date()\n): CgiRunner {\n const running = new Map<string, number>();\n const streams = new Map<string, CgiRun>();\n const logs = new Map<string, Promise<void>>();\n const timers = new Set<ReturnType<typeof setTimeout>>();\n const later = (ms: number, run: () => void) => {\n const timer = setTimeout(() => {\n timers.delete(timer);\n run();\n }, ms);\n timers.add(timer);\n return () => {\n clearTimeout(timer);\n timers.delete(timer);\n };\n };\n const count = (id: string, by: number) => running.set(id, (running.get(id) ?? 0) + by);\n const log = (fs: KernelFs, folder: string, script: string, text: string) => {\n const added = lines(now(), script, text);\n if (!added) return;\n const path = `${folder}/error.log`;\n const next = (logs.get(path) ?? Promise.resolve())\n .then(() => appendLog(fs, path, added, limits.log))\n .catch(() => undefined);\n logs.set(path, next);\n };\n const publish = (run: CgiRun) => {\n const id = crypto.randomUUID();\n streams.set(id, run);\n return id;\n };\n const execute = (site: CgiSite, kernel: CgiKernel, request: CgiRequest, path: string) => {\n const { script, pathInfo } = scriptOf(request.path) as { script: string; pathInfo: string };\n const run = new CgiRun(site.id, limits, publish, request.method === 'HEAD');\n const fs = kernel.client.fs;\n const env = cgiEnv({\n request,\n script,\n pathInfo,\n ...site,\n sprinkle: site.id,\n user: kernel.user,\n });\n count(site.id, 1);\n const ended = (code: number | undefined) => {\n count(site.id, -1);\n log(fs, site.folder, script, run.end(code));\n later(limits.keepMs, () => {\n for (const [id, kept] of streams) if (kept === run) streams.delete(id);\n });\n };\n const started = (process: KernelProcess) => {\n run.process = process;\n if (run.why) void process.signal('SIGKILL');\n const cancel = later(limits.timeoutMs, () => run.stop('timeout'));\n process.exited\n .then(\n (code) => ended(code),\n () => ended(undefined)\n )\n .finally(cancel);\n };\n launch(kernel.client, path, {\n cwd: site.folder,\n env,\n tag: tagOf(site.id),\n ...(request.body ? { stdin: request.body } : {}),\n onStdout: run.out,\n onStderr: run.err,\n }).then(started, (error: Error) => {\n count(site.id, -1);\n log(fs, site.folder, script, error.message);\n run.fail(error.message);\n });\n return run.answered;\n };\n const refused = async (site: CgiSite, kernel: CgiKernel, request: CgiRequest) => {\n const parts = scriptOf(request.path);\n if (!parts) return cgiReply(404, `there is no ${CGI_DIR}/${request.path}`);\n if (request.body && request.body.length > limits.input)\n return cgiReply(413, `a ${CGI_DIR} request body is at most ${limits.input} bytes`);\n if ((running.get(site.id) ?? 0) >= limits.parallel)\n return cgiReply(503, `${site.id} runs ${limits.parallel} scripts already`, [\n ['Retry-After', '1'],\n ]);\n const fs = kernel.client.fs;\n const found = await uidOf(fs, kernel.user).then(\n (uid) => locate(fs, site.folder, parts.script, uid),\n (error: Error): Found => ({ status: 403, reason: error.message })\n );\n if (!('status' in found)) return found.path;\n if (found.status === 403) log(fs, site.folder, parts.script, found.reason);\n return cgiReply(found.status, found.reason);\n };\n return {\n async start(site, kernel, request) {\n const method = methodOf(request.method);\n if (!method) return cgiReply(400, 'the method is no HTTP token');\n const path = await refused(site, kernel, request);\n return typeof path === 'string' ? execute(site, kernel, { ...request, method }, path) : path;\n },\n async read(stream, sprinkle) {\n const run = streams.get(stream);\n if (run?.sprinkle !== sprinkle) throw new Error(`there is no ${CGI_DIR} stream ${stream}`);\n await run.wait(limits.pollMs, later);\n const body = run.drain();\n if (run.ended) streams.delete(stream);\n return { body, done: run.ended };\n },\n close(stream, sprinkle) {\n const run = streams.get(stream);\n if (run?.sprinkle !== sprinkle) return;\n streams.delete(stream);\n run.stop('the frame stopped reading its output');\n },\n stop() {\n for (const timer of timers) clearTimeout(timer);\n timers.clear();\n for (const run of new Set(streams.values())) run.stop('the worker closed');\n streams.clear();\n },\n };\n}\n"],
|
|
5
|
-
"mappings": "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
|
|
4
|
+
"sourcesContent": ["import type { KernelClient, KernelFs, KernelProcess, SpawnOptions } from '../kernel/client.ts';\nimport { dirname } from '../kernel/paths.ts';\nimport {\n CGI_DIR,\n CGI_LIMITS,\n type CgiHead,\n type CgiHeaders,\n type CgiRequest,\n cgiEnv,\n inside,\n methodOf,\n openTo,\n parseHead,\n REASONS,\n scriptOf,\n shebang,\n tagOf,\n toBase64,\n} from './cgi.ts';\n\nexport interface CgiKernel {\n client: KernelClient;\n user: string;\n}\n\nexport interface CgiSite {\n id: string;\n folder: string;\n owner: string;\n}\n\nexport interface CgiReply {\n status: number;\n statusText: string;\n headers: CgiHeaders;\n body: string;\n done: boolean;\n stream: string | null;\n}\n\nexport interface CgiChunk {\n body: string;\n done: boolean;\n}\n\nexport interface CgiRunner {\n start(site: CgiSite, kernel: CgiKernel, request: CgiRequest): Promise<CgiReply>;\n read(stream: string, sprinkle: string): Promise<CgiChunk>;\n close(stream: string, sprinkle: string): void;\n stop(): void;\n}\n\nexport type CgiLimits = typeof CGI_LIMITS;\n\ntype Found = { path: string } | { status: 403 | 404; reason: string };\n\nconst missing = (reason: string): Found => ({ status: 404, reason });\n\nasync function real(fs: KernelFs, path: string): Promise<string | undefined> {\n return fs.realpath(path).catch(() => undefined);\n}\n\nexport async function locate(\n fs: KernelFs,\n folder: string,\n script: string,\n uid: number\n): Promise<Found> {\n const root = await real(fs, folder);\n if (!root) return missing(`${folder} is gone`);\n const bin = await real(fs, `${folder}/${CGI_DIR}`);\n if (!bin || !inside(bin, root)) return missing(`${folder} has no ${CGI_DIR}/`);\n const path = await real(fs, `${folder}/${CGI_DIR}/${script}`);\n if (!path || !inside(path, root)) return missing(`${CGI_DIR}/${script} isn't there`);\n const stat = await fs.stat(path).catch(() => undefined);\n if (!stat?.isFile) return missing(`${CGI_DIR}/${script} is no file`);\n for (const each of new Set([root, bin, dirname(path), path])) {\n const why = openTo(await fs.stat(each), uid);\n if (why) return { status: 403, reason: `${each} is refused: ${why}` };\n }\n return { path };\n}\n\nexport async function uidOf(fs: KernelFs, user: string): Promise<number> {\n if (user === 'root') return 0;\n const passwd = await fs.readText('/etc/passwd').catch(() => '');\n const line = passwd.split('\\n').find((entry) => entry.startsWith(`${user}:`));\n const uid = Number(line?.split(':')[2] ?? Number.NaN);\n if (!Number.isInteger(uid)) throw new Error(`there is no kernel user ${user}`);\n return uid;\n}\n\nasync function launch(\n client: KernelClient,\n path: string,\n options: SpawnOptions\n): Promise<KernelProcess> {\n try {\n return await client.spawn([path], options);\n } catch (error) {\n if ((error as { code?: unknown }).code !== 'EACCES') throw error;\n const line = shebang(await client.fs.readFile(path));\n if (!line) throw new Error(`${path} can't run: it has no #! line`);\n return client.spawn([...line, path], options);\n }\n}\n\nfunction joined(parts: readonly Uint8Array[]): Uint8Array {\n const out = new Uint8Array(parts.reduce((sum, part) => sum + part.length, 0));\n let at = 0;\n for (const part of parts) {\n out.set(part, at);\n at += part.length;\n }\n return out;\n}\n\nexport function cgiReply(status: number, text: string, more: CgiHeaders = []): CgiReply {\n return {\n status,\n statusText: REASONS[status] ?? '',\n headers: [['Content-Type', 'text/plain; charset=utf-8'], ...more],\n body: toBase64(new TextEncoder().encode(text ? `${text}\\n` : '')),\n done: true,\n stream: null,\n };\n}\n\nfunction plain(status: number): CgiHead {\n return { status, statusText: REASONS[status] ?? '', headers: [['Content-Type', 'text/plain']] };\n}\n\nexport async function appendLog(fs: KernelFs, path: string, text: string, max: number) {\n const old = await fs.readFile(path).catch(() => new Uint8Array());\n let all = joined([old, new TextEncoder().encode(text)]);\n if (all.length > max) {\n const cut = all.indexOf(10, all.length - Math.floor(max / 2));\n all = all.subarray(cut < 0 ? all.length - Math.floor(max / 2) : cut + 1);\n }\n await fs.writeFile(path, all);\n}\n\nfunction lines(at: Date, script: string, text: string): string {\n const stamp = at.toISOString();\n return text\n .split('\\n')\n .filter((line) => line.trim())\n .map((line) => `[${stamp}] ${script}: ${line}\\n`)\n .join('');\n}\n\nconst encode = (text: string) => new TextEncoder().encode(text);\n\nexport class CgiRun {\n readonly sprinkle: string;\n readonly answered: Promise<CgiReply>;\n process: KernelProcess | undefined;\n ended = false;\n why: string | undefined;\n readonly #limits: CgiLimits;\n readonly #publish: (run: CgiRun) => string;\n readonly #settle: (reply: CgiReply) => void;\n #early: Uint8Array[] = [];\n #queue: Uint8Array[] = [];\n #total = 0;\n #errors: Uint8Array[] = [];\n #errorBytes = 0;\n #head: CgiHead | undefined;\n #waiting: (() => void)[] = [];\n readonly #bodiless: boolean;\n\n constructor(\n sprinkle: string,\n limits: CgiLimits,\n publish: (run: CgiRun) => string,\n bodiless = false\n ) {\n this.sprinkle = sprinkle;\n this.#bodiless = bodiless;\n this.#limits = limits;\n this.#publish = publish;\n const { promise, resolve } = Promise.withResolvers<CgiReply>();\n this.answered = promise;\n this.#settle = resolve;\n }\n\n stop(why: string): void {\n this.why ??= why;\n void this.process?.signal('SIGKILL');\n }\n\n fail(message: string): void {\n this.#settle(cgiReply(500, message));\n }\n\n readonly out = (bytes: Uint8Array): void => {\n if (this.ended || this.why) return;\n this.#total += bytes.length;\n if (this.#total > this.#limits.output) {\n this.stop(`its output passed ${this.#limits.output} bytes`);\n return;\n }\n if (this.#head) {\n this.#queue.push(bytes);\n this.#wake();\n return;\n }\n this.#early.push(bytes);\n this.#headed(false);\n };\n\n readonly err = (bytes: Uint8Array): void => {\n const room = this.#limits.stderr - this.#errorBytes;\n if (room <= 0) return;\n const kept = bytes.subarray(0, room);\n this.#errors.push(kept);\n this.#errorBytes += kept.length;\n };\n\n end(code: number | undefined): string {\n this.ended = true;\n const stderr = new TextDecoder().decode(joined(this.#errors));\n if (!this.#head && this.#total === 0) this.#silent(code, stderr);\n else this.#headed(true);\n this.#wake();\n const timeout = `timed out after ${this.#limits.timeoutMs / 1000} s`;\n return [\n stderr,\n this.why === 'timeout' ? timeout : this.why,\n code === undefined || code === 0 ? undefined : `exited ${code}`,\n ]\n .filter(Boolean)\n .join('\\n');\n }\n\n drain(): string {\n const body = this.#bodiless ? '' : toBase64(joined(this.#queue));\n this.#queue = [];\n return body;\n }\n\n get pending(): boolean {\n return this.#queue.length > 0;\n }\n\n wait(ms: number, later: (ms: number, run: () => void) => () => void): Promise<void> {\n if (this.pending || this.ended) return Promise.resolve();\n return new Promise((resolve) => {\n const cancel = later(ms, resolve);\n this.#waiting.push(() => {\n cancel();\n resolve();\n });\n });\n }\n\n #wake(): void {\n for (const resolve of this.#waiting.splice(0)) resolve();\n }\n\n #silent(code: number | undefined, stderr: string): void {\n const status = this.why === 'timeout' ? 504 : code === undefined ? 502 : code ? 500 : 200;\n this.#head = plain(status);\n const said = stderr || (this.why === 'timeout' ? 'timed out\\n' : `exit ${code ?? '?'}\\n`);\n if (status !== 200) this.#queue.push(encode(said));\n this.#answer();\n }\n\n #headed(ended: boolean): void {\n if (this.#head) return;\n const bytes = joined(this.#early);\n const parsed = parseHead(bytes, ended);\n if (parsed.kind === 'more') return;\n this.#early = [];\n if (parsed.kind === 'head') {\n this.#head = parsed.head;\n if (parsed.body.length) this.#queue.push(parsed.body);\n } else if (parsed.kind === 'body') {\n this.#head = plain(200);\n this.#queue.push(bytes);\n } else {\n this.#head = plain(502);\n this.#queue.push(encode(`${parsed.reason}\\n`));\n this.stop(parsed.reason);\n }\n this.#answer();\n }\n\n #answer(): void {\n const head = this.#head as CgiHead;\n const done = this.ended && !this.pending;\n const stream = done ? null : this.#publish(this);\n this.#settle({ ...head, body: this.drain(), done, stream });\n }\n}\n\nexport function cgiRunner(\n limits: CgiLimits = CGI_LIMITS,\n now: () => Date = () => new Date()\n): CgiRunner {\n const running = new Map<string, number>();\n const streams = new Map<string, CgiRun>();\n const logs = new Map<string, Promise<void>>();\n const timers = new Set<ReturnType<typeof setTimeout>>();\n const later = (ms: number, run: () => void) => {\n const timer = setTimeout(() => {\n timers.delete(timer);\n run();\n }, ms);\n timers.add(timer);\n return () => {\n clearTimeout(timer);\n timers.delete(timer);\n };\n };\n const count = (id: string, by: number) => running.set(id, (running.get(id) ?? 0) + by);\n const log = (fs: KernelFs, folder: string, script: string, text: string) => {\n const added = lines(now(), script, text);\n if (!added) return;\n const path = `${folder}/error.log`;\n const next = (logs.get(path) ?? Promise.resolve())\n .then(() => appendLog(fs, path, added, limits.log))\n .catch(() => undefined);\n logs.set(path, next);\n };\n const publish = (run: CgiRun) => {\n const id = crypto.randomUUID();\n streams.set(id, run);\n return id;\n };\n const execute = (site: CgiSite, kernel: CgiKernel, request: CgiRequest, path: string) => {\n const { script, pathInfo } = scriptOf(request.path) as { script: string; pathInfo: string };\n const run = new CgiRun(site.id, limits, publish, request.method === 'HEAD');\n const fs = kernel.client.fs;\n const env = cgiEnv({\n request,\n script,\n pathInfo,\n ...site,\n sprinkle: site.id,\n user: kernel.user,\n });\n const ended = (code: number | undefined) => {\n count(site.id, -1);\n log(fs, site.folder, script, run.end(code));\n later(limits.keepMs, () => {\n for (const [id, kept] of streams) if (kept === run) streams.delete(id);\n });\n };\n const started = (process: KernelProcess) => {\n run.process = process;\n if (run.why) void process.signal('SIGKILL');\n const cancel = later(limits.timeoutMs, () => run.stop('timeout'));\n process.exited\n .then(\n (code) => ended(code),\n () => ended(undefined)\n )\n .finally(cancel);\n };\n launch(kernel.client, path, {\n cwd: site.folder,\n env,\n tag: tagOf(site.id),\n ...(request.body ? { stdin: request.body } : {}),\n onStdout: run.out,\n onStderr: run.err,\n }).then(started, (error: Error) => {\n count(site.id, -1);\n log(fs, site.folder, script, error.message);\n run.fail(error.message);\n });\n return run.answered;\n };\n const refused = async (site: CgiSite, kernel: CgiKernel, request: CgiRequest) => {\n const parts = scriptOf(request.path);\n if (!parts) return cgiReply(404, `there is no ${CGI_DIR}/${request.path}`);\n if (request.body && request.body.length > limits.input)\n return cgiReply(413, `a ${CGI_DIR} request body is at most ${limits.input} bytes`);\n if ((running.get(site.id) ?? 0) >= limits.parallel)\n return cgiReply(503, `${site.id} runs ${limits.parallel} scripts already`, [\n ['Retry-After', '1'],\n ]);\n count(site.id, 1);\n const fs = kernel.client.fs;\n const found = await uidOf(fs, kernel.user)\n .then((uid) => locate(fs, site.folder, parts.script, uid))\n .catch((error: Error): Found => ({ status: 403, reason: error.message }));\n if (!('status' in found)) return found.path;\n count(site.id, -1);\n if (found.status === 403) log(fs, site.folder, parts.script, found.reason);\n return cgiReply(found.status, found.reason);\n };\n return {\n async start(site, kernel, request) {\n const method = methodOf(request.method);\n if (!method) return cgiReply(400, 'the method is no HTTP token');\n const path = await refused(site, kernel, request);\n return typeof path === 'string' ? execute(site, kernel, { ...request, method }, path) : path;\n },\n async read(stream, sprinkle) {\n const run = streams.get(stream);\n if (run?.sprinkle !== sprinkle) throw new Error(`there is no ${CGI_DIR} stream ${stream}`);\n await run.wait(limits.pollMs, later);\n const body = run.drain();\n if (run.ended) streams.delete(stream);\n return { body, done: run.ended };\n },\n close(stream, sprinkle) {\n const run = streams.get(stream);\n if (run?.sprinkle !== sprinkle) return;\n streams.delete(stream);\n run.stop('the frame stopped reading its output');\n },\n stop() {\n for (const timer of timers) clearTimeout(timer);\n timers.clear();\n for (const run of new Set(streams.values())) run.stop('the worker closed');\n streams.clear();\n },\n };\n}\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
package/dist/titles/generate.js
CHANGED
|
@@ -30,13 +30,27 @@ function textOf(entry) {
|
|
|
30
30
|
function transcriptOf(entries) {
|
|
31
31
|
return entries.filter((entry) => entry.kind === "pi.user" || entry.kind === "pi.assistant").map((entry) => `${entry.kind === "pi.user" ? "User" : "Agent"}: ${textOf(entry)}`).join("\n");
|
|
32
32
|
}
|
|
33
|
-
async function scrubbed(raw) {
|
|
33
|
+
async function scrubbed(raw, limit = TRANSCRIPT_LENGTH) {
|
|
34
34
|
const redacted = redactSecrets(raw).text;
|
|
35
|
-
return (await scrubText(redacted)).slice(0,
|
|
35
|
+
return (await scrubText(redacted)).slice(0, limit);
|
|
36
36
|
}
|
|
37
37
|
function scrubTranscript(entries) {
|
|
38
38
|
return scrubbed(transcriptOf(entries));
|
|
39
39
|
}
|
|
40
|
+
async function completeText(models, found, text, max, options = {}) {
|
|
41
|
+
const message = await models.completeSimple(
|
|
42
|
+
found,
|
|
43
|
+
{
|
|
44
|
+
messages: [
|
|
45
|
+
{ role: "user", content: [{ type: "text", text }], timestamp: Date.now() }
|
|
46
|
+
]
|
|
47
|
+
},
|
|
48
|
+
{ maxTokens: max, ...options.signal ? { signal: options.signal } : {} }
|
|
49
|
+
);
|
|
50
|
+
if (message.stopReason === "error") return void 0;
|
|
51
|
+
const said = message.content.map((part) => part.type === "text" ? part.text : "").join("").trim();
|
|
52
|
+
return { text: said, answer: message };
|
|
53
|
+
}
|
|
40
54
|
function smallModel(models, settings, key, prompt, max) {
|
|
41
55
|
return async (transcript, model, context, admit = () => true) => {
|
|
42
56
|
const text = await settings(context);
|
|
@@ -46,24 +60,9 @@ function smallModel(models, settings, key, prompt, max) {
|
|
|
46
60
|
const ref = chosen ?? (provider && rest.length ? { provider, modelId: rest.join("/") } : null);
|
|
47
61
|
const found = ref ? models.getModel(ref.provider, ref.modelId) : void 0;
|
|
48
62
|
if (!found || !transcript || !admit()) return void 0;
|
|
49
|
-
|
|
50
|
-
found,
|
|
51
|
-
{
|
|
52
|
-
messages: [
|
|
53
|
-
{
|
|
54
|
-
role: "user",
|
|
55
|
-
content: [{ type: "text", text: `${prompt}
|
|
63
|
+
return completeText(models, found, `${prompt}
|
|
56
64
|
|
|
57
|
-
${transcript}
|
|
58
|
-
timestamp: Date.now()
|
|
59
|
-
}
|
|
60
|
-
]
|
|
61
|
-
},
|
|
62
|
-
{ maxTokens: max }
|
|
63
|
-
);
|
|
64
|
-
if (message.stopReason === "error") return void 0;
|
|
65
|
-
const said = message.content.map((part) => part.type === "text" ? part.text : "").join("").trim();
|
|
66
|
-
return { text: said, answer: message };
|
|
65
|
+
${transcript}`, max);
|
|
67
66
|
};
|
|
68
67
|
}
|
|
69
68
|
function titler(models, settings) {
|
|
@@ -77,6 +76,7 @@ export {
|
|
|
77
76
|
LABEL_PROMPT,
|
|
78
77
|
TITLE_PROMPT,
|
|
79
78
|
TRANSCRIPT_LENGTH,
|
|
79
|
+
completeText,
|
|
80
80
|
labeler,
|
|
81
81
|
labelsOn,
|
|
82
82
|
scrubTranscript,
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../src/titles/generate.ts"],
|
|
4
|
-
"sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport type { AssistantMessage, Message } from '@earendil-works/pi-ai';\nimport type { Models } from '@earendil-works/pi-ai/models';\nimport type { EntryRecord } from '@earendil-works/pi-durable';\nimport type { ExecutionEnv } from '@earendil-works/pi-durable/env';\nimport { answerText } from '../agent.ts';\nimport { extractSettings } from '../memory/extract.ts';\nimport { redactSecrets } from '../memory/format.ts';\nimport { scrubText } from '../secrets/scrub.ts';\n\nexport const TITLE_PROMPT =\n 'Give this chat a title of three to six words that says what it is about, in the language the user writes in. Answer with the title only, without quotes.';\n\nexport const LABEL_PROMPT =\n 'Label this group of tool runs in three to eight words, as an imperative that says what they do, such as \"Check the failing build logs\". Answer with the label only, without quotes.';\n\nexport const TRANSCRIPT_LENGTH = 4000;\n\ntype Switch = 'titles' | 'toolLabels';\n\nfunction settingOn(text: string | undefined, key: Switch): boolean {\n try {\n return (JSON.parse(text ?? '{}') as Record<string, unknown>)[key] !== false;\n } catch {\n return true;\n }\n}\n\nexport function titlesOn(text: string | undefined): boolean {\n return settingOn(text, 'titles');\n}\n\nexport function labelsOn(text: string | undefined): boolean {\n return settingOn(text, 'toolLabels');\n}\n\nexport function settingsText(\n env: Pick<ExecutionEnv, 'readTextFile'>,\n home: string,\n dir = `${home}/.pi/agent`\n): (context: Context) => Promise<string | undefined> {\n return async (context) => {\n const read = await env.readTextFile(`${dir}/settings.json`, context);\n return read.ok ? read.value : undefined;\n };\n}\n\nfunction textOf(entry: EntryRecord): string {\n return answerText(entry.model?.[0]?.content).trim();\n}\n\nexport function transcriptOf(entries: readonly EntryRecord[]): string {\n return entries\n .filter((entry) => entry.kind === 'pi.user' || entry.kind === 'pi.assistant')\n .map((entry) => `${entry.kind === 'pi.user' ? 'User' : 'Agent'}: ${textOf(entry)}`)\n .join('\\n');\n}\n\nexport async function scrubbed(raw: string): Promise<string> {\n const redacted = redactSecrets(raw).text;\n return (await scrubText(redacted)).slice(0,
|
|
5
|
-
"mappings": "AAKA,SAAS,kBAAkB;AAC3B,SAAS,uBAAuB;AAChC,SAAS,qBAAqB;AAC9B,SAAS,iBAAiB;AAEnB,MAAM,eACX;AAEK,MAAM,eACX;AAEK,MAAM,oBAAoB;AAIjC,SAAS,UAAU,MAA0B,KAAsB;AACjE,MAAI;AACF,WAAQ,KAAK,MAAM,QAAQ,IAAI,EAA8B,GAAG,MAAM;AAAA,EACxE,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,SAAS,MAAmC;AAC1D,SAAO,UAAU,MAAM,QAAQ;AACjC;AAEO,SAAS,SAAS,MAAmC;AAC1D,SAAO,UAAU,MAAM,YAAY;AACrC;AAEO,SAAS,aACd,KACA,MACA,MAAM,GAAG,IAAI,cACsC;AACnD,SAAO,OAAO,YAAY;AACxB,UAAM,OAAO,MAAM,IAAI,aAAa,GAAG,GAAG,kBAAkB,OAAO;AACnE,WAAO,KAAK,KAAK,KAAK,QAAQ;AAAA,EAChC;AACF;AAEA,SAAS,OAAO,OAA4B;AAC1C,SAAO,WAAW,MAAM,QAAQ,CAAC,GAAG,OAAO,EAAE,KAAK;AACpD;AAEO,SAAS,aAAa,SAAyC;AACpE,SAAO,QACJ,OAAO,CAAC,UAAU,MAAM,SAAS,aAAa,MAAM,SAAS,cAAc,EAC3E,IAAI,CAAC,UAAU,GAAG,MAAM,SAAS,YAAY,SAAS,OAAO,KAAK,OAAO,KAAK,CAAC,EAAE,EACjF,KAAK,IAAI;AACd;AAEA,eAAsB,SAAS,
|
|
4
|
+
"sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport type { Api, AssistantMessage, Message, Model } from '@earendil-works/pi-ai';\nimport type { Models } from '@earendil-works/pi-ai/models';\nimport type { EntryRecord } from '@earendil-works/pi-durable';\nimport type { ExecutionEnv } from '@earendil-works/pi-durable/env';\nimport { answerText } from '../agent.ts';\nimport { extractSettings } from '../memory/extract.ts';\nimport { redactSecrets } from '../memory/format.ts';\nimport { scrubText } from '../secrets/scrub.ts';\n\nexport const TITLE_PROMPT =\n 'Give this chat a title of three to six words that says what it is about, in the language the user writes in. Answer with the title only, without quotes.';\n\nexport const LABEL_PROMPT =\n 'Label this group of tool runs in three to eight words, as an imperative that says what they do, such as \"Check the failing build logs\". Answer with the label only, without quotes.';\n\nexport const TRANSCRIPT_LENGTH = 4000;\n\ntype Switch = 'titles' | 'toolLabels';\n\nfunction settingOn(text: string | undefined, key: Switch): boolean {\n try {\n return (JSON.parse(text ?? '{}') as Record<string, unknown>)[key] !== false;\n } catch {\n return true;\n }\n}\n\nexport function titlesOn(text: string | undefined): boolean {\n return settingOn(text, 'titles');\n}\n\nexport function labelsOn(text: string | undefined): boolean {\n return settingOn(text, 'toolLabels');\n}\n\nexport function settingsText(\n env: Pick<ExecutionEnv, 'readTextFile'>,\n home: string,\n dir = `${home}/.pi/agent`\n): (context: Context) => Promise<string | undefined> {\n return async (context) => {\n const read = await env.readTextFile(`${dir}/settings.json`, context);\n return read.ok ? read.value : undefined;\n };\n}\n\nfunction textOf(entry: EntryRecord): string {\n return answerText(entry.model?.[0]?.content).trim();\n}\n\nexport function transcriptOf(entries: readonly EntryRecord[]): string {\n return entries\n .filter((entry) => entry.kind === 'pi.user' || entry.kind === 'pi.assistant')\n .map((entry) => `${entry.kind === 'pi.user' ? 'User' : 'Agent'}: ${textOf(entry)}`)\n .join('\\n');\n}\n\nexport async function scrubbed(raw: string, limit = TRANSCRIPT_LENGTH): Promise<string> {\n const redacted = redactSecrets(raw).text;\n return (await scrubText(redacted)).slice(0, limit);\n}\n\nexport function scrubTranscript(entries: readonly EntryRecord[]): Promise<string> {\n return scrubbed(transcriptOf(entries));\n}\n\ntype Settings = (context: Context) => Promise<string | undefined>;\n\nexport type Asked = { text: string; answer: AssistantMessage };\n\nexport async function completeText(\n models: Pick<Models, 'completeSimple'>,\n found: Model<Api>,\n text: string,\n max: number,\n options: { signal?: AbortSignal } = {}\n): Promise<Asked | undefined> {\n const message = await models.completeSimple(\n found,\n {\n messages: [\n { role: 'user', content: [{ type: 'text', text }], timestamp: Date.now() } as Message,\n ],\n },\n { maxTokens: max, ...(options.signal ? { signal: options.signal } : {}) }\n );\n if (message.stopReason === 'error') return undefined;\n const said = message.content\n .map((part) => (part.type === 'text' ? part.text : ''))\n .join('')\n .trim();\n return { text: said, answer: message };\n}\n\nfunction smallModel(models: Models, settings: Settings, key: Switch, prompt: string, max: number) {\n return async (\n transcript: string,\n model: string,\n context: Context,\n admit: () => boolean = () => true\n ): Promise<Asked | undefined> => {\n const text = await settings(context);\n if (!settingOn(text, key)) return undefined;\n const chosen = extractSettings(text).model;\n const [provider, ...rest] = model.split('/');\n const ref = chosen ?? (provider && rest.length ? { provider, modelId: rest.join('/') } : null);\n const found = ref ? models.getModel(ref.provider, ref.modelId) : undefined;\n if (!found || !transcript || !admit()) return undefined;\n return completeText(models, found, `${prompt}\\n\\n${transcript}`, max);\n };\n}\n\nexport function titler(models: Models, settings: Settings) {\n const ask = smallModel(models, settings, 'titles', TITLE_PROMPT, 40);\n return async (transcript: string, model: string, context: Context) =>\n (await ask(transcript, model, context))?.text;\n}\n\nexport function labeler(models: Models, settings: Settings) {\n return smallModel(models, settings, 'toolLabels', LABEL_PROMPT, 40);\n}\n\nexport type Labeler = ReturnType<typeof labeler>;\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { Context } from '@earendil-works/chord';
|
|
2
|
-
import type { EntryRecord } from '@earendil-works/pi-durable';
|
|
2
|
+
import type { EntryRecord, ModelRef } from '@earendil-works/pi-durable';
|
|
3
3
|
import type { ExecutionEnv } from '@earendil-works/pi-durable/env';
|
|
4
4
|
import type { AgentsState } from '../agents.ts';
|
|
5
5
|
import type { MemoryEntry } from '../memory/format.ts';
|
|
@@ -25,6 +25,9 @@ export interface IntentSources {
|
|
|
25
25
|
context(context: Context): Promise<{
|
|
26
26
|
entries: readonly EntryRecord[];
|
|
27
27
|
}>;
|
|
28
|
+
agent?(context: Context): Promise<{
|
|
29
|
+
model?: ModelRef | null;
|
|
30
|
+
}>;
|
|
28
31
|
} | undefined>;
|
|
29
32
|
};
|
|
30
33
|
memories?: () => readonly MemoryEntry[] | undefined;
|