{
  "id": "agent-host-transport:stdio-pty",
  "_kind": "AgentHostTransport",
  "_file": "compute/agent-host-transports/stdio-pty.yaml",
  "_cluster": "compute",
  "attributes": {
    "displayName": "stdio+pty",
    "kind": "stdio-pty",
    "description": "Stdio attached to a pseudo-terminal (PTY) instead of anonymous pipes.\n`isatty()` returns true; ANSI colour codes, prompt redraws, raw-mode\nkeystrokes, and full TUI rendering work. Required by interactive\nagents whose UX depends on terminal control sequences (Claude Code\ninteractive mode, Cursor agent CLI, most terminal-first agents).\n",
    "inboundMessageFormat": "Raw keystroke bytes via the master side of the PTY. The agent reads\nvia its slave-side stdin which behaves as a terminal — modes (raw vs\ncooked), local echo, and signal generation (Ctrl-C → SIGINT) are\ngoverned by termios.\n",
    "outboundMessageFormat": "Mixed text + ANSI escape sequences on stdout (and stderr). Hosts that\nneed to consume structured output alongside the TUI typically run a\nsecond sidecar pipe (e.g. Claude Code `--output-format stream-json`\nover a separate fd).\n",
    "signalForwarding": "Control characters delivered through the PTY are translated to signals\nby the kernel (Ctrl-C → SIGINT, Ctrl-Z → SIGTSTP, Ctrl-\\\\ → SIGQUIT).\nHosts can also send signals directly to the child PID.\n",
    "ptySemantics": "Full TTY semantics — termios attributes, window-size (TIOCGWINSZ /\nTIOCSWINSZ) propagation on resize, line discipline, control\ncharacters all behave as on a real terminal.\n"
  },
  "outgoingEdges": [
    {
      "from": "agent-host-transport:stdio-pty",
      "to": "agentVersion:claude:ge-0-0-0",
      "kind": "used_by"
    },
    {
      "from": "agent-host-transport:stdio-pty",
      "to": "agentVersion:cursor:ge-0-0-0",
      "kind": "used_by"
    }
  ],
  "incomingEdges": []
}