@ai-ecoverse/slicc-agent 7.33.1 → 7.34.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 +6 -5
- package/dist/approvals/run-licks.js +40 -22
- package/dist/approvals/run-licks.js.map +2 -2
- package/dist/approvals/run-notice.js +170 -0
- package/dist/approvals/run-notice.js.map +7 -0
- package/dist/client.js +3 -0
- package/dist/client.js.map +2 -2
- package/dist/control.js.map +2 -2
- package/dist/guests/client.js +1 -0
- package/dist/guests/client.js.map +2 -2
- package/dist/host.js +8 -2
- package/dist/host.js.map +2 -2
- package/dist/index.js +6 -0
- package/dist/index.js.map +2 -2
- package/dist/secrets/endpoints.js.map +1 -1
- package/dist/secrets/fetch.js.map +2 -2
- package/dist/secrets/records.js.map +2 -2
- package/dist/secrets/vault-types.js +1 -0
- package/dist/secrets/vault-types.js.map +7 -0
- package/dist/secrets/vault.js.map +2 -2
- package/dist/services.js +3 -1
- package/dist/services.js.map +2 -2
- package/dist/types/approvals/run-licks.d.ts +15 -3
- package/dist/types/approvals/run-notice.d.ts +63 -0
- package/dist/types/client.d.ts +2 -0
- package/dist/types/control.d.ts +1 -1
- package/dist/types/index.d.ts +1 -0
- package/dist/types/secrets/endpoints.d.ts +1 -1
- package/dist/types/secrets/fetch.d.ts +1 -1
- package/dist/types/secrets/records.d.ts +2 -2
- package/dist/types/secrets/vault-types.d.ts +29 -0
- package/dist/types/secrets/vault.d.ts +1 -1
- package/dist/types/services.d.ts +3 -1
- package/package.json +7 -7
package/README.md
CHANGED
|
@@ -30,9 +30,9 @@ await agent.prompt('What is in /home?');
|
|
|
30
30
|
- `openOpfsSqliteStorage({ directory?, file? })` keeps the session in wasm SQLite ([`@sqlite.org/sqlite-wasm`](https://www.npmjs.com/package/@sqlite.org/sqlite-wasm)) in an `opfs-sahpool` pool, by default `/.slicc/agent/` in OPFS. It needs a dedicated worker. Only one worker holds a pool at a time: the opener takes a Web Lock per directory and waits until every file of the pool can be opened before sqlite-wasm installs it, because a failed install deletes the pool's directory. `openMemorySqliteStorage()` keeps the same database in memory. **Document bases.** Every session and conversation document the agent defines stores a complete base after 64 deltas (`boundedDeltas` in `src/checkpoints.ts`, the policy pi durable's codemode journal uses), so reading one replays at most 64 changes: with deltas only, a document changed 5,000 times took about 26 ms to read after a reopen, against under 1 ms. Task documents, which end with their task, keep deltas only. **Profile marker:** every open, under the pool's lock and before pi durable opens (and migrates) the database, writes `<directory>-profile.json` next to the pool, `/.slicc/agent-profile.json` by default: `{ "durableSchema": 2, "agent": "<version>" }`, with pi durable's `CURRENT_SQLITE_SCHEMA_VERSION` and the agent's version (the `agent` option, or the version in the agent's `package.json`). A `durableSchema` already in the file is never lowered. bios reads it from OPFS before it starts an agent, and refuses one whose pi durable schema is lower (slicc-agent 6.x is 1): the schema version lives in a `durable_schema` table, not in the SQLite header, so the database itself can't be checked without opening it. On pi durable 1.4, opening a database written by an earlier agent migrates it to durable's SQLite schema 2, once and in place; an agent on pi durable 1.3 or earlier (slicc-agent 6.19.13 and earlier) can't open it afterwards, so the agent can't be rolled back past this version. Requests through the Harness are attributed to SLICC (`identity: { attribution: { name: 'SLICC', url: 'https://www.sliccy.com' } }`), which pi-ai sends as OpenRouter's `HTTP-Referer` and `X-OpenRouter-Title`, NVIDIA's `X-BILLING-INVOKE-ORIGIN` and OpenCode's `x-opencode-client`; OpenRouter's preflight allows them from `https://seven.sliccy.ai`, and NVIDIA and OpenCode answer no browser preflight at all, so they go through a CORS-free transport either way. pi durable's crash-loop guard is on with its default: a task cut off 5 times in a row without committing a new state (a crash, a reload or `restart()`, which end the worker without closing the session) ends instead of being parked. A built-in generation, tool or compaction reports `task_interrupted`; any other task reports `task_faulted` with reason `restart_limit`. The monitor alerts that as an error and offers no command to resume it. `agent retry <task id>` says to submit the work again. Only the user may ask; an agent's `agent retry` is refused.
|
|
31
31
|
- `hostAgent(agent)` serves the agent from one Chord host named `agent` (`serveAgent` in [`src/host.ts`](src/host.ts)). Its remote contracts, in [`src/services.ts`](src/services.ts), are `slicc.agent.control` (send with `whenBusy` `steer`, `followUp` or `reject`, wait, withdraw, abort, compact) and `slicc.agent.transcript` (the conversation's durable view as replicated state, plus `deliveries`: how each user entry was delivered, `run`, `steer` or `follow-up`, derived by the host from where each send it accepted was placed: after a tool result it steered, queued first it's a follow-up or a late steer per its `whenBusy`, placed at once it started a run), `slicc.agent.settings`, `slicc.agent.remote` (remote control), `slicc.agent.pages` (Panels) and `slicc.agent.guest` (Guest seats). `serveConnections(self, host)` hands it every `MessagePort` the page sends, and each port becomes one Chord link whose principal is a seat: `owner` (a page of the owner, with its own Panels), `control` (a follower with Control), `view` (a follower without) or `guest` (a guest seat, with its id, label and epoch), plus the link's number, so every link gets its own objects. The principal is typed (`AgentPrincipal` in [`src/serving.ts`](src/serving.ts)); the host's own code acts as `{ seat: 'host' }`, which no link gets. Each factory picks a variant per seat. Every contract places its objects on the host `agent` (`hostNamed`), so no caller names a host. The contracts take their methods' arguments as one JSON array, and the client in [`src/serving.ts`](src/serving.ts) turns them back into the `AgentControl`, `AgentSettings`, `AgentRemote` and `AgentPages` interfaces and their replicated states, so callers don't see Chord.
|
|
32
32
|
- `@ai-ecoverse/slicc-agent/page` has what the page needs (`startAgent`, `connectAgent`) without the agent's runtime: no pi-durable, pi-ai, providers or SQLite, which load only in the worker. `@ai-ecoverse/slicc-agent/spectrum` is just as light, and a test keeps both that way.
|
|
33
|
-
- `startAgent({ worker })` takes the Web Lock `slicc-agent`, so one tab at a time owns the agent worker, and waits while another tab holds it. `connect()` returns an `AgentConnection` (`control`, `transcript`, `prompt()`,
|
|
33
|
+
- `startAgent({ worker })` takes the Web Lock `slicc-agent`, so one tab at a time owns the agent worker, and waits while another tab holds it. `connect()` returns an `AgentConnection` (`control`, `transcript`, `prompt()`, `webhook(name, { id?, headers?, body })`, which hands a webhook delivery, such as one from the tray hub, to the licks without a chord `Context`, and `approvalRunNotice(notice)`, see Run now), `restart()` replaces the worker (durable resumes from SQLite), and `release()` stops it and lets the next tab take over. `port()` returns a raw `MessagePort` into the worker instead, for another tab: hand it over (through a SharedWorker, say), and that tab calls `connectAgent(port)`. A caller that already holds the lock passes `held: true`. A connection's `closed` resolves when its port ends (with the error, if any), and from then on its states keep their last values.
|
|
34
34
|
- **Followers over a link** (PR 18): `port({ readOnly: true })` and `connect({ readOnly: true })` give a view-only connection, and `port({ pages: false })` a full one that never takes `panel` requests (see Panels).
|
|
35
|
-
- **What a view-only connection can do:** it sees the transcript, the agents, settings state and remote-control `watch`, and may call `wait` and `changesOpen`. It's still an owner device, so it has the owner-device methods (`OWNER_DEVICE_METHODS` in [`src/services.ts`](src/services.ts)) with the owner's powers: `decide`, `approvalRun`, `approvalRunStop`, `guestOpen`, `guestRevoke`, `guestAlwaysForget` and `approvalPolicySet`. Control gates driving, not approvals.
|
|
35
|
+
- **What a view-only connection can do:** it sees the transcript, the agents, settings state and remote-control `watch`, and may call `wait` and `changesOpen`. It's still an owner device, so it has the owner-device methods (`OWNER_DEVICE_METHODS` in [`src/services.ts`](src/services.ts)) with the owner's powers: `decide`, `approvalRun`, `approvalRunStop`, `approvalRunNotice`, `guestOpen`, `guestRevoke`, `guestAlwaysForget` and `approvalPolicySet`. Control gates driving, not approvals.
|
|
36
36
|
- **What it can't:** every other `AgentControl` method, settings action and remote-control `prompt` or `abort` is refused with `EACCES` ("this follower can watch, but not send, steer or abort"). Send and compact answer `accepted: false` with that code, and `addServer` and `removeServer` answer `not-owner`. The `view` seat's variants don't have those methods at all (`view` for control and settings, `watch` for remote control, `none` for Panels); the follower's client answers the missing ones with the refusals ([`src/readonly.ts`](src/readonly.ts)), so the worker never runs them. A `watch` stream is readable only over the link that opened it.
|
|
37
37
|
- **Carrying the connection over a byte stream:** `linkEndpoint({ write, close })` is a `PortEndpoint` that `connectAgent` accepts. Feed it the stream's bytes with `receive(bytes)` and its end with `end(error?)`. On the owner's side, `bridgePort(port, { write, close })` does the same for the `MessagePort` from `port()`.
|
|
38
38
|
- **The bytes:** the owner first posts a hello, its server id, then each Chord frame travels as its JSON text in UTF-8 (`PortLink` in [`src/wire.ts`](src/wire.ts)), and `{ close: true }` ends the port. The owner holds its own Chord frames until the client's Chord hello arrives, so it knows which Chord it talks to before it says anything. `PortLink.send` returns each frame's size, so Chord's flow control applies: once 256 KiB are unacknowledged, state waits at the owner, coalesced per member, instead of piling up in front of a slow WebRTC follower, while calls and results still pass. On a byte stream each message becomes a frame: a `u32` big-endian length, then a tag (0 data, 1 hello, 2 close), then the payload. A frame is at most 16 MiB, and a malformed one ends the link.
|
|
@@ -781,6 +781,7 @@ Every approval, of a guest's prompt, of a tool call in a run a guest started, of
|
|
|
781
781
|
- **At most once:** a task resumed after a worker restart while it was calling the kernel never calls again: it adopts the process from `ps` that carries the tag and runs as the target's uid, trying five times with backoff (250 ms doubling), and only then ends `failed` with "interrupted before it started". A resumed `running` one subscribes again and checks `ps`: gone without an exit is `done` with no status, and a kernel that booted since (`btime`, the page reloaded) is `failed` with "the page reloaded while it ran", unless a process with the tag is still alive, which it then keeps waiting for. A boot id that couldn't be read (`null`) is unknown, never a reload.
|
|
782
782
|
- **Stop:** `AgentControl.approvalRunStop(id)` sends `SIGTERM` to every live process with the run's tag, and `SIGKILL` 5 s later to those still there; a running run ends `stopped`. It also works on a `done` run that still has survivors. With no tagged process left it answers "Its processes are already gone." for a running run and "This request isn't running." otherwise, and without a process list "The kernel's process list isn't available, so it can't be stopped.". One stopped before the kernel was called never runs. The agent's own Stop (`Conversation.abort`) doesn't touch it, since it's the owner's run, not the agent's turn; aborting the task stops it.
|
|
783
783
|
- **Licks** go to `requester.agentId` (a scoop that's gone falls back to its cone, a frozen cone gets the frozen notice) on the channel `sudo-run`, from the item's id, never coalesced and once per `eventId` (`<id>:start`, `<id>:end`), with the taints of the request's tags, and both steer, so each wakes an idle agent. The start lick says the owner ran the timed-out request, when it asked and when it ran, the pid and the output path; the end lick has the exit status or signal, how long it took, any survivors and the full paths, never the output itself: the requester can write those files while the command runs, so the agent reads them with its own shell if it needs them, as normal tool output. It has `severity="warn"` unless it exited 0 with no survivors. When the requester is a scoop that has ended, both licks go to its cone and say so. Title, text and body go through the secrets redaction, then both go through `scrubbedLick`. The licks prompt section says a sudo-run lick reports a command the owner ran late, not a new request.
|
|
784
|
+
- **Run by bios:** a timed-out sudo that the owner runs from bios's own Approvals panel is bios's run, not the agent's, so bios reports it with `AgentControl.approvalRunNotice(notice)` (`connectAgent().approvalRunNotice(notice)` without a `Context`), once when it starts and once when it ends, and the agent tells the requester with the same `sudo-run` licks. Ids never collide: the agent's items are `apr-<uuid>`, bios's are `bios:<kernel id>`. It's an owner-device method (`OWNER_DEVICE_METHODS`), so every owner device, view-only ones included, may call it, and a guest seat can't. A process can't send it either: `agent send --lick=sudo-run` stays refused as the agent's own channel. The notice is facts, never text: `{ id, phase, agentId, command, requestedAt, at, tags, pid?, endedAt?, status?, signal?, survivors?, stopped?, capped?, stdout?, stderr? }`, `id` matching `bios:` (at most 128 characters), `phase` `start` or `end`, `agentId` the cone or scoop that asked, `command` the typed command (at most 1024 characters, control characters shown as spaces), the times in ms, `status` 0 to 255, `signal` a name such as `SIGTERM`, `survivors` at most 64 pids, `stopped` for one the owner stopped, `capped` the output cap in bytes it passed, `stdout` and `stderr` absolute paths (at most 1024 characters), and `tags`, required, at most 16 kernel tags, whose taints the licks carry as for `replay.tag`: bios must pass the kernel's tags for the run exactly (`[]` when it has none), so leaving them out can't drop a taint. Any other key, a wrong type, an oversized field, or a control character or line or paragraph separator (U+2028, U+2029) in `agentId`, a path or a tag is refused. The agent takes `agentId`, `command` and `tags` from the owner device on trust, as it does for `decide`: it can't check a run that bios held. The agent renders both licks itself with the templates above (`<id>:start`, `<id>:end`, source `id`, never coalesced, never the output), to the same target: the requester, its cone when the scoop has ended. It answers `{ delivered, reason? }` and never throws for a missing target: `delivered` is `false` with the sentence when the notice is malformed (such as "A run notice id is bios:<kernel id>." or "A run notice has no channel field."), when that `eventId` was already delivered ("This notice was already delivered.", so a retry never tells the agent twice), for a `start` after that id's `end` was delivered ("This run already ended.", so the agent is never told it runs after it exited), when the agent is gone ("The agent that asked is gone, so nobody was told.") or its cone is frozen ("<cone> is frozen, so nobody was told."). A run that never started sends no notice, as nothing ran.
|
|
784
785
|
- **In spectrum,** the adapter's `history()` lists every item, newest first, as an `ApprovalRecord` `{ approval, state, reason?, decidedBy?, device?, decidedAt?, answer?, run?, runnable? }` (`run` without `pgid` and `stopBy`, with `survivors` when there are some, `runnable` from `approvalRunnable`), with a `history` event when it changes; `run(id)` and `stopRun(id)` reject with the agent's sentence. Every owner device's adapter has all three, a guest connection's has none. With `approvals: biosPort`, the adapter merges bios's `history()` in and sends `run` and `stopRun` to whichever side listed the id. A `sudo-run` lick card carries `approval`, the item's id.
|
|
785
786
|
- **Media capture:** `AgentOwner.approveCapture(request, { signal, where? })` takes a `/dev/embedder` request as bios's hook receives it, `{ kind, options, stamp }`, and resolves `once`, `always`, `deny` or `{ answer: 'deny', message }`. It rejects with `code: 'EAGAIN'` when the agent can't answer (released, restarting, or a worker without it) and when `stamp.users` is neither `report` nor `enforce`, since the agent can't tell who started the program then, so bios falls back to its own prompt.
|
|
786
787
|
- **Who started it** comes only from the kernel's stamp: its `tags`, plus the taints the agent has seen alive for that process (`stamp.pid`) since it first saw it, the `recent` set the `agent` CLI uses ([`src/kernel/lineage.ts`](src/kernel/lineage.ts)). So a clean process that a guest's process sets off counts as the guest's while that cover holds: while a tagged process of the guest, or a `crontab` line it installed, lives, and for about 2 s after it ends (the agent's `ps` reads). Something the guest planted that runs later, such as a sprinkle CGI, a `~/.bashrc` line or a git hook, is attributed to whoever starts it then. As for the `agent` CLI, this is conservative: while a guest's leftover job or `crontab` line lives, everyone's captures are reviewed too. When the agent has no lineage provider or can't read the process's lineage, it denies.
|
|
@@ -888,7 +889,7 @@ The agent worker never holds a secret's value. Values live in the vault (`vault.
|
|
|
888
889
|
|
|
889
890
|
- **The port.** bios posts `{ kernel, admin, vault, scrub }` to the worker, where `vault` is a `MessagePort` to the vault frame (role `agent`) and `scrub` the last-known `{ needed, version, ready? }`, or `null` when no vault ever connected. On a vault reload it posts `{ vault, scrub }` again, and the worker resends its unanswered ops. The agent port gets no events, so bios also posts `{ locked }` (a boolean, from the page port's `status`) whenever the lock changes; the worker reads the initial state from the vault's `welcome`. With `needed: false`, every scrub is the identity; when scrubbing is needed but no port is connected, output waits. A `version` newer than the last pair read counts as `needed` until the new pair arrives. Pair versions are nonnegative safe integers and never move backwards within a worker, including on welcome or reconnect; `null` cannot reset an established pair, and equal-version updates cannot turn `needed` off. Only a strictly newer pair can turn it off. Optional `ready` must be boolean; `ready: false` does not bypass scrubbing.
|
|
890
891
|
- **Scrub receipts.** bios can post exactly `{ scrub, scrubReceipt: { v: 1, nonce, version } }` with one private transferred `MessagePort`. The nonce is 32 lowercase hex digits and the receipt version must equal the valid pair's version. The worker synchronously installs the pair, or retains an already newer state, then posts only `{ v: 1, nonce, version }` on that port and closes it. The reply echoes the requested version, not a higher installed version. Malformed requests and missing or extra ports get no receipt; receipt ports are closed even on rejection. Legacy initialization and update messages remain separate and send no receipt. A receipt confirms the scrub safety state is installed, not that the vault is unlocked or a credential is usable.
|
|
891
|
-
- **The wire** is slicc-vault's `
|
|
892
|
+
- **The wire** is slicc-vault's agent request/reply shape. The few wire types the agent needs (`AgentRecord`, `OutgoingRequest`, and the rest in `src/secrets/vault-types.ts`) are kept here so published `.d.ts` never name `@ai-ecoverse/slicc-vault`; that package is a devDependency for `npm run lint:vault-pi` and for `types/vault-conformance.ts`, which `npm run typecheck` uses to keep those copies equal to the vault's. Requests are `{ v: 1, id, op, ... }` and answers `{ v: 1, id, op, ... }` or `{ v: 1, id, error: { code, message } }`, in request order: `redact { texts }` (strings and `Uint8Array`s, answered in the same order and types, with `version`), the stream ops `redactStream`, `push { chunk }`, `end` and `drop` with the worker's string `stream` id, and `model`, `mcp`, `records`, `grant`, `refresh` and `endpoints`. The vault's first message, `welcome`, carries `status.scrub` and `status.locked`; version bumps come only from bios's `{ scrub }` posts and the `version` in answers.
|
|
892
893
|
- **Credentials by placeholder.** `records()` lists the `model` and `mcp` records (names, placeholders, states, never values). It is read at start, whenever `version` changes, and after `connect`, `disconnect` and `remove`. The read-only `CredentialStore` behind pi-ai returns a model record's placeholder as the API key (found by `kind: 'model'` and `provider`), with the account's non-secret fields as its env (Bedrock's `region` as `AWS_REGION`); writing to it throws.
|
|
893
894
|
- **The transport.** The worker's `fetch` is `vaultFetch`: a request to a configured provider's base URL (Bedrock's standard `bedrock-runtime.*.amazonaws.com` and `-fips` endpoints included, so the AWS SDK's bearer requests are covered), or one carrying a model placeholder in its URL or headers, goes out as `model { provider?, request }`; MCP requests go out as `mcp { server, request }`, discovery and client registration included. The vault returns the request scrubbed over every value and with the credential filled in its headers or URL, and the existing transport sends it (`loopbackFetch` for a server on `http://<port>.kernel.localhost`); the response comes back directly. `EAGAIN` prepares the request once more; a refusal becomes a response (403 for `EACCES`, with the vault's sentence); a 401 calls `refresh { provider | server }` once and sends again. A request the vault filled, and the code exchange of an MCP sign-in, don't follow redirects: they go out with `redirect: 'manual'`. A same-origin redirect goes back through the same op with the fetch spec's method and body rules, at most 5 times, so the vault's checks apply to the new URL. Any other redirect becomes a 403 that names only the origin, an opaque one included (`opaqueRedirect` from the transport), and it's an error if the transport reports that it followed one. The mode reaches the transport as `redirect` on its request, and a route that doesn't show it honours that (`traits.redirectPolicy`, or `traits.manualRedirects` without `traits.redirectHops`) gets no such request: it's a 403 before anything is sent. Nor does the worker's own fetch, so with no transport, or to the same origin, the same rule applies. Anything else passes through, and without a vault every request does. Transport errors name only the method and origin, never a prepared URL or header.
|
|
894
895
|
- **Endpoints.** `endpoints { mcp: [{ server, url, names?, tokenUrl? }] }` is sent when the port opens and whenever `mcp.json` changes: every server URL with the `${NAME}`s its headers use. Registrations only add. The agent registers no model URL at all: from slicc-vault 1.13.0 every model provider's endpoints are built into the vault (pi-ai's catalog, Bedrock's regions and Adobe's proxy as `adobe`), and a custom base URL a user types (Azure's `customBase`) is registered by the page; the agent port's `{ provider, url }` would be a no-op anyway.
|
|
@@ -907,7 +908,7 @@ The agent worker never holds a secret's value. Values live in the vault (`vault.
|
|
|
907
908
|
- **In spectrum.** The agent port's `hold()` is `{ reason: 'locked', held }` while the vault needs a passkey, `{ reason: 'waiting', held }` while scrubbing is needed and the port isn't `ready`, and `null` otherwise, with a `hold` event on each change (and `null` when it clears); spectrum (≥ 1.62.0) shows it above the composer, and older spectrum ignores it. While a hold is up, the worker's active cone is busy (`working` when it isn't running), so the composer steers and queues; a send made during the hold waits in the tab, shown in that cone's queue, and goes to the worker once the hold clears; removing it before then means it's never sent. `/secrets` entries (`slicc.secrets`) show as a "Secrets listed" notice, or "Secrets unavailable" with the reason.
|
|
908
909
|
- **The 3.x store is wiped.** 3.x kept model and MCP keys in the IndexedDB database `slicc-agent-credentials`; 4.x doesn't migrate them. At start, before any model call, the worker reads only that database's record keys (never decrypting), deletes it, and keeps the accounts it found (`adobe` as Adobe, `amazon-bedrock` as Bedrock, `mcp:<server>|…` as the server, anything else by its providerId) in the session document `slicc.keys-moved`. A missing database, or no `indexedDB`, does nothing. The worker waits up to 3 s for the delete and claims the keys moved only once it succeeds. A delete blocked by an open 3.x tab shows no notice yet: if it succeeds later in the session (the tab closes) its accounts are added then, and otherwise the next start tries again. A delete that fails reports nothing. Once the vault's records are read, the accounts still without a record are the settings state's `moved`, and the spectrum adapter's `notices` port shows one notice, with model accounts first and MCP servers grouped after them: "Your keys moved to seven's vault. Add them again in Settings › Accounts: Adobe, Bedrock; MCP servers: github, jira." (or "…, and the MCP server github" for one). Dismissing it calls `AgentSettings.dismissMoved`, which marks the document, so it stays dismissed across reloads. An account without a record reads not connected. A model call that finds no credential ("Provider is not configured", "No API key") leads with "Adobe isn't connected." or "Bedrock isn't connected.", with "Connect it in Settings › Accounts." underneath instead of the raw error, and opens settings, and a send whose run finds no model because its account isn't connected (Adobe lists models only once signed in) shows the same error. "Your Adobe session has expired." is kept for a 401 from a token that exists. The settings state's `labels` names every model of a provider without a record from the agent's catalogue ("Claude Haiku 4.5 (US) on Bedrock"), and the adapter puts that name in the header of a reply whose model isn't in the picker, instead of the raw id.
|
|
909
910
|
- **For bios:** the agent's `notices` (keys moved) would replace bios's own port in `{ ...bios, ...createAgentModel(connection) }`, so pass that port in instead, as `createAgentModel(connection, { notices: biosPort })`. The returned port lists bios's notices and then the agent's, sends `act` and `dismiss` to whichever port listed the id (never dismissing one with `dismissible: false`), and passes on both ports' `notices` events. Without the option, it lists only the agent's.
|
|
910
|
-
- **Tests.** The worker never compiles values: `src/` takes only `import type { Hit }` from [`@ai-ecoverse/slicc-scrub`](https://www.npmjs.com/package/@ai-ecoverse/slicc-scrub), the vault's scrubber, and the package is a devDependency. The fake vault the tests use scrubs with that package, and its `vectors.json` (every form, line-wrapped base64 and hex included) runs through each scrub point and each cut. A suite-wide check asserts that no captured model request, entry, slot or memory file holds any form of a seeded value. `test/integration/secrets-fnox.test.mjs` runs the listing on the page kernel with `@ai-ecoverse/wasi-fnox` (a devDependency) and the fake vault's `/dev/sealed` side (`fakeSealed`: `list`, `placeholder`, `materialize`, `materializeConsume` and `ask`): a sealed secret in the section and `/secrets`, a shell grant reaching a command through `fnox exec --shell-grants`, shell grants kept off by an unsealed `env = true` secret, fnox missing, fnox exiting non-zero on a config error that quotes a plain value (which never reaches the prompt, `/secrets` or the transcript), an empty config, and the kernel's `sealed ask` (slicc-kernel 1.175 on): a revealed value reaches the command while the transcript and every model request hold only its placeholder, and a cancelled ask exits 1; and `fnox set NAME --ask` (wasi-fnox 1.45.0-2 on), which seals what the user typed and prints only its placeholder.
|
|
911
|
+
- **Tests.** The worker never compiles values: `src/` takes only `import type { Hit }` from [`@ai-ecoverse/slicc-scrub`](https://www.npmjs.com/package/@ai-ecoverse/slicc-scrub), the vault's scrubber, and the package is a devDependency. [`@ai-ecoverse/slicc-vault`](https://www.npmjs.com/package/@ai-ecoverse/slicc-vault) is a devDependency for `npm run lint:vault-pi` only (the agent does not import it). The fake vault the tests use scrubs with that package, and its `vectors.json` (every form, line-wrapped base64 and hex included) runs through each scrub point and each cut. A suite-wide check asserts that no captured model request, entry, slot or memory file holds any form of a seeded value. `test/integration/secrets-fnox.test.mjs` runs the listing on the page kernel with `@ai-ecoverse/wasi-fnox` (a devDependency) and the fake vault's `/dev/sealed` side (`fakeSealed`: `list`, `placeholder`, `materialize`, `materializeConsume` and `ask`): a sealed secret in the section and `/secrets`, a shell grant reaching a command through `fnox exec --shell-grants`, shell grants kept off by an unsealed `env = true` secret, fnox missing, fnox exiting non-zero on a config error that quotes a plain value (which never reaches the prompt, `/secrets` or the transcript), an empty config, and the kernel's `sealed ask` (slicc-kernel 1.175 on): a revealed value reaches the command while the transcript and every model request hold only its placeholder, and a cancelled ask exits 1; and `fnox set NAME --ask` (wasi-fnox 1.45.0-2 on), which seals what the user typed and prints only its placeholder.
|
|
911
912
|
|
|
912
913
|
## The kernel
|
|
913
914
|
|
|
@@ -931,7 +932,7 @@ Fixes to pi stay in this repository. [`patches/patches.json`](patches/patches.js
|
|
|
931
932
|
|
|
932
933
|
**One Chord.** `@earendil-works/chord` is pinned to the version pi-durable pins (1.5.0), so the link, the serving code and pi-durable's state layer share one copy. `npm run lint:chord` (part of `npm run lint`) fails if the lockfile has a second Chord that the agent would load, or none. The `slicc-agent-5` devDependency brings its own Chords 1.2 and 1.3 for the version tests only, which the check skips because it's dev-only.
|
|
933
934
|
|
|
934
|
-
**pi-ai in lockstep with the vault.** The vault fills a model key only under the endpoints of its built-in table, which it generates from its own pi-ai pin and publishes as `"piAi"` in its package.json (slicc-vault 1.12.2 and later). `npm run lint:vault-pi` (part of `npm run lint`) fails when the installed `@ai-ecoverse/slicc-vault`'s `piAi` has another minor than our `@earendil-works/pi-ai`, or when it has none (an older vault). Renovate's `patched dependencies` group carries the `pi-ai-lockstep` label, as the vault's pi-ai updates do, so the two are found and bumped together.
|
|
935
|
+
**pi-ai in lockstep with the vault.** `@ai-ecoverse/slicc-vault` is a devDependency for this check only (Renovate bumps it as `chore(deps)` with no release; seven's install never gets it). The vault fills a model key only under the endpoints of its built-in table, which it generates from its own pi-ai pin and publishes as `"piAi"` in its package.json (slicc-vault 1.12.2 and later). `npm run lint:vault-pi` (part of `npm run lint`) fails when the installed `@ai-ecoverse/slicc-vault`'s `piAi` has another minor than our `@earendil-works/pi-ai`, or when it has none (an older vault). Renovate's `patched dependencies` group carries the `pi-ai-lockstep` label, as the vault's pi-ai updates do, so the two are found and bumped together.
|
|
935
936
|
|
|
936
937
|
## Develop
|
|
937
938
|
|
|
@@ -68,14 +68,27 @@ function handedOn(state, agentId) {
|
|
|
68
68
|
if (!scoop || live(scoop) || scoop.frozen) return [];
|
|
69
69
|
return [`The scoop that asked, ${scoop.name}, has ended, so this goes to its cone.`];
|
|
70
70
|
}
|
|
71
|
-
|
|
71
|
+
function itemFacts(item) {
|
|
72
|
+
const run = item.run;
|
|
72
73
|
const replay = item.replay;
|
|
73
|
-
|
|
74
|
-
|
|
74
|
+
return {
|
|
75
|
+
id: item.id,
|
|
76
|
+
agentId: item.requester.agentId,
|
|
77
|
+
typed: typed(item),
|
|
78
|
+
where: where(item),
|
|
79
|
+
requestedAt: item.createdAt,
|
|
80
|
+
run,
|
|
81
|
+
tags: [...replay?.tag ? [replay.tag] : [], ...replay?.tags ?? []],
|
|
82
|
+
started: ` Output: ${run.stdout} (.err)`,
|
|
83
|
+
ended: ` Read it with your shell if you need it: ${run.stdout} and ${run.stderr} (kept for ${KEEP_HOURS} h).`
|
|
84
|
+
};
|
|
85
|
+
}
|
|
86
|
+
async function lickBase(host, facts) {
|
|
87
|
+
const taints = await taggedTaints(host.harness, facts.tags, BACKGROUND_CONTEXT);
|
|
75
88
|
return {
|
|
76
89
|
channel: "sudo-run",
|
|
77
|
-
source:
|
|
78
|
-
target: agentTarget(host.agents.state(),
|
|
90
|
+
source: facts.id,
|
|
91
|
+
target: agentTarget(host.agents.state(), facts.agentId),
|
|
79
92
|
coalesce: false,
|
|
80
93
|
...taints.length ? { taints } : {}
|
|
81
94
|
};
|
|
@@ -88,39 +101,43 @@ function clean(event) {
|
|
|
88
101
|
body: redacted(event.body)
|
|
89
102
|
};
|
|
90
103
|
}
|
|
91
|
-
|
|
92
|
-
|
|
104
|
+
const factsOf = (from) => "kind" in from ? itemFacts(from) : from;
|
|
105
|
+
async function startLick(host, from) {
|
|
106
|
+
const facts = factsOf(from);
|
|
107
|
+
const { run } = facts;
|
|
93
108
|
const now = host.now?.() ?? Date.now();
|
|
109
|
+
const pid = run.pid !== void 0 ? ` (pid ${run.pid})` : "";
|
|
94
110
|
return clean({
|
|
95
|
-
...await lickBase(host,
|
|
96
|
-
eventId: `${
|
|
97
|
-
title: `sudo runs now: ${typed
|
|
111
|
+
...await lickBase(host, facts),
|
|
112
|
+
eventId: `${facts.id}:start`,
|
|
113
|
+
title: `sudo runs now: ${facts.typed}`,
|
|
98
114
|
text: "[the owner ran your timed-out sudo request]",
|
|
99
115
|
body: [
|
|
100
|
-
`Your sudo request from ${clock(
|
|
101
|
-
`The owner ran it at ${clock(run.at, now)} with Run now. It runs in the background
|
|
102
|
-
`Its result follows as another sudo-run lick
|
|
103
|
-
...handedOn(host.agents.state(),
|
|
116
|
+
`Your sudo request from ${clock(facts.requestedAt, now)} (${facts.where}) timed out.`,
|
|
117
|
+
`The owner ran it at ${clock(run.at, now)} with Run now. It runs in the background${pid}, with no terminal and no input.`,
|
|
118
|
+
`Its result follows as another sudo-run lick.${facts.started}`,
|
|
119
|
+
...handedOn(host.agents.state(), facts.agentId)
|
|
104
120
|
].join("\n")
|
|
105
121
|
});
|
|
106
122
|
}
|
|
107
|
-
async function endLick(host,
|
|
108
|
-
const
|
|
123
|
+
async function endLick(host, from) {
|
|
124
|
+
const facts = factsOf(from);
|
|
125
|
+
const { run } = facts;
|
|
109
126
|
const ran = outcome(run);
|
|
110
127
|
const took = run.endedAt !== void 0 ? ` after ${duration(run.endedAt - run.at)}` : "";
|
|
111
128
|
const left = run.survivors?.length ? [
|
|
112
129
|
`Still running: pid ${run.survivors.join(", ")}. They left its process group; the owner can end them with Stop in Approvals.`
|
|
113
130
|
] : [];
|
|
114
131
|
return clean({
|
|
115
|
-
...await lickBase(host,
|
|
116
|
-
eventId: `${
|
|
117
|
-
title: `sudo run ended: ${typed
|
|
132
|
+
...await lickBase(host, facts),
|
|
133
|
+
eventId: `${facts.id}:end`,
|
|
134
|
+
title: `sudo run ended: ${facts.typed}`,
|
|
118
135
|
text: `[your late sudo run ended: ${ran.text}]`,
|
|
119
136
|
body: [
|
|
120
|
-
`${where
|
|
137
|
+
`${facts.where} ${ran.sentence}${took}.`,
|
|
121
138
|
...left,
|
|
122
|
-
`Its output isn't shown here
|
|
123
|
-
...handedOn(host.agents.state(),
|
|
139
|
+
`Its output isn't shown here.${facts.ended}`,
|
|
140
|
+
...handedOn(host.agents.state(), facts.agentId)
|
|
124
141
|
].join("\n"),
|
|
125
142
|
...ran.ok && !left.length ? {} : { severity: "warn" }
|
|
126
143
|
});
|
|
@@ -131,6 +148,7 @@ export {
|
|
|
131
148
|
clock,
|
|
132
149
|
duration,
|
|
133
150
|
endLick,
|
|
151
|
+
itemFacts,
|
|
134
152
|
sized,
|
|
135
153
|
startLick
|
|
136
154
|
};
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../src/approvals/run-licks.ts"],
|
|
4
|
-
"sourcesContent": ["import { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { Harness } from '@earendil-works/pi-durable';\nimport { type AgentsState, live } from '../agents.ts';\nimport { taggedTaints } from '../guests/tags.ts';\nimport type { LickEvent } from '../licks/licks.ts';\nimport { redactSecrets } from '../memory/format.ts';\nimport type { SudoApproval, SudoRun } from './record.ts';\nimport { agentTarget } from './runnable.ts';\nimport { shellWord } from './sudo.ts';\n\nexport const KEEP_HOURS = 24;\nexport const MIB = 1024 * 1024;\n\nexport type LickHost = {\n harness: Pick<Harness, 'commit' | 'snapshot'>;\n agents: { state(): Readonly<AgentsState> };\n now?: () => number;\n};\n\nconst redacted = (text: string) => redactSecrets(text).text;\n\nexport const sized = (bytes: number): string =>\n bytes % MIB === 0 ? `${bytes / MIB} MiB` : `${Math.round(bytes / 1024)} KiB`;\n\nfunction typed(item: SudoApproval): string {\n return (item.replay?.argv ?? [])\n .map((word) => shellWord(String(word)))\n .join(' ')\n .trim();\n}\n\nfunction where(item: SudoApproval): string {\n const { command, target, cwd } = item.detail;\n return `${command} as ${target ?? 'root'}${cwd ? ` in ${cwd}` : ''}`;\n}\n\nconst pad = (value: number) => String(value).padStart(2, '0');\n\nexport function clock(at: number, now: number): string {\n const when = new Date(at);\n const time = `${pad(when.getHours())}:${pad(when.getMinutes())}`;\n if (when.toDateString() === new Date(now).toDateString()) return time;\n return `${when.getFullYear()}-${pad(when.getMonth() + 1)}-${pad(when.getDate())} ${time}`;\n}\n\nexport function duration(ms: number): string {\n const seconds = Math.max(0, Math.round(ms / 1000));\n if (seconds < 60) return `${seconds} s`;\n const minutes = Math.floor(seconds / 60);\n if (minutes < 60) return `${minutes} min ${seconds % 60} s`;\n return `${Math.floor(minutes / 60)} h ${minutes % 60} min`;\n}\n\nfunction outcome(run: SudoRun): { text: string; sentence: string; ok: boolean } {\n if (run.state === 'failed')\n return { text: run.error ?? 'failed', sentence: `didn't finish: ${run.error}`, ok: false };\n const signal = run.signal ? ` (${run.signal})` : '';\n if (run.capped)\n return {\n text: `stopped: its output passed ${sized(run.capped)}`,\n sentence: `was stopped because its output passed ${sized(run.capped)}${signal}`,\n ok: false,\n };\n if (run.state === 'stopped')\n return {\n text: 'stopped by the owner',\n sentence: `was stopped by the owner${signal}`,\n ok: false,\n };\n if (run.status === undefined)\n return {\n text: 'status unknown',\n sentence: 'ended while the agent was away, so its exit status is unknown',\n ok: false,\n };\n if (run.signal)\n return {\n text: `killed by ${run.signal}`,\n sentence: `was killed by ${run.signal} (status ${run.status})`,\n ok: false,\n };\n return {\n text: `exit ${run.status}`,\n sentence: `exited with status ${run.status}`,\n ok: run.status === 0,\n };\n}\n\nfunction handedOn(state: Readonly<AgentsState>, agentId: string): string[] {\n const scoop = agentId.startsWith('scoop:') ? state.scoops[agentId] : undefined;\n if (!scoop || live(scoop) || scoop.frozen) return [];\n return [`The scoop that asked, ${scoop.name}, has ended, so this goes to its cone.`];\n}\n\
|
|
5
|
-
"mappings": "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
|
|
4
|
+
"sourcesContent": ["import { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { Harness } from '@earendil-works/pi-durable';\nimport { type AgentsState, live } from '../agents.ts';\nimport { taggedTaints } from '../guests/tags.ts';\nimport type { LickEvent } from '../licks/licks.ts';\nimport { redactSecrets } from '../memory/format.ts';\nimport type { SudoApproval, SudoRun } from './record.ts';\nimport { agentTarget } from './runnable.ts';\nimport { shellWord } from './sudo.ts';\n\nexport const KEEP_HOURS = 24;\nexport const MIB = 1024 * 1024;\n\nexport type LickHost = {\n harness: Pick<Harness, 'commit' | 'snapshot'>;\n agents: { state(): Readonly<AgentsState> };\n now?: () => number;\n};\n\nconst redacted = (text: string) => redactSecrets(text).text;\n\nexport const sized = (bytes: number): string =>\n bytes % MIB === 0 ? `${bytes / MIB} MiB` : `${Math.round(bytes / 1024)} KiB`;\n\nfunction typed(item: SudoApproval): string {\n return (item.replay?.argv ?? [])\n .map((word) => shellWord(String(word)))\n .join(' ')\n .trim();\n}\n\nfunction where(item: SudoApproval): string {\n const { command, target, cwd } = item.detail;\n return `${command} as ${target ?? 'root'}${cwd ? ` in ${cwd}` : ''}`;\n}\n\nconst pad = (value: number) => String(value).padStart(2, '0');\n\nexport function clock(at: number, now: number): string {\n const when = new Date(at);\n const time = `${pad(when.getHours())}:${pad(when.getMinutes())}`;\n if (when.toDateString() === new Date(now).toDateString()) return time;\n return `${when.getFullYear()}-${pad(when.getMonth() + 1)}-${pad(when.getDate())} ${time}`;\n}\n\nexport function duration(ms: number): string {\n const seconds = Math.max(0, Math.round(ms / 1000));\n if (seconds < 60) return `${seconds} s`;\n const minutes = Math.floor(seconds / 60);\n if (minutes < 60) return `${minutes} min ${seconds % 60} s`;\n return `${Math.floor(minutes / 60)} h ${minutes % 60} min`;\n}\n\nfunction outcome(run: SudoRun): { text: string; sentence: string; ok: boolean } {\n if (run.state === 'failed')\n return { text: run.error ?? 'failed', sentence: `didn't finish: ${run.error}`, ok: false };\n const signal = run.signal ? ` (${run.signal})` : '';\n if (run.capped)\n return {\n text: `stopped: its output passed ${sized(run.capped)}`,\n sentence: `was stopped because its output passed ${sized(run.capped)}${signal}`,\n ok: false,\n };\n if (run.state === 'stopped')\n return {\n text: 'stopped by the owner',\n sentence: `was stopped by the owner${signal}`,\n ok: false,\n };\n if (run.status === undefined)\n return {\n text: 'status unknown',\n sentence: 'ended while the agent was away, so its exit status is unknown',\n ok: false,\n };\n if (run.signal)\n return {\n text: `killed by ${run.signal}`,\n sentence: `was killed by ${run.signal} (status ${run.status})`,\n ok: false,\n };\n return {\n text: `exit ${run.status}`,\n sentence: `exited with status ${run.status}`,\n ok: run.status === 0,\n };\n}\n\nfunction handedOn(state: Readonly<AgentsState>, agentId: string): string[] {\n const scoop = agentId.startsWith('scoop:') ? state.scoops[agentId] : undefined;\n if (!scoop || live(scoop) || scoop.frozen) return [];\n return [`The scoop that asked, ${scoop.name}, has ended, so this goes to its cone.`];\n}\n\nexport type RunFacts = {\n id: string;\n agentId: string;\n typed: string;\n where: string;\n requestedAt: number;\n run: SudoRun;\n tags: readonly string[];\n started: string;\n ended: string;\n};\n\nexport function itemFacts(item: SudoApproval): RunFacts {\n const run = item.run as SudoRun;\n const replay = item.replay;\n return {\n id: item.id,\n agentId: item.requester.agentId as string,\n typed: typed(item),\n where: where(item),\n requestedAt: item.createdAt,\n run,\n tags: [...(replay?.tag ? [replay.tag] : []), ...(replay?.tags ?? [])],\n started: ` Output: ${run.stdout} (.err)`,\n ended: ` Read it with your shell if you need it: ${run.stdout} and ${run.stderr} (kept for ${KEEP_HOURS} h).`,\n };\n}\n\nasync function lickBase(host: LickHost, facts: RunFacts) {\n const taints = await taggedTaints(host.harness, facts.tags, BACKGROUND_CONTEXT);\n return {\n channel: 'sudo-run' as const,\n source: facts.id,\n target: agentTarget(host.agents.state(), facts.agentId),\n coalesce: false,\n ...(taints.length ? { taints } : {}),\n };\n}\n\nfunction clean(event: LickEvent): LickEvent {\n return {\n ...event,\n title: redacted(event.title),\n text: redacted(event.text),\n body: redacted(event.body as string),\n };\n}\n\nconst factsOf = (from: SudoApproval | RunFacts): RunFacts =>\n 'kind' in from ? itemFacts(from) : from;\n\nexport async function startLick(host: LickHost, from: SudoApproval | RunFacts): Promise<LickEvent> {\n const facts = factsOf(from);\n const { run } = facts;\n const now = host.now?.() ?? Date.now();\n const pid = run.pid !== undefined ? ` (pid ${run.pid})` : '';\n return clean({\n ...(await lickBase(host, facts)),\n eventId: `${facts.id}:start`,\n title: `sudo runs now: ${facts.typed}`,\n text: '[the owner ran your timed-out sudo request]',\n body: [\n `Your sudo request from ${clock(facts.requestedAt, now)} (${facts.where}) timed out.`,\n `The owner ran it at ${clock(run.at, now)} with Run now. It runs in the background${pid}, with no terminal and no input.`,\n `Its result follows as another sudo-run lick.${facts.started}`,\n ...handedOn(host.agents.state(), facts.agentId),\n ].join('\\n'),\n });\n}\n\nexport async function endLick(host: LickHost, from: SudoApproval | RunFacts): Promise<LickEvent> {\n const facts = factsOf(from);\n const { run } = facts;\n const ran = outcome(run);\n const took = run.endedAt !== undefined ? ` after ${duration(run.endedAt - run.at)}` : '';\n const left = run.survivors?.length\n ? [\n `Still running: pid ${run.survivors.join(', ')}. They left its process group; the owner can end them with Stop in Approvals.`,\n ]\n : [];\n return clean({\n ...(await lickBase(host, facts)),\n eventId: `${facts.id}:end`,\n title: `sudo run ended: ${facts.typed}`,\n text: `[your late sudo run ended: ${ran.text}]`,\n body: [\n `${facts.where} ${ran.sentence}${took}.`,\n ...left,\n `Its output isn't shown here.${facts.ended}`,\n ...handedOn(host.agents.state(), facts.agentId),\n ].join('\\n'),\n ...(ran.ok && !left.length ? {} : { severity: 'warn' as const }),\n });\n}\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
6
|
"names": []
|
|
7
7
|
}
|
|
@@ -0,0 +1,170 @@
|
|
|
1
|
+
import { BACKGROUND_CONTEXT } from "@earendil-works/chord/context";
|
|
2
|
+
import { LicksOutbox } from "../licks/licks.js";
|
|
3
|
+
import { endLick, startLick } from "./run-licks.js";
|
|
4
|
+
import { frozenOf, goneOf } from "./runnable.js";
|
|
5
|
+
const NOTICE_LIMITS = {
|
|
6
|
+
id: 128,
|
|
7
|
+
agentId: 256,
|
|
8
|
+
command: 1024,
|
|
9
|
+
path: 1024,
|
|
10
|
+
tag: 256,
|
|
11
|
+
tags: 16,
|
|
12
|
+
survivors: 64
|
|
13
|
+
};
|
|
14
|
+
const NOTICE_REASONS = {
|
|
15
|
+
shape: "A run notice is an object.",
|
|
16
|
+
id: "A run notice id is bios:<kernel id>.",
|
|
17
|
+
phase: "A run notice phase is start or end.",
|
|
18
|
+
agentId: "A run notice needs the agentId of the cone or scoop that asked.",
|
|
19
|
+
command: `A run notice needs its command, at most ${NOTICE_LIMITS.command} characters.`,
|
|
20
|
+
time: "A run notice needs requestedAt and at as times.",
|
|
21
|
+
endedAt: "endedAt is a time, no earlier than at.",
|
|
22
|
+
pid: "pid is a process id.",
|
|
23
|
+
status: "status is an exit status from 0 to 255.",
|
|
24
|
+
signal: "signal is a signal name such as SIGTERM.",
|
|
25
|
+
survivors: `survivors is a list of at most ${NOTICE_LIMITS.survivors} process ids.`,
|
|
26
|
+
stopped: "stopped is true or false.",
|
|
27
|
+
capped: "capped is a size in bytes.",
|
|
28
|
+
path: `stdout and stderr are absolute paths, at most ${NOTICE_LIMITS.path} characters.`,
|
|
29
|
+
tagsMissing: "A run notice needs tags, the kernel's tags for the run exactly (an empty list when it has none).",
|
|
30
|
+
tags: `tags is a list of at most ${NOTICE_LIMITS.tags} tags of at most ${NOTICE_LIMITS.tag} characters.`,
|
|
31
|
+
licks: "This agent has no licks.",
|
|
32
|
+
gone: "The agent that asked is gone, so nobody was told.",
|
|
33
|
+
seen: "This notice was already delivered.",
|
|
34
|
+
ended: "This run already ended.",
|
|
35
|
+
failed: "The notice couldn't be delivered."
|
|
36
|
+
};
|
|
37
|
+
const unknownKey = (key) => `A run notice has no ${key.slice(0, 64)} field.`;
|
|
38
|
+
const frozenNoticed = (name) => `${name} is frozen, so nobody was told.`;
|
|
39
|
+
const KEYS = /* @__PURE__ */ new Set([
|
|
40
|
+
"id",
|
|
41
|
+
"phase",
|
|
42
|
+
"agentId",
|
|
43
|
+
"command",
|
|
44
|
+
"requestedAt",
|
|
45
|
+
"at",
|
|
46
|
+
"pid",
|
|
47
|
+
"endedAt",
|
|
48
|
+
"status",
|
|
49
|
+
"signal",
|
|
50
|
+
"survivors",
|
|
51
|
+
"stopped",
|
|
52
|
+
"capped",
|
|
53
|
+
"stdout",
|
|
54
|
+
"stderr",
|
|
55
|
+
"tags"
|
|
56
|
+
]);
|
|
57
|
+
const ID = /^bios:[\w.:-]+$/;
|
|
58
|
+
const AGENT = /^[^\s\p{Cc}\p{Cf}\p{Zl}\p{Zp}]+$/u;
|
|
59
|
+
const PATH = /^\/[^\p{Cc}\p{Cf}\p{Zl}\p{Zp}]*$/u;
|
|
60
|
+
const TAG = /^[^\p{Cc}\p{Cf}\p{Zl}\p{Zp}]+$/u;
|
|
61
|
+
const SIGNAL = /^SIG[A-Z0-9+-]{1,12}$/;
|
|
62
|
+
const shown = (text2) => text2.replace(/[\p{Cc}\p{Cf}]/gu, " ").replace(/\s+/g, " ").trim();
|
|
63
|
+
const time = (value) => typeof value === "number" && Number.isFinite(value) && value >= 0;
|
|
64
|
+
const whole = (value, least) => typeof value === "number" && Number.isSafeInteger(value) && value >= least;
|
|
65
|
+
const text = (value, max) => typeof value === "string" && value.length > 0 && value.length <= max;
|
|
66
|
+
const list = (value, max, each) => Array.isArray(value) && value.length <= max && value.every(each);
|
|
67
|
+
const path = (value) => text(value, NOTICE_LIMITS.path) && PATH.test(value);
|
|
68
|
+
const CHECKS = [
|
|
69
|
+
["pid", (value) => whole(value, 1)],
|
|
70
|
+
["endedAt", (value, notice) => time(value) && value >= notice.at],
|
|
71
|
+
["status", (value) => whole(value, 0) && value <= 255],
|
|
72
|
+
["signal", (value) => typeof value === "string" && SIGNAL.test(value)],
|
|
73
|
+
["survivors", (value) => list(value, NOTICE_LIMITS.survivors, (one) => whole(one, 1))],
|
|
74
|
+
["stopped", (value) => typeof value === "boolean"],
|
|
75
|
+
["capped", (value) => whole(value, 1)],
|
|
76
|
+
["stdout", path],
|
|
77
|
+
["stderr", path],
|
|
78
|
+
[
|
|
79
|
+
"tags",
|
|
80
|
+
(value) => list(value, NOTICE_LIMITS.tags, (one) => text(one, NOTICE_LIMITS.tag) && TAG.test(one))
|
|
81
|
+
]
|
|
82
|
+
];
|
|
83
|
+
const REASON_OF = {
|
|
84
|
+
...NOTICE_REASONS,
|
|
85
|
+
stdout: NOTICE_REASONS.path,
|
|
86
|
+
stderr: NOTICE_REASONS.path
|
|
87
|
+
};
|
|
88
|
+
function optional(notice) {
|
|
89
|
+
const bad = CHECKS.find(
|
|
90
|
+
([key, check]) => notice[key] !== void 0 && !check(notice[key], notice)
|
|
91
|
+
);
|
|
92
|
+
return bad ? REASON_OF[bad[0]] : void 0;
|
|
93
|
+
}
|
|
94
|
+
function checkNotice(raw) {
|
|
95
|
+
if (!raw || typeof raw !== "object" || Array.isArray(raw)) return NOTICE_REASONS.shape;
|
|
96
|
+
const notice = raw;
|
|
97
|
+
const extra = Object.keys(notice).find((key) => !KEYS.has(key));
|
|
98
|
+
if (extra !== void 0) return unknownKey(extra);
|
|
99
|
+
const { id, phase, agentId, command } = notice;
|
|
100
|
+
if (!(text(id, NOTICE_LIMITS.id) && ID.test(id))) return NOTICE_REASONS.id;
|
|
101
|
+
if (phase !== "start" && phase !== "end") return NOTICE_REASONS.phase;
|
|
102
|
+
if (!(text(agentId, NOTICE_LIMITS.agentId) && AGENT.test(agentId))) return NOTICE_REASONS.agentId;
|
|
103
|
+
if (!(text(command, NOTICE_LIMITS.command) && shown(command))) return NOTICE_REASONS.command;
|
|
104
|
+
if (!time(notice.requestedAt) || !time(notice.at)) return NOTICE_REASONS.time;
|
|
105
|
+
if (!Array.isArray(notice.tags)) return NOTICE_REASONS.tagsMissing;
|
|
106
|
+
return optional(notice) ?? notice;
|
|
107
|
+
}
|
|
108
|
+
function factsOf(notice, agentId) {
|
|
109
|
+
const paths = [notice.stdout, notice.stderr].filter((path2) => !!path2);
|
|
110
|
+
const run = {
|
|
111
|
+
state: notice.stopped ? "stopped" : "done",
|
|
112
|
+
by: "owner",
|
|
113
|
+
at: notice.at,
|
|
114
|
+
...notice.pid !== void 0 ? { pid: notice.pid } : {},
|
|
115
|
+
...notice.endedAt !== void 0 ? { endedAt: notice.endedAt } : {},
|
|
116
|
+
...notice.status !== void 0 ? { status: notice.status } : {},
|
|
117
|
+
...notice.signal ? { signal: notice.signal } : {},
|
|
118
|
+
...notice.survivors?.length ? { survivors: notice.survivors } : {},
|
|
119
|
+
...notice.capped ? { capped: notice.capped } : {}
|
|
120
|
+
};
|
|
121
|
+
const command = shown(notice.command);
|
|
122
|
+
return {
|
|
123
|
+
id: notice.id,
|
|
124
|
+
agentId,
|
|
125
|
+
typed: command,
|
|
126
|
+
where: command,
|
|
127
|
+
requestedAt: notice.requestedAt,
|
|
128
|
+
run,
|
|
129
|
+
tags: notice.tags,
|
|
130
|
+
started: paths.length ? ` Output: ${paths.join(" and ")}` : "",
|
|
131
|
+
ended: paths.length ? ` Read it with your shell if you need it: ${paths.join(" and ")}.` : ""
|
|
132
|
+
};
|
|
133
|
+
}
|
|
134
|
+
async function seen(host, id, eventId, context) {
|
|
135
|
+
const events = (await host.harness.snapshot(LicksOutbox, context))?.events ?? {};
|
|
136
|
+
return (events[`sudo-run|${id}`] ?? []).includes(eventId);
|
|
137
|
+
}
|
|
138
|
+
async function deliverNotice(host, raw) {
|
|
139
|
+
const notice = checkNotice(raw);
|
|
140
|
+
if (typeof notice === "string") return { delivered: false, reason: notice };
|
|
141
|
+
const licks = host.licks;
|
|
142
|
+
if (!licks) return { delivered: false, reason: NOTICE_REASONS.licks };
|
|
143
|
+
const agentId = notice.agentId.startsWith("cone:") ? notice.agentId.slice("cone:".length) : notice.agentId;
|
|
144
|
+
const state = () => host.agents.state();
|
|
145
|
+
const frozen = frozenOf(state)(agentId);
|
|
146
|
+
if (frozen) return { delivered: false, reason: frozenNoticed(frozen) };
|
|
147
|
+
if (goneOf(state)(agentId)) return { delivered: false, reason: NOTICE_REASONS.gone };
|
|
148
|
+
const eventId = `${notice.id}:${notice.phase}`;
|
|
149
|
+
try {
|
|
150
|
+
if (notice.phase === "start" && await seen(host, notice.id, `${notice.id}:end`, BACKGROUND_CONTEXT))
|
|
151
|
+
return { delivered: false, reason: NOTICE_REASONS.ended };
|
|
152
|
+
if (await seen(host, notice.id, eventId, BACKGROUND_CONTEXT))
|
|
153
|
+
return { delivered: false, reason: NOTICE_REASONS.seen };
|
|
154
|
+
const facts = factsOf(notice, agentId);
|
|
155
|
+
const event = await (notice.phase === "start" ? startLick : endLick)(host, facts);
|
|
156
|
+
await licks.deliver(event, BACKGROUND_CONTEXT);
|
|
157
|
+
} catch {
|
|
158
|
+
return { delivered: false, reason: NOTICE_REASONS.failed };
|
|
159
|
+
}
|
|
160
|
+
return { delivered: true };
|
|
161
|
+
}
|
|
162
|
+
export {
|
|
163
|
+
NOTICE_LIMITS,
|
|
164
|
+
NOTICE_REASONS,
|
|
165
|
+
checkNotice,
|
|
166
|
+
deliverNotice,
|
|
167
|
+
frozenNoticed,
|
|
168
|
+
unknownKey
|
|
169
|
+
};
|
|
170
|
+
//# sourceMappingURL=run-notice.js.map
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 3,
|
|
3
|
+
"sources": ["../../src/approvals/run-notice.ts"],
|
|
4
|
+
"sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport { type Licks, LicksOutbox } from '../licks/licks.ts';\nimport type { SudoRun } from './record.ts';\nimport { endLick, type LickHost, type RunFacts, startLick } from './run-licks.ts';\nimport { frozenOf, goneOf } from './runnable.ts';\n\nexport type RunNotice = {\n id: string;\n phase: 'start' | 'end';\n agentId: string;\n command: string;\n requestedAt: number;\n at: number;\n pid?: number;\n endedAt?: number;\n status?: number;\n signal?: string;\n survivors?: number[];\n stopped?: boolean;\n capped?: number;\n stdout?: string;\n stderr?: string;\n tags: string[];\n};\n\nexport type NoticeAnswer = { delivered: boolean; reason?: string };\n\nexport type NoticeHost = LickHost & { licks?: Pick<Licks, 'deliver'> };\n\nexport const NOTICE_LIMITS = {\n id: 128,\n agentId: 256,\n command: 1024,\n path: 1024,\n tag: 256,\n tags: 16,\n survivors: 64,\n} as const;\n\nexport const NOTICE_REASONS = {\n shape: 'A run notice is an object.',\n id: 'A run notice id is bios:<kernel id>.',\n phase: 'A run notice phase is start or end.',\n agentId: 'A run notice needs the agentId of the cone or scoop that asked.',\n command: `A run notice needs its command, at most ${NOTICE_LIMITS.command} characters.`,\n time: 'A run notice needs requestedAt and at as times.',\n endedAt: 'endedAt is a time, no earlier than at.',\n pid: 'pid is a process id.',\n status: 'status is an exit status from 0 to 255.',\n signal: 'signal is a signal name such as SIGTERM.',\n survivors: `survivors is a list of at most ${NOTICE_LIMITS.survivors} process ids.`,\n stopped: 'stopped is true or false.',\n capped: 'capped is a size in bytes.',\n path: `stdout and stderr are absolute paths, at most ${NOTICE_LIMITS.path} characters.`,\n tagsMissing:\n \"A run notice needs tags, the kernel's tags for the run exactly (an empty list when it has none).\",\n tags: `tags is a list of at most ${NOTICE_LIMITS.tags} tags of at most ${NOTICE_LIMITS.tag} characters.`,\n licks: 'This agent has no licks.',\n gone: 'The agent that asked is gone, so nobody was told.',\n seen: 'This notice was already delivered.',\n ended: 'This run already ended.',\n failed: \"The notice couldn't be delivered.\",\n} as const;\n\nexport const unknownKey = (key: string): string => `A run notice has no ${key.slice(0, 64)} field.`;\n\nexport const frozenNoticed = (name: string): string => `${name} is frozen, so nobody was told.`;\n\nconst KEYS = new Set([\n 'id',\n 'phase',\n 'agentId',\n 'command',\n 'requestedAt',\n 'at',\n 'pid',\n 'endedAt',\n 'status',\n 'signal',\n 'survivors',\n 'stopped',\n 'capped',\n 'stdout',\n 'stderr',\n 'tags',\n]);\n\nconst ID = /^bios:[\\w.:-]+$/;\nconst AGENT = /^[^\\s\\p{Cc}\\p{Cf}\\p{Zl}\\p{Zp}]+$/u;\nconst PATH = /^\\/[^\\p{Cc}\\p{Cf}\\p{Zl}\\p{Zp}]*$/u;\nconst TAG = /^[^\\p{Cc}\\p{Cf}\\p{Zl}\\p{Zp}]+$/u;\nconst SIGNAL = /^SIG[A-Z0-9+-]{1,12}$/;\n\nconst shown = (text: string) =>\n text\n .replace(/[\\p{Cc}\\p{Cf}]/gu, ' ')\n .replace(/\\s+/g, ' ')\n .trim();\n\nconst time = (value: unknown): value is number =>\n typeof value === 'number' && Number.isFinite(value) && value >= 0;\n\nconst whole = (value: unknown, least: number): value is number =>\n typeof value === 'number' && Number.isSafeInteger(value) && value >= least;\n\nconst text = (value: unknown, max: number): value is string =>\n typeof value === 'string' && value.length > 0 && value.length <= max;\n\nconst list = (value: unknown, max: number, each: (one: unknown) => boolean) =>\n Array.isArray(value) && value.length <= max && value.every(each);\n\nconst path = (value: unknown) => text(value, NOTICE_LIMITS.path) && PATH.test(value as string);\n\nconst CHECKS: [keyof RunNotice, (value: unknown, notice: Record<string, unknown>) => boolean][] = [\n ['pid', (value) => whole(value, 1)],\n ['endedAt', (value, notice) => time(value) && value >= (notice.at as number)],\n ['status', (value) => whole(value, 0) && value <= 255],\n ['signal', (value) => typeof value === 'string' && SIGNAL.test(value)],\n ['survivors', (value) => list(value, NOTICE_LIMITS.survivors, (one) => whole(one, 1))],\n ['stopped', (value) => typeof value === 'boolean'],\n ['capped', (value) => whole(value, 1)],\n ['stdout', path],\n ['stderr', path],\n [\n 'tags',\n (value) =>\n list(value, NOTICE_LIMITS.tags, (one) => text(one, NOTICE_LIMITS.tag) && TAG.test(one)),\n ],\n];\n\nconst REASON_OF: Partial<Record<keyof RunNotice, string>> = {\n ...NOTICE_REASONS,\n stdout: NOTICE_REASONS.path,\n stderr: NOTICE_REASONS.path,\n};\n\nfunction optional(notice: Record<string, unknown>): string | undefined {\n const bad = CHECKS.find(\n ([key, check]) => notice[key] !== undefined && !check(notice[key], notice)\n );\n return bad ? REASON_OF[bad[0]] : undefined;\n}\n\nexport function checkNotice(raw: unknown): RunNotice | string {\n if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return NOTICE_REASONS.shape;\n const notice = raw as Record<string, unknown>;\n const extra = Object.keys(notice).find((key) => !KEYS.has(key));\n if (extra !== undefined) return unknownKey(extra);\n const { id, phase, agentId, command } = notice;\n if (!(text(id, NOTICE_LIMITS.id) && ID.test(id))) return NOTICE_REASONS.id;\n if (phase !== 'start' && phase !== 'end') return NOTICE_REASONS.phase;\n if (!(text(agentId, NOTICE_LIMITS.agentId) && AGENT.test(agentId))) return NOTICE_REASONS.agentId;\n if (!(text(command, NOTICE_LIMITS.command) && shown(command))) return NOTICE_REASONS.command;\n if (!time(notice.requestedAt) || !time(notice.at)) return NOTICE_REASONS.time;\n if (!Array.isArray(notice.tags)) return NOTICE_REASONS.tagsMissing;\n return optional(notice) ?? (notice as RunNotice);\n}\n\nfunction factsOf(notice: RunNotice, agentId: string): RunFacts {\n const paths = [notice.stdout, notice.stderr].filter((path): path is string => !!path);\n const run: SudoRun = {\n state: notice.stopped ? 'stopped' : 'done',\n by: 'owner',\n at: notice.at,\n ...(notice.pid !== undefined ? { pid: notice.pid } : {}),\n ...(notice.endedAt !== undefined ? { endedAt: notice.endedAt } : {}),\n ...(notice.status !== undefined ? { status: notice.status } : {}),\n ...(notice.signal ? { signal: notice.signal } : {}),\n ...(notice.survivors?.length ? { survivors: notice.survivors } : {}),\n ...(notice.capped ? { capped: notice.capped } : {}),\n };\n const command = shown(notice.command);\n return {\n id: notice.id,\n agentId,\n typed: command,\n where: command,\n requestedAt: notice.requestedAt,\n run,\n tags: notice.tags,\n started: paths.length ? ` Output: ${paths.join(' and ')}` : '',\n ended: paths.length ? ` Read it with your shell if you need it: ${paths.join(' and ')}.` : '',\n };\n}\n\nasync function seen(host: NoticeHost, id: string, eventId: string, context: Context) {\n const events = (await host.harness.snapshot(LicksOutbox, context))?.events ?? {};\n return (events[`sudo-run|${id}`] ?? []).includes(eventId);\n}\n\nexport async function deliverNotice(host: NoticeHost, raw: unknown): Promise<NoticeAnswer> {\n const notice = checkNotice(raw);\n if (typeof notice === 'string') return { delivered: false, reason: notice };\n const licks = host.licks;\n if (!licks) return { delivered: false, reason: NOTICE_REASONS.licks };\n const agentId = notice.agentId.startsWith('cone:')\n ? notice.agentId.slice('cone:'.length)\n : notice.agentId;\n const state = () => host.agents.state();\n const frozen = frozenOf(state)(agentId);\n if (frozen) return { delivered: false, reason: frozenNoticed(frozen) };\n if (goneOf(state)(agentId)) return { delivered: false, reason: NOTICE_REASONS.gone };\n const eventId = `${notice.id}:${notice.phase}`;\n try {\n if (\n notice.phase === 'start' &&\n (await seen(host, notice.id, `${notice.id}:end`, BACKGROUND_CONTEXT))\n )\n return { delivered: false, reason: NOTICE_REASONS.ended };\n if (await seen(host, notice.id, eventId, BACKGROUND_CONTEXT))\n return { delivered: false, reason: NOTICE_REASONS.seen };\n const facts = factsOf(notice, agentId);\n const event = await (notice.phase === 'start' ? startLick : endLick)(host, facts);\n await licks.deliver(event, BACKGROUND_CONTEXT);\n } catch {\n return { delivered: false, reason: NOTICE_REASONS.failed };\n }\n return { delivered: true };\n}\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
|
+
"names": ["text", "path"]
|
|
7
|
+
}
|
package/dist/client.js
CHANGED
|
@@ -200,6 +200,9 @@ async function connectAgent(endpoint, options = {}) {
|
|
|
200
200
|
context
|
|
201
201
|
);
|
|
202
202
|
},
|
|
203
|
+
approvalRunNotice(notice) {
|
|
204
|
+
return control.approvalRunNotice(notice, context);
|
|
205
|
+
},
|
|
203
206
|
async prompt(text, whenBusy = "followUp") {
|
|
204
207
|
const sent = await control.send({ text, whenBusy, requestId: null }, context);
|
|
205
208
|
if (!sent.accepted) throw new Error(`${sent.error.code}: ${sent.error.message}`);
|
package/dist/client.js.map
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../src/client.ts"],
|
|
4
|
-
"sourcesContent": ["import {\n type Context,\n createHost,\n type Host,\n isChordError,\n type Readable,\n type ReplicatedState,\n} from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { ConversationView } from '@earendil-works/pi-durable';\nimport type { ApprovalPolicy } from './approvals/policy.ts';\nimport type { Approval } from './approvals/record.ts';\nimport type { Runnable } from './approvals/runnable.ts';\nimport type { ChangesView } from './changes/git.ts';\nimport type { FrozenCone } from './freezer/index.ts';\nimport type { ImportProgress } from './freezer/v6.ts';\nimport type { GuestSeat } from './guests/seats.ts';\nimport type { MemoryEntry, MemoryScope } from './memory/format.ts';\nimport { controlAnswer, pageAnswer, remoteAnswer, settingsAnswer } from './readonly.ts';\nimport type { AgentRemote } from './remote/host.ts';\nimport type { AgentPages } from './remote/pages.ts';\nimport type { VaultState } from './secrets/vault.ts';\nimport {\n AgentControl,\n AgentInventoryService,\n AgentPagesService,\n AgentRemoteService,\n AgentSettings,\n type AgentsSummary,\n AgentTranscript,\n CONTROL_METHODS,\n type Command,\n type Delivered,\n type GuestProposal,\n type GuestShown,\n type InventoryState,\n type MonitorFeed,\n OWNER_SETTINGS_METHODS,\n PAGE_METHODS,\n type PrivateRevision,\n REMOTE_METHODS,\n type SendMode,\n type SettingsState,\n TRANSCRIPT_STATES,\n} from './services.ts';\nimport {\n type AgentPrincipal,\n bound,\n offers,\n type Remote,\n type Root,\n replicated,\n SELF,\n} from './serving.ts';\nimport type { Sprinkle } from './sprinkles/kind.ts';\nimport { otherVersion, type PortEndpoint, PortLink } from './wire.ts';\n\nexport interface AgentConnection {\n readonly serverId: string;\n readonly control: AgentControl;\n readonly transcript: ReplicatedState<ConversationView>;\n readonly deliveries: ReplicatedState<Record<string, Delivered>>;\n readonly agents?: ReplicatedState<AgentsSummary>;\n readonly views?: ReplicatedState<Record<string, ConversationView>>;\n readonly commands?: ReplicatedState<Command[]>;\n readonly privateRevision?: ReplicatedState<PrivateRevision>;\n readonly sprinkles?: ReplicatedState<Sprinkle[]>;\n readonly memories?: ReplicatedState<MemoryEntry[]>;\n readonly memoryScopes?: ReplicatedState<MemoryScope[]>;\n readonly frozen?: ReplicatedState<FrozenCone[]>;\n readonly importing?: ReplicatedState<ImportProgress>;\n readonly changes?: ReplicatedState<ChangesView>;\n readonly monitor?: ReplicatedState<MonitorFeed>;\n readonly vault?: ReplicatedState<VaultState>;\n readonly labels?: ReplicatedState<Record<string, string>>;\n readonly guests?: ReplicatedState<GuestSeat[]>;\n readonly viewOnly?: boolean;\n readonly guest?: GuestShown;\n readonly proposals?: ReplicatedState<GuestProposal[]>;\n readonly owner?: boolean;\n readonly approvals?: ReplicatedState<Approval[]>;\n readonly approvalPolicy?: ReplicatedState<ApprovalPolicy>;\n readonly approvalRunnable?: ReplicatedState<Record<string, Runnable>>;\n readonly settings: AgentSettings;\n readonly remote?: AgentRemote;\n readonly history?: boolean;\n readonly pages?: AgentPages;\n readonly inventory?: ReplicatedState<InventoryState>;\n readonly closed: Promise<Error | undefined>;\n readonly readOnly?: boolean;\n prompt(text: string, whenBusy?: SendMode): Promise<string>;\n webhook(\n name: string,\n delivery: { id?: string | null; headers?: Record<string, string>; body: string }\n ): Promise<{ delivered: boolean }>;\n close(): Promise<void>;\n}\n\nexport interface Lasting<T> {\n readonly state: ReplicatedState<T>;\n freeze(): void;\n}\n\nexport function lasting<T>(state: ReplicatedState<T>): Lasting<T> {\n let last: T | undefined;\n let frozen = false;\n const read = () => {\n if (frozen) return last;\n try {\n last = state.value;\n } catch {}\n return last;\n };\n return {\n state: {\n get value() {\n return read();\n },\n subscribe: (listener) => (frozen ? () => undefined : state.subscribe(listener)),\n },\n freeze() {\n read();\n frozen = true;\n },\n };\n}\n\nexport function lastingSettings(\n settings: AgentSettings,\n hold: <T>(state: ReplicatedState<T>) => ReplicatedState<T>\n): AgentSettings {\n return {\n state: hold(settings.state),\n connect: (providerId, secret, fields, context) =>\n settings.connect(providerId, secret, fields, context),\n disconnect: (providerId, context) => settings.disconnect(providerId, context),\n remove: (providerId, context) => settings.remove(providerId, context),\n serverUrl: (providerId, context) => settings.serverUrl(providerId, context),\n signIn: (providerId, context) => settings.signIn(providerId, context),\n dismissMoved: (context) => settings.dismissMoved(context),\n addServer: (name, entry, context) => settings.addServer(name, entry, context),\n removeServer: (id, context) => settings.removeServer(id, context),\n refusals: (context) => settings.refusals(context),\n };\n}\n\nconst VERSIONS = new Set(['upgrade_required', 'contract_mismatch']);\n\nexport const final = (error: unknown): unknown =>\n isChordError(error) && VERSIONS.has(error.code) ? otherVersion(error) : error;\n\nexport const ended = (link: PortLink): Promise<never> =>\n link.ended.then((reason) => {\n throw reason ?? new Error('the agent closed the link');\n });\n\ntype Contract = Parameters<Host<AgentPrincipal>['get']>[0];\n\nexport function clientHost(link: PortLink, name: string): Host<AgentPrincipal> {\n const host = createHost<AgentPrincipal>({\n name: `${name}:${crypto.randomUUID()}`,\n kind: 'client',\n self: SELF,\n });\n host.connect(link, { principal: SELF, onProtocolMismatch: () => link.mismatched() });\n return host;\n}\n\nexport async function holding(\n host: Host<AgentPrincipal>,\n link: PortLink,\n contracts: readonly Contract[]\n): Promise<Remote[]> {\n const stop = new AbortController();\n const getting = contracts.map(\n (contract) =>\n host.get(contract, {}, { signal: stop.signal }) as Promise<unknown> as Promise<Remote>\n );\n try {\n return await Promise.race([Promise.all(getting), ended(link)]);\n } catch (error) {\n stop.abort();\n for (const got of getting)\n void got.then(\n (ref) => ref.release(),\n () => undefined\n );\n link.close('handshake failed');\n void host.close().catch(() => undefined);\n throw error;\n }\n}\n\nexport async function optional(\n host: Host<AgentPrincipal>,\n link: PortLink,\n contract: Contract\n): Promise<Remote | undefined> {\n const got = host.get(contract, {}) as Promise<unknown> as Promise<Remote>;\n return Promise.race([got, ended(link)]).catch(() => {\n void got.then(\n (ref) => ref.release(),\n () => undefined\n );\n return undefined;\n });\n}\n\nexport async function connectAgent(\n endpoint: PortEndpoint,\n options: { context?: Context } = {}\n): Promise<AgentConnection> {\n const context = options.context ?? BACKGROUND_CONTEXT;\n const link = new PortLink(endpoint);\n const serverId = await link.hello;\n const host = clientHost(link, 'follower');\n const inventory = optional(host, link, AgentInventoryService);\n const handles = await holding(host, link, [\n AgentControl,\n AgentTranscript,\n AgentSettings,\n AgentRemoteService,\n AgentPagesService,\n ]).catch((error: unknown) => {\n void inventory.then((handle) => handle?.release());\n throw final(error);\n });\n const [controlHandle, transcriptHandle, settingsHandle, remoteHandle, pagesHandle] = handles as [\n Remote,\n Remote,\n Remote,\n Remote,\n Remote,\n ];\n const inventoryHandle = await inventory;\n const release = () => {\n for (const handle of handles) handle.release();\n inventoryHandle?.release();\n };\n const root: Root = (run, rootOptions) => host.root(run, rootOptions);\n const control = bound<AgentControl>(controlHandle, root, CONTROL_METHODS, controlAnswer);\n const members = Object.fromEntries(\n TRANSCRIPT_STATES.map((name) => [name, transcriptHandle[name] as Readable<unknown>])\n ) as Record<(typeof TRANSCRIPT_STATES)[number], Readable<unknown>>;\n const settingsState = settingsHandle.state as Readable<SettingsState>;\n const settings: AgentSettings = {\n ...bound<Omit<AgentSettings, 'state'>>(\n settingsHandle,\n root,\n OWNER_SETTINGS_METHODS,\n settingsAnswer\n ),\n state: replicated(settingsState),\n };\n const remote = bound<AgentRemote>(remoteHandle, root, REMOTE_METHODS, remoteAnswer);\n const pages = bound<AgentPages>(pagesHandle, root, PAGE_METHODS, pageAnswer);\n const state = <K extends keyof typeof members>(name: K) =>\n replicated(members[name] as Readable<never>);\n const held: Lasting<unknown>[] = [];\n const hold = <T>(state: ReplicatedState<T>): ReplicatedState<T> => {\n const kept = lasting(state);\n held.push(kept as Lasting<unknown>);\n return kept.state;\n };\n let open = true;\n const finish = () => {\n if (!open) return;\n open = false;\n for (const kept of held) kept.freeze();\n release();\n };\n const closed = link.ended.then((reason) => {\n finish();\n return reason;\n });\n return {\n serverId,\n readOnly: controlHandle.variant === 'view',\n control,\n transcript: hold<ConversationView>(state('state')),\n deliveries: hold<Record<string, Delivered>>(state('deliveries')),\n agents: hold<AgentsSummary>(state('agents')),\n views: hold<Record<string, ConversationView>>(state('views')),\n commands: hold<Command[]>(state('commands')),\n privateRevision: hold<PrivateRevision>(state('privateRevision')),\n sprinkles: hold<Sprinkle[]>(state('sprinkles')),\n memories: hold<MemoryEntry[]>(state('memories')),\n memoryScopes: hold<MemoryScope[]>(state('memoryScopes')),\n frozen: hold<FrozenCone[]>(state('frozen')),\n importing: hold<ImportProgress>(state('importing')),\n changes: hold<ChangesView>(state('changes')),\n monitor: hold<MonitorFeed>(state('monitor')),\n vault: hold<VaultState>(state('vault')),\n labels: hold<Record<string, string>>(state('labels')),\n guests: hold<GuestSeat[]>(state('guests')),\n viewOnly: controlHandle.variant === 'view',\n owner: pagesHandle.variant === 'pages',\n approvals: hold<Approval[]>(state('approvals')),\n approvalPolicy: hold<ApprovalPolicy>(state('approvalPolicy')),\n approvalRunnable: hold<Record<string, Runnable>>(state('approvalRunnable')),\n settings: lastingSettings(settings, hold),\n remote,\n history: offers(controlHandle, 'entries'),\n pages,\n ...(inventoryHandle?.variant === 'owner'\n ? { inventory: hold(replicated(inventoryHandle.inventory as Readable<InventoryState>)) }\n : {}),\n closed,\n webhook(name, delivery) {\n return control.webhook(\n name,\n { id: delivery.id ?? null, headers: delivery.headers ?? {}, body: delivery.body },\n context\n );\n },\n async prompt(text, whenBusy = 'followUp') {\n const sent = await control.send({ text, whenBusy, requestId: null }, context);\n if (!sent.accepted) throw new Error(`${sent.error.code}: ${sent.error.message}`);\n const settled = await control.wait(sent.submissionId, context);\n if (settled.status !== 'done') throw new Error(`unanswered: ${settled.reason}`);\n return settled.text;\n },\n async close() {\n finish();\n link.close('closed');\n await closed;\n await host.close();\n },\n };\n}\n"],
|
|
5
|
-
"mappings": "AAAA;AAAA,EAEE;AAAA,EAEA;AAAA,OAGK;AACP,SAAS,0BAA0B;
|
|
4
|
+
"sourcesContent": ["import {\n type Context,\n createHost,\n type Host,\n isChordError,\n type Readable,\n type ReplicatedState,\n} from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport type { ConversationView } from '@earendil-works/pi-durable';\nimport type { ApprovalPolicy } from './approvals/policy.ts';\nimport type { Approval } from './approvals/record.ts';\nimport type { NoticeAnswer, RunNotice } from './approvals/run-notice.ts';\nimport type { Runnable } from './approvals/runnable.ts';\nimport type { ChangesView } from './changes/git.ts';\nimport type { FrozenCone } from './freezer/index.ts';\nimport type { ImportProgress } from './freezer/v6.ts';\nimport type { GuestSeat } from './guests/seats.ts';\nimport type { MemoryEntry, MemoryScope } from './memory/format.ts';\nimport { controlAnswer, pageAnswer, remoteAnswer, settingsAnswer } from './readonly.ts';\nimport type { AgentRemote } from './remote/host.ts';\nimport type { AgentPages } from './remote/pages.ts';\nimport type { VaultState } from './secrets/vault.ts';\nimport {\n AgentControl,\n AgentInventoryService,\n AgentPagesService,\n AgentRemoteService,\n AgentSettings,\n type AgentsSummary,\n AgentTranscript,\n CONTROL_METHODS,\n type Command,\n type Delivered,\n type GuestProposal,\n type GuestShown,\n type InventoryState,\n type MonitorFeed,\n OWNER_SETTINGS_METHODS,\n PAGE_METHODS,\n type PrivateRevision,\n REMOTE_METHODS,\n type SendMode,\n type SettingsState,\n TRANSCRIPT_STATES,\n} from './services.ts';\nimport {\n type AgentPrincipal,\n bound,\n offers,\n type Remote,\n type Root,\n replicated,\n SELF,\n} from './serving.ts';\nimport type { Sprinkle } from './sprinkles/kind.ts';\nimport { otherVersion, type PortEndpoint, PortLink } from './wire.ts';\n\nexport interface AgentConnection {\n readonly serverId: string;\n readonly control: AgentControl;\n readonly transcript: ReplicatedState<ConversationView>;\n readonly deliveries: ReplicatedState<Record<string, Delivered>>;\n readonly agents?: ReplicatedState<AgentsSummary>;\n readonly views?: ReplicatedState<Record<string, ConversationView>>;\n readonly commands?: ReplicatedState<Command[]>;\n readonly privateRevision?: ReplicatedState<PrivateRevision>;\n readonly sprinkles?: ReplicatedState<Sprinkle[]>;\n readonly memories?: ReplicatedState<MemoryEntry[]>;\n readonly memoryScopes?: ReplicatedState<MemoryScope[]>;\n readonly frozen?: ReplicatedState<FrozenCone[]>;\n readonly importing?: ReplicatedState<ImportProgress>;\n readonly changes?: ReplicatedState<ChangesView>;\n readonly monitor?: ReplicatedState<MonitorFeed>;\n readonly vault?: ReplicatedState<VaultState>;\n readonly labels?: ReplicatedState<Record<string, string>>;\n readonly guests?: ReplicatedState<GuestSeat[]>;\n readonly viewOnly?: boolean;\n readonly guest?: GuestShown;\n readonly proposals?: ReplicatedState<GuestProposal[]>;\n readonly owner?: boolean;\n readonly approvals?: ReplicatedState<Approval[]>;\n readonly approvalPolicy?: ReplicatedState<ApprovalPolicy>;\n readonly approvalRunnable?: ReplicatedState<Record<string, Runnable>>;\n readonly settings: AgentSettings;\n readonly remote?: AgentRemote;\n readonly history?: boolean;\n readonly pages?: AgentPages;\n readonly inventory?: ReplicatedState<InventoryState>;\n readonly closed: Promise<Error | undefined>;\n readonly readOnly?: boolean;\n prompt(text: string, whenBusy?: SendMode): Promise<string>;\n webhook(\n name: string,\n delivery: { id?: string | null; headers?: Record<string, string>; body: string }\n ): Promise<{ delivered: boolean }>;\n approvalRunNotice(notice: RunNotice): Promise<NoticeAnswer>;\n close(): Promise<void>;\n}\n\nexport interface Lasting<T> {\n readonly state: ReplicatedState<T>;\n freeze(): void;\n}\n\nexport function lasting<T>(state: ReplicatedState<T>): Lasting<T> {\n let last: T | undefined;\n let frozen = false;\n const read = () => {\n if (frozen) return last;\n try {\n last = state.value;\n } catch {}\n return last;\n };\n return {\n state: {\n get value() {\n return read();\n },\n subscribe: (listener) => (frozen ? () => undefined : state.subscribe(listener)),\n },\n freeze() {\n read();\n frozen = true;\n },\n };\n}\n\nexport function lastingSettings(\n settings: AgentSettings,\n hold: <T>(state: ReplicatedState<T>) => ReplicatedState<T>\n): AgentSettings {\n return {\n state: hold(settings.state),\n connect: (providerId, secret, fields, context) =>\n settings.connect(providerId, secret, fields, context),\n disconnect: (providerId, context) => settings.disconnect(providerId, context),\n remove: (providerId, context) => settings.remove(providerId, context),\n serverUrl: (providerId, context) => settings.serverUrl(providerId, context),\n signIn: (providerId, context) => settings.signIn(providerId, context),\n dismissMoved: (context) => settings.dismissMoved(context),\n addServer: (name, entry, context) => settings.addServer(name, entry, context),\n removeServer: (id, context) => settings.removeServer(id, context),\n refusals: (context) => settings.refusals(context),\n };\n}\n\nconst VERSIONS = new Set(['upgrade_required', 'contract_mismatch']);\n\nexport const final = (error: unknown): unknown =>\n isChordError(error) && VERSIONS.has(error.code) ? otherVersion(error) : error;\n\nexport const ended = (link: PortLink): Promise<never> =>\n link.ended.then((reason) => {\n throw reason ?? new Error('the agent closed the link');\n });\n\ntype Contract = Parameters<Host<AgentPrincipal>['get']>[0];\n\nexport function clientHost(link: PortLink, name: string): Host<AgentPrincipal> {\n const host = createHost<AgentPrincipal>({\n name: `${name}:${crypto.randomUUID()}`,\n kind: 'client',\n self: SELF,\n });\n host.connect(link, { principal: SELF, onProtocolMismatch: () => link.mismatched() });\n return host;\n}\n\nexport async function holding(\n host: Host<AgentPrincipal>,\n link: PortLink,\n contracts: readonly Contract[]\n): Promise<Remote[]> {\n const stop = new AbortController();\n const getting = contracts.map(\n (contract) =>\n host.get(contract, {}, { signal: stop.signal }) as Promise<unknown> as Promise<Remote>\n );\n try {\n return await Promise.race([Promise.all(getting), ended(link)]);\n } catch (error) {\n stop.abort();\n for (const got of getting)\n void got.then(\n (ref) => ref.release(),\n () => undefined\n );\n link.close('handshake failed');\n void host.close().catch(() => undefined);\n throw error;\n }\n}\n\nexport async function optional(\n host: Host<AgentPrincipal>,\n link: PortLink,\n contract: Contract\n): Promise<Remote | undefined> {\n const got = host.get(contract, {}) as Promise<unknown> as Promise<Remote>;\n return Promise.race([got, ended(link)]).catch(() => {\n void got.then(\n (ref) => ref.release(),\n () => undefined\n );\n return undefined;\n });\n}\n\nexport async function connectAgent(\n endpoint: PortEndpoint,\n options: { context?: Context } = {}\n): Promise<AgentConnection> {\n const context = options.context ?? BACKGROUND_CONTEXT;\n const link = new PortLink(endpoint);\n const serverId = await link.hello;\n const host = clientHost(link, 'follower');\n const inventory = optional(host, link, AgentInventoryService);\n const handles = await holding(host, link, [\n AgentControl,\n AgentTranscript,\n AgentSettings,\n AgentRemoteService,\n AgentPagesService,\n ]).catch((error: unknown) => {\n void inventory.then((handle) => handle?.release());\n throw final(error);\n });\n const [controlHandle, transcriptHandle, settingsHandle, remoteHandle, pagesHandle] = handles as [\n Remote,\n Remote,\n Remote,\n Remote,\n Remote,\n ];\n const inventoryHandle = await inventory;\n const release = () => {\n for (const handle of handles) handle.release();\n inventoryHandle?.release();\n };\n const root: Root = (run, rootOptions) => host.root(run, rootOptions);\n const control = bound<AgentControl>(controlHandle, root, CONTROL_METHODS, controlAnswer);\n const members = Object.fromEntries(\n TRANSCRIPT_STATES.map((name) => [name, transcriptHandle[name] as Readable<unknown>])\n ) as Record<(typeof TRANSCRIPT_STATES)[number], Readable<unknown>>;\n const settingsState = settingsHandle.state as Readable<SettingsState>;\n const settings: AgentSettings = {\n ...bound<Omit<AgentSettings, 'state'>>(\n settingsHandle,\n root,\n OWNER_SETTINGS_METHODS,\n settingsAnswer\n ),\n state: replicated(settingsState),\n };\n const remote = bound<AgentRemote>(remoteHandle, root, REMOTE_METHODS, remoteAnswer);\n const pages = bound<AgentPages>(pagesHandle, root, PAGE_METHODS, pageAnswer);\n const state = <K extends keyof typeof members>(name: K) =>\n replicated(members[name] as Readable<never>);\n const held: Lasting<unknown>[] = [];\n const hold = <T>(state: ReplicatedState<T>): ReplicatedState<T> => {\n const kept = lasting(state);\n held.push(kept as Lasting<unknown>);\n return kept.state;\n };\n let open = true;\n const finish = () => {\n if (!open) return;\n open = false;\n for (const kept of held) kept.freeze();\n release();\n };\n const closed = link.ended.then((reason) => {\n finish();\n return reason;\n });\n return {\n serverId,\n readOnly: controlHandle.variant === 'view',\n control,\n transcript: hold<ConversationView>(state('state')),\n deliveries: hold<Record<string, Delivered>>(state('deliveries')),\n agents: hold<AgentsSummary>(state('agents')),\n views: hold<Record<string, ConversationView>>(state('views')),\n commands: hold<Command[]>(state('commands')),\n privateRevision: hold<PrivateRevision>(state('privateRevision')),\n sprinkles: hold<Sprinkle[]>(state('sprinkles')),\n memories: hold<MemoryEntry[]>(state('memories')),\n memoryScopes: hold<MemoryScope[]>(state('memoryScopes')),\n frozen: hold<FrozenCone[]>(state('frozen')),\n importing: hold<ImportProgress>(state('importing')),\n changes: hold<ChangesView>(state('changes')),\n monitor: hold<MonitorFeed>(state('monitor')),\n vault: hold<VaultState>(state('vault')),\n labels: hold<Record<string, string>>(state('labels')),\n guests: hold<GuestSeat[]>(state('guests')),\n viewOnly: controlHandle.variant === 'view',\n owner: pagesHandle.variant === 'pages',\n approvals: hold<Approval[]>(state('approvals')),\n approvalPolicy: hold<ApprovalPolicy>(state('approvalPolicy')),\n approvalRunnable: hold<Record<string, Runnable>>(state('approvalRunnable')),\n settings: lastingSettings(settings, hold),\n remote,\n history: offers(controlHandle, 'entries'),\n pages,\n ...(inventoryHandle?.variant === 'owner'\n ? { inventory: hold(replicated(inventoryHandle.inventory as Readable<InventoryState>)) }\n : {}),\n closed,\n webhook(name, delivery) {\n return control.webhook(\n name,\n { id: delivery.id ?? null, headers: delivery.headers ?? {}, body: delivery.body },\n context\n );\n },\n approvalRunNotice(notice) {\n return control.approvalRunNotice(notice, context);\n },\n async prompt(text, whenBusy = 'followUp') {\n const sent = await control.send({ text, whenBusy, requestId: null }, context);\n if (!sent.accepted) throw new Error(`${sent.error.code}: ${sent.error.message}`);\n const settled = await control.wait(sent.submissionId, context);\n if (settled.status !== 'done') throw new Error(`unanswered: ${settled.reason}`);\n return settled.text;\n },\n async close() {\n finish();\n link.close('closed');\n await closed;\n await host.close();\n },\n };\n}\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
6
|
"names": ["state"]
|
|
7
7
|
}
|