Files
cobble/src/functions/backend/db/bots-queue/notify-bot-job-failed.ts
T
tbenandClaude Opus 5.5 0e59559ea9 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]>
2026-10-25 17:47:28 +01:00

83 lines
2.6 KiB
TypeScript

import BunSQLite from "@moduletrace/bun-sqlite";
import type { BUN_SQLITE_COBBLE_BOTS_QUEUE } from "@/db/types/db";
import insertBotMessage from "../bots/insert-bot-message";
import setBotFace from "../bots/set-bot-face";
import relayJobToRequester from "./relay-job-to-requester";
import noteTrackerTask from "./note-tracker-task";
import recordHookCallResponse from "../bot-hooks/record-hook-call-response";
import jobSessionId from "./job-session-id";
import grabJobUserId from "./grab-job-user-id";
import { BotNeedsYouStatusLine } from "@/src/dict/bot-queue-dict";
type Params = {
job: BUN_SQLITE_COBBLE_BOTS_QUEUE;
failure_message?: string;
};
/**
* Wraps up a job that is out of attempts: stamps `finished_at` (so it's
* reported once), tells the user in the bot's conversation and sets the
* bot to needs-you for that user. Its task stays active, since the work isn't done. A
* handed-over job's failure also goes to the bot that handed it over, and
* blocks the handed-over task it worked on (`noteTrackerTask`). A hook run's
* calls keep why it failed (`recordHookCallResponse`).
*/
export default async function notifyBotJobFailed({
job,
failure_message,
}: Params) {
if (!job.id || !job.bot_id) {
throw new Error(`Job has no id or bot.`);
}
await BunSQLite.sql({
sql: `UPDATE bots_queue SET finished_at = ? WHERE id = ?`,
values: [Date.now(), job.id],
});
const message = await insertBotMessage({
bot_id: job.bot_id,
session_id: await jobSessionId({ job }),
workspace_id: job.workspace_id || null,
text:
failure_message ||
[
job.kind == "reply"
? `I couldn't reply.`
: `I couldn't finish "${job.title || "the job"}".`,
job.last_error,
]
.filter(Boolean)
.join(" "),
needs_you: true,
});
const user_id = await grabJobUserId({ job });
const bot = user_id
? await setBotFace({
bot_id: job.bot_id,
user_id,
face: "needs-you",
status_line: BotNeedsYouStatusLine,
})
: null;
await noteTrackerTask({ job, failure: failure_message || job.last_error || "" });
await recordHookCallResponse({
job,
status: "failed",
response: job.last_error || failure_message || "The run failed.",
message_id: message?.id,
});
const relay = await relayJobToRequester({
job,
text: failure_message || job.last_error || "",
failed: true,
});
return { message, bot, relay };
}