Keep every hook call's response, searchable by the user and the bot

A hook call used to record only how it was taken; its run's answer went
to the chat alone and was lost to the call once the job was pruned. Now
`bot_hook_events` keeps `response`, `response_message_id` and
`responded_at`, written on every call a run took in when that run ends
(completed, failed, lost, stopped or cancelled) by
`recordHookCallResponse` in the job helpers, and calls turn done or
failed. The Calls view searches what calls sent and what runs answered,
filters by status and pages; Show all loads one call whole. Bots get
`search_hook_calls` and `read_hook_call` for their own hooks (never in a
hook call's own run), with payloads always marked as outside data.
Calls are kept for the app setting `hook_events_keep_days` (Settings >
General, default now 30 days). The caller still only gets 202 Queued.

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

src/functions/backend/db/app-settings/grab-hook-events-keep-days.ts

@@ -0,0 +1,31 @@
+import { AppData } from "@/src/data/app-data";
+import { HookEventsKeepDaysSettingKey } from "@/src/dict/bot-hook-dict";
+import type { HookCallRetentionOverview } from "@/src/types";
+import readStepLimit from "@/src/utils/read-step-limit";
+import grabAppSetting from "./grab-app-setting";
+
+/**
+ * How many days hook calls (and their responses) are kept: the install's
+ * own number (`hook_events_keep_days`, Settings > General), else
+ * `AppData.BotHookEventsKeepDays`.
+ */
+export async function grabHookEventsKeepDays() {
+    return readStepLimit({
+        saved: await grabAppSetting({ key: HookEventsKeepDaysSettingKey }),
+        fallback: AppData.BotHookEventsKeepDays,
+        max: AppData.BotHookEventsKeepDaysMax,
+    });
+}
+
+/**
+ * The number with its default and ceiling, for the settings page.
+ */
+export default async function grabHookCallRetentionOverview() {
+    const overview: HookCallRetentionOverview = {
+        keep_days: await grabHookEventsKeepDays(),
+        default_days: AppData.BotHookEventsKeepDays,
+        max: AppData.BotHookEventsKeepDaysMax,
+    };
+
+    return overview;
+}