recappi 0.1.14 → 0.1.16

package/dist/index.js

@@ -9,6 +9,127 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
+// src/recordingCore.ts
+function recordingCaptureMappingFromSelection(selection = DEFAULT_RECORDING_SELECTION, sources = DEFAULT_RECORDING_SOURCES) {
+  const source = sources.find((candidate) => candidate.id === selection.sourceId) ?? sources[0];
+  if (!source) {
+    throw new Error("No recording sources are available.");
+  }
+  if (source.kind === "microphone") {
+    return {
+      source,
+      includeSystemAudio: false,
+      includeMicrophone: true,
+      sourceLabel: source.label,
+      micEnabled: true
+    };
+  }
+  return {
+    source,
+    // Current helper support is system-wide capture. App-specific targeting is
+    // represented in the core model, then falls back to system capture until the
+    // Darwin adapter exposes a target app option.
+    includeSystemAudio: true,
+    includeMicrophone: selection.includeMicrophone,
+    sourceLabel: source.label,
+    micEnabled: selection.includeMicrophone
+  };
+}
+function recordingStatusFromSidecarState(state) {
+  switch (state) {
+    case "recording":
+      return "recording";
+    case "stopping":
+    case "finalizing":
+    case "uploading":
+      return "stopping";
+    case "completed":
+    case "cancelled":
+      return "stopped";
+    case "failed":
+      return "error";
+    case "idle":
+    case "starting":
+    default:
+      return "starting";
+  }
+}
+function levelFromRmsDb(rmsDb) {
+  if (typeof rmsDb !== "number" || Number.isNaN(rmsDb)) return 0;
+  return Math.max(0, Math.min(1, (rmsDb + 60) / 60));
+}
+function applyRecordingEventToTelemetry(telemetry, event) {
+  if (event.type === "recording.state") {
+    return {
+      ...telemetry,
+      status: recordingStatusFromSidecarState(event.state),
+      ...event.message && event.state === "failed" ? { error: event.message } : {}
+    };
+  }
+  if (event.type === "audio.level") {
+    const level = levelFromRmsDb(event.rmsDb);
+    if (event.input === "microphone") {
+      return { ...telemetry, level: { ...telemetry.level, mic: level } };
+    }
+    return { ...telemetry, level: { ...telemetry.level, system: level } };
+  }
+  if (event.type === "error") {
+    return { ...telemetry, status: "error", error: event.message };
+  }
+  return telemetry;
+}
+function recordingArtifactFromRecordData(data) {
+  const artifact = data.artifacts.find((item) => item.kind === "recording_session") ?? data.artifacts[0];
+  const metadata = isRecord5(artifact?.metadata) ? artifact.metadata : {};
+  const audioPath = typeof metadata.audioPath === "string" ? metadata.audioPath : typeof artifact?.localPath === "string" ? artifact.localPath : void 0;
+  const durationMs = typeof metadata.durationMs === "number" && Number.isFinite(metadata.durationMs) ? metadata.durationMs : void 0;
+  const sizeBytes = typeof metadata.sizeBytes === "number" && Number.isFinite(metadata.sizeBytes) ? metadata.sizeBytes : void 0;
+  return {
+    sessionId: data.sessionId,
+    ...audioPath ? { audioPath } : {},
+    ...durationMs != null ? { durationMs } : {},
+    ...sizeBytes != null ? { sizeBytes } : {},
+    uploadStatus: "local_only",
+    transcriptionStatus: "not_started"
+  };
+}
+function artifactTelemetryPatch(artifact) {
+  return {
+    savedPath: artifact.audioPath,
+    durationMs: artifact.durationMs,
+    sizeBytes: artifact.sizeBytes
+  };
+}
+function isRecord5(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+var DEFAULT_RECORDING_SOURCES, DEFAULT_RECORDING_SCENES, DEFAULT_RECORDING_SELECTION;
+var init_recordingCore = __esm({
+  "src/recordingCore.ts"() {
+    "use strict";
+    DEFAULT_RECORDING_SOURCES = [
+      {
+        id: "system",
+        kind: "system",
+        label: "System audio",
+        canIncludeMicrophone: true
+      },
+      {
+        id: "microphone",
+        kind: "microphone",
+        label: "Microphone only",
+        canIncludeMicrophone: false
+      }
+    ];
+    DEFAULT_RECORDING_SCENES = [{ id: "default", label: "Default" }];
+    DEFAULT_RECORDING_SELECTION = {
+      sourceId: DEFAULT_RECORDING_SOURCES[0].id,
+      includeMicrophone: true,
+      sceneId: DEFAULT_RECORDING_SCENES[0].id
+    };
+  }
+});
+
 // src/tui/format.ts
 function formatClockMs(ms) {
   if (ms == null || !Number.isFinite(ms) || ms < 0) return "--:--";
@@ -577,8 +698,7 @@ function Header({ active }) {
     ] }),
     /* @__PURE__ */ jsx5(Tab, { num: "1", label: "Overview", active: active === "overview" }),
     /* @__PURE__ */ jsx5(Tab, { num: "2", label: "Jobs", active: active === "jobs" }),
