Documentation
¶
Overview ¶
Package terminalbinding locates a review terminal without changing an agent's launch options.
Index ¶
- func Remote(target Target, origin Origin) bool
- func Snapshot(ctx context.Context, t Target) (string, error)
- type Origin
- type Request
- type Store
- func (s *Store) Notify(id string, target Target) error
- func (s *Store) Prepare() (Request, error)
- func (s *Store) Register(target Target) error
- func (s *Store) Resolve(ctx context.Context, id string, ...) (Target, error)
- func (s *Store) ResolveNotification(ctx context.Context, id string) (Target, error)
- type Target
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
Types ¶
type Origin ¶ added in v1.2.0
type Origin struct {
PID int `json:"pid,omitempty"`
Started string `json:"started,omitempty"`
SSH bool `json:"ssh,omitempty"`
Terminal string `json:"terminal,omitempty"`
WSLDistribution string `json:"wsl_distribution,omitempty"`
}
Origin records client hints, never SSH addresses or a daemon's environment. Started guards against PID reuse when a marker is resolved later.
func CaptureOrigin ¶ added in v1.2.0
type Request ¶
type Request struct {
ID string `json:"id"`
Marker string `json:"marker"`
ExpiresAt time.Time `json:"expires_at"`
}
Request is the prepare response. Marker must be displayed verbatim before resolving ID.
type Store ¶
type Store struct {
// contains filtered or unexported fields
}
func DefaultStore ¶
func DefaultStore() *Store
func (*Store) Register ¶
Register records only a candidate; the marker is still needed to attribute a review.
func (*Store) Resolve ¶
func (s *Store) Resolve(ctx context.Context, id string, snapshot func(context.Context, Target) (string, error)) (Target, error)
Resolve prefers notifications and otherwise scans only live registrations' visible screens. It consumes the request once a destination is selected, before the caller launches its UI.
type Target ¶
type Target struct {
Origin Origin `json:"origin,omitempty"`
Kind string `json:"kind"`
Socket string `json:"socket"`
Pane string `json:"pane"`
Workspace string `json:"workspace,omitempty"`
Tab string `json:"tab,omitempty"`
}
Target identifies a multiplexer pane or a notifying client outside a multiplexer.
func FromEnvironment ¶
FromEnvironment is used in the real terminal, never to infer a daemon client's identity.