@ai-ecoverse/slicc-agent 7.32.0 → 7.33.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 CHANGED
@@ -64,6 +64,14 @@ const agent = await openAgent({ models, model, storage, registry, env: kernelEnv
64
64
  - string commands run as `bash -c`. All of one agent's commands share one process group: the first leads it and later ones join it with `spawn({ pgid })` (slicc-kernel ≥ 1.19.0, client protocol 1.3), so `ps -o pgid` and `kill -- -<pgid>` cover a whole scoop from any terminal.
65
65
  - **Fallbacks:** if the group has no live member left (`ESRCH`) or belongs to another session (`EPERM`), the command leads a new group that later commands join. On an older kernel (`ENOSYS`), every command leads its own group, as before.
66
66
  - **Timeouts and aborts** kill only that command: its descendants are read from `ps()` first, then all are killed together with it, so a background job the agent started earlier keeps running. A process forked in the instant between that snapshot and the kill can slip through; it ends when the agent's groups are stopped;
67
+ - **What a call ran.** A caller can pass `trace: { tag, report }` with an exec's options (the `slicc-ran` wrapper does, for every `bash` call, with the tag `call:<toolCallId>`). The env then subscribes `client.trace(tag)` before the spawn (slicc-kernel ≥ 1.180.0, client protocol 1.15), spawns with the tags `[taint?, tag]` (the taint tag, when the run has one, stays first and is still the one the groups and sightings track) and hands `report` what ran once it is over:
68
+ - **Programs:** the names of the programs the kernel's `exec` events show, the basename of `argv[0]` (else of `exe`), and for a `#!` script run by a path (`sh /tmp/bin/intent`, `node ./x.js`) the script's name instead of its interpreter's. The spawn's own launch chain (`bash -c <command>`, and the `fnox exec --shell-grants --` in front of it) and forks that exec nothing (a subshell or a pipeline element that only ran builtins) aren't programs, so `cd`, `for`, `printf` or `2>&1` never show. A program `bash` runs as its last command replaces bash (`replaced`) and still counts. They are ordered by CPU time (`utime + stime` of each process's `exit`, given to the image it ended as), then by first exec, without repeats. Arguments never leave the env, apart from the intent below.
69
+ - **Exits:** each program's status and signal, its first failure when it ran more than once. A failure is `quiet` when it isn't news: the exit of the spawn's own pid (its status is the call's exit code), a `SIGPIPE` (141) of a process that ran beside an unrelated one (the writer of a pipeline whose reader stopped, as `| head` does), and any process killed by a signal after the env itself ended the command (a timeout, an abort or held output).
70
+ - **Intent:** the first `--intent "…"` or `--intent=…` in the argv of an exec'd `intent` or `playwright-cli`, raw (at most 1000 characters).
71
+ - **Wall time** from the spawn to its exit, and `dropped`, the events the kernel dropped or the env didn't keep, when it isn't 0.
72
+ - **When it ends:** once every traced pid has exited, or 2 s after the spawned bash exits while a background job still runs, so a call waits at most 2 s more for a job that outlives it; then the subscription closes. An abandoned or lost command (`abandonOnAbort`, a kernel gone) closes it at once.
73
+ - **Bounds:** 64 program names, 1024 pids and 4096 queued events per call (`trace({ limit: 4096 })` in the kernel); what goes past them is counted in `more` or `dropped`. At most 16 programs are kept.
74
+ - **Older kernels:** a client without `trace`, a `trace` that fails (`ENOSYS` before protocol 1.15) or a spawn that refuses a tag list (`ENOSYS`) runs the command exactly as before, with no trace and nothing reported.
67
75
  - output past the spill limits goes to `/tmp/slicc-agent-output-*.log`;
68
76
  - files and directories go through the kernel's OPFS view and metadata sidecar;
69
77
  - `watch()` uses the kernel client's own `fs.watch` (slicc-kernel protocol 1.1), so a change made through the kernel by any process or client is reported in the same task. A watched path whose parent is renamed or replaced counts as changed, and a watched symbolic link also reports changes to its target. The kernel's watches are on names, so a target that doesn't exist yet is watched natively like any other and its creation is reported; the rest of its group isn't affected. A target under a symlinked directory is also watched at its real path (for a missing target, the real path of its nearest existing directory with the rest after it), and that is resolved again when the target or a directory above it changes. A missing target the client may not reach (`EACCES` under `users`) is left to the rescan, which retries its watch once it shows up. Writers that bypass the kernel, such as spectrum's Files panel writing OPFS directly, are caught by a rescan: every 2 s for a single file or directory (`watch: { rescanMs }`), and every 30 s for a recursive target (`watch: { deepRescanMs }`), at least 50 times the last rescan's duration later. On a kernel whose client watches also hear other kernels on the root and `postFsNotice` (it has `/proc/sys/kernel/slicc_meta_transactions`, read once per client with `cat`, and that shows shared metadata), recursive targets aren't rescanned at all unless `deepRescanMs` is set, so a writer outside the kernel has to post `postFsNotice` to be heard there. Only a kernel without `fs.watch` (`ENOSYS`) makes the whole watch poll; `watch: { mode: 'polling' }` forces that. Polling starts the next scan `intervalMs` after the last one finished (by default 2 s when a target is recursive, 500 ms otherwise), and at least 10 times the last scan's duration later. Scans never overlap or queue up: all watches of the worker take turns, one scan at a time, and each watch has at most one waiting.
@@ -500,9 +508,11 @@ pi durable keeps every conversation and entry in the session database, and has n
500
508
  - **Tool labels.** Spectrum groups tool runs into clusters and asks `AgentPort.toolLabel(agentId, callIds)` for a finished cluster of two or more runs. It asks `AgentPort.stepLabel(agentId, callId)` for a run that is going, the one run of a finished cluster, and every run of a cluster the user opens. The agent answers with a label of three to eight words that starts with a present participle, such as "Checking the failing build logs", or `null`, and spectrum keeps its own title or summary either way. Every source of a label reads the same way: the model's own intent, the titles below and both label prompts.
501
509
  - **Intents.** A wrapper (`slicc-intents`, like `slicc-images`) gives `bash` and `codemode` an optional `intent` argument, the first property of their schemas, so it streams before a long command or heredoc: "What this call does, as 2–6 words starting with a present participle, in the user's language, such as "Backing up the dataset's access list". At most 80 characters; a longer one is cut. No credentials, secrets or command output." The wrapper takes it out of the arguments before the tool runs, so the command runs unchanged. A nested `tools.bash()` in a codemode script gets the script's intent unless it sets its own. A trusted `bash` call runs with `SLICC_INTENT=<the cleaned intent>` in its environment, which every process it starts inherits (`playwright-cli` will read it). The schema sets no length limit, since pi's argument check would refuse the whole call, heredoc and all, for a long label: the intent is cleaned like a label instead (`cleanLabel`: whitespace, control and format characters such as bidi overrides and zero-width spaces, quotes and a final stop, cut to eight words and 80 characters), and secret-shaped text in it is redacted. The title cuts it again to 60 characters, like every title. `"toolIntents": false` in `~/.pi/agent/settings.json` leaves the field out of both schemas; it is read when the agent starts. The wrapper still strips an `intent` a call carries anyway, and such a call is titled, labelled and run as if it had none. The settings service says `toolIntents: true` only when intents are on, and the page titles a call by its intent only then.
502
510
  - **An intent is a claim, not a fact.** A call in a run the guest guard gates (one a guest started, or one that inherited guest or lick taint, as for images from command output) never shows its intent and never gets `SLICC_INTENT`; the guard's memo (`gatedRun`) decides that for the spawn. The page can't see a run's taints, so the guard writes entries it can see, with no model message, so the model never sees them. Before each model request of a tainted run it writes a `slicc.tainted` entry (one in a row), and the adapter shows no intent for the tool calls of the next assistant message, the streaming one included. Taint can also arrive after that request, such as a guest-tainted `agent send` or `agent rename` to a scoop that is already streaming, so the guard also writes a `slicc.gated-call` entry (`{ callId }`) for each model-issued call it gates, before it reviews it; that call then shows its parsed title, also after a reload. The adapter fails closed: the first assistant message of a window that doesn't start at the transcript's start shows no intent, since its marker may be outside the window, and a paged transcript with a gap not yet filled shows none at all. A guest's view and the frozen markdown leave intents out of the tool calls they hold. The guard's reviewer, the judge and the approval cards get the arguments without `intent` (`summary`, `arguments`, `args` and the Always hash), and so does a step's input in the chat: they show what runs, never what the model says it does.
