Reference

Events

Generated by scripts/gen-docs-reference from each module.json's watches and the emit calls in the module's source. Do not edit this page: edit the code, then run npm run docs:ref.

565 event types. A module may emit only what its manifest declares under watches.emits; anything else throws. Events land in vyred's event log, where watchers, surfaces and other modules read them. Fields are the payload keys the source passes to emit; "sometimes" marks keys only some emits carry.

See tools and events for how to listen.

agents

Event	Fields
`summon.finished`	`result`, `status`
`summon.queued`	`text`
`summon.started`	not found in the source (the type is built at run time)
`summon.thread`	`thread`

appearance

Event	Fields
`appearance.changed`	`scheme`, `theme`, `version`

appmods

Event	Fields
`appmods.domain-changed`	`host`, `on`; sometimes `app`
`appmods.installed`	`name`, `version`; sometimes `deployment`, `source`
`appmods.removed`	`name`; sometimes `deployment`, `source`
`appmods.restarted`	`name`, `why`
`appmods.started`	`name`
`appmods.stopped`	`name`; sometimes `deployment`, `source`
`documents.declined`	not found in the source (the type is built at run time)
`documents.form-completed`	not found in the source (the type is built at run time)
`documents.signed`	not found in the source (the type is built at run time)

Listens for: vault.item-changed

approvals

Event	Fields
`approvals.changed`	`count`

apps

Event	Fields
`apps.acted`	`action`, `app`
`apps.sent`	`action`, `app`

artifacts

Event	Fields
`artifact-links.changed`	`on`, `path`, `port`
`artifact.archived`	built in a variable before the emit; see the source
`artifact.created`	built in a variable before the emit; see the source
`artifact.deleted`	built in a variable before the emit; see the source
`artifact.moved`	built in a variable before the emit; see the source
`artifact.restored`	built in a variable before the emit; see the source
`artifact.shared`	built in a variable before the emit; see the source
`artifact.unshared`	built in a variable before the emit; see the source
`artifact.updated`	built in a variable before the emit; see the source
`thread.artifact`	built in a variable before the emit; see the source

Listens for: floor.wrote, thread.deleted

ask

Event	Fields
`ask.answered-many`	`id`, `thread`
`thread.questions`	`id`, `questions`, `state`, `title`; sometimes `answers`

assistant

Event	Fields
`assistant.access-narrowed`	`screens`, `tools`
`assistant.briefed`	`day`, `text`
`assistant.rolled`	`day`, `seeded`, `thread`
`push.proactive`	built in a variable before the emit; see the source

attachments

Event	Fields
`attachment.added`	`bytes`, `id`, `mime`, `name`, `thread`

brand

Event	Fields
`brand.changed`	`version`

bridges

Event	Fields
`bridge.revoked`	`at`, `bridge`, `by_space`, `destination`, `kind`, `source`
`kit.installed`	not found in the source (the type is built at run time)
`projection.accepted`	not found in the source (the type is built at run time)
`projection.delivered`	not found in the source (the type is built at run time)
`projection.proposed`	not found in the source (the type is built at run time)
`projection.revoked`	not found in the source (the type is built at run time)
`record.copied`	not found in the source (the type is built at run time)
`reference.accepted`	not found in the source (the type is built at run time)
`reference.proposed`	not found in the source (the type is built at run time)
`reference.resolved`	not found in the source (the type is built at run time)
`reference.revoked`	not found in the source (the type is built at run time)
`task.continued`	not found in the source (the type is built at run time)
`view.accepted`	not found in the source (the type is built at run time)
`view.proposed`	not found in the source (the type is built at run time)
`view.read`	not found in the source (the type is built at run time)
`view.revoked`	not found in the source (the type is built at run time)

capsule

Event	Fields
`capsule.hotkey`	`message`, `ok`
`capsule.requested`	`action`

chrome

Event	Fields
`chrome.acted`	`action`, `app`, `ok`, `summary`; sometimes `agent`, `call`, `thread`, `why`
`chrome.connected`	`browser`, `version`
`chrome.disconnected`	none
`chrome.finished`	`agent`, `ok`; sometimes `stopped`, `thread`
`chrome.interjected`	`agent`, `from`, `text`
`chrome.paused`	`agent`
`chrome.plan`	built in a variable before the emit; see the source
`chrome.replaced`	none
`chrome.resumed`	`agent`; sometimes `answer`
`chrome.signin-asked`	`app`, `kind`, `message`, `tab`
`chrome.signin-done`	`app`, `tab`
`chrome.site-learned`	`origin`, `rev`
`chrome.step`	`agent`, `id`, `state`, `status`; sometimes `thread`, `why`
`chrome.stopped`	`agent`, `by`
`chrome.voice`	`agent`, `final`, `text`; sometimes `run`
`chrome.waiting`	`agent`, `question`

