KetraTerm
API · DevelopmentAll versions

TerminalClipboardPolicy

data class TerminalClipboardPolicy(val writePermission: TerminalClipboardPermission = TerminalClipboardPermission.DENY, val readPermission: TerminalClipboardPermission = TerminalClipboardPermission.DENY, val maxDecodedBytes: Int = DEFAULT_MAX_DECODED_BYTES)

Permission policy for terminal-originated clipboard protocols such as OSC 52.

This policy describes what would be permitted by an embedding host. The host adapter never writes to a platform clipboard directly; it audits every request and emits decoded write payloads only when the configured policy permits the operation or requires a product-host write prompt. Valid read requests pass to session execution; the product supplies consent and platform clipboard access, while the session owns response ordering and lifetime.

Permissions apply to all output in the session, including nested SSH and multiplexer output. Process names and reported host metadata do not establish the source of a clipboard request.

Constructors

Link copied to clipboard
constructor(writePermission: TerminalClipboardPermission = TerminalClipboardPermission.DENY, readPermission: TerminalClipboardPermission = TerminalClipboardPermission.DENY, maxDecodedBytes: Int = DEFAULT_MAX_DECODED_BYTES)

Types

Link copied to clipboard
object Companion

Properties

Link copied to clipboard

maximum raw UTF-8 clipboard payload size for reads and writes. Session output storage also bounds the complete encoded reply.

Link copied to clipboard

policy for clipboard read/query requests. This defaults to deny because read responses can exfiltrate user clipboard data. Queries must also pass the selection allowlist and HostPolicy.terminalResponsePolicy.

Link copied to clipboard

write policy for the entire terminal session.