import type { SessionMessage, Settings } from 'claude-code'

/**
 * What the world beneath a repository session holds and answers besides
 * git.
 *
 * The store, the settings, the environment, the transcript, whether a pane
 * is seated, whether a hunks read is refused.
 */
export type Beneath = {
  /**
   * What the plugin's store holds at the start; nothing when not given.
   */
  stored?: Readonly<Record<string, unknown>>

  /**
   * What `$.settings.read` answers; empty when not given.
   */
  settings?: Settings

  /**
   * The variables `$.env.get` answers from; none set when not given.
   */
  env?: Readonly<Record<string, string>>

  /**
   * What `$.session.messages` answers each time it is read, as a resumed
   * session's transcript already holds turns; empty when not given.
   */
  messages?: () => readonly SessionMessage[]

  /**
   * Whether an open made now is left waiting undrawn (LEFT_WAITING), as an
   * engine leaves an unasked open on a narrow terminal; placed when not given.
   */
  isLeftWaiting?: () => boolean

  /**
   * Whether an open made now is kept with nothing attached to draw it
   * (LEFT_UNSEEN), as before a host's page attaches; placed when not given.
   */
  isLeftUnseen?: () => boolean

  /**
   * Why a hunks read asked now is refused, as the host refuses a git that
   * outran its timeout; answered from the script when null or not given.
   */
  hunksRefusal?: () => string | null
}