chrome

Event	Fields
`chrome.acted`	`action`, `agent`, `app`, `ok`; sometimes `why`

comms

Event	Fields
`comms.held`	`count`, `id`, `via`
`comms.sent`	`id`, `sent`, `via`; sometimes `failed`, `provider`

computers

Event	Fields
`computer.checked-out`	`agent`, `screen`, `thread`
`computer.created`	`agent`
`computer.fill-began`	`agent`, `fill`, `origin`
`computer.fill-ended`	`agent`, `fill`, `why`; sometimes `target`
`computer.frozen`	`agent`
`computer.handed-back`	built in a variable before the emit; see the source
`computer.idle-warning`	`agent`, `at`, `surface`
`computer.joined`	`agent`, `node`, `stableId`
`computer.left`	`agent`
`computer.member-added`	`agent`, `computer`, `generation`
`computer.member-removed`	`agent`, `computer`
`computer.member-rotated`	`agent`, `computer`, `generation`
`computer.paused`	`agent`
`computer.released`	`agent`, `why`
`computer.resumed`	`agent`
`computer.shielded`	`agent`, `reason`
`computer.stopped`	`agent`; sometimes `died`
`computer.taken-over`	`agent`, `surface`, `thread`
`computer.thawed`	`agent`
`computer.unshielded`	`agent`, `reason`
`device.renamed`	`id`, `kind`, `name`

connectors

Event	Fields
`connectors.connect-failed`	not found in the source (the type is built at run time)
`connectors.connected`	not found in the source (the type is built at run time)
`connectors.connection-checked`	`id`, `light`
`connectors.connection-created`	`id`
`connectors.connection-deleted`	`id`
`connectors.connection-proposed`	`label`, `proposal`
`connectors.connection-received`	`bytes`, `delivery`, `id`
`connectors.connection-updated`	`id`
`connectors.disconnected`	not found in the source (the type is built at run time)
`connectors.scope-changed`	not found in the source (the type is built at run time)
`connectors.site-needs-browser`	`host`, `id`, `reason`, `rung`, `site`
`connectors.site-needs-signin`	`host`, `id`, `rung`, `site`; sometimes `agent`
`connectors.site-ran`	`class`, `id`, `op`, `rung`
`connectors.site-stopped`	`host`, `id`, `reason`, `site`

context

Event	Fields
`context.changed`	built in a variable before the emit; see the source

design

Event	Fields
`design.changed`	none; sometimes `css`, `removed`, `screen`, `version`
`design.css-disabled`	`reason`, `scope`
`design.proposed`	`by`, `id`; sometimes `css`, `screen`

documents

Event	Fields
`documents.copy-sent`	`days`
`documents.generated`	`format`, `path`, `record`, `template`, `template_version`
`documents.reminded`	`submission`
`documents.sent`	`submission`, `template_id`

files

Event	Fields
`drive.exposed`	`findings`, `unsafe`
`files.received`	`bytes`, `name`, `path`
`files.sent`	`bytes`, `name`, `to`

gate

Event	Fields
`gate.failed`	`error`, `id`, `via`
`gate.held`	none; sometimes `agent`, `description`, `id`, `input`, `kind`, `project`, `run`, `summary`, `thread`, `to`, `via`
`gate.rejected`	`by`, `id`, `kind`, `reason`, `via`
`gate.released`	`agent`, `by`, `edited`, `id`, `kind`, `project`, `thread`, `to`, `via`; sometimes `said`
`gate.revised`	`agent`, `by`, `id`, `project`, `thread`, `to`, `via`
`gate.settled`	`by`, `id`, `kind`, `outcome`, `via`

github

Event	Fields
`github.added`	`login`, `name`
`github.cleanup-needed`	`branch`, `commits`, `dirty`, `path`, `project`, `session`
`github.connect-failed`	`error`, `id`
`github.connected`	`id`, `login`, `name`
`github.local-init`	`branch`, `project`
`github.removed`	`name`
`github.repo-created`	`account`, `full_name`, `visibility`
`github.token-invalid`	`name`
`github.undone`	`project`, `session`, `undone`

glass

Event	Fields
`file.created`	`by`, `kind`, `path`, `size`, `target`
`file.moved`	`by`, `from`, `size`, `target`, `to`
`file.trashed`	`by`, `path`, `size`, `target`, `to`
`file.uploaded`	`by`, `path`, `size`, `target`
`glass.closed`	`seconds`, `session`, `surface`, `target`
`glass.opened`	`session`, `surface`, `target`
`glass.released`	`held_ms`, `surface`, `target`, `why`
`glass.taken`	`private`, `surface`, `target`

goals

Event	Fields
`goal.accepted`	`goal`
`goal.created`	`goal`
`goal.done`	`goal`
`goal.milestone`	`goal`, `index`, `text`
`goal.proposed`	`goal`

