recappi 0.1.12 → 0.1.14

package/dist/index.js

@@ -1293,10 +1293,56 @@ var init_TranscriptView = __esm({
   }
 });
 
+// src/tui/PermissionPreflightView.tsx
+import { Box as Box13, Text as Text13 } from "ink";
+import { jsx as jsx15, jsxs as jsxs12 } from "react/jsx-runtime";
+function statusGlyph2(status) {
+  switch (status) {
+    case "granted":
+      return { glyph: "\u2713", color: "green", label: "granted" };
+    case "denied":
+      return { glyph: "\u2717", color: "red", label: "not allowed" };
+    case "unknown":
+      return { glyph: "\u25CB", color: "yellow", label: "not requested yet" };
+  }
+}
+function PermissionPreflightView({
+  items
+}) {
+  const allGranted = items.length > 0 && items.every((item) => item.status === "granted");
+  return /* @__PURE__ */ jsxs12(Box13, { flexDirection: "column", paddingX: 1, children: [
+    /* @__PURE__ */ jsx15(Text13, { dimColor: true, children: "\u2039 Recording permissions" }),
+    /* @__PURE__ */ jsx15(Box13, { marginTop: 1, flexDirection: "column", children: items.length === 0 ? /* @__PURE__ */ jsx15(Text13, { dimColor: true, children: "Checking permissions\u2026" }) : items.map((item) => {
+      const status = statusGlyph2(item.status);
+      const hint = item.status === "granted" ? void 0 : item.hint ?? DEFAULT_HINTS[item.name];
+      return /* @__PURE__ */ jsxs12(Box13, { flexDirection: "column", children: [
+        /* @__PURE__ */ jsxs12(Text13, { children: [
+          /* @__PURE__ */ jsx15(Text13, { color: status.color, children: status.glyph }),
+          /* @__PURE__ */ jsx15(Text13, { bold: true, children: ` ${item.name}` }),
+          /* @__PURE__ */ jsx15(Text13, { dimColor: true, children: `  ${status.label}` })
+        ] }),
+        hint ? /* @__PURE__ */ jsx15(Text13, { dimColor: true, children: `   ${hint}` }) : null
+      ] }, item.name);
+    }) }),
+    /* @__PURE__ */ jsx15(Box13, { marginTop: 1, children: allGranted ? /* @__PURE__ */ jsx15(Text13, { color: "green", children: "All set \u2014 ready to record." }) : /* @__PURE__ */ jsx15(Text13, { dimColor: true, children: "Grant the permissions above, then press r to recheck." }) }),
+    /* @__PURE__ */ jsx15(Box13, { marginTop: 1, children: /* @__PURE__ */ jsx15(Text13, { dimColor: true, children: "r recheck \xB7 o open System Settings \xB7 esc back" }) })
+  ] });
+}
+var DEFAULT_HINTS;
+var init_PermissionPreflightView = __esm({
+  "src/tui/PermissionPreflightView.tsx"() {
+    "use strict";
+    DEFAULT_HINTS = {
+      "Screen Recording": "Open System Settings \u203A Privacy & Security \u203A Screen Recording, enable recappi, then recheck.",
+      Microphone: "Open System Settings \u203A Privacy & Security \u203A Microphone, enable recappi, then recheck."
+    };
+  }
+});
+
 // src/tui/AppShell.tsx
 import { useCallback, useEffect as useEffect2, useState as useState5 } from "react";
-import { Box as Box13, Text as Text13, useApp, useInput as useInput5 } from "ink";
-import { Fragment as Fragment4, jsx as jsx15, jsxs as jsxs12 } from "react/jsx-runtime";
+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";
 function recordErrorCopy(code, message) {
   switch (code) {
     case "record.helper_unavailable":
@@ -1317,10 +1363,54 @@ function recordErrorCopy(code, message) {
         detail: "Use the Recappi Mini app to record for now; CLI recording is coming soon.",
         tone: "yellow"
       };
+    case "record.permission_required":
+      return {
+        title: "Recording needs macOS permission first.",
+        detail: "Open System Settings > Privacy & Security, allow recording access, then retry.",
+        tone: "yellow"
+      };
+    case "record.capture_failed":
+      return {
+        title: "Couldn't start recording.",
+        detail: "Recording failed to start \u2014 please try again.",
+        tone: "red"
+      };
     default:
       return { title: "Couldn't start recording.", detail: message, tone: "red" };
   }
 }
