Set up a new terminal connection to "{{host}}" and verify it works:
-
Create Credentials First
- Ask the user for their preferred auth method (password, SSH key, or key file)
- Use
terminal_credential_createto store the credential securely - Note the returned credential ID for the next step
-
Create the Connection
- Use
terminal_connection_createwith the host "{{host}}" and thecredential_idfrom step 1 - Set the name to "{{label}}" if provided, otherwise use the hostname
- Configure the connection type (SSH is the default)
- Use
-
Test the Connection
- Use
terminal_connection_testwith the connection ID to verify it works - If the test fails, report the error details clearly
- Suggest common fixes (wrong port, firewall, credential issues)
- Use
-
Confirm Setup
- Use
terminal_connection_listto show the new connection in the list - Report the connection ID for future reference
- Suggest next steps (starting a session, creating a tunnel)
- Use
Important Notes:
- Never store or log raw passwords or private keys
- If SSH key auth is chosen, the key content should be provided securely
- Default SSH port is 22; ask if a non-standard port is needed
