Previous value: -"Seconds of silence after sending the key before returning (> 0, ≤ total_timeout)"New value: +"Seconds of output silence after sending the key before returning. Raise for slow TUI repaints (e.g. over high-latency SSH). Must be > 0 and ≤ total_timeout"

Previous value: -"Hard cap on call duration in seconds (≥ pause_timeout)"New value: +"Hard cap on total call duration in seconds. Only binds while output is actively streaming. Must be ≥ pause_timeout"

Removed value: -"ctrl+c"

Previous value: -[
-  "command_id"
-]New value: +[
+  "command_id",
+  "signal"
+]

Previous value: -"The command_id from a status='partial' response. Must be an active (not yet completed) command. Raises ValueError if invalid or already finished"New value: +"The command_id from a status='partial' response. Raises ValueError if invalid or already completed"

Previous value: -"Seconds of output silence before returning. Raise this (not total_timeout) when the command is slow to respond after receiving input. Must be > 0 and ≤ total_timeout"New value: +"Seconds of silence before returning (> 0, ≤ total_timeout)"

Previous value: -"Text to write to the command's stdin (e.g. 'y', a password, a shell command). A trailing newline is auto-appended if missing. For control keys (Ctrl+C, arrows, etc.) use send_control instead — AI frameworks strip control bytes from strings"New value: +"Text to write to stdin (e.g. 'y', a password, a shell command)"

Previous value: -"Hard cap on total call duration in seconds. Only binds while output is actively streaming. Must be ≥ pause_timeout"New value: +"Hard cap on call duration in seconds (≥ pause_timeout)"

Previous value: -"Max seconds to capture the MOTD/welcome banner after login. If exceeded, banner returns '' (not an error). Increase for slow hosts; set to 0 to skip banner capture entirely"New value: +"Max seconds to capture the MOTD/welcome banner after login"

Previous value: -"Hostname or IP of the SSH server (e.g. '192.168.1.10', 'example.com'). DNS resolution happens at connect time; unresolvable hosts raise an error"New value: +"Hostname or IP of the SSH server (e.g. '192.168.1.10', 'example.com')"

Previous value: -"Absolute path to a private key file (e.g. '/home/user/.ssh/id_rsa'). Must be readable by the server process. Preferred over password for non-interactive use"New value: +"Absolute path to a private key file (e.g. '/home/user/.ssh/id_rsa')"

Previous value: -"Password for password-based auth. If both password and key_filepath are provided, key is tried first, password is the fallback"New value: +"Password for password-based auth; omit for key-based auth"

Previous value: -"SSH port, 1–65535. Most servers listen on 22; non-standard ports are common for hardened hosts"New value: +"SSH port number, 1–65535"

Previous value: -"Login user for authentication. If omitted, falls back to SSH agent or OS default user. Required when the remote user differs from the local one"New value: +"Login user for authentication; omit to use SSH agent or OS default"

Previous value: -"The session_id returned by connect_ssh. After this call, the session_id becomes invalid — further execute() calls with it raise ValueError. Safe to call multiple times: disconnecting an already-closed or unknown session_id silently returns true (idempotent)"New value: +"SSH session identifier obtained from connect_ssh"

Previous value: -"Shell command to run. Each call is stateless — `cd /foo` does NOT persist. Chain with && for multi-step (e.g. 'cd /foo && ls'), or use a Zellij/tmux session for persistent state"New value: +"Shell command to run (stateless — cd does not persist between calls)"

Previous value: -"Seconds of output silence before returning. Controls how long to wait for a quiet command — raise this (not total_timeout) for slow-starting jobs. Must be > 0 and ≤ total_timeout"New value: +"Seconds of silence before returning a partial result (> 0, ≤ total_timeout)"

Previous value: -"SSH session_id from connect_ssh. Omit (or null) for local execution. Raises ValueError if the session_id is invalid or was already disconnected"New value: +"SSH session_id from connect_ssh; omit for local execution"

