adapter

type Adapter ¶

type Adapter interface {
	Name() string
	Probe(ctx context.Context, target string) error
	Inject(ctx context.Context, target string, payload string) error
}

type Cmux ¶

type Cmux struct {
	Runner       CommandRunner
	Path         string
	Getenv       func(string) string
	LookPath     func(string) (string, error)
	UserHomeDir  func() (string, error)
	IsExecutable func(string) bool
	Sleep        func(context.Context, time.Duration) error
	SettleDelay  time.Duration
	// LiveTTYOwnerCount reports how many live (non-zombie) processes hold the
	// device at devPath as their controlling terminal. Defaults to the darwin
	// sysctl implementation; tests inject a fake so they never run a real
	// sysctl against fixture tty names.
	LiveTTYOwnerCount func(devPath string) (int, error)
	// Logf receives non-fatal diagnostics (evictions, degraded fail-closed
	// ttys). Nil is a no-op.
	Logf func(format string, args ...any)
	// contains filtered or unexported fields
}

func (c Cmux) Discover(_ context.Context) (string, error)

func (c Cmux) Inject(ctx context.Context, target string, payload string) error

func (c Cmux) Inventory(ctx context.Context, _ OwnershipContext) (TargetInventory, error)

func (Cmux) Name() string

func (Cmux) NormalizeTarget(target string) (string, error)

func (c Cmux) Probe(ctx context.Context, target string) error

type CommandRunner ¶

type CommandRunner interface {
	Run(ctx context.Context, name string, args ...string) ([]byte, error)
}

type Discoverer ¶

type Discoverer interface {
	Discover(ctx context.Context) (string, error)
}

type ExecRunner ¶

type ExecRunner struct{}

func (ExecRunner) Run(ctx context.Context, name string, args ...string) ([]byte, error)

type File ¶

type File struct{}

func (File) Inject(ctx context.Context, target string, payload string) error

func (File) Name() string

func (File) NormalizeTarget(target string) (string, error)

func (File) Probe(ctx context.Context, target string) error

type Ghostty ¶

type Ghostty struct {
	Runner CommandRunner
}

func (g Ghostty) Discover(ctx context.Context) (string, error)

func (g Ghostty) Inject(ctx context.Context, target string, payload string) error

func (Ghostty) Name() string

func (Ghostty) NormalizeTarget(target string) (string, error)

func (g Ghostty) Probe(ctx context.Context, target string) error

type InventoryProvider ¶

type InventoryProvider interface {
	Inventory(ctx context.Context, own OwnershipContext) (TargetInventory, error)
}

InventoryProvider lets the supervisor inventory an adapter once per pass instead of spawning one probe process for every registry entry. The OwnershipContext lets the registration preflight pass a trusted-live candidate; other callers pass the zero value.

type OwnershipContext ¶

type OwnershipContext struct {
	// TrustedTarget is the adapter-native target string (e.g. a cmux surface
	// target) the caller has proven live. Empty means no trusted candidate.
	TrustedTarget string
}

OwnershipContext carries optional trust the caller has already established about a candidate target. Only the registration preflight may populate it: the target it is registering was discovered from the live local surface, so it is live by construction and can break an otherwise-ambiguous physical ownership tie. Supervisor and inject passes pass the zero value, which trusts nothing.

type Registry ¶

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

func DefaultRegistry() Registry

func DefaultRegistryWithLogf(logf func(format string, args ...any)) Registry

func NewRegistry(adapters ...Adapter) Registry

func (r Registry) Get(name string) (Adapter, error)

type TargetInventory ¶

type TargetInventory interface {
	Probe(target string) error
	OwnershipKey(target string) (string, error)
}

TargetInventory is a point-in-time existence snapshot. Implementations must return ErrTargetNotFound only when absence is proven by the snapshot; parse, transport, and permission failures remain ambiguous errors. When ownership is degraded, callers remain fail-closed unless a concrete adapter-specific capability proves that the same immutable inventory also established a different physical identity. The generic interface deliberately exposes no constructor for such a capability.

type TargetNormalizer ¶

type TargetNormalizer interface {
	NormalizeTarget(target string) (string, error)
}