google

Event	Fields
`google.added`	`name`
`google.connect-failed`	`error`, `id`
`google.connected`	`email`, `id`, `name`
`google.drafted`	`account`
`google.removed`	`name`
`google.scheduled`	`account`, `op`
`google.sent`	`account`, `what`

hands

Event	Fields
`hands.acted`	`acted`, `app`, `kind`, `selector`, `verified`; sometimes `action`, `held`, `why`
`hands.paused`	none
`hands.resumed`	`app`; sometimes `by`
`hands.stopped`	`app`, `by`

hands-desktop

Event	Fields
`desktop.acted`	`action`, `agent`, `ok`, `summary`; sometimes `app`, `call`, `thread`, `why`

harness

Event	Fields
`file.touched`	`path`, `session`, `tool`
`thread.started`	`cwd`, `session`, `source`
`thread.stopped`	`reason`, `session`, `source`
`tool.held`	`decision`, `lesson`, `rule`, `session`, `tool`
`turn.completed`	`session`

hooks

Event	Fields
`hook.closed`	`route`
`hook.opened`	`route`, `scheme`
`hook.received`	`at`, `bytes`, `id`, `route`

import

Event	Fields
`import.progress`	built in a variable before the emit; see the source

learn

Event	Fields
`distill.finished`	`job`, `kind`, `lesson`, `ok`, `skill`
`lesson.allowed`	`allowed`, `asked`, `lesson`, `level`, `propose`
`lesson.broken`	`lesson`, `level`, `session`, `stage`
`lesson.caught`	`lesson`, `session`, `stage`; sometimes `attempt`, `tool`
`lesson.dormant`	`lesson`, `level`
`lesson.escalated`	`from`, `lesson`, `to`
`lesson.learned`	`checked`, `lesson`, `level`, `rule`
`lesson.proposed`	`checked`, `lesson`, `rule`
`lesson.retired`	`lesson`; sometimes `declined`, `replaced`
`lesson.tampered`	none
`skill.installed`	`scope`, `skill`
`skill.proposed`	`scope`, `sessions`, `skill`
`skill.retired`	`skill`

link

Event	Fields
`ask.answered`	not found in the source (the type is built at run time)
`ask.raised`	built in a variable before the emit; see the source
`companion.paired`	`approved`, `companion`, `device`, `fingerprint`, `nonce`
`companion.refused`	`device`, `reason`
`companion.removed`	`companion`, `device`, `why`
`companion.requested`	`device`, `fingerprint`, `name`, `reason`, `request`
`device.renamed`	`id`, `kind`, `name`
`lease.borrowed`	not found in the source (the type is built at run time)
`link.connected`	`box`
`link.lost`	`box`, `error`
`link.mac-online`	`name`, `peer`
`link.pair-requested`	`expires`, `id`, `kind`, `login`, `name`
`link.paired`	`peer`; sometimes `box`, `kind`, `login`, `name`
`link.signed-in`	`box`, `expires`
`link.signed-out`	none
`link.sleeping`	built in a variable before the emit; see the source
`link.unpaired`	none; sometimes `box`, `name`, `peer`
`link.woke`	built in a variable before the emit; see the source
`thread.contended`	built in a variable before the emit; see the source
`thread.finished`	built in a variable before the emit; see the source
`thread.limit`	not found in the source (the type is built at run time)
`thread.moved`	not found in the source (the type is built at run time)
`thread.queued`	built in a variable before the emit; see the source
`thread.sent`	built in a variable before the emit; see the source
`thread.stopped`	built in a variable before the emit; see the source
`thread.text`	built in a variable before the emit; see the source

mail

Event	Fields
`mail.held`	`account`, `id`, `via`
`mail.mapped`	`account`
`mail.needs-credential`	`account`, `item`
`mail.sent`	`account`

mcp

Event	Fields
`mcp.added`	`auth`, `name`, `transport`
`mcp.called`	`agent`, `ms`, `ok`, `server`, `tool`; sometimes `released`
`mcp.failed`	`error`, `name`
`mcp.held`	`agent`, `id`, `kind`, `server`, `tool`
`mcp.refreshed`	`name`, `tools`
`mcp.removed`	`name`
`mcp.started`	`ms`, `name`, `tools`, `transport`
`mcp.stopped`	`name`, `reason`
`mcp.updated`	`fields`, `name`

mcpconn

Event	Fields
`mcpconn.connected`	`id`, `name`, `where`
`mcpconn.did`	`conn`, `name`, `ok`, `says`, `tool`
`mcpconn.revoked`	`id`, `name`

memory

