Session

export type Session = {
  // required
  agentId: string
  cwd: string
  id: string
  status: "cancelled" | "completed" | "failed" | "idle" | "paused" | "pending" | "running" | "stuck" | "waiting"
  updatedAt: number
  // optional
  harnessSessionId?: string
  parentId?: string
  prompt?: string
  resetsAt?: number
  // metadata
  metadata?: {
    branch?: string
    issue?: {
      key: string
      url: string
    }
    pr?: {
      number: number
      url: string
    }
    reason?: string
    task?: "build" | "data" | "debug" | "deploy" | "docs" | "explain" | "explore" | "plan" | "refactor" | "research" | "review" | "security" | "test"
    title?: string
  }
}

type Session = {
  agent?: string
  cost: number
  fork?: {
    readonly sessionID: string
    readonly boundary:
      | { readonly type: "before"; readonly messageID: string }
      | { readonly type: "through"; readonly messageID: string }
  }
  id: string
  location: { readonly directory: string; readonly workspaceID?: string | undefined }
  metadata?: { readonly [x: string]: Json }
  model?: {
    readonly id: string
    readonly providerID: string
    readonly variant?: string | undefined
  }
  outcome?: "failed" | "interrupted" | "succeeded"
  parentID?: string
  permissions?: readonly {
    readonly action: string
    readonly resource: string
    readonly effect: "allow" | "ask" | "deny"
  }[]
  projectID: string
  revert?: {
    readonly messageID: string
    readonly partID?: string | undefined
    readonly snapshot?: string | undefined
    readonly files?:
      | readonly {
          readonly file: string
          readonly patch: string
          readonly additions: number
          readonly deletions: number
          readonly status: "added" | "deleted" | "modified"
        }[]
      | undefined
  }
  subpath?: string
  time: {
    readonly created: number
    readonly updated: number
    readonly idle?: number | undefined
    readonly viewed?: number | undefined
    readonly archived?: number | undefined
  }
  title?: string
  tokens: {
    readonly input: number
    readonly output: number
    readonly reasoning: number
    readonly cache: { readonly read: number; readonly write: number }
  }
}

type SDKSessionInfo = {
  createdAt?: number
  customTitle?: string
  cwd?: string
  fileSize?: number
  firstPrompt?: string
  gitBranch?: string
  lastModified: number
  sessionId: string
  summary: string
  tag?: string
}

type SDKTaskStartedMessage = {
  ambient?: boolean
  description: string
  is_backgrounded?: boolean
  parent_task_id?: string
  prompt?: string
  run_id?: string
  session_id: string
  skip_transcript?: boolean
  spawn_depth?: number
  subagent_type?: string
  subtype: "task_started"
  task_id: string
  task_type?: string
  tool_use_id?: string
  type: "system"
  uuid: `${string}-${string}-${string}-${string}-${string}`
  workflow_name?: string
}

type session = {
  cwd
  id?
  kind
  name?
  pid?
  sessionId?
  startedAt
  state?
  status?
  waitingFor?
}

type AgentToolRunState = {
  agentType: string
  childStillRunning?: boolean
  display?: AgentToolDisplayMetadata
  error?: string
  inputPreview?: unknown
  milestones?: AgentToolMilestone[]
  order: number
  parentToolCallId?: string
  parts: AgentToolRunPart[]
  progress?: AgentToolProgressSnapshot
  reason?: AgentToolInterruptedReason
  runId: string
  status: "aborted" | "completed" | "error" | "interrupted" | "running"
  subAgent: { agent: string; name: string }
  summary?: string
}

type ActiveSubagentState = {
  agentType: string
  displayName?: string
  durationMs?: number
  forked?: boolean
  modelId?: string
  result?: string
  startedAt?: number
  status: "completed" | "error" | "running"
  task: string
  textDelta: string
  toolCalls: { name: string; isError: boolean }[]
}

type Thread = {
  agentNickname: string | null
  agentRole: string | null
  cliVersion: string
  createdAt: number
  cwd: string
  ephemeral: boolean
  forkedFromId: string | null
  gitInfo: GitInfo | null
  historyMode: ThreadHistoryMode
  id: string
  model: string | null
  modelProvider: string
  name: string | null
  originator: string | null
  parentThreadId: string | null
  path: string | null
  preview: string
  projectId: string | null
  reasoningEffort: string | null
  recencyAt: number | null
  section: ThreadSection | null
  sectionEnteredAt: number | null
  sessionId: string
  source: SessionSource
  status: ThreadStatus
  threadSource: string | null
  turns: Turn[]
  updatedAt: number
}

type SessionContext = {
  session: {
    readonly id: string
    readonly auth: SessionAuth
    readonly turn: SessionTurn
    readonly parent?: SessionParent | undefined
    readonly schedule?: SessionSchedule | undefined
    readonly predecessor?: SessionPredecessor | undefined
  }
}

type SessionParent = {
  callId: string
  rootSessionId: string
  sessionId: string
  turn: SessionTurn
}