-    /* @__PURE__ */ jsx5(Tab, { num: "3", label: "Account", active: active === "account" }),
-    /* @__PURE__ */ jsx5(Tab, { num: "4", label: "Record", active: active === "record" })
+    /* @__PURE__ */ jsx5(Tab, { num: "3", label: "Account", active: active === "account" })
   ] });
 }
 function Tab({
@@ -1339,10 +1459,175 @@ var init_PermissionPreflightView = __esm({
   }
 });
 
+// src/tui/RecordSetupView.tsx
+import { useState as useState5 } from "react";
+import { Box as Box14, Text as Text14, useInput as useInput5 } from "ink";
+import { jsx as jsx16, jsxs as jsxs13 } from "react/jsx-runtime";
+function levelBar(level, width = 8) {
+  const v = Math.max(0, Math.min(1, level ?? 0));
+  const n = Math.round(v * width);
+  return "\u2587".repeat(n) + "\u2581".repeat(width - n);
+}
+function RecordSetupView({
+  model,
+  onStart,
+  onCancel
+}) {
+  const size = useTerminalSize();
+  const [srcIdx, setSrcIdx] = useState5(0);
+  const [includeMic, setIncludeMic] = useState5(true);
+  const [sceneIdx, setSceneIdx] = useState5(0);
+  const sources = model.sources;
+  const selected = sources[Math.min(srcIdx, Math.max(0, sources.length - 1))];
+  const micApplicable = selected?.canIncludeMicrophone ?? selected?.kind !== "microphone";
+  const wide = size.columns >= 100;
+  useInput5((input, key) => {
+    if (key.upArrow || input === "k") setSrcIdx((i) => Math.max(0, i - 1));
+    else if (key.downArrow || input === "j") setSrcIdx((i) => Math.min(sources.length - 1, i + 1));
+    else if (input === " " && micApplicable) setIncludeMic((m) => !m);
+    else if (input === "s" && model.scenes.length > 1) setSceneIdx((i) => (i + 1) % model.scenes.length);
+    else if (key.return && selected) {
+      onStart({
+        sourceId: selected.id,
+        includeMicrophone: micApplicable ? includeMic : false,
+        sceneId: model.scenes[sceneIdx]?.id
+      });
+    } else if (key.escape) onCancel();
+  });
+  const sourceList = /* @__PURE__ */ jsxs13(Box14, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx16(Text14, { dimColor: true, children: "SOURCE" }),
+    sources.map((s, i) => {
+      const on = i === srcIdx;
+      return /* @__PURE__ */ jsxs13(Text14, { color: on ? "cyan" : void 0, wrap: "truncate-end", children: [
+        on ? "\u25B8 \u25CF " : "  \u25CB ",
+        s.label
+      ] }, s.id);
+    })
+  ] });
+  const preview = /* @__PURE__ */ jsxs13(Box14, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx16(Text14, { dimColor: true, children: "INPUT PREVIEW" }),
+    /* @__PURE__ */ jsx16(Text14, { color: "green", children: levelBar(model.previewLevel, 10) }),
+    /* @__PURE__ */ jsx16(Text14, { dimColor: true, children: "live level of selection" })
+  ] });
+  return /* @__PURE__ */ jsxs13(Box14, { flexDirection: "column", paddingX: 1, children: [
+    /* @__PURE__ */ jsx16(Text14, { bold: true, color: "magenta", children: "New recording" }),
+    /* @__PURE__ */ jsxs13(Box14, { marginTop: 1, flexDirection: wide ? "row" : "column", children: [
+      /* @__PURE__ */ jsx16(Box14, { flexGrow: 1, flexDirection: "column", children: sourceList }),
+      wide ? /* @__PURE__ */ jsx16(Box14, { marginLeft: 4, children: preview }) : null
+    ] }),
+    /* @__PURE__ */ jsxs13(Box14, { marginTop: 1, flexDirection: "column", children: [
+      micApplicable ? /* @__PURE__ */ jsxs13(Text14, { children: [
+        /* @__PURE__ */ jsx16(Text14, { dimColor: true, children: "Microphone  " }),
+        /* @__PURE__ */ jsx16(Text14, { color: includeMic ? "green" : "gray", children: includeMic ? "[x] include mic" : "[ ] include mic" }),
+        /* @__PURE__ */ jsx16(Text14, { dimColor: true, children: "  (space)" })
+      ] }) : /* @__PURE__ */ jsx16(Text14, { dimColor: true, children: "Microphone is the source" }),
+      model.scenes.length > 0 ? /* @__PURE__ */ jsxs13(Text14, { children: [
+        /* @__PURE__ */ jsx16(Text14, { dimColor: true, children: "Scene       " }),
+        /* @__PURE__ */ jsx16(Text14, { children: model.scenes[sceneIdx]?.label ?? "Default" }),
+        model.scenes.length > 1 ? /* @__PURE__ */ jsx16(Text14, { dimColor: true, children: "  (s to change)" }) : null
+      ] }) : null
+    ] }),
+    /* @__PURE__ */ jsx16(Box14, { marginTop: 1, children: /* @__PURE__ */ jsx16(Text14, { dimColor: true, children: "\u2191\u2193 source \xB7 space mic \xB7 \u23CE start recording \xB7 esc cancel" }) })
+  ] });
+}
+var init_RecordSetupView = __esm({
+  "src/tui/RecordSetupView.tsx"() {
+    "use strict";
+    init_terminal();
+  }
+});
+
+// src/tui/RecordingHeroScreen.tsx
+import { useEffect as useEffect2, useState as useState6 } from "react";
+import { Box as Box15, Text as Text15 } from "ink";
+import { jsx as jsx17, jsxs as jsxs14 } from "react/jsx-runtime";
+function waveform(samples, width) {
+  if (width <= 0) return "";
+  const tail = samples.slice(-width);
+  const pad = width - tail.length;
+  const cells = tail.map((v) => {
+    const i = Math.max(0, Math.min(BLOCKS.length - 1, Math.round(Math.max(0, Math.min(1, v)) * (BLOCKS.length - 1))));
+    return BLOCKS[i];
+  });
+  return "\u2581".repeat(Math.max(0, pad)) + cells.join("");
+}
+function RecordingHeroScreen({
+  telemetry,
+  canPause = false,
+  now = () => Date.now()
+}) {
+  const size = useTerminalSize();
+  const [tick, setTick] = useState6(() => now());
+  const [wave, setWave] = useState6([]);
+  useEffect2(() => {
+    const lvl = Math.max(telemetry.level?.system ?? 0, telemetry.level?.mic ?? 0);
+    setWave((w) => [...w.slice(-512), lvl]);
+  }, [telemetry.level]);
+  useEffect2(() => {
+    const id = setInterval(() => setTick(now()), 1e3);
+    return () => clearInterval(id);
+  }, []);
+  const elapsed = telemetry.startedAtMs != null ? formatClockMs(Math.max(0, tick - telemetry.startedAtMs)) : "00:00";
+  const innerWidth = Math.max(10, size.columns - 4);
+  if (telemetry.status === "stopped") {
+    const meta3 = [
+      telemetry.durationMs != null ? formatClockMs(telemetry.durationMs) : null,
+      formatBytes2(telemetry.sizeBytes) || null
+    ].filter(Boolean).join(" \xB7 ");
+    return /* @__PURE__ */ jsxs14(Box15, { flexDirection: "column", paddingX: 1, children: [
+      /* @__PURE__ */ jsx17(Text15, { dimColor: true, children: "recappi \xB7 Recording" }),
+      /* @__PURE__ */ jsxs14(Box15, { marginTop: 1, flexDirection: "column", children: [
+        /* @__PURE__ */ jsx17(Text15, { color: "green", children: "\u2713 Saved to your Mac" }),
+        meta3 ? /* @__PURE__ */ jsx17(Text15, { dimColor: true, children: meta3 }) : null,
+        telemetry.savedPath ? /* @__PURE__ */ jsx17(Text15, { dimColor: true, wrap: "truncate-middle", children: telemetry.savedPath }) : null
+      ] }),
+      /* @__PURE__ */ jsx17(Box15, { marginTop: 1, children: /* @__PURE__ */ jsx17(Text15, { dimColor: true, children: "Transcribe now?  \u23CE yes \xB7 n not now \xB7 esc back" }) })
+    ] });
+  }
+  if (telemetry.status === "error") {
+    return /* @__PURE__ */ jsxs14(Box15, { flexDirection: "column", paddingX: 1, children: [
+      /* @__PURE__ */ jsx17(Text15, { dimColor: true, children: "recappi \xB7 Recording" }),
+      /* @__PURE__ */ jsx17(Box15, { marginTop: 1, children: /* @__PURE__ */ jsx17(Text15, { color: "red", children: telemetry.error ? `Recording error: ${telemetry.error}` : "Recording error" }) }),
+      /* @__PURE__ */ jsx17(Box15, { marginTop: 1, children: /* @__PURE__ */ jsx17(Text15, { dimColor: true, children: "esc back" }) })
+    ] });
+  }
+  const paused = telemetry.status === "paused";
+  const starting = telemetry.status === "starting" || telemetry.status === "stopping";
+  const badge = paused ? "\u23F8 PAUSED" : starting ? "\u2026" : "\u23FA REC";
+  return /* @__PURE__ */ jsxs14(Box15, { flexDirection: "column", paddingX: 1, height: size.rows, children: [
+    /* @__PURE__ */ jsxs14(Text15, { children: [
+      /* @__PURE__ */ jsx17(Text15, { bold: true, color: "magenta", children: "recappi" }),
+      /* @__PURE__ */ jsx17(Text15, { dimColor: true, children: " \xB7 Recording" })
+    ] }),
+    /* @__PURE__ */ jsxs14(Box15, { flexGrow: 1, flexDirection: "column", justifyContent: "center", alignItems: "center", children: [
+      /* @__PURE__ */ jsx17(Text15, { bold: true, color: paused ? "yellow" : "red", children: badge }),
+      /* @__PURE__ */ jsx17(Text15, { bold: true, children: elapsed }),
+      /* @__PURE__ */ jsx17(Box15, { marginTop: 1, children: /* @__PURE__ */ jsx17(Text15, { color: paused ? "gray" : "red", children: waveform(wave, innerWidth) }) }),
+      /* @__PURE__ */ jsx17(Box15, { marginTop: 1, children: /* @__PURE__ */ jsxs14(Text15, { dimColor: true, children: [
+        telemetry.sourceLabel,
+        telemetry.micEnabled ? "  +  Microphone" : ""
+      ] }) })
+    ] }),
+    /* @__PURE__ */ jsx17(Box15, { children: /* @__PURE__ */ jsxs14(Text15, { dimColor: true, children: [
+      "q stop & save",
+      canPause ? ` \xB7 p ${paused ? "resume" : "pause"}` : ""
+    ] }) })
+  ] });
+}
+var BLOCKS;
+var init_RecordingHeroScreen = __esm({
+  "src/tui/RecordingHeroScreen.tsx"() {
+    "use strict";
+    init_format();
+    init_terminal();
+    BLOCKS = " \u2581\u2582\u2583\u2584\u2585\u2586\u2587\u2588";
+  }
+});
+
 // src/tui/AppShell.tsx
