pty_read
Read PTY session output incrementally, reduce token usage via control-character and repetition trimming, wait for command completion, and recover final assistant messages from completed agent turns.
Instructions
セッションの出力をトークン削減して読む（既定は前回読取位置からの増分）。削減: 制御文字除去 / 反復圧縮 / head+tail 折りたたみ＋復元ヒント＋メタ併記。agent_transcript:true は agent session の直近完了ターンの最終 assistant メッセージを公開されたharness記録から平文で返す。回答が空で終わったターンは誤りにせず、空のtextとanswer_empty:trueを返す。長い回答が screen tail で切れた時の回収用。
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"session_id": "<session_id>"
},
"name": "pty_read"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| raw | No | 削減せず生テキスト | |
| rtk | No | 直前コマンド別の自前 reducer(git/grep/pytest 等)で縮約 | |
| full | No | 増分でなく全文 | |
| wait | No | 完了まで待つ（dead / mark sentinel 自動検出 / until / 出力静止∧シェル復帰 / timeout） | |
| lines | No | 末尾 N 行のみ | |
| until | No | この文字列が出たら完了とみなす（既定はリテラル部分一致。`$ ` や `[..]` もそのまま探せる） | |
| remote | No | 別端末のAitermで実行する時のSSH接続情報。hostだけならssh_configの接続名として使う。Aitermは接続情報を保存・管理しない。passphraseは会話記録に残るため、ssh-agentかpassphrase_env（環境変数名）を推奨する。 | |
| screen | No | 描画済みスクリーン(TUI 向け) | |
| timeout | No | wait の最大待ち秒数 | |
| input_id | No | Claudeのpty_send dispatch receiptのinput_id。agent_transcript:true時だけ指定し、その入力の番の回答を読む。後の番が動いていても拒否しない。未完了はAITERM_TRANSCRIPT_INPUT_PENDING、後の番の結果で置換済みはAITERM_TRANSCRIPT_INPUT_REPLACED | |
| line_range | No | 全文からの行範囲 "A:B" | |
| session_id | Yes | ||
| until_regex | No | until を正規表現として扱う（既定 false＝リテラル部分一致。メタ文字を使いたい時のみ true） | |
| operation_id | No | Claude operationの期待ID。agent_transcript:true時だけ指定し、古い別operationの結果を拒否する | |
| agent_transcript | No | agent session の直近完了ターンの最終 assistant メッセージを返す。Claudeはlaunch相関付きStop hook result、他harnessは通常transcript／session historyを使う。長い回答がscreen tailで切れた時の回収用 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| text | Yes | ||
| schema | Yes | ||
| vendor | Yes | ||
| harness | Yes | ||
| turn_id | Yes | ||
| raw_chars | Yes | ||
| session_id | Yes | ||
| answer_empty | No | agent_transcriptで、完了したturnの回答が空だった時だけtrue（textは空文字列）。回答を読めなかった時は誤りを返す。terminalではnull |