Astra Shell DocumentationDownload for macOS
Documentation Current: Protocol compatibility

Documentation / Reference / Protocol compatibility

REFERENCE · PROTOCOL

Versions, capabilities, and compatibility.

The connection version selects framing and authentication; Hello capability negotiation selects the semantic terminal and session features available to that connection.

Version range

The current application protocol is N=2 and supports N-1=1. ALPN astra/1 identifies the framing and authentication family; Hello's version range and capability selection define the actual semantics.

Capability table

CapabilityVersionStatus
terminal.semantic_statev2Enabled
terminal.history_pagingv1Enabled
session.objectsv1Enabled
terminal.input_leasev1Enabled
terminal.datagram_stateNot enabled

Compatibility boundary

Only N-1 clients without semantic capability negotiation enter the isolated ANSI path. Standalone SSH/SFTP Hosts are a separate product mode, not Astra-over-SSH stdio fallback.

Evolution rules

Capabilities must be negotiated explicitly. UI code must not guess old-field semantics, and migration paths must be versioned and registered. Clients reject unknown or incomplete state and request a reliable baseline.