LibTmux.Send-TmuxText

Description#

Text is literal: key names, leading dashes, semicolons and tmux format markers remain text. Enter is sent only when requested. Newlines already present in Text are delivered regardless of the Enter switch; they can execute commands in the receiving shell or application. NUL characters are rejected before I/O.

An empty string is accepted, including with Enter to send just that key.

The endpoint and daemon generation come from the supplied native pane. WhatIf performs no acquisition or sending. Confirmation names the endpoint and pane without displaying the supplied text or keys. Successful sending confirms tmux accepted input; use an explicit application readiness signal before checking that a command has finished.

Notes

Failures use Tmux.TextSendFailed and retain the original core exception, its dispatch information and the failed pane. ErrorAction Continue permits later owners to be processed; ErrorAction Stop stops on the first failure. NUL content uses Tmux.InvalidInput before dispatch; PowerShell handles parameter binding errors. Cancellation stops pending work but cannot undo delivered input. Nothing is retried. If text was sent but the following Enter fails, the core reports unknown partial dispatch. Retrying the whole operation can duplicate effects.