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/functions/backend/db/bot-hooks/find-bot-hook-by-token.ts

@@ -0,0 +1,29 @@
+import BunSQLite from "@moduletrace/bun-sqlite";
+import type { BUN_SQLITE_COBBLE_BOT_HOOKS } from "@/db/types/db";
+import { BotHookTokenPrefix } from "@/src/dict/bot-hook-dict";
+import hashHookToken from "@/src/utils/hash-hook-token";
+import { safeCompare } from "@/src/utils/safe-compare";
+
+type Params = {
+    token: string;
+};
+
+/**
+ * The hook a call's token names, or null. Found by the token's first
+ * characters, then its hash compared in constant time, so the lookup
+ * says nothing about how close a guess came.
+ */
+export default async function findBotHookByToken({ token }: Params): Promise<BUN_SQLITE_COBBLE_BOT_HOOKS | null> {
+    if (!token.startsWith(BotHookTokenPrefix) || token.length < 20 || token.length > 200) {
+        return null;
+    }
+
+    const { prefix, hash } = hashHookToken({ token });
+
+    const res = await BunSQLite.sql<BUN_SQLITE_COBBLE_BOT_HOOKS>({
+        sql: `SELECT * FROM bot_hooks WHERE token_prefix = ?`,
+        values: [prefix],
+    });
+
+    return (res.payload || []).find((hook) => safeCompare(hash, hook.token_hash || "")) || null;
+}