Let outside services and computers' browser notifications give bots work

A bot hook (bot_hooks) is a secret URL, POST /api/hooks/<token>, whose
calls queue the hook's brief plus the raw body as a task, per user and
bot like a routine. Only the token's hash is kept (shown once, rotatable);
an optional HMAC-SHA256 signing secret is stored encrypted. Calls are
rate limited per address and per hook, recorded in bot_hook_events
(pruned daily), deduplicated by delivery id, and a call while the last
run still waits joins its brief instead of queueing another. The payload
is fenced data and HookRunNote tells the bot never to take instructions
from it; failed runs retry like routines.

A hook can instead watch a computer's browser notifications: the app
installs a small watcher that owns org.freedesktop.Notifications on the
sandbox's session bus, so Chrome hands it every notification (it only
looks for that service at start-up, so Chrome is restarted once, never
mid-task), and it posts each one to its hooks, optionally filtered.
Computers reach the app at COMPUTER_APP_URL or the app container's name.

Users make hooks in the conversation's Hooks modal and manage them all
on /admin/routines; bots never create or change hooks.

Co-Authored-By: Claude Opus 5.5 <[email protected]>

src/utils/notify-watch-ensure-command.test.ts

@@ -0,0 +1,25 @@
+import { describe, expect, test } from "bun:test";
+import notifyWatchEnsureCommand from "./notify-watch-ensure-command";
+
+/**
+ * The command runs through the sandbox's shell as a Python heredoc, so the
+ * placeholders must all be filled and the heredoc must close.
+ */
+describe("notifyWatchEnsureCommand", () => {
+    test("fills the version and restart flag everywhere", () => {
+        const command = notifyWatchEnsureCommand({ version: "7", restart_browser: false });
+
+        expect(command).not.toContain("__VERSION__");
+        expect(command).not.toContain("__RESTART__");
+        expect(command.match(/== "7"|!= "7"/g)?.length).toBe(2);
+        expect(command).toContain("elif False:");
+        expect(notifyWatchEnsureCommand({ version: "7", restart_browser: true })).toContain("elif True:");
+    });
+
+    test("is one quoted heredoc", () => {
+        const command = notifyWatchEnsureCommand({ version: "1", restart_browser: true });
+
+        expect(command.startsWith("python3 - <<'COBBLE_NOTIFY_WATCH'\n")).toBe(true);
+        expect(command.endsWith("\nCOBBLE_NOTIFY_WATCH")).toBe(true);
+    });
+});