terminalbinding

package
v1.0.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 12, 2026 License: MIT Imports: 16 Imported by: 0

Documentation

Overview

Package terminalbinding locates a review terminal without changing an agent's launch options.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Snapshot

func Snapshot(ctx context.Context, t Target) (string, error)

Snapshot reads only visible pane text, without scrolling or collecting history.

Types

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) Notify

func (s *Store) Notify(id string, target Target) error

Notify is the tfil intake. Multiple distinct destinations remain ambiguous.

func (*Store) Prepare

func (s *Store) Prepare() (Request, error)

func (*Store) Register

func (s *Store) Register(target Target) error

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 {
	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 pane within one multiplexer instance.

func FromEnvironment

func FromEnvironment() (Target, error)

FromEnvironment is used in the real terminal, never to infer a daemon client's identity.

func (Target) Command

func (t Target) Command(ctx context.Context, args ...string) *exec.Cmd

Command pins every Herdr request to the recorded server, regardless of daemon environment.

func (Target) Validate

func (t Target) Validate() error

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL