feat: add mac node screen recording and ssh tunnel

src/cli/nodes-screen.ts

@@ -0,0 +1,58 @@
+import { randomUUID } from "node:crypto";
+import * as os from "node:os";
+import * as path from "node:path";
+
+import { writeBase64ToFile } from "./nodes-camera.js";
+
+export type ScreenRecordPayload = {
+  format: string;
+  base64: string;
+  durationMs?: number;
+  fps?: number;
+  screenIndex?: number;
+};
+
+function asRecord(value: unknown): Record<string, unknown> {
+  return typeof value === "object" && value !== null
+    ? (value as Record<string, unknown>)
+    : {};
+}
+
+function asString(value: unknown): string | undefined {
+  return typeof value === "string" ? value : undefined;
+}
+
+export function parseScreenRecordPayload(value: unknown): ScreenRecordPayload {
+  const obj = asRecord(value);
+  const format = asString(obj.format);
+  const base64 = asString(obj.base64);
+  if (!format || !base64) {
+    throw new Error("invalid screen.record payload");
+  }
+  return {
+    format,
+    base64,
+    durationMs: typeof obj.durationMs === "number" ? obj.durationMs : undefined,
+    fps: typeof obj.fps === "number" ? obj.fps : undefined,
+    screenIndex:
+      typeof obj.screenIndex === "number" ? obj.screenIndex : undefined,
+  };
+}
+
+export function screenRecordTempPath(opts: {
+  ext: string;
+  tmpDir?: string;
+  id?: string;
+}) {
+  const tmpDir = opts.tmpDir ?? os.tmpdir();
+  const id = opts.id ?? randomUUID();
+  const ext = opts.ext.startsWith(".") ? opts.ext : `.${opts.ext}`;
+  return path.join(tmpDir, `clawdis-screen-record-${id}${ext}`);
+}
+
+export async function writeScreenRecordToFile(
+  filePath: string,
+  base64: string,
+) {
+  return writeBase64ToFile(filePath, base64);
+}