Traversio

1.0.0

Release notes for Traversio 1.0.0.

Released: 2026-05-25

Summary

Traversio 1.0.0 establishes the first public Swift package API for Apple apps that need native Swift SSH, SFTP, SCP, forwarding, proxy routing, host-key trust, and diagnostics.

Public API Surface

The initial API includes:

  • encrypted SSH transport with the documented algorithm profile
  • explicit host-key trust
  • password, keyboard-interactive, public-key, callback-backed, and SSH-agent authentication
  • OpenSSH private-key loading and OpenSSH-compatible key generation
  • command execution, streamed exec, named subsystem startup, and PTY shells
  • SFTP metadata, file handles, reads, writes, mutations, recursive helpers, resumable helpers, and selected OpenSSH extensions
  • single-file SCP receive/send helpers
  • raw direct TCP/IP and streamlocal channels
  • local forwarding, dynamic SOCKS forwarding, remote TCP forwarding, and remote streamlocal forwarding
  • SOCKS5 and HTTP CONNECT connection proxies
  • ProxyJump
  • structured errors, log handlers, OSLog helpers, support reports, and route-aware SSH port latency diagnostics

Release Hardening

This release also adds:

  • public OpenSSH private-key metadata inspection with SSHOpenSSHPrivateKeyInfo
  • a public API baseline check through Tools/check-public-api.sh
  • release metadata checks for TraversioRelease.version, source package tags, and SSH client identification
  • public documentation for connection lifecycle, cancellation behavior, forwarding shutdown, and support diagnostics

Not Included

This release does not include:

  • library-owned automatic reconnect
  • local ssh_config parsing
  • mandatory built-in trust-store persistence
  • mandatory Keychain-backed credential or trust storage
  • hostbased authentication
  • security-key authentication
  • X11 forwarding
  • auth-agent forwarding
  • recursive SCP
  • broad legacy algorithm compatibility beyond explicit ssh-rsa
  • release-quality benchmark comparisons

On this page