KetraTermHostEventSink
Host-facing events emitted while parser commands are mapped to core state.
Hosts receive metadata and decide whether host-side actions can be honored. Grid mutation and terminal modes remain owned by core; session coordinates transport changes and terminal-to-host byte responses.
Callbacks are synchronous and ordered on the mutation caller's thread. A TerminalSession holds its mutation lock during delivery. Return promptly; do not mutate the session or wait for a UI thread. Schedule UI work using the product's lifecycle. Direct sinks propagate exceptions to the caller; the PTY convenience bridge isolates and reports listener failures. No initial state replay or per-frame delivery is performed.
Functions
Called after a valid OSC 7 current-working-directory URI is accepted.
Called when the shell requests deminimizing (restoring) the window.
Called after a new OSC 8 registry entry is accepted. hyperlinkId is a positive session-local numeric identity; id is the optional application ID. Reusing an existing entry emits nothing. No browser action is implied.
Called after LRU eviction makes hyperlinkId unresolvable. Registration of its replacement follows this event. Numeric IDs are never reassigned. Closing OSC 8 or soft reset does not remove existing registry entries.
Called after hard reset clears a nonempty registry, instead of per-ID removals.
Called after the OSC icon title metadata changes.
Called when the shell requests lowering the window.
Called when the shell requests minimizing the window.
Called when the shell requests moving the window.
Called after the effective palette changes through OSC, host theme update, or hard reset. palette is the immutable core-owned value and may be retained. Queries, denied/invalid operations, and equal values do not emit an event.
Called when the shell requests raising the window.
Accepts an application-requested 80/132-column switch before core changes.
Called when the shell requests a window resize.
Called when the shell requests maximizing or restoring the window.
Called when an OSC 133 shell integration marker is received.
Called when the shell requests a desktop notification.
Called when an OSC 52 clipboard write request requires product-host user approval and has been decoded to text.
Called after an OSC 52 terminal clipboard request is evaluated by host policy.
Called when an OSC 52 clipboard write request has been allowed by host policy and decoded to text.
Called after the OSC window title metadata changes.