@elefunc/send 0.1.6 → 0.1.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elefunc/send",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Browser-compatible file transfer CLI and TUI powered by Bun, WebRTC, and Rezi.",
   "license": "MIT",
   "type": "module",

package/src/core/session.ts

@@ -492,6 +492,20 @@ export class SendSession {
     return sent
   }
 
+  shareTurnWithPeers(peerIds: string[]) {
+    if (!this.extraTurnServers.length) return 0
+    const iceServers = this.sharedTurnServers()
+    const sentPeers: string[] = []
+    for (const peerId of new Set(peerIds.filter(Boolean))) {
+      const peer = this.peers.get(peerId)
+      if (!peer || peer.presence !== "active") continue
+      if (!this.sendSignal({ kind: "turn-share", to: peer.id, iceServers })) continue
+      sentPeers.push(peer.id)
+    }
+    if (sentPeers.length) this.pushLog("turn:share-sent", { peers: sentPeers.length, scope: "filtered", peerIds: sentPeers }, "info")
+    return sentPeers.length
+  }
+
   shareTurnWithAllPeers() {
     const count = this.activePeers().length
     if (!count || !this.extraTurnServers.length) return 0

package/src/index.ts

@@ -37,11 +37,45 @@ const waitPeerTimeout = (value: unknown) => {
   if (!Number.isFinite(parsed) || parsed < 0) throw new ExitError("--wait-peer must be a finite non-negative number of milliseconds", 1)
   return parsed
 }
+const BINARY_OPTION_FLAGS = {
+  clean: "--clean",
+  accept: "--accept",
+  offer: "--offer",
+  save: "--save",
+} as const
+type BinaryOptionKey = keyof typeof BINARY_OPTION_FLAGS
+const binaryOption = (value: unknown, flag: string) => {
+  if (value == null) return undefined
+  if (value === 1 || value === "1") return true
+  if (value === 0 || value === "0") return false
+  throw new ExitError(`${flag} must be 0 or 1`, 1)
+}
+const parseBinaryOptions = <K extends BinaryOptionKey>(options: Record<string, unknown>, keys: readonly K[]) =>
+  Object.fromEntries(keys.map(key => [key, binaryOption(options[key], BINARY_OPTION_FLAGS[key])])) as Record<K, boolean | undefined>
 
 const SELF_ID_LENGTH = 8
 const SELF_ID_PATTERN = new RegExp(`^[a-z0-9]{${SELF_ID_LENGTH}}$`)
 const SELF_HELP_TEXT = "self identity: name, name-ID, or -ID (use --self=-ID)"
 const INVALID_SELF_ID_MESSAGE = `--self ID suffix must be exactly ${SELF_ID_LENGTH} lowercase alphanumeric characters`
+type CliCommand = ReturnType<CAC["command"]>
+const ROOM_SELF_OPTIONS = [
+  ["--room <room>", "room id; omit to create a random room"],
+  ["--self <self>", SELF_HELP_TEXT],
+] as const
+const TURN_OPTIONS = [
+  ["--turn-url <url>", "custom TURN url, repeat or comma-separate"],
+  ["--turn-username <value>", "custom TURN username"],
+  ["--turn-credential <value>", "custom TURN credential"],
+] as const
+const SAVE_DIR_OPTION = ["--save-dir <dir>", "save directory"] as const
+const TUI_TOGGLE_OPTIONS = [
+  ["--clean <0|1>", "show only active peers when 1; show terminal peers too when 0"],
+  ["--accept <0|1>", "auto-accept incoming offers: 1 on, 0 off"],
+  ["--offer <0|1>", "auto-offer drafts to matching ready peers: 1 on, 0 off"],
+  ["--save <0|1>", "auto-save completed incoming files: 1 on, 0 off"],
+] as const
+const addOptions = (command: CliCommand, definitions: readonly (readonly [string, string])[]) =>
+  definitions.reduce((next, [flag, description]) => next.option(flag, description), command)
 
 const requireSelfId = (value: string) => {
   if (!SELF_ID_PATTERN.test(value)) throw new ExitError(INVALID_SELF_ID_MESSAGE, 1)
@@ -61,12 +95,13 @@ const parseSelfOption = (value: unknown): Pick<SessionConfig, "name" | "localId"
 export const sessionConfigFrom = (options: Record<string, unknown>, defaults: { autoAcceptIncoming?: boolean; autoSaveIncoming?: boolean }): SessionConfig & { room: string } => {
   const room = cleanRoom(firstNonEmptyText(options.room, process.env.SEND_ROOM))
   const self = parseSelfOption(options.self ?? process.env.SEND_SELF)
+  const { accept, save } = parseBinaryOptions(options, ["accept", "save"] as const)
   return {
     room,
     ...self,
     saveDir: resolve(`${options.saveDir ?? process.env.SEND_SAVE_DIR ?? "downloads"}`),
-    autoAcceptIncoming: defaults.autoAcceptIncoming ?? false,
-    autoSaveIncoming: defaults.autoSaveIncoming ?? false,
+    autoAcceptIncoming: accept ?? defaults.autoAcceptIncoming ?? false,
+    autoSaveIncoming: save ?? defaults.autoSaveIncoming ?? false,
     turnUrls: splitList(options.turnUrl ?? process.env.SEND_TURN_URL),
     turnUsername: `${options.turnUsername ?? process.env.SEND_TURN_USERNAME ?? ""}`.trim() || undefined,
     turnCredential: `${options.turnCredential ?? process.env.SEND_TURN_CREDENTIAL ?? ""}`.trim() || undefined,
@@ -218,8 +253,13 @@ const acceptCommand = async (options: Record<string, unknown>) => {
 
 const tuiCommand = async (options: Record<string, unknown>) => {
   const initialConfig = sessionConfigFrom(options, { autoAcceptIncoming: true, autoSaveIncoming: true })
+  const { clean, offer } = parseBinaryOptions(options, ["clean", "offer"] as const)
   const { startTui } = await loadTuiRuntime()
-  await startTui(initialConfig, !!options.events)
+  await startTui(initialConfig, {
+    events: !!options.events,
+    clean: clean ?? true,
+    offer: offer ?? true,
+  })
 }
 
 type CliHandlers = {
@@ -240,53 +280,38 @@ export const createCli = (handlers: CliHandlers = defaultCliHandlers) => {
   const cli = cac("send")
   cli.usage("[command] [options]")
 
-  cli
-    .command("peers", "list discovered peers")
-    .option("--room <room>", "room id; omit to create a random room")
-    .option("--self <self>", SELF_HELP_TEXT)
-    .option("--wait <ms>", "discovery wait in milliseconds")
-    .option("--json", "print a json snapshot")
-    .option("--save-dir <dir>", "save directory")
-    .option("--turn-url <url>", "custom TURN url, repeat or comma-separate")
-    .option("--turn-username <value>", "custom TURN username")
-    .option("--turn-credential <value>", "custom TURN credential")
-    .action(handlers.peers)
-
-  cli
-    .command("offer [...files]", "offer files to browser-compatible peers")
-    .option("--room <room>", "room id; omit to create a random room")
-    .option("--self <self>", SELF_HELP_TEXT)
-    .option("--to <peer>", "target peer id or name-suffix, or `.` for all ready peers; default: `.`")
-    .option("--wait-peer <ms>", "wait for eligible peers in milliseconds; omit to wait indefinitely")
-    .option("--json", "emit ndjson events")
-    .option("--save-dir <dir>", "save directory")
-    .option("--turn-url <url>", "custom TURN url, repeat or comma-separate")
-    .option("--turn-username <value>", "custom TURN username")
-    .option("--turn-credential <value>", "custom TURN credential")
-    .action(handlers.offer)
-
-  cli
-    .command("accept", "receive and save files")
-    .option("--room <room>", "room id; omit to create a random room")
-    .option("--self <self>", SELF_HELP_TEXT)
-    .option("--save-dir <dir>", "save directory")
-    .option("--once", "exit after the first saved incoming transfer")
-    .option("--json", "emit ndjson events")
-    .option("--turn-url <url>", "custom TURN url, repeat or comma-separate")
-    .option("--turn-username <value>", "custom TURN username")
-    .option("--turn-credential <value>", "custom TURN credential")
-    .action(handlers.accept)
-
-  cli
-    .command("tui", "launch the interactive terminal UI")
-    .option("--room <room>", "room id; omit to create a random room")
-    .option("--self <self>", SELF_HELP_TEXT)
-    .option("--events", "show the event log pane")
-    .option("--save-dir <dir>", "save directory")
-    .option("--turn-url <url>", "custom TURN url, repeat or comma-separate")
-    .option("--turn-username <value>", "custom TURN username")
-    .option("--turn-credential <value>", "custom TURN credential")
-    .action(handlers.tui)
+  addOptions(cli.command("peers", "list discovered peers"), [
+    ...ROOM_SELF_OPTIONS,
+    ["--wait <ms>", "discovery wait in milliseconds"],
+    ["--json", "print a json snapshot"],
+    SAVE_DIR_OPTION,
+    ...TURN_OPTIONS,
+  ]).action(handlers.peers)
+
+  addOptions(cli.command("offer [...files]", "offer files to browser-compatible peers"), [
+    ...ROOM_SELF_OPTIONS,
+    ["--to <peer>", "target peer id or name-suffix, or `.` for all ready peers; default: `.`"],
+    ["--wait-peer <ms>", "wait for eligible peers in milliseconds; omit to wait indefinitely"],
+    ["--json", "emit ndjson events"],
+    SAVE_DIR_OPTION,
+    ...TURN_OPTIONS,
+  ]).action(handlers.offer)
+
+  addOptions(cli.command("accept", "receive and save files"), [
+    ...ROOM_SELF_OPTIONS,
+    SAVE_DIR_OPTION,
+    ["--once", "exit after the first saved incoming transfer"],
+    ["--json", "emit ndjson events"],
+    ...TURN_OPTIONS,
+  ]).action(handlers.accept)
+
+  addOptions(cli.command("tui", "launch the interactive terminal UI"), [
+    ...ROOM_SELF_OPTIONS,
+    ...TUI_TOGGLE_OPTIONS,
+    ["--events", "show the event log pane"],
+    SAVE_DIR_OPTION,
+    ...TURN_OPTIONS,
+  ]).action(handlers.tui)
 
   cli.help(sections => {
     const usage = sections.find(section => section.title === "Usage:")

package/src/tui/app.ts

@@ -1,3 +1,4 @@
+import { resolve } from "node:path"
 import { rgb, ui, type BadgeVariant, type VNode } from "@rezi-ui/core"
 import { createNodeApp } from "@rezi-ui/node"
 import { inspectLocalFile } from "../core/files"
@@ -37,6 +38,7 @@ type DenseSectionOptions = {
   border?: "rounded" | "single" | "none"
   flex?: number
 }
+type TuiLaunchOptions = { events?: boolean; clean?: boolean; offer?: boolean }
 
 export type VisiblePane = "peers" | "transfers" | "logs"
 
@@ -45,6 +47,8 @@ export interface TuiState {
   sessionSeed: SessionSeed
   peerSelectionByRoom: Map<string, Map<string, boolean>>
   snapshot: SessionSnapshot
+  aboutOpen: boolean
+  peerSearch: string
   focusedId: string | null
   roomInput: string
   nameInput: string
@@ -66,12 +70,15 @@ export interface TuiState {
 
 export interface TuiActions {
   toggleEvents: TuiAction
+  openAbout: TuiAction
+  closeAbout: TuiAction
   jumpToRandomRoom: TuiAction
   commitRoom: TuiAction
   setRoomInput: (value: string) => void
   jumpToNewSelf: TuiAction
   commitName: TuiAction
   setNameInput: (value: string) => void
+  setPeerSearch: (value: string) => void
   toggleSelectReadyPeers: TuiAction
   clearPeerSelection: TuiAction
   toggleHideTerminalPeers: TuiAction
@@ -97,12 +104,22 @@ export interface TuiActions {
 
 const ROOM_INPUT_ID = "room-input"
 const NAME_INPUT_ID = "name-input"
+const PEER_SEARCH_INPUT_ID = "peer-search-input"
 const DRAFT_INPUT_ID = "draft-input"
+const ABOUT_TRIGGER_ID = "open-about"
 const TRANSPARENT_BORDER_STYLE = { fg: rgb(7, 10, 12) } as const
 const METRIC_BORDER_STYLE = { fg: rgb(20, 25, 32) } as const
 const PRIMARY_TEXT_STYLE = { fg: rgb(255, 255, 255) } as const
 const HEADING_TEXT_STYLE = { fg: rgb(255, 255, 255), bold: true } as const
 const DEFAULT_WEB_URL = "https://send.rt.ht/"
+const DEFAULT_SAVE_DIR = resolve(process.cwd(), "downloads")
+const ABOUT_ELEFUNC_URL = "https://elefunc.com"
+const ABOUT_TITLE = "About Send"
+const ABOUT_INTRO = "Room-based peer-to-peer file transfers for the web and terminal"
+const ABOUT_SUMMARY = "Join the same room, see who is there, and offer files directly to selected peers."
+const ABOUT_RUNTIME = "Send uses lightweight signaling to discover peers and negotiate WebRTC. Files move over WebRTC data channels, using direct paths when possible and TURN relay when needed."
+const ABOUT_CLI_LABEL = "bunx @elefunc/send@latest"
+const ABOUT_WEB_LINK_LABEL = "Web"
 const TRANSFER_DIRECTION_ARROW = {
   out: { glyph: "↗", style: { fg: rgb(170, 217, 76), bold: true } },
   in: { glyph: "↙", style: { fg: rgb(240, 113, 120), bold: true } },
@@ -118,6 +135,45 @@ export const visiblePanes = (showEvents: boolean): VisiblePane[] => showEvents ?
 const noop = () => {}
 
 const hashBool = (value: boolean) => value ? "1" : "0"
+const safeShellArgPattern = /^[A-Za-z0-9._/:?=&,+@%-]+$/
+const TUI_QUIT_SIGNALS = ["SIGINT", "SIGTERM", "SIGHUP"] as const
+type TuiQuitSignal = (typeof TUI_QUIT_SIGNALS)[number]
+type ProcessSignalLike = {
+  on?: (signal: TuiQuitSignal, handler: () => void) => unknown
+  off?: (signal: TuiQuitSignal, handler: () => void) => unknown
+  removeListener?: (signal: TuiQuitSignal, handler: () => void) => unknown
+}
+type ShareUrlState = Pick<TuiState, "snapshot" | "hideTerminalPeers" | "autoAcceptIncoming" | "autoOfferOutgoing" | "autoSaveIncoming">
+type ShareCliState = ShareUrlState & Pick<TuiState, "sessionSeed" | "eventsExpanded">
+const shellQuote = (value: string) => safeShellArgPattern.test(value) ? value : `'${value.replaceAll("'", `'\"'\"'`)}'`
+const appendCliFlag = (args: string[], flag: string, value?: string | null) => {
+  const text = `${value ?? ""}`.trim()
+  if (!text) return
+  args.push(flag, shellQuote(text))
+}
+const SHARE_TOGGLE_FLAGS = [
+  ["clean", "hideTerminalPeers", "--clean"],
+  ["accept", "autoAcceptIncoming", "--accept"],
+  ["offer", "autoOfferOutgoing", "--offer"],
+  ["save", "autoSaveIncoming", "--save"],
+] as const satisfies readonly (readonly [string, keyof ShareUrlState, string])[]
+const appendToggleCliFlags = (args: string[], state: ShareUrlState) => {
+  for (const [, stateKey, flag] of SHARE_TOGGLE_FLAGS) if (!state[stateKey]) appendCliFlag(args, flag, "0")
+}
+const buildHashParams = (state: ShareUrlState, omitDefaults = false) => {
+  const params = new URLSearchParams({ room: cleanRoom(state.snapshot.room) })
+  for (const [key, stateKey] of SHARE_TOGGLE_FLAGS) if (!omitDefaults || !state[stateKey]) params.set(key, hashBool(state[stateKey]))
+  return params
+}
+const shareTurnCliArgs = (sessionSeed: SessionSeed) => {
+  const turnUrls = [...new Set((sessionSeed.turnUrls ?? []).map(url => `${url ?? ""}`.trim()).filter(Boolean))]
+  if (!turnUrls.length) return []
+  const args: string[] = []
+  for (const turnUrl of turnUrls) appendCliFlag(args, "--turn-url", turnUrl)
+  appendCliFlag(args, "--turn-username", sessionSeed.turnUsername)
+  appendCliFlag(args, "--turn-credential", sessionSeed.turnCredential)
+  return args
+}
 
 export const resolveWebUrlBase = (value = process.env.SEND_WEB_URL) => {
   const candidate = `${value ?? ""}`.trim() || DEFAULT_WEB_URL
@@ -128,29 +184,82 @@ export const resolveWebUrlBase = (value = process.env.SEND_WEB_URL) => {
   }
 }
 
-export const webInviteUrl = (
-  state: Pick<TuiState, "snapshot" | "hideTerminalPeers" | "autoAcceptIncoming" | "autoOfferOutgoing" | "autoSaveIncoming">,
-  baseUrl = resolveWebUrlBase(),
-) => {
+const renderWebUrl = (state: ShareUrlState, baseUrl = DEFAULT_WEB_URL, omitDefaults = true) => {
   const url = new URL(baseUrl)
-  url.hash = new URLSearchParams({
-    room: cleanRoom(state.snapshot.room),
-    clean: hashBool(state.hideTerminalPeers),
-    accept: hashBool(state.autoAcceptIncoming),
-    offer: hashBool(state.autoOfferOutgoing),
-    save: hashBool(state.autoSaveIncoming),
-  }).toString()
+  url.hash = buildHashParams(state, omitDefaults).toString()
   return url.toString()
 }
+const renderCliCommand = (state: ShareCliState, { includeSelf = false, includePrefix = false } = {}) => {
+  const args = includePrefix ? ["bunx", "@elefunc/send@latest"] : []
+  appendCliFlag(args, "--room", state.snapshot.room)
+  if (includeSelf) appendCliFlag(args, "--self", displayPeerName(state.snapshot.name, state.snapshot.localId))
+  appendToggleCliFlags(args, state)
+  if (state.eventsExpanded) args.push("--events")
+  if (resolve(state.snapshot.saveDir) !== DEFAULT_SAVE_DIR) appendCliFlag(args, "--save-dir", state.snapshot.saveDir)
+  args.push(...shareTurnCliArgs(state.sessionSeed))
+  return args.join(" ")
+}
+
+export const webInviteUrl = (state: ShareUrlState, baseUrl = resolveWebUrlBase()) => {
+  return renderWebUrl(state, baseUrl, false)
+}
+
+export const aboutWebUrl = (state: ShareUrlState, baseUrl = DEFAULT_WEB_URL) => renderWebUrl(state, baseUrl)
+
+export const aboutWebLabel = (state: ShareUrlState, baseUrl = DEFAULT_WEB_URL) => aboutWebUrl(state, baseUrl).replace(/^https:\/\//, "")
+
+export const aboutCliCommand = (state: ShareCliState) => renderCliCommand(state)
+
+export const resumeWebUrl = (state: ShareUrlState, baseUrl = DEFAULT_WEB_URL) => renderWebUrl(state, baseUrl)
+
+export const resumeCliCommand = (state: ShareCliState) => renderCliCommand(state, { includeSelf: true, includePrefix: true })
+
+export const resumeOutputLines = (state: ShareCliState) => [
+  "Rejoin with:",
+  "",
+  "Web",
+  resumeWebUrl(state),
+  "",
+  "CLI",
+  resumeCliCommand(state),
+  "",
+]
+
+export const createQuitController = (processLike: ProcessSignalLike | null = process) => {
+  let settled = false
+  let resolvePromise = () => {}
+  const promise = new Promise<void>(resolve => { resolvePromise = resolve })
+  const requestStop = () => {
+    if (settled) return false
+    settled = true
+    resolvePromise()
+    return true
+  }
+  const handler = () => { requestStop() }
+  for (const signal of TUI_QUIT_SIGNALS) processLike?.on?.(signal, handler)
+  return {
+    promise,
+    requestStop,
+    detach: () => {
+      for (const signal of TUI_QUIT_SIGNALS) {
+        processLike?.off?.(signal, handler)
+        processLike?.removeListener?.(signal, handler)
+      }
+    },
+  }
+}
 
 export const createNoopTuiActions = (): TuiActions => ({
   toggleEvents: noop,
+  openAbout: noop,
+  closeAbout: noop,
   jumpToRandomRoom: noop,
   commitRoom: noop,
   setRoomInput: noop,
   jumpToNewSelf: noop,
   commitName: noop,
   setNameInput: noop,
+  setPeerSearch: noop,
   toggleSelectReadyPeers: noop,
   clearPeerSelection: noop,
   toggleHideTerminalPeers: noop,
@@ -206,6 +315,16 @@ const transferStatusKind = (status: TransferSnapshot["status"]) => ({
   error: "offline",
 }[status] || "unknown") as "online" | "offline" | "away" | "busy" | "unknown"
 const visiblePeers = (peers: PeerSnapshot[], hideTerminalPeers: boolean) => hideTerminalPeers ? peers.filter(peer => peer.presence === "active") : peers
+const peerSearchNeedle = (value: string) => `${value ?? ""}`.trim().toLowerCase()
+const peerMatchesSearch = (peer: PeerSnapshot, search: string) => !search || peer.displayName.toLowerCase().includes(search)
+export const renderedPeers = (peers: PeerSnapshot[], hideTerminalPeers: boolean, search: string) => {
+  const needle = peerSearchNeedle(search)
+  return visiblePeers(peers, hideTerminalPeers)
+    .filter(peer => peerMatchesSearch(peer, needle))
+    .sort((left, right) => left.id.localeCompare(right.id))
+}
+export const renderedReadySelectedPeers = (peers: PeerSnapshot[], hideTerminalPeers: boolean, search: string) =>
+  renderedPeers(peers, hideTerminalPeers, search).filter(peer => peer.selected && peer.ready)
 const transferProgress = (transfer: TransferSnapshot) => Math.max(0, Math.min(1, transfer.progress / 100))
 const isPendingOffer = (transfer: TransferSnapshot) => transfer.direction === "out" && (transfer.status === "queued" || transfer.status === "offered")
 const statusVariant = (status: TransferSnapshot["status"]): BadgeVariant => ({
@@ -467,7 +586,7 @@ export const groupTransfersByPeer = (transfers: TransferSnapshot[], peers: PeerS
   return [...groups.values()]
 }
 
-export const createInitialTuiState = (initialConfig: SessionConfig, showEvents = false): TuiState => {
+export const createInitialTuiState = (initialConfig: SessionConfig, showEvents = false, launchOptions: Pick<TuiLaunchOptions, "clean" | "offer"> = {}): TuiState => {
   const sessionSeed = normalizeSessionSeed(initialConfig)
   const autoAcceptIncoming = initialConfig.autoAcceptIncoming ?? true
   const autoSaveIncoming = initialConfig.autoSaveIncoming ?? true
@@ -479,6 +598,8 @@ export const createInitialTuiState = (initialConfig: SessionConfig, showEvents =
     sessionSeed,
     peerSelectionByRoom,
     snapshot: session.snapshot(),
+    aboutOpen: false,
+    peerSearch: "",
     focusedId: null,
     roomInput: sessionSeed.room,
     nameInput: visibleNameInput(sessionSeed.name),
@@ -487,10 +608,10 @@ export const createInitialTuiState = (initialConfig: SessionConfig, showEvents =
     draftInputKeyVersion: 0,
     filePreview: emptyFilePreviewState(),
     drafts: [],
-    autoOfferOutgoing: true,
+    autoOfferOutgoing: launchOptions.offer ?? true,
     autoAcceptIncoming,
     autoSaveIncoming,
-    hideTerminalPeers: true,
+    hideTerminalPeers: launchOptions.clean ?? true,
     eventsExpanded: showEvents,
     offeringDrafts: false,
     notice: { text: "Tab focus", variant: "info" },
@@ -579,9 +700,55 @@ const renderHeaderBrand = () => ui.row({ id: "brand-title", gap: 1, items: "cent
 const renderHeader = (state: TuiState, actions: TuiActions) => denseSection({
   id: "header-shell",
   titleNode: renderHeaderBrand(),
-  actions: [toggleButton("toggle-events", "Events", state.eventsExpanded, actions.toggleEvents)],
+  actions: [
+    toggleButton("toggle-events", "Events", state.eventsExpanded, actions.toggleEvents),
+    actionButton(ABOUT_TRIGGER_ID, "About", actions.openAbout),
+  ],
 }, [])
 
+const renderAboutModal = (state: TuiState, actions: TuiActions) => {
+  const cliCommand = aboutCliCommand(state)
+  const currentWebUrl = aboutWebUrl(state)
+  const currentWebLabel = aboutWebLabel(state)
+  return ui.modal({
+  id: "about-modal",
+  title: ABOUT_TITLE,
+  content: ui.column({ gap: 1 }, [
+    ui.text(ABOUT_INTRO, { id: "about-intro", variant: "heading" }),
+    ui.text(ABOUT_SUMMARY, { id: "about-summary" }),
+    ui.text(ABOUT_RUNTIME, { id: "about-runtime" }),
+    ui.column({ gap: 0 }, [
+      ui.text(ABOUT_CLI_LABEL, { id: "about-cli-label", variant: "caption" }),
+      ui.text(cliCommand, { id: "about-current-cli" }),
+    ]),
+    ui.column({ gap: 0 }, [
+      ui.text(ABOUT_WEB_LINK_LABEL, { id: "about-web-link-label", variant: "caption" }),
+      ui.link({
+        id: "about-current-web-link",
+        label: currentWebLabel,
+        accessibleLabel: "Open current web link",
+        url: currentWebUrl,
+      }),
+    ]),
+  ]),
+  actions: [
+    ui.link({
+      id: "about-elefunc-link",
+      label: "elefunc.com",
+      accessibleLabel: "Open Elefunc website",
+      url: ABOUT_ELEFUNC_URL,
+    }),
+    actionButton("close-about", "Close", actions.closeAbout, "primary"),
+  ],
+  width: 72,
+  maxWidth: 84,
+  minWidth: 54,
+  initialFocus: "close-about",
+  returnFocusTo: ABOUT_TRIGGER_ID,
+  onClose: actions.closeAbout,
+})
+}
+
 const renderRoomCard = (state: TuiState, actions: TuiActions) => denseSection({
   id: "room-card",
 }, [
@@ -700,18 +867,18 @@ const renderPeerRow = (peer: PeerSnapshot, turnShareEnabled: boolean, actions: T
 ])
 
 const renderPeersCard = (state: TuiState, actions: TuiActions) => {
-  const peers = visiblePeers(state.snapshot.peers, state.hideTerminalPeers)
-  const activeCount = state.snapshot.peers.filter(peer => peer.presence === "active").length
-  const selectedCount = state.snapshot.peers.filter(peer => peer.selectable && peer.selected).length
+  const peers = renderedPeers(state.snapshot.peers, state.hideTerminalPeers, state.peerSearch)
+  const activeCount = peers.filter(peer => peer.presence === "active").length
+  const selectedCount = peers.filter(peer => peer.selectable && peer.selected).length
   const canShareTurn = state.session.canShareTurn()
   return denseSection({
     id: "peers-card",
     titleNode: ui.row({ id: "peers-title-row", gap: 1, items: "center" }, [
       headingTextButton("share-turn-all-peers", "Peers", canShareTurn && !!activeCount ? actions.shareTurnWithAllPeers : undefined, {
         focusable: canShareTurn && !!activeCount,
-        accessibleLabel: "share TURN with all active peers",
+        accessibleLabel: "share TURN with matching active peers",
       }),
-      ui.text(`${selectedCount}/${activeCount}`, { id: "peers-count-text", variant: "heading" }),
+      ui.text(`${selectedCount}/${peers.length}`, { id: "peers-count-text", variant: "heading" }),
     ]),
     flex: 1,
     actions: [
@@ -720,10 +887,16 @@ const renderPeersCard = (state: TuiState, actions: TuiActions) => {
       toggleButton("toggle-clean-peers", "Clean", state.hideTerminalPeers, actions.toggleHideTerminalPeers),
     ],
   }, [
+    ui.input({
+      id: PEER_SEARCH_INPUT_ID,
+      value: state.peerSearch,
+      placeholder: "filter",
+      onInput: value => actions.setPeerSearch(value),
+    }),
     ui.box({ id: "peers-list", flex: 1, minHeight: 0, overflow: "scroll", border: "none" }, [
       peers.length
         ? ui.column({ gap: 0 }, peers.map(peer => renderPeerRow(peer, canShareTurn, actions)))
-        : ui.empty(`Waiting for peers in ${state.snapshot.room}...`),
+        : ui.empty(state.snapshot.peers.length ? "No peers match current filters." : `Waiting for peers in ${state.snapshot.room}...`),
     ]),
   ])
 }
@@ -768,6 +941,7 @@ const renderFilePreviewRow = (match: FileSearchMatch, index: number, selected: b
     offsetFileSearchMatchIndices(displayPrefix, match.indices),
     { id: `file-preview-path-${index}`, flex: 1 },
   ),
+  match.kind === "file" && typeof match.size === "number" ? ui.text(formatBytes(match.size), { style: { dim: true } }) : null,
   match.kind === "directory" ? tightTag("dir", { variant: "info", bare: true }) : null,
 ])
 
@@ -999,7 +1173,7 @@ export const renderTuiView = (state: TuiState, actions: TuiActions): VNode => {
     gap: 0,
   })
 
-  return state.pendingFocusTarget
+  const basePage = state.pendingFocusTarget
     ? ui.focusTrap({
         id: `focus-request-${state.focusRequestEpoch}`,
         key: `focus-request-${state.focusRequestEpoch}`,
@@ -1007,6 +1181,10 @@ export const renderTuiView = (state: TuiState, actions: TuiActions): VNode => {
         initialFocus: state.pendingFocusTarget,
       }, [page])
     : page
+
+  return state.aboutOpen
+    ? ui.layers([basePage, renderAboutModal(state, actions)])
+    : basePage
 }
 
 const withNotice = (state: TuiState, notice: Notice): TuiState => ({ ...state, notice })
@@ -1021,10 +1199,11 @@ export const withAcceptedDraftInput = (state: TuiState, draftInput: string, file
     focusRequestEpoch: state.focusRequestEpoch + 1,
   }, notice)
 
-export const startTui = async (initialConfig: SessionConfig, showEvents = false) => {
+export const startTui = async (initialConfig: SessionConfig, launchOptions: TuiLaunchOptions = {}) => {
   await installCheckboxClickPatch()
-  const initialState = createInitialTuiState(initialConfig, showEvents)
+  const initialState = createInitialTuiState(initialConfig, !!launchOptions.events, launchOptions)
   const app = createNodeApp<TuiState>({ initialState })
+  const quitController = createQuitController()
   let state = initialState
   let unsubscribe = () => {}
   let stopping = false
@@ -1064,11 +1243,7 @@ export const startTui = async (initialConfig: SessionConfig, showEvents = false)
   const requestStop = () => {
     if (stopping) return
     stopping = true
-    try {
-      process.kill(process.pid, "SIGINT")
-    } catch {
-      void app.stop()
-    }
+    quitController.requestStop()
   }
 
   const resetFilePreview = (overrides: Partial<FilePreviewState> = {}): FilePreviewState => ({
@@ -1233,11 +1408,12 @@ export const startTui = async (initialConfig: SessionConfig, showEvents = false)
 
   const maybeOfferDrafts = () => {
     if (!state.autoOfferOutgoing || !state.drafts.length || state.offeringDrafts) return
-    if (!state.snapshot.peers.some(peer => peer.presence === "active" && peer.ready && peer.selected)) return
+    const targetPeerIds = renderedReadySelectedPeers(state.snapshot.peers, state.hideTerminalPeers, state.peerSearch).map(peer => peer.id)
+    if (!targetPeerIds.length) return
     const session = state.session
     const pendingDrafts = [...state.drafts]
     commit(current => ({ ...current, offeringDrafts: true }))
-    void session.offerToSelectedPeers(pendingDrafts.map(draft => draft.path)).then(
+    void session.queueFiles(pendingDrafts.map(draft => draft.path), targetPeerIds).then(
       ids => {
         if (state.session !== session) return
         const offeredIds = new Set(pendingDrafts.map(draft => draft.id))
@@ -1277,6 +1453,7 @@ export const startTui = async (initialConfig: SessionConfig, showEvents = false)
       sessionSeed: nextSeed,
       peerSelectionByRoom: current.peerSelectionByRoom,
       snapshot: nextSession.snapshot(),
+      peerSearch: "",
       roomInput: nextSeed.room,
       nameInput: visibleNameInput(nextSeed.name),
       draftInput: "",
@@ -1344,22 +1521,27 @@ export const startTui = async (initialConfig: SessionConfig, showEvents = false)
 
   const actions: TuiActions = {
     toggleEvents: () => commit(current => ({ ...withNotice(current, { text: current.eventsExpanded ? "Events hidden." : "Events shown.", variant: "info" }), eventsExpanded: !current.eventsExpanded })),
+    openAbout: () => commit(current => ({ ...current, aboutOpen: true })),
+    closeAbout: () => commit(current => ({ ...current, aboutOpen: false })),
     jumpToRandomRoom: () => replaceSession({ ...state.sessionSeed, room: uid(8) }, "Joined a new room."),
     commitRoom,
     setRoomInput: value => commit(current => ({ ...current, roomInput: value })),
     jumpToNewSelf: () => replaceSession({ ...state.sessionSeed, localId: cleanLocalId(uid(8)) }, "Started a fresh self ID.", { reseedBootFocus: true }),
     commitName,
     setNameInput: value => commit(current => ({ ...current, nameInput: value })),
+    setPeerSearch: value => commit(current => ({ ...current, peerSearch: value })),
     toggleSelectReadyPeers: () => {
+      const peers = renderedPeers(state.snapshot.peers, state.hideTerminalPeers, state.peerSearch)
       let changed = 0
-      for (const peer of state.snapshot.peers) if (state.session.setPeerSelected(peer.id, peer.presence === "active" && peer.ready)) changed += 1
-      commit(current => withNotice(current, { text: changed ? "Selected ready peers." : "No ready peers to select.", variant: changed ? "success" : "info" }))
+      for (const peer of peers) if (state.session.setPeerSelected(peer.id, peer.presence === "active" && peer.ready)) changed += 1
+      commit(current => withNotice(current, { text: changed ? "Selected matching ready peers." : "No matching ready peers to select.", variant: changed ? "success" : "info" }))
       maybeOfferDrafts()
     },
     clearPeerSelection: () => {
+      const peers = renderedPeers(state.snapshot.peers, state.hideTerminalPeers, state.peerSearch)
       let changed = 0
-      for (const peer of state.snapshot.peers) if (state.session.setPeerSelected(peer.id, false)) changed += 1
-      commit(current => withNotice(current, { text: changed ? `Cleared ${plural(changed, "peer selection")}.` : "No peer selections to clear.", variant: changed ? "warning" : "info" }))
+      for (const peer of peers) if (state.session.setPeerSelected(peer.id, false)) changed += 1
+      commit(current => withNotice(current, { text: changed ? `Cleared ${plural(changed, "matching peer selection")}.` : "No matching peer selections to clear.", variant: changed ? "warning" : "info" }))
     },
     toggleHideTerminalPeers: () => commit(current => withNotice({ ...current, hideTerminalPeers: !current.hideTerminalPeers }, { text: current.hideTerminalPeers ? "Terminal peers shown." : "Terminal peers hidden.", variant: "info" })),
     togglePeer: peerId => {
@@ -1379,13 +1561,16 @@ export const startTui = async (initialConfig: SessionConfig, showEvents = false)
       }))
     },
     shareTurnWithAllPeers: () => {
-      const shared = state.session.shareTurnWithAllPeers()
+      const targetPeerIds = renderedPeers(state.snapshot.peers, state.hideTerminalPeers, state.peerSearch)
+        .filter(peer => peer.presence === "active")
+        .map(peer => peer.id)
+      const shared = state.session.shareTurnWithPeers(targetPeerIds)
       commit(current => withNotice(current, {
         text: !state.session.canShareTurn()
           ? "TURN is not configured."
           : shared
-            ? `Shared TURN with ${plural(shared, "active peer")}.`
-            : "No active peers to share TURN with.",
+            ? `Shared TURN with ${plural(shared, "matching peer")}.`
+            : "No matching active peers to share TURN with.",
         variant: !state.session.canShareTurn() ? "info" : shared ? "success" : "info",
       }))
     },
@@ -1563,17 +1748,31 @@ export const startTui = async (initialConfig: SessionConfig, showEvents = false)
     stopping = true
     unsubscribe()
     stopPreviewSession()
+    try {
+      await app.stop()
+    } catch {}
     await state.session.close()
   }
 
+  const printResumeOutput = async () => {
+    const output = `${resumeOutputLines(state).join("\n")}\n`
+    await new Promise<void>(resolve => process.stdout.write(output, () => resolve()))
+  }
+
   try {
     bindSession(state.session)
-    await app.run()
+    await app.start()
+    await quitController.promise
   } finally {
     try {
       await stop()
     } finally {
-      app.dispose()
+      try {
+        app.dispose()
+      } finally {
+        await printResumeOutput()
+        quitController.detach()
+      }
     }
   }
 }

package/src/tui/file-search-protocol.ts

@@ -3,6 +3,7 @@ export interface FileSearchMatch {
   absolutePath: string
   fileName: string
   kind: "file" | "directory"
+  size?: number
   score: number
   indices: number[]
 }

package/src/tui/file-search.ts

@@ -8,6 +8,7 @@ export interface IndexedEntry {
   relativePath: string
   fileName: string
   kind: "file" | "directory"
+  size?: number
 }
 
 export interface FileSearchScope {
@@ -187,6 +188,7 @@ const browseEntries = (entries: readonly IndexedEntry[], resultLimit: number) =>
     absolutePath: entry.absolutePath,
     fileName: entry.fileName,
     kind: entry.kind,
+    size: entry.size,
     score: 0,
     indices: [],
   } satisfies FileSearchMatch))
@@ -203,6 +205,7 @@ export const searchEntries = (entries: readonly IndexedEntry[], query: string, r
       absolutePath: entry.absolutePath,
       fileName: entry.fileName,
       kind: entry.kind,
+      size: entry.size,
       score: match.score,
       indices: match.indices,
     })
@@ -272,6 +275,7 @@ export const crawlWorkspaceEntries = async (workspaceRoot: string, onEntry: (ent
             relativePath: normalizeRelativePath(relative(root, absolutePath)),
             fileName: child.name,
             kind: "file",
+            size: info.size,
           })
         }
       } catch {