agent

type Agent struct {
	// contains filtered or unexported fields
}

type ControlPlaneRuntimeStatus struct {
	Enabled        bool
	Connected      bool
	Connectable    bool
	Label          string
	DisabledReason string
}

type ControlPlaneSetup struct {
	ProviderOrigin    string
	AccessPointOrigin string
	EnvironmentID     string
	BootstrapTicket   string
}

type LocalDirectSessionOptions struct {
	AccessUnlocked            bool
	TraceID                   string
	ConnectArtifactIssuedAtMs int64
}

type Options struct {
	Config *config.Config
	// ConfigPath is the path used to load the config file (used to derive state_dir).
	ConfigPath string
	StateRoot  string
	// InstanceID is a per-process runtime identity used by desktop lifecycle diagnostics.
	InstanceID string
	// LocalUIBind is the requested Local UI bind address before dynamic port resolution.
	LocalUIBind string
	// LocalUIEnabled indicates Local UI is enabled (e.g. `redeven run --mode hybrid|local`).
	//
	// When enabled, the agent is allowed to start even without a full bootstrap config.
	LocalUIEnabled bool
	// ControlChannelEnabled indicates whether the agent should connect to the control-plane control channel.
	//
	// In Local mode, this should be false even when the config is fully bootstrapped.
	ControlChannelEnabled bool
	// DesktopManaged disables CLI self-upgrade behaviors that do not apply when the
	// agent lifecycle is owned by a desktop shell package.
	DesktopManaged bool
	// EffectiveRunMode reports the current runtime mode exposed to the UI/control plane.
	EffectiveRunMode string
	// RemoteEnabled reports whether the current process has the remote control channel enabled.
	RemoteEnabled bool
	// LogOutput overrides the default runtime log sink.
	//
	// IMPORTANT: callers that reserve stdout for a machine protocol must pass
	// a non-stdout sink so agent services cannot corrupt the protocol stream.
	LogOutput io.Writer

	Version   string
	Commit    string
	BuildTime string

	// OnControlConnected is called once after the agent successfully connects to the
	// remote control channel and completes the initial register call.
	//
	// This hook is intended for CLI UX (e.g., printing the environment access URL)
	// and must not be used for authorization decisions.
	OnControlConnected func()
	// OnControlConnecting is called before a control-channel connection attempt.
	OnControlConnecting func()
	// OnControlRetry is called after a failed control-channel attempt with the retry delay.
	OnControlRetry func(error, time.Duration)
	// OnControlDisabled is called when the runtime starts without a control channel.
	OnControlDisabled func()

	AccessGate *accessgate.Gate
}

type ProviderLinkError struct {
	Code    string
	Message string
	Err     error
}

type ProviderLinkRequest struct {
	ProviderOrigin            string
	ProviderID                string
	EnvPublicID               string
	AccessPointOrigin         string
	BootstrapTicket           string
	ExpectedProviderOrigin    string
	ExpectedProviderID        string
	ExpectedEnvPublicID       string
	ExpectedAccessPointOrigin string
	ExpectedGeneration        int64
	AllowRelinkWhenIdle       bool
	// contains filtered or unexported fields
}

type ProviderLinkResponse struct {
	Binding runtimeservice.ProviderLinkBinding
}

type RuntimePresentationSession struct {
	ChannelID string

	UserPublicID string
	UserEmail    string

	FloeApp     string
	CodeSpaceID string
	SessionKind string
	TunnelURL   string

	CreatedAtUnixMs   int64
	ConnectedAtUnixMs int64

	CanRead    bool
	CanWrite   bool
	CanExecute bool
}