Интерактивный терминал

Псевдотерминал (PTY) нужен программам, которые ожидают интерактивную оболочку, размер терминала или двунаправленный ввод. Вывод поступает во время работы процесса.

При создании терминала задайте user в JavaScript/Python или PTYOptions.User в Go. В этом примере оболочка запускается от root. Если пользователь не задан, используется пользователь шаблона. При повторном подключении пользователь терминала сохраняется.

mjs

import { Sandbox } from "@abox-dev/sdk";

const sandbox = await Sandbox.create();
const output = [];

try {
  const terminal = await sandbox.pty.create({
    user: "root",
    cols: 80,
    rows: 24,
    onData: (data) => output.push(new TextDecoder().decode(data)),
  });

  await sandbox.pty.sendInput(
    terminal.pid,
    new TextEncoder().encode("whoami\nprintf 'hello from PTY\\n'\nexit\n"),
  );
  await terminal.wait();
  console.log(output.join(""));
} finally {
  await sandbox.kill();
}

from agentbox import PtySize, Sandbox


sandbox = Sandbox.create()
output = []

try:
    terminal = sandbox.pty.create(PtySize(rows=24, cols=80), user="root")
    sandbox.pty.send_stdin(terminal.pid, b"whoami\nprintf 'hello from PTY\\n'\nexit\n")
    terminal.wait(on_pty=output.append)
    print(b"".join(output).decode())
finally:
    sandbox.kill()

package main

import (
	"context"
	"fmt"
	"log"

	"github.com/abox-dev/sdk/packages/go-sdk"
)

func kill(sandbox *agentbox.Sandbox) {
	if _, err := sandbox.Kill(context.Background()); err != nil {
		log.Printf("cleanup sandbox: %v", err)
	}
}

func run() (err error) {
	ctx := context.Background()
	client, err := agentbox.NewClient()
	if err != nil {
		return err
	}
	sandbox, err := client.Sandboxes.Create(ctx, nil)
	if err != nil {
		return err
	}
	defer kill(sandbox)
	terminal, err := sandbox.PTY.Create(ctx, "bash", &agentbox.PTYOptions{
		User:  "root",
		Rows:  24,
		Cols:  80,
		OnPTY: func(output []byte) { fmt.Print(string(output)) },
	})
	if err != nil {
		return err
	}
	if err := sandbox.PTY.Input(ctx, terminal, []byte("whoami\nprintf 'hello from PTY\\n'\nexit\n")); err != nil {
		return err
	}
	_, err = terminal.Wait(ctx)
	if err != nil {
		return err
	}
	return nil
}

func main() {
	if err := run(); err != nil {
		log.Fatal(err)
	}
}

Ввод передаётся в виде байтов. Добавьте перевод строки, если нужно имитировать нажатие Enter. Интерактивная оболочка не завершается сама: перед ожиданием результата отправьте exit или остановите PTY.

PTY также можно изменить размер, отключить, подключить повторно и завершить. Эти операции и настройки времени ожидания описаны в справочнике SDK.

Интерактивный терминал ​

Интерактивный терминал