Event	Fields
`memory.answered`	`abstained`, `id`, `limited`
`memory.corrected`	`action`, `addresses`, `prior_confidence`, `prior_rule`, `prior_source`, `rel`, `scope`
`memory.curated`	`edges`, `ms`, `nodes`, `updated`
`memory.fixed`	`action`, `id`, `kind`, `source`
`memory.forgot`	`from`, `id`; sometimes `project`
`memory.graph-grew`	`edges`, `new`, `nodes`, `updated`
`memory.merged`	`id`, `scope`
`memory.profile-changed`	`facts`
`memory.remembered`	`facts`, `id`
`memory.sealed`	`kept`
`memory.site-learned`	`counts`, `key`
`memory.split`	none; sometimes `callers`, `effect`, `id`, `scope`
`memory.suggested`	`id`; sometimes `state`
`memory.thinking`	`id`, `stage`
`memory.unlock-asked`	`server`
`memory.updated`	`by`, `thread`; sometimes `correction`, `fix`
`memory.written`	`from`, `id`, `kind`, `project`; sometimes `restored`

microsoft

Event	Fields
`microsoft.added`	`name`
`microsoft.removed`	`name`

models

Event	Fields
`models.changed`	`added`, `count`
`models.evals-changed`	`model`, `state`
`models.new`	`id`, `model`, `provider`

names

Event	Fields
`name.claimed`	`name`
`name.moved`	`at`, `name`
`name.released`	`name`

onboard

Event	Fields
`onboard.claude-changed`	`signedIn`
`onboard.finished`	none
`onboard.stepped`	`state`, `step`

outside

Event	Fields
`outside.granted`	`id`, `kind`, `resource`; sometimes `write`
`outside.held`	`held`, `id`, `name`, `tool`
`outside.refused`	`reason`, `source`; sometimes `id`
`outside.registered`	`id`, `kind`, `name`
`outside.revoked`	`by`, `id`, `name`
`outside.used`	`id`, `name`, `outcome`, `resource`, `tool`

planner

Event	Fields
`planner.acked`	`action`, `by`, `due`, `firing`, `item`, `key`; sometimes `unrung`, `until`
`planner.added`	`item`, `kind`, `title`; sometimes `added_by`, `at`
`planner.changed`	`fields`, `item`, `kind`
`planner.escalated`	`after_ms`, `doer`, `task`, `title`, `to`
`planner.fired`	`actions`, `due`, `firing`, `item`, `key`, `kind`, `missed`, `ring`, `title`; sometimes `account`, `added_by`, `start`
`planner.removed`	`item`, `kind`
`planner.schedule`	`reason`
`planner.task-run`	`item`, `ok`, `result`; sometimes `thread`

pluginagent

Event	Fields
`pluginagent.asked`	`computer`, `id`
`pluginagent.declined`	none
`pluginagent.granted`	`agent`, `computer`
`pluginagent.revoked`	`agent`

presence

Event	Fields
`presence.enrolled`	`id`, `kind`, `name`
`presence.proved`	`caller`, `method`, `tool`; sometimes `strength`
`presence.refused`	none; sometimes `caller`, `device`, `method`, `tool`, `why`
`presence.removed`	`id`
`presence.session-replaced`	`device`, `ended`, `id`
`presence.signed-in`	`id`, `node`
`presence.signed-out`	none; sometimes `device`, `id`

previews

Event	Fields
`preview.opened`	`id`, `project`, `thread`, `title`
`preview.removed`	`id`, `project`, `thread`
`preview.state`	`id`, `project`, `state`, `thread`, `title`; sometimes `access`, `error`
`thread.operator`	`ask`, `computer`, `line`, `run`, `state`, `steps`, `title`
`thread.preview`	`access`, `id`, `mode`, `source`, `state`, `thumb`, `title`
`thread.signin`	`computer`, `id`, `site`, `state`, `why`

projects

Event	Fields
`project.changed`	`project`; sometimes `archived`, `fields`, `instructions`, `name`
`project.created`	`home`, `name`, `project`, `threads`
`thread.picked`	`project`, `thread`
`thread.unpicked`	`project`, `thread`

publish

Event	Fields
`deployment.approved`	not found in the source (the type is built at run time)
`deployment.built`	not found in the source (the type is built at run time)
`deployment.decided`	`deployment`, `outcome`, `space`, `task`
`deployment.held`	`deployment`, `space`, `task`
`deployment.job-ran`	`code`, `deployment`, `ok`, `seconds`, `space`
`deployment.previewed`	not found in the source (the type is built at run time)
`deployment.published`	not found in the source (the type is built at run time)
`deployment.restarted`	`deployment`, `space`, `why`
`deployment.retired`	not found in the source (the type is built at run time)
`deployment.rolled-back`	not found in the source (the type is built at run time)

push

Event	Fields
`push.capped`	`day`, `kind`, `tag`
`push.delivered`	`device`, `receipt`
`push.seen`	`standalone`, `surface`; sometimes `device`
`push.subscribed`	`device`, `label`, `service`