+function recordErrorState(error51) {
+  if (error51 instanceof Error) {
+    const descriptor = isRecord6(error51) && isRecord6(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
+    };
+  }
+  return { kind: "error", message: String(error51) };
+}
+function permissionItemsFromRecordError(data) {
+  const sidecarError = isRecord6(data) ? data : void 0;
+  const sidecarData = isRecord6(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 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) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 function AppShell({
   fetchJobs,
   fetchTranscript,
@@ -1359,6 +1449,7 @@ function AppShell({
   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 refreshDownloadedIds = useCallback(async () => {
     if (!listDownloadedRecordingIds) return;
     try {
@@ -1403,18 +1494,13 @@ function AppShell({
       setLiveRecord({ kind: "live", session });
     }).catch((error51) => {
       if (!cancelled) {
-        const code = error51 && typeof error51 === "object" && "code" in error51 ? String(error51.code) : void 0;
-        setLiveRecord({
-          kind: "error",
-          code,
-          message: error51 instanceof Error ? error51.message : String(error51)
-        });
+        setLiveRecord(recordErrorState(error51));
       }
     });
     return () => {
       cancelled = true;
     };
-  }, [screen.kind, startLiveRecord]);
+  }, [screen.kind, startLiveRecord, recordRetryNonce]);
   const selectedRecording = screen.kind === "overview" ? recordings[selected] : void 0;
   const peekTranscriptId = selectedRecording?.activeTranscriptId ?? void 0;
   useEffect2(() => {
@@ -1592,6 +1678,14 @@ function AppShell({
   useInput5((input, key) => {
     setNotice(void 0);
     if (screen.kind === "record") {
+      if (liveRecord?.kind === "error" && input === "r") {
+        setRecordRetryNonce((value) => value + 1);
+        return;
+      }
+      if (liveRecord?.kind === "error" && input === "o") {
+        openUrl2?.(settingsUrlFromRecordError(liveRecord.data));
+        return;
+      }
       if (input === "q" || key.escape || key.leftArrow) void stopLiveRecord();
       return;
     }
@@ -1647,18 +1741,18 @@ function AppShell({
     }
   });
   if (screen.kind === "transcript") {
-    return /* @__PURE__ */ jsx15(TranscriptView, { loading: screen.loading, data: screen.data, error: screen.error });
+    return /* @__PURE__ */ jsx16(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__ */ jsx15(Missing, { label: "Job" });
-    return /* @__PURE__ */ jsx15(Detail, { notice, children: /* @__PURE__ */ jsx15(JobDetailView, { item: job, origin, spinnerFrame, nowMs: now() }) });
+    if (!job) return /* @__PURE__ */ jsx16(Missing, { label: "Job" });
+    return /* @__PURE__ */ jsx16(Detail, { notice, children: /* @__PURE__ */ jsx16(JobDetailView, { item: job, origin, spinnerFrame, nowMs: now() }) });
   }
   if (screen.kind === "recordingDetail") {
     const rec = recordings.find((r) => r.recordingId === screen.recordingId);
-    if (!rec) return /* @__PURE__ */ jsx15(Missing, { label: "Recording" });
+    if (!rec) return /* @__PURE__ */ jsx16(Missing, { label: "Recording" });
     const detailTranscript = rec.activeTranscriptId ? transcriptCache.get(rec.activeTranscriptId) : void 0;
-    return /* @__PURE__ */ jsx15(Detail, { notice, children: /* @__PURE__ */ jsx15(
+    return /* @__PURE__ */ jsx16(Detail, { notice, children: /* @__PURE__ */ jsx16(
       RecordingDetailView,
       {
         item: rec,
@@ -1670,18 +1764,21 @@ function AppShell({
   }
   if (screen.kind === "record") {
     if (liveRecord?.kind === "live") {
-      return /* @__PURE__ */ jsx15(LiveCaptionsScreen, { source: liveRecord.session.source, now });
+      return /* @__PURE__ */ jsx16(LiveCaptionsScreen, { source: liveRecord.session.source, now });
     }
-    return /* @__PURE__ */ jsxs12(Box13, { flexDirection: "column", height: size.rows, paddingX: 1, children: [
-      /* @__PURE__ */ jsx15(Header, { active: "record" }),
-      /* @__PURE__ */ jsx15(Box13, { flexGrow: 1, flexDirection: "column", paddingX: 1, paddingTop: 1, children: liveRecord?.kind === "error" ? (() => {
+    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" ? (() => {
+        if (liveRecord.code === "record.permission_required") {
+          return /* @__PURE__ */ jsx16(PermissionPreflightView, { items: permissionItemsFromRecordError(liveRecord.data) });
+        }
         const copy = recordErrorCopy(liveRecord.code, liveRecord.message);
-        return /* @__PURE__ */ jsxs12(Fragment4, { children: [
-          /* @__PURE__ */ jsx15(Text13, { color: copy.tone, children: copy.title }),
-          copy.detail ? /* @__PURE__ */ jsx15(Text13, { dimColor: true, children: copy.detail }) : null
+        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
         ] });
-      })() : /* @__PURE__ */ jsx15(Text13, { dimColor: true, children: "Starting live recording\u2026" }) }),
-      /* @__PURE__ */ jsx15(Footer, { keys: "q / esc / \u2190 back" })
+      })() : /* @__PURE__ */ jsx16(Text14, { dimColor: true, children: "Starting live recording\u2026" }) }),
+      /* @__PURE__ */ jsx16(Footer, { keys: "q / esc / \u2190 back" })
     ] });
   }
   const tab = screen.kind === "jobs" ? "jobs" : screen.kind === "account" ? "account" : "overview";
@@ -1699,7 +1796,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__ */ jsx15(
+    body = /* @__PURE__ */ jsx16(
       OverviewView,
       {
         recordings: recordings.slice(win.start, win.end),
@@ -1719,11 +1816,11 @@ function AppShell({
     );
   } else if (screen.kind === "account") {
     position = "";
-    body = /* @__PURE__ */ jsx15(AccountView, { status: accountStatus });
+    body = /* @__PURE__ */ jsx16(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__ */ jsx15(
+    body = /* @__PURE__ */ jsx16(
       JobsView,
       {
         items: jobs.slice(win.start, win.end),
@@ -1733,34 +1830,34 @@ 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__ */ jsxs12(Box13, { flexDirection: "column", height: size.rows, paddingX: 1, children: [
-    /* @__PURE__ */ jsx15(Header, { active: tab }),
-    /* @__PURE__ */ jsxs12(Box13, { flexGrow: 1, flexDirection: "column", children: [
+  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: [
       body,
-      loadError && jobs.length === 0 && recordings.length === 0 ? /* @__PURE__ */ jsx15(Box13, { marginTop: 1, children: /* @__PURE__ */ jsxs12(Text13, { color: "red", children: [
+      loadError && jobs.length === 0 && recordings.length === 0 ? /* @__PURE__ */ jsx16(Box14, { marginTop: 1, children: /* @__PURE__ */ jsxs13(Text14, { color: "red", children: [
         "! ",
         loadError
       ] }) }) : null
     ] }),
-    /* @__PURE__ */ jsx15(Footer, { keys: footerKeys })
+    /* @__PURE__ */ jsx16(Footer, { keys: footerKeys })
   ] });
 }
 function Detail({
   notice,
   children
 }) {
-  return /* @__PURE__ */ jsxs12(Box13, { flexDirection: "column", children: [
+  return /* @__PURE__ */ jsxs13(Box14, { flexDirection: "column", children: [
     children,
-    notice ? /* @__PURE__ */ jsx15(Box13, { paddingX: 1, children: /* @__PURE__ */ jsx15(Text13, { color: "green", children: notice }) }) : null
+    notice ? /* @__PURE__ */ jsx16(Box14, { paddingX: 1, children: /* @__PURE__ */ jsx16(Text14, { color: "green", children: notice }) }) : null
   ] });
 }
 function Missing({ label }) {
-  return /* @__PURE__ */ jsxs12(Box13, { flexDirection: "column", paddingX: 1, children: [
-    /* @__PURE__ */ jsxs12(Text13, { dimColor: true, children: [
+  return /* @__PURE__ */ jsxs13(Box14, { flexDirection: "column", paddingX: 1, children: [
+    /* @__PURE__ */ jsxs13(Text14, { dimColor: true, children: [
       label,
       " no longer in the list."
     ] }),
-    /* @__PURE__ */ jsx15(Text13, { dimColor: true, children: "esc back \xB7 q quit" })
+    /* @__PURE__ */ jsx16(Text14, { dimColor: true, children: "esc back \xB7 q quit" })
   ] });
 }
 var RECORDINGS_PAGE_SIZE, RECORDINGS_PREFETCH_REMAINING;
@@ -1775,6 +1872,7 @@ var init_AppShell = __esm({
     init_RecordingDetailView();
     init_TranscriptView();
     init_LiveCaptionsScreen();
+    init_PermissionPreflightView();
     init_format();
     init_terminal();
     RECORDINGS_PAGE_SIZE = 50;
@@ -16400,6 +16498,8 @@ var cliErrorCodeSchema = external_exports.enum([
   "record.helper_unavailable",
   "record.unsupported_platform",
   "record.capture_unavailable",
+  "record.permission_required",
+  "record.capture_failed",
   "cloud.conflict.upload_in_progress",
   "cloud.recording_not_ready",
   "cloud.job_failed",
@@ -16496,6 +16596,19 @@ var sidecarRecordingOptionsSchema = external_exports.object({
   transcriptionLanguage: external_exports.string().optional(),
   title: external_exports.string().optional()
 });
+var sidecarPermissionNameSchema = external_exports.enum(["screen_recording", "microphone"]);
+var sidecarPermissionStatusSchema = external_exports.enum(["granted", "denied", "unknown"]);
+var sidecarPermissionItemSchema = external_exports.object({
+  name: sidecarPermissionNameSchema,
+  status: sidecarPermissionStatusSchema,
+  hint: external_exports.string().optional()
+});
+var sidecarPermissionStatusParamsSchema = external_exports.object({
+  options: sidecarRecordingOptionsSchema
+});
+var sidecarPermissionStatusResultSchema = external_exports.object({
+  permissions: external_exports.array(sidecarPermissionItemSchema)
+});
 var sidecarRecordingStateSchema = external_exports.enum([
   "idle",
   "starting",
@@ -16567,6 +16680,12 @@ var sidecarRequestSchema = external_exports.discriminatedUnion("method", [
     method: external_exports.literal("recappi.recording.start"),
     params: sidecarRecordingStartParamsSchema
   }),
+  external_exports.object({
+    jsonrpc: external_exports.literal("2.0"),
+    id: sidecarJsonRpcIdSchema,
+    method: external_exports.literal("recappi.permissions.status"),
+    params: sidecarPermissionStatusParamsSchema
+  }),
   external_exports.object({
     jsonrpc: external_exports.literal("2.0"),
     id: sidecarJsonRpcIdSchema,
@@ -16894,6 +17013,8 @@ var DEFAULT_EXIT_CODES = {
   "record.helper_unavailable": 2,
   "record.unsupported_platform": 2,
   "record.capture_unavailable": 2,
+  "record.permission_required": 2,
+  "record.capture_failed": 1,
   "cloud.conflict.upload_in_progress": 5,
   "cloud.recording_not_ready": 5,
   "cloud.job_failed": 5,
@@ -19420,6 +19541,13 @@ var MiniSidecarClient = class {
       sidecarRecordingStartResultSchema
     );
   }
+  getPermissionStatus(params) {
+    return this.request(
+      "recappi.permissions.status",
+      sidecarPermissionStatusParamsSchema.parse(params),
+      sidecarPermissionStatusResultSchema
+    );
+  }
   stopRecording(params) {
     return this.request(
       "recappi.recording.stop",
@@ -19520,12 +19648,7 @@ var MiniSidecarClient = class {
     this.pending.delete(id);
     clearTimeout(pending.timer);
     if ("error" in response.data) {
-      pending.reject(
-        cliError("internal.unexpected", response.data.error.message, {
-          data: response.data.error,
-          retryable: response.data.error.code >= -32099 && response.data.error.code <= -32e3
-        })
-      );
+      pending.reject(sidecarErrorToCliError(response.data.error));
       return;
     }
     pending.resolve(response.data.result);
@@ -19538,6 +19661,27 @@ var MiniSidecarClient = class {
     }
   }
 };
+function sidecarErrorToCliError(error51) {
+  const data = isRecord5(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;
+  if (maybeCode?.success) {
+    return cliError(maybeCode.data, error51.message, {
+      data: error51,
+      hint,
+      retryable
+    });
+  }
+  return cliError("internal.unexpected", error51.message, {
+    data: error51,
+    hint,
+    retryable
+  });
+}
+function isRecord5(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 function spawnMiniSidecar(opts) {
   const spawnProcess = opts.spawnProcess ?? spawn2;
   const child = spawnProcess(opts.command, opts.args ?? [], {
@@ -19602,7 +19746,7 @@ async function recordViaSidecar(opts) {
   }
 }
 async function startLiveRecordSession(opts) {
-  const session = await startRecordSession({ ...opts, live: true });
+  const session = await startRecordSession({ ...opts, live: false });
   return {
     source: session.source,
     stop: async () => {
@@ -19658,16 +19802,19 @@ async function startRecordSession(opts) {
       })
     );
     assertSidecarCapabilities(handshake, opts);
+    const recordingOptions = {
+      includeSystemAudio: opts.includeSystemAudio ?? true,
+      includeMicrophone: opts.includeMicrophone ?? true,
+      liveCaptions: opts.live === true,
+      ...opts.translationLanguage ? { translationLanguage: opts.translationLanguage } : {},
+      ...opts.transcriptionLanguage ? { transcriptionLanguage: opts.transcriptionLanguage } : {},
+      ...opts.title ? { title: opts.title } : {}
+    };
+    const preflight = await sidecar.client.getPermissionStatus({ options: recordingOptions });
+    assertRecordingPermissions(preflight.permissions);
     const started = await sidecar.client.startRecording({
       account,
-      options: {
-        includeSystemAudio: opts.includeSystemAudio ?? true,
-        includeMicrophone: opts.includeMicrophone ?? true,
-        liveCaptions: opts.live === true,
-        ...opts.translationLanguage ? { translationLanguage: opts.translationLanguage } : {},
-        ...opts.transcriptionLanguage ? { transcriptionLanguage: opts.transcriptionLanguage } : {},
-        ...opts.title ? { title: opts.title } : {}
-      }
+      options: recordingOptions
     });
     sessionId = started.sessionId;
     latestState = started.state;
@@ -19709,6 +19856,24 @@ async function startRecordSession(opts) {
     throw error51;
   }
 }
+function assertRecordingPermissions(permissions) {
+  const blocked = permissions.find((permission) => permission.status !== "granted");
+  if (!blocked) return;
+  const label = blocked.name === "microphone" ? "Microphone" : blocked.name === "screen_recording" ? "Screen Recording" : "Recording";
+  throw cliError("record.permission_required", `${label} permission is required before recording.`, {
+    hint: blocked.hint,
+    data: {
+      code: -32020,
+      message: `${label} permission is required before recording.`,
+      data: {
+        cliCode: "record.permission_required",
+        permission: blocked.name,
+        ...blocked.hint ? { recovery: blocked.hint } : {},
+        permissions
+      }
+    }
+  });
+}
 function assertSidecarCapabilities(handshake, opts) {
   const capabilities = new Set(handshake.capabilities);
   const missing = [];