clide/lib/builtin/claude/src/tmux_session.dart

/// tmux server interactions for Claude panes (D-41 lifecycle).
///
/// `pane.close` only kills the PTY-spawned tmux *client*; tmux is
/// client/server, so the server-side session keeps running after the
/// client disconnects. To honour D-41 ("closing a secondary kills that
/// tmux session" + "secondary numbering resets between clide runs"),
/// we need explicit `tmux kill-session` calls — that's what lives here.
library;

import 'dart:io';

/// Override-able runner so tests don't shell out for real.
typedef TmuxRunner = Future<ProcessResult> Function(List<String> args);

TmuxRunner tmuxRunner = _defaultRunner;

Future<ProcessResult> _defaultRunner(List<String> args) => Process.run('tmux', args);

const _socket = ['-L', 'clide'];

/// Kill the named tmux session on the clide socket. No-op if the
/// session does not exist (kill-session exits non-zero — we ignore it).
Future<void> killSession(String name) async {
  await tmuxRunner([..._socket, 'kill-session', '-t', name]);
}

/// Whether [name] is a live session on the clide socket. Used to suppress
/// a spurious "session exited" when a transient tmux client process exits
/// but the session itself is fine (T-149 follow-up).
Future<bool> hasSession(String name) async {
  final r = await tmuxRunner([..._socket, 'has-session', '-t', name]);
  return r.exitCode == 0;
}

/// Return the names of all sessions currently alive on the clide
/// socket. Empty list if the server is not running.
Future<List<String>> listClideSessions() async {
  final r = await tmuxRunner([..._socket, 'list-sessions', '-F', '#{session_name}']);
  if (r.exitCode != 0) return const [];
  return (r.stdout as String).split('\n').map((s) => s.trim()).where((s) => s.isNotEmpty).toList();
}

/// Kill every secondary clide-claude session whose name begins with
/// [primaryName] and ends with `-<digits>`. Leaves the primary itself
/// alive (D-41).
Future<void> reapSecondaries(String primaryName) async {
  final pattern = RegExp('^${RegExp.escape(primaryName)}-\\d+\$');
  for (final s in await listClideSessions()) {
    if (pattern.hasMatch(s)) {
      await killSession(s);
    }
  }
}

/// Kill every clide-claude session for [primaryName], including the
/// primary itself. Used by the explicit `claude.kill-all-sessions`
/// command when the user wants a hard reset.
Future<void> killAllForRepo(String primaryName) async {
  for (final s in await listClideSessions()) {
    if (s == primaryName || s.startsWith('$primaryName-')) {
      await killSession(s);
    }
  }
}

/// Named tmux paste buffer clide loads composed messages into.
const _composeBuffer = 'clide-compose';

/// Submit [text] to [session] as a single message: load it into a named
/// paste buffer, paste it in bracketed mode (so multi-line content and
/// special characters arrive as one block rather than a stream of
/// submits), then press Enter.
///
/// This goes through the tmux *server*, so it reaches Claude whether or
/// not a client is attached. Writing to the app's spawned client PTY
/// (`pane.write`) does not — once that client detaches, the PTY is dead
/// and keystrokes vanish (the bug this replaces).
Future<void> sendMessage(String session, String text) async {
  await tmuxRunner([..._socket, 'set-buffer', '-b', _composeBuffer, '--', text]);
  await tmuxRunner([..._socket, 'paste-buffer', '-p', '-d', '-b', _composeBuffer, '-t', session]);
  await tmuxRunner([..._socket, 'send-keys', '-t', session, 'Enter']);
}

/// Submit [text] to [session] as TYPED input (literal keystrokes, no bracketed
/// paste), then Enter — so Claude's TUI parses a leading `/` as a slash
/// command, exactly as if the user had typed it (T-153). For single-line
/// slash-command input only; regular messages go through [sendMessage] so
/// bracketed paste keeps multi-line content and stray slashes literal.
Future<void> sendCommand(String session, String text) async {
  await tmuxRunner([..._socket, 'send-keys', '-t', session, '-l', '--', text]);
  await tmuxRunner([..._socket, 'send-keys', '-t', session, 'Enter']);
}