docs/generated/vocabulary.mdgenerated from code
Reference · 10 min read
op
Vocabulary: op.
Read as
Local API operations (discussion:owner/272): the JSON-RPC method names. The CLI spells checkpoint, approve, and revoke as lvcs checkpoint, lvcs approve, and agentflare revoke, and status as agentflare status, which also works with no daemon; other CLI commands (init, join, key, daemon, rpc, replay, audit, genesis, explain, hook, sandbox) are not operations. Also the op telemetry attribute.
| Value | Meaning |
|---|---|
hello | Name the peer this connection acts for; required first on every connection (discussion:owner/272). |
open | Load a document and return its address and kind. |
read | Return a document's rendered body, or the value at a pointer into its Loro structure. |
edit | Apply splices given against the caller's base heads (discussion:owner/434). |
move | Rename a file, keeping its history and blame (discussion:owner/434). CLI: lvcs mv. |
remove | Delete a file against the heads it was read at, as an edit of it is checked (discussion:owner/434). CLI: lvcs rm. |
subscribe | Receive pushed changes for an address or subtree. |
snapshot | Return main's visible frontier: its id and the map from document to heads. |
grant | Issue a capability grant signed by the calling peer: the owner, or a holder of a delegable grant (discussion:owner/146); the issuer's daemon renews one with a window, unattended, as a new grant with the same terms (discussion:owner/148). |
revoke | Revoke a grant and every unrevoked grant of its lineage, its renewals: a signed caps record each, after which no change at or past its time is within the grant (discussion:owner/148). |
file.purge | Purge deleted files' documents from the project, owner only: a signed, final caps record after which every honest node drops their content and never serves, syncs, or accepts it again (discussion:owner/614). CLI: agentflare purge. |
sync.deliver | Test builds only (e2e-forge, release-qual/16): take a sync payload for a document as if the named connected node had sent it on its sync stream, down the receiver's whole path (its held flag and intake, the node's share of the byte budget, the document's checks). The daemon's own user only, over its socket; any other build refuses it not_supported. |
add | Save a file of the tree as it is on disk, sending its refused save through intake again; with force, a secret_detected false positive is saved, each flagged string recorded in a signed allowlist entry with the reason given (discussion:owner/513). CLI: agentflare add. |
stop_gate | Whether the caller may stop now (discussion:owner/214 and discussion:owner/217), as the Stop hook asks: failed while an action_failed streak of its is open, pending while the change set holds no frontier with its newest change to each file, and passed otherwise. |
saves.latest | The caller's newest saves, each changed file with its newest heads, as the stop gate keeps them (discussion:owner/532): a plugin judges which of its frontiers holds them. |
notifications | List the caller's notifications, metadata only (who sent each, its kind, where, when, and its size, never what it says): its unread notifications, stale and refused saves and failed checks first, then write notifications, each newest first. Listing marks nothing read (discussion:owner/118 and discussion:owner/176). |
notifications.read | Read the content of the caller's notifications named by ids, and mark them read; an id it doesn't hold is listed as missing (discussion:owner/173 and discussion:owner/176). |
notifications.wait | Wait until a new notification of an attention kind (action_failed, refused_write, or the kinds named) arrives for the caller, then answer its metadata, never its text; with none by timeout_ms, answer no notification (discussion:owner/424). |
status | Where the caller stands, read-only: its tier, trees, live grants and whether each renews, grants ended lately, how many notifications wait unread, stale saves, the connected node count, and the last error the daemon answered it (discussion:owner/164). It shows the caller only its own. |
approve | Approve the named protected paths at a frontier every change channel attests: an approval in .lvcs/approvals by any holder of Approve (discussion:owner/123, discussion:owner/147, and discussion:owner/297). |
channel.read | Return a channel's value: its counted frontiers, each with its attestation and approval counts (discussion:owner/120). |
run | Run a gated action by hand (its manual trigger): a run request in its channel by a holder of Approve on it, whose run the channel's runners carry out, on the named frontier or, when none is named, the one its after channel holds; a rollback is a run on an earlier frontier the channel held. CLI: lvcs run <action> [<frontier-id>] (discussion:owner/141 and discussion:owner/204, the triggers row). |
init | Create a project at a root and host it (discussion:owner/272): the owner key, the project id, the capability file, and one document per file; a request to the per-user daemon on a connection whose hello names no root. |
join | Join an existing project from its nodes into a root and host it (discussion:owner/107 and discussion:owner/272); a request on a connection whose hello names no root. |
forget | Stop hosting a project and drop it from the registry, leaving its files alone (discussion:owner/272); a request on a connection whose hello names no root. |
project | Register an initialized project with the daemon, or change how it is hosted: its default peer and its transport, then open it again (discussion:owner/272); a request on a connection whose hello names no root. |
key.new | Create a peer key in the connection's project and return its peer id (discussion:owner/272). |
key.encryption | The connection's peer's X25519 encryption public key, which the keyring derives from that peer's signing key (discussion:owner/531, discussion:owner/514). |
key.open | Open an HPKE wrap sealed to the connection's peer's encryption key, inside the keyring; local socket only (discussion:owner/531, discussion:owner/514). |
key.endorse | The connection's peer's Ed25519 signature over a plugin's domain-separated message, so a plugin can publish what that peer itself vouches for; local socket only (discussion:owner/514). |
key.held | The peers whose signing keys this daemon holds for the project (discussion:owner/568); local socket only. |
key.handed | The calling plugin is ready for a replaced key to go (discussion:owner/768, o-edge/8); local socket only. |
key.handover_blocked | The calling plugin can't be ready for a replaced key to go on this node, why, and the next step (discussion:owner/768, o-edge/8); local socket only. |
grant.holders | The peers whose live grants hold a capability on an address, and the owner (discussion:owner/514). |
channel.list | List every action's channel and every [channels] combination of main's approved lvcs.toml: its trigger kind and its value's frontiers with their counts (discussion:owner/303). |
run.list | List the runs runners gossiped, newest first, optionally of one channel or one frontier (discussion:owner/303). |
checks.list | List every check on a peer's latest changes, one per action, as gh pr checks lists a PR's (discussion:owner/427). |
node.list | List the connected nodes: whether each is direct or relayed and the peers known to sign from it (discussion:owner/303). |
node.load | One connected node's recent load in this project: its daemon's latest resource samples and memory by part, asked of that node over the project's swarm (discussion:owner/400). |
presence.list | List the live presences: who is on which document ( discussion:owner/303). |
watch | Subscribe the connection to platform pushes: channel_moved, run, presence, activity (discussion:owner/303). |
project.summary | One summary per hosted project, read as its default peer: owner, peers present, channels, recent activity; on the host's connection (discussion:owner/303). |
inbox | Every hosted project's notifications for its default peer, metadata only; on the host's connection ( discussion:owner/303). |
blame | Who wrote each line of a file at given heads, from the document's history (discussion:owner/303). |
change.signers | The peer that signed each change id asked, from the documents' verified signatures; an id this node doesn't hold is left out (discussion:owner/685). |
main.versions | Main's newest saved versions, newest first: each one's frontier, time, signer, and the files it changed (discussion:owner/687). |
channel.history | The moves of a channel's value this daemon saw, newest first (discussion:owner/303). |
file.history | A file's saves, newest first: each change to its text, who made it, when, and the lines it touched (discussion:owner/399). |
search | The lines of main's text files holding a query, ignoring case, read from the main tree (discussion:owner/303). |
resources | The per-user daemon's own use over the last hour: CPU, memory, sandbox slots, and each project's storage; on the host's connection (discussion:owner/303). |
event.publish | Publish a signed event (discussion:owner/515): a durable one appended to its plugin ledger at .lvcs/x/<plugin>/..., admitted under write on it and the plugin's manifest rules; an ephemeral one by gossip. |
event.read | Read a plugin ledger's events, oldest first, of the kinds asked, the last limit when given (discussion:owner/515). |
event.list | The ledgers this daemon holds under a prefix, each with its heads (discussion:owner/515). |
event.subscribe | Deliver each event under a prefix, of the kinds asked, as event pushes (discussion:owner/515). |
event.unsubscribe | End an event.subscribe of the caller's connection ( discussion:owner/520). |
peer.resolve | Peers' ids from the names people type: an alias, an id, or an id's start, and the caller's own id (discussion:owner/514). |
plugin.install | Install a plugin from its manifest: its key, exactly the grants it declares, and its record in .lvcs/caps (discussion:owner/514). CLI: agentflare plugin install. |
plugin.list | The installed plugins, their commands and directories ( discussion:owner/514). CLI: agentflare plugin list. |
plugin.surfaces | The installed plugins and the UI surfaces they ship, for the app (discussion:owner/520). |
plugin.asset | One file a plugin's surfaces declare under its ui/ (discussion:owner/520). |
plugin.configure | Propose a plugin's settings from a device with write: its [plugins.<name>], a protected change (discussion:owner/521). |
plugin.config | A plugin's settings: their approved values, its manifest's defaults, and a change waiting for approval (discussion:owner/521). |
plugin.upgrade | Replace an installed plugin's manifest, grants, and record with a newer one's (discussion:owner/514). CLI: agentflare plugin upgrade. |
plugin.remove | Remove an installed plugin: revoke its grants and delete its record (discussion:owner/514). CLI: agentflare plugin remove. |
plugin.enable | Enable a plugin the node's store holds in this project: its key and exactly the grants its manifest declares (discussion:owner/768). CLI: agentflare plugin enable. |
plugin.disable | Disable a plugin in this project: revoke its grants and stop it, keeping its key and documents (discussion:owner/768). CLI: agentflare plugin disable. |
plugin.dormant | A plugin's serve, from its own process, ends itself idle: its keeper keeps it down until one of its wake filters matches an event, its wake time comes, or an install or upgrade starts it (discussion:owner/790). Not a CLI command. |
plugin.busy | A plugin's serve, from its own process, answers a plugin.rest push that it is busy and stays up (discussion:owner/790 item 3). Not a CLI command. |
plugin.admit | Room in the plugins' memory share for one plugin command, asked before the CLI runs it (discussion:owner/790 item 3); answered once there is room, or refused recover=wait. Not a CLI command. |
run.view | One channel's runs on one frontier: each runner's state, the action's steps, and this daemon's run's log tail ( discussion:owner/312). |
files.list | Main's files with presence counts (discussion:owner/312). |
frontier.read | A frontier's file documents and their heads: main's visible frontier, or one a channel holds, by id (discussion:owner/518). |
write | Save a whole file, text or bytes, from a base (discussion:owner/518). |
tree.materialize | Write a frontier's files matching some patterns into a directory under .lvcs/tmp/, local only (discussion:owner/518). |
doc.descends | Whether a document's heads descend from others, local only (discussion:owner/518). |
protected.read | Each protected path's approved heads and baseline, local only (discussion:owner/518: the actions plugin's saved-approval rule). |
auth.login | Start pairing a device (discussion:owner/300): a one-time link for the app and the scope the device will get. |
auth.wait | Wait for a device to claim a pairing; answered with its key and the code it shows (discussion:owner/300). |
auth.confirm | Accept or decline the device that claimed a pairing; accepting grants it its scope (discussion:owner/300). |
auth.pair | A device claims a pairing from its link (discussion:owner/300); answered once the pairing is confirmed or declined. |
auth.status | The peer's paired devices (discussion:owner/300). |
auth.logout | Revoke a paired device by its alias (discussion:owner/300). |
host.enable | Turn the host node on and keep it on (discussion:owner/300); a request on a connection whose hello names no root. |
host.disable | Turn the host node off and keep it off (discussion:owner/300); a request on a connection whose hello names no root. |
auth.sign | A write device's signature over what the daemon's push sign asked it to sign (discussion:owner/300). |
Cardinality: 85.