@elefunc/send 0.1.18 → 0.1.20

package/README.md

@@ -35,12 +35,12 @@ In the TUI, the room row includes a `📋` invite link that opens the equivalent
 `--self` accepts three forms:
 
 - `name`
-- `name-ID`
-- `-ID` using the attached CLI form `--self=-ab12cd34`
+- `name-id`
+- `-id` using the attached CLI form `--self=-ab12cd34`
 
 `SEND_SELF` supports the same raw values, including `SEND_SELF=-ab12cd34`.
 
-The ID suffix must be exactly 8 lowercase alphanumeric characters.
+The `id` suffix must be exactly 8 lowercase alphanumeric characters.
 
 ## Examples
 

package/package.json

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

package/src/core/files.ts

@@ -1,4 +1,4 @@
-import { access, mkdir, open, rm, stat, type FileHandle } from "node:fs/promises"
+import { access, mkdir, open, rename, rm, stat, type FileHandle } from "node:fs/promises"
 import { basename, extname, join, resolve } from "node:path"
 import { resolveUserPath } from "./paths"
 
@@ -101,8 +101,23 @@ export const uniqueOutputPath = async (directory: string, fileName: string, rese
   }
 }
 
-export const saveIncomingFile = async (directory: string, fileName: string, data: Buffer) => {
-  const path = await uniqueOutputPath(directory, fileName)
+export const incomingOutputPath = async (directory: string, fileName: string, overwrite = false, reservedPaths: ReadonlySet<string> = new Set()) => {
+  await mkdir(directory, { recursive: true })
+  return overwrite ? join(directory, fileName) : uniqueOutputPath(directory, fileName, reservedPaths)
+}
+
+export const replaceOutputPath = async (sourcePath: string, destinationPath: string) => {
+  try {
+    await rename(sourcePath, destinationPath)
+  } catch (error) {
+    if (!await pathExists(destinationPath)) throw error
+    await removePath(destinationPath)
+    await rename(sourcePath, destinationPath)
+  }
+}
+
+export const saveIncomingFile = async (directory: string, fileName: string, data: Buffer, overwrite = false) => {
+  const path = await incomingOutputPath(directory, fileName, overwrite)
   await Bun.write(path, data)
   return path
 }

package/src/core/invite.ts

@@ -0,0 +1,148 @@
+import { resolve } from "node:path"
+import { cleanRoom } from "./protocol"
+
+export const DEFAULT_WEB_URL = "https://rtme.sh/"
+export const COPY_SERVICE_URL = "https://copy.rt.ht/"
+
+export type ShareUrlOptions = {
+  room: string
+  clean?: boolean
+  accept?: boolean
+  offer?: boolean
+  save?: boolean
+  overwrite?: boolean
+}
+
+export type ShareCliCommandOptions = ShareUrlOptions & {
+  self?: string
+  events?: boolean
+  saveDir?: string
+  defaultSaveDir?: string
+  turnUrls?: readonly (string | null | undefined)[]
+  turnUsername?: string
+  turnCredential?: string
+}
+
+export type JoinOutputKind = "offer" | "accept"
+
+const hashBool = (value: boolean) => value ? "1" : "0"
+const safeShellArgPattern = /^[A-Za-z0-9._/:?=&,+@%-]+$/
+
+const normalizeShareUrlOptions = (options: ShareUrlOptions) => ({
+  room: cleanRoom(options.room),
+  clean: options.clean ?? true,
+  accept: options.accept ?? true,
+  offer: options.offer ?? true,
+  save: options.save ?? true,
+  overwrite: options.overwrite ?? false,
+})
+
+const shellQuote = (value: string) => safeShellArgPattern.test(value) ? value : `'${value.replaceAll("'", `'\"'\"'`)}'`
+
+export const appendCliFlag = (args: string[], flag: string, value?: string | null) => {
+  const text = `${value ?? ""}`.trim()
+  if (!text) return
+  args.push(flag, shellQuote(text))
+}
+
+export const appendToggleCliFlags = (args: string[], options: ShareUrlOptions) => {
+  const normalized = normalizeShareUrlOptions(options)
+  if (!normalized.clean) appendCliFlag(args, "--clean", "0")
+  if (!normalized.accept) appendCliFlag(args, "--accept", "0")
+  if (!normalized.offer) appendCliFlag(args, "--offer", "0")
+  if (!normalized.save) appendCliFlag(args, "--save", "0")
+  if (normalized.overwrite) args.push("--overwrite")
+}
+
+const buildHashParams = (options: ShareUrlOptions, omitDefaults = false) => {
+  const normalized = normalizeShareUrlOptions(options)
+  const params = new URLSearchParams({ room: normalized.room })
+  if (!omitDefaults || !normalized.clean) params.set("clean", hashBool(normalized.clean))
+  if (!omitDefaults || !normalized.accept) params.set("accept", hashBool(normalized.accept))
+  if (!omitDefaults || !normalized.offer) params.set("offer", hashBool(normalized.offer))
+  if (!omitDefaults || !normalized.save) params.set("save", hashBool(normalized.save))
+  if (!omitDefaults || normalized.overwrite) params.set("overwrite", hashBool(normalized.overwrite))
+  return params
+}
+
+export const resolveWebUrlBase = (value = process.env.SEND_WEB_URL) => {
+  const candidate = `${value ?? ""}`.trim() || DEFAULT_WEB_URL
+  try {
+    return new URL(candidate).toString()
+  } catch {
+    return DEFAULT_WEB_URL
+  }
+}
+
+export const renderWebUrl = (options: ShareUrlOptions, baseUrl = DEFAULT_WEB_URL, omitDefaults = true) => {
+  const url = new URL(baseUrl)
+  url.hash = buildHashParams(options, omitDefaults).toString()
+  return url.toString()
+}
+
+export const schemeLessUrlText = (text: string) => text.replace(/^[a-z]+:\/\//, "")
+
+export const webInviteUrl = (options: ShareUrlOptions, baseUrl = resolveWebUrlBase()) => renderWebUrl(options, baseUrl)
+
+export const inviteWebLabel = (options: ShareUrlOptions, baseUrl = resolveWebUrlBase()) => schemeLessUrlText(webInviteUrl(options, baseUrl))
+
+export const inviteCliPackageName = (baseUrl = resolveWebUrlBase()) => new URL(resolveWebUrlBase(baseUrl)).hostname
+
+export const inviteCliCommand = (options: ShareUrlOptions) => {
+  const normalized = normalizeShareUrlOptions(options)
+  const args: string[] = []
+  appendCliFlag(args, "--room", normalized.room)
+  appendToggleCliFlags(args, normalized)
+  return args.join(" ")
+}
+
+export const inviteCliText = (options: ShareUrlOptions, baseUrl = resolveWebUrlBase()) => `bunx ${inviteCliPackageName(baseUrl)} ${inviteCliCommand(options)}`
+
+export const inviteCopyUrl = (text: string) => `${COPY_SERVICE_URL}#${new URLSearchParams({ text })}`
+
+export const shareTurnCliArgs = (options: Pick<ShareCliCommandOptions, "turnUrls" | "turnUsername" | "turnCredential">) => {
+  const turnUrls = [...new Set((options.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", options.turnUsername)
+  appendCliFlag(args, "--turn-credential", options.turnCredential)
+  return args
+}
+
+export const renderCliCommand = (
+  options: ShareCliCommandOptions,
+  { includeSelf = false, includePrefix = false, packageName }: { includeSelf?: boolean; includePrefix?: boolean; packageName?: string } = {},
+) => {
+  const normalized = normalizeShareUrlOptions(options)
+  const args = includePrefix ? ["bunx", packageName || inviteCliPackageName(DEFAULT_WEB_URL)] : []
+  appendCliFlag(args, "--room", normalized.room)
+  if (includeSelf) appendCliFlag(args, "--self", options.self)
+  appendToggleCliFlags(args, normalized)
+  if (options.events) args.push("--events")
+  if (options.saveDir && (!options.defaultSaveDir || resolve(options.saveDir) !== options.defaultSaveDir)) appendCliFlag(args, "--save-dir", options.saveDir)
+  args.push(...shareTurnCliArgs(options))
+  return args.join(" ")
+}
+
+const joinCliLabel = (kind: JoinOutputKind) => kind === "offer" ? "CLI (receive and save):" : "CLI (append file paths at the end):"
+
+const joinCliCommand = (kind: JoinOutputKind, room: string, baseUrl = resolveWebUrlBase()) => {
+  const prefix = `bunx ${inviteCliPackageName(baseUrl)}`
+  const roomArgs = inviteCliCommand({ room })
+  return kind === "offer" ? `${prefix} accept ${roomArgs}` : `${prefix} offer ${roomArgs}`
+}
+
+export const joinOutputLines = (kind: JoinOutputKind, room: string, baseUrl = resolveWebUrlBase()) => [
+  "Join with:",
+  "",
+  "Web (open in browser):",
+  webInviteUrl({ room }, baseUrl),
+  "",
+  joinCliLabel(kind),
+  joinCliCommand(kind, room, baseUrl),
+  "",
+  "TUI (interactive terminal UI):",
+  inviteCliText({ room }, baseUrl),
+  "",
+]

package/src/core/session.ts

@@ -2,7 +2,7 @@ import { open, rename, type FileHandle } from "node:fs/promises"
 import { resolve } from "node:path"
 import type { RTCDataChannel, RTCIceCandidateInit, RTCIceServer } from "werift"
 import { RTCPeerConnection } from "werift"
-import { closeLocalFile, loadLocalFiles, pathExists, readFileChunk, removePath, saveIncomingFile, uniqueOutputPath, writeFileChunk, type LocalFile } from "./files"
+import { closeLocalFile, incomingOutputPath, loadLocalFiles, pathExists, readFileChunk, removePath, replaceOutputPath, saveIncomingFile, uniqueOutputPath, writeFileChunk, type LocalFile } from "./files"
 import {
   BASE_ICE_SERVERS,
   BUFFER_HIGH,
@@ -176,6 +176,7 @@ export interface SessionConfig {
   peerSelectionMemory?: Map<string, boolean>
   autoAcceptIncoming?: boolean
   autoSaveIncoming?: boolean
+  overwriteIncoming?: boolean
   turnUrls?: string[]
   turnUsername?: string
   turnCredential?: string
@@ -184,6 +185,8 @@ export interface SessionConfig {
 
 const LOG_LIMIT = 200
 const STATS_POLL_MS = 1000
+export const PULSE_PROBE_INTERVAL_MS = 15_000
+export const PULSE_STALE_MS = 45_000
 const PROFILE_URL = "https://ip.rt.ht/"
 export interface PeerConnectivitySnapshot {
   rttMs: number
@@ -194,9 +197,12 @@ export interface PeerConnectivitySnapshot {
 
 export type TurnState = "none" | "idle" | "used"
 export type PulseState = "idle" | "checking" | "open" | "error"
+export type SettledPulseState = "idle" | "open" | "error"
+export type SignalMetricState = "idle" | "connecting" | "checking" | "open" | "degraded" | "closed" | "error"
 
 export interface PulseSnapshot {
   state: PulseState
+  lastSettledState: SettledPulseState
   at: number
   ms: number
   error: string
@@ -206,7 +212,27 @@ const progressOf = (transfer: TransferState) => transfer.size ? Math.max(0, Math
 const isFinal = (transfer: TransferState) => FINAL_STATUSES.has(transfer.status as never)
 export const candidateTypeLabel = (type: string) => ({ host: "Direct", srflx: "NAT", prflx: "NAT", relay: "TURN" }[type] || "—")
 const emptyConnectivitySnapshot = (): PeerConnectivitySnapshot => ({ rttMs: Number.NaN, localCandidateType: "", remoteCandidateType: "", pathLabel: "—" })
-const emptyPulseSnapshot = (): PulseSnapshot => ({ state: "idle", at: 0, ms: 0, error: "" })
+const settledPulseState = (pulse?: Pick<PulseSnapshot, "state" | "lastSettledState"> | null): SettledPulseState =>
+  pulse?.lastSettledState === "open" || pulse?.lastSettledState === "error" || pulse?.lastSettledState === "idle"
+    ? pulse.lastSettledState
+    : pulse?.state === "open"
+      ? "open"
+      : pulse?.state === "error"
+        ? "error"
+        : "idle"
+const pulseIsFresh = (pulse: Pick<PulseSnapshot, "at" | "lastSettledState" | "state">, now = Date.now()) =>
+  settledPulseState(pulse) === "open" && Number.isFinite(pulse.at) && pulse.at > 0 && now - pulse.at <= PULSE_STALE_MS
+export const signalMetricState = (socketState: SocketState, pulse: PulseSnapshot, now = Date.now()): SignalMetricState => {
+  if (socketState === "error") return "error"
+  if (socketState === "closed") return "closed"
+  if (socketState === "connecting") return "connecting"
+  if (socketState === "idle") return "idle"
+  const lastSettled = settledPulseState(pulse)
+  if (lastSettled === "idle") return "checking"
+  if (lastSettled === "error") return "degraded"
+  return pulseIsFresh(pulse, now) ? "open" : "degraded"
+}
+const emptyPulseSnapshot = (): PulseSnapshot => ({ state: "idle", lastSettledState: "idle", at: 0, ms: 0, error: "" })
 
 export const sanitizeProfile = (profile?: PeerProfile): PeerProfile => ({
   geo: {
@@ -389,6 +415,7 @@ export class SendSession {
 
   private autoAcceptIncoming: boolean
   private autoSaveIncoming: boolean
+  private readonly overwriteIncoming: boolean
   private readonly reconnectSocket: boolean
   private iceServers: RTCIceServer[]
   private extraTurnServers: RTCIceServer[]
@@ -405,6 +432,7 @@ export class SendSession {
   private socketToken = 0
   private reconnectTimer: ReturnType<typeof setTimeout> | null = null
   private peerStatsTimer: ReturnType<typeof setInterval> | null = null
+  private pulseTimer: ReturnType<typeof setInterval> | null = null
   private readonly pendingRtcCloses = new Set<Promise<void>>()
   private lifecycleAbortController: AbortController | null = null
   private stopped = false
@@ -418,6 +446,7 @@ export class SendSession {
     this.peerSelectionMemory = config.peerSelectionMemory ?? new Map()
     this.autoAcceptIncoming = !!config.autoAcceptIncoming
     this.autoSaveIncoming = !!config.autoSaveIncoming
+    this.overwriteIncoming = !!config.overwriteIncoming
     this.reconnectSocket = config.reconnectSocket ?? true
     this.extraTurnServers = turnServers(config.turnUrls ?? [], config.turnUsername, config.turnCredential)
     this.iceServers = [...BASE_ICE_SERVERS, ...this.extraTurnServers]
@@ -460,6 +489,7 @@ export class SendSession {
     this.lifecycleAbortController?.abort()
     this.lifecycleAbortController = typeof AbortController === "function" ? new AbortController() : null
     this.startPeerStatsPolling()
+    this.startPulsePolling()
     void this.loadLocalProfile()
     void this.probePulse()
     this.connectSocket()
@@ -469,6 +499,7 @@ export class SendSession {
   async close() {
     this.stopped = true
     this.stopPeerStatsPolling()
+    this.stopPulsePolling()
     if (this.reconnectTimer) clearTimeout(this.reconnectTimer)
     this.reconnectTimer = null
     this.lifecycleAbortController?.abort()
@@ -763,7 +794,7 @@ export class SendSession {
     if (transfer.savedPath) return transfer.savedPath
     if (!transfer.data && transfer.buffers?.length) transfer.data = Buffer.concat(transfer.buffers)
     if (!transfer.data) return null
-    transfer.savedPath = await saveIncomingFile(this.saveDir, transfer.name, transfer.data)
+    transfer.savedPath = await saveIncomingFile(this.saveDir, transfer.name, transfer.data, this.overwriteIncoming)
     transfer.savedAt ||= Date.now()
     this.emitTransferSaved(transfer)
     this.notify()
@@ -788,8 +819,8 @@ export class SendSession {
   }
 
   private async createIncomingDiskState(fileName: string): Promise<IncomingDiskState> {
-    const finalPath = await uniqueOutputPath(this.saveDir, fileName || "download", this.reservedSavePaths)
-    this.reservedSavePaths.add(finalPath)
+    const finalPath = await incomingOutputPath(this.saveDir, fileName || "download", this.overwriteIncoming, this.reservedSavePaths)
+    if (!this.overwriteIncoming) this.reservedSavePaths.add(finalPath)
     for (let attempt = 0; ; attempt += 1) {
       const tempPath = `${finalPath}.part.${uid(6)}${attempt ? `.${attempt}` : ""}`
       try {
@@ -805,7 +836,7 @@ export class SendSession {
         }
       } catch (error) {
         if ((error as NodeJS.ErrnoException | undefined)?.code === "EEXIST") continue
-        this.reservedSavePaths.delete(finalPath)
+        if (!this.overwriteIncoming) this.reservedSavePaths.delete(finalPath)
         throw error
       }
     }
@@ -875,12 +906,13 @@ export class SendSession {
         disk.closed = true
         await disk.handle.close()
       }
-      if (await pathExists(finalPath)) {
+      if (!this.overwriteIncoming && await pathExists(finalPath)) {
         this.reservedSavePaths.delete(finalPath)
         finalPath = await uniqueOutputPath(this.saveDir, transfer.name || "download", this.reservedSavePaths)
         this.reservedSavePaths.add(finalPath)
       }
-      await rename(disk.tempPath, finalPath)
+      if (this.overwriteIncoming) await replaceOutputPath(disk.tempPath, finalPath)
+      else await rename(disk.tempPath, finalPath)
       transfer.savedPath = finalPath
       transfer.savedAt ||= Date.now()
       return finalPath
@@ -952,6 +984,17 @@ export class SendSession {
     this.peerStatsTimer = null
   }
 
+  private startPulsePolling() {
+    if (this.pulseTimer) return
+    this.pulseTimer = setInterval(() => void this.probePulse(), PULSE_PROBE_INTERVAL_MS)
+  }
+
+  private stopPulsePolling() {
+    if (!this.pulseTimer) return
+    clearInterval(this.pulseTimer)
+    this.pulseTimer = null
+  }
+
   private async refreshPeerStats() {
     if (this.stopped) return
     let dirty = false
@@ -1156,10 +1199,10 @@ export class SendSession {
       const response = await fetch(SIGNAL_PULSE_URL, { cache: "no-store", signal: timeoutSignal(3500, this.lifecycleAbortController?.signal) })
       if (!response.ok) throw new Error(`pulse ${response.status}`)
       if (this.stopped) return
-      this.pulse = { state: "open", at: Date.now(), ms: performance.now() - startedAt, error: "" }
+      this.pulse = { state: "open", lastSettledState: "open", at: Date.now(), ms: performance.now() - startedAt, error: "" }
     } catch (error) {
       if (this.stopped) return
-      this.pulse = { state: "error", at: Date.now(), ms: 0, error: `${error}` }
+      this.pulse = { state: "error", lastSettledState: "error", at: Date.now(), ms: 0, error: `${error}` }
       this.pushLog("pulse:error", { error: `${error}` }, "error")
     }
     if (this.stopped) return

package/src/core/targeting.ts

@@ -1,4 +1,4 @@
-import { cleanName, displayPeerName } from "./protocol"
+import { cleanText, displayPeerName } from "./protocol"
 
 export interface TargetPeer {
   id: string
@@ -16,23 +16,29 @@ export interface ResolveTargetsResult {
 const BROADCAST_SELECTOR = "."
 
 const uniquePeers = (peers: TargetPeer[]) => [...new Map(peers.map(peer => [peer.id, peer])).values()]
-
-const matchesSelector = (peer: TargetPeer, selector: string) => selector === peer.id || selector === displayPeerName(peer.name, peer.id) || selector === cleanName(peer.name)
+const normalizeName = (value: unknown) => cleanText(value, 24).toLowerCase().replace(/[^a-z0-9]+/g, "").slice(0, 24)
+const parseSelector = (selector: string) => {
+  const hyphen = selector.lastIndexOf("-")
+  return hyphen < 0
+    ? { raw: selector, kind: "name" as const, value: normalizeName(selector) }
+    : { raw: selector, kind: "id" as const, value: selector.slice(hyphen + 1) }
+}
+const matchesSelector = (peer: TargetPeer, selector: ReturnType<typeof parseSelector>) =>
+  selector.kind === "name" ? normalizeName(peer.name) === selector.value : peer.id === selector.value
 
 export const resolvePeerTargets = (peers: TargetPeer[], selectors: string[]): ResolveTargetsResult => {
   const active = peers.filter(peer => peer.presence === "active")
-  const ready = active.filter(peer => peer.ready)
   const requested = [...new Set(selectors.filter(Boolean))]
   const normalized = requested.length ? requested : [BROADCAST_SELECTOR]
   if (normalized.includes(BROADCAST_SELECTOR)) {
     if (normalized.length > 1) return { ok: false, peers: [], error: "broadcast selector `.` cannot be combined with specific peers" }
+    const ready = active.filter(peer => peer.ready)
     return ready.length ? { ok: true, peers: ready } : { ok: false, peers: [], error: "no ready peers" }
   }
-  const matches = uniquePeers(active.filter(peer => normalized.some(selector => matchesSelector(peer, selector))))
-  if (matches.length !== normalized.length) {
-    const missing = normalized.filter(selector => !matches.some(peer => matchesSelector(peer, selector)))
-    return { ok: false, peers: [], error: `no matching peer for ${missing.join(", ")}` }
-  }
+  const parsed = normalized.map(parseSelector)
+  const missing = parsed.filter(selector => !active.some(peer => matchesSelector(peer, selector))).map(selector => selector.raw)
+  if (missing.length) return { ok: false, peers: [], error: `no matching peer for ${missing.join(", ")}` }
+  const matches = uniquePeers(active.flatMap(peer => parsed.some(selector => matchesSelector(peer, selector)) ? [peer] : []))
   const notReady = matches.filter(peer => !peer.ready)
   if (notReady.length) return { ok: false, peers: [], error: `peer not ready: ${notReady.map(peer => displayPeerName(peer.name, peer.id)).join(", ")}` }
   return { ok: true, peers: matches }

package/src/index.ts

@@ -1,6 +1,7 @@
 #!/usr/bin/env bun
 import { resolve } from "node:path"
 import { cac, type CAC } from "cac"
+import { joinOutputLines, type JoinOutputKind } from "./core/invite"
 import { cleanRoom, displayPeerName } from "./core/protocol"
 import type { SendSession, SessionConfig, SessionEvent } from "./core/session"
 import { resolvePeerTargets } from "./core/targeting"
@@ -55,8 +56,8 @@ const parseBinaryOptions = <K extends BinaryOptionKey>(options: Record<string, u
 
 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`
+const SELF_HELP_TEXT = "self identity: `name`, `name-id`, or `-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"],
@@ -67,6 +68,7 @@ const TURN_OPTIONS = [
   ["--turn-username <value>", "custom TURN username"],
   ["--turn-credential <value>", "custom TURN credential"],
 ] as const
+const OVERWRITE_OPTION = ["--overwrite", "overwrite same-name saved files instead of creating copies"] 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"],
@@ -77,6 +79,14 @@ const TUI_TOGGLE_OPTIONS = [
 export const ACCEPT_SESSION_DEFAULTS = { autoAcceptIncoming: true, autoSaveIncoming: true } as const
 const addOptions = (command: CliCommand, definitions: readonly (readonly [string, string])[]) =>
   definitions.reduce((next, [flag, description]) => next.option(flag, description), command)
+const withTrailingHelpLine = <T extends { outputHelp: () => void }>(target: T) => {
+  const outputHelp = target.outputHelp.bind(target)
+  target.outputHelp = () => {
+    outputHelp()
+    console.info("")
+  }
+  return target
+}
 
 const requireSelfId = (value: string) => {
   if (!SELF_ID_PATTERN.test(value)) throw new ExitError(INVALID_SELF_ID_MESSAGE, 1)
@@ -103,6 +113,7 @@ export const sessionConfigFrom = (options: Record<string, unknown>, defaults: {
     saveDir: resolve(`${options.saveDir ?? process.env.SEND_SAVE_DIR ?? "."}`),
     autoAcceptIncoming: accept ?? defaults.autoAcceptIncoming ?? false,
     autoSaveIncoming: save ?? defaults.autoSaveIncoming ?? false,
+    overwriteIncoming: !!options.overwrite,
     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,
@@ -114,6 +125,16 @@ export const roomAnnouncement = (room: string, self: string, json = false) =>
 
 const printRoomAnnouncement = (room: string, self: string, json = false) => console.log(roomAnnouncement(room, self, json))
 
+export const commandAnnouncement = (kind: JoinOutputKind, room: string, self: string, json = false) =>
+  json ? roomAnnouncement(room, self, true) : [roomAnnouncement(room, self), "", ...joinOutputLines(kind, room)].join("\n")
+
+const printCommandAnnouncement = (kind: JoinOutputKind, room: string, self: string, json = false) => console.log(commandAnnouncement(kind, room, self, json))
+export const readyStatusLine = (room: string, json = false) => json ? "" : `ready in ${room}`
+const printReadyStatus = (room: string, json = false) => {
+  const line = readyStatusLine(room, json)
+  if (line) console.log(line)
+}
+
 const printEvent = (event: SessionEvent) => console.log(JSON.stringify(event))
 
 const attachReporter = (session: SendSession, json = false) => {
@@ -220,9 +241,10 @@ const offerCommand = async (files: string[], options: Record<string, unknown>) =
   const { SendSession } = await loadSessionRuntime()
   const session = new SendSession(sessionConfigFrom(options, {}))
   handleSignals(session)
-  printRoomAnnouncement(session.room, displayPeerName(session.name, session.localId), !!options.json)
+  printCommandAnnouncement("offer", session.room, displayPeerName(session.name, session.localId), !!options.json)
   const detachReporter = attachReporter(session, !!options.json)
   await session.connect()
+  printReadyStatus(session.room, !!options.json)
   const targets = await waitForTargets(session, selectors, timeoutMs)
   const transferIds = await session.queueFiles(files, targets.map(peer => peer.id))
   const results = await waitForFinalTransfers(session, transferIds)
@@ -236,10 +258,10 @@ const acceptCommand = async (options: Record<string, unknown>) => {
   const { SendSession } = await loadSessionRuntime()
   const session = new SendSession(sessionConfigFrom(options, ACCEPT_SESSION_DEFAULTS))
   handleSignals(session)
-  printRoomAnnouncement(session.room, displayPeerName(session.name, session.localId), !!options.json)
+  printCommandAnnouncement("accept", session.room, displayPeerName(session.name, session.localId), !!options.json)
   const detachReporter = attachReporter(session, !!options.json)
   await session.connect()
-  if (!options.json) console.log(`listening in ${session.room}`)
+  printReadyStatus(session.room, !!options.json)
   if (options.once) {
     for (;;) {
       const saved = session.snapshot().transfers.find(transfer => transfer.direction === "in" && transfer.savedAt > 0)
@@ -278,71 +300,96 @@ const defaultCliHandlers: CliHandlers = {
   tui: tuiCommand,
 }
 
+const fileNamePart = (value: string) => value.replace(/^.*[\\/]/, "") || value
+const HELP_NAME_COLOR = "\x1b[38;5;214m"
+const HELP_NAME_RESET = "\x1b[0m"
+const colorCliHelpName = (value: string) => `${HELP_NAME_COLOR}${value}${HELP_NAME_RESET}`
+const cliHelpPlainName = () => process.env.SEND_NAME?.trim() || fileNamePart(Bun.main)
+const cliHelpDisplayName = () => {
+  const name = cliHelpPlainName()
+  if (!process.stdout.isTTY) return name
+  return process.env.SEND_NAME_COLORED?.trim() || colorCliHelpName(name)
+}
+
 export const createCli = (handlers: CliHandlers = defaultCliHandlers) => {
-  const cli = cac("send")
+  const name = cliHelpDisplayName()
+  const cli = cac(name)
   cli.usage("[command] [options]")
 
-  addOptions(cli.command("peers", "list discovered peers"), [
+  withTrailingHelpLine(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)
+  ])).action(handlers.peers)
 
-  addOptions(cli.command("offer [...files]", "offer files to browser-compatible peers"), [
+  withTrailingHelpLine(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: `.`"],
+    ["--to <peer>", "target `name`, `name-id`, or `-id`; `.` targets all ready peers by 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)
+  ])).action(handlers.offer)
 
-  addOptions(cli.command("accept", "receive and save files"), [
+  withTrailingHelpLine(addOptions(cli.command("accept", "receive and save files"), [
     ...ROOM_SELF_OPTIONS,
     SAVE_DIR_OPTION,
+    OVERWRITE_OPTION,
     ["--once", "exit after the first saved incoming transfer"],
     ["--json", "emit ndjson events"],
     ...TURN_OPTIONS,
-  ]).action(handlers.accept)
+  ])).action(handlers.accept)
 
-  addOptions(cli.command("tui", "launch the interactive terminal UI"), [
+  withTrailingHelpLine(addOptions(cli.command("tui", "launch the interactive terminal UI"), [
     ...ROOM_SELF_OPTIONS,
     ...TUI_TOGGLE_OPTIONS,
     ["--events", "show the event log pane"],
     SAVE_DIR_OPTION,
+    OVERWRITE_OPTION,
     ...TURN_OPTIONS,
-  ]).action(handlers.tui)
+  ])).action(handlers.tui)
 
   cli.help(sections => {
     const usage = sections.find(section => section.title === "Usage:")
-    if (usage) usage.body = "  $ send [command] [options]"
+    if (usage) usage.body = `  $ ${name} [command] [options]`
     const moreInfoIndex = sections.findIndex(section => section.title?.startsWith("For more info"))
     const defaultSection = {
       title: "Default",
-      body: "  send with no command launches the terminal UI (same as `send tui`).",
+      body: `  ${name} with no command launches the terminal UI (same as \`${name} tui\`).`,
     }
     if (moreInfoIndex < 0) sections.push(defaultSection)
     else sections.splice(moreInfoIndex, 0, defaultSection)
   })
+  withTrailingHelpLine(cli.globalCommand)
 
   return cli
 }
 
-const explicitCommand = (cli: CAC, argv: string[]) => {
-  const command = argv[2]
-  if (!command || command.startsWith("-")) return undefined
-  if (cli.commands.some(entry => entry.isMatched(command))) return command
-  throw new ExitError(`Unknown command \`${command}\``, 1)
+const argvPrefix = (argv: string[]) => [argv[0] ?? process.argv[0] ?? "bun", argv[1] ?? process.argv[1] ?? cliHelpPlainName()]
+const printSubcommandHelp = (argv: string[], handlers: CliHandlers, subcommand: string) =>
+  void createCli(handlers).parse([...argvPrefix(argv), subcommand, "--help"], { run: false })
+
+const explicitCommand = (argv: string[], handlers: CliHandlers) => {
+  const cli = createCli(handlers)
+  cli.showHelpOnExit = false
+  cli.parse(argv, { run: false })
+  if (cli.matchedCommandName) return cli.matchedCommandName
+  if (cli.args[0]) throw new ExitError(`Unknown command \`${cli.args[0]}\``, 1)
+  return undefined
 }
 
 export const runCli = async (argv = process.argv, handlers: CliHandlers = defaultCliHandlers) => {
   const cli = createCli(handlers)
-  const command = explicitCommand(cli, argv)
+  const command = explicitCommand(argv, handlers)
   const parsed = cli.parse(argv, { run: false }) as { options: Record<string, unknown> }
   const helpRequested = !!parsed.options.help || !!parsed.options.h
-  if (!command && !helpRequested) {
+  if (!command) {
+    if (helpRequested) {
+      printSubcommandHelp(argv, handlers, "tui")
+      return
+    }
     await handlers.tui(parsed.options)
     return
   }

package/src/tui/app.ts

@@ -2,7 +2,20 @@ import { resolve } from "node:path"
 import { BACKEND_RAW_WRITE_MARKER, rgb, ui, type BackendRawWrite, type BadgeVariant, type TextStyle, type UiEvent, type VNode } from "@rezi-ui/core"
 import { createNodeApp } from "@rezi-ui/node"
 import { inspectLocalFile } from "../core/files"
-import { isSessionAbortedError, SendSession, type PeerSnapshot, type SessionConfig, type SessionSnapshot, type TransferSnapshot } from "../core/session"
+import {
+  DEFAULT_WEB_URL,
+  inviteCliCommand as formatInviteCliCommand,
+  inviteCliPackageName as formatInviteCliPackageName,
+  inviteCliText as formatInviteCliText,
+  inviteCopyUrl as formatInviteCopyUrl,
+  inviteWebLabel as formatInviteWebLabel,
+  renderCliCommand as renderSharedCliCommand,
+  renderWebUrl,
+  resolveWebUrlBase as resolveSharedWebUrlBase,
+  schemeLessUrlText,
+  webInviteUrl as formatWebInviteUrl,
+} from "../core/invite"
+import { isSessionAbortedError, SendSession, signalMetricState, type PeerSnapshot, type SessionConfig, type SessionSnapshot, type TransferSnapshot } from "../core/session"
 import { cleanLocalId, cleanName, cleanRoom, displayPeerName, fallbackName, formatBytes, type LogEntry, peerDefaultsToken, type PeerProfile, uid } from "../core/protocol"
 import { FILE_SEARCH_VISIBLE_ROWS, type FileSearchEvent, type FileSearchMatch, type FileSearchRequest } from "./file-search-protocol"
 import { deriveFileSearchScope, formatFileSearchDisplayPath, normalizeSearchQuery, offsetFileSearchMatchIndices } from "./file-search"
@@ -72,6 +85,7 @@ export interface TuiState {
   autoOfferOutgoing: boolean
   autoAcceptIncoming: boolean
   autoSaveIncoming: boolean
+  overwriteIncoming: boolean
   hideTerminalPeers: boolean
   eventsExpanded: boolean
   offeringDrafts: boolean
@@ -86,6 +100,7 @@ export interface TuiActions {
   closeInviteDropdown: TuiAction
   copyWebInvite: TuiAction
   copyCliInvite: TuiAction
+  copyLogs: TuiAction
   jumpToRandomRoom: TuiAction
   commitRoom: TuiAction
   setRoomInput: (value: string) => void
@@ -128,14 +143,17 @@ 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 MUTED_TEXT_STYLE = { fg: rgb(159, 166, 178) } as const
-const DEFAULT_WEB_URL = "https://rtme.sh/"
 const DEFAULT_SAVE_DIR = resolve(process.cwd())
 const ABOUT_ELEFUNC_URL = "https://rtme.sh/send"
 const ABOUT_TITLE = "About Send"
 const ABOUT_INTRO = "Peer-to-Peer Transfers – Web & CLI"
-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 COPY_SERVICE_URL = "https://copy.rt.ht/"
+const ABOUT_BULLETS = [
+  "• Join a room, see who is there, and filter or select exactly which peers to target before offering files.",
+  "• File data does not travel through the signaling service; Send uses lightweight signaling to discover peers and negotiate WebRTC, then transfers directly peer-to-peer when possible, with TURN relay when needed.",
+  "• Incoming transfers can be auto-accepted and auto-saved, and same-name files can either stay as numbered copies or overwrite the original when that mode is enabled.",
+  "• The CLI streams incoming saves straight to disk in the current save directory, with overwrite available through the CLI flag.",
+  "• Other features include copyable web and CLI invites, rendered-peer filtering and selection, TURN sharing, and live connection insight like signaling state, RTT, data state, and path labels.",
+] as const
 const TRANSFER_DIRECTION_ARROW = {
   out: { glyph: "↗", style: { fg: rgb(170, 217, 76), bold: true } },
   in: { glyph: "↙", style: { fg: rgb(240, 113, 120), bold: true } },
@@ -154,8 +172,6 @@ export const isEditableFocusId = (focusedId: string | null) =>
   focusedId === ROOM_INPUT_ID || focusedId === NAME_INPUT_ID || focusedId === PEER_SEARCH_INPUT_ID || focusedId === DRAFT_INPUT_ID
 export const shouldSwallowQQuit = (focusedId: string | null) => !isEditableFocusId(focusedId)
 
-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 = {
@@ -169,63 +185,32 @@ type BunSpawn = (cmd: string[], options: {
   stderr?: "pipe" | "inherit" | "ignore"
 }) => { unref?: () => void }
 type BunLike = { spawn?: BunSpawn }
-type ShareUrlState = Pick<TuiState, "snapshot" | "hideTerminalPeers" | "autoAcceptIncoming" | "autoOfferOutgoing" | "autoSaveIncoming">
+type ShareUrlState = Pick<TuiState, "snapshot" | "hideTerminalPeers" | "autoAcceptIncoming" | "autoOfferOutgoing" | "autoSaveIncoming" | "overwriteIncoming">
 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
-  try {
-    return new URL(candidate).toString()
-  } catch {
-    return DEFAULT_WEB_URL
-  }
-}
-
-const renderWebUrl = (state: ShareUrlState, baseUrl = DEFAULT_WEB_URL, omitDefaults = true) => {
-  const url = new URL(baseUrl)
-  url.hash = buildHashParams(state, omitDefaults).toString()
-  return url.toString()
-}
-const schemeLessUrlText = (text: string) => text.replace(/^[a-z]+:\/\//, "")
-export const inviteWebLabel = (state: ShareUrlState, baseUrl = resolveWebUrlBase()) => schemeLessUrlText(webInviteUrl(state, baseUrl))
-export const inviteCliPackageName = (baseUrl = resolveWebUrlBase()) => new URL(resolveWebUrlBase(baseUrl)).hostname
-export const inviteCliCommand = (state: ShareUrlState) => {
-  const args: string[] = []
-  appendCliFlag(args, "--room", state.snapshot.room)
-  appendToggleCliFlags(args, state)
-  return args.join(" ")
-}
-export const inviteCliText = (state: ShareUrlState, baseUrl = resolveWebUrlBase()) => `bunx ${inviteCliPackageName(baseUrl)} ${inviteCliCommand(state)}`
-export const inviteCopyUrl = (text: string) => `${COPY_SERVICE_URL}#${new URLSearchParams({ text })}`
+const shareUrlOptions = (state: ShareUrlState) => ({
+  room: cleanRoom(state.snapshot.room),
+  clean: state.hideTerminalPeers,
+  accept: state.autoAcceptIncoming,
+  offer: state.autoOfferOutgoing,
+  save: state.autoSaveIncoming,
+  overwrite: state.overwriteIncoming,
+})
+const shareCliOptions = (state: ShareCliState) => ({
+  ...shareUrlOptions(state),
+  self: displayPeerName(state.snapshot.name, state.snapshot.localId),
+  events: state.eventsExpanded,
+  saveDir: state.snapshot.saveDir,
+  defaultSaveDir: DEFAULT_SAVE_DIR,
+  turnUrls: state.sessionSeed.turnUrls,
+  turnUsername: state.sessionSeed.turnUsername,
+  turnCredential: state.sessionSeed.turnCredential,
+})
+export const resolveWebUrlBase = (value = process.env.SEND_WEB_URL) => resolveSharedWebUrlBase(value)
+export const inviteWebLabel = (state: ShareUrlState, baseUrl = resolveWebUrlBase()) => formatInviteWebLabel(shareUrlOptions(state), baseUrl)
+export const inviteCliPackageName = (baseUrl = resolveWebUrlBase()) => formatInviteCliPackageName(baseUrl)
+export const inviteCliCommand = (state: ShareUrlState) => formatInviteCliCommand(shareUrlOptions(state))
+export const inviteCliText = (state: ShareUrlState, baseUrl = resolveWebUrlBase()) => formatInviteCliText(shareUrlOptions(state), baseUrl)
+export const inviteCopyUrl = (text: string) => formatInviteCopyUrl(text)
 export const buildOsc52ClipboardSequence = (text: string) => text ? `\u001b]52;c;${Buffer.from(text).toString("base64")}\u0007` : ""
 export const externalOpenCommand = (url: string, platform = process.platform) =>
   platform === "darwin" ? ["open", url]
@@ -236,30 +221,17 @@ const getBackendRawWriter = (backend: unknown): BackendRawWrite | null => {
   return typeof marker === "function" ? marker as BackendRawWrite : null
 }
 const getBunRuntime = () => (globalThis as typeof globalThis & { Bun?: BunLike }).Bun ?? null
-const renderCliCommand = (state: ShareCliState, { includeSelf = false, includePrefix = false } = {}) => {
-  const args = includePrefix ? ["bunx", "rtme.sh"] : []
-  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)
-}
+export const webInviteUrl = (state: ShareUrlState, baseUrl = resolveWebUrlBase()) => formatWebInviteUrl(shareUrlOptions(state), baseUrl)
 
-export const aboutWebUrl = (state: ShareUrlState, baseUrl = DEFAULT_WEB_URL) => renderWebUrl(state, baseUrl)
+export const aboutWebUrl = (state: ShareUrlState, baseUrl = DEFAULT_WEB_URL) => renderWebUrl(shareUrlOptions(state), baseUrl)
 
-export const aboutWebLabel = (state: ShareUrlState, baseUrl = DEFAULT_WEB_URL) => aboutWebUrl(state, baseUrl).replace(/^https:\/\//, "")
+export const aboutWebLabel = (state: ShareUrlState, baseUrl = DEFAULT_WEB_URL) => schemeLessUrlText(aboutWebUrl(state, baseUrl))
 
-export const aboutCliCommand = (state: ShareCliState) => renderCliCommand(state)
+export const aboutCliCommand = (state: ShareCliState) => renderSharedCliCommand(shareCliOptions(state))
 
-export const resumeWebUrl = (state: ShareUrlState, baseUrl = DEFAULT_WEB_URL) => renderWebUrl(state, baseUrl)
+export const resumeWebUrl = (state: ShareUrlState, baseUrl = DEFAULT_WEB_URL) => renderWebUrl(shareUrlOptions(state), baseUrl)
 
-export const resumeCliCommand = (state: ShareCliState) => renderCliCommand(state, { includeSelf: true, includePrefix: true })
+export const resumeCliCommand = (state: ShareCliState) => renderSharedCliCommand(shareCliOptions(state), { includeSelf: true, includePrefix: true, packageName: "rtme.sh" })
 
 export const resumeOutputLines = (state: ShareCliState) => [
   "Rejoin with:",
@@ -304,6 +276,7 @@ export const createNoopTuiActions = (): TuiActions => ({
   closeInviteDropdown: noop,
   copyWebInvite: noop,
   copyCliInvite: noop,
+  copyLogs: noop,
   jumpToRandomRoom: noop,
   commitRoom: noop,
   setRoomInput: noop,
@@ -339,6 +312,15 @@ const shortText = (value: unknown, max = 88) => {
   const text = typeof value === "string" ? value : JSON.stringify(value)
   return text.length <= max ? text : `${text.slice(0, Math.max(0, max - 1))}…`
 }
+const formatLogPayloadText = (payload: unknown) => {
+  if (typeof payload === "string") return payload
+  try {
+    return JSON.stringify(payload, null, 2) ?? `${payload}`
+  } catch {
+    return `${payload}`
+  }
+}
+export const formatLogsForCopy = (logs: readonly LogEntry[]) => logs.map(log => `${timeFormat.format(log.at)} ${log.kind}\n${formatLogPayloadText(log.payload)}`).join("\n\n")
 const toggleIntent = (active: boolean) => active ? "success" : "secondary"
 const statusKind = (socketState: SessionSnapshot["socketState"]) => socketState === "open" ? "online" : socketState === "connecting" ? "busy" : socketState === "error" ? "offline" : "away"
 const peerConnectionStatusKind = (status: string) => ({
@@ -393,7 +375,7 @@ const statusVariant = (status: TransferSnapshot["status"]): BadgeVariant => ({
   cancelling: "warning",
   "awaiting-done": "info",
 }[status] || "default") as BadgeVariant
-const statusToneVariant = (value: string): BadgeVariant => ({
+export const statusToneVariant = (value: string): BadgeVariant => ({
   open: "success",
   connected: "success",
   complete: "success",
@@ -411,6 +393,7 @@ const statusToneVariant = (value: string): BadgeVariant => ({
   pending: "warning",
   cancelling: "warning",
   checking: "warning",
+  degraded: "warning",
   disconnected: "warning",
   left: "warning",
   rejected: "warning",
@@ -730,6 +713,7 @@ export const createInitialTuiState = (initialConfig: SessionConfig, showEvents =
   const sessionSeed = normalizeSessionSeed(initialConfig)
   const autoAcceptIncoming = initialConfig.autoAcceptIncoming ?? true
   const autoSaveIncoming = initialConfig.autoSaveIncoming ?? true
+  const overwriteIncoming = !!initialConfig.overwriteIncoming
   const peerSelectionByRoom = new Map<string, Map<string, boolean>>()
   const session = makeSession(sessionSeed, autoAcceptIncoming, autoSaveIncoming, roomPeerSelectionMemory(peerSelectionByRoom, sessionSeed.room))
   const focusState = deriveBootFocusState(sessionSeed.name)
@@ -753,6 +737,7 @@ export const createInitialTuiState = (initialConfig: SessionConfig, showEvents =
     autoOfferOutgoing: launchOptions.offer ?? true,
     autoAcceptIncoming,
     autoSaveIncoming,
+    overwriteIncoming,
     hideTerminalPeers: launchOptions.clean ?? true,
     eventsExpanded: showEvents,
     offeringDrafts: false,
@@ -854,8 +839,7 @@ const renderAboutModal = (_state: TuiState, actions: TuiActions) => {
   title: ABOUT_TITLE,
   content: ui.column({ gap: 1 }, [
     ui.text(ABOUT_INTRO, { id: "about-intro", variant: "heading", wrap: true }),
-    ui.text(ABOUT_SUMMARY, { id: "about-summary", wrap: true }),
-    ui.text(ABOUT_RUNTIME, { id: "about-runtime", wrap: true }),
+    ...ABOUT_BULLETS.map((line, index) => ui.text(line, { id: `about-bullet-${index + 1}`, wrap: true })),
   ]),
   actions: [
     ui.link({
@@ -957,8 +941,7 @@ const renderSelfCard = (state: TuiState, actions: TuiActions) => denseSection({
     ui.text(`-${state.snapshot.localId}`),
   ]),
   ui.row({ gap: 0, wrap: true }, [
-    renderSelfMetric("Signaling", state.snapshot.socketState),
-    renderSelfMetric("Pulse", state.snapshot.pulse.state),
+    renderSelfMetric("Signaling", signalMetricState(state.snapshot.socketState, state.snapshot.pulse)),
     renderSelfMetric("TURN", state.snapshot.turnState),
   ]),
   ui.column({ gap: 0 }, [
@@ -1000,10 +983,10 @@ const renderPeerRow = (peer: PeerSnapshot, turnShareEnabled: boolean, actions: T
     ]),
     ui.row({ gap: 0 }, [
       renderPeerMetric("RTT", formatPeerRtt(peer.rttMs)),
-      renderPeerMetric("Data", peer.dataState, true),
+      renderPeerMetric("TURN", peer.turnState, true),
     ]),
     ui.row({ gap: 0 }, [
-      renderPeerMetric("TURN", peer.turnState, true),
+      renderPeerMetric("Data", peer.dataState, true),
       renderPeerMetric("Path", peer.pathLabel || "—"),
     ]),
     ui.column({ gap: 0 }, [
@@ -1141,7 +1124,7 @@ const transferActionButtons = (transfer: TransferSnapshot, actions: TuiActions):
   return []
 }
 
-const renderTransferFact = (label: string, value: string) => ui.box({ minWidth: 12 }, [
+const renderTransferFact = (label: string, value: string) => ui.box({ minWidth: 12, border: "single", borderStyle: METRIC_BORDER_STYLE }, [
   ui.column({ gap: 0 }, [
     ui.text(label, { variant: "caption" }),
     ui.text(value),
@@ -1267,8 +1250,8 @@ const renderEventsCard = (state: TuiState, actions: TuiActions) => denseSection(
   id: "events-card",
   title: "Events",
   actions: [
+    actionButton("copy-events", "Copy", actions.copyLogs, "secondary", !state.snapshot.logs.length),
     actionButton("clear-events", "Clear", actions.clearLogs, "warning", !state.snapshot.logs.length),
-    actionButton("hide-events", "Hide", actions.toggleEvents),
   ],
 }, [
   ui.box({ maxHeight: 24, overflow: "scroll" }, [
@@ -1385,23 +1368,30 @@ export const startTui = async (initialConfig: SessionConfig, launchOptions: TuiL
       return false
     }
   }
-  const copyInvitePayload = async (payload: string, label: "WEB" | "CLI") => {
-    const closeDropdown = (notice: Notice) => commit(current => withNotice({ ...current, inviteDropdownOpen: false }, notice))
+  const copyTextPayload = async (payload: string, notices: { copied: string; opened: string; failed: string }, finish = (notice: Notice) => commit(current => withNotice(current, notice))) => {
     const rawWrite = getBackendRawWriter(app.backend)
     if (rawWrite && await ensureOsc52Support()) {
       const sequence = buildOsc52ClipboardSequence(payload)
       if (sequence) {
         try {
           rawWrite(sequence)
-          closeDropdown({ text: `Copied ${label} invite.`, variant: "success" })
+          finish({ text: notices.copied, variant: "success" })
           return
         } catch {}
       }
     }
     const opened = openExternalUrl(inviteCopyUrl(payload))
-    closeDropdown(opened
-      ? { text: `Opened ${label} copy link.`, variant: "info" }
-      : { text: `Unable to copy ${label} invite.`, variant: "error" })
+    finish(opened
+      ? { text: notices.opened, variant: "info" }
+      : { text: notices.failed, variant: "error" })
+  }
+  const copyInvitePayload = async (payload: string, label: "WEB" | "CLI") => {
+    const closeDropdown = (notice: Notice) => commit(current => withNotice({ ...current, inviteDropdownOpen: false }, notice))
+    await copyTextPayload(payload, {
+      copied: `Copied ${label} invite.`,
+      opened: `Opened ${label} copy link.`,
+      failed: `Unable to copy ${label} invite.`,
+    }, closeDropdown)
   }
 
   const flushUpdate = () => {
@@ -1676,6 +1666,7 @@ export const startTui = async (initialConfig: SessionConfig, launchOptions: TuiL
       filePreview: resetFilePreview(),
       drafts: [],
       offeringDrafts: false,
+      overwriteIncoming: !!nextSeed.overwriteIncoming,
       ...(options.reseedBootFocus
         ? deriveBootFocusState(nextSeed.name, current.focusRequestEpoch + 1)
         : {
@@ -1751,6 +1742,15 @@ export const startTui = async (initialConfig: SessionConfig, launchOptions: TuiL
     closeInviteDropdown: () => commit(current => current.inviteDropdownOpen ? { ...current, inviteDropdownOpen: false } : current),
     copyWebInvite: () => { void copyInvitePayload(webInviteUrl(state), "WEB") },
     copyCliInvite: () => { void copyInvitePayload(inviteCliText(state), "CLI") },
+    copyLogs: () => {
+      const payload = formatLogsForCopy(state.snapshot.logs)
+      if (!payload) return
+      void copyTextPayload(payload, {
+        copied: "Copied events.",
+        opened: "Opened event copy link.",
+        failed: "Unable to copy events.",
+      })
+    },
     jumpToRandomRoom: () => replaceSession({ ...state.sessionSeed, room: uid(8) }, "Joined a new room."),
     commitRoom,
     setRoomInput: value => commit(current => ({ ...current, roomInput: value })),

package/src/types/bun-runtime.d.ts

@@ -1,5 +1,6 @@
 declare const Bun: {
   file(path: string): Blob & { type: string }
+  main: string
   write(path: string, data: string | Blob | ArrayBuffer | ArrayBufferView): Promise<number>
   sleep(ms: number): Promise<void>
 }