Struct SessionConfig 

pub struct SessionConfig {
    pub route: String,
    pub component: String,
    pub imports: Vec<String>,
    pub limits: Option<HandlerLimits>,
    pub env: BTreeMap<String, String>,
    pub invoke_targets: Vec<String>,
    pub tenancy: Option<Tenancy>,
    pub token_claims: Option<HandlerGraphqlTokenClaims>,
}

A duplex, resumable session route (PLAN-session-primitive): a long-lived, client-addressable, bidirectional channel served by a guest component’s session-handler export, which the host re-enters per inbound frame (mechanism B). The host opens the session on route (SSE-out + POST-in), binds the verified principal, buffers/orders outbound frames with resume-from-cursor, and persists a resumable checkpoint. Frames are opaque bytes. Unlike a StreamConfig (host-only pub/sub fan-out), a session runs guest code and carries a backchannel.

Fields

route: String

Route the session is opened at (the client GETs it for the SSE stream and POSTs inbound frames to it). Matcher syntax, like a handler route.

component: String

Path to the session component .wasm within the deployment (exports session-handler).

imports: Vec<String>

Requested capabilities (interface names; see KNOWN_IMPORTS). A session handler declares session plus whatever sql/orm/invoke/… it uses per frame.

limits: Option<HandlerLimits>

Optional resource limits (capped by site config at activation).

env: BTreeMap<String, String>

Static environment variables (never secrets).

invoke_targets: Vec<String>

Function-to-function invoke allowlist (same contract as a handler’s invoke_targets).

tenancy: Option<Tenancy>

In-site tenancy decision for this session’s sql/orm (Dimension 0). Resolved once at open from the verified source and carried across every re-entry, so a frame-triggered query is host-scoped identically to a normal handler. Absent ⇒ plain (project = database).

token_claims: Option<HandlerGraphqlTokenClaims>

JWKS/issuer verifying the app bearer for a token-sourced tenant (same as a function’s).

Trait Implementations

impl Clone for SessionConfig

fn clone(&self) -> SessionConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SessionConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for SessionConfig

fn default() -> SessionConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SessionConfig

where SessionConfig: Default,

fn deserialize<__D>( __deserializer: __D, ) -> Result<SessionConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for SessionConfig

impl PartialEq for SessionConfig

fn eq(&self, other: &SessionConfig) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for SessionConfig

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SessionConfig