Skip to content

Soul-driven AI agent with permission-hardened tools, token budgets, and multi-channel access. Runs 24/7 from CLI, Telegram or More.

feat(whatsapp): link, check and unlink WhatsApp from the dashboard

Salman Qureshic03fec3fdf86
diff --git a/src/plugins/qr-svg.test.ts b/src/plugins/qr-svg.test.ts
new file mode 100644
index 00000000..70e5b3ce
--- /dev/null
+++ b/src/plugins/qr-svg.test.ts
@@ -0,0 +1,15 @@
+import { describe, expect, it } from 'vitest';
+import { qrSvg } from './qr-svg.js';
+
+describe('qrSvg', () => {
+ it('renders a square SVG with dark modules on white', () => {
+ const svg = qrSvg('2@AbCdEf,GhIjKl,MnOpQr==', 4);
+ expect(svg.startsWith('<svg')).toBe(true);
+ const size = Number(/viewBox="0 0 (\d+) \1"/.exec(svg)?.[1]);
+ expect(size).toBeGreaterThan(100);
+ expect(svg).toMatch(/<path d="M\d+ \d+h4v4h-4z/);
+ });
+ it('is deterministic', () => {
+ expect(qrSvg('hello')).toBe(qrSvg('hello'));
+ });
+});
diff --git a/src/plugins/qr-svg.ts b/src/plugins/qr-svg.ts
new file mode 100644
index 00000000..c7ec467d
--- /dev/null
+++ b/src/plugins/qr-svg.ts
@@ -0,0 +1,33 @@
+/**
+ * Render a QR code as SVG for the dashboard (WhatsApp linking). Uses the
+ * encoder bundled in qrcode-terminal, which Mercury already ships, so the
+ * dashboard needs no QR library of its own.
+ */
+// @ts-ignore: CommonJS module without types
+import QRCode from 'qrcode-terminal/vendor/QRCode/index.js';
+// @ts-ignore: CommonJS module without types
+import QRErrorCorrectLevel from 'qrcode-terminal/vendor/QRCode/QRErrorCorrectLevel.js';
+
+interface QRCodeInstance {
+ addData(data: string): void;
+ make(): void;
+ getModuleCount(): number;
+ isDark(row: number, col: number): boolean;
+}
+
+export function qrSvg(text: string, scale = 6): string {
+ const Ctor = QRCode as unknown as new (type: number, level: number) => QRCodeInstance;
+ const qr = new Ctor(-1, (QRErrorCorrectLevel as { L: number }).L);
+ qr.addData(text);
+ qr.make();
+ const n = qr.getModuleCount();
+ const quiet = 4;
+ const size = (n + quiet * 2) * scale;
+ let path = '';
+ for (let r = 0; r < n; r++) {
+ for (let c = 0; c < n; c++) {
+ if (qr.isDark(r, c)) path += `M${(c + quiet) * scale} ${(r + quiet) * scale}h${scale}v${scale}h-${scale}z`;
+ }
+ }
+ return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${size} ${size}" width="${size}" height="${size}" shape-rendering="crispEdges"><rect width="100%" height="100%" fill="#fff"/><path d="${path}" fill="#000"/></svg>`;
+}
diff --git a/src/web/api/plugins.ts b/src/web/api/plugins.ts
index c36c5109..97c0e24e 100644
--- a/src/web/api/plugins.ts
+++ b/src/web/api/plugins.ts
@@ -11,6 +11,7 @@ import { Hono, type Context } from 'hono';
import { isLoopbackRequest } from '../middleware.js';
import { getPluginManager } from '../../plugins/manager.js';
import { localService } from '../../plugins/service.js';
+import { qrSvg } from '../../plugins/qr-svg.js';
const plugins = new Hono();
@@ -114,7 +115,10 @@ plugins.post('/api/plugins/:id/settings', async (c) => {
plugins.get('/api/plugins/:id/channel', (c) => {
const denied = localOnly(c);
if (denied) return denied;
- return c.json({ status: getPluginManager().channelStatus(c.req.param('id')) });
+ const status = getPluginManager().channelStatus(c.req.param('id'));
+ // qr for the terminal (`mercury plugins pair`), qrImage for the dashboard.
+ const qrImage = status?.qr ? `data:image/svg+xml;base64,${Buffer.from(qrSvg(status.qr)).toString('base64')}` : undefined;
+ return c.json({ status: status ? { ...status, qrImage } : null });
});
plugins.post('/api/plugins/:id/pair', async (c) => {
diff --git a/ui/src/lib/api.ts b/ui/src/lib/api.ts
index a9c57f39..d53a567f 100644
--- a/ui/src/lib/api.ts
+++ b/ui/src/lib/api.ts
@@ -297,6 +297,16 @@ export interface PluginItem {
lastError?: string;
incompatibleReason?: string;
settings?: PluginSetting[];
+ channel?: { type: string; state?: string; detail?: string; account?: string };
+ missing?: Array<{ key: string; unlocks: string; needs: string; fix: string }>;
+}
+
+export interface PluginChannelStatus {
+ state: string;
+ detail?: string;
+ account?: string;
+ pairCode?: string;
+ qrImage?: string;
}
export const plugins = {
@@ -312,6 +322,10 @@ export const plugins = {
uninstall: (id: string, purge = false) => del<{ ok: boolean }>(`/api/plugins/${encodeURIComponent(id)}${purge ? "?purge=1" : ""}`),
setSetting: (id: string, key: string, value: unknown) =>
post<{ ok: boolean }>(`/api/plugins/${encodeURIComponent(id)}/settings`, { key, value }),
+ channel: (id: string) => get<{ status: PluginChannelStatus | null }>(`/api/plugins/${encodeURIComponent(id)}/channel`),
+ pair: (id: string, method: "qr" | "code", phone?: string) =>
+ post<{ status: PluginChannelStatus }>(`/api/plugins/${encodeURIComponent(id)}/pair`, { method, phone }),
+ unlink: (id: string) => post<{ ok: boolean }>(`/api/plugins/${encodeURIComponent(id)}/unlink`, {}),
};
// ── Permissions ──
diff --git a/ui/src/pages/Plugins.tsx b/ui/src/pages/Plugins.tsx
index 5937c24a..ae004413 100644
--- a/ui/src/pages/Plugins.tsx
+++ b/ui/src/pages/Plugins.tsx
@@ -19,6 +19,9 @@ import {
Search,
Cpu,
Boxes,
+ Link2,
+ Unlink,
+ AlertTriangle,
} from "lucide-react";
import { Card, CardContent } from "@/components/ui/card";
import { Button } from "@/components/ui/button";
@@ -44,7 +47,7 @@ import {
AlertDialogTitle,
} from "@/components/ui/alert-dialog";
import { cn } from "@/lib/utils";
-import api, { type PluginItem, type PluginSetting } from "@/lib/api";
+import api, { type PluginChannelStatus, type PluginItem, type PluginSetting } from "@/lib/api";
/* ── Helpers ────────────────────────────────────────────────── */
@@ -486,6 +489,13 @@ function PluginDetails({ p, busy, safeMode, onAct, onInstall, onClose }: {
</p>
{note && <p className="rounded-md border border-destructive/30 bg-destructive/5 p-2 text-xs text-destructive">{note}</p>}
<PermissionList p={p} />
+ {(p.missing ?? []).map((m) => (
+ <p key={m.key} className="flex items-start gap-2 rounded-md border border-amber-500/30 bg-amber-500/5 p-2 text-xs">
+ <AlertTriangle className="mt-0.5 h-3.5 w-3.5 shrink-0 text-amber-500" />
+ <span><strong>{m.unlocks}</strong> needs {m.needs}. {m.fix}</span>
+ </p>
+ ))}
+ {p.channel && p.installedVersion && <ChannelPanel id={p.id} enabled={p.enabled} />}
{p.settings && p.settings.length > 0 && (
<div className="space-y-3 rounded-lg border border-border p-3">
<p className="text-xs font-medium uppercase tracking-wide text-muted-foreground">Settings</p>
@@ -553,3 +563,117 @@ function PluginDetails({ p, busy, safeMode, onAct, onInstall, onClose }: {
</>
);
}
+
+/* ── Channel plugins (e.g. WhatsApp): link, status, unlink ───── */
+
+const CHANNEL_STATE: Record<string, string> = {
+ connected: "Linked",
+ "needs-pairing": "Not linked yet",
+ pairing: "Waiting for you to link",
+ starting: "Starting…",
+ disconnected: "Reconnecting…",
+ "logged-out": "Logged out",
+ error: "Error",
+};
+
+function ChannelPanel({ id, enabled }: { id: string; enabled: boolean }) {
+ const [status, setStatus] = useState<PluginChannelStatus | null>(null);
+ const [linking, setLinking] = useState(false);
+ const [phone, setPhone] = useState("");
+ const [error, setError] = useState<string | null>(null);
+
+ const refresh = useCallback(async () => {
+ try {
+ const r = await api.plugins.channel(id);
+ setStatus(r.status);
+ return r.status;
+ } catch (err) {
+ setError(errorText(err, "Couldn't read the connection status"));
+ return null;
+ }
+ }, [id]);
+
+ useEffect(() => {
+ if (enabled) void refresh();
+ }, [enabled, refresh]);
+
+ // While linking, poll so the QR refreshes and "Linked" shows up by itself.
+ useEffect(() => {
+ if (!linking) return;
+ const t = setInterval(async () => {
+ const s = await refresh();
+ if (s?.state === "connected" || s?.state === "error") setLinking(false);
+ }, 2000);
+ const stop = setTimeout(() => setLinking(false), 3 * 60_000);
+ return () => { clearInterval(t); clearTimeout(stop); };
+ }, [linking, refresh]);
+
+ async function pair(method: "qr" | "code") {
+ setError(null);
+ try {
+ const r = await api.plugins.pair(id, method, method === "code" ? phone : undefined);
+ setStatus(r.status);
+ setLinking(r.status.state !== "connected");
+ if (method === "qr") await refresh();
+ } catch (err) {
+ setError(errorText(err, "Couldn't start linking"));
+ }
+ }
+
+ async function unlink() {
+ if (!window.confirm("Log Mercury out of this account? You can link it again any time.")) return;
+ setError(null);
+ try {
+ await api.plugins.unlink(id);
+ await refresh();
+ } catch (err) {
+ setError(errorText(err, "Couldn't unlink"));
+ }
+ }
+
+ if (!enabled) return <p className="text-xs text-muted-foreground">Enable the plugin to link an account.</p>;
+ const state = status?.state ?? "starting";
+ const connected = state === "connected";
+ return (
+ <div className="space-y-3 rounded-lg border border-border p-3">
+ <div className="flex items-center justify-between gap-2">
+ <p className="text-xs font-medium uppercase tracking-wide text-muted-foreground">Account</p>
+ <Badge variant={connected ? "success" : state === "error" || state === "logged-out" ? "destructive" : "secondary"}>
+ {CHANNEL_STATE[state] ?? state}
+ </Badge>
+ </div>
+ {status?.account && <p className="text-sm">Linked as <span className="font-mono">+{status.account}</span></p>}
+ {status?.detail && !connected && <p className="text-xs text-muted-foreground">{status.detail}</p>}
+ {linking && status?.qrImage && (
+ <div className="flex flex-col items-center gap-2">
+ <img src={status.qrImage} alt="Scan this QR code with the phone you are linking" className="h-56 w-56 rounded-md bg-white p-2" />
+ <p className="text-center text-xs text-muted-foreground">On the spare phone: WhatsApp → Settings → Linked devices → Link a device, then scan. It refreshes every ~20 seconds.</p>
+ </div>
+ )}
+ {linking && status?.pairCode && (
+ <div className="text-center">
+ <p className="font-mono text-2xl tracking-widest">{status.pairCode}</p>
+ <p className="text-xs text-muted-foreground">On the spare phone: Linked devices → Link a device → Link with phone number instead, then type this code.</p>
+ </div>
+ )}
+ {!connected && (
+ <div className="space-y-2">
+ <Button size="sm" onClick={() => pair("qr")} className="w-full">
+ <Link2 className="h-4 w-4" />Link with QR code
+ </Button>
+ <form className="flex gap-2" onSubmit={(e) => { e.preventDefault(); if (phone.trim()) void pair("code"); }}>
+ <Input value={phone} onChange={(e) => setPhone(e.target.value)} placeholder="Or the spare number, e.g. +15550001111" className="h-8 text-sm" />
+ <Button size="sm" variant="outline" type="submit" disabled={!phone.trim()}>Get code</Button>
+ </form>
+ <p className="text-xs text-amber-600 dark:text-amber-400">Unofficial protocol: link a spare number you can afford to lose, not your main one.</p>
+ </div>
+ )}
+ {connected && (
+ <Button size="sm" variant="outline" onClick={unlink}>
+ <Unlink className="h-4 w-4" />Unlink
+ </Button>
+ )}
+ {error && <p className="text-xs text-destructive">{error}</p>}
+ </div>
+ );
+}