Previous value: -"Shell for local execution (e.g. 'powershell.exe', '/bin/bash'). Only used when session_id is null — ignored for SSH. Defaults to cmd.exe on Windows, /bin/bash on Unix"New value: +"Shell for local execution (e.g. 'powershell.exe', '/bin/bash'); ignored for SSH"

Previous value: -"Hard cap on total call duration in seconds. Only binds while output is actively streaming — a silent command returns at pause_timeout, not total_timeout. Must be ≥ pause_timeout"New value: +"Hard cap on call duration in seconds (≥ pause_timeout)"

Previous value: -"The command_id from a status='partial' response. Must be an active command. Raises ValueError if invalid or already completed"New value: +"The command_id from a status='partial' response. Raises ValueError if invalid or already completed"

Previous value: -"Seconds of output silence before returning. This is the primary dial for polling quiet jobs — raise it (e.g. 30, 60) instead of total_timeout. Must be > 0 and ≤ total_timeout"New value: +"Seconds of silence before returning. Primary dial for polling — raise it (e.g. 30, 60) for quiet jobs instead of total_timeout. Must be > 0 and ≤ total_timeout"

Previous value: -"Hard cap on total call duration in seconds. Only binds while output is actively streaming — a silent poll returns at pause_timeout regardless. Must be ≥ pause_timeout"New value: +"Hard cap on call duration in seconds. Only binds while output is streaming — silent polls return at pause_timeout. Must be ≥ pause_timeout"

Previous value: -"Seconds of output silence after sending the key before returning. Raise for slow TUI repaints (e.g. over high-latency SSH). Must be > 0 and ≤ total_timeout"New value: +"Seconds of silence after sending the key before returning (> 0, ≤ total_timeout)"

Previous value: -"Hard cap on total call duration in seconds. Only binds while output is actively streaming. Must be ≥ pause_timeout"New value: +"Hard cap on call duration in seconds (≥ pause_timeout)"

Previous value: -"The session_id returned by connect_ssh. Becomes invalid after this call — further execute() calls with it raise ValueError. Raises ValueError if already disconnected or unrecognized"New value: +"The session_id returned by connect_ssh. After this call, the session_id becomes invalid — further execute() calls with it raise ValueError. Safe to call multiple times: disconnecting an already-closed or unknown session_id silently returns true (idempotent)"

Previous value: -"The timeout in seconds to wait for the MOTD/welcome banner after the connection opens"New value: +"Max seconds to capture the MOTD/welcome banner after login. If exceeded, banner returns '' (not an error). Increase for slow hosts; set to 0 to skip banner capture entirely"

Previous value: -"The hostname or IP address of the SSH server to connect to (e.g., '192.168.1.10' or 'example.com')"New value: +"Hostname or IP of the SSH server (e.g. '192.168.1.10', 'example.com'). DNS resolution happens at connect time; unresolvable hosts raise an error"

Previous value: -"Optional absolute path to a private key file for key-based auth; must be readable by the server process. If both this and password are supplied, the key is attempted first"New value: +"Absolute path to a private key file (e.g. '/home/user/.ssh/id_rsa'). Must be readable by the server process. Preferred over password for non-interactive use"

Previous value: -"Optional password for password-based authentication. Omit if using key-based authentication"New value: +"Password for password-based auth. If both password and key_filepath are provided, key is tried first, password is the fallback"

Previous value: -"The port number of the SSH server (default is 22)"New value: +"SSH port, 1–65535. Most servers listen on 22; non-standard ports are common for hardened hosts"

Previous value: -"Optional username for authentication. If omitted, the connection will use SSH agent or system defaults"New value: +"Login user for authentication. If omitted, falls back to SSH agent or OS default user. Required when the remote user differs from the local one"

Previous value: -"The SSH session_id returned by connect_ssh that you want to close"New value: +"The session_id returned by connect_ssh. Becomes invalid after this call — further execute() calls with it raise ValueError. Raises ValueError if already disconnected or unrecognized"