recall

Event	Fields
`recall.embedded`	`done`, `total`
`recall.scrubbed`	`classes`, `names`, `titles`, `turns`, `vectors`
`session.indexed`	`from`, `rewritten`, `session`, `to`
`session.state`	`busy`, `session`
`session.turn`	`session`; sometimes `replay`

relay

Event	Fields
`device.joined`	not found in the source (the type is built at run time)
`device.moved`	`id`, `path`; sometimes `rtt`
`device.paired`	`id`, `kind`, `name`, `via`; sometimes `build`, `fingerprint`, `gate`, `release`
`device.removed`	`id`, `why`
`device.renamed`	`id`, `kind`, `name`
`device.trust-asked`	`fingerprint`, `id`, `name`
`pairing-window.closed`	`reason`, `window`
`pairing-window.opened`	`window`
`pairing-window.renewed`	`window`
`pairing.abandoned`	`device`
`pairing.pending`	`device`, `fingerprint`, `gate`, `name`, `via`
`pairing.rejected`	`device`, `window`
`pairing.requested`	`device`, `fingerprint`, `name`, `window`
`relay.code-asked`	built in a variable before the emit; see the source
`relay.connected`	built in a variable before the emit; see the source
`relay.disconnected`	built in a variable before the emit; see the source
`relay.invite-redeemed`	`fingerprint`, `name`, `offer`, `pub`
`relay.paired`	`device`, `fingerprint`, `name`
`relay.signin-asked`	built in a variable before the emit; see the source
`relay.tunnel-connected`	built in a variable before the emit; see the source
`relay.tunnel-disconnected`	built in a variable before the emit; see the source
`setup.contested`	none
`setup.ended`	`why`
`setup.paired`	`device`
`tailnet.revoke-failed`	not found in the source (the type is built at run time)
`tailnet.tried`	not found in the source (the type is built at run time)

runner

Event	Fields
`runner.checkpoint`	not found in the source (the type is built at run time)
`runner.deleted`	not found in the source (the type is built at run time)
`runner.fenced`	not found in the source (the type is built at run time)
`runner.locked`	not found in the source (the type is built at run time)
`runner.moved`	not found in the source (the type is built at run time)
`runner.resumed`	`conflicts`, `files`, `lines`, `session`, `thread`, `turn`; sometimes `held`, `heldNames`, `line`
`runner.seal-failed`	not found in the source (the type is built at run time)
`runner.sealed`	not found in the source (the type is built at run time)
`runner.started`	not found in the source (the type is built at run time)
`runner.stopped`	not found in the source (the type is built at run time)

sessions

Event	Fields
`account.changed`	`account`, `provider`, `signed_in`, `why`
`mode.defaulted`	`mode`, `project`
`model.changed`	`model`, `scope`
`prompt.changed`	`by`, `mode`, `scope`, `version`
`slot.queued`	`key`, `kind`, `owner`, `position`, `project`, `waiting`
`slot.released`	`id`, `key`, `kind`, `owner`, `project`
`slot.taken`	`held`, `id`, `key`, `kind`, `owner`, `project`
`usage.paused`	built in a variable before the emit; see the source
`usage.resumed`	`auth`, `by`

settings

Event	Fields
`settings.changed`	`apply`, `by`, `key`, `level`, `rev`; sometimes `change`, `project`, `session`
`settings.loosened`	`by`, `change`, `key`, `label`, `level`, `said`

Event	Fields
`sidebar.changed`	`scope`; sometimes `key`, `op`

sight

Event	Fields
`sight.stepped`	built in a variable before the emit; see the source

spaces

Event	Fields
`compute.member-accepted`	not found in the source (the type is built at run time)
`compute.member-declined`	not found in the source (the type is built at run time)
`compute.space-allowed`	not found in the source (the type is built at run time)
`compute.space-stopped`	not found in the source (the type is built at run time)
`identity.alias-added`	`at`, `domain`, `name`
`identity.code-replaced`	`at`, `name`, `seq`
`identity.created`	`at`, `id`, `name`
`identity.device-removed`	`at`, `eid`, `name`
`identity.entry-added`	`at`, `name`; sometimes `eid`, `kind`, `seq`
`identity.entry-removed`	`at`, `name`; sometimes `eid`, `kind`, `seq`
`identity.recovered`	`at`, `how`, `name`, `seq`
`identity.warning`	`at`, `code`, `name`, `why`
`invite.accepted`	not found in the source (the type is built at run time)
`invite.created`	not found in the source (the type is built at run time)
`invite.expired`	not found in the source (the type is built at run time)
`invite.revoked`	not found in the source (the type is built at run time)
`member.added`	not found in the source (the type is built at run time)
`member.expired`	not found in the source (the type is built at run time)
`member.extended`	not found in the source (the type is built at run time)
`member.removed`	not found in the source (the type is built at run time)
`member.role-changed`	not found in the source (the type is built at run time)
`ownership.transferred`	not found in the source (the type is built at run time)
`space.create-cancelled`	not found in the source (the type is built at run time)
`space.create-done`	not found in the source (the type is built at run time)
`space.create-step`	not found in the source (the type is built at run time)
`space.device-enrolment-set`	`device`, `spaces`
`space.device-lent`	`device`, `lent`, `space`
`space.device-removed`	`device`, `space`
`space.device-restored`	`device`, `space`
`space.pairing-state`	not found in the source (the type is built at run time)
`space.setup-moved`	`space`
`space.vps-created`	not found in the source (the type is built at run time)
`space.vps-destroyed`	not found in the source (the type is built at run time)
`space.warning`	`code`, `message`, `spaceId`

