A personal assistant that lives on your desktop, remembers what matters, and can use your Mac for you.
TypeScript
import type { ConnectorInfo } from "@gentle-dot/protocol";
import { useCallback, useEffect, useState } from "react";
import {
type ComputerPermission,
type ComputerPermissions,
type ComputerSession,
type ComputerYolo,
timeLeft,
} from "../computer.ts";
import { isWindows } from "../shortcut.ts";
/** Computer control in the desktop panel (S24.5, S24.6); the web page never gets it. */
export interface ComputerControls {
/** The app has a helper (macOS), so the Connectors screen offers it. */
available: boolean;
/** The session the user allowed, while it lasts. */
session?: ComputerSession;
/** Yolo mode, while it is on (S24.9). */
yolo?: ComputerYolo;
stop: () => void;
/** Asks the app; its native confirmation decides, and the state follows. */
setYolo: (enabled: boolean) => Promise<unknown>;
permissions: () => Promise<ComputerPermissions>;
requestPermission: (kind: ComputerPermission) => Promise<unknown>;
}
const PERMISSIONS: [ComputerPermission, string][] = [
["accessibility", "Accessibility"],
["screenRecording", "Screen Recording"],
];
export const DEBUG_BUILD_NOTE =
"Debug builds lose these permissions on every rebuild because macOS ties them to the app's signature; grant them again after updating.";
/** Names the panic shortcut only when the app registered it; until it says so, only Stop is promised. */
const yoloNote = (windows: boolean, panicShortcut: boolean) =>
`Yolo mode lets the assistant send, pay, delete, and submit without asking you first. It turns itself off after 1 hour or when the app quits; ${panicShortcut ? `Stop and ${windows ? "Alt+Shift+Esc" : "⌥⇧Esc"} still work` : "Stop still works"}.`;
const WINDOWS_TOO_OLD_NOTE =
"Computer control needs Windows 10 version 2004 (build 19041) or newer for screenshots.";
const WINDOWS_UNKNOWN_VERSION_NOTE =
"Gentle Dot cannot tell which Windows version this is, so computer control is unavailable: screenshots need Windows 10 version 2004 (build 19041) or newer.";
const NO_IMAGES_NOTE =
"The current model does not accept images, so the assistant cannot see your screen. Choose a model that does in Profiles.";
interface ComputerBannerProps {
session: ComputerSession;
yolo: boolean;
stop: () => void;
}
/** "Controlling your Mac · mm:ss left" with a Stop button, while a session is active. */
export function ComputerBanner({ session, yolo, stop }: ComputerBannerProps) {
const [now, setNow] = useState(() => Date.now());
useEffect(() => {
const timer = setInterval(() => setNow(Date.now()), 1000);
return () => clearInterval(timer);
}, []);
const left = session.endsAt === undefined ? "" : ` · ${timeLeft(session.endsAt, now)} left`;
return (
<section className="computer-banner" aria-label="Computer control">
<span className="computer-banner-light" aria-hidden="true" />
<span>
Controlling your {isWindows() ? "PC" : "Mac"}
{left}
</span>
{yolo ? (
<span className="chip computer-yolo-chip" title="Risky actions run without asking you first">
Yolo
</span>
) : null}
<button type="button" className="primary" onClick={stop}>
Stop
</button>
</section>
);
}
interface ComputerEntryProps {
/** The daemon's built-in entry, once the helper is registered. */
info?: ConnectorInfo;
controls: ComputerControls;
}
/** The built-in Computer connector: the macOS permissions it needs and how to grant them (Windows asks for none). */
export function ComputerEntry({ info, controls }: ComputerEntryProps) {
const { permissions, requestPermission, yolo, setYolo } = controls;
const windows = isWindows();
const [granted, setGranted] = useState<ComputerPermissions>();
const check = useCallback(() => {
permissions().then(setGranted, () => setGranted(undefined));
}, [permissions]);
useEffect(check, [check]);
return (
<li className="computer-entry" aria-labelledby="connector-computer">
<div className="provider-name">
<b id="connector-computer">Computer</b>
<span className="chip connector-connected">Built in</span>
</div>
{info ? (
<>
<p className="connector-note">{info.reads}</p>
<p className="connector-note">{info.sends}</p>
</>
) : null}
{windows ? (
<p className="connector-note">Windows asks for no permission for computer control.</p>
) : null}
{windows ? null : (
<ul className="computer-permissions">
{PERMISSIONS.map(([kind, label]) => {
const allowed = granted?.[kind] === true;
const id = `computer-permission-${kind}`;
return (
<li key={kind} aria-labelledby={id}>
<span id={id}>{label}</span>
<span className={`chip ${allowed ? "connector-connected" : "connector-needs_setup"}`}>
{granted === undefined ? "Checking…" : allowed ? "Allowed" : "Not allowed"}
</span>
{granted !== undefined && !allowed ? (
<button
type="button"
className="primary"
aria-label={`Grant ${label}`}
onClick={() => {
requestPermission(kind).then(check, check);
}}
>
Grant
</button>
) : null}
</li>
);
})}
</ul>
)}
{windows ? null : (
<div className="provider-actions">
<button type="button" onClick={check}>
Check again
</button>
</div>
)}
{windows && granted?.screenshotsSupported === false ? (
<p className="connector-note computer-warning">
{granted.screenshotsUnsupported === "unknownVersion"
? WINDOWS_UNKNOWN_VERSION_NOTE
: WINDOWS_TOO_OLD_NOTE}
</p>
) : null}
<div className="computer-yolo">
<span id="computer-yolo-label">Yolo mode</span>
<button
type="button"
role="switch"
className="switch"
aria-checked={yolo !== undefined}
aria-labelledby="computer-yolo-label"
onClick={() => {
setYolo(yolo === undefined).catch(() => {});
}}
>
<span className="switch-knob" aria-hidden="true" />
</button>
</div>
<p className="connector-note">{yoloNote(windows, granted?.panicShortcut === true)}</p>
{windows ? null : <p className="connector-note">{DEBUG_BUILD_NOTE}</p>}
{info?.noImages ? <p className="connector-note computer-warning">{NO_IMAGES_NOTE}</p> : null}
</li>
);
}