503
- - **Step labels** come from the run's own name and arguments only, not its output, through the same model and scrubber, with their own prompt. While intents are on, a call that has an intent gets `null` without a label call, trusted or not: spectrum then shows its title, which is the intent for a trusted call and the parsed title for any other. The labellers never see an intent: it is left out of the arguments they get, for steps and clusters. A pull for a call the conversation doesn't have yet waits for it only while that call is going on, which spectrum sees while its arguments still stream: it is in the run's streaming message or tool slots in `pi.live`. Then it checks every 250 ms, for up to 30 seconds, until the call is written or leaves `pi.live`, so the label shows while the run still goes. Any other id, or one that isn't 1 to 256 characters without spaces, gets `null` at once. All pulls for one call share one wait, and each agent waits for at most 8 calls at a time and 60 a minute; over that, `null`. A watch-only seat never makes a label call or reads the conversation: it only waits for a label to show up, for at most 32 calls at a time per connection. A labelled call costs one label call, however many tabs ask, and its label is kept under `step:<call id>` in the same doc. Like clusters, only calls made after the agent started are labelled. Each agent makes at most 30 step labels a minute (`STEP_LABELS_PER_MINUTE`), apart from the cluster budget; a pull over it gets `null` and the run keeps its title.
504
- - **Titles without a label.** A trusted `bash` or `codemode` call with an intent is titled by it, and the title follows the intent as it streams. Otherwise titles are present participles too. A bash call's title names the programs its command runs, such as `Running cd, rm, mkdir and more` (up to three, before any heredoc), or `Running a command`; `read`, `write` and `edit` are `Reading foo.ts`, `Writing bar.ts` and `Editing baz.md`, `codemode` is `Running code`, and an MCP tool is `Calling <server> · <tool>`.
505
- - The label comes from the cluster's tool inputs and outputs (each output cut at 600 characters), through the title model and the title scrubber. A vault that is locked or not ready gives `null`, so no unscrubbed text goes out.
511
+ - **Step labels** come from the run's own name and arguments only, not its output, through the same model and scrubber, with their own prompt. A bash call that has run adds a line of what its trace saw, `ran: gcloud, bq, jq; bq exited 1` (or `ran: only shell builtins`), scrubbed with the rest. While intents are on, a call that has an intent gets `null` without a label call, trusted or not, and so does a bash call whose details hold an argv intent: spectrum then shows its title, which is the intent for a trusted call and the deterministic title for any other. The labellers never see an intent: it is left out of the arguments they get, for steps and clusters. A pull for a call the conversation doesn't have yet waits for it only while that call is going on, which spectrum sees while its arguments still stream: it is in the run's streaming message or tool slots in `pi.live`. Then it checks every 250 ms, for up to 30 seconds, until the call is written or leaves `pi.live`, so the label shows while the run still goes. Any other id, or one that isn't 1 to 256 characters without spaces, gets `null` at once. All pulls for one call share one wait, and each agent waits for at most 8 calls at a time and 60 a minute; over that, `null`. A watch-only seat never makes a label call or reads the conversation: it only waits for a label to show up, for at most 32 calls at a time per connection. A labelled call costs one label call, however many tabs ask, and its label is kept under `step:<call id>` in the same doc. Like clusters, only calls made after the agent started are labelled. Each agent makes at most 30 step labels a minute (`STEP_LABELS_PER_MINUTE`), apart from the cluster budget; a pull over it gets `null` and the run keeps its title.
512
+ - **Titles without a label.** A trusted `bash` or `codemode` call with an intent is titled by it, and the title follows the intent as it streams. Otherwise titles are present participles too. `read`, `write` and `edit` are `Reading foo.ts`, `Writing bar.ts` and `Editing baz.md`, `codemode` is `Running code`, and an MCP tool is `Calling <server> · <tool>`.
513
+ - **Bash titles.** A `bash` call's title is, in this order: its trusted model intent; a trusted argv intent (the `--intent` its trace saw an `intent` or `playwright-cli` take, cleaned and redacted like a model intent, which matters for a call that left the field out); `Running gcloud and bq`, the programs its trace saw (up to three, then `and more`), once it has run; and the parser's guess, such as `Running cd, rm, mkdir and more` (up to three, before any heredoc) or `Running a command`, while its arguments stream, when it ran only builtins, and on a kernel without `trace`. An argv intent is still text a model wrote: the wrapper keeps it only for a call the guest guard didn't gate, the adapter shows it only for a call it would show a model intent for, and a guest's view leaves it out of the results it holds.
514
+ - **What ran, in the opened step.** The `slicc-ran` wrapper stores the trace's facts in the bash result's `details.ran` (`programs` with `name`, `status`, `signal` and `quiet`, `ms`, `more`, `dropped`, `intent`), also for a call that timed out, so a reload, freeze or thaw shows the same once the processes are gone. Spectrum shows them only when the step is opened, with its existing fields: `meta` is `Ran gcloud, bq, jq · 3.4 s` (up to eight, then `and more`; `Ran only shell builtins · 0.1 s`), before the `timeout 5s` the call asked for, and `notes` get an `error` note for each program that failed and isn't `quiet`, such as `bq exited 1` or `node was killed (SIGKILL)`, after the notes from diagnostics, never repeating one of them. The step row stays one line.
515
+ - The label comes from the cluster's tool inputs, each bash run's `ran:` line, and the outputs (each output cut at 600 characters), through the title model and the title scrubber. A vault that is locked or not ready gives `null`, so no unscrubbed text goes out.
506
516
  - A cluster pulled while it still runs (as spectrum used to do) costs about two calls. The first call happens when it forms, with any run still going shown as running. The second happens when it settles: every run has a result and the turn has moved on (assistant text, the end of the turn, or a new user message). A pull for a longer list while a run is still going doesn't call. It waits, up to ten minutes, for the cluster to settle and is then relabelled, unless an even longer pull takes over; then it gets the prefix's label. A cluster that settled and grows later gets one relabel. A pull for a list that a longer cached or pending one extends gets the prefix's label.
507
517
  - Each id list costs at most one call, however many tabs ask, including calls still in flight. Labels live in the session's `slicc.labels` doc (the newest 1000) and reach every tab through the transcript service's `labels`. A reload, freeze or thaw reads them without calling again, and a watch-only tab only waits for one.
508
518
  - Only clusters with a call made after the agent started are labelled; older ones get `null` unless already labelled. Each agent makes at most six label calls a minute, and two of them are kept for settled relabels, which wait for room instead of being dropped.
@@ -901,7 +911,7 @@ The agent worker never holds a secret's value. Values live in the vault (`vault.
901
911
 
902
912
  ## The kernel
903
913
 
904
- `@ai-ecoverse/slicc-kernel` is a peer dependency (`>=1.172.2 <2`): the agent only calls `attachKernel`, the client end of the page kernel's port, so it must match the kernel the page runs. Seven chooses that version: slicc-bios pins the certified kernel next to the agent in `src/packages/agent/package.json`, and pnpm fills the peer from that pin. The floor is 1.172.2, required by slicc-jsh 0.64.0; slicc-bios has pinned that kernel since v1.51.36. The kernel and the `wasm-*` commands are devDependencies pinned to certified versions, with the kernel kept at the peer floor, and CI runs the unit and integration tests on them in one leg. If the port protocol ever breaks within 1.x, a patch release narrows the upper bound. Renovate opens PRs for the kernel, `wasi-pnpm`, the `wasm-*` packages and `slicc-cdp` but never merges them, because they move only after the homescoop coordinator certifies them; newer kernel proposals stay held until certified.
914
+ `@ai-ecoverse/slicc-kernel` is a peer dependency (`>=1.172.2 <2`): the agent only calls `attachKernel`, the client end of the page kernel's port, so it must match the kernel the page runs. Seven chooses that version: slicc-bios pins the certified kernel next to the agent in `src/packages/agent/package.json`, and pnpm fills the peer from that pin. The floor is 1.172.2, required by slicc-jsh 0.64.0; exec traces need 1.180.0 (client protocol 1.15), and an older kernel runs bash calls untraced; slicc-bios has pinned that kernel since v1.51.36. The kernel and the `wasm-*` commands are devDependencies pinned to certified versions, with the kernel kept at the peer floor, and CI runs the unit and integration tests on them in one leg. If the port protocol ever breaks within 1.x, a patch release narrows the upper bound. Renovate opens PRs for the kernel, `wasi-pnpm`, the `wasm-*` packages and `slicc-cdp` but never merges them, because they move only after the homescoop coordinator certifies them; newer kernel proposals stay held until certified.
905
915
 
906
916
  ## Patched dependencies
907
917
 
@@ -21,7 +21,15 @@ function shownMessage(message) {
21
21
  const content = message?.content;
22
22
  return Array.isArray(content) ? { ...message, content: withoutIntents(content) } : message;
23
23
  }
24
+ function unsaid(message) {
25
+ const details = message?.details;
26
+ if (details?.ran?.intent === void 0) return message;
27
+ const { intent: _, ...ran } = details.ran;
28
+ return { ...message, details: { ...details, ran } };
29
+ }
24
30
  function shownEntry(entry) {
31
+ if (entry.kind === "pi.tool-result" && entry.model)
32
+ return { ...entry, model: entry.model.map(unsaid) };
25
33
  if (entry.kind !== "pi.assistant" || !entry.model) return entry;
26
34
  return { ...entry, model: entry.model.map(shownMessage) };
27
35
  }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/guests/view.ts"],