spend

Event	Fields
`spend.capped`	`action`, `cap`, `day`, `line`, `provider`, `spent`; sometimes `agent`, `purpose`, `thread`
`spend.raised`	`cap`, `provider`, `was`

suggest

Event	Fields
`suggest.ready`	none

sync

Event	Fields
`sync.deleted`	`bytes`, `files`, `machine`; sometimes `planHash`
`sync.progress`	`machine`, `path`; sometimes `bytes`, `done`, `quarantined`, `total`
`sync.revoked`	`machine`
`sync.sending`	`ok`, `path`; sometimes `error`, `quarantined`
`sync.sent`	`excluded`, `failed`, `of`, `quarantined`, `sent`, `skipped`

Listens for: link.unpaired

system

Event	Fields
`device.renamed`	`id`, `kind`, `name`
`system.started`	`pid`

team

Event	Fields
`summon.cancelled`	`project`, `request`, `teammate`
`summon.finished`	`project`, `reply_to`, `request`, `result`, `status`, `teammate`
`summon.queued`	`from_kind`, `priority`, `project`, `reply_to`, `request`, `role`, `teammate`, `text`
`summon.started`	`project`, `reply_to`, `request`, `teammate`
`summon.thread`	`project`, `reply_to`, `request`, `teammate`, `thread`
`team.role-changed`	`filler`, `project`, `role`
`teammate.charter-changed`	`agent`, `by`, `note`, `previous`, `project`, `version`
`teammate.created`	`agent`, `project`, `role`; sometimes `revived`
`teammate.default-changed`	`enabled`, `project`
`teammate.duty-changed`	`agent`, `change`, `id`, `project`
`teammate.retired`	`agent`, `project`, `reason`, `role`, `undone`

term

Event	Fields
`term.closed`	`reason`, `term`
`term.command`	`author`, `command`, `session`, `surface`, `term`, `via`
`term.opened`	`cwd`, `session`, `term`

threads

Event	Fields
`ask.answered`	`ask`, `by`, `decision`, `summary`, `tool`; sometimes `answers`, `device`, `scope`
`ask.raised`	`agent`, `ask`, `destination`, `holder`, `kind`, `reason`, `summary`, `thread_name`, `tool`, `tool_use_id`
`effort.switched`	`effort`, `live`
`lease.changed`	`holder`, `previous`; sometimes `took`
`mode.changed`	`label`, `mode`
`model.switched`	`live`, `model`; sometimes `reported`
`thinking.switched`	`on`
`thread.archived`	`agent`, `project`
`thread.chat`	`chat`, `cwd`, `session`
`thread.contended`	`holder`, `session`
`thread.continued`	`from_machine`, `from_thread`, `provider`, `source`, `thread`, `turns`
`thread.deleted`	`agent`, `project`, `thread`
`thread.edit-undone`	`path`, `restored`
`thread.finished`	`ok`, `via`
`thread.limit`	built in a variable before the emit; see the source
`thread.mentioned`	`mentions`, `uuid`
`thread.placing`	not found in the source (the type is built at run time)
`thread.plan`	built in a variable before the emit; see the source
`thread.provider`	`account`, `from`, `model`, `reason`, `to`; sometimes `once`, `text`
`thread.queued`	`queued`, `surface`, `text`, `uuid`; sometimes `author`, `edited`, `images`, `kind`, `queued_at`, `request`, `step`
`thread.remembered`	`file`, `scope`
`thread.renamed`	`name`
`thread.rewound`	`restore`, `uuid`; sometimes `at`, `files`
`thread.rolled`	`from`, `quiet`, `reason`, `seed_chars`, `seed_tail`, `thread`, `to`; sometimes `share`, `source`, `used`, `window`
`thread.sandbox`	`sandboxed`; sometimes `confined_by`, `folder`, `provider`, `reason`
`thread.sent`	`surface`, `text`; sometimes `author`, `images`, `kind`, `queued`, `queued_at`, `request`, `step`, `uuid`, `via`
`thread.shell`	`code`, `command`, `output`
`thread.started`	built in a variable before the emit; see the source
`thread.state`	`state`; sometimes `error`, `turn`
`thread.status`	`status`; sometimes `error`, `stopping`, `turn`
`thread.steered`	`step`, `uuid`; sometimes `queued_at`, `restored`, `text`
`thread.stopped`	`code`, `reason`
`thread.task`	built in a variable before the emit; see the source
`thread.text`	none; sometimes `before`, `block`, `delta`, `done`, `has`, `message`, `notice`, `text`, `thread`
`thread.thinking`	`block`, `delta`, `message`
`thread.tool`	`call`, `id`, `phase`, `status`
`thread.turn`	`text`, `turn`, `uuid`; sometimes `steered`
`thread.unarchived`	`agent`, `project`
`thread.unqueued`	`queued`, `reason`, `surface`, `uuid`
`thread.usage`	`cost_usd`, `tokens`, `total_cost_usd`; sometimes `context`
`thread.watched`	`by`, `note`, `notify`, `reason`, `watch`; sometimes `summary`
`turn.said`	`at`, `id`, `surface`, `text_hash`