-import { useCallback, useEffect as useEffect2, useState as useState5 } from "react";
-import { Box as Box14, Text as Text14, useApp, useInput as useInput5 } from "ink";
-import { Fragment as Fragment4, jsx as jsx16, jsxs as jsxs13 } from "react/jsx-runtime";
+import { useCallback, useEffect as useEffect3, useState as useState7 } from "react";
+import { Box as Box16, Text as Text16, useApp, useInput as useInput6 } from "ink";
+import { Fragment as Fragment4, jsx as jsx18, jsxs as jsxs15 } from "react/jsx-runtime";
 function recordErrorCopy(code, message) {
   switch (code) {
     case "record.helper_unavailable":
@@ -1379,36 +1664,37 @@ function recordErrorCopy(code, message) {
       return { title: "Couldn't start recording.", detail: message, tone: "red" };
   }
 }
-function recordErrorState(error51) {
+function recordErrorState(error51, selection) {
   if (error51 instanceof Error) {
-    const descriptor = isRecord6(error51) && isRecord6(error51.descriptor) ? error51.descriptor : void 0;
+    const descriptor = isRecord7(error51) && isRecord7(error51.descriptor) ? error51.descriptor : void 0;
     return {
       kind: "error",
       message: error51.message,
       code: typeof descriptor?.code === "string" ? descriptor.code : "code" in error51 && typeof error51.code === "string" ? error51.code : void 0,
-      data: isRecord6(error51) ? error51.data : void 0
+      data: isRecord7(error51) ? error51.data : void 0,
+      ...selection ? { selection } : {}
     };
   }
-  return { kind: "error", message: String(error51) };
+  return { kind: "error", message: String(error51), ...selection ? { selection } : {} };
 }
 function permissionItemsFromRecordError(data) {
-  const sidecarError = isRecord6(data) ? data : void 0;
-  const sidecarData = isRecord6(sidecarError?.data) ? sidecarError.data : void 0;
+  const sidecarError = isRecord7(data) ? data : void 0;
+  const sidecarData = isRecord7(sidecarError?.data) ? sidecarError.data : void 0;
   const permission = typeof sidecarData?.permission === "string" ? sidecarData.permission : "";
   const hint = typeof sidecarData?.recovery === "string" ? sidecarData.recovery : void 0;
   const item = permission === "microphone" ? "Microphone" : permission === "screen_recording" ? "Screen Recording" : "Recording";
   return [{ name: item, status: "denied", ...hint ? { hint } : {} }];
 }
 function settingsUrlFromRecordError(data) {
-  const sidecarError = isRecord6(data) ? data : void 0;
-  const sidecarData = isRecord6(sidecarError?.data) ? sidecarError.data : void 0;
+  const sidecarError = isRecord7(data) ? data : void 0;
+  const sidecarData = isRecord7(sidecarError?.data) ? sidecarError.data : void 0;
   const permission = typeof sidecarData?.permission === "string" ? sidecarData.permission : "";
   if (permission === "microphone") {
     return "x-apple.systempreferences:com.apple.preference.security?Privacy_Microphone";
   }
   return "x-apple.systempreferences:com.apple.preference.security?Privacy_ScreenCapture";
 }
-function isRecord6(value) {
+function isRecord7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function AppShell({
@@ -1429,27 +1715,30 @@ function AppShell({
 }) {
   const { exit } = useApp();
   const size = useTerminalSize();
-  const [jobs, setJobs] = useState5([]);
-  const [recordings, setRecordings] = useState5([]);
-  const [recordingsNextCursor, setRecordingsNextCursor] = useState5(null);
-  const [recordingsTotalCount, setRecordingsTotalCount] = useState5(void 0);
-  const [stats, setStats] = useState5(void 0);
-  const [accountStatus, setAccountStatus] = useState5("loading");
-  const [origin, setOrigin] = useState5("");
-  const [stack, setStack] = useState5([{ kind: initialView }]);
-  const [selected, setSelected] = useState5(0);
-  const [spinnerFrame, setSpinnerFrame] = useState5(0);
-  const [loadingMoreRecordings, setLoadingMoreRecordings] = useState5(false);
-  const [loadError, setLoadError] = useState5(void 0);
-  const [notice, setNotice] = useState5(void 0);
-  const [summaryCache, setSummaryCache] = useState5(() => /* @__PURE__ */ new Map());
-  const [transcriptCache, setTranscriptCache] = useState5(
+  const [jobs, setJobs] = useState7([]);
+  const [recordings, setRecordings] = useState7([]);
+  const [recordingsNextCursor, setRecordingsNextCursor] = useState7(null);
+  const [recordingsTotalCount, setRecordingsTotalCount] = useState7(void 0);
+  const [stats, setStats] = useState7(void 0);
+  const [accountStatus, setAccountStatus] = useState7("loading");
+  const [origin, setOrigin] = useState7("");
+  const [stack, setStack] = useState7([{ kind: initialView }]);
+  const [selected, setSelected] = useState7(0);
+  const [spinnerFrame, setSpinnerFrame] = useState7(0);
+  const [loadingMoreRecordings, setLoadingMoreRecordings] = useState7(false);
+  const [loadError, setLoadError] = useState7(void 0);
+  const [notice, setNotice] = useState7(void 0);
+  const [summaryCache, setSummaryCache] = useState7(() => /* @__PURE__ */ new Map());
+  const [transcriptCache, setTranscriptCache] = useState7(
     () => /* @__PURE__ */ new Map()
   );
-  const [audioCache, setAudioCache] = useState5(() => /* @__PURE__ */ new Map());
-  const [downloadedIds, setDownloadedIds] = useState5(() => /* @__PURE__ */ new Set());
-  const [liveRecord, setLiveRecord] = useState5(void 0);
-  const [recordRetryNonce, setRecordRetryNonce] = useState5(0);
+  const [audioCache, setAudioCache] = useState7(() => /* @__PURE__ */ new Map());
+  const [downloadedIds, setDownloadedIds] = useState7(() => /* @__PURE__ */ new Set());
+  const [liveRecord, setLiveRecord] = useState7(void 0);
+  const recordSetupModel = {
+    sources: DEFAULT_RECORDING_SOURCES,
+    scenes: DEFAULT_RECORDING_SCENES
+  };
   const refreshDownloadedIds = useCallback(async () => {
     if (!listDownloadedRecordingIds) return;
     try {
@@ -1457,53 +1746,104 @@ function AppShell({
     } catch {
     }
   }, [listDownloadedRecordingIds]);
-  useEffect2(() => {
+  useEffect3(() => {
     void refreshDownloadedIds();
   }, [refreshDownloadedIds]);
   const screen = stack[stack.length - 1];
+  const beginLiveRecord = useCallback(
+    (selection = DEFAULT_RECORDING_SELECTION) => {
+      const capture = recordingCaptureMappingFromSelection(selection, DEFAULT_RECORDING_SOURCES);
+      const telemetry = {
+        status: "starting",
+        startedAtMs: now(),
+        sourceLabel: capture.sourceLabel,
+        micEnabled: capture.micEnabled
+      };
+      setStack((current) => {
+        const withoutSetup = current[current.length - 1]?.kind === "recordSetup" ? current.slice(0, -1) : current;
+        return [...withoutSetup, { kind: "record" }];
+      });
+      if (!startLiveRecord) {
+        setLiveRecord({
+          kind: "error",
+          code: "record.helper_unavailable",
+          message: "Live recording is not available",
+          selection
+        });
+        return;
+      }
+      setLiveRecord({ kind: "starting", selection, telemetry });
+      startLiveRecord(selection).then((session) => {
+        setLiveRecord((current) => {
+          if (current?.kind !== "starting") return current;
+          return {
+            kind: "live",
+            session,
+            selection,
+            telemetry: { ...current.telemetry, status: "recording" }
+          };
+        });
+      }).catch((error51) => {
+        setLiveRecord(recordErrorState(error51, selection));
+      });
+    },
+    [now, startLiveRecord]
+  );
   const stopLiveRecord = useCallback(async () => {
     const current = liveRecord;
     if (current?.kind === "live") {
-      setLiveRecord({ kind: "starting" });
+      const stoppingTelemetry = { ...current.telemetry, status: "stopping" };
+      setLiveRecord({
+        kind: "stopping",
+        session: current.session,
+        selection: current.selection,
+        telemetry: stoppingTelemetry
+      });
       try {
-        await current.session.stop();
+        const data = await current.session.stop();
+        const artifact = recordingArtifactFromRecordData(data);
+        const fallbackDuration = current.telemetry.startedAtMs != null ? Math.max(0, now() - current.telemetry.startedAtMs) : void 0;
+        setLiveRecord({
+          kind: "stopped",
+          selection: current.selection,
+          artifact,
+          telemetry: {
+            ...stoppingTelemetry,
+            ...artifactTelemetryPatch(artifact),
+            ...artifact.durationMs == null && fallbackDuration != null ? { durationMs: fallbackDuration } : {},
+            status: "stopped"
+          }
+        });
+        void refreshDownloadedIds();
       } catch (error51) {
-        setNotice(error51 instanceof Error ? error51.message : String(error51));
+        setLiveRecord({
+          kind: "error",
+          message: error51 instanceof Error ? error51.message : String(error51)
+        });
       }
+      return;
     }
-    setLiveRecord(void 0);
+    if (current?.kind === "stopped" || current?.kind === "error") setLiveRecord(void 0);
     setStack([{ kind: "overview" }]);
-  }, [liveRecord]);
-  useEffect2(() => {
-    if (screen.kind !== "record") return;
-    if (!startLiveRecord) {
-      setLiveRecord({
-        kind: "error",
-        code: "record.helper_unavailable",
-        message: "Live recording is not available"
+  }, [liveRecord, now, refreshDownloadedIds]);
+  const liveSession = liveRecord?.kind === "live" ? liveRecord.session : void 0;
+  useEffect3(() => {
+    if (!liveSession) return;
+    const session = liveSession;
+    const unsubscribe = session.source.onEvent((event) => {
+      setLiveRecord((current) => {
+        if (current?.kind !== "live" || current.session !== session) return current;
+        return {
+          ...current,
+          telemetry: applyRecordingEventToTelemetry(current.telemetry, event)
+        };
       });
-      return;
-    }
-    let cancelled = false;
-    setLiveRecord({ kind: "starting" });
-    startLiveRecord().then((session) => {
-      if (cancelled) {
-        void session.stop();
-        return;
-      }
-      setLiveRecord({ kind: "live", session });
-    }).catch((error51) => {
-      if (!cancelled) {
-        setLiveRecord(recordErrorState(error51));
-      }
     });
-    return () => {
-      cancelled = true;
-    };
-  }, [screen.kind, startLiveRecord, recordRetryNonce]);
+    return unsubscribe;
+  }, [liveSession]);
   const selectedRecording = screen.kind === "overview" ? recordings[selected] : void 0;
   const peekTranscriptId = selectedRecording?.activeTranscriptId ?? void 0;
-  useEffect2(() => {
+  useEffect3(() => {
     if (!peekTranscriptId || summaryCache.has(peekTranscriptId)) return;
     let cancelled = false;
     const timer = setTimeout(() => {
@@ -1571,13 +1911,13 @@ function AppShell({
       setLoadingMoreRecordings(false);
     }
   }, [fetchRecordings, loadingMoreRecordings, recordingsNextCursor]);
-  useEffect2(() => {
+  useEffect3(() => {
     void refresh({ resetRecordings: true });
     const id = setInterval(() => void refresh(), pollMs);
     return () => clearInterval(id);
   }, [refresh, pollMs]);
   const hasRunning = jobs.some((item) => item.status === "running");
-  useEffect2(() => {
+  useEffect3(() => {
     if (!hasRunning) return;
     const id = setInterval(() => setSpinnerFrame((f) => f + 1), spinnerMs);
     return () => clearInterval(id);
@@ -1591,11 +1931,11 @@ function AppShell({
     }
   }
   const listLength = screen.kind === "jobs" ? jobs.length : screen.kind === "overview" ? recordings.length : 0;
-  useEffect2(() => {
+  useEffect3(() => {
     setSelected((i) => Math.max(0, Math.min(i, Math.max(0, listLength - 1))));
   }, [listLength]);
   const visibleRecordingRows = Math.max(3, size.rows - 6);
-  useEffect2(() => {
+  useEffect3(() => {
     if (screen.kind !== "overview" || !recordingsNextCursor) return;
     const nearLoadedEnd = recordings.length - selected <= RECORDINGS_PREFETCH_REMAINING;
     const underfilledViewport = recordings.length < visibleRecordingRows;
@@ -1628,7 +1968,7 @@ function AppShell({
     [fetchTranscript]
   );
   const detailTranscriptId = screen.kind === "recordingDetail" ? recordings.find((r) => r.recordingId === screen.recordingId)?.activeTranscriptId : void 0;
-  useEffect2(() => {
+  useEffect3(() => {
     if (!detailTranscriptId || transcriptCache.has(detailTranscriptId)) return;
     let cancelled = false;
     setTranscriptCache((m) => new Map(m).set(detailTranscriptId, "loading"));
@@ -1675,18 +2015,26 @@ function AppShell({
     setNotice(void 0);
   };
   const back = () => setStack((st) => st.length > 1 ? st.slice(0, -1) : st);
-  useInput5((input, key) => {
+  useInput6((input, key) => {
     setNotice(void 0);
+    if (screen.kind === "recordSetup") {
+      if (input === "q" || key.leftArrow) back();
+      return;
+    }
     if (screen.kind === "record") {
       if (liveRecord?.kind === "error" && input === "r") {
-        setRecordRetryNonce((value) => value + 1);
+        beginLiveRecord(liveRecord.selection ?? DEFAULT_RECORDING_SELECTION);
         return;
       }
       if (liveRecord?.kind === "error" && input === "o") {
         openUrl2?.(settingsUrlFromRecordError(liveRecord.data));
         return;
       }
-      if (input === "q" || key.escape || key.leftArrow) void stopLiveRecord();
+      if (liveRecord?.kind === "stopped" && key.return) {
+        setNotice("Transcribe handoff is coming next.");
+        return;
+      }
+      if (input === "q" || key.escape || key.leftArrow || input === "n") void stopLiveRecord();
       return;
     }
     if (input === "q") return exit();
@@ -1694,7 +2042,10 @@ function AppShell({
     if (input === "1") return goTab("overview");
     if (input === "2") return goTab("jobs");
     if (input === "3") return goTab("account");
-    if (input === "4") return goTab("record");
+    if (input === "n") {
+      setStack((st) => [...st, { kind: "recordSetup" }]);
+      return;
+    }
     if (input === "r") return void refresh({ resetRecordings: true });
     if (screen.kind === "overview") {
       if (key.upArrow || input === "k") setSelected((i) => Math.max(0, i - 1));
@@ -1741,18 +2092,18 @@ function AppShell({
     }
   });
   if (screen.kind === "transcript") {
-    return /* @__PURE__ */ jsx16(TranscriptView, { loading: screen.loading, data: screen.data, error: screen.error });
+    return /* @__PURE__ */ jsx18(TranscriptView, { loading: screen.loading, data: screen.data, error: screen.error });
   }
   if (screen.kind === "jobDetail") {
     const job = jobs.find((j) => j.jobId === screen.jobId);
-    if (!job) return /* @__PURE__ */ jsx16(Missing, { label: "Job" });
-    return /* @__PURE__ */ jsx16(Detail, { notice, children: /* @__PURE__ */ jsx16(JobDetailView, { item: job, origin, spinnerFrame, nowMs: now() }) });
+    if (!job) return /* @__PURE__ */ jsx18(Missing, { label: "Job" });
+    return /* @__PURE__ */ jsx18(Detail, { notice, children: /* @__PURE__ */ jsx18(JobDetailView, { item: job, origin, spinnerFrame, nowMs: now() }) });
   }
   if (screen.kind === "recordingDetail") {
     const rec = recordings.find((r) => r.recordingId === screen.recordingId);
-    if (!rec) return /* @__PURE__ */ jsx16(Missing, { label: "Recording" });
+    if (!rec) return /* @__PURE__ */ jsx18(Missing, { label: "Recording" });
     const detailTranscript = rec.activeTranscriptId ? transcriptCache.get(rec.activeTranscriptId) : void 0;
-    return /* @__PURE__ */ jsx16(Detail, { notice, children: /* @__PURE__ */ jsx16(
+    return /* @__PURE__ */ jsx18(Detail, { notice, children: /* @__PURE__ */ jsx18(
       RecordingDetailView,
       {
         item: rec,
@@ -1762,23 +2113,35 @@ function AppShell({
       }
     ) });
   }
+  if (screen.kind === "recordSetup") {
+    return /* @__PURE__ */ jsx18(Box16, { flexDirection: "column", height: size.rows, paddingX: 1, children: /* @__PURE__ */ jsx18(
+      RecordSetupView,
+      {
+        model: recordSetupModel,
+        onStart: beginLiveRecord,
+        onCancel: () => setStack((st) => st.length > 1 ? st.slice(0, -1) : [{ kind: "overview" }])
+      }
+    ) });
+  }
   if (screen.kind === "record") {
-    if (liveRecord?.kind === "live") {
-      return /* @__PURE__ */ jsx16(LiveCaptionsScreen, { source: liveRecord.session.source, now });
+    if (liveRecord?.kind === "live" && liveRecord.session.mode === "live_captions") {
+      return /* @__PURE__ */ jsx18(LiveCaptionsScreen, { source: liveRecord.session.source, now });
+    }
+    if (liveRecord?.kind === "live" || liveRecord?.kind === "starting" || liveRecord?.kind === "stopping" || liveRecord?.kind === "stopped") {
+      return /* @__PURE__ */ jsx18(Detail, { notice, children: /* @__PURE__ */ jsx18(RecordingHeroScreen, { telemetry: liveRecord.telemetry, now }) });
     }
-    return /* @__PURE__ */ jsxs13(Box14, { flexDirection: "column", height: size.rows, paddingX: 1, children: [
-      /* @__PURE__ */ jsx16(Header, { active: "record" }),
-      /* @__PURE__ */ jsx16(Box14, { flexGrow: 1, flexDirection: "column", paddingX: 1, paddingTop: 1, children: liveRecord?.kind === "error" ? (() => {
+    return /* @__PURE__ */ jsxs15(Box16, { flexDirection: "column", height: size.rows, paddingX: 1, children: [
+      /* @__PURE__ */ jsx18(Box16, { flexGrow: 1, flexDirection: "column", paddingX: 1, paddingTop: 1, children: liveRecord?.kind === "error" ? (() => {
         if (liveRecord.code === "record.permission_required") {
-          return /* @__PURE__ */ jsx16(PermissionPreflightView, { items: permissionItemsFromRecordError(liveRecord.data) });
+          return /* @__PURE__ */ jsx18(PermissionPreflightView, { items: permissionItemsFromRecordError(liveRecord.data) });
         }
         const copy = recordErrorCopy(liveRecord.code, liveRecord.message);
-        return /* @__PURE__ */ jsxs13(Fragment4, { children: [
-          /* @__PURE__ */ jsx16(Text14, { color: copy.tone, children: copy.title }),
-          copy.detail ? /* @__PURE__ */ jsx16(Text14, { dimColor: true, children: copy.detail }) : null
+        return /* @__PURE__ */ jsxs15(Fragment4, { children: [
+          /* @__PURE__ */ jsx18(Text16, { color: copy.tone, children: copy.title }),
+          copy.detail ? /* @__PURE__ */ jsx18(Text16, { dimColor: true, children: copy.detail }) : null
         ] });
-      })() : /* @__PURE__ */ jsx16(Text14, { dimColor: true, children: "Starting live recording\u2026" }) }),
-      /* @__PURE__ */ jsx16(Footer, { keys: "q / esc / \u2190 back" })
+      })() : /* @__PURE__ */ jsx18(Text16, { dimColor: true, children: "Starting recording\u2026" }) }),
+      /* @__PURE__ */ jsx18(Footer, { keys: "r retry \xB7 o settings \xB7 q / esc / \u2190 back" })
     ] });
   }
   const tab = screen.kind === "jobs" ? "jobs" : screen.kind === "account" ? "account" : "overview";
@@ -1796,7 +2159,7 @@ function AppShell({
     const showPeek = size.columns >= 100;
     const peekWidth = showPeek ? 34 : 0;
     const listColumns = showPeek ? Math.max(30, size.columns - peekWidth - 3) : size.columns;
-    body = /* @__PURE__ */ jsx16(
+    body = /* @__PURE__ */ jsx18(
       OverviewView,
       {
         recordings: recordings.slice(win.start, win.end),
@@ -1816,11 +2179,11 @@ function AppShell({
     );
   } else if (screen.kind === "account") {
     position = "";
-    body = /* @__PURE__ */ jsx16(AccountView, { status: accountStatus });
+    body = /* @__PURE__ */ jsx18(AccountView, { status: accountStatus });
   } else {
     const win = listWindow(selected, jobs.length, Math.max(3, size.rows - 4));
     position = jobs.length ? `${selected + 1} / ${jobs.length}` : "0";
-    body = /* @__PURE__ */ jsx16(
+    body = /* @__PURE__ */ jsx18(
       JobsView,
       {
         items: jobs.slice(win.start, win.end),
@@ -1829,35 +2192,35 @@ function AppShell({
       }
     );
   }
-  const footerKeys = screen.kind === "jobs" ? `${position}  \xB7  \u2191\u2193 select \xB7 \u23CE job \xB7 t transcript \xB7 1 overview \xB7 3 account \xB7 4 record \xB7 r refresh \xB7 q quit` : screen.kind === "account" ? "3 account  \xB7  1 overview \xB7 2 jobs \xB7 4 record \xB7 r refresh \xB7 q quit" : `${position}  \xB7  \u2191\u2193 scroll \xB7 \u23CE open \xB7 t transcript \xB7 2 jobs \xB7 3 account \xB7 4 record \xB7 r refresh \xB7 q quit`;
-  return /* @__PURE__ */ jsxs13(Box14, { flexDirection: "column", height: size.rows, paddingX: 1, children: [
-    /* @__PURE__ */ jsx16(Header, { active: tab }),
-    /* @__PURE__ */ jsxs13(Box14, { flexGrow: 1, flexDirection: "column", children: [
+  const footerKeys = screen.kind === "jobs" ? `${position}  \xB7  \u2191\u2193 select \xB7 \u23CE job \xB7 t transcript \xB7 n record \xB7 1 overview \xB7 3 account \xB7 r refresh \xB7 q quit` : screen.kind === "account" ? "3 account  \xB7  n record \xB7 1 overview \xB7 2 jobs \xB7 r refresh \xB7 q quit" : `${position}  \xB7  \u2191\u2193 scroll \xB7 \u23CE open \xB7 t transcript \xB7 n record \xB7 2 jobs \xB7 3 account \xB7 r refresh \xB7 q quit`;
+  return /* @__PURE__ */ jsxs15(Box16, { flexDirection: "column", height: size.rows, paddingX: 1, children: [
+    /* @__PURE__ */ jsx18(Header, { active: tab }),
+    /* @__PURE__ */ jsxs15(Box16, { flexGrow: 1, flexDirection: "column", children: [
       body,
-      loadError && jobs.length === 0 && recordings.length === 0 ? /* @__PURE__ */ jsx16(Box14, { marginTop: 1, children: /* @__PURE__ */ jsxs13(Text14, { color: "red", children: [
+      loadError && jobs.length === 0 && recordings.length === 0 ? /* @__PURE__ */ jsx18(Box16, { marginTop: 1, children: /* @__PURE__ */ jsxs15(Text16, { color: "red", children: [
         "! ",
         loadError
       ] }) }) : null
     ] }),
-    /* @__PURE__ */ jsx16(Footer, { keys: footerKeys })
+    /* @__PURE__ */ jsx18(Footer, { keys: footerKeys })
   ] });
 }
 function Detail({
   notice,
   children
 }) {
-  return /* @__PURE__ */ jsxs13(Box14, { flexDirection: "column", children: [
+  return /* @__PURE__ */ jsxs15(Box16, { flexDirection: "column", children: [
     children,
-    notice ? /* @__PURE__ */ jsx16(Box14, { paddingX: 1, children: /* @__PURE__ */ jsx16(Text14, { color: "green", children: notice }) }) : null
+    notice ? /* @__PURE__ */ jsx18(Box16, { paddingX: 1, children: /* @__PURE__ */ jsx18(Text16, { color: "green", children: notice }) }) : null
   ] });
 }
 function Missing({ label }) {
-  return /* @__PURE__ */ jsxs13(Box14, { flexDirection: "column", paddingX: 1, children: [
-    /* @__PURE__ */ jsxs13(Text14, { dimColor: true, children: [
+  return /* @__PURE__ */ jsxs15(Box16, { flexDirection: "column", paddingX: 1, children: [
+    /* @__PURE__ */ jsxs15(Text16, { dimColor: true, children: [
       label,
       " no longer in the list."
     ] }),
-    /* @__PURE__ */ jsx16(Text14, { dimColor: true, children: "esc back \xB7 q quit" })
+    /* @__PURE__ */ jsx18(Text16, { dimColor: true, children: "esc back \xB7 q quit" })
   ] });
 }
 var RECORDINGS_PAGE_SIZE, RECORDINGS_PREFETCH_REMAINING;
@@ -1873,6 +2236,9 @@ var init_AppShell = __esm({
     init_TranscriptView();
     init_LiveCaptionsScreen();
     init_PermissionPreflightView();
+    init_RecordSetupView();
+    init_RecordingHeroScreen();
+    init_recordingCore();
     init_format();
     init_terminal();
     RECORDINGS_PAGE_SIZE = 50;
@@ -1891,7 +2257,7 @@ __export(tui_exports, {
   runDashboard: () => runDashboard,
   useTerminalSize: () => useTerminalSize
 });
-import React7 from "react";
+import React9 from "react";
 import { render as render2 } from "ink";
 import { spawn as spawn3 } from "child_process";
 function openUrl(url2) {
@@ -1912,7 +2278,7 @@ function copyText(text) {
 async function runDashboard(deps) {
   const renderApp = deps.renderApp ?? render2;
   const app = renderApp(
-    React7.createElement(AppShell, {
+    React9.createElement(AppShell, {
       fetchJobs: deps.fetchJobs,
       fetchTranscript: deps.fetchTranscript,
       fetchRecordings: deps.fetchRecordings,
@@ -19502,6 +19868,7 @@ import { createRequire as createRequire2 } from "module";
 import { dirname, join } from "path";
 import { fileURLToPath } from "url";
 import { render, useInput as useInput2 } from "ink";
+init_recordingCore();
 
 // src/sidecar.ts
 import { spawn as spawn2 } from "child_process";
@@ -19662,7 +20029,7 @@ var MiniSidecarClient = class {
   }
 };
 function sidecarErrorToCliError(error51) {
-  const data = isRecord5(error51.data) ? error51.data : void 0;
+  const data = isRecord6(error51.data) ? error51.data : void 0;
   const maybeCode = typeof data?.cliCode === "string" ? cliErrorCodeSchema.safeParse(data.cliCode) : void 0;
   const hint = typeof data?.recovery === "string" ? data.recovery : void 0;
   const retryable = typeof data?.retryable === "boolean" ? data.retryable : error51.code >= -32099 && error51.code <= -32e3;
@@ -19679,7 +20046,7 @@ function sidecarErrorToCliError(error51) {
     retryable
   });
 }
-function isRecord5(value) {
+function isRecord6(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function spawnMiniSidecar(opts) {
@@ -19745,13 +20112,21 @@ async function recordViaSidecar(opts) {
     session?.close();
   }
 }
-async function startLiveRecordSession(opts) {
-  const session = await startRecordSession({ ...opts, live: false });
+async function startLiveRecordSession(opts, selection = {
+  sourceId: DEFAULT_RECORDING_SOURCES[0].id,
+  includeMicrophone: true
+}, sources = DEFAULT_RECORDING_SOURCES) {
+  const capture = recordingCaptureMappingFromSelection(selection, sources);
+  const session = await startRecordSession({
+    ...opts,
+    includeSystemAudio: capture.includeSystemAudio,
+    includeMicrophone: capture.includeMicrophone,
+    live: false
+  });
   return {
+    mode: "local",
     source: session.source,
-    stop: async () => {
-      await session.stop();
-    }
+    stop: session.stop
   };
 }
 async function startRecordSession(opts) {
@@ -20076,24 +20451,27 @@ async function runCli(deps = {}) {
         recordingAudio,
         listDownloadedRecordingIds: () => recordingAudio.listDownloadedRecordingIds(),
         listDownloads: () => recordingAudio.listDownloads(),
-        startLiveRecord: async () => {
+        startLiveRecord: async (selection) => {
           const liveStatus = await client.authStatus();
           if (!liveStatus.loggedIn || !liveStatus.userId) {
             throw cliError("auth.not_logged_in", "Sign in before starting a sidecar recording.", {
               hint: "Run recappi auth login, or import the Recappi Mini session with recappi auth import-macos."
             });
           }
-          return startLiveRecordSession({
-            account: {
-              backendOrigin: auth.origin,
-              userId: liveStatus.userId,
-              ...liveStatus.email ? { email: liveStatus.email } : {}
+          return startLiveRecordSession(
+            {
+              account: {
+                backendOrigin: auth.origin,
+                userId: liveStatus.userId,
+                ...liveStatus.email ? { email: liveStatus.email } : {}
+              },
+              cliVersion: CLI_VERSION,
+              env: deps.env,
+              homeDir: deps.homeDir,
+              runtime: deps.recordRuntime
             },
-            cliVersion: CLI_VERSION,
-            env: deps.env,
-            homeDir: deps.homeDir,
-            runtime: deps.recordRuntime
-          });
+            selection
+          );
         },
         initialView: parsed.initialView
       });