HostPolicy

data class HostPolicy(val titlePolicy: TerminalTitlePolicy = TerminalTitlePolicy(), val hyperlinkPolicy: HostControlPolicy = HostControlPolicy.ALLOW, val currentWorkingDirectoryPolicy: HostControlPolicy = HostControlPolicy.ALLOW, val notificationPolicy: HostControlPolicy = HostControlPolicy.ALLOW, val windowManipulationPolicy: HostControlPolicy = HostControlPolicy.ALLOW, val palettePolicy: HostControlPolicy = HostControlPolicy.ALLOW, val terminalResponsePolicy: HostControlPolicy = HostControlPolicy.ALLOW, val clipboardPolicy: TerminalClipboardPolicy = TerminalClipboardPolicy(), val maxHyperlinkEntries: Int = 4096, val maxHyperlinkUriLength: Int = 4096, val maxHyperlinkIdLength: Int = 256, val maxNotificationTitleLength: Int = 256, val maxNotificationBodyLength: Int = 1024, val maxCurrentWorkingDirectoryUriLength: Int = 4096)

Host-facing security policy for terminal controls that can affect host state, retain host metadata, or write terminal-generated bytes back to the remote process.

The parser only recognizes protocols. This policy is evaluated in the host adapter before commands touch core state, host callbacks, metadata registries, or terminal-to-host response queues.

Constructors

Link copied to clipboard
constructor(titlePolicy: TerminalTitlePolicy = TerminalTitlePolicy(), hyperlinkPolicy: HostControlPolicy = HostControlPolicy.ALLOW, currentWorkingDirectoryPolicy: HostControlPolicy = HostControlPolicy.ALLOW, notificationPolicy: HostControlPolicy = HostControlPolicy.ALLOW, windowManipulationPolicy: HostControlPolicy = HostControlPolicy.ALLOW, palettePolicy: HostControlPolicy = HostControlPolicy.ALLOW, terminalResponsePolicy: HostControlPolicy = HostControlPolicy.ALLOW, clipboardPolicy: TerminalClipboardPolicy = TerminalClipboardPolicy(), maxHyperlinkEntries: Int = 4096, maxHyperlinkUriLength: Int = 4096, maxHyperlinkIdLength: Int = 256, maxNotificationTitleLength: Int = 256, maxNotificationBodyLength: Int = 1024, maxCurrentWorkingDirectoryUriLength: Int = 4096)

Properties

Link copied to clipboard

deny-by-default permission and audit policy for terminal-triggered clipboard protocols such as OSC 52.

Link copied to clipboard

whether OSC 7 current-working-directory reports may be retained and forwarded to the host.

Link copied to clipboard

whether OSC 8 hyperlinks may be retained and attached to written cells.

Link copied to clipboard

maximum accepted OSC 7 file URI length in UTF-16 code units. Longer or malformed URIs are ignored.

Link copied to clipboard

maximum distinct OSC 8 hyperlink keys retained by the adapter before least-recently-used entries are evicted.

Link copied to clipboard

maximum accepted OSC 8 id= parameter length in UTF-16 code units. Longer IDs are ignored and mapped to no active hyperlink.

Link copied to clipboard

maximum accepted OSC 8 URI length in UTF-16 code units. Longer URIs are ignored and mapped to no active hyperlink.

Link copied to clipboard

maximum accepted character length for desktop notification bodies.

Link copied to clipboard

maximum accepted character length for desktop notification titles.

Link copied to clipboard

whether terminal-triggered desktop notification requests may be forwarded to the host.

Link copied to clipboard

whether OSC palette updates and palette query responses may affect core palette state or enqueue terminal-to-host bytes.

Link copied to clipboard

whether DA, DSR/CPR, window reports, DECRQSS, and XTGETTCAP requests may enqueue terminal-to-host response bytes.

Link copied to clipboard

origin-aware policy for OSC title updates and title-stack restore operations before adapter/core title metadata changes or host callbacks are emitted.

Link copied to clipboard

whether terminal-triggered window movement, resize, minimize, raise, lower, and maximize requests may be forwarded.