remote.go RawHistoryFolder

1package ports
2
3import (
4	"context"
5
6	"github.com/bnema/vev/internal/domain"
7	"github.com/bnema/vev/internal/protocol/catalogue"
8)
9
10// RemoteHostStore persists pinned and learned remote host targets as
11// registration records. Each record carries a persistent random incarnation
12// so remove/re-add cycles are observable even when the endpoint string is
13// unchanged.
14type RemoteHostStore interface {
15	Hosts() (pinned, learned []domain.RemoteRegistration, err error)
16	AddPinned(target string) error
17	RemovePinned(target string) error
18	Remember(target string) error
19	Forget(target string) error
20	Remove(target string) (deleted bool, err error)
21}
22
23// RemoteCatalogClient fetches a versioned session catalogue from a remote host.
24type RemoteCatalogClient interface {
25	List(ctx context.Context, target string) (catalogue.RemoteCatalog, error)
26}
27
28// RemoteCatalogCache persists complete remote discovery snapshots independently
29// from the remote host registry.
30type RemoteCatalogCache interface {
31	Load() ([]catalogue.RemoteCatalogCacheEntry, error)
32	Store([]catalogue.RemoteCatalogCacheEntry) error
33}
34
35// RemoteEndpointBinding is one endpoint's resolved client carriage: the typed
36// dialer every session on that endpoint attaches through, and the environment
37// to advertise when the remote environment is daemon-owned. It never carries
38// session identity, a resume token, or discovered inventory.
39type RemoteEndpointBinding struct {
40	Dialer      ClientDialer
41	Environment []string
42}
43
44// RemoteEndpointFactory resolves one endpoint into its binding. The composition
45// root implements it from the configured transport mode, the launch allowlist,
46// and the endpoint environment; consumers never inspect those policies.
47type RemoteEndpointFactory interface {
48	ResolveEndpoint(ctx context.Context, endpoint string) (RemoteEndpointBinding, error)
49}
50
51// ClientHostRegistry resolves and caches the endpoint bindings one runner
52// reuses across handoffs. Remote discovery remains daemon-owned.
53type ClientHostRegistry interface {
54	ResolveEndpoint(ctx context.Context, endpoint string) (RemoteEndpointBinding, error)
55}