{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://github.com/Kuddev/nebula/docs/runtime-api-v1.schema.json",
  "title": "Nebula Runtime API v1 frames",
  "description": "JSON Lines request, response, and event frames for the authenticated local runtime control plane.",
  "type": "object",
  "properties": {
    "protocol": {
      "const": "nebula.runtime"
    },
    "version": {
      "const": 1
    }
  },
  "required": [
    "protocol",
    "version"
  ],
  "oneOf": [
    {
      "$ref": "#/$defs/request"
    },
    {
      "$ref": "#/$defs/response"
    },
    {
      "$ref": "#/$defs/event"
    }
  ],
  "$defs": {
    "request": {
      "type": "object",
      "required": [
        "protocol",
        "version",
        "id",
        "token",
        "method",
        "params"
      ],
      "properties": {
        "protocol": {
          "const": "nebula.runtime"
        },
        "version": {
          "const": 1
        },
        "id": {
          "type": "string",
          "minLength": 1
        },
        "token": {
          "type": "string",
          "minLength": 1
        },
        "method": {
          "enum": [
            "runtime.describe",
            "runtime.snapshot",
            "runtime.orchestrate",
            "events.subscribe",
            "agents.list",
            "agent.start",
            "agent.fork",
            "agent.get",
            "agent.delegate",
            "agent.prompt",
            "agent.paste",
            "agent.read",
            "agent.wait",
            "window.create",
            "window.close",
            "window.focus",
            "tab.new",
            "tab.close",
            "tab.rename",
            "tab.move",
            "pane.split",
            "pane.close",
            "pane.zoom",
            "pane.resize",
            "pane.prompt",
            "pane.paste",
            "pane.read",
            "pane.procs",
            "pane.send_key",
            "pane.run",
            "pane.exec",
            "pane.wait",
            "git.status",
            "git.diff",
            "git.history",
            "git.stage",
            "git.unstage",
            "git.commit",
            "git.fetch",
            "git.pull",
            "git.push",
            "tab.focus",
            "tab.open",
            "tab.read",
            "conversation.read",
            "conversation.send",
            "conversation.choose",
            "conversation.key"
          ]
        },
        "params": {
          "type": "object"
        }
      },
      "additionalProperties": false,
      "allOf": [
        {
          "if": {
            "properties": {
              "method": {
                "enum": [
                  "runtime.describe",
                  "runtime.snapshot",
                  "window.create"
                ]
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/empty_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "runtime.orchestrate"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/orchestrate_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "events.subscribe"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/subscribe_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "agents.list"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/window_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "agent.start"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/agent_start_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "agent.fork"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/agent_fork_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "agent.get"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/agent_target_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "agent.prompt"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/agent_prompt_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "agent.delegate"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/agent_delegate_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "agent.paste"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/agent_paste_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "agent.read"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/agent_read_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "agent.wait"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/agent_wait_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "window.focus"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/focus_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "window.close"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/window_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "tab.new"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/tab_new_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "tab.close"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "oneOf": [
                  {
                    "$ref": "#/$defs/tab_target_params"
                  },
                  {
                    "$ref": "#/$defs/tab_identity_params"
                  }
                ]
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "tab.rename"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/tab_rename_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "tab.move"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/tab_move_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "pane.split"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/split_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "pane.zoom"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/pane_zoom_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "pane.resize"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/pane_resize_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "pane.prompt"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/prompt_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "pane.paste"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/paste_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "pane.read"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/read_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "enum": [
                  "pane.close",
                  "pane.procs"
                ]
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/pane_target_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "pane.send_key"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/send_key_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "pane.run"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/run_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "pane.exec"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/exec_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "pane.wait"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/wait_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "enum": [
                  "git.status",
                  "git.diff",
                  "git.history",
                  "git.stage",
                  "git.unstage",
                  "git.commit",
                  "git.fetch",
                  "git.pull",
                  "git.push"
                ]
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/git_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "enum": [
                  "git.stage",
                  "git.unstage",
                  "git.commit",
                  "git.fetch",
                  "git.pull",
                  "git.push"
                ]
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "required": [
                  "revision"
                ],
                "properties": {
                  "revision": {
                    "type": "string",
                    "pattern": "^[0-9a-fA-F]{64}$"
                  }
                }
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "git.commit"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "required": [
                  "message"
                ],
                "properties": {
                  "message": {
                    "type": "string",
                    "pattern": "\\S"
                  }
                }
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "tab.focus"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/tab_identity_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "tab.open"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/tab_open_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "tab.read"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/tab_read_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "conversation.read"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/conversation_read_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "conversation.send"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/conversation_send_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "conversation.choose"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/conversation_choose_params"
              }
            }
          }
        },
        {
          "if": {
            "properties": {
              "method": {
                "const": "conversation.key"
              }
            }
          },
          "then": {
            "properties": {
              "params": {
                "$ref": "#/$defs/conversation_key_params"
              }
            }
          }
        }
      ]
    },
    "empty_params": {
      "type": "object",
      "maxProperties": 0
    },
    "nullable_window_id": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 0
    },
    "window_params": {
      "type": "object",
      "properties": {
        "window_id": {
          "$ref": "#/$defs/nullable_window_id"
        },
        "cwd": {
          "type": [
            "string",
            "null"
          ]
        },
        "shell": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "additionalProperties": false
    },
    "subscribe_params": {
      "type": "object",
      "properties": {
        "since_revision": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0
        }
      },
      "additionalProperties": false
    },
    "orchestrate_params": {
      "type": "object",
      "required": [
        "steps"
      ],
      "properties": {
        "steps": {
          "type": "array",
          "minItems": 1,
          "maxItems": 32,
          "items": {
            "$ref": "#/$defs/orchestrate_step"
          }
        },
        "on_error": {
          "enum": [
            "stop",
            "continue"
          ],
          "default": "stop"
        }
      },
      "additionalProperties": false
    },
    "orchestrate_step": {
      "oneOf": [
        {
          "$ref": "#/$defs/orchestrate_new_tab"
        },
        {
          "$ref": "#/$defs/orchestrate_focus"
        },
        {
          "$ref": "#/$defs/orchestrate_split"
        },
        {
          "$ref": "#/$defs/orchestrate_prompt"
        },
        {
          "$ref": "#/$defs/orchestrate_run"
        },
        {
          "$ref": "#/$defs/orchestrate_agent_launch"
        },
        {
          "$ref": "#/$defs/orchestrate_wait"
        }
      ]
    },
    "orchestrate_step_id": {
      "type": "string",
      "pattern": "^[A-Za-z_][A-Za-z0-9_-]{0,63}$"
    },
    "orchestrate_pane_target": {
      "oneOf": [
        {
          "type": "object",
          "required": [
            "step",
            "field"
          ],
          "properties": {
            "step": {
              "$ref": "#/$defs/orchestrate_step_id"
            },
            "field": {
              "const": "pane_id"
            }
          },
          "additionalProperties": false
        },
        {
          "type": "object",
          "required": [
            "pane_id"
          ],
          "properties": {
            "window_id": {
              "$ref": "#/$defs/nullable_window_id"
            },
            "pane_id": {
              "type": "integer",
              "minimum": 0
            }
          },
          "additionalProperties": false
        }
      ]
    },
    "orchestrate_new_tab": {
      "type": "object",
      "required": [
        "id",
        "op"
      ],
      "properties": {
        "id": {
          "$ref": "#/$defs/orchestrate_step_id"
        },
        "op": {
          "const": "new_tab"
        },
        "window_id": {
          "$ref": "#/$defs/nullable_window_id"
        },
        "cwd": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "additionalProperties": false
    },
    "orchestrate_focus": {
      "type": "object",
      "required": [
        "id",
        "op",
        "target"
      ],
      "properties": {
        "id": {
          "$ref": "#/$defs/orchestrate_step_id"
        },
        "op": {
          "const": "focus"
        },
        "target": {
          "$ref": "#/$defs/orchestrate_pane_target"
        }
      },
      "additionalProperties": false
    },
    "orchestrate_split": {
      "type": "object",
      "required": [
        "id",
        "op",
        "direction"
      ],
      "properties": {
        "id": {
          "$ref": "#/$defs/orchestrate_step_id"
        },
        "op": {
          "const": "split"
        },
        "window_id": {
          "$ref": "#/$defs/nullable_window_id"
        },
        "target": {
          "$ref": "#/$defs/orchestrate_pane_target"
        },
        "direction": {
          "enum": [
            "left_right",
            "top_bottom"
          ]
        }
      },
      "additionalProperties": false
    },
    "orchestrate_prompt": {
      "type": "object",
      "required": [
        "id",
        "op",
        "target",
        "text"
      ],
      "properties": {
        "id": {
          "$ref": "#/$defs/orchestrate_step_id"
        },
        "op": {
          "const": "prompt"
        },
        "target": {
          "$ref": "#/$defs/orchestrate_pane_target"
        },
        "text": {
          "type": "string",
          "minLength": 1,
          "maxLength": 32768
        },
        "submit": {
          "type": "boolean",
          "default": true
        }
      },
      "additionalProperties": false
    },
    "orchestrate_run": {
      "type": "object",
      "required": [
        "id",
        "op",
        "target",
        "command"
      ],
      "properties": {
        "id": {
          "$ref": "#/$defs/orchestrate_step_id"
        },
        "op": {
          "const": "run"
        },
        "target": {
          "$ref": "#/$defs/orchestrate_pane_target"
        },
        "command": {
          "type": "string",
          "minLength": 1,
          "maxLength": 32768
        },
        "wait": {
          "type": "boolean",
          "default": true
        },
        "timeout_ms": {
          "type": "integer",
          "minimum": 1,
          "maximum": 86400000,
          "default": 30000
        },
        "tail_lines": {
          "type": "integer",
          "minimum": 1,
          "maximum": 2000
        }
      },
      "additionalProperties": false
    },
    "orchestrate_agent_launch": {
      "type": "object",
      "required": [
        "id",
        "op",
        "target",
        "name",
        "kind",
        "initial_prompt"
      ],
      "properties": {
        "id": {
          "$ref": "#/$defs/orchestrate_step_id"
        },
        "op": {
          "const": "agent_launch"
        },
        "target": {
          "$ref": "#/$defs/orchestrate_pane_target"
        },
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 64
        },
        "kind": {
          "$ref": "#/$defs/launch_agent_kind"
        },
        "resume_session_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "initial_prompt": {
          "type": "string",
          "minLength": 1,
          "maxLength": 32768
        },
        "ready_timeout_ms": {
          "type": "integer",
          "minimum": 1,
          "maximum": 86400000,
          "default": 10000
        }
      },
      "additionalProperties": false
    },
    "orchestrate_wait": {
      "type": "object",
      "required": [
        "id",
        "op",
        "target",
        "state"
      ],
      "properties": {
        "id": {
          "$ref": "#/$defs/orchestrate_step_id"
        },
        "op": {
          "const": "wait"
        },
        "target": {
          "$ref": "#/$defs/orchestrate_pane_target"
        },
        "state": {
          "$ref": "#/$defs/wait_state"
        },
        "timeout_ms": {
          "type": "integer",
          "minimum": 1,
          "maximum": 86400000,
          "default": 30000
        },
        "tail_lines": {
          "type": "integer",
          "minimum": 1,
          "maximum": 2000
        }
      },
      "additionalProperties": false
    },
    "agent_start_params": {
      "type": "object",
      "required": [
        "name",
        "kind"
      ],
      "properties": {
        "window_id": {
          "$ref": "#/$defs/nullable_window_id"
        },
        "pane_id": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0
        },
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 64
        },
        "kind": {
          "$ref": "#/$defs/launch_agent_kind"
        },
        "cwd": {
          "type": [
            "string",
            "null"
          ]
        },
        "resume_session_id": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "additionalProperties": false
    },
    "agent_fork_params": {
      "type": "object",
      "required": [
        "name",
        "kind"
      ],
      "properties": {
        "window_id": {
          "$ref": "#/$defs/nullable_window_id"
        },
        "source_pane_id": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0
        },
        "source_cwd": {
          "type": [
            "string",
            "null"
          ]
        },
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 64
        },
        "kind": {
          "$ref": "#/$defs/launch_agent_kind"
        },
        "resume_session_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "branch": {
          "type": [
            "string",
            "null"
          ]
        },
        "base": {
          "type": [
            "string",
            "null"
          ]
        },
        "path": {
          "type": [
            "string",
            "null"
          ]
        },
        "allow_dirty_source": {
          "type": "boolean",
          "default": false
        }
      },
      "anyOf": [
        {
          "required": [
            "source_pane_id"
          ],
          "properties": {
            "source_pane_id": {
              "type": "integer"
            }
          }
        },
        {
          "required": [
            "source_cwd"
          ],
          "properties": {
            "source_cwd": {
              "type": "string",
              "minLength": 1
            }
          }
        }
      ],
      "additionalProperties": false
    },
    "launch_agent_kind": {
      "enum": [
        "claude",
        "codex",
        "opencode",
        "cursor",
        "pi",
        "omp",
        "kimi"
      ],
      "description": "Agent kinds with an officially verified interactive cold-start command."
    },
    "agent_target_params": {
      "type": "object",
      "required": [
        "agent"
      ],
      "properties": {
        "agent": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        },
        "generation": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 1
        }
      },
      "additionalProperties": false
    },
    "agent_prompt_params": {
      "type": "object",
      "required": [
        "agent",
        "text"
      ],
      "properties": {
        "agent": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        },
        "generation": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 1
        },
        "text": {
          "type": "string",
          "minLength": 1,
          "maxLength": 32768
        },
        "submit": {
          "type": "boolean",
          "default": true
        }
      },
      "additionalProperties": false
    },
    "agent_delegate_params": {
      "type": "object",
      "required": [
        "agent",
        "text",
        "origin_pane_id"
      ],
      "properties": {
        "agent": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        },
        "generation": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 1
        },
        "text": {
          "type": "string",
          "minLength": 1,
          "maxLength": 32768
        },
        "origin_pane_id": {
          "type": "integer",
          "minimum": 1
        }
      },
      "additionalProperties": false
    },
    "agent_paste_params": {
      "type": "object",
      "required": [
        "agent",
        "text"
      ],
      "properties": {
        "agent": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        },
        "generation": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 1
        },
        "text": {
          "type": "string",
          "minLength": 1,
          "maxLength": 32768
        },
        "submit": {
          "type": "boolean",
          "default": true
        }
      },
      "additionalProperties": false
    },
    "agent_read_params": {
      "type": "object",
      "required": [
        "agent"
      ],
      "properties": {
        "agent": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        },
        "generation": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 1
        },
        "lines": {
          "type": "integer",
          "minimum": 1,
          "maximum": 2000,
          "default": 120
        }
      },
      "additionalProperties": false
    },
    "agent_wait_params": {
      "type": "object",
      "required": [
        "agent",
        "generation",
        "state",
        "timeout_ms"
      ],
      "properties": {
        "agent": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        },
        "generation": {
          "type": "integer",
          "minimum": 1
        },
        "state": {
          "$ref": "#/$defs/wait_state"
        },
        "timeout_ms": {
          "type": "integer",
          "minimum": 1,
          "maximum": 86400000
        },
        "after_seq": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0
        }
      },
      "additionalProperties": false
    },
    "focus_params": {
      "type": "object",
      "properties": {
        "window_id": {
          "$ref": "#/$defs/nullable_window_id"
        },
        "pane_id": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0
        }
      },
      "additionalProperties": false
    },
    "tab_new_params": {
      "type": "object",
      "properties": {
        "window_id": {
          "$ref": "#/$defs/nullable_window_id"
        },
        "cwd": {
          "type": [
            "string",
            "null"
          ]
        },
        "shell": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "additionalProperties": false
    },
    "tab_target_params": {
      "type": "object",
      "required": [
        "tab_index"
      ],
      "properties": {
        "window_id": {
          "$ref": "#/$defs/nullable_window_id"
        },
        "tab_index": {
          "type": "integer",
          "minimum": 0
        }
      },
      "additionalProperties": false
    },
    "tab_rename_params": {
      "type": "object",
      "required": [
        "tab_index",
        "name"
      ],
      "properties": {
        "window_id": {
          "$ref": "#/$defs/nullable_window_id"
        },
        "tab_index": {
          "type": "integer",
          "minimum": 0
        },
        "name": {
          "type": "string",
          "maxLength": 256,
          "pattern": "^[^\\u0000-\\u001F\\u007F]*$",
          "description": "The server additionally enforces a 256-byte UTF-8 limit. Empty restores the generated title."
        }
      },
      "additionalProperties": false
    },
    "tab_move_params": {
      "type": "object",
      "required": [
        "tab_index",
        "to_index"
      ],
      "properties": {
        "window_id": {
          "$ref": "#/$defs/nullable_window_id"
        },
        "tab_index": {
          "type": "integer",
          "minimum": 0
        },
        "to_index": {
          "type": "integer",
          "minimum": 0
        }
      },
      "additionalProperties": false
    },
    "split_params": {
      "type": "object",
      "required": [
        "direction"
      ],
      "properties": {
        "window_id": {
          "$ref": "#/$defs/nullable_window_id"
        },
        "pane_id": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0
        },
        "direction": {
          "enum": [
            "left_right",
            "top_bottom"
          ]
        }
      },
      "additionalProperties": false
    },
    "prompt_params": {
      "type": "object",
      "required": [
        "pane_id",
        "text"
      ],
      "properties": {
        "window_id": {
          "$ref": "#/$defs/nullable_window_id"
        },
        "pane_id": {
          "type": "integer",
          "minimum": 0
        },
        "text": {
          "type": "string",
          "minLength": 1,
          "maxLength": 32768
        },
        "submit": {
          "type": "boolean",
          "default": true
        }
      },
      "additionalProperties": false
    },
    "paste_params": {
      "type": "object",
      "required": [
        "pane_id",
        "text"
      ],
      "properties": {
        "window_id": {
          "$ref": "#/$defs/nullable_window_id"
        },
        "pane_id": {
          "type": "integer",
          "minimum": 0
        },
        "text": {
          "type": "string",
          "minLength": 1,
          "maxLength": 32768
        },
        "submit": {
          "type": "boolean",
          "default": true
        }
      },
      "additionalProperties": false
    },
    "read_params": {
      "type": "object",
      "required": [
        "pane_id"
      ],
      "properties": {
        "window_id": {
          "$ref": "#/$defs/nullable_window_id"
        },
        "pane_id": {
          "type": "integer",
          "minimum": 0
        },
        "lines": {
          "type": "integer",
          "minimum": 1,
          "maximum": 2000,
          "default": 120
        },
        "screen": {
          "type": "boolean",
          "default": false,
          "description": "Include the live screen v1 color grid, independently of the text tail and desktop scrollback offset."
        }
      },
      "additionalProperties": false
    },
    "pane_target_params": {
      "type": "object",
      "required": [
        "pane_id"
      ],
      "properties": {
        "window_id": {
          "$ref": "#/$defs/nullable_window_id"
        },
        "pane_id": {
          "type": "integer",
          "minimum": 0
        }
      },
      "additionalProperties": false
    },
    "pane_zoom_params": {
      "type": "object",
      "required": [
        "pane_id",
        "zoomed"
      ],
      "properties": {
        "window_id": {
          "$ref": "#/$defs/nullable_window_id"
        },
        "pane_id": {
          "type": "integer",
          "minimum": 0
        },
        "zoomed": {
          "type": "boolean"
        }
      },
      "additionalProperties": false
    },
    "pane_resize_params": {
      "type": "object",
      "required": [
        "pane_id",
        "ratio"
      ],
      "properties": {
        "window_id": {
          "$ref": "#/$defs/nullable_window_id"
        },
        "pane_id": {
          "type": "integer",
          "minimum": 0
        },
        "ratio": {
          "type": "number",
          "minimum": 0.05,
          "maximum": 0.95
        }
      },
      "additionalProperties": false
    },
    "send_key_params": {
      "type": "object",
      "required": [
        "pane_id",
        "key"
      ],
      "properties": {
        "window_id": {
          "$ref": "#/$defs/nullable_window_id"
        },
        "pane_id": {
          "type": "integer",
          "minimum": 0
        },
        "key": {
          "enum": [
            "escape",
            "enter",
            "tab",
            "backspace",
            "up",
            "down",
            "left",
            "right",
            "home",
            "end",
            "insert",
            "delete",
            "page_up",
            "page_down",
            "f1",
            "f2",
            "f3",
            "f4",
            "f5",
            "f6",
            "f7",
            "f8",
            "f9",
            "f10",
            "f11",
            "f12",
            "a",
            "b",
            "c",
            "d",
            "e",
            "f",
            "g",
            "h",
            "i",
            "j",
            "k",
            "l",
            "m",
            "n",
            "o",
            "p",
            "q",
            "r",
            "s",
            "t",
            "u",
            "v",
            "w",
            "x",
            "y",
            "z"
          ]
        },
        "modifiers": {
          "type": "object",
          "properties": {
            "shift": {
              "type": "boolean",
              "default": false
            },
            "alt": {
              "type": "boolean",
              "default": false
            },
            "control": {
              "type": "boolean",
              "default": false
            }
          },
          "additionalProperties": false
        },
        "repeat": {
          "type": "integer",
          "minimum": 1,
          "maximum": 64,
          "default": 1
        }
      },
      "additionalProperties": false
    },
    "run_params": {
      "type": "object",
      "required": [
        "pane_id",
        "command"
      ],
      "properties": {
        "window_id": {
          "$ref": "#/$defs/nullable_window_id"
        },
        "pane_id": {
          "type": "integer",
          "minimum": 0
        },
        "command": {
          "type": "string",
          "minLength": 1,
          "maxLength": 32768
        },
        "wait": {
          "type": "boolean",
          "default": true
        },
        "timeout_ms": {
          "type": "integer",
          "minimum": 1,
          "maximum": 86400000,
          "default": 30000
        }
      },
      "additionalProperties": false
    },
    "exec_params": {
      "type": "object",
      "required": [
        "pane_id",
        "argv"
      ],
      "properties": {
        "window_id": {
          "$ref": "#/$defs/nullable_window_id"
        },
        "pane_id": {
          "type": "integer",
          "minimum": 0
        },
        "argv": {
          "type": "array",
          "minItems": 1,
          "maxItems": 256,
          "items": {
            "type": "string"
          },
          "description": "Direct program argv; no shell expansion is performed. The server enforces a 32768-byte aggregate limit."
        },
        "timeout_ms": {
          "type": "integer",
          "minimum": 1,
          "maximum": 86400000,
          "default": 30000
        },
        "max_output_bytes": {
          "type": "integer",
          "minimum": 1,
          "maximum": 16777216,
          "default": 1048576
        }
      },
      "additionalProperties": false
    },
    "git_params": {
      "type": "object",
      "description": "Git runs on the explicitly selected computer pane. The server rechecks its current cwd, resolves the repository root and checks the supplied status revision before a write. Read-only mobile channels allow status, diff and history only. Requests have a 25-second total execution deadline and a 256-KiB stdout limit.",
      "required": [
        "window_id",
        "pane_id",
        "expected_cwd"
      ],
      "properties": {
        "window_id": {
          "type": "integer",
          "minimum": 1
        },
        "pane_id": {
          "type": "integer",
          "minimum": 1
        },
        "expected_cwd": {
          "type": "string",
          "minLength": 1,
          "maxLength": 4096,
          "pattern": "^[^\\u0000]+$",
          "description": "Exact cwd from the pane snapshot; at most 4096 UTF-8 bytes."
        },
        "path": {
          "type": "string",
          "maxLength": 4096,
          "pattern": "^[^\\u0000]*$",
          "default": "",
          "description": "Exact repository-relative change path, at most 4096 UTF-8 bytes. Never interpreted as a shell command or glob."
        },
        "staged": {
          "type": "boolean",
          "default": false,
          "description": "Select the index diff rather than the worktree diff."
        },
        "all": {
          "type": "boolean",
          "default": false,
          "description": "Stage or unstage all changes in the repository, including when the pane cwd is a subdirectory."
        },
        "revision": {
          "type": "string",
          "default": "",
          "description": "Opaque revision returned by git.status. Required for mutations; an outdated revision produces git_stale before execution."
        },
        "message": {
          "type": "string",
          "maxLength": 16384,
          "pattern": "^[^\\u0000]*$",
          "default": "",
          "description": "Commit message, at most 16384 UTF-8 bytes. Only staged changes are committed."
        },
        "commit": {
          "type": "string",
          "pattern": "^(?:|[0-9a-fA-F]{40}|[0-9a-fA-F]{64})$",
          "default": "",
          "description": "A full object ID selects the commit diff instead of a current change."
        },
        "offset": {
          "type": "integer",
          "minimum": 0,
          "maximum": 10000,
          "default": 0,
          "description": "History offset; each response returns at most 50 commits and has_more."
        }
      },
      "additionalProperties": false
    },
    "wait_state": {
      "enum": [
        "idle",
        "running",
        "waiting_input",
        "attention",
        "finished",
        "failed",
        "settled"
      ]
    },
    "wait_params": {
      "type": "object",
      "required": [
        "pane_id",
        "state",
        "timeout_ms"
      ],
      "properties": {
        "window_id": {
          "$ref": "#/$defs/nullable_window_id"
        },
        "pane_id": {
          "type": "integer",
          "minimum": 0
        },
        "state": {
          "$ref": "#/$defs/wait_state"
        },
        "timeout_ms": {
          "type": "integer",
          "minimum": 1,
          "maximum": 86400000
        },
        "after_seq": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0
        }
      },
      "additionalProperties": false
    },
    "response": {
      "type": "object",
      "required": [
        "protocol",
        "version",
        "id",
        "ok"
      ],
      "properties": {
        "protocol": {
          "const": "nebula.runtime"
        },
        "version": {
          "const": 1
        },
        "id": {
          "type": "string"
        },
        "ok": {
          "type": "boolean"
        },
        "result": {},
        "error": {
          "$ref": "#/$defs/error"
        }
      },
      "additionalProperties": false
    },
    "error": {
      "type": "object",
      "required": [
        "code",
        "message"
      ],
      "properties": {
        "code": {
          "type": "string"
        },
        "message": {
          "type": "string"
        },
        "details": {}
      },
      "additionalProperties": false
    },
    "event": {
      "type": "object",
      "required": [
        "protocol",
        "version",
        "event",
        "revision",
        "data"
      ],
      "properties": {
        "protocol": {
          "const": "nebula.runtime"
        },
        "version": {
          "const": 1
        },
        "event": {
          "const": "runtime.snapshot"
        },
        "revision": {
          "type": "integer",
          "minimum": 1
        },
        "data": {
          "$ref": "#/$defs/snapshot"
        }
      },
      "additionalProperties": false
    },
    "snapshot": {
      "type": "object",
      "required": [
        "revision",
        "process_id",
        "app_version",
        "protocol_version",
        "detached_windows",
        "windows"
      ],
      "properties": {
        "revision": {
          "type": "integer",
          "minimum": 0
        },
        "process_id": {
          "type": "integer",
          "minimum": 1
        },
        "app_version": {
          "type": "string"
        },
        "protocol_version": {
          "const": 1
        },
        "detached_windows": {
          "type": "integer",
          "minimum": 0
        },
        "windows": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/window"
          }
        },
        "pane_lifecycles": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/pane_lifecycle"
          }
        }
      },
      "additionalProperties": false
    },
    "window": {
      "type": "object",
      "required": [
        "id",
        "focused",
        "session_exempt",
        "active_tab",
        "focused_pane_id",
        "tabs"
      ],
      "properties": {
        "id": {
          "type": "integer",
          "minimum": 0
        },
        "focused": {
          "type": "boolean"
        },
        "session_exempt": {
          "type": "boolean"
        },
        "active_tab": {
          "type": "integer",
          "minimum": 0
        },
        "focused_pane_id": {
          "type": [
            "integer",
            "null"
          ]
        },
        "tabs": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/tab"
          }
        }
      },
      "additionalProperties": false
    },
    "tab": {
      "type": "object",
      "required": [
        "index",
        "active",
        "label",
        "kind",
        "bell",
        "focused_pane_id",
        "zoomed_pane_id",
        "layout",
        "panes"
      ],
      "properties": {
        "index": {
          "type": "integer",
          "minimum": 0
        },
        "active": {
          "type": "boolean"
        },
        "label": {
          "type": "string"
        },
        "kind": {
          "enum": [
            "shell",
            "profile",
            "ssh",
            "document",
            "image",
            "code",
            "settings"
          ]
        },
        "bell": {
          "type": "boolean"
        },
        "focused_pane_id": {
          "type": [
            "integer",
            "null"
          ]
        },
        "zoomed_pane_id": {
          "type": [
            "integer",
            "null"
          ]
        },
        "layout": {
          "oneOf": [
            {
              "$ref": "#/$defs/layout"
            },
            {
              "type": "null"
            }
          ]
        },
        "panes": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/pane"
          }
        },
        "tab_id": {
          "type": "string",
          "pattern": "^[a-fA-F0-9]{32}$",
          "description": "Ephemeral identity, preserved by reorder and split. Absent on older runtimes."
        },
        "file": {
          "$ref": "#/$defs/tab_file"
        }
      },
      "additionalProperties": false
    },
    "layout": {
      "oneOf": [
        {
          "type": "object",
          "required": [
            "type",
            "pane_id"
          ],
          "properties": {
            "type": {
              "const": "pane"
            },
            "pane_id": {
              "type": "integer"
            }
          },
          "additionalProperties": false
        },
        {
          "type": "object",
          "required": [
            "type",
            "direction",
            "ratio",
            "first",
            "second"
          ],
          "properties": {
            "type": {
              "const": "split"
            },
            "direction": {
              "enum": [
                "left_right",
                "top_bottom"
              ]
            },
            "ratio": {
              "type": "number",
              "minimum": 0,
              "maximum": 1
            },
            "first": {
              "$ref": "#/$defs/layout"
            },
            "second": {
              "$ref": "#/$defs/layout"
            }
          },
          "additionalProperties": false
        }
      ]
    },
    "pane": {
      "type": "object",
      "required": [
        "id",
        "active",
        "title",
        "cwd",
        "branch",
        "ssh_destination",
        "running_program",
        "task_state",
        "state_change_seq"
      ],
      "properties": {
        "id": {
          "type": "integer",
          "minimum": 0
        },
        "active": {
          "type": "boolean"
        },
        "title": {
          "type": "string"
        },
        "cwd": {
          "type": "string"
        },
        "branch": {
          "type": "string"
        },
        "ssh_destination": {
          "type": [
            "string",
            "null"
          ]
        },
        "running_program": {
          "type": [
            "string",
            "null"
          ]
        },
        "agent": {
          "$ref": "#/$defs/agent"
        },
        "task_state": {
          "enum": [
            "idle",
            "running",
            "waiting_input",
            "attention",
            "finished",
            "failed"
          ]
        },
        "state_change_seq": {
          "description": "Monotonic per-pane counter, bumped every time task_state changes. Capture it before sending work, then pass it as wait's after_seq so an unchanged pane cannot satisfy the wait.",
          "type": "integer",
          "minimum": 1
        },
        "active_run": {
          "$ref": "#/$defs/pane_run"
        },
        "last_run": {
          "$ref": "#/$defs/run_outcome"
        }
      },
      "additionalProperties": false
    },
    "agent": {
      "type": "object",
      "required": [
        "kind",
        "display_name",
        "session_id",
        "state_source",
        "hook_seen"
      ],
      "properties": {
        "agent_id": {
          "type": "string",
          "minLength": 1
        },
        "generation": {
          "type": "integer",
          "minimum": 1
        },
        "name": {
          "type": "string",
          "minLength": 1
        },
        "worktree": {
          "$ref": "#/$defs/worktree"
        },
        "kind": {
          "type": "string",
          "minLength": 1
        },
        "display_name": {
          "type": "string",
          "minLength": 1
        },
        "session_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "state_source": {
          "enum": [
            "hook",
            "screen",
            "process"
          ]
        },
        "state_rule": {
          "type": "string"
        },
        "hook_seen": {
          "type": "boolean"
        }
      },
      "additionalProperties": false
    },
    "worktree": {
      "type": "object",
      "required": [
        "repo_root",
        "source_root",
        "path",
        "branch",
        "base_commit",
        "created"
      ],
      "properties": {
        "repo_root": {
          "type": "string",
          "minLength": 1
        },
        "source_root": {
          "type": "string",
          "minLength": 1
        },
        "path": {
          "type": "string",
          "minLength": 1
        },
        "branch": {
          "type": "string",
          "minLength": 1
        },
        "base_commit": {
          "type": "string",
          "minLength": 1
        },
        "created": {
          "const": true
        }
      },
      "additionalProperties": false
    },
    "managed_agent": {
      "type": "object",
      "required": [
        "agent_id",
        "generation",
        "name",
        "kind",
        "window_id",
        "pane_id",
        "active",
        "observed"
      ],
      "properties": {
        "agent_id": {
          "type": "string",
          "minLength": 1
        },
        "generation": {
          "type": "integer",
          "minimum": 1
        },
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 64
        },
        "kind": {
          "type": "string",
          "minLength": 1
        },
        "window_id": {
          "type": "integer",
          "minimum": 0
        },
        "pane_id": {
          "type": "integer",
          "minimum": 0
        },
        "session_id": {
          "type": "string"
        },
        "worktree": {
          "$ref": "#/$defs/worktree"
        },
        "active": {
          "type": "boolean"
        },
        "observed": {
          "type": "boolean"
        },
        "closed_reason": {
          "type": "string"
        }
      },
      "additionalProperties": false
    },
    "pane_lifecycle": {
      "type": "object",
      "required": [
        "sequence",
        "window_id",
        "pane_id",
        "event"
      ],
      "properties": {
        "sequence": {
          "type": "integer",
          "minimum": 1
        },
        "window_id": {
          "type": "integer",
          "minimum": 0
        },
        "pane_id": {
          "type": "integer",
          "minimum": 0
        },
        "event": {
          "enum": [
            "closed",
            "exited"
          ]
        }
      },
      "additionalProperties": false
    },
    "pane_run": {
      "type": "object",
      "required": [
        "run_id",
        "phase"
      ],
      "properties": {
        "run_id": {
          "type": "integer",
          "minimum": 1
        },
        "phase": {
          "enum": [
            "submitted",
            "started"
          ]
        }
      },
      "additionalProperties": false
    },
    "run_outcome": {
      "type": "object",
      "required": [
        "run_id",
        "state",
        "exit_code",
        "exit_code_capability"
      ],
      "properties": {
        "run_id": {
          "type": "integer",
          "minimum": 1
        },
        "state": {
          "enum": [
            "finished",
            "failed",
            "unavailable"
          ]
        },
        "exit_code": {
          "type": [
            "integer",
            "null"
          ]
        },
        "exit_code_capability": {
          "enum": [
            "supported",
            "unavailable"
          ]
        },
        "unavailable_reason": {
          "type": "string"
        }
      },
      "additionalProperties": false
    },
    "agent_pane": {
      "type": "object",
      "required": [
        "window_id",
        "tab_index",
        "tab_active",
        "pane_id",
        "pane_active",
        "title",
        "cwd",
        "branch",
        "ssh_destination",
        "agent",
        "task_state",
        "state_change_seq"
      ],
      "properties": {
        "window_id": {
          "type": "integer",
          "minimum": 0
        },
        "tab_index": {
          "type": "integer",
          "minimum": 0
        },
        "tab_active": {
          "type": "boolean"
        },
        "pane_id": {
          "type": "integer",
          "minimum": 0
        },
        "pane_active": {
          "type": "boolean"
        },
        "title": {
          "type": "string"
        },
        "cwd": {
          "type": "string"
        },
        "branch": {
          "type": "string"
        },
        "ssh_destination": {
          "type": [
            "string",
            "null"
          ]
        },
        "agent": {
          "$ref": "#/$defs/agent"
        },
        "task_state": {
          "enum": [
            "idle",
            "running",
            "waiting_input",
            "attention",
            "finished",
            "failed"
          ]
        },
        "state_change_seq": {
          "type": "integer",
          "minimum": 1
        }
      },
      "additionalProperties": false
    },
    "agents_result": {
      "type": "object",
      "required": [
        "revision",
        "agents"
      ],
      "properties": {
        "revision": {
          "type": "integer",
          "minimum": 1
        },
        "agents": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/agent_pane"
          }
        }
      },
      "additionalProperties": false
    },
    "pane_read": {
      "type": "object",
      "required": [
        "window_id",
        "pane_id",
        "text",
        "requested_lines",
        "returned_lines",
        "history_available",
        "truncated",
        "task_state",
        "exited"
      ],
      "properties": {
        "window_id": {
          "type": "integer",
          "minimum": 0
        },
        "pane_id": {
          "type": "integer",
          "minimum": 0
        },
        "text": {
          "type": "string"
        },
        "requested_lines": {
          "type": "integer",
          "minimum": 1,
          "maximum": 2000
        },
        "returned_lines": {
          "type": "integer",
          "minimum": 0,
          "maximum": 2000
        },
        "history_available": {
          "type": "integer",
          "minimum": 0
        },
        "truncated": {
          "type": "boolean"
        },
        "task_state": {
          "enum": [
            "idle",
            "running",
            "waiting_input",
            "attention",
            "finished",
            "failed"
          ]
        },
        "exited": {
          "type": "boolean"
        },
        "exit_reason": {
          "type": "string"
        },
        "screen": {
          "$ref": "#/$defs/terminal_screen_v1"
        }
      },
      "additionalProperties": false
    },
    "tab_identity_params": {
      "type": "object",
      "required": [
        "window_id",
        "tab_id"
      ],
      "properties": {
        "window_id": {
          "type": "integer",
          "minimum": 1
        },
        "tab_id": {
          "type": "string",
          "pattern": "^[a-fA-F0-9]{32}$"
        }
      },
      "additionalProperties": false
    },
    "tab_read_params": {
      "type": "object",
      "required": [
        "window_id",
        "tab_id"
      ],
      "properties": {
        "window_id": {
          "type": "integer",
          "minimum": 1
        },
        "tab_id": {
          "type": "string",
          "pattern": "^[a-fA-F0-9]{32}$"
        },
        "offset": {
          "type": "integer",
          "minimum": 0,
          "maximum": 16777216
        },
        "limit": {
          "type": "integer",
          "minimum": 4,
          "maximum": 65536
        },
        "revision": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        }
      },
      "additionalProperties": false,
      "allOf": [
        {
          "if": {
            "required": [
              "offset"
            ],
            "properties": {
              "offset": {
                "minimum": 1
              }
            }
          },
          "then": {
            "required": [
              "revision"
            ]
          }
        }
      ]
    },
    "tab_open_params": {
      "type": "object",
      "required": [
        "window_id",
        "path"
      ],
      "properties": {
        "window_id": {
          "type": "integer",
          "minimum": 1
        },
        "path": {
          "type": "string",
          "minLength": 1,
          "maxLength": 4096,
          "description": "Absolute path on the computer; only in-app readable files are accepted."
        }
      },
      "additionalProperties": false
    },
    "tab_file": {
      "type": "object",
      "required": [
        "path",
        "remote",
        "dirty",
        "saving",
        "ready"
      ],
      "properties": {
        "path": {
          "type": "string"
        },
        "remote": {
          "type": "boolean"
        },
        "dirty": {
          "type": "boolean"
        },
        "saving": {
          "type": "boolean"
        },
        "ready": {
          "type": "boolean"
        },
        "revision": {
          "type": "integer",
          "minimum": 0
        }
      },
      "additionalProperties": false
    },
    "conversation_identity": {
      "type": "object",
      "required": [
        "kind",
        "session_id"
      ],
      "properties": {
        "kind": {
          "enum": [
            "codex",
            "claude"
          ]
        },
        "session_id": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        },
        "epoch": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0
        }
      },
      "additionalProperties": false
    },
    "conversation_read_params": {
      "type": "object",
      "required": [
        "window_id",
        "pane_id",
        "identity"
      ],
      "properties": {
        "window_id": {
          "type": "integer",
          "minimum": 1
        },
        "pane_id": {
          "type": "integer",
          "minimum": 1
        },
        "identity": {
          "$ref": "#/$defs/conversation_identity"
        },
        "before": {
          "type": [
            "integer",
            "null"
          ],
          "minimum": 0
        },
        "revision": {
          "type": [
            "string",
            "null"
          ],
          "maxLength": 128
        }
      },
      "additionalProperties": false
    },
    "conversation_send_params": {
      "type": "object",
      "required": [
        "window_id",
        "pane_id",
        "identity",
        "text"
      ],
      "properties": {
        "window_id": {
          "type": "integer",
          "minimum": 1
        },
        "pane_id": {
          "type": "integer",
          "minimum": 1
        },
        "identity": {
          "allOf": [
            {
              "$ref": "#/$defs/conversation_identity"
            },
            {
              "required": [
                "epoch"
              ],
              "properties": {
                "epoch": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          ]
        },
        "text": {
          "type": "string",
          "minLength": 1
        }
      },
      "additionalProperties": false
    },
    "conversation_choose_params": {
      "type": "object",
      "required": [
        "window_id",
        "pane_id",
        "identity",
        "prompt_id",
        "option"
      ],
      "properties": {
        "window_id": {
          "type": "integer",
          "minimum": 1
        },
        "pane_id": {
          "type": "integer",
          "minimum": 1
        },
        "identity": {
          "allOf": [
            {
              "$ref": "#/$defs/conversation_identity"
            },
            {
              "required": [
                "epoch"
              ],
              "properties": {
                "epoch": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          ]
        },
        "prompt_id": {
          "type": "string",
          "pattern": "^[a-f0-9]{64}$"
        },
        "option": {
          "type": "integer",
          "minimum": 0,
          "maximum": 8
        }
      },
      "additionalProperties": false
    },
    "conversation_key_params": {
      "type": "object",
      "required": [
        "window_id",
        "pane_id",
        "identity",
        "key"
      ],
      "properties": {
        "window_id": {
          "type": "integer",
          "minimum": 1
        },
        "pane_id": {
          "type": "integer",
          "minimum": 1
        },
        "identity": {
          "allOf": [
            {
              "$ref": "#/$defs/conversation_identity"
            },
            {
              "required": [
                "epoch"
              ],
              "properties": {
                "epoch": {
                  "type": "integer",
                  "minimum": 0
                }
              }
            }
          ]
        },
        "key": {
          "type": "string",
          "enum": [
            "Ctrl+C",
            "Esc",
            "Tab",
            "←",
            "→",
            "↑",
            "↓"
          ]
        }
      },
      "additionalProperties": false
    },
    "terminal_screen_v1": {
      "type": "object",
      "required": [
        "version",
        "columns",
        "rows",
        "palette",
        "cursor"
      ],
      "properties": {
        "version": {
          "const": 1
        },
        "columns": {
          "type": "integer",
          "minimum": 1,
          "maximum": 400
        },
        "rows": {
          "type": "array",
          "minItems": 1,
          "maxItems": 200,
          "items": {
            "type": "array",
            "minItems": 1,
            "maxItems": 400,
            "items": {
              "type": "array",
              "prefixItems": [
                {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256
                },
                {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 2
                },
                {
                  "type": "integer",
                  "minimum": -269,
                  "maximum": 16777215
                },
                {
                  "type": "integer",
                  "minimum": -269,
                  "maximum": 16777215
                },
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 63
                }
              ],
              "minItems": 5,
              "maxItems": 5
            }
          }
        },
        "palette": {
          "type": "array",
          "maxItems": 269,
          "items": {
            "type": "array",
            "prefixItems": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 268
              },
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 16777215
              }
            ],
            "minItems": 2,
            "maxItems": 2
          }
        },
        "cursor": {
          "type": "array",
          "prefixItems": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 399
            },
            {
              "type": "integer",
              "minimum": 0
            },
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 1
            }
          ],
          "minItems": 3,
          "maxItems": 3
        },
        "wrapped": {
          "type": "array",
          "minItems": 1,
          "maxItems": 200,
          "items": {
            "type": "boolean"
          },
          "description": "Optional soft-wrap flag per physical row, preserving logical lines during phone-only reflow."
        }
      },
      "additionalProperties": false,
      "description": "At most 40000 cells and 128 KiB UTF-8 glyphs; each glyph <=256 UTF-8 bytes. Row widths must equal columns. Color <0 references -(palette index+1); otherwise RGB. Flags: bold=1, italic=2, underline=4, strike=8, dim=16, hidden=32. Cursor is [x,y,visible]. Oversized grids return screen_too_large, never a silently cropped frame."
    }
  }
}