Function copyTextToClipboard

cli/src/utils/clipboard.ts:86–133

(
  text: string,
  {
    successMessage,
    errorMessage,
    durationMs,
    suppressGlobalMessage = false,
  }: CopyToClipboardOptions = {},
)

}

export async function copyTextToClipboard(
  text: string,
  {
    successMessage,
    errorMessage,
    durationMs,
    suppressGlobalMessage = false,
  }: CopyToClipboardOptions = {},
) {
  if (!text || text.trim().length === 0) {
    return
  }

  try {
    let copied: boolean
    if (isRemoteSession()) {
      // Remote/SSH: prefer renderer OSC 52 (through render pipeline),
      // then our manual OSC 52, then platform tools
      copied = tryCopyViaRenderer(text) || tryCopyViaOsc52(text) || tryCopyViaPlatformTool(text)
    } else {
      // Local: prefer platform tools (reliable with tmux),
      // then renderer OSC 52, then our manual OSC 52 as fallback
      copied = tryCopyViaPlatformTool(text) || tryCopyViaRenderer(text) || tryCopyViaOsc52(text)
    }

    if (!copied) {
      throw new Error('No clipboard method available')
    }

    if (!suppressGlobalMessage) {
      const message =
        successMessage !== undefined
          ? successMessage
          : getDefaultSuccessMessage(text)
      if (message) {
        showClipboardMessage(message, { durationMs })
      }
    }
  } catch (error) {
    logger.error(error, 'Failed to copy to clipboard')
    if (!suppressGlobalMessage) {
      showClipboardMessage(errorMessage ?? 'Failed to copy to clipboard', {
        durationMs,
      })
    }
    throw error
  }
}

export function clearClipboardMessage() {
  if (clearTimer) {