@labring/sealos-tty-client

Web Streams API client for sealos-tty-agent (Kubernetes exec terminal over WebSocket).

Install

pnpm add @labring/sealos-tty-client

Browser + xterm (recommended)

import { connectTerminalStreams } from '@labring/sealos-tty-client'

const { stdout, stdin, resize } = await connectTerminalStreams({
	client: { baseUrl: 'http://localhost:3000' },
	ticketRequest: { kubeconfig, namespace: 'default', pod: 'mypod', container: 'c1' },
	connect: { initialSize: { cols: term.cols, rows: term.rows } },
})

// stdin: xterm -> ws (binary)
const enc = new TextEncoder()
const writer = stdin.getWriter()
term.onData((d) => {
	void writer.write(enc.encode(d))
})
term.onResize(({ cols, rows }) => resize(cols, rows))

// stdout: ws -> xterm (binary -> text)
void stdout
	.pipeThrough(new TextDecoderStream())
	.pipeTo(new WritableStream({ write: s => term.write(s) }))

Notes

• The server starts exec only after the first resize.
• Use TextDecoderStream() (or TextDecoder(..., { stream: true })) for UTF-8 across frames.
• In Node/SSR, inject wsFactory (e.g. ws) and fetch if missing.