Add bot schedules (routines), open Activity, add Help and a Desktop computer view

Bots create, list, update and delete schedules (cron_jobs, Bun.cron in UTC);
a per-minute cron queues due runs as tasks. Routines, Activity (super admins)
and Help get their own rail aside. Help covers familiar problems, starting
with signing in to Google through Cookie-Editor over the new Desktop (noVNC)
view.

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

src/pages/api/admin/routines/delete-routine.ts

@@ -0,0 +1,50 @@
+import userAuth from "@/src/functions/backend/auth/user-auth";
+import deleteCronJob from "@/src/functions/backend/db/cron-jobs/delete-cron-job";
+import logEvent, { grabRequestIP } from "@/src/functions/backend/logger";
+import { CronJobIdRequestSchema } from "@/src/schemas/cron-job-schema";
+import AppError from "@/src/utils/app-error";
+import parseWithSchema from "@/src/utils/parse-with-schema";
+import isReadOnlyUser from "@/src/utils/rbac/is-read-only-user";
+import safeErrorMessage from "@/src/utils/safe-error-message";
+import type {
+    APIResponseObject,
+    BunextAPIRouteHandler,
+} from "@moduletrace/bunext/types";
+
+/**
+ * Deletes one of the session user's routines (a bot's schedule).
+ */
+export const handler: BunextAPIRouteHandler<APIResponseObject> = async ({ req, body }) => {
+    try {
+        if (req.method != "POST") {
+            throw new AppError(`Method not allowed`);
+        }
+
+        const { user, user_types } = await userAuth({ req });
+
+        if (!user?.logged_in_status || !user.id) {
+            return { success: false, msg: `Unauthorized`, logoutUser: true };
+        }
+
+        if (isReadOnlyUser({ user_types: user_types || [] })) {
+            throw new AppError(`This user can only read records.`);
+        }
+
+        const { cron_job_id } = parseWithSchema({ schema: CronJobIdRequestSchema, data: body });
+
+        const cron_job = await deleteCronJob({ user_id: user.id, cron_job_id });
+
+        await logEvent({
+            title: "Routine deleted",
+            category: "system",
+            user_id: user.id,
+            plain_text: `User #${user.id} deleted the routine "${cron_job.title}" of ${cron_job.bot_name}.`,
+            metadata: { cron_job_id },
+            ip_address: grabRequestIP(req),
+        });
+
+        return { success: true, msg: `${cron_job.title || "The routine"} is deleted.` };
+    } catch (error: unknown) {
+        return { success: false, msg: safeErrorMessage({ error }) };
+    }
+};

src/pages/api/admin/routines/update-routine.ts

@@ -0,0 +1,51 @@
+import userAuth from "@/src/functions/backend/auth/user-auth";
+import updateCronJob from "@/src/functions/backend/db/cron-jobs/update-cron-job";
+import { UpdateCronJobRequestSchema } from "@/src/schemas/cron-job-schema";
+import AppError from "@/src/utils/app-error";
+import parseWithSchema from "@/src/utils/parse-with-schema";
+import isReadOnlyUser from "@/src/utils/rbac/is-read-only-user";
+import safeErrorMessage from "@/src/utils/safe-error-message";
+import type { CronJobWithNames } from "@/src/types";
+import type {
+    APIResponseObject,
+    BunextAPIRouteHandler,
+} from "@moduletrace/bunext/types";
+
+/**
+ * Changes one of the session user's routines (a bot's schedule): its
+ * name, brief or schedule, or pauses and resumes it. Returns the routine.
+ */
+export const handler: BunextAPIRouteHandler<APIResponseObject<CronJobWithNames>> = async ({ req, body }) => {
+    try {
+        if (req.method != "POST") {
+            throw new AppError(`Method not allowed`);
+        }
+
+        const { user, user_types } = await userAuth({ req });
+
+        if (!user?.logged_in_status || !user.id) {
+            return { success: false, msg: `Unauthorized`, logoutUser: true };
+        }
+
+        if (isReadOnlyUser({ user_types: user_types || [] })) {
+            throw new AppError(`This user can only read records.`);
+        }
+
+        const { cron_job_id, ...data } = parseWithSchema({ schema: UpdateCronJobRequestSchema, data: body });
+
+        const cron_job = await updateCronJob({ user_id: user.id, cron_job_id, data });
+
+        return {
+            success: true,
+            singleRes: cron_job,
+            msg:
+                data.enabled === undefined
+                    ? `Saved.`
+                    : data.enabled
+                      ? `${cron_job.title} is back on.`
+                      : `${cron_job.title} is paused.`,
+        };
+    } catch (error: unknown) {
+        return { success: false, msg: safeErrorMessage({ error }) };
+    }
+};