tips

Event	Fields
`tips.updated`	`count`, `from`, `module`, `to`

undo

Event	Fields
`undo.done`	`id`
`undo.failed`	`id`
`undo.recorded`	`actor_kind`, `id`, `tool`

update

Event	Fields
`update.available`	`channel`, `current`, `version`
`update.requested`	`version`

vault

Event	Fields
`grant.requested`	none; sometimes `agent`, `item`, `module`, `name`, `origin`, `project`, `watcher`
`pass.accept-requested`	`id`
`pass.accepted`	`items`, `mode`, `owner`, `pass`
`pass.created`	`holder`, `items`, `mode`, `pass`
`pass.requested`	`holder`, `items`, `mode`, `pass`
`pass.revoked`	`holder`, `pass`, `rotate`
`person.offboarded`	`person`, `revoked`, `rotate`
`person.requested`	`id`
`vault.agent-carried`	`carried`, `rows`
`vault.agent-granted`	`agent`, `item`, `origin`
`vault.agent-revoked`	`agent`, `item`, `origin`
`vault.card-changed`	`fingerprint`, `name`, `was`
`vault.connected`	`item`, `module`, `need`, `provider`
`vault.connection-added`	`account`, `id`, `provider`, `source`
`vault.connection-changed`	`fields`, `id`
`vault.connection-removed`	`id`
`vault.copied`	`clearsAt`, `field`, `name`, `surface`
`vault.device-joined`	`fingerprint`, `name`, `role`
`vault.device-paired`	`device`, `name`
`vault.device-revoked`	`device`, `name`
`vault.emergency-added`	`items`, `person`, `wait_ms`
`vault.emergency-denied`	`person`
`vault.emergency-released`	`person`
`vault.emergency-removed`	`person`
`vault.emergency-requested`	`opens`, `person`
`vault.filled`	`name`; sometimes `agent`, `app`, `device`, `origin`, `surface`, `what`
`vault.granted`	none; sometimes `description`, `input`, `internal`, `module`, `name`, `project`, `run`, `watcher`
`vault.item-added`	`kind`, `name`
`vault.item-changed`	`kind`, `name`; sometimes `stale`
`vault.item-deleted`	`name`
`vault.key-rotated`	`kv`, `vault`
`vault.kit-printed`	`by`
`vault.lease-ended`	`ended`, `task`
`vault.lease-lent`	`agent`, `connections`, `kit`, `task`, `version`
`vault.linked`	`name`, `to`
`vault.locked`	none; sometimes `ended`, `sessions`, `surface`, `vault`, `why`
`vault.mcp-pass-ended`	`id`, `name`
`vault.mcp-pass-made`	`id`, `items`, `name`
`vault.mcp-refused`	`reason`, `source`; sometimes `pass`
`vault.member-added`	`member`, `role`, `vault`
`vault.member-removed`	`member`, `rotate`, `vault`
`vault.member-role`	`member`, `role`, `vault`
`vault.person-verified`	`fingerprint`, `name`
`vault.refused`	`action`, `name`, `who`, `why`
`vault.released`	`name`; sometimes `holder`, `module`, `pass`, `watcher`
`vault.restored`	`added`, `grants`, `identity`, `kept`, `mode`, `passes`
`vault.reveal-asked`	`item`, `name`, `pass`
`vault.revealed`	`field`, `name`, `surface`
`vault.revealed-to-pass`	`item`, `name`, `pass`
`vault.revoked`	`module`, `name`; sometimes `project`, `watcher`
`vault.scope-converted`	`agents`, `item`, `projects`; sometimes `note`
`vault.secretkey-changed`	`acct`, `why`
`vault.shared-created`	`vault`
`vault.shared-joined`	`role`, `vault`
`vault.ssh-approved`	`expires`, `host`, `name`
`vault.sync-conflicted`	`name`, `vault`
`vault.unlinked`	`name`, `to`
`vault.unlocked`	none; sometimes `sessions`, `surface`, `vault`
`vault.used`	`item`, `thread`, `via`

