term

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

type Config struct {
	// WorkDir is the cwd every session starts in unless Options.Dir names
	// another — the workspace directory in `gadak serve`.
	WorkDir string
	// Grace is how long a session outlives its last attachment.
	Grace time.Duration
	// MaxDetachedLife caps how long re-arming may keep an unattached
	// session alive. Zero takes DefaultMaxDetachedLife.
	MaxDetachedLife time.Duration
	// RingBytes is the per-session scrollback.
	RingBytes int
	// AttachBytes is the per-attachment backlog bound, in bytes. Zero
	// takes DefaultAttachBytes.
	AttachBytes int
	// AfterFunc is time.AfterFunc, injectable so a test can pin the
	// reconnect grace without sleeping a minute.
	AfterFunc func(time.Duration, func()) *time.Timer
	// Now is time.Now, injectable for the same reason.
	Now func() time.Time
}

type End struct {
	Kind   EndKind
	Code   int
	Reason string
}

type EndKind int

type Info struct {
	ID                 string    `json:"id"`
	PID                int       `json:"pid"`
	Cols               uint16    `json:"cols"`
	Rows               uint16    `json:"rows"`
	Attached           int       `json:"attached"`
	CreatedAt          time.Time `json:"created_at"`
	LastOutputAt       time.Time `json:"last_output_at"`
	BytesOut           int64     `json:"bytes_out"`
	DroppedAttachments int       `json:"dropped_attachments"`
	Exited             bool      `json:"exited"`
	ExitCode           int       `json:"exit_code"`
	// BacklogMaxBytes is the high-water mark of any one attachment's
	// pending backlog over the session's life — the number that answers
	// "was this anywhere near the drop bound?". CoalescedChunks counts
	// how many emits landed on a non-empty backlog, i.e. how often
	// merging actually did work (GDK-1042).
	BacklogMaxBytes int64 `json:"backlog_max_bytes"`
	CoalescedChunks int64 `json:"coalesced_chunks"`
	// PIDs is every process currently on this session's controlling
	// terminal, including the shell. Empty when the enumerator cannot
	// see a tty (Windows, or a pid with no controlling terminal).
	// Filled only by Snapshot — the list path; the create path does not
	// walk the process table (GDK-988).
	PIDs []int `json:"pids,omitempty"`
	// DetachedAt is when this session last lost its final attachment,
	// zero while anything is attached. GraceExtensions counts how many
	// times the reconnect grace re-armed instead of reaping because work
	// was still on the terminal. The pair answers "why is this shell
	// still here" from `gadak terminal list`, without a debugger.
	DetachedAt      time.Time `json:"detached_at"`
	GraceExtensions int       `json:"grace_extensions,omitempty"`
	// Resizes counts the size changes this session has actually applied
	// since it was created — not attempts, and not the create size.
	// Cols/Rows say what the PTY believes; this says whether any client
	// ever corrected it. A pane whose layout settles after it opened its
	// socket has to send one, and "0 here with a pane clearly wider than
	// Cols" is the whole diagnosis of GDK-1154, which otherwise needs a
	// debugger attached to a phone.
	Resizes int `json:"resizes"`
	// NeedsAttention is "this session rang for a person" (GDK-1163): a BEL
	// byte went through the ring and nobody has attached since. It is the
	// only honest answer to "is this blocked or is it working" that the
	// terminal already carries — idleForReap deliberately answers a
	// different question ("may I reap you"), and an agent waiting at a
	// prompt with a child on the tty reads as busy to that one.
	NeedsAttention bool `json:"needs_attention,omitempty"`
	// IssueKey is the issue this session was claimed for, empty when none.
	// It is runtime state and is not persisted anywhere: the binding dies
	// with the session, and the durable record of "who claimed what when"
	// is origin's own claim history (GDK-1158).
	IssueKey string `json:"issue_key,omitempty"`
}

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

type Options struct {
	// Dir overrides Config.WorkDir for this session.
	Dir string
	// Cols and Rows are the initial PTY size. Zero takes 80x24 — a shell
	// with a zero-sized terminal draws nothing and is a support ticket.
	Cols, Rows uint16
	// Env is appended after the inherited environment and the variables
	// this package always sets. Create appends GADAK_TERMINAL_SESSION
	// after it in turn (last duplicate wins), so a session's own id is
	// never maskable from here.
	Env []string
	// Shell overrides $SHELL. The settings catalog's terminal.shell
	// reaches here through handleTerminalCreate (GDK-896); tests use it
	// too.
	Shell string
	// Args are the shell's arguments.
	Args []string
	// TokenID is the pairing token this session was opened with — empty
	// for a loopback client, which needs none. CloseByToken reads it.
	TokenID string
}

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