tbenandClaude Opus 5.5
380d3ebb2f
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]>
41 lines
1.6 KiB
TypeScript
41 lines
1.6 KiB
TypeScript
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 })}.`;
|
|
},
|
|
};
|
|
}
|