4
- "sourcesContent": ["import type { ConversationView, EntryRecord, JsonObject } from '@earendil-works/pi-durable';\nimport { withoutIntents } from '../intent/said.ts';\nimport { GATED_KIND, GUEST_INPUT_KIND, TAINTED_KIND } from './attribution.ts';\n\nconst SHOWN = new Set([\n 'pi.user',\n 'pi.assistant',\n 'pi.tool-result',\n 'pi.compaction',\n 'slicc.rewound',\n 'slicc.from',\n GUEST_INPUT_KIND,\n TAINTED_KIND,\n GATED_KIND,\n]);\n\nexport const EMPTY_VIEW = {\n conversation: {},\n entries: [],\n docs: {},\n} as unknown as ConversationView;\n\ntype InboxItem = { mode?: string; entry?: { kind?: string; data?: { seat?: unknown } } };\n\nconst own = (seat: string) => (item: InboxItem) =>\n item.entry?.kind === GUEST_INPUT_KIND && item.entry.data?.seat === seat;\n\nfunction shownMessage<T>(message: T): T {\n const content = (message as { content?: unknown } | undefined)?.content;\n return Array.isArray(content) ? { ...message, content: withoutIntents(content) } : message;\n}\n\nfunction shownEntry(entry: EntryRecord): EntryRecord {\n if (entry.kind !== 'pi.assistant' || !entry.model) return entry;\n return { ...entry, model: entry.model.map(shownMessage) };\n}\n\nfunction shownLive(live: { generation?: { message?: JsonObject } }) {\n const message = live.generation?.message;\n if (!message) return live;\n return { ...live, generation: { ...live.generation, message: shownMessage(message) } };\n}\n\nexport function guestView(view: ConversationView | undefined, seat: string): ConversationView {\n if (!view) return EMPTY_VIEW;\n const docs: Record<string, JsonObject> = {};\n const live = view.docs['pi.live'] as { generation?: { message?: JsonObject } } | undefined;\n if (live) docs['pi.live'] = shownLive(live) as JsonObject;\n const agent = view.docs['pi.agent'] as { model?: JsonObject; thinkingLevel?: string } | undefined;\n if (agent)\n docs['pi.agent'] = {\n ...(agent.model ? { model: agent.model } : {}),\n ...(agent.thinkingLevel ? { thinkingLevel: agent.thinkingLevel } : {}),\n };\n const inbox = view.docs['pi.inbox'] as { items?: InboxItem[] } | undefined;\n if (inbox) docs['pi.inbox'] = { items: (inbox.items ?? []).filter(own(seat)) } as JsonObject;\n return {\n conversation: view.conversation,\n entries: view.entries.filter((entry: EntryRecord) => SHOWN.has(entry.kind)).map(shownEntry),\n docs,\n };\n}\n"],
5
- "mappings": "AACA,SAAS,sBAAsB;AAC/B,SAAS,YAAY,kBAAkB,oBAAoB;AAE3D,MAAM,QAAQ,oBAAI,IAAI;AAAA,EACpB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,MAAM,aAAa;AAAA,EACxB,cAAc,CAAC;AAAA,EACf,SAAS,CAAC;AAAA,EACV,MAAM,CAAC;AACT;AAIA,MAAM,MAAM,CAAC,SAAiB,CAAC,SAC7B,KAAK,OAAO,SAAS,oBAAoB,KAAK,MAAM,MAAM,SAAS;AAErE,SAAS,aAAgB,SAAe;AACtC,QAAM,UAAW,SAA+C;AAChE,SAAO,MAAM,QAAQ,OAAO,IAAI,EAAE,GAAG,SAAS,SAAS,eAAe,OAAO,EAAE,IAAI;AACrF;AAEA,SAAS,WAAW,OAAiC;AACnD,MAAI,MAAM,SAAS,kBAAkB,CAAC,MAAM,MAAO,QAAO;AAC1D,SAAO,EAAE,GAAG,OAAO,OAAO,MAAM,MAAM,IAAI,YAAY,EAAE;AAC1D;AAEA,SAAS,UAAU,MAAiD;AAClE,QAAM,UAAU,KAAK,YAAY;AACjC,MAAI,CAAC,QAAS,QAAO;AACrB,SAAO,EAAE,GAAG,MAAM,YAAY,EAAE,GAAG,KAAK,YAAY,SAAS,aAAa,OAAO,EAAE,EAAE;AACvF;AAEO,SAAS,UAAU,MAAoC,MAAgC;AAC5F,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,OAAmC,CAAC;AAC1C,QAAM,OAAO,KAAK,KAAK,SAAS;AAChC,MAAI,KAAM,MAAK,SAAS,IAAI,UAAU,IAAI;AAC1C,QAAM,QAAQ,KAAK,KAAK,UAAU;AAClC,MAAI;AACF,SAAK,UAAU,IAAI;AAAA,MACjB,GAAI,MAAM,QAAQ,EAAE,OAAO,MAAM,MAAM,IAAI,CAAC;AAAA,MAC5C,GAAI,MAAM,gBAAgB,EAAE,eAAe,MAAM,cAAc,IAAI,CAAC;AAAA,IACtE;AACF,QAAM,QAAQ,KAAK,KAAK,UAAU;AAClC,MAAI,MAAO,MAAK,UAAU,IAAI,EAAE,QAAQ,MAAM,SAAS,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,EAAE;AAC7E,SAAO;AAAA,IACL,cAAc,KAAK;AAAA,IACnB,SAAS,KAAK,QAAQ,OAAO,CAAC,UAAuB,MAAM,IAAI,MAAM,IAAI,CAAC,EAAE,IAAI,UAAU;AAAA,IAC1F;AAAA,EACF;AACF;",
4
+ "sourcesContent": ["import type { ConversationView, EntryRecord, JsonObject } from '@earendil-works/pi-durable';\nimport { withoutIntents } from '../intent/said.ts';\nimport { GATED_KIND, GUEST_INPUT_KIND, TAINTED_KIND } from './attribution.ts';\n\nconst SHOWN = new Set([\n 'pi.user',\n 'pi.assistant',\n 'pi.tool-result',\n 'pi.compaction',\n 'slicc.rewound',\n 'slicc.from',\n GUEST_INPUT_KIND,\n TAINTED_KIND,\n GATED_KIND,\n]);\n\nexport const EMPTY_VIEW = {\n conversation: {},\n entries: [],\n docs: {},\n} as unknown as ConversationView;\n\ntype InboxItem = { mode?: string; entry?: { kind?: string; data?: { seat?: unknown } } };\n\nconst own = (seat: string) => (item: InboxItem) =>\n item.entry?.kind === GUEST_INPUT_KIND && item.entry.data?.seat === seat;\n\nfunction shownMessage<T>(message: T): T {\n const content = (message as { content?: unknown } | undefined)?.content;\n return Array.isArray(content) ? { ...message, content: withoutIntents(content) } : message;\n}\n\ntype Details = { ran?: { intent?: unknown } };\n\nfunction unsaid<T>(message: T): T {\n const details = (message as { details?: Details } | undefined)?.details;\n if (details?.ran?.intent === undefined) return message;\n const { intent: _, ...ran } = details.ran;\n return { ...message, details: { ...details, ran } };\n}\n\nfunction shownEntry(entry: EntryRecord): EntryRecord {\n if (entry.kind === 'pi.tool-result' && entry.model)\n return { ...entry, model: entry.model.map(unsaid) };\n if (entry.kind !== 'pi.assistant' || !entry.model) return entry;\n return { ...entry, model: entry.model.map(shownMessage) };\n}\n\nfunction shownLive(live: { generation?: { message?: JsonObject } }) {\n const message = live.generation?.message;\n if (!message) return live;\n return { ...live, generation: { ...live.generation, message: shownMessage(message) } };\n}\n\nexport function guestView(view: ConversationView | undefined, seat: string): ConversationView {\n if (!view) return EMPTY_VIEW;\n const docs: Record<string, JsonObject> = {};\n const live = view.docs['pi.live'] as { generation?: { message?: JsonObject } } | undefined;\n if (live) docs['pi.live'] = shownLive(live) as JsonObject;\n const agent = view.docs['pi.agent'] as { model?: JsonObject; thinkingLevel?: string } | undefined;\n if (agent)\n docs['pi.agent'] = {\n ...(agent.model ? { model: agent.model } : {}),\n ...(agent.thinkingLevel ? { thinkingLevel: agent.thinkingLevel } : {}),\n };\n const inbox = view.docs['pi.inbox'] as { items?: InboxItem[] } | undefined;\n if (inbox) docs['pi.inbox'] = { items: (inbox.items ?? []).filter(own(seat)) } as JsonObject;\n return {\n conversation: view.conversation,\n entries: view.entries.filter((entry: EntryRecord) => SHOWN.has(entry.kind)).map(shownEntry),\n docs,\n };\n}\n"],
5
+ "mappings": "AACA,SAAS,sBAAsB;AAC/B,SAAS,YAAY,kBAAkB,oBAAoB;AAE3D,MAAM,QAAQ,oBAAI,IAAI;AAAA,EACpB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,MAAM,aAAa;AAAA,EACxB,cAAc,CAAC;AAAA,EACf,SAAS,CAAC;AAAA,EACV,MAAM,CAAC;AACT;AAIA,MAAM,MAAM,CAAC,SAAiB,CAAC,SAC7B,KAAK,OAAO,SAAS,oBAAoB,KAAK,MAAM,MAAM,SAAS;AAErE,SAAS,aAAgB,SAAe;AACtC,QAAM,UAAW,SAA+C;AAChE,SAAO,MAAM,QAAQ,OAAO,IAAI,EAAE,GAAG,SAAS,SAAS,eAAe,OAAO,EAAE,IAAI;AACrF;AAIA,SAAS,OAAU,SAAe;AAChC,QAAM,UAAW,SAA+C;AAChE,MAAI,SAAS,KAAK,WAAW,OAAW,QAAO;AAC/C,QAAM,EAAE,QAAQ,GAAG,GAAG,IAAI,IAAI,QAAQ;AACtC,SAAO,EAAE,GAAG,SAAS,SAAS,EAAE,GAAG,SAAS,IAAI,EAAE;AACpD;AAEA,SAAS,WAAW,OAAiC;AACnD,MAAI,MAAM,SAAS,oBAAoB,MAAM;AAC3C,WAAO,EAAE,GAAG,OAAO,OAAO,MAAM,MAAM,IAAI,MAAM,EAAE;AACpD,MAAI,MAAM,SAAS,kBAAkB,CAAC,MAAM,MAAO,QAAO;AAC1D,SAAO,EAAE,GAAG,OAAO,OAAO,MAAM,MAAM,IAAI,YAAY,EAAE;AAC1D;AAEA,SAAS,UAAU,MAAiD;AAClE,QAAM,UAAU,KAAK,YAAY;AACjC,MAAI,CAAC,QAAS,QAAO;AACrB,SAAO,EAAE,GAAG,MAAM,YAAY,EAAE,GAAG,KAAK,YAAY,SAAS,aAAa,OAAO,EAAE,EAAE;AACvF;AAEO,SAAS,UAAU,MAAoC,MAAgC;AAC5F,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,OAAmC,CAAC;AAC1C,QAAM,OAAO,KAAK,KAAK,SAAS;AAChC,MAAI,KAAM,MAAK,SAAS,IAAI,UAAU,IAAI;AAC1C,QAAM,QAAQ,KAAK,KAAK,UAAU;AAClC,MAAI;AACF,SAAK,UAAU,IAAI;AAAA,MACjB,GAAI,MAAM,QAAQ,EAAE,OAAO,MAAM,MAAM,IAAI,CAAC;AAAA,MAC5C,GAAI,MAAM,gBAAgB,EAAE,eAAe,MAAM,cAAc,IAAI,CAAC;AAAA,IACtE;AACF,QAAM,QAAQ,KAAK,KAAK,UAAU;AAClC,MAAI,MAAO,MAAK,UAAU,IAAI,EAAE,QAAQ,MAAM,SAAS,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,EAAE;AAC7E,SAAO;AAAA,IACL,cAAc,KAAK;AAAA,IACnB,SAAS,KAAK,QAAQ,OAAO,CAAC,UAAuB,MAAM,IAAI,MAAM,IAAI,CAAC,EAAE,IAAI,UAAU;AAAA,IAC1F;AAAA,EACF;AACF;",
6
6
  "names": []
