Function openTerminal

desktop/terminal/manager.ts:111–173

(request: TerminalOpenRequest)

}

export async function openTerminal(request: TerminalOpenRequest): Promise<TerminalSessionSnapshot> {
  const cwd = request.cwd ?? request.projectId
  const sessionId = makeSessionId(request)
  const existing = getTerminalSession(sessionId)

  if (existing) {
    existing.snapshot = {
      ...existing.snapshot,
      cols: request.cols,
      rows: request.rows,
      updatedAt: nowIso(),
    }

    if (existing.process) {
      existing.process.resize(request.cols, request.rows)
    } else if (isRestartableTerminalStatus(existing.snapshot.status)) {
      existing.snapshot = {
        ...existing.snapshot,
        status: 'starting',
        exitCode: null,
        exitSignal: null,
        updatedAt: nowIso(),
      }
      void ensureProcessStarted(existing, 'restarted')
    }

    return existing.snapshot
  }

  const history = readTranscript(getTranscriptPath(sessionId))
  const snapshot: TerminalSessionSnapshot = {
    sessionId,
    projectId: request.projectId,
    sessionPath: request.sessionPath ?? null,
    cwd,
    launchMode: request.launchMode ?? 'shell',
    status: 'starting',
    pid: null,
    cols: request.cols,
    rows: request.rows,
    history,
    hasVisibleContent:
      (request.launchMode ?? 'shell') === 'shell' || hasVisibleTerminalContent(history),
    exitCode: null,
    exitSignal: null,
    updatedAt: nowIso(),
  }

  const record: TerminalSessionRecord = {
    snapshot,
    process: null,
    restartPromise: null,
    transcriptPath: getTranscriptPath(sessionId),
    inputBuffer: '',
    suppressOutputVisibilityUntilInput: false,
    persistTimer: null,
    cleanup: [],
  }