recappi 0.1.76 → 0.1.78

package/dist/index.js

@@ -84,7 +84,7 @@ function isLiveCaptionSidecarError(code) {
 }
 function recordingArtifactFromRecordData(data) {
   const artifact = data.artifacts.find((item) => item.kind === "recording_session") ?? data.artifacts[0];
-  const metadata = isRecord5(artifact?.metadata) ? artifact.metadata : {};
+  const metadata = isRecord6(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;
@@ -104,7 +104,7 @@ function artifactTelemetryPatch(artifact) {
     sizeBytes: artifact.sizeBytes
   };
 }
-function isRecord5(value) {
+function isRecord6(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 var DEFAULT_RECORDING_SOURCES, DEFAULT_RECORDING_SCENES, DEFAULT_RECORDING_SELECTION;
@@ -977,7 +977,8 @@ function OverviewView({
   peekItem,
   peekSummary,
   showPeek = false,
-  peekWidth = 0
+  peekWidth = 0,
+  revalidating = false
 }) {
   const jobCounts = countJobs(jobs);
   const running = stats?.jobs.running ?? jobCounts.running;
@@ -998,7 +999,8 @@ function OverviewView({
         /* @__PURE__ */ jsx12(Text10, { dimColor: true, children: "  \xB7  " }),
         /* @__PURE__ */ jsx12(Text10, { color: "yellow", children: `${queued} queued` })
       ] }) : null,
-      stats?.recordings.totalDurationMs != null ? /* @__PURE__ */ jsx12(Text10, { dimColor: true, children: `  \xB7  ${formatClockMs(stats.recordings.totalDurationMs)} transcribed` }) : null
+      stats?.recordings.totalDurationMs != null ? /* @__PURE__ */ jsx12(Text10, { dimColor: true, children: `  \xB7  ${formatClockMs(stats.recordings.totalDurationMs)} transcribed` }) : null,
+      revalidating ? /* @__PURE__ */ jsx12(Text10, { dimColor: true, children: `  \xB7  ${"\u280B\u2819\u2839\u2838\u283C\u2834\u2826\u2827\u2807\u280F"[spinnerFrame % 10]} syncing` }) : null
     ] }),
     /* @__PURE__ */ jsxs9(Box10, { flexDirection: "row", alignItems: "flex-start", children: [
       /* @__PURE__ */ jsx12(Box10, { flexGrow: 1, flexDirection: "column", children: /* @__PURE__ */ jsx12(
@@ -1877,20 +1879,20 @@ function recordErrorCopy(code, message) {
 }
 function recordErrorState(error51, selection) {
   if (error51 instanceof Error) {
-    const descriptor = isRecord8(error51) && isRecord8(error51.descriptor) ? error51.descriptor : void 0;
+    const descriptor = isRecord9(error51) && isRecord9(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: isRecord8(error51) ? error51.data : void 0,
+      data: isRecord9(error51) ? error51.data : void 0,
       ...selection ? { selection } : {}
     };
   }
   return { kind: "error", message: String(error51), ...selection ? { selection } : {} };
 }
 function transcribeHandoffErrorCopy(error51) {
-  const descriptor = error51 instanceof Error && isRecord8(error51) && isRecord8(error51.descriptor) ? error51.descriptor : void 0;
-  const code = typeof descriptor?.code === "string" ? descriptor.code : isRecord8(error51) && typeof error51.code === "string" ? error51.code : void 0;
+  const descriptor = error51 instanceof Error && isRecord9(error51) && isRecord9(error51.descriptor) ? error51.descriptor : void 0;
+  const code = typeof descriptor?.code === "string" ? descriptor.code : isRecord9(error51) && typeof error51.code === "string" ? error51.code : void 0;
   switch (code) {
     case "auth.not_logged_in":
       return "Sign in to Recappi before transcribing this recording.";
@@ -1964,8 +1966,8 @@ function recordFrameTitle(recordings, recordingId) {
   return recording ? recordingTitle2(recording) : "New recording";
 }
 function permissionItemsFromRecordError(data) {
-  const sidecarError = isRecord8(data) ? data : void 0;
-  const sidecarData = isRecord8(sidecarError?.data) ? sidecarError.data : void 0;
+  const sidecarError = isRecord9(data) ? data : void 0;
+  const sidecarData = isRecord9(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 requiresProcessRestart = sidecarData?.requiresProcessRestart === true || sidecarData?.requiresProcessRestart === "true";
@@ -1980,21 +1982,22 @@ function permissionItemsFromRecordError(data) {
   ];
 }
 function settingsUrlFromRecordError(data) {
-  const sidecarError = isRecord8(data) ? data : void 0;
-  const sidecarData = isRecord8(sidecarError?.data) ? sidecarError.data : void 0;
+  const sidecarError = isRecord9(data) ? data : void 0;
+  const sidecarData = isRecord9(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 isRecord8(value) {
+function isRecord9(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function AppShell({
   fetchJobs,
   fetchTranscript,
   fetchRecordings,
+  fetchCachedRecordings,
   fetchDashboardStats,
   fetchAccountStatus,
   recordingAudio,
@@ -2028,6 +2031,7 @@ function AppShell({
   const [selected, setSelected] = useState8(0);
   const [spinnerFrame, setSpinnerFrame] = useState8(0);
   const [loadingMoreRecordings, setLoadingMoreRecordings] = useState8(false);
+  const [revalidatingRecordings, setRevalidatingRecordings] = useState8(false);
   const [loaded, setLoaded] = useState8(false);
   const [loadError, setLoadError] = useState8(void 0);
   const [notice, setNotice] = useState8(void 0);
@@ -2067,6 +2071,12 @@ function AppShell({
     void refreshDownloadedIds();
   }, [refreshDownloadedIds]);
   const screen = stack[stack.length - 1];
+  const recordingsRef = useRef3(recordings);
+  recordingsRef.current = recordings;
+  const selectedRef = useRef3(selected);
+  selectedRef.current = selected;
+  const screenRef = useRef3(screen);
+  screenRef.current = screen;
   useEffect4(() => {
     if (screen.kind !== "recordSetup" || !startRecordSetupPreview) return;
     let cancelled = false;
@@ -2245,6 +2255,21 @@ function AppShell({
   }, [peekTranscriptId, fetchTranscript]);
   const peekSummary = peekTranscriptId ? summaryCache.get(peekTranscriptId) : void 0;
   const refresh = useCallback(async ({ resetRecordings = false } = {}) => {
+    let showingCachedRecordings = false;
+    if (resetRecordings && fetchCachedRecordings) {
+      try {
+        const cached2 = await fetchCachedRecordings({ limit: RECORDINGS_PAGE_SIZE });
+        if (cached2.items.length > 0) {
+          showingCachedRecordings = true;
+          setRecordings(cached2.items);
+          setRecordingsNextCursor(cached2.nextCursor ?? null);
+          setRecordingsTotalCount(cached2.totalCount);
+          setLoaded(true);
+          setRevalidatingRecordings(Boolean(fetchRecordings));
+        }
+      } catch {
+      }
+    }
     const [jobsR, recR, statsR, accountR] = await Promise.allSettled([
       fetchJobs(),
       resetRecordings && fetchRecordings ? fetchRecordings({ limit: RECORDINGS_PAGE_SIZE }) : Promise.resolve(void 0),
@@ -2259,9 +2284,15 @@ function AppShell({
       setLoadError(jobsR.reason instanceof Error ? jobsR.reason.message : String(jobsR.reason));
     }
     if (recR.status === "fulfilled" && recR.value) {
-      setRecordings(recR.value.items);
+      const prevSelectedId = screenRef.current.kind === "overview" ? recordingsRef.current[selectedRef.current]?.recordingId : void 0;
+      const freshItems = recR.value.items;
+      setRecordings(freshItems);
       setRecordingsNextCursor(recR.value.nextCursor ?? null);
       setRecordingsTotalCount(recR.value.totalCount);
+      if (prevSelectedId) {
+        const idx = freshItems.findIndex((r) => r.recordingId === prevSelectedId);
+        setSelected((s) => idx >= 0 ? idx : Math.min(s, Math.max(0, freshItems.length - 1)));
+      }
     }
     if (statsR.status === "fulfilled" && statsR.value) setStats(statsR.value);
     if (accountR.status === "fulfilled") {
@@ -2270,7 +2301,8 @@ function AppShell({
       setAccountStatus("error");
     }
     setLoaded(true);
-  }, [fetchJobs, fetchRecordings, fetchDashboardStats, fetchAccountStatus]);
+    if (showingCachedRecordings) setRevalidatingRecordings(false);
+  }, [fetchJobs, fetchRecordings, fetchCachedRecordings, fetchDashboardStats, fetchAccountStatus]);
   const transcribeStoppedRecording = useCallback(async () => {
     const current = liveRecord;
     if (current?.kind !== "stopped") return;
@@ -2933,7 +2965,8 @@ function AppShell({
         peekItem: recordings[selected],
         peekSummary,
         showPeek,
-        peekWidth
+        peekWidth,
+        revalidating: revalidatingRecordings
       }
     );
   } else if (screen.kind === "account") {
@@ -3051,6 +3084,7 @@ async function runDashboard(deps) {
       fetchJobs: deps.fetchJobs,
       fetchTranscript: deps.fetchTranscript,
       fetchRecordings: deps.fetchRecordings,
+      fetchCachedRecordings: deps.fetchCachedRecordings,
       fetchDashboardStats: deps.fetchDashboardStats,
       fetchAccountStatus: deps.fetchAccountStatus,
       recordingAudio: deps.recordingAudio,
@@ -3859,10 +3893,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path7) {
-  if (!path7)
+function getElementAtPath(obj, path8) {
+  if (!path8)
     return obj;
-  return path7.reduce((acc, key) => acc?.[key], obj);
+  return path8.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -4271,11 +4305,11 @@ function explicitlyAborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path7, issues) {
+function prefixIssues(path8, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path7);
+    iss.path.unshift(path8);
     return iss;
   });
 }
@@ -4422,16 +4456,16 @@ function flattenError(error51, mapper = (issue2) => issue2.message) {
 }
 function formatError(error51, mapper = (issue2) => issue2.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error52, path7 = []) => {
+  const processError = (error52, path8 = []) => {
     for (const issue2 of error52.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path7, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path8, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path7, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path8, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path7, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path8, ...issue2.path]);
       } else {
-        const fullpath = [...path7, ...issue2.path];
+        const fullpath = [...path8, ...issue2.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue2));
         } else {
@@ -4458,17 +4492,17 @@ function formatError(error51, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error51, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error52, path7 = []) => {
+  const processError = (error52, path8 = []) => {
     var _a3, _b;
     for (const issue2 of error52.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path7, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path8, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path7, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path8, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path7, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path8, ...issue2.path]);
       } else {
-        const fullpath = [...path7, ...issue2.path];
+        const fullpath = [...path8, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -4500,8 +4534,8 @@ function treeifyError(error51, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path7 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path7) {
+  const path8 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path8) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -17193,13 +17227,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path7 = ref.slice(1).split("/").filter(Boolean);
-  if (path7.length === 0) {
+  const path8 = ref.slice(1).split("/").filter(Boolean);
+  if (path8.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path7[0] === defsKey) {
-    const key = path7[1];
+  if (path8[0] === defsKey) {
+    const key = path8[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -18884,6 +18918,9 @@ function defaultStorePath(homeDir = os3.homedir(), env = process.env) {
   const dataHome = env.XDG_DATA_HOME?.trim() || path3.join(homeDir, ".local", "share");
   return path3.join(dataHome, "recappi", "cli-state.sqlite");
 }
+function normalizeAccountStamp(input) {
+  return parseAccountPartition(input, "lenient");
+}
 function requireAccountPartition(input) {
   const account = parseAccountPartition(input, "strict");
   if (!account) {
@@ -18900,6 +18937,30 @@ function requireAccountPartition(input) {
 function openCliStore(opts = {}) {
   return new CliLocalStore(opts);
 }
+function isLocalStoreUnavailableError(error51) {
+  return typeof error51 === "object" && error51 !== null && error51.localStoreUnavailable === true;
+}
+var warnedLocalStoreUnavailable = false;
+function tryOpenCliStore(opts = {}) {
+  const { onUnavailable, open = openCliStore, ...storeOpts } = opts;
+  try {
+    return open(storeOpts);
+  } catch (error51) {
+    if (isLocalStoreUnavailableError(error51)) {
+      if (!warnedLocalStoreUnavailable) {
+        warnedLocalStoreUnavailable = true;
+        (onUnavailable ?? defaultWarnLocalStoreUnavailable)();
+      }
+      return null;
+    }
+    throw error51;
+  }
+}
+function defaultWarnLocalStoreUnavailable() {
+  process.stderr.write(
+    "Local cache unavailable (needs Node.js 22+ for node:sqlite). Cloud commands work normally.\n"
+  );
+}
 var CliLocalStore = class {
   db;
   now;
@@ -19195,9 +19256,11 @@ function suppressNodeSqliteWarning(run) {
     return run();
   } catch (error51) {
     if (isMissingNodeSqlite(error51)) {
-      throw cliError("internal.unexpected", "Local SQLite store requires Node.js 22 or newer.", {
+      const err = cliError("internal.unexpected", "Local SQLite store requires Node.js 22 or newer.", {
         hint: "Upgrade Node.js, then retry. Cloud-only commands that do not touch local state can still run."
       });
+      err.localStoreUnavailable = true;
+      throw err;
     }
     throw error51;
   } finally {
@@ -19524,21 +19587,23 @@ var RecappiApiClient = class {
     let accountScopedArtifacts = 0;
     let unattributedArtifacts = 0;
     if (status.loggedIn && status.userId) {
-      const store = openCliStore({
+      const store = tryOpenCliStore({
         dbPath: storePath,
         env: this.env,
         homeDir: this.homeDir
       });
-      try {
-        const account = requireAccountPartition({
-          backendOrigin: this.auth.origin,
-          userId: status.userId
-        });
-        store.recordAccountSeen(account, status.email);
-        accountScopedArtifacts = store.listLocalArtifactsForAccount(account).length;
-        unattributedArtifacts = store.listUnattributedLocalArtifacts().length;
-      } finally {
-        store.close();
+      if (store) {
+        try {
+          const account = requireAccountPartition({
+            backendOrigin: this.auth.origin,
+            userId: status.userId
+          });
+          store.recordAccountSeen(account, status.email);
+          accountScopedArtifacts = store.listLocalArtifactsForAccount(account).length;
+          unattributedArtifacts = store.listUnattributedLocalArtifacts().length;
+        } finally {
+          store.close();
+        }
       }
     }
     const billing = status.loggedIn ? await this.billingStatus() : void 0;
@@ -19791,12 +19856,12 @@ var RecappiApiClient = class {
       } : {}
     };
   }
-  async getJson(path7) {
-    const response = await this.request("GET", path7);
+  async getJson(path8) {
+    const response = await this.request("GET", path8);
     return await parseJson(response);
   }
-  async postJson(path7, body) {
-    const response = await this.request("POST", path7, JSON.stringify(body), {
+  async postJson(path8, body) {
+    const response = await this.request("POST", path8, JSON.stringify(body), {
       headers: { "content-type": "application/json" }
     });
     return await parseJson(response);
@@ -20187,8 +20252,11 @@ import { promises as fs4 } from "fs";
 import path5 from "path";
 function createRecordingAudioRuntime(client, deps = {}) {
   const downloadRecordingAudioFile = async (recordingId, opts) => {
-    const cached2 = opts?.directory ? null : await findReusableDownload(recordingId, deps);
-    if (cached2) return cached2;
+    const cached2 = await findReusableDownload(recordingId, deps);
+    if (cached2) {
+      if (!opts?.directory) return cached2;
+      return materializeCachedDownload(recordingId, cached2, opts, deps);
+    }
     const directory = opts?.directory ?? (deps.account ? defaultDownloadDirectory(deps) : void 0);
     const download = await client.downloadRecordingAudio(recordingId, {
       ...opts,
@@ -20216,6 +20284,38 @@ function createRecordingAudioRuntime(client, deps = {}) {
     )
   };
 }
+async function materializeCachedDownload(recordingId, cached2, opts, deps) {
+  if (!opts.directory) return cached2;
+  await fs4.mkdir(opts.directory, { recursive: true });
+  const contentType = cached2.contentType ?? contentTypeForAudioPath(cached2.localPath);
+  const targetPath = path5.join(
+    opts.directory,
+    recordingAudioFileName(recordingId, opts.title, contentType, opts.filenameStem)
+  );
+  if (path5.resolve(cached2.localPath) !== path5.resolve(targetPath)) {
+    await fs4.copyFile(cached2.localPath, targetPath);
+  }
+  const contentLength = cached2.contentLength ?? (await fs4.stat(targetPath)).size;
+  const artifact = await rememberDownload(
+    {
+      recordingId,
+      localPath: targetPath,
+      contentType,
+      contentLength,
+      origin: cached2.origin ?? ""
+    },
+    deps
+  );
+  return {
+    recordingId,
+    localPath: targetPath,
+    reused: true,
+    ...artifact ? { artifactId: artifact.id } : {},
+    contentType,
+    contentLength,
+    ...cached2.origin ? { origin: cached2.origin } : {}
+  };
+}
 function openPath(localPath, deps = {}) {
   return runMacOpen([localPath], deps);
 }
@@ -20232,7 +20332,7 @@ async function findReusableDownload(recordingId, deps) {
     if (!artifact || !await isReadableFile(artifact.localPath)) return null;
     const opened = store.markLocalArtifactOpened(artifact.id);
     return artifactToDownload(opened, recordingId);
-  });
+  }, null);
 }
 async function rememberDownload(download, deps) {
   return withStore(deps, (store, account) => {
@@ -20246,16 +20346,17 @@ async function rememberDownload(download, deps) {
         resource: "recording_audio",
         contentType: download.contentType,
         ...download.contentLength !== void 0 ? { contentLength: download.contentLength } : {},
-        origin: download.origin
+        ...download.origin ? { origin: download.origin } : {}
       }
     });
     return store.markLocalArtifactOpened(artifact.id);
-  });
+  }, null);
 }
 async function listExistingDownloads(deps) {
   const artifacts = await withStore(
     deps,
-    (store, account) => account ? store.listLocalArtifactsForAccount(account, { kind: "download" }) : []
+    (store, account) => account ? store.listLocalArtifactsForAccount(account, { kind: "download" }) : [],
+    []
   );
   const existing = [];
   for (const artifact of artifacts) {
@@ -20263,8 +20364,9 @@ async function listExistingDownloads(deps) {
   }
   return existing;
 }
-async function withStore(deps, run) {
-  const store = deps.store ?? openCliStore({ homeDir: deps.homeDir, env: deps.env });
+async function withStore(deps, run, fallback) {
+  const store = deps.store ?? tryOpenCliStore({ homeDir: deps.homeDir, env: deps.env });
+  if (!store) return fallback;
   try {
     return await run(store, deps.account ?? null);
   } finally {
@@ -20274,6 +20376,27 @@ async function withStore(deps, run) {
 function defaultDownloadDirectory(deps) {
   return path5.join(path5.dirname(defaultStorePath(deps.homeDir, deps.env)), "downloads");
 }
+function contentTypeForAudioPath(localPath) {
+  switch (path5.extname(localPath).toLowerCase()) {
+    case ".mp3":
+      return "audio/mpeg";
+    case ".m4a":
+    case ".mp4":
+      return "audio/m4a";
+    case ".ogg":
+      return "audio/ogg";
+    case ".flac":
+      return "audio/flac";
+    case ".webm":
+      return "audio/webm";
+    case ".aiff":
+    case ".aif":
+      return "audio/aiff";
+    case ".wav":
+    default:
+      return "audio/wav";
+  }
+}
 async function isReadableFile(localPath) {
   try {
     return (await fs4.stat(localPath)).isFile();
@@ -20553,41 +20676,171 @@ ${lines.join("\n")}
 }
 
 // src/export.ts
-import { promises as fs5 } from "fs";
+import { promises as fs6 } from "fs";
 import os5 from "os";
+import path7 from "path";
+
+// src/recordingSessionCache.ts
+import { promises as fs5 } from "fs";
 import path6 from "path";
+function accountFromStatus(status) {
+  if (!status.loggedIn || !status.userId) return null;
+  return normalizeAccountStamp({ backendOrigin: status.origin, userId: status.userId });
+}
+async function findIndexedRecordingSessionDir(recordingId, deps) {
+  return withSessionStore(deps, async (store, account) => {
+    if (!account) return void 0;
+    const artifact = store.findLocalArtifactForAccount(account, {
+      kind: "recording_session",
+      remoteId: recordingId
+    });
+    if (!artifact) return void 0;
+    if (!await isReadableDirectory(artifact.localPath)) return void 0;
+    const manifest = await readJsonRecord(path6.join(artifact.localPath, "remote-session.json"));
+    if (manifest?.recordingId && manifest.recordingId !== recordingId) return void 0;
+    return artifact.localPath;
+  }, void 0);
+}
+async function rememberRecordingSession(input, deps) {
+  return withSessionStore(deps, (store, account) => {
+    if (!account) return null;
+    return store.upsertLocalArtifact({
+      kind: "recording_session",
+      account,
+      remoteId: input.recording.recordingId,
+      localPath: input.sessionDir,
+      metadata: stripUndefined({
+        resource: "recording_session",
+        source: input.source,
+        sessionDir: input.sessionDir,
+        recording: input.recording,
+        files: stripUndefined({ ...input.files }),
+        transcriptId: input.transcriptId,
+        summaryStatus: input.summaryStatus,
+        uploadFilename: input.uploadFilename,
+        origin: input.recording.origin,
+        indexedAt: (input.now ?? (() => /* @__PURE__ */ new Date()))().toISOString()
+      })
+    });
+  }, null);
+}
+async function listCachedRecordingSessions(deps) {
+  const limit = deps.limit ?? 50;
+  const items = await withSessionStore(deps, async (store, account) => {
+    if (!account) return [];
+    const artifacts = store.listLocalArtifactsForAccount(account, { kind: "recording_session" });
+    const recordings = [];
+    const seen = /* @__PURE__ */ new Set();
+    for (const artifact of artifacts) {
+      if (recordings.length >= limit) break;
+      const recording = await recordingFromArtifact(artifact);
+      if (!recording || seen.has(recording.recordingId)) continue;
+      if (!await isReadableDirectory(artifact.localPath)) continue;
+      seen.add(recording.recordingId);
+      recordings.push(recording);
+    }
+    return recordings.sort((a, b) => b.createdAt - a.createdAt || b.updatedAt - a.updatedAt);
+  }, []);
+  return recordingListDataSchema.parse({
+    items,
+    limit,
+    nextCursor: null,
+    totalCount: items.length,
+    origin: deps.origin
+  });
+}
+async function recordingFromArtifact(artifact) {
+  const metadata = isRecord4(artifact.metadata) ? artifact.metadata : {};
+  const cached2 = recordingDataSchema.safeParse(metadata.recording);
+  if (cached2.success) return cached2.data;
+  const fromFile = await readJsonRecord(path6.join(artifact.localPath, "recording.json"));
+  const parsed = recordingDataSchema.safeParse(fromFile);
+  return parsed.success ? parsed.data : null;
+}
+async function withSessionStore(deps, run, fallback) {
+  const store = deps.store ?? tryOpenCliStore({ homeDir: deps.homeDir, env: deps.env });
+  if (!store) return fallback;
+  try {
+    return await run(store, deps.account ?? null);
+  } finally {
+    if (!deps.store) store.close();
+  }
+}
+async function readJsonRecord(filePath) {
+  try {
+    const parsed = JSON.parse(await fs5.readFile(filePath, "utf8"));
+    return isRecord4(parsed) ? parsed : void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function isReadableDirectory(localPath) {
+  try {
+    return (await fs5.stat(localPath)).isDirectory();
+  } catch {
+    return false;
+  }
+}
+function stripUndefined(value) {
+  return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== void 0));
+}
+function isRecord4(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+// src/export.ts
 async function syncRecordingText(opts) {
   const context = await loadRecordingBundleContext(opts);
-  const sessionDir = await resolveRecordingSessionDir(context.recording, opts);
+  const account = accountFromStatus(context.subscription);
+  const sessionDir = await resolveRecordingSessionDir(context.recording, opts, account);
   return writeRecordingTextFiles(context, sessionDir, {
-    now: opts.now
+    now: opts.now,
+    store: opts.store,
+    env: opts.env,
+    homeDir: opts.homeDir,
+    account,
+    source: "text_sync"
   });
 }
 async function syncRecordingAudio(opts) {
   const context = await loadRecordingBundleContext(opts);
-  const sessionDir = await resolveRecordingSessionDir(context.recording, opts);
+  const account = accountFromStatus(context.subscription);
+  const sessionDir = await resolveRecordingSessionDir(context.recording, opts, account);
   const audio = await downloadRecordingAudioToDir(context.recording, opts.recordingAudio, sessionDir);
   const text = await writeRecordingTextFiles(context, sessionDir, {
     now: opts.now,
-    uploadFilename: path6.basename(audio.localPath)
+    uploadFilename: path7.basename(audio.localPath),
+    store: opts.store,
+    env: opts.env,
+    homeDir: opts.homeDir,
+    account,
+    source: "audio_sync",
+    audioPath: audio.localPath
   });
   return { ...text, audioPath: audio.localPath, audio: audioMetadata(audio) };
 }
 async function exportRecording(opts) {
   const context = await loadRecordingBundleContext(opts);
-  const exportDir = await resolveRecordingSessionDir(context.recording, opts);
+  const account = accountFromStatus(context.subscription);
+  const exportDir = await resolveRecordingSessionDir(context.recording, opts, account);
   const audio = await downloadRecordingAudioToDir(context.recording, opts.recordingAudio, exportDir);
   const textFiles = await writeRecordingTextFiles(context, exportDir, {
     now: opts.now,
-    uploadFilename: path6.basename(audio.localPath)
+    uploadFilename: path7.basename(audio.localPath),
+    store: opts.store,
+    env: opts.env,
+    homeDir: opts.homeDir,
+    account,
+    source: "export",
+    audioPath: audio.localPath
   });
   const { recording, subscription, transcript } = context;
-  const subscriptionPath = path6.join(exportDir, "subscription.md");
-  const subscriptionJsonPath = path6.join(exportDir, "subscription.json");
-  await fs5.writeFile(subscriptionPath, renderSubscriptionMarkdown(subscription), "utf8");
+  const subscriptionPath = path7.join(exportDir, "subscription.md");
+  const subscriptionJsonPath = path7.join(exportDir, "subscription.json");
+  await fs6.writeFile(subscriptionPath, renderSubscriptionMarkdown(subscription), "utf8");
   await writeJson(subscriptionJsonPath, subscription);
-  const textPath = path6.join(exportDir, "handoff.md");
-  const manifestPath = path6.join(exportDir, "manifest.json");
+  const textPath = path7.join(exportDir, "handoff.md");
+  const manifestPath = path7.join(exportDir, "manifest.json");
   const data = recordingExportDataSchema.parse({
     origin: recording.origin,
     recordingId: recording.recordingId,
@@ -20609,7 +20862,7 @@ async function exportRecording(opts) {
     ...textFiles.summaryStatus ? { summaryStatus: textFiles.summaryStatus } : {},
     audio: audioMetadata(audio)
   });
-  await fs5.writeFile(
+  await fs6.writeFile(
     textPath,
     renderHandoffMarkdown(recording, subscription, audio, data, transcript),
     "utf8"
@@ -20619,6 +20872,33 @@ async function exportRecording(opts) {
     command: "recordings export",
     data
   });
+  await rememberRecordingSession(
+    {
+      recording,
+      sessionDir: exportDir,
+      files: {
+        remoteManifestPath: data.remoteManifestPath,
+        sessionMetadataPath: data.sessionMetadataPath,
+        recordingJsonPath: data.recordingJsonPath,
+        ...data.transcriptPath ? { transcriptPath: data.transcriptPath } : {},
+        ...data.transcriptJsonPath ? { transcriptJsonPath: data.transcriptJsonPath } : {},
+        ...data.summaryPath ? { summaryPath: data.summaryPath } : {},
+        ...data.summaryJsonPath ? { summaryJsonPath: data.summaryJsonPath } : {},
+        ...data.actionItemsPath ? { actionItemsPath: data.actionItemsPath } : {},
+        audioPath: data.audioPath,
+        subscriptionPath: data.subscriptionPath,
+        subscriptionJsonPath: data.subscriptionJsonPath,
+        textPath: data.textPath,
+        manifestPath: data.manifestPath
+      },
+      ...data.transcriptId !== void 0 ? { transcriptId: data.transcriptId } : {},
+      ...data.summaryStatus ? { summaryStatus: data.summaryStatus } : {},
+      uploadFilename: path7.basename(audio.localPath),
+      source: "export",
+      now: opts.now
+    },
+    { account, store: opts.store, env: opts.env, homeDir: opts.homeDir }
+  );
   return data;
 }
 async function loadRecordingBundleContext(opts) {
@@ -20641,11 +20921,11 @@ async function downloadRecordingAudioToDir(recording, recordingAudio, directory)
 }
 async function writeRecordingTextFiles(context, sessionDir, opts) {
   const { recording, transcript, subscription } = context;
-  await fs5.mkdir(sessionDir, { recursive: true });
-  const recordingJsonPath = path6.join(sessionDir, "recording.json");
-  const sessionMetadataPath = path6.join(sessionDir, "session-metadata.json");
-  const remoteManifestPath = path6.join(sessionDir, "remote-session.json");
-  const existingManifest = await readJsonRecord(remoteManifestPath);
+  await fs6.mkdir(sessionDir, { recursive: true });
+  const recordingJsonPath = path7.join(sessionDir, "recording.json");
+  const sessionMetadataPath = path7.join(sessionDir, "session-metadata.json");
+  const remoteManifestPath = path7.join(sessionDir, "remote-session.json");
+  const existingManifest = await readJsonRecord2(remoteManifestPath);
   const uploadFilename = opts.uploadFilename ?? (typeof existingManifest?.uploadFilename === "string" ? existingManifest.uploadFilename : void 0);
   await writeJson(recordingJsonPath, recording);
   await writeJson(sessionMetadataPath, renderSessionMetadata(recording));
@@ -20660,19 +20940,23 @@ async function writeRecordingTextFiles(context, sessionDir, opts) {
   let actionItemsPath;
   let summaryStatus;
   if (transcript) {
-    transcriptPath = path6.join(sessionDir, "transcript.md");
-    transcriptJsonPath = path6.join(sessionDir, "transcript.json");
-    summaryPath = path6.join(sessionDir, "summary.md");
-    summaryJsonPath = path6.join(sessionDir, "summary.json");
-    actionItemsPath = path6.join(sessionDir, "action-items.md");
+    transcriptPath = path7.join(sessionDir, "transcript.md");
+    transcriptJsonPath = path7.join(sessionDir, "transcript.json");
+    summaryJsonPath = path7.join(sessionDir, "summary.json");
     summaryStatus = transcript.summary.status;
-    await fs5.writeFile(transcriptPath, renderTranscriptMarkdown(transcript), "utf8");
+    await fs6.writeFile(transcriptPath, renderTranscriptMarkdown(transcript), "utf8");
     await writeJson(transcriptJsonPath, transcript);
     await writeJson(summaryJsonPath, transcript.summary);
-    await fs5.writeFile(summaryPath, renderSummaryMarkdown(recording, transcript), "utf8");
-    await writeOptionalText(actionItemsPath, renderActionItemsMarkdown(transcript.summary));
+    const summaryFilePath = path7.join(sessionDir, "summary.md");
+    const summaryMarkdown = renderSummaryMarkdown(transcript);
+    await writeOptionalText(summaryFilePath, summaryMarkdown);
+    if (summaryMarkdown) summaryPath = summaryFilePath;
+    const actionItemsFilePath = path7.join(sessionDir, "action-items.md");
+    const actionItemsMarkdown = renderActionItemsMarkdown(transcript.summary);
+    await writeOptionalText(actionItemsFilePath, actionItemsMarkdown);
+    if (actionItemsMarkdown) actionItemsPath = actionItemsFilePath;
   }
-  return {
+  const data = {
     recordingId: recording.recordingId,
     sessionDir,
     remoteManifestPath,
@@ -20686,10 +20970,56 @@ async function writeRecordingTextFiles(context, sessionDir, opts) {
     ...actionItemsPath ? { actionItemsPath } : {},
     ...summaryStatus ? { summaryStatus } : {}
   };
+  await rememberRecordingSession(
+    {
+      recording,
+      sessionDir,
+      files: {
+        remoteManifestPath,
+        sessionMetadataPath,
+        recordingJsonPath,
+        ...transcriptPath ? { transcriptPath } : {},
+        ...transcriptJsonPath ? { transcriptJsonPath } : {},
+        ...summaryPath ? { summaryPath } : {},
+        ...summaryJsonPath ? { summaryJsonPath } : {},
+        ...actionItemsPath ? { actionItemsPath } : {},
+        ...opts.audioPath ? { audioPath: opts.audioPath } : {}
+      },
+      ...context.transcriptId !== void 0 ? { transcriptId: context.transcriptId } : {},
+      ...summaryStatus ? { summaryStatus } : {},
+      ...uploadFilename ? { uploadFilename } : {},
+      source: opts.source,
+      now: opts.now
+    },
+    { account: opts.account ?? null, store: opts.store, env: opts.env, homeDir: opts.homeDir }
+  );
+  return data;
 }
-async function resolveRecordingSessionDir(recording, opts) {
-  if (opts.directory) return path6.resolve(opts.directory);
+async function resolveRecordingSessionDir(recording, opts, account) {
+  if (opts.directory) return path7.resolve(opts.directory);
+  const indexed = await findIndexedRecordingSessionDir(recording.recordingId, {
+    account,
+    store: opts.store,
+    homeDir: opts.homeDir,
+    env: opts.env
+  });
+  if (indexed) return indexed;
   const existing = await findExistingRecordingSessionDir(recording.recordingId, opts.homeDir, opts.env);
+  if (existing) {
+    await rememberRecordingSession(
+      {
+        recording,
+        sessionDir: existing,
+        files: {
+          remoteManifestPath: path7.join(existing, "remote-session.json"),
+          sessionMetadataPath: path7.join(existing, "session-metadata.json"),
+          recordingJsonPath: path7.join(existing, "recording.json")
+        },
+        source: "manifest_scan"
+      },
+      { account, store: opts.store, env: opts.env, homeDir: opts.homeDir }
+    );
+  }
   if (existing) return existing;
   return createRecordingSessionDir(recording, opts.homeDir, opts.env);
 }
@@ -20697,39 +21027,39 @@ async function findExistingRecordingSessionDir(recordingId, homeDir, env) {
   const base = recordingSessionBaseDirectory(homeDir, env);
   let entries;
   try {
-    entries = await fs5.readdir(base, { withFileTypes: true });
+    entries = await fs6.readdir(base, { withFileTypes: true });
   } catch {
     return void 0;
   }
   for (const entry of entries) {
     if (!entry.isDirectory()) continue;
-    const dir = path6.join(base, entry.name);
-    const manifest = await readJsonRecord(path6.join(dir, "remote-session.json"));
+    const dir = path7.join(base, entry.name);
+    const manifest = await readJsonRecord2(path7.join(dir, "remote-session.json"));
     if (manifest?.recordingId === recordingId) return dir;
   }
   return void 0;
 }
 async function createRecordingSessionDir(recording, homeDir, env) {
   const base = recordingSessionBaseDirectory(homeDir, env);
-  await fs5.mkdir(base, { recursive: true });
+  await fs6.mkdir(base, { recursive: true });
   const stem = formatSessionDirectoryDate(new Date(recording.createdAt));
-  let candidate = path6.join(base, stem);
+  let candidate = path7.join(base, stem);
   let suffix = 2;
   while (await pathExists(candidate)) {
-    candidate = path6.join(base, `${stem}-cloud-${suffix}`);
+    candidate = path7.join(base, `${stem}-cloud-${suffix}`);
     suffix += 1;
   }
-  await fs5.mkdir(candidate, { recursive: true });
+  await fs6.mkdir(candidate, { recursive: true });
   return candidate;
 }
 function recordingSessionBaseDirectory(homeDir = os5.homedir(), env = process.env) {
   const explicit = env.RECAPPI_LOCAL_SESSIONS_DIR?.trim();
   if (explicit) return explicit;
-  return path6.join(homeDir, "Documents", "Recappi Mini");
+  return path7.join(homeDir, "Documents", "Recappi Mini");
 }
-async function readJsonRecord(filePath) {
+async function readJsonRecord2(filePath) {
   try {
-    const parsed = JSON.parse(await fs5.readFile(filePath, "utf8"));
+    const parsed = JSON.parse(await fs6.readFile(filePath, "utf8"));
     return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed) ? parsed : void 0;
   } catch {
     return void 0;
@@ -20737,7 +21067,7 @@ async function readJsonRecord(filePath) {
 }
 async function pathExists(filePath) {
   try {
-    await fs5.access(filePath);
+    await fs6.access(filePath);
     return true;
   } catch {
     return false;
@@ -20753,15 +21083,15 @@ function formatSessionDirectoryDate(date5) {
   return `${year}-${month}-${day}_${hour}${minute}${second}`;
 }
 async function writeJson(filePath, value) {
-  await fs5.writeFile(filePath, `${JSON.stringify(value, null, 2)}
+  await fs6.writeFile(filePath, `${JSON.stringify(value, null, 2)}
 `, "utf8");
 }
 async function writeOptionalText(filePath, value) {
   if (value && value.trim()) {
-    await fs5.writeFile(filePath, value, "utf8");
+    await fs6.writeFile(filePath, value, "utf8");
     return;
   }
-  await fs5.rm(filePath, { force: true });
+  await fs6.rm(filePath, { force: true });
 }
 function renderHandoffMarkdown(recording, subscription, audio, data, transcript) {
   const lines = [];
@@ -20797,9 +21127,12 @@ function renderHandoffMarkdown(recording, subscription, audio, data, transcript)
   appendSubscriptionLines(lines, subscription);
   lines.push("");
   if (transcript) {
-    lines.push(renderSummaryMarkdown(recording, transcript).trimEnd());
-    lines.push("");
-    lines.push(renderTranscriptMarkdown(transcript).trimEnd());
+    const summaryMarkdown = renderSummaryMarkdown(transcript);
+    if (summaryMarkdown) {
+      lines.push(summaryMarkdown.trimEnd());
+      lines.push("");
+    }
+    lines.push(renderTimestampedTranscriptMarkdown(transcript).trimEnd());
     lines.push("");
   }
   return `${lines.join("\n").trimEnd()}
@@ -20813,7 +21146,7 @@ function renderSubscriptionMarkdown(subscription) {
 }
 function renderSessionMetadata(recording) {
   const sourceTitle = recording.title ?? recording.summaryTitle ?? "Recappi Cloud";
-  return stripUndefined({
+  return stripUndefined2({
     summaryTitle: recording.summaryTitle ?? recording.title ?? void 0,
     sourceTitle,
     sourceAppName: void 0,
@@ -20825,7 +21158,7 @@ function renderSessionMetadata(recording) {
   });
 }
 function renderRemoteSessionManifest(recording, uploadFilename, transcript, subscription, now) {
-  return stripUndefined({
+  return stripUndefined2({
     recordingId: recording.recordingId,
     jobId: transcript?.jobId,
     transcriptId: transcript?.transcriptId ?? recording.activeTranscriptId ?? void 0,
@@ -20839,7 +21172,7 @@ function renderRemoteSessionManifest(recording, uploadFilename, transcript, subs
     accountBackendOrigin: subscription.origin
   });
 }
-function stripUndefined(value) {
+function stripUndefined2(value) {
   return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== void 0));
 }
 function appendSubscriptionLines(lines, subscription) {
@@ -20862,6 +21195,12 @@ function appendSubscriptionLines(lines, subscription) {
 function renderTranscriptMarkdown(transcript) {
   return `# Transcript
 
+${transcript.text}
+`;
+}
+function renderTimestampedTranscriptMarkdown(transcript) {
+  return `# Transcript
+
 ${renderTranscriptLines(transcript)}
 `;
 }
@@ -20873,15 +21212,10 @@ function renderTranscriptLines(transcript) {
   if (lines.length > 0) return lines.join("\n");
   return transcript.text;
 }
-function renderSummaryMarkdown(recording, transcript) {
+function renderSummaryMarkdown(transcript) {
   const summary = transcript.summary;
   const lines = [];
-  lines.push(`# ${summary.title ?? recording.title ?? recording.summaryTitle ?? "Summary"}`);
-  lines.push("");
-  lines.push(`- recordingId: ${recording.recordingId}`);
-  lines.push(`- transcriptId: ${transcript.transcriptId}`);
-  lines.push(`- summaryStatus: ${summary.status}`);
-  if (summary.error) lines.push(`- error: ${summary.error}`);
+  lines.push("# Summary");
   lines.push("");
   if (summary.tldr) {
     lines.push("## TL;DR", "");
@@ -20891,8 +21225,8 @@ function renderSummaryMarkdown(recording, transcript) {
   appendStringList(lines, "Topics", summary.topics);
   appendStringList(lines, "Decisions", summary.decisions);
   appendActionItems(lines, summary.actionItems);
-  appendTimeline(lines, summary.timeline);
-  appendQuotes(lines, summary.quotes);
+  appendNotableQuotes(lines, summary.quotes);
+  if (lines.length === 2) return null;
   if (lines[lines.length - 1] !== "") lines.push("");
   return lines.join("\n");
 }
@@ -20900,7 +21234,7 @@ function renderActionItemsMarkdown(summary) {
   if (!summary.actionItems || summary.actionItems.length === 0) return null;
   const lines = ["# Action Items", ""];
   for (const item of summary.actionItems) {
-    lines.push(`- ${item.who ? `${item.who} - ` : ""}${item.what}`);
+    lines.push(actionItemLine(item));
   }
   lines.push("");
   return lines.join("\n");
@@ -20915,27 +21249,20 @@ function appendActionItems(lines, values) {
   if (!values || values.length === 0) return;
   lines.push("## Action Items", "");
   for (const item of values) {
-    lines.push(`- ${item.who ? `${item.who}: ` : ""}${item.what}`);
+    lines.push(actionItemLine(item));
   }
   lines.push("");
 }
-function appendTimeline(lines, values) {
+function appendNotableQuotes(lines, values) {
   if (!values || values.length === 0) return;
-  lines.push("## Timeline", "");
+  lines.push("## Notable Quotes", "");
   for (const item of values) {
-    lines.push(
-      `- ${formatTimestamp(item.startMs)}-${formatTimestamp(item.endMs)}: ${item.title} - ${item.summary}`
-    );
+    lines.push(`> ${item.speaker ? `${item.speaker}: ` : ""}${item.text}`);
   }
   lines.push("");
 }
-function appendQuotes(lines, values) {
-  if (!values || values.length === 0) return;
-  lines.push("## Quotes", "");
-  for (const item of values) {
-    lines.push(`- ${item.speaker ? `${item.speaker}: ` : ""}"${item.text}"`);
-  }
-  lines.push("");
+function actionItemLine(item) {
+  return `- ${item.who ? `${item.who}: ` : ""}${item.what}`;
 }
 function audioMetadata(audio) {
   return {
@@ -21331,20 +21658,20 @@ function renderEnvelope(envelope, opts) {
 `);
 }
 function renderHumanSuccess(command, data, opts) {
-  if (command === "auth login" && isRecord4(data)) {
+  if (command === "auth login" && isRecord5(data)) {
     opts.stdout(`Signed in${typeof data.email === "string" ? ` as ${data.email}` : ""}
 `);
     return;
   }
-  if (command === "auth logout" && isRecord4(data)) {
+  if (command === "auth logout" && isRecord5(data)) {
     opts.stdout(data.cleared ? "Signed out of Recappi CLI\n" : "No Recappi CLI session to clear\n");
     return;
   }
-  if (command === "auth import-macos" && isRecord4(data)) {
+  if (command === "auth import-macos" && isRecord5(data)) {
     opts.stdout("Imported the Recappi Mini app session into Recappi CLI\n");
     return;
   }
-  if (command === "auth status" && isRecord4(data)) {
+  if (command === "auth status" && isRecord5(data)) {
     if (data.loggedIn) {
       opts.stdout(`Signed in${typeof data.email === "string" ? ` as ${data.email}` : ""}
 `);
@@ -21353,7 +21680,7 @@ function renderHumanSuccess(command, data, opts) {
     opts.stdout("Not logged in\n");
     return;
   }
-  if (command === "account status" && isRecord4(data)) {
+  if (command === "account status" && isRecord5(data)) {
     if (!data.loggedIn) {
       opts.stdout("Not logged in\n");
       return;
@@ -21364,7 +21691,7 @@ function renderHumanSuccess(command, data, opts) {
 `);
     if (typeof data.userId === "string") opts.stdout(`  userId: ${data.userId}
 `);
-    const billing = isRecord4(data.billing) ? data.billing : {};
+    const billing = isRecord5(data.billing) ? data.billing : {};
     if (typeof billing.tier === "string") opts.stdout(`  plan: ${billing.tier}
 `);
     if (typeof billing.minutesUsed === "number") {
@@ -21377,7 +21704,7 @@ function renderHumanSuccess(command, data, opts) {
       opts.stdout(`  storage: ${formatBytes2(billing.storageBytes)} / ${cap}
 `);
     }
-    const localStore = isRecord4(data.localStore) ? data.localStore : {};
+    const localStore = isRecord5(data.localStore) ? data.localStore : {};
     if (typeof localStore.path === "string") opts.stdout(`  localStore: ${localStore.path}
 `);
     opts.stdout(
@@ -21386,17 +21713,17 @@ function renderHumanSuccess(command, data, opts) {
     );
     return;
   }
-  if (command === "version" && isRecord4(data) && typeof data.version === "string") {
+  if (command === "version" && isRecord5(data) && typeof data.version === "string") {
     opts.stdout(`${data.version}
 `);
     return;
   }
-  if (command === "doctor" && isRecord4(data) && Array.isArray(data.checks)) {
+  if (command === "doctor" && isRecord5(data) && Array.isArray(data.checks)) {
     const status = typeof data.status === "string" ? data.status : "unknown";
     opts.stdout(`Doctor: ${status}
 `);
     for (const check2 of data.checks) {
-      if (!isRecord4(check2)) continue;
+      if (!isRecord5(check2)) continue;
       const checkStatus = typeof check2.status === "string" ? check2.status : "unknown";
       const name = typeof check2.name === "string" ? check2.name : "check";
       const message = typeof check2.message === "string" ? ` \u2014 ${check2.message}` : "";
@@ -21407,14 +21734,14 @@ function renderHumanSuccess(command, data, opts) {
     }
     return;
   }
-  if (command === "transcript get" && isRecord4(data)) {
+  if (command === "transcript get" && isRecord5(data)) {
     renderTranscriptHuman(data, opts);
     return;
   }
-  if (command === "recordings list" && isRecord4(data) && Array.isArray(data.items)) {
+  if (command === "recordings list" && isRecord5(data) && Array.isArray(data.items)) {
     opts.stdout("Recordings:\n");
     for (const item of data.items) {
-      if (!isRecord4(item)) continue;
+      if (!isRecord5(item)) continue;
       opts.stdout(`  ${recordingLabel(item)}
 `);
     }
@@ -21426,7 +21753,7 @@ Next cursor: ${data.nextCursor}
     }
     return;
   }
-  if (command === "recordings get" && isRecord4(data)) {
+  if (command === "recordings get" && isRecord5(data)) {
     opts.stdout(`${recordingTitle(data)}
 `);
     opts.stdout(`  recordingId: ${String(data.recordingId)}
@@ -21448,7 +21775,7 @@ Next:
     }
     return;
   }
-  if (command === "recordings export" && isRecord4(data)) {
+  if (command === "recordings export" && isRecord5(data)) {
     opts.stdout("Recording export ready\n");
     printStringField(opts, data, "recordingId");
     printStringField(opts, data, "exportDir");
@@ -21470,7 +21797,7 @@ Next:
     }
     return;
   }
-  if (command === "recordings retranscribe" && isRecord4(data)) {
+  if (command === "recordings retranscribe" && isRecord5(data)) {
     opts.stdout("Transcription started\n");
     if (typeof data.recordingId === "string") opts.stdout(`  recordingId: ${data.recordingId}
 `);
@@ -21493,7 +21820,7 @@ Next:
     }
     return;
   }
-  if (command === "recordings resummarize" && isRecord4(data)) {
+  if (command === "recordings resummarize" && isRecord5(data)) {
     opts.stdout("Summary queued\n");
     if (typeof data.recordingId === "string") opts.stdout(`  recordingId: ${data.recordingId}
 `);
@@ -21511,9 +21838,9 @@ Next:
     }
     return;
   }
-  if (command === "dashboard stats" && isRecord4(data)) {
-    const recordings = isRecord4(data.recordings) ? data.recordings : {};
-    const jobs = isRecord4(data.jobs) ? data.jobs : {};
+  if (command === "dashboard stats" && isRecord5(data)) {
+    const recordings = isRecord5(data.recordings) ? data.recordings : {};
+    const jobs = isRecord5(data.jobs) ? data.jobs : {};
     opts.stdout(
       `Recordings: ${numberText(recordings.total)} total, ${numberText(recordings.ready)} ready
 `
@@ -21556,7 +21883,7 @@ Next:
     }
     return;
   }
-  if (command === "record" && isRecord4(data)) {
+  if (command === "record" && isRecord5(data)) {
     opts.stdout("Recording complete\n");
     if (typeof data.recordingId === "string") opts.stdout(`  recordingId: ${data.recordingId}
 `);
@@ -21575,14 +21902,14 @@ Next:
     if (Array.isArray(data.artifacts) && data.artifacts.length > 0) {
       opts.stdout("  artifacts:\n");
       for (const artifact of data.artifacts) {
-        if (!isRecord4(artifact)) continue;
+        if (!isRecord5(artifact)) continue;
         const kind = typeof artifact.kind === "string" ? artifact.kind : "artifact";
         const localPath = typeof artifact.localPath === "string" ? artifact.localPath : "";
         opts.stdout(`    - ${kind}: ${localPath}
 `);
       }
     }
-    const cloudHandoffError = isRecord4(data.cloudHandoffError) ? data.cloudHandoffError : void 0;
+    const cloudHandoffError = isRecord5(data.cloudHandoffError) ? data.cloudHandoffError : void 0;
     if (cloudHandoffError && typeof cloudHandoffError.message === "string") {
       opts.stderr(`Cloud handoff failed: ${cloudHandoffError.message}
 `);
@@ -21607,7 +21934,7 @@ Next:
     }
     return;
   }
-  if (command === "audio" && isRecord4(data)) {
+  if (command === "audio" && isRecord5(data)) {
     const action = typeof data.action === "string" ? data.action : "download";
     opts.stdout(
       action === "open" ? "Audio opened\n" : action === "reveal" ? "Audio revealed\n" : "Audio ready\n"
@@ -21622,7 +21949,7 @@ Next:
     }
     return;
   }
-  if ((command === "jobs wait" || command === "upload") && isRecord4(data)) {
+  if ((command === "jobs wait" || command === "upload") && isRecord5(data)) {
     if (typeof data.transcriptId === "string") {
       opts.stdout("Transcript ready\n");
       if (typeof data.recordingId === "string" && typeof data.origin === "string") {
@@ -21647,10 +21974,10 @@ Next:
     }
     return;
   }
-  if (command === "schema" && isRecord4(data) && Array.isArray(data.commands)) {
+  if (command === "schema" && isRecord5(data) && Array.isArray(data.commands)) {
     opts.stdout("Commands:\n");
     for (const entry of data.commands) {
-      if (!isRecord4(entry) || typeof entry.name !== "string") continue;
+      if (!isRecord5(entry) || typeof entry.name !== "string") continue;
       const summary = typeof entry.summary === "string" ? ` \u2014 ${entry.summary}` : "";
       opts.stdout(`  ${entry.name}${summary}
 `);
@@ -21660,9 +21987,9 @@ Next:
       }
       if (Array.isArray(entry.examples) && entry.examples.length > 0) {
         const first = entry.examples.find(
-          (example) => isRecord4(example) && typeof example.command === "string"
+          (example) => isRecord5(example) && typeof example.command === "string"
         );
-        if (isRecord4(first) && typeof first.command === "string") {
+        if (isRecord5(first) && typeof first.command === "string") {
           opts.stdout(`    example: ${first.command}
 `);
         }
@@ -21794,7 +22121,7 @@ function renderTranscriptHuman(data, opts) {
   const segments = Array.isArray(data.segments) ? data.segments : [];
   let printedBody = false;
   for (const segment of segments) {
-    if (!isRecord4(segment) || typeof segment.text !== "string") continue;
+    if (!isRecord5(segment) || typeof segment.text !== "string") continue;
     const clock = typeof segment.startMs === "number" ? `[${formatClock(segment.startMs / 1e3)}] ` : "";
     const speaker = typeof segment.speaker === "string" ? `${segment.speaker}: ` : "";
     opts.stdout(`${clock}${speaker}${segment.text}
@@ -21806,7 +22133,7 @@ function renderTranscriptHuman(data, opts) {
 `);
     printedBody = true;
   }
-  const summary = isRecord4(data.summary) ? data.summary : void 0;
+  const summary = isRecord5(data.summary) ? data.summary : void 0;
   if (!summary || summary.status !== "succeeded") return;
   if (typeof summary.tldr === "string" && summary.tldr.length > 0) {
     opts.stdout(`
@@ -21824,7 +22151,7 @@ Summary:
   if (Array.isArray(summary.actionItems) && summary.actionItems.length > 0) {
     opts.stdout("\nAction items:\n");
     for (const item of summary.actionItems) {
-      if (!isRecord4(item) || typeof item.what !== "string") continue;
+      if (!isRecord5(item) || typeof item.what !== "string") continue;
       const who = typeof item.who === "string" ? `${item.who}: ` : "";
       opts.stdout(`  - ${who}${item.what}
 `);
@@ -21899,7 +22226,7 @@ function applyFields(command, data, fields, compact) {
     };
     return compact ? compactData(filtered2) : filtered2;
   }
-  if (!isRecord4(data)) return data;
+  if (!isRecord5(data)) return data;
   const allowed = new Set(Object.keys(data));
   assertKnownFields(fields, allowed);
   const filtered = pickFields(data, fields);
@@ -21924,7 +22251,7 @@ function compactData(value) {
   if (Array.isArray(value)) {
     return value.map(compactData).filter((item) => item !== void 0);
   }
-  if (isRecord4(value)) {
+  if (isRecord5(value)) {
     const out = {};
     for (const [key, child] of Object.entries(value)) {
       const compacted = compactData(child);
@@ -21942,16 +22269,16 @@ function stableStringify(value, compact) {
 }
 function sortKeys(value) {
   if (Array.isArray(value)) return value.map(sortKeys);
-  if (!isRecord4(value)) return value;
+  if (!isRecord5(value)) return value;
   return Object.fromEntries(
     Object.keys(value).sort().map((key) => [key, sortKeys(value[key])])
   );
 }
-function isRecord4(value) {
+function isRecord5(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isUploadBatch(value) {
-  return isRecord4(value) && Array.isArray(value.successes) && Array.isArray(value.failures);
+  return isRecord5(value) && Array.isArray(value.successes) && Array.isArray(value.failures);
 }
 
 // src/schema.ts
@@ -22006,11 +22333,11 @@ function buildSchemaDocument(program) {
     event: toJsonSchema(operationEventSchema)
   };
 }
-function walkCommands(command, path7, out) {
+function walkCommands(command, path8, out) {
   for (const sub of subcommandsOf(command)) {
     const name = sub.name();
     if (name === "help") continue;
-    const fullPath = [...path7, name];
+    const fullPath = [...path8, name];
     const children = subcommandsOf(sub).filter((child) => child.name() !== "help");
     if (children.length === 0) {
       out.push(leafCommandDoc(sub, fullPath.join(" ")));
@@ -22288,7 +22615,7 @@ var MiniSidecarClient = class {
   }
 };
 function sidecarErrorToCliError(error51) {
-  const data = isRecord6(error51.data) ? error51.data : void 0;
+  const data = isRecord7(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;
@@ -22305,7 +22632,7 @@ function sidecarErrorToCliError(error51) {
     retryable
   });
 }
-function isRecord6(value) {
+function isRecord7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function spawnMiniSidecar(opts) {
@@ -22412,8 +22739,8 @@ function requestLaunchServicesSidecarShutdown(input) {
   } catch {
   }
 }
-function createFifo(path7) {
-  const result = spawnSync("mkfifo", [path7], { encoding: "utf8" });
+function createFifo(path8) {
+  const result = spawnSync("mkfifo", [path8], { encoding: "utf8" });
   if (result.status !== 0) {
     throw cliError("record.helper_unavailable", "Recappi recording helper could not start.", {
       hint: result.stderr || "Could not create the local recorder pipes. Try again."
@@ -22949,14 +23276,14 @@ async function startRecordSessionOnce(opts) {
   }
 }
 function isPermissionRestartRequiredError(error51, permissionName) {
-  const root = isRecord7(error51) ? error51 : void 0;
-  const descriptor = isRecord7(root?.descriptor) ? root.descriptor : void 0;
+  const root = isRecord8(error51) ? error51 : void 0;
+  const descriptor = isRecord8(root?.descriptor) ? root.descriptor : void 0;
   if (descriptor?.code !== "record.permission_required") return false;
-  const sidecarError = isRecord7(root?.data) ? root.data : void 0;
-  const sidecarData = isRecord7(sidecarError?.data) ? sidecarError.data : void 0;
+  const sidecarError = isRecord8(root?.data) ? root.data : void 0;
+  const sidecarData = isRecord8(sidecarError?.data) ? sidecarError.data : void 0;
   return sidecarData?.permission === permissionName && (sidecarData.requiresProcessRestart === true || sidecarData.requiresProcessRestart === "true");
 }
-function isRecord7(value) {
+function isRecord8(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function normalizeSidecarSources(sources) {
@@ -23037,9 +23364,9 @@ function resolveSidecarCommand(opts) {
     hint: `No bundled helper is registered for ${platform}. Set ${SIDECAR_COMMAND_ENV} to a compatible helper when one is available.`
   });
 }
-function ensureBundledHelperExecutable(path7, opts = {}) {
-  if (process.platform === "darwin" && path7.endsWith(".app")) {
-    const stableApp = ensureStableDarwinHelperApp(path7, opts);
+function ensureBundledHelperExecutable(path8, opts = {}) {
+  if (process.platform === "darwin" && path8.endsWith(".app")) {
+    const stableApp = ensureStableDarwinHelperApp(path8, opts);
     const executable = darwinAppExecutablePath(stableApp);
     if (!existsSync(executable)) {
       throw cliError("record.helper_unavailable", "Recappi recording helper is not available.", {
@@ -23049,19 +23376,19 @@ function ensureBundledHelperExecutable(path7, opts = {}) {
     ensureExecutableMode(executable);
     return stableApp;
   }
-  if (process.platform === "win32") return path7;
-  ensureExecutableMode(path7);
-  return path7;
+  if (process.platform === "win32") return path8;
+  ensureExecutableMode(path8);
+  return path8;
 }
-function ensureExecutableMode(path7) {
-  const mode = statSync(path7).mode;
+function ensureExecutableMode(path8) {
+  const mode = statSync(path8).mode;
   if ((mode & 73) !== 0) return;
   try {
-    chmodSync(path7, mode | 493);
+    chmodSync(path8, mode | 493);
   } catch (error51) {
     const message = error51 instanceof Error ? error51.message : String(error51);
     throw cliError("record.helper_unavailable", "Recappi recording helper is not executable.", {
-      hint: `Could not make bundled helper executable at ${path7}: ${message}. Reinstall recappi, or set ${SIDECAR_COMMAND_ENV} to a compatible helper.`
+      hint: `Could not make bundled helper executable at ${path8}: ${message}. Reinstall recappi, or set ${SIDECAR_COMMAND_ENV} to a compatible helper.`
     });
   }
 }
@@ -23106,14 +23433,14 @@ function helperSourceSignature(sourceApp) {
     codeSignature: existsSync(signaturePath) ? fileDigest(signaturePath) : null
   });
 }
-function fileDigest(path7) {
+function fileDigest(path8) {
   const hash2 = createHash("sha256");
-  hash2.update(readFileSync2(path7));
+  hash2.update(readFileSync2(path8));
   return hash2.digest("hex");
 }
-function readTextIfExists(path7) {
+function readTextIfExists(path8) {
   try {
-    return readFileSync2(path7, "utf8");
+    return readFileSync2(path8, "utf8");
   } catch {
     return null;
   }
@@ -23407,6 +23734,13 @@ async function runCli(deps = {}) {
       await runDashboard2({
         fetchJobs: () => client.listJobs({ status: "active", limit: 20 }),
         fetchRecordings: ({ cursor, limit = DASHBOARD_RECORDINGS_PAGE_SIZE } = {}) => client.listRecordings({ limit, cursor }),
+        fetchCachedRecordings: account ? ({ limit = DASHBOARD_RECORDINGS_PAGE_SIZE } = {}) => listCachedRecordingSessions({
+          account,
+          origin: auth.origin,
+          limit,
+          env: deps.env,
+          homeDir: deps.homeDir
+        }) : void 0,
         fetchDashboardStats: () => client.dashboardStats(),
         fetchAccountStatus: () => client.accountStatus(),
         fetchTranscript: (transcriptId) => client.getTranscript(transcriptId),