Module debug_session 

Wire shapes for alien debug sessions.

These types are the contract between the CLI, the manager (push mode), and the agent (pull mode). Pure data + a small AWS-host parser; no cloud-client dependencies, so any layer in the dep graph can speak them.

The credential translator — projecting a resolved crate::ClientConfig onto a DebugSessionResponse::Push payload — lives in alien-platform-core, one tier above the cloud-client crates.

Structs

DebugCredFile

PendingDebugSession

Async-session handle. The CLI polls poll_url until the manager has received the agent’s tunnel-ready signal and can return a Pull payload whose kubeconfig points at the per-session HTTPS proxy on the manager.

PullDebugSession

PushDebugSession

PushTunnelDebugSession

RuntimeTunnelDebugSession

Enums

DebugSessionError

Errors raised by the debug-session producer (manager or agent). Callers wrap into their own error type when surfacing across crate boundaries.

DebugSessionKind

What kind of debug session the caller is requesting.

DebugSessionResponse

Wire response. Discriminated by kind. Identical shape on both ends so the CLI can deserialize a session regardless of who produced it (manager or agent).

RuntimeAgentFrame

Agent-to-client runtime debug frames, relayed by the manager.

RuntimeClientFrame

Client-to-agent runtime debug frames, relayed by the manager.

Functions

extract_aws_service_and_region

Derive (service, signing_region) from an AWS API URL host.