7
7
  }
@@ -6,6 +6,7 @@ import {
6
6
  } from "@earendil-works/pi-durable/env";
7
7
  import { descendants, REFUSED } from "./groups.js";
8
8
  import { resolve } from "./paths.js";
9
+ import { follow, LINGER_MS } from "./trace.js";
9
10
  const SHELL = ["bash", "-c"];
10
11
  const HELD_LIMIT = 32 * 1024 * 1024;
11
12
  const HELD = "output held: waiting for the vault";
@@ -129,27 +130,49 @@ async function drained(sinks, context) {
129
130
  off();
130
131
  }
131
132
  }
132
- async function tagged(client, argv, options) {
133
+ const unsupported = (error) => error.code === "ENOSYS";
134
+ async function tagged(client, argv, options, call) {
133
135
  const { tag, ...untagged } = options;
136
+ if (call !== void 0)
137
+ try {
138
+ const tags = tag === void 0 ? [call] : [tag, call];
139
+ const process = await client.spawn(argv, { ...untagged, tag: tags });
140
+ return { process, ...tag === void 0 ? {} : { tag }, traced: true };
141
+ } catch (error) {
142
+ if (!unsupported(error)) throw error;
143
+ }
134
144
  if (tag === void 0) return { process: await client.spawn(argv, options) };
135
145
  try {
136
146
  return { process: await client.spawn(argv, options), tag };
137
147
  } catch (error) {
138
- if (error.code !== "ENOSYS") throw error;
148
+ if (!unsupported(error)) throw error;
139
149
  return { process: await client.spawn(argv, untagged) };
140
150
  }
141
151
  }
142
- async function start(client, argv, options, join) {
152
+ async function start(client, argv, options, join, call) {
143
153
  if (join?.pgid !== void 0) {
144
154
  try {
145
- return { ...await tagged(client, argv, { ...options, pgid: join.pgid }), joined: true };
155
+ const process = await tagged(client, argv, { ...options, pgid: join.pgid }, call);
156
+ return { ...process, joined: true };
146
157
  } catch (error) {
147
158
  const code = String(error.code ?? "");
148
159
  if (!REFUSED.has(code)) throw error;
149
160
  join.refused(code);
150
161
  }
151
162
  }
152
- return { ...await tagged(client, argv, options), joined: false };
163
+ return { ...await tagged(client, argv, options, call), joined: false };
164
+ }
165
+ async function traceOf(client, trace, argv, given, shell) {
166
+ if (!trace) return void 0;
167
+ const launchers = argv.length - given.length + (shell ? 1 : 0);
168
+ return follow(client, trace.tag, argv, launchers);
169
+ }
170
+ async function traceEnded(tracer, trace, began, exitCode, killed) {
171
+ if (!tracer || !trace) return;
172
+ const ms = Date.now() - began;
173
+ if (typeof exitCode === "number") await tracer.collector.settled(LINGER_MS);
174
+ tracer.close();
175
+ trace.report(tracer.collector.facts(ms, killed));
153
176
  }
154
177
  async function execute(client, cwd, command, options, context, spawned, join, hooks = {}) {
155
178
  const given = typeof command === "string" ? [...SHELL, command] : [...command];
@@ -172,9 +195,14 @@ async function execute(client, cwd, command, options, context, spawned, join, ho
172
195
  };
173
196
  const out = sink("stdout", spill, options, context, scrubbed());
174
197
  const errors = sink("stderr", spill, options, context, scrubbed());
198
+ const trace = options?.trace;
199
+ let tracer;
175
200
  let started;
201
+ let began = Date.now();
176
202
  try {
177
203
  const tag = await hooks.tag?.(context);
204
+ tracer = await traceOf(client, trace, argv, given, typeof command === "string");
205
+ began = Date.now();
178
206
  started = await start(
179
207
  client,
180
208
  argv,
@@ -185,13 +213,20 @@ async function execute(client, cwd, command, options, context, spawned, join, ho
185
213
  onStdout: (bytes) => out.push(bytes),
186
214
  onStderr: (bytes) => errors.push(bytes)
187
215
  },
188
- join
216
+ join,
217
+ tracer ? trace?.tag : void 0
189
218
  );
190
219
  } catch (error) {
220
+ tracer?.close();
191
221
  const message = error instanceof Error ? error.message : String(error);
192
222
  return err(new ExecutionError("spawn_error", message));
193
223
  }
194
224
  const { process } = started;
225
+ if (!started.traced) {
226
+ tracer?.close();
227
+ tracer = void 0;
228
+ }
229
+ tracer?.collector.begin(process.pid);
195
230
  spawned?.(process, started.tag);
196
231
  let killing;
197
232
  const { abandon, release } = abandoning(hooks.abandonOnAbort);
@@ -203,6 +238,7 @@ async function execute(client, cwd, command, options, context, spawned, join, ho
203
238
  over = () => watch.stop("held");
204
239
  if (overflowed) over();
205
240
  const exitCode = await waited(process, watch, abandon, () => killing);
241
+ await traceEnded(tracer, trace, began, exitCode, watch.ending !== void 0);
206
242
  if (exitCode === "abandoned" || exitCode === void 0) {
207
243
  out.drop();
208
244
  errors.drop();
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/kernel/exec.ts"],
4
- "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport {\n ExecutionError,\n err,\n ok,\n type Result,\n type ShellExecOptions,\n type ShellExecResult,\n StreamDecoder,\n} from '@earendil-works/pi-durable/env';\nimport type { ScrubStream } from '../secrets/scrub.ts';\nimport type { KernelClient, KernelProcess, SpawnOptions } from './client.ts';\nimport { descendants, REFUSED } from './groups.ts';\nimport { resolve } from './paths.ts';\n\nexport const SHELL = ['bash', '-c'] as const;\nexport const HELD_LIMIT = 32 * 1024 * 1024;\nexport const HELD = 'output held: waiting for the vault';\nexport const GONE = 'the kernel went away mid-run, so the command may have partly run';\n\nexport interface ExecHooks {\n scrub?: () => ScrubStream;\n spawn?: (argv: readonly string[]) => readonly string[];\n tag?: (context: Context) => Promise<string | undefined>;\n abandonOnAbort?: boolean;\n}\n\nclass Spill {\n readonly #chunks: Uint8Array[] = [];\n readonly #limit: { afterBytes: number; afterLines: number } | undefined;\n #bytes = 0;\n #lines = 0;\n\n constructor(limit: ShellExecOptions['spill']) {\n this.#limit = limit;\n }\n\n add(chunk: Uint8Array): void {\n if (!this.#limit) return;\n this.#chunks.push(chunk);\n this.#bytes += chunk.length;\n for (const byte of chunk) if (byte === 10) this.#lines++;\n }\n\n get over(): boolean {\n const limit = this.#limit;\n return (\n limit !== undefined && (this.#bytes > limit.afterBytes || this.#lines > limit.afterLines)\n );\n }\n\n async write(client: KernelClient): Promise<string | undefined> {\n if (!this.over) return undefined;\n const path = `/tmp/slicc-agent-output-${crypto.randomUUID()}.log`;\n const all = new Uint8Array(this.#bytes);\n let offset = 0;\n for (const chunk of this.#chunks) {\n all.set(chunk, offset);\n offset += chunk.length;\n }\n await client.fs.mkdir('/tmp');\n await client.fs.writeFile(path, all);\n return path;\n }\n}\n\ninterface Sink {\n push(bytes: Uint8Array): void;\n end(): Promise<void>;\n drop(): void;\n}\n\nfunction sink(\n stream: 'stdout' | 'stderr',\n spill: Spill,\n options: ShellExecOptions | undefined,\n context: Context,\n scrub?: { stream: ScrubStream; held(bytes: number): void }\n): Sink {\n const decoder = new StreamDecoder();\n const emit = (bytes: Uint8Array) => {\n spill.add(bytes);\n const text = decoder.decode(bytes);\n if (text) options?.onOutput?.(text, context, { stream });\n };\n const flush = () => {\n const text = decoder.decode();\n if (text) options?.onOutput?.(text, context, { stream });\n };\n if (!scrub)\n return {\n push: emit,\n end: async () => flush(),\n drop: flush,\n };\n let chain: Promise<void> = Promise.resolve();\n let dropped = false;\n const live = (bytes: Uint8Array) => {\n if (!dropped) emit(bytes);\n };\n return {\n push(bytes) {\n scrub.held(bytes.length);\n chain = chain\n .then(() => scrub.stream.push(bytes))\n .then((out) => {\n scrub.held(-bytes.length);\n live(out);\n });\n },\n async end() {\n await chain;\n live(await scrub.stream.end());\n if (!dropped) flush();\n },\n drop() {\n dropped = true;\n chain.catch(() => undefined);\n scrub.stream.drop();\n },\n };\n}\n\ntype Ending = 'timeout' | 'aborted' | 'held' | undefined;\n\nexport async function sweep(\n client: Pick<KernelClient, 'kill' | 'ps'>,\n process: KernelProcess\n): Promise<void> {\n for (let round = 0; round < 2; round++) {\n const table = (await client.ps?.().catch(() => undefined)) ?? [];\n const pids = [process.pid, ...descendants(table, process.pid)];\n await Promise.all(pids.map((pid) => client.kill?.(pid, 'SIGKILL').catch(() => undefined)));\n }\n}\n\nfunction guard(\n process: KernelProcess,\n options: ShellExecOptions | undefined,\n context: Context,\n kill: () => void\n) {\n let ending: Ending;\n const stop = (why: Ending) => {\n ending ??= why;\n kill();\n };\n const timer =\n options?.timeout === undefined\n ? undefined\n : setTimeout(() => stop('timeout'), options.timeout * 1000);\n const onAbort = () => stop('aborted');\n context.abortSignal?.addEventListener('abort', onAbort, { once: true });\n if (context.abortSignal?.aborted) onAbort();\n return {\n get ending() {\n return ending;\n },\n stop,\n release() {\n clearTimeout(timer);\n context.abortSignal?.removeEventListener('abort', onAbort);\n },\n };\n}\n\nasync function drained(sinks: readonly Sink[], context: Context): Promise<Ending> {\n const signal = context.abortSignal;\n if (signal?.aborted) return 'aborted';\n let off = () => undefined as void;\n const aborted = new Promise<Ending>((resolve) => {\n const onAbort = () => resolve('aborted');\n signal?.addEventListener('abort', onAbort, { once: true });\n off = () => signal?.removeEventListener('abort', onAbort);\n });\n const ends = Promise.all(sinks.map((each) => each.end())).then(() => undefined);\n ends.catch(() => undefined);\n try {\n return await Promise.race([ends, aborted]);\n } finally {\n off();\n }\n}\n\nexport interface Join {\n pgid?: number;\n refused(code: string): void;\n}\n\ntype Started = { process: KernelProcess; tag?: string };\n\nasync function tagged(\n client: KernelClient,\n argv: readonly string[],\n options: SpawnOptions\n): Promise<Started> {\n const { tag, ...untagged } = options;\n if (tag === undefined) return { process: await client.spawn(argv, options) };\n try {\n return { process: await client.spawn(argv, options), tag };\n } catch (error) {\n if ((error as { code?: unknown }).code !== 'ENOSYS') throw error;\n return { process: await client.spawn(argv, untagged) };\n }\n}\n\nasync function start(\n client: KernelClient,\n argv: readonly string[],\n options: SpawnOptions,\n join: Join | undefined\n): Promise<Started & { joined: boolean }> {\n if (join?.pgid !== undefined) {\n try {\n return { ...(await tagged(client, argv, { ...options, pgid: join.pgid })), joined: true };\n } catch (error) {\n const code = String((error as { code?: unknown }).code ?? '');\n if (!REFUSED.has(code)) throw error;\n join.refused(code);\n }\n }\n return { ...(await tagged(client, argv, options)), joined: false };\n}\n\nexport async function execute(\n client: KernelClient,\n cwd: string,\n command: string | readonly string[],\n options: ShellExecOptions | undefined,\n context: Context,\n spawned?: (process: KernelProcess, tag?: string) => void,\n join?: Join,\n hooks: ExecHooks = {}\n): Promise<Result<ShellExecResult, ExecutionError>> {\n const given = typeof command === 'string' ? [...SHELL, command] : [...command];\n if (given.length === 0) return err(new ExecutionError('spawn_error', 'No program to run'));\n const argv = hooks.spawn ? [...hooks.spawn(given)] : given;\n if (context.abortSignal?.aborted)\n return err(new ExecutionError('aborted', 'The command was aborted'));\n const spill = new Spill(options?.spill);\n let held = 0;\n let overflowed = false;\n let over = () => {\n overflowed = true;\n };\n const scrubbed = () =>\n hooks.scrub && {\n stream: hooks.scrub(),\n held(bytes: number) {\n held += bytes;\n if (held > HELD_LIMIT) over();\n },\n };\n const out = sink('stdout', spill, options, context, scrubbed());\n const errors = sink('stderr', spill, options, context, scrubbed());\n let started: Started & { joined: boolean };\n try {\n const tag = await hooks.tag?.(context);\n started = await start(\n client,\n argv,\n {\n cwd: resolve(cwd, options?.cwd ?? '.'),\n ...(options?.env ? { env: options.env } : {}),\n ...(tag === undefined ? {} : { tag }),\n onStdout: (bytes) => out.push(bytes),\n onStderr: (bytes) => errors.push(bytes),\n },\n join\n );\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n return err(new ExecutionError('spawn_error', message));\n }\n const { process } = started;\n spawned?.(process, started.tag);\n let killing: Promise<void> | undefined;\n const { abandon, release } = abandoning(hooks.abandonOnAbort);\n const watch = guard(process, options, context, () => {\n if (release()) return;\n if (join) killing = sweep(client, process);\n else void Promise.resolve(process.signal('SIGKILL'));\n });\n over = () => watch.stop('held');\n if (overflowed) over();\n const exitCode = await waited(process, watch, abandon, () => killing);\n if (exitCode === 'abandoned' || exitCode === undefined) {\n out.drop();\n errors.drop();\n if (exitCode === 'abandoned') watch.release();\n return err(earlyError(exitCode));\n }\n return settled(client, watch, out, errors, spill, exitCode, context);\n}\n\nfunction earlyError(exitCode: 'abandoned' | undefined): ExecutionError {\n return exitCode === 'abandoned'\n ? new ExecutionError('aborted', 'The command was aborted')\n : new ExecutionError('unknown', GONE);\n}\n\nasync function settled(\n client: KernelClient,\n watch: ReturnType<typeof guard>,\n out: Sink,\n errors: Sink,\n spill: Spill,\n exitCode: number,\n context: Context\n): Promise<Result<ShellExecResult, ExecutionError>> {\n const ended = watch.ending ?? (await drained([out, errors], context));\n if (ended) {\n out.drop();\n errors.drop();\n }\n const spillPath = await spill.write(client);\n const ending = watch.ending ?? ended;\n if (ending) {\n const error = endedError(ending);\n if (spillPath) error.spillPath = spillPath;\n return err(error);\n }\n return ok(spillPath ? { exitCode, spillPath } : { exitCode });\n}\n\nfunction abandoning(on: boolean | undefined): {\n abandon: Promise<'abandoned'> | undefined;\n release: () => boolean;\n} {\n if (!on) return { abandon: undefined, release: () => false };\n let abandoned: (() => void) | undefined;\n const abandon = new Promise<'abandoned'>((resolve) => {\n abandoned = () => resolve('abandoned');\n });\n return {\n abandon,\n release: () => {\n abandoned?.();\n return true;\n },\n };\n}\n\nfunction endedError(ending: Exclude<Ending, undefined>): ExecutionError {\n return ending === 'held'\n ? new ExecutionError('unknown', HELD)\n : new ExecutionError(\n ending,\n `The command was ${ending === 'timeout' ? 'timed out' : 'aborted'}`\n );\n}\n\nasync function waited(\n process: KernelProcess,\n watch: ReturnType<typeof guard>,\n abandon: Promise<'abandoned'> | undefined,\n killingOf: () => Promise<void> | undefined\n): Promise<number | undefined | 'abandoned'> {\n const raced: Array<Promise<number | undefined | 'abandoned'>> = [\n process.exited.finally(() => watch.release()).catch(() => undefined),\n ];\n if (abandon !== undefined) raced.push(abandon);\n const exitCode = await Promise.race(raced);\n const killing = killingOf();\n if (killing !== undefined) await killing.catch(() => undefined);\n return exitCode;\n}\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport {\n ExecutionError,\n err,\n ok,\n type Result,\n type ShellExecOptions,\n type ShellExecResult,\n StreamDecoder,\n} from '@earendil-works/pi-durable/env';\nimport type { ScrubStream } from '../secrets/scrub.ts';\nimport type { KernelClient, KernelProcess, SpawnOptions } from './client.ts';\nimport { descendants, REFUSED } from './groups.ts';\nimport { resolve } from './paths.ts';\nimport { type CallTrace, follow, LINGER_MS, type Tracer } from './trace.ts';\n\nexport const SHELL = ['bash', '-c'] as const;\nexport const HELD_LIMIT = 32 * 1024 * 1024;\nexport const HELD = 'output held: waiting for the vault';\nexport const GONE = 'the kernel went away mid-run, so the command may have partly run';\n\nexport type TracedExecOptions = ShellExecOptions & { trace?: CallTrace };\n\nexport interface ExecHooks {\n scrub?: () => ScrubStream;\n spawn?: (argv: readonly string[]) => readonly string[];\n tag?: (context: Context) => Promise<string | undefined>;\n abandonOnAbort?: boolean;\n}\n\nclass Spill {\n readonly #chunks: Uint8Array[] = [];\n readonly #limit: { afterBytes: number; afterLines: number } | undefined;\n #bytes = 0;\n #lines = 0;\n\n constructor(limit: ShellExecOptions['spill']) {\n this.#limit = limit;\n }\n\n add(chunk: Uint8Array): void {\n if (!this.#limit) return;\n this.#chunks.push(chunk);\n this.#bytes += chunk.length;\n for (const byte of chunk) if (byte === 10) this.#lines++;\n }\n\n get over(): boolean {\n const limit = this.#limit;\n return (\n limit !== undefined && (this.#bytes > limit.afterBytes || this.#lines > limit.afterLines)\n );\n }\n\n async write(client: KernelClient): Promise<string | undefined> {\n if (!this.over) return undefined;\n const path = `/tmp/slicc-agent-output-${crypto.randomUUID()}.log`;\n const all = new Uint8Array(this.#bytes);\n let offset = 0;\n for (const chunk of this.#chunks) {\n all.set(chunk, offset);\n offset += chunk.length;\n }\n await client.fs.mkdir('/tmp');\n await client.fs.writeFile(path, all);\n return path;\n }\n}\n\ninterface Sink {\n push(bytes: Uint8Array): void;\n end(): Promise<void>;\n drop(): void;\n}\n\nfunction sink(\n stream: 'stdout' | 'stderr',\n spill: Spill,\n options: ShellExecOptions | undefined,\n context: Context,\n scrub?: { stream: ScrubStream; held(bytes: number): void }\n): Sink {\n const decoder = new StreamDecoder();\n const emit = (bytes: Uint8Array) => {\n spill.add(bytes);\n const text = decoder.decode(bytes);\n if (text) options?.onOutput?.(text, context, { stream });\n };\n const flush = () => {\n const text = decoder.decode();\n if (text) options?.onOutput?.(text, context, { stream });\n };\n if (!scrub)\n return {\n push: emit,\n end: async () => flush(),\n drop: flush,\n };\n let chain: Promise<void> = Promise.resolve();\n let dropped = false;\n const live = (bytes: Uint8Array) => {\n if (!dropped) emit(bytes);\n };\n return {\n push(bytes) {\n scrub.held(bytes.length);\n chain = chain\n .then(() => scrub.stream.push(bytes))\n .then((out) => {\n scrub.held(-bytes.length);\n live(out);\n });\n },\n async end() {\n await chain;\n live(await scrub.stream.end());\n if (!dropped) flush();\n },\n drop() {\n dropped = true;\n chain.catch(() => undefined);\n scrub.stream.drop();\n },\n };\n}\n\ntype Ending = 'timeout' | 'aborted' | 'held' | undefined;\n\nexport async function sweep(\n client: Pick<KernelClient, 'kill' | 'ps'>,\n process: KernelProcess\n): Promise<void> {\n for (let round = 0; round < 2; round++) {\n const table = (await client.ps?.().catch(() => undefined)) ?? [];\n const pids = [process.pid, ...descendants(table, process.pid)];\n await Promise.all(pids.map((pid) => client.kill?.(pid, 'SIGKILL').catch(() => undefined)));\n }\n}\n\nfunction guard(\n process: KernelProcess,\n options: ShellExecOptions | undefined,\n context: Context,\n kill: () => void\n) {\n let ending: Ending;\n const stop = (why: Ending) => {\n ending ??= why;\n kill();\n };\n const timer =\n options?.timeout === undefined\n ? undefined\n : setTimeout(() => stop('timeout'), options.timeout * 1000);\n const onAbort = () => stop('aborted');\n context.abortSignal?.addEventListener('abort', onAbort, { once: true });\n if (context.abortSignal?.aborted) onAbort();\n return {\n get ending() {\n return ending;\n },\n stop,\n release() {\n clearTimeout(timer);\n context.abortSignal?.removeEventListener('abort', onAbort);\n },\n };\n}\n\nasync function drained(sinks: readonly Sink[], context: Context): Promise<Ending> {\n const signal = context.abortSignal;\n if (signal?.aborted) return 'aborted';\n let off = () => undefined as void;\n const aborted = new Promise<Ending>((resolve) => {\n const onAbort = () => resolve('aborted');\n signal?.addEventListener('abort', onAbort, { once: true });\n off = () => signal?.removeEventListener('abort', onAbort);\n });\n const ends = Promise.all(sinks.map((each) => each.end())).then(() => undefined);\n ends.catch(() => undefined);\n try {\n return await Promise.race([ends, aborted]);\n } finally {\n off();\n }\n}\n\nexport interface Join {\n pgid?: number;\n refused(code: string): void;\n}\n\ntype Started = { process: KernelProcess; tag?: string; traced?: boolean };\n\ntype Spawning = Omit<SpawnOptions, 'tag'> & { tag?: string };\n\nconst unsupported = (error: unknown) => (error as { code?: unknown }).code === 'ENOSYS';\n\nasync function tagged(\n client: KernelClient,\n argv: readonly string[],\n options: Spawning,\n call: string | undefined\n): Promise<Started> {\n const { tag, ...untagged } = options;\n if (call !== undefined)\n try {\n const tags = tag === undefined ? [call] : [tag, call];\n const process = await client.spawn(argv, { ...untagged, tag: tags });\n return { process, ...(tag === undefined ? {} : { tag }), traced: true };\n } catch (error) {\n if (!unsupported(error)) throw error;\n }\n if (tag === undefined) return { process: await client.spawn(argv, options) };\n try {\n return { process: await client.spawn(argv, options), tag };\n } catch (error) {\n if (!unsupported(error)) throw error;\n return { process: await client.spawn(argv, untagged) };\n }\n}\n\nasync function start(\n client: KernelClient,\n argv: readonly string[],\n options: Spawning,\n join: Join | undefined,\n call?: string\n): Promise<Started & { joined: boolean }> {\n if (join?.pgid !== undefined) {\n try {\n const process = await tagged(client, argv, { ...options, pgid: join.pgid }, call);\n return { ...process, joined: true };\n } catch (error) {\n const code = String((error as { code?: unknown }).code ?? '');\n if (!REFUSED.has(code)) throw error;\n join.refused(code);\n }\n }\n return { ...(await tagged(client, argv, options, call)), joined: false };\n}\n\nasync function traceOf(\n client: KernelClient,\n trace: CallTrace | undefined,\n argv: readonly string[],\n given: readonly string[],\n shell: boolean\n): Promise<Tracer | undefined> {\n if (!trace) return undefined;\n const launchers = argv.length - given.length + (shell ? 1 : 0);\n return follow(client, trace.tag, argv, launchers);\n}\n\nasync function traceEnded(\n tracer: Tracer | undefined,\n trace: CallTrace | undefined,\n began: number,\n exitCode: number | undefined | 'abandoned',\n killed: boolean\n): Promise<void> {\n if (!tracer || !trace) return;\n const ms = Date.now() - began;\n if (typeof exitCode === 'number') await tracer.collector.settled(LINGER_MS);\n tracer.close();\n trace.report(tracer.collector.facts(ms, killed));\n}\n\nexport async function execute(\n client: KernelClient,\n cwd: string,\n command: string | readonly string[],\n options: ShellExecOptions | undefined,\n context: Context,\n spawned?: (process: KernelProcess, tag?: string) => void,\n join?: Join,\n hooks: ExecHooks = {}\n): Promise<Result<ShellExecResult, ExecutionError>> {\n const given = typeof command === 'string' ? [...SHELL, command] : [...command];\n if (given.length === 0) return err(new ExecutionError('spawn_error', 'No program to run'));\n const argv = hooks.spawn ? [...hooks.spawn(given)] : given;\n if (context.abortSignal?.aborted)\n return err(new ExecutionError('aborted', 'The command was aborted'));\n const spill = new Spill(options?.spill);\n let held = 0;\n let overflowed = false;\n let over = () => {\n overflowed = true;\n };\n const scrubbed = () =>\n hooks.scrub && {\n stream: hooks.scrub(),\n held(bytes: number) {\n held += bytes;\n if (held > HELD_LIMIT) over();\n },\n };\n const out = sink('stdout', spill, options, context, scrubbed());\n const errors = sink('stderr', spill, options, context, scrubbed());\n const trace = (options as TracedExecOptions | undefined)?.trace;\n let tracer: Tracer | undefined;\n let started: Started & { joined: boolean };\n let began = Date.now();\n try {\n const tag = await hooks.tag?.(context);\n tracer = await traceOf(client, trace, argv, given, typeof command === 'string');\n began = Date.now();\n started = await start(\n client,\n argv,\n {\n cwd: resolve(cwd, options?.cwd ?? '.'),\n ...(options?.env ? { env: options.env } : {}),\n ...(tag === undefined ? {} : { tag }),\n onStdout: (bytes) => out.push(bytes),\n onStderr: (bytes) => errors.push(bytes),\n },\n join,\n tracer ? trace?.tag : undefined\n );\n } catch (error) {\n tracer?.close();\n const message = error instanceof Error ? error.message : String(error);\n return err(new ExecutionError('spawn_error', message));\n }\n const { process } = started;\n if (!started.traced) {\n tracer?.close();\n tracer = undefined;\n }\n tracer?.collector.begin(process.pid);\n spawned?.(process, started.tag);\n let killing: Promise<void> | undefined;\n const { abandon, release } = abandoning(hooks.abandonOnAbort);\n const watch = guard(process, options, context, () => {\n if (release()) return;\n if (join) killing = sweep(client, process);\n else void Promise.resolve(process.signal('SIGKILL'));\n });\n over = () => watch.stop('held');\n if (overflowed) over();\n const exitCode = await waited(process, watch, abandon, () => killing);\n await traceEnded(tracer, trace, began, exitCode, watch.ending !== undefined);\n if (exitCode === 'abandoned' || exitCode === undefined) {\n out.drop();\n errors.drop();\n if (exitCode === 'abandoned') watch.release();\n return err(earlyError(exitCode));\n }\n return settled(client, watch, out, errors, spill, exitCode, context);\n}\n\nfunction earlyError(exitCode: 'abandoned' | undefined): ExecutionError {\n return exitCode === 'abandoned'\n ? new ExecutionError('aborted', 'The command was aborted')\n : new ExecutionError('unknown', GONE);\n}\n\nasync function settled(\n client: KernelClient,\n watch: ReturnType<typeof guard>,\n out: Sink,\n errors: Sink,\n spill: Spill,\n exitCode: number,\n context: Context\n): Promise<Result<ShellExecResult, ExecutionError>> {\n const ended = watch.ending ?? (await drained([out, errors], context));\n if (ended) {\n out.drop();\n errors.drop();\n }\n const spillPath = await spill.write(client);\n const ending = watch.ending ?? ended;\n if (ending) {\n const error = endedError(ending);\n if (spillPath) error.spillPath = spillPath;\n return err(error);\n }\n return ok(spillPath ? { exitCode, spillPath } : { exitCode });\n}\n\nfunction abandoning(on: boolean | undefined): {\n abandon: Promise<'abandoned'> | undefined;\n release: () => boolean;\n} {\n if (!on) return { abandon: undefined, release: () => false };\n let abandoned: (() => void) | undefined;\n const abandon = new Promise<'abandoned'>((resolve) => {\n abandoned = () => resolve('abandoned');\n });\n return {\n abandon,\n release: () => {\n abandoned?.();\n return true;\n },\n };\n}\n\nfunction endedError(ending: Exclude<Ending, undefined>): ExecutionError {\n return ending === 'held'\n ? new ExecutionError('unknown', HELD)\n : new ExecutionError(\n ending,\n `The command was ${ending === 'timeout' ? 'timed out' : 'aborted'}`\n );\n}\n\nasync function waited(\n process: KernelProcess,\n watch: ReturnType<typeof guard>,\n abandon: Promise<'abandoned'> | undefined,\n killingOf: () => Promise<void> | undefined\n): Promise<number | undefined | 'abandoned'> {\n const raced: Array<Promise<number | undefined | 'abandoned'>> = [\n process.exited.finally(() => watch.release()).catch(() => undefined),\n ];\n if (abandon !== undefined) raced.push(abandon);\n const exitCode = await Promise.race(raced);\n const killing = killingOf();\n if (killing !== undefined) await killing.catch(() => undefined);\n return exitCode;\n}\n"],
5
+ "mappings": "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",
6
6
  "names": ["resolve"]
7
7
  }
@@ -0,0 +1,203 @@
1
+ const CALL_TAG = "call:";
2
+ const PROGRAMS_KEPT = 16;
3
+ const NAMES_HELD = 64;
4
+ const PIDS_HELD = 1024;
5
+ const QUEUE_HELD = 4096;
6
+ const LINGER_MS = 2e3;
7
+ const TRACE_LIMIT = 4096;
8
+ const INTENT_HELD = 1e3;
9
+ const INTERPRETERS = /^(?:(?:ba|da|z|k|c|tc|fi)?sh|node|jsh|deno|bun|tsx|python[\d.]*|pypy[\d.]*|perl[\d.]*|ruby[\d.]*|php[\d.]*|lua[\d.]*)$/;
10
+ const NAME = /^[^\s/\p{Cc}\p{Cf}]{1,64}$/u;
11
+ const SAYERS = /* @__PURE__ */ new Set(["intent", "playwright-cli"]);
12
+ function leaf(path) {
13
+ return path.split("/").filter(Boolean).at(-1) ?? "";
14
+ }
15
+ function programOf(argv, exe) {
16
+ const first = leaf(argv[0] ?? "") || leaf(exe ?? "");
17
+ const script = argv[1] ?? "";
18
+ const shebang = INTERPRETERS.test(first) && script.includes("/") && !script.startsWith("-") && !/\s/.test(script) && NAME.test(leaf(script));
19
+ const name = shebang ? leaf(script) : first;
20
+ if (!NAME.test(name)) return void 0;
21
+ return { name, args: argv.slice(shebang ? 2 : 1) };
22
+ }
23
+ function argvIntent(args) {
24
+ for (let at = 0; at < args.length; at++) {
25
+ const arg = args[at];
26
+ if (arg === "--") return void 0;
27
+ if (arg === "--intent") return args[at + 1];
28
+ if (arg.startsWith("--intent=")) return arg.slice("--intent=".length);
29
+ }
30
+ return void 0;
31
+ }
32
+ const sigpipe = (proc) => proc.status === 141 || proc.signal === "SIGPIPE";
33
+ const same = (a, b) => a.length === b.length && a.every((word, at) => at === 0 ? leaf(word) === leaf(b[0]) : word === b[at]);
34
+ class Collector {
35
+ #procs = /* @__PURE__ */ new Map();
36
+ #names = /* @__PURE__ */ new Map();
37
+ #launchers;
38
+ #queue = [];
39
+ #root;
40
+ #rootEnded = false;
41
+ #dropped = 0;
42
+ #more = 0;
43
+ #intent;
44
+ #wake;
45
+ constructor(argv, launchers) {
46
+ this.#launchers = Array.from({ length: launchers }, (_, at) => argv.slice(at));
47
+ }
48
+ feed(batch) {
49
+ this.#dropped += batch.dropped;
50
+ for (const event of batch.events) {
51
+ if (!this.#queue) this.#take(event);
52
+ else if (this.#queue.length < QUEUE_HELD) this.#queue.push(event);
53
+ else this.#dropped++;
54
+ }
55
+ this.#check();
56
+ }
57
+ begin(pid) {
58
+ this.#root = pid;
59
+ const queued = this.#queue ?? [];
60
+ this.#queue = void 0;
61
+ for (const event of queued) this.#take(event);
62
+ this.#check();
63
+ }
64
+ #proc(pid, ppid, seq) {
65
+ const found = this.#procs.get(pid);
66
+ if (found) return found;
67
+ if (this.#procs.size >= PIDS_HELD) {
68
+ this.#dropped++;
69
+ return void 0;
70
+ }
71
+ const made = { pid, ppid, start: seq, cpu: 0 };
72
+ this.#procs.set(pid, made);
73
+ return made;
74
+ }
75
+ #launcher(proc, argv) {
76
+ return proc.name === void 0 && this.#launchers.some((each) => same(argv, each));
77
+ }
78
+ #take(event) {
79
+ if (event.type === "exit") {
80
+ this.#exit(event);
81
+ return;
82
+ }
83
+ const proc = this.#proc(event.pid, event.ppid, event.seq);
84
+ if (!proc || event.type === "fork" || this.#launcher(proc, event.argv)) return;
85
+ const program = programOf(event.argv, event.exe);
86
+ if (!program) return;
87
+ proc.name = program.name;
88
+ if (this.#intent === void 0 && SAYERS.has(program.name)) {
89
+ const said = argvIntent(program.args);
90
+ if (said) this.#intent = said.slice(0, INTENT_HELD);
91
+ }
92
+ if (this.#names.has(program.name)) return;
93
+ if (this.#names.size >= NAMES_HELD) {
94
+ this.#more++;
95
+ proc.name = void 0;
96
+ return;
97
+ }
98
+ this.#names.set(program.name, { first: event.seq, cpu: 0 });
99
+ }
100
+ #exit(event) {
101
+ if (event.pid === this.#root) this.#rootEnded = true;
102
+ const proc = this.#procs.get(event.pid);
103
+ if (!proc || proc.end !== void 0) return;
104
+ proc.end = event.seq;
105
+ proc.status = event.status;
106
+ if (event.signal) proc.signal = event.signal;
107
+ proc.cpu = (event.utime ?? 0) + (event.stime ?? 0);
108
+ const named = proc.name === void 0 ? void 0 : this.#names.get(proc.name);
109
+ if (named) named.cpu += proc.cpu;
110
+ }
111
+ get done() {
112
+ return this.#rootEnded && [...this.#procs.values()].every((proc) => proc.end !== void 0);
113
+ }
114
+ #check() {
115
+ if (this.done) this.#wake?.();
116
+ }
117
+ settled(ms) {
118
+ if (this.done) return Promise.resolve();
119
+ return new Promise((resolve) => {
120
+ const timer = setTimeout(finish, ms);
121
+ function finish() {
122
+ clearTimeout(timer);
123
+ resolve();
124
+ }
125
+ this.#wake = finish;
126
+ });
127
+ }
128
+ #related(a, b) {
129
+ const above = (low, high) => {
130
+ const seen = /* @__PURE__ */ new Set();
131
+ for (let at = this.#procs.get(low.ppid); at && !seen.has(at.pid); at = this.#procs.get(at.ppid)) {
132
+ if (at.pid === high.pid) return true;
133
+ seen.add(at.pid);
134
+ }
135
+ return false;
136
+ };
137
+ return above(a, b) || above(b, a);
138
+ }
139
+ #piped(proc) {
140
+ const end = proc.end ?? Number.POSITIVE_INFINITY;
141
+ for (const other of this.#procs.values())
142
+ if (other !== proc && other.start < end && (other.end ?? Number.POSITIVE_INFINITY) > proc.start && !this.#related(proc, other))
143
+ return true;
144
+ return false;
145
+ }
146
+ #quiet(proc, killed) {
147
+ if (proc.pid === this.#root) return true;
148
+ if (killed && proc.signal !== void 0) return true;
149
+ return sigpipe(proc) && this.#piped(proc);
150
+ }
151
+ facts(ms, killed) {
152
+ const ranked = [...this.#names].sort(([, a], [, b]) => b.cpu - a.cpu || a.first - b.first);
153
+ const kept = ranked.slice(0, PROGRAMS_KEPT);
154
+ const programs = kept.map(([name]) => this.#program(name, killed));
155
+ const more = this.#more + ranked.length - kept.length;
156
+ return {
157
+ programs,
158
+ ms,
159
+ ...more ? { more } : {},
160
+ ...this.#dropped ? { dropped: this.#dropped } : {},
161
+ ...this.#intent ? { intent: this.#intent } : {}
162
+ };
163
+ }
164
+ #program(name, killed) {
165
+ const runs = [...this.#procs.values()].filter((proc) => proc.name === name && proc.end !== void 0).sort((a, b) => a.end - b.end);
166
+ const loud = runs.find((proc) => proc.status !== 0 && !this.#quiet(proc, killed));
167
+ const shown = loud ?? runs.find((proc) => proc.status !== 0) ?? runs.at(-1);
168
+ if (!shown) return { name };
169
+ return {
170
+ name,
171
+ status: shown.status,
172
+ ...shown.signal ? { signal: shown.signal } : {},
173
+ ...shown.status !== 0 && !loud ? { quiet: true } : {}
174
+ };
175
+ }
176
+ }
177
+ async function follow(client, tag, argv, launchers) {
178
+ if (typeof client.trace !== "function") return void 0;
179
+ const collector = new Collector(argv, launchers);
180
+ try {
181
+ const subscription = await client.trace(tag, (batch) => collector.feed(batch), {
182
+ limit: TRACE_LIMIT
183
+ });
184
+ return { collector, close: () => subscription.close() };
185
+ } catch {
186
+ return void 0;
187
+ }
188
+ }
189
+ export {
190
+ CALL_TAG,
191
+ Collector,
192
+ INTENT_HELD,
193
+ LINGER_MS,
194
+ NAMES_HELD,
195
+ PIDS_HELD,
196
+ PROGRAMS_KEPT,
197
+ QUEUE_HELD,
198
+ TRACE_LIMIT,
199
+ argvIntent,
200
+ follow,
201
+ programOf
202
+ };
203
+ //# sourceMappingURL=trace.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../src/kernel/trace.ts"],
4
+ "sourcesContent": ["import type { KernelClient, TraceBatch, TraceEvent } from './client.ts';\n\nexport const CALL_TAG = 'call:';\nexport const PROGRAMS_KEPT = 16;\nexport const NAMES_HELD = 64;\nexport const PIDS_HELD = 1024;\nexport const QUEUE_HELD = 4096;\nexport const LINGER_MS = 2000;\nexport const TRACE_LIMIT = 4096;\nexport const INTENT_HELD = 1000;\n\nexport interface RanProgram {\n name: string;\n status?: number;\n signal?: string;\n quiet?: true;\n}\n\nexport interface Ran {\n programs: RanProgram[];\n ms: number;\n more?: number;\n dropped?: number;\n intent?: string;\n}\n\nexport interface CallTrace {\n tag: string;\n report(ran: Ran): void;\n}\n\ntype Proc = {\n pid: number;\n ppid: number;\n start: number;\n end?: number;\n name?: string;\n status?: number;\n signal?: string;\n cpu: number;\n};\n\nconst INTERPRETERS =\n /^(?:(?:ba|da|z|k|c|tc|fi)?sh|node|jsh|deno|bun|tsx|python[\\d.]*|pypy[\\d.]*|perl[\\d.]*|ruby[\\d.]*|php[\\d.]*|lua[\\d.]*)$/;\nconst NAME = /^[^\\s/\\p{Cc}\\p{Cf}]{1,64}$/u;\nconst SAYERS = new Set(['intent', 'playwright-cli']);\n\nfunction leaf(path: string): string {\n return path.split('/').filter(Boolean).at(-1) ?? '';\n}\n\nexport function programOf(\n argv: readonly string[],\n exe?: string\n): { name: string; args: readonly string[] } | undefined {\n const first = leaf(argv[0] ?? '') || leaf(exe ?? '');\n const script = argv[1] ?? '';\n const shebang =\n INTERPRETERS.test(first) &&\n script.includes('/') &&\n !script.startsWith('-') &&\n !/\\s/.test(script) &&\n NAME.test(leaf(script));\n const name = shebang ? leaf(script) : first;\n if (!NAME.test(name)) return undefined;\n return { name, args: argv.slice(shebang ? 2 : 1) };\n}\n\nexport function argvIntent(args: readonly string[]): string | undefined {\n for (let at = 0; at < args.length; at++) {\n const arg = args[at] as string;\n if (arg === '--') return undefined;\n if (arg === '--intent') return args[at + 1];\n if (arg.startsWith('--intent=')) return arg.slice('--intent='.length);\n }\n return undefined;\n}\n\nconst sigpipe = (proc: Proc) => proc.status === 141 || proc.signal === 'SIGPIPE';\n\nconst same = (a: readonly string[], b: readonly string[]) =>\n a.length === b.length &&\n a.every((word, at) => (at === 0 ? leaf(word) === leaf(b[0] as string) : word === b[at]));\n\nexport class Collector {\n readonly #procs = new Map<number, Proc>();\n readonly #names = new Map<string, { first: number; cpu: number }>();\n readonly #launchers: readonly (readonly string[])[];\n #queue: TraceEvent[] | undefined = [];\n #root: number | undefined;\n #rootEnded = false;\n #dropped = 0;\n #more = 0;\n #intent: string | undefined;\n #wake: (() => void) | undefined;\n\n constructor(argv: readonly string[], launchers: number) {\n this.#launchers = Array.from({ length: launchers }, (_, at) => argv.slice(at));\n }\n\n feed(batch: TraceBatch): void {\n this.#dropped += batch.dropped;\n for (const event of batch.events) {\n if (!this.#queue) this.#take(event);\n else if (this.#queue.length < QUEUE_HELD) this.#queue.push(event);\n else this.#dropped++;\n }\n this.#check();\n }\n\n begin(pid: number): void {\n this.#root = pid;\n const queued = this.#queue ?? [];\n this.#queue = undefined;\n for (const event of queued) this.#take(event);\n this.#check();\n }\n\n #proc(pid: number, ppid: number, seq: number): Proc | undefined {\n const found = this.#procs.get(pid);\n if (found) return found;\n if (this.#procs.size >= PIDS_HELD) {\n this.#dropped++;\n return undefined;\n }\n const made: Proc = { pid, ppid, start: seq, cpu: 0 };\n this.#procs.set(pid, made);\n return made;\n }\n\n #launcher(proc: Proc, argv: readonly string[]): boolean {\n return proc.name === undefined && this.#launchers.some((each) => same(argv, each));\n }\n\n #take(event: TraceEvent): void {\n if (event.type === 'exit') {\n this.#exit(event);\n return;\n }\n const proc = this.#proc(event.pid, event.ppid, event.seq);\n if (!proc || event.type === 'fork' || this.#launcher(proc, event.argv)) return;\n const program = programOf(event.argv, event.exe);\n if (!program) return;\n proc.name = program.name;\n if (this.#intent === undefined && SAYERS.has(program.name)) {\n const said = argvIntent(program.args);\n if (said) this.#intent = said.slice(0, INTENT_HELD);\n }\n if (this.#names.has(program.name)) return;\n if (this.#names.size >= NAMES_HELD) {\n this.#more++;\n proc.name = undefined;\n return;\n }\n this.#names.set(program.name, { first: event.seq, cpu: 0 });\n }\n\n #exit(event: Extract<TraceEvent, { type: 'exit' }>): void {\n if (event.pid === this.#root) this.#rootEnded = true;\n const proc = this.#procs.get(event.pid);\n if (!proc || proc.end !== undefined) return;\n proc.end = event.seq;\n proc.status = event.status;\n if (event.signal) proc.signal = event.signal;\n proc.cpu = (event.utime ?? 0) + (event.stime ?? 0);\n const named = proc.name === undefined ? undefined : this.#names.get(proc.name);\n if (named) named.cpu += proc.cpu;\n }\n\n get done(): boolean {\n return this.#rootEnded && [...this.#procs.values()].every((proc) => proc.end !== undefined);\n }\n\n #check(): void {\n if (this.done) this.#wake?.();\n }\n\n settled(ms: number): Promise<void> {\n if (this.done) return Promise.resolve();\n return new Promise((resolve) => {\n const timer = setTimeout(finish, ms);\n function finish() {\n clearTimeout(timer);\n resolve();\n }\n this.#wake = finish;\n });\n }\n\n #related(a: Proc, b: Proc): boolean {\n const above = (low: Proc, high: Proc) => {\n const seen = new Set<number>();\n for (\n let at = this.#procs.get(low.ppid);\n at && !seen.has(at.pid);\n at = this.#procs.get(at.ppid)\n ) {\n if (at.pid === high.pid) return true;\n seen.add(at.pid);\n }\n return false;\n };\n return above(a, b) || above(b, a);\n }\n\n #piped(proc: Proc): boolean {\n const end = proc.end ?? Number.POSITIVE_INFINITY;\n for (const other of this.#procs.values())\n if (\n other !== proc &&\n other.start < end &&\n (other.end ?? Number.POSITIVE_INFINITY) > proc.start &&\n !this.#related(proc, other)\n )\n return true;\n return false;\n }\n\n #quiet(proc: Proc, killed: boolean): boolean {\n if (proc.pid === this.#root) return true;\n if (killed && proc.signal !== undefined) return true;\n return sigpipe(proc) && this.#piped(proc);\n }\n\n facts(ms: number, killed: boolean): Ran {\n const ranked = [...this.#names].sort(([, a], [, b]) => b.cpu - a.cpu || a.first - b.first);\n const kept = ranked.slice(0, PROGRAMS_KEPT);\n const programs = kept.map(([name]) => this.#program(name, killed));\n const more = this.#more + ranked.length - kept.length;\n return {\n programs,\n ms,\n ...(more ? { more } : {}),\n ...(this.#dropped ? { dropped: this.#dropped } : {}),\n ...(this.#intent ? { intent: this.#intent } : {}),\n };\n }\n\n #program(name: string, killed: boolean): RanProgram {\n const runs = [...this.#procs.values()]\n .filter((proc) => proc.name === name && proc.end !== undefined)\n .sort((a, b) => (a.end as number) - (b.end as number));\n const loud = runs.find((proc) => proc.status !== 0 && !this.#quiet(proc, killed));\n const shown = loud ?? runs.find((proc) => proc.status !== 0) ?? runs.at(-1);\n if (!shown) return { name };\n return {\n name,\n status: shown.status as number,\n ...(shown.signal ? { signal: shown.signal } : {}),\n ...(shown.status !== 0 && !loud ? { quiet: true as const } : {}),\n };\n }\n}\n\nexport interface Tracer {\n collector: Collector;\n close(): void;\n}\n\nexport async function follow(\n client: KernelClient,\n tag: string,\n argv: readonly string[],\n launchers: number\n): Promise<Tracer | undefined> {\n if (typeof client.trace !== 'function') return undefined;\n const collector = new Collector(argv, launchers);\n try {\n const subscription = await client.trace(tag, (batch) => collector.feed(batch), {\n limit: TRACE_LIMIT,\n });\n return { collector, close: () => subscription.close() };\n } catch {\n return undefined;\n }\n}\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
package/dist/main.js CHANGED
@@ -48,6 +48,7 @@ import { modelsCommand } from "./models/index.js";
48
48
  import { pageOnly, transportFetch, transportReach } from "./net.js";
49
49
  import { sliccPrompt } from "./prompt.js";
50
50
  import { AZURE, azureBase } from "./providers.js";
51
+ import { ranExtension } from "./ran/index.js";
51
52
  import { createPages } from "./remote/pages.js";
52
53
  import { identity } from "./scoops/identity.js";
53
54
  import { packageAssets, setupScoops } from "./scoops/index.js";
@@ -379,6 +380,7 @@ async function start(scope, ports, options, vault) {
379
380
  registry.install(codemodeExtension(codemode));
380
381
  const intents = intentsOn(await settingsFile(client, at.agentDir));
381
382
  registry.install(intentExtension([...coding, ...codemode], intents));
383
+ registry.install(ranExtension(coding));
382
384
  if (chosen.toolSearch) registry.install(createToolSearchExtension());
383
385
  const licks = setupLicks(registry, transport);
384
386
  licks.licks.triage(lickTriage(models));