Skip to content

terminal.write.v1

Write to terminal

Writes bounded text to the terminal identified by invocation scope.

At a glance

Callable byagent, cli, plugin
Effectwrite — Changes state.
Confirmationpolicy — May require a live confirmation, decided by policy and the caller’s audience.
Idempotencynone
Leaves the machineyes
Provided bydev.tenon.core
Contract classsealed

Input

PropertyRequiredTypeConstraints
textyesstringlength 0–49152

Output

Takes no properties — send {}.

Errors it can return

These are this contract’s own failures, on top of the lifecycle errors every intent can settle with. See Errors.

  • dev.tenon.core.terminal-unavailable

Call it

From a plugin — declare it in intents.uses first:

js
const result = await tenon.intents.send("terminal.write.v1", {})
if (!result.ok) throw new Error(result.error.code)

From a shell:

sh
tenon-cli intent send terminal.write.v1 --input '{}'

Ask your own build for this same contract with tenon-cli intent describe terminal.write.v1.