Foundation / checks (checks) (push) Successful in 32m47s
Foundation / checks (client) (push) Failing after 10m1s
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 1m53s
Foundation / checks (network) (push) Successful in 11m18s
Foundation / checks (postgres) (push) Successful in 40m20s
Foundation / checks (tsan) (push) Successful in 7m46s
Foundation / postgres-tools (push) Skipped
Foundation / image (push) Skipped
Foundation / server-image (push) Skipped
evo-client's remote mode now runs over RegionSessionClient (QUIC, session v2): snapshot-fed environment and organism views, the camera following the server's view until the user moves it and then driving the interest, intention records with a simulated state, and reconnects with the next grant of a bundle. The launcher reads 160-byte M10 grants and defaults to the dev route. - quic::resolve_ipv4 shared by the client and evo-session-probe - evo-session-probe grants: owner-only bundles of 1-64 grants - evo-server --m10-max-grant-lifetime (dev only, 60..3600 s) - presets client-network/client-package build QUIC; msquic links the CRT fully static; msquic.dll and msquic/OpenSSL licences in the Windows package - client-remote-session test against a loopback region - ADR-0093/0091/0086 amendments, M10_CLIENT_SESSIONS guide, validation Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
96 lines
3.7 KiB
C++
96 lines
3.7 KiB
C++
#pragma once
|
|
#include <array>
|
|
#include <cstddef>
|
|
#include <cstdint>
|
|
#include <expected>
|
|
#include <string>
|
|
#include <string_view>
|
|
#include <vector>
|
|
|
|
// M9.8c launcher model (toolkit- and network-independent). Validates what the user
|
|
// typed, loads the two credential files within bounds, and tracks the connect flow.
|
|
// M10.5c (ADR-0093): grant records are M10 session grants (network::session_grant_bytes),
|
|
// issued by `evo-session-probe grants`; the default endpoint is the dev route (ADR-0087).
|
|
// Error texts are fixed: they never contain file contents, grant bytes or keys, and
|
|
// nothing here is persisted or logged.
|
|
namespace evo::client {
|
|
inline constexpr std::size_t grant_record_bytes = 160; // network::session_grant_bytes.
|
|
inline constexpr std::size_t max_grant_records = 64; // As issued by the probe.
|
|
inline constexpr std::size_t max_authority_bytes = 65536; // One small PEM CA.
|
|
inline constexpr std::size_t max_field_bytes = 1024; // Every text field.
|
|
using GrantRecord = std::array<std::uint8_t, grant_record_bytes>;
|
|
|
|
enum class LaunchError : std::uint8_t {
|
|
endpoint,
|
|
server_name,
|
|
authority_path,
|
|
grants_path,
|
|
authority_unreadable,
|
|
authority_invalid,
|
|
grants_unreadable,
|
|
grants_invalid,
|
|
grant_refused,
|
|
server_unreachable,
|
|
grants_exhausted,
|
|
no_session
|
|
};
|
|
[[nodiscard]] std::string_view launch_error_text(LaunchError error) noexcept;
|
|
|
|
struct ConnectForm {
|
|
std::string endpoint{"void.aeternalisgames.com:7400"}, server_name{"dev-region.evolution.test"};
|
|
std::string authority_path, grants_path;
|
|
};
|
|
struct Endpoint {
|
|
std::string host;
|
|
std::uint16_t port{};
|
|
};
|
|
struct ConnectMaterial {
|
|
Endpoint endpoint;
|
|
std::string server_name, authority_pem;
|
|
std::string authority_path; // The same CA as a file (the QUIC stack loads it too).
|
|
std::vector<GrantRecord> grants;
|
|
};
|
|
// "host:port", "[ipv6]:port" or "a.b.c.d:port"; plain DNS host names only.
|
|
[[nodiscard]] std::expected<Endpoint, LaunchError> parse_endpoint(std::string_view text);
|
|
[[nodiscard]] std::expected<ConnectMaterial, LaunchError> load_connect(const ConnectForm& form);
|
|
|
|
// What the session reports while connecting, reduced to what the launcher decides on.
|
|
enum class ConnectSignal : std::uint8_t {
|
|
welcome, // A session was opened.
|
|
lost, // Transport/TLS failure or deadline before a Close.
|
|
refused, // Closed as unauthenticated/expired/duplicate: this grant cannot work.
|
|
not_ready, // Closed as shutdown/capacity: the session retries later with the next grant.
|
|
exhausted // No unused grant remains.
|
|
};
|
|
enum class LaunchPhase : std::uint8_t { choosing, fixture, connecting, connected, failed };
|
|
class Launcher {
|
|
public:
|
|
static constexpr int max_attempts_without_welcome = 3;
|
|
void start_fixture() noexcept;
|
|
// From choosing or failed (retry). The caller then creates a fresh session.
|
|
[[nodiscard]] bool begin_connect() noexcept;
|
|
// Cancel returns to choosing from connecting, connected or failed; the caller
|
|
// drops its session. Fixture mode also returns to choosing.
|
|
void cancel() noexcept;
|
|
// Lost connections after a welcome are reconnects, not failures; before any
|
|
// welcome, repeated loss means the endpoint, name or CA is wrong.
|
|
void observe(ConnectSignal signal) noexcept;
|
|
void fail(LaunchError error) noexcept;
|
|
[[nodiscard]] LaunchPhase phase() const noexcept {
|
|
return phase_;
|
|
}
|
|
[[nodiscard]] LaunchError error() const noexcept {
|
|
return error_;
|
|
}
|
|
[[nodiscard]] bool ever_connected() const noexcept {
|
|
return welcomed_;
|
|
}
|
|
|
|
private:
|
|
LaunchPhase phase_{LaunchPhase::choosing};
|
|
LaunchError error_{LaunchError::no_session};
|
|
int losses_{};
|
|
bool welcomed_{};
|
|
};
|
|
} // namespace evo::client
|