Let bots manage their hooks, with the user confirming what widens them

Bots get list_hooks, pause_hook and delete_hook, which act directly since they only take away. A new hook, or a new name, brief or filter, or switching a paused one back on, goes through propose_hook: it stores a hook_proposals row and puts a [hook-proposal:ID] card in the reply, which the user it was proposed to confirms or rejects. The card is read from what Confirm saves, with the bot's reason labelled as its own; confirming checks everything again and saves through the Hooks modal's helpers. A new hook's URL is shown on the card once, to the user only, never in the outcome the bot is told. What calls a hook, its computers and its signing are never proposed. Only chat replies propose, and a hook call's own run gets no hook tools, so a caller's payload can't reach them. Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-10-25 15:18:54 +01:00
parent 045167715d
commit 380d3ebb2f
54 changed files with 1983 additions and 55 deletions
@@ -0,0 +1,40 @@
+import { z } from "zod";
+import updateBotHook from "@/src/functions/backend/db/bot-hooks/update-bot-hook";
+import describeBotHook from "@/src/utils/describe-bot-hook";
+import type { HarnessTool } from "../../../types";
+import grabOwnHook from "./grab-own-hook";
+
+type Params = {
+    user_id: number | string;
+    bot_id: number | string;
+};
+
+type Args = {
+    hook_id: number;
+};
+
+/**
+ * Lets a bot pause one of its hooks: calls are refused until it's on
+ * again. Only taking away needs no confirming; switching it back on is a
+ * proposal (`propose_hook`).
+ */
+export default function pauseHookTool({ user_id, bot_id }: Params): HarnessTool<Args> {
+    return {
+        name: "pause_hook",
+        description: `Pause one of your hooks (ids from list_hooks): calls to it are refused until it's switched back on. Use it when the user asks, or when a hook keeps sending work that fails or that the user doesn't want. Switching it back on needs the user's confirmation: propose it with propose_hook (hook_id, enabled true).`,
+        schema: z.object({
+            hook_id: z.number().int().positive(),
+        }),
+        run: async ({ args }) => {
+            const hook = await grabOwnHook({ user_id, bot_id, hook_id: args.hook_id });
+
+            if (!hook.enabled) return `Hook #${hook.id} "${hook.title}" is already paused.`;
+
+            const paused = await updateBotHook({ user_id, hook_id: hook.id!, data: { enabled: false } });
+
+            if (paused.enabled) throw new Error(`Hook #${hook.id} is still on: pausing it didn't take.`);
+
+            return `Hook paused: ${describeBotHook({ hook: paused })}.`;
+        },
+    };
+}