Previous value: -"The shell command to execute. Each call is stateless; for persistent state (cd, venv, env vars), drive a Zellij session instead of chaining &&"New value: +"Shell command to run. Each call is stateless — `cd /foo` does NOT persist. Chain with && for multi-step (e.g. 'cd /foo && ls'), or use a Zellij/tmux session for persistent state"

Previous value: -"Seconds of output silence to wait before returning a partial response (default is 9.0)"New value: +"Seconds of output silence before returning. Controls how long to wait for a quiet command — raise this (not total_timeout) for slow-starting jobs. Must be > 0 and ≤ total_timeout"

Previous value: -"SSH session_id returned by connect_ssh. Omit for local commands — no session needed"New value: +"SSH session_id from connect_ssh. Omit (or null) for local execution. Raises ValueError if the session_id is invalid or was already disconnected"

Previous value: -"Shell for local execution (e.g. 'powershell.exe', '/bin/bash'). Ignored when session_id is provided. Defaults to cmd.exe on Windows, /bin/bash on Unix"New value: +"Shell for local execution (e.g. 'powershell.exe', '/bin/bash'). Only used when session_id is null — ignored for SSH. Defaults to cmd.exe on Windows, /bin/bash on Unix"

Previous value: -"Hard cap in seconds on the maximum duration of this call (default is 20.0)"New value: +"Hard cap on total call duration in seconds. Only binds while output is actively streaming — a silent command returns at pause_timeout, not total_timeout. Must be ≥ pause_timeout"

Previous value: -"The active command_id returned in a partial status response"New value: +"The command_id from a status='partial' response. Must be an active command. Raises ValueError if invalid or already completed"

Previous value: -"Seconds of output silence to wait before returning (default is 9.0)"New value: +"Seconds of output silence before returning. This is the primary dial for polling quiet jobs — raise it (e.g. 30, 60) instead of total_timeout. Must be > 0 and ≤ total_timeout"

Previous value: -"Hard cap in seconds on the maximum duration of this call (default is 20.0)"New value: +"Hard cap on total call duration in seconds. Only binds while output is actively streaming — a silent poll returns at pause_timeout regardless. Must be ≥ pause_timeout"

Previous value: -"The active command_id returned in a partial status response that is waiting for input"New value: +"The command_id from a status='partial' response. Must be an active (not yet completed) command. Raises ValueError if invalid or already finished"

Previous value: -"Seconds of output silence to wait before returning (default is 9.0)"New value: +"Seconds of output silence before returning. Raise this (not total_timeout) when the command is slow to respond after receiving input. Must be > 0 and ≤ total_timeout"

Previous value: -"The text input to send to the command (e.g. 'y' for prompts, passwords, etc.). Newline is auto-appended"New value: +"Text to write to the command's stdin (e.g. 'y', a password, a shell command). A trailing newline is auto-appended if missing. For control keys (Ctrl+C, arrows, etc.) use send_control instead — AI frameworks strip control bytes from strings"

Previous value: -"Hard cap in seconds on the maximum duration of this call (default is 20.0)"New value: +"Hard cap on total call duration in seconds. Only binds while output is actively streaming. Must be ≥ pause_timeout"

Previous value: -"The active command_id returned in a partial status response"New value: +"The command_id from a status='partial' response. Must be an active command. Raises ValueError if invalid or already completed"

Previous value: -"Seconds of output silence to wait before returning (default is 9.0)"New value: +"Seconds of output silence after sending the key before returning. Raise for slow TUI repaints (e.g. over high-latency SSH). Must be > 0 and ≤ total_timeout"

Previous value: -"The control signal or key to send. Supported values: 'ctrl+c', 'ctrl+z', 'ctrl+d', arrow keys, enter, f1-f12, etc."New value: +"Case-insensitive key name. Values: ctrl+a..ctrl+z, ctrl+[/]/^/_/\\, esc, tab, enter, return, space, backspace, up/down/left/right, home, end, pageup, pagedown, insert, delete, f1..f12, backtab, alt+<char>. Raises ValueError if unrecognized"