vitals

Event	Fields
`vitals.sample`	`at`, `battery`, `cpu`, `device`, `disk`, `gpu`, `netRx`, `netTx`, `ram`, `scope`
`vitals.trouble`	`device`, `metric`, `minutes`, `scope`, `value`

waiting

Event	Fields
`waiting.changed`	`by_kind`, `count`

watchers

Event	Fields
`watcher.created`	`name`, `project`, `schedule`
`watcher.deleted`	`name`
`watcher.failed`	`error`, `failures`, `name`, `paused`
`watcher.fired`	`items`, `name`, `seen`, `trigger`
`watcher.paused`	`name`, `why`
`watcher.resumed`	`name`
`watcher.schedule-moved`	`watchers`, `zone_before`, `zone_now`
`watcher.woke`	`items`, `name`, `thread`

wink

Event	Fields
`storage.paired`	built in a variable before the emit; see the source
`storage.removed`	`drain`, `final`
`storage.unreachable`	`reason`
`wink.code-ack`	not found in the source (the type is built at run time)
`wink.code-closed`	not found in the source (the type is built at run time)
`wink.code-done`	not found in the source (the type is built at run time)
`wink.code-opened`	not found in the source (the type is built at run time)
`wink.code-replaced`	not found in the source (the type is built at run time)
`wink.code-unavailable`	not found in the source (the type is built at run time)
`wink.code-wrong`	not found in the source (the type is built at run time)
`wink.confirmed`	`offer`
`wink.declined`	`offer`, `why`
`wink.device-needs-repair`	`device`
`wink.enrol-asked`	`device`
`wink.enrolled`	`device`, `ok`
`wink.expired`	`offer`
`wink.found`	`offer`; sometimes `flow`
`wink.joined`	`flow`; sometimes `device`, `grant`, `kind`, `offer`, `role`
`wink.network-changed`	`space`, `state`
`wink.offer-changed`	`device`, `offer`, `on`; sometimes `side`, `space`
`wink.offered`	`expires`, `flow`, `offer`, `via`; sometimes `role`
`wink.pair-answered`	`yes`; sometimes `kind`
`wink.pair-asked`	`choices`, `device`, `name`, `until`; sometimes `any`, `kind`, `signin`
`wink.pair-confirm`	`pairing`, `words`
`wink.pair-done`	`kind`, `pairing`; sometimes `device`, `target`
`wink.pair-failed`	`pairing`, `reason`
`wink.pair-waiting`	`kind`, `pairing`; sometimes `target`
`wink.relay-applied`	`device`; sometimes `url`
`wink.removed`	none; sometimes `device`, `grant`
`wink.server-adopted`	`owner`
`wink.server-paired`	`device`
`wink.server-release`	`device`, `state`; sometimes `message`
`wink.server-released`	none
`wink.server-reset`	`at`, `card`, `devices`
`wink.shared`	`device`, `grant`
`wink.signin-asked`	`until`

Listens for: device.paired, device.removed, name.claimed, relay.code-asked, relay.connected, relay.invite-redeemed, relay.signin-asked

Events

agents#

appearance#

appmods#

approvals#

apps#

artifacts#

ask#

assistant#

attachments#

brand#

bridges#

capsule#

chrome#

chrome#

comms#

computers#

connectors#

context#

design#

documents#

files#

gate#

github#

glass#

goals#

google#

hands#

hands-desktop#

harness#

hooks#

import#

learn#

link#

mail#

mcp#

mcpconn#

memory#

microsoft#

models#

names#

onboard#

outside#

planner#

pluginagent#

presence#

previews#

projects#

publish#

push#

recall#

relay#

runner#

sessions#

settings#

sidebar#

sight#

spaces#

spend#

suggest#

sync#

system#

team#

term#

threads#

tips#

undo#

update#

vault#

vitals#

waiting#

watchers#

wink#

agents

appearance

appmods

approvals

apps

artifacts

ask

assistant

attachments

brand

bridges

capsule

chrome

chrome

comms

computers

connectors

context

design

documents

files

gate

github

glass

goals

google

hands

hands-desktop

harness

hooks

import

learn

link

mail

mcp

mcpconn

memory

microsoft

models

names

onboard

outside

planner

pluginagent

presence

previews

projects

publish

push

recall

relay

runner

sessions

settings

sidebar

sight

spaces

spend

suggest

sync

system

team

term

threads

tips

undo

update

vault

vitals

waiting

watchers

wink