MailboxWakeLauncher typedef

MailboxWakeLauncher = Future<String?> Function({required String cwd, required String sessionId, String? sessionName})

Session-scoped subagent manager. Launches a detached, non-interactive run of a session so a SLEEPING agent processes its pending inbox mail right away (issue: "if the target is asleep it will never read the message"). Hosts wire the launcher (the CLI spawns its own binary with --session <name>); the run appends to the same session JSONL, so a later interactive fa --session <name> resumes that exact transcript. Null disables the wake path — callers then get a "how to start it" hint instead.

Implementation

typedef MailboxWakeLauncher =
    Future<String?> Function({
      required String cwd,
      required String sessionId,
      String? sessionName,
    });