Previous value: -"Hard cap in seconds on the maximum duration of this call (default is 20.0)"New value: +"Hard cap on total call duration in seconds. Only binds while output is actively streaming. Must be ≥ pause_timeout"

Previous value: -"The unique session identifier returned by connect_ssh or create_local that you want to close"New value: +"The SSH session_id returned by connect_ssh that you want to close"

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Added value: +null

Previous value: -"The unique session identifier returned by connect_ssh or create_local"New value: +"SSH session_id returned by connect_ssh. Omit for local commands — no session needed"

Removed value: -"string"

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Shell for local execution (e.g. 'powershell.exe', '/bin/bash'). Ignored when session_id is provided. Defaults to cmd.exe on Windows, /bin/bash on Unix",
+  "title": "Shell"
+}

Previous value: -[
-  "session_id",
-  "command"
-]New value: +[
+  "command"
+]

Previous value: -"Optional absolute path to a private key file (SSH key) for key-based authentication"New value: +"Optional absolute path to a private key file for key-based auth; must be readable by the server process. If both this and password are supplied, the key is attempted first"

Previous value: -"Optional password for password-based authentication. If using key-based authentication, this can be omitted"New value: +"Optional password for password-based authentication. Omit if using key-based authentication"

Previous value: -"The shell command to execute (e.g., 'ls -la' or 'npm run build'). Can chain multiple commands with && or ;"New value: +"The shell command to execute. Each call is stateless; for persistent state (cd, venv, env vars), drive a Zellij session instead of chaining &&"

Added value: +"The timeout in seconds to wait for the MOTD/welcome banner after the connection opens"

Added value: +"The hostname or IP address of the SSH server to connect to (e.g., '192.168.1.10' or 'example.com')"

Added value: +"Optional absolute path to a private key file (SSH key) for key-based authentication"

Added value: +"Optional password for password-based authentication. If using key-based authentication, this can be omitted"

Added value: +"The port number of the SSH server (default is 22)"

Added value: +"Optional username for authentication. If omitted, the connection will use SSH agent or system defaults"

Added value: +"Optional absolute path or executable name of the shell to use (e.g., 'powershell.exe', '/bin/bash', '/bin/zsh'). If omitted, defaults to cmd.exe on Windows or /bin/bash on Unix/macOS."

Added value: +"The unique session identifier returned by connect_ssh or create_local that you want to close"

Added value: +"The shell command to execute (e.g., 'ls -la' or 'npm run build'). Can chain multiple commands with && or ;"

Added value: +"Seconds of output silence to wait before returning a partial response (default is 9.0)"

Added value: +"The unique session identifier returned by connect_ssh or create_local"

Added value: +"Hard cap in seconds on the maximum duration of this call (default is 20.0)"

Added value: +"The active command_id returned in a partial status response"

Added value: +"Seconds of output silence to wait before returning (default is 9.0)"

Added value: +"Hard cap in seconds on the maximum duration of this call (default is 20.0)"

Added value: +"The active command_id returned in a partial status response that is waiting for input"

Added value: +"Seconds of output silence to wait before returning (default is 9.0)"

Added value: +"The text input to send to the command (e.g. 'y' for prompts, passwords, etc.). Newline is auto-appended"

Added value: +"Hard cap in seconds on the maximum duration of this call (default is 20.0)"

Added value: +"The active command_id returned in a partial status response"

Added value: +"Seconds of output silence to wait before returning (default is 9.0)"

Added value: +"The control signal or key to send. Supported values: 'ctrl+c', 'ctrl+z', 'ctrl+d', arrow keys, enter, f1-f12, etc."

Added value: +"Hard cap in seconds on the maximum duration of this call (default is 20.0)"