thepopebot 1.2.39 → 1.2.41

package/config/instrumentation.js

@@ -42,5 +42,16 @@ export async function register() {
   const { loadCrons } = await import('../lib/cron.js');
   loadCrons();
 
+  // Start built-in crons (version check)
+  const { startBuiltinCrons, setUpdateAvailable } = await import('../lib/cron.js');
+  startBuiltinCrons();
+
+  // Warm in-memory flag from DB (covers the window before the async cron fetch completes)
+  try {
+    const { getAvailableVersion } = await import('../lib/db/update-check.js');
+    const stored = getAvailableVersion();
+    if (stored) setUpdateAvailable(stored);
+  } catch {}
+
   console.log('thepopebot initialized');
 }

package/lib/chat/actions.js

@@ -159,14 +159,27 @@ export async function markNotificationsRead() {
 // ─────────────────────────────────────────────────────────────────────────────
 
 /**
- * Get the installed package version (auth-gated, never in client bundle).
- * @returns {Promise<string>}
+ * Get the installed package version and update status (auth-gated, never in client bundle).
+ * @returns {Promise<{ version: string, updateAvailable: string|null }>}
  */
 export async function getAppVersion() {
   await requireAuth();
   const { createRequire } = await import('module');
   const require = createRequire(import.meta.url);
-  return require('../../../package.json').version;
+  const version = require('../../../package.json').version;
+  const { getUpdateAvailable } = await import('../cron.js');
+  return { version, updateAvailable: getUpdateAvailable() };
+}
+
+/**
+ * Trigger the upgrade-event-handler workflow via GitHub Actions.
+ * @returns {Promise<{ success: boolean }>}
+ */
+export async function triggerUpgrade() {
+  await requireAuth();
+  const { triggerWorkflowDispatch } = await import('../tools/github.js');
+  await triggerWorkflowDispatch('upgrade-event-handler.yml');
+  return { success: true };
 }
 
 // ─────────────────────────────────────────────────────────────────────────────

package/lib/chat/components/app-sidebar.js

@@ -1,7 +1,7 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useState, useEffect } from "react";
-import { CirclePlusIcon, PanelLeftIcon, MessageIcon, BellIcon, SwarmIcon } from "./icons.js";
+import { CirclePlusIcon, PanelLeftIcon, MessageIcon, BellIcon, SwarmIcon, ArrowUpCircleIcon } from "./icons.js";
 import { getUnreadNotificationCount, getAppVersion } from "../actions.js";
 import { SidebarHistory } from "./sidebar-history.js";
 import { SidebarUserNav } from "./sidebar-user-nav.js";
@@ -25,10 +25,14 @@ function AppSidebar({ user }) {
   const collapsed = state === "collapsed";
   const [unreadCount, setUnreadCount] = useState(0);
   const [version, setVersion] = useState("");
+  const [updateAvailable, setUpdateAvailable] = useState(null);
   useEffect(() => {
     getUnreadNotificationCount().then((count) => setUnreadCount(count)).catch(() => {
     });
-    getAppVersion().then(setVersion).catch(() => {
+    getAppVersion().then(({ version: version2, updateAvailable: updateAvailable2 }) => {
+      setVersion(version2);
+      setUpdateAvailable(updateAvailable2);
+    }).catch(() => {
     });
   }, []);
   return /* @__PURE__ */ jsxs(Sidebar, { children: [
@@ -122,6 +126,34 @@ function AppSidebar({ user }) {
             }
           ) }),
           collapsed && /* @__PURE__ */ jsx(TooltipContent, { side: "right", children: "Notifications" })
+        ] }) }),
+        updateAvailable && /* @__PURE__ */ jsx(SidebarMenuItem, { children: /* @__PURE__ */ jsxs(Tooltip, { children: [
+          /* @__PURE__ */ jsx(TooltipTrigger, { asChild: true, children: /* @__PURE__ */ jsxs(
+            SidebarMenuButton,
+            {
+              className: collapsed ? "justify-center" : "",
+              onClick: () => {
+                window.location.href = "/upgrade";
+              },
+              children: [
+                /* @__PURE__ */ jsxs("span", { className: "relative", children: [
+                  /* @__PURE__ */ jsx(ArrowUpCircleIcon, { size: 16 }),
+                  collapsed && /* @__PURE__ */ jsx("span", { className: "absolute -top-1 -right-1 inline-block h-2 w-2 rounded-full bg-blue-500" })
+                ] }),
+                !collapsed && /* @__PURE__ */ jsxs("span", { className: "flex items-center gap-2", children: [
+                  "Upgrade",
+                  /* @__PURE__ */ jsxs("span", { className: "inline-flex items-center justify-center rounded-full bg-blue-500 px-1.5 py-0.5 text-[10px] font-medium leading-none text-white", children: [
+                    "v",
+                    updateAvailable
+                  ] })
+                ] })
+              ]
+            }
+          ) }),
+          collapsed && /* @__PURE__ */ jsxs(TooltipContent, { side: "right", children: [
+            "Upgrade to v",
+            updateAvailable
+          ] })
         ] }) })
       ] })
     ] }),

package/lib/chat/components/app-sidebar.jsx

@@ -1,7 +1,7 @@
 'use client';
 
 import { useState, useEffect } from 'react';
-import { CirclePlusIcon, PanelLeftIcon, MessageIcon, BellIcon, SwarmIcon } from './icons.js';
+import { CirclePlusIcon, PanelLeftIcon, MessageIcon, BellIcon, SwarmIcon, ArrowUpCircleIcon } from './icons.js';
 import { getUnreadNotificationCount, getAppVersion } from '../actions.js';
 import { SidebarHistory } from './sidebar-history.js';
 import { SidebarUserNav } from './sidebar-user-nav.js';
@@ -26,13 +26,17 @@ export function AppSidebar({ user }) {
   const collapsed = state === 'collapsed';
   const [unreadCount, setUnreadCount] = useState(0);
   const [version, setVersion] = useState('');
+  const [updateAvailable, setUpdateAvailable] = useState(null);
 
   useEffect(() => {
     getUnreadNotificationCount()
       .then((count) => setUnreadCount(count))
       .catch(() => {});
     getAppVersion()
-      .then(setVersion)
+      .then(({ version, updateAvailable }) => {
+        setVersion(version);
+        setUpdateAvailable(updateAvailable);
+      })
       .catch(() => {});
   }, []);
 
@@ -155,6 +159,40 @@ export function AppSidebar({ user }) {
             </Tooltip>
           </SidebarMenuItem>
 
+          {/* Upgrade (only when update is available) */}
+          {updateAvailable && (
+            <SidebarMenuItem>
+              <Tooltip>
+                <TooltipTrigger asChild>
+                  <SidebarMenuButton
+                    className={collapsed ? 'justify-center' : ''}
+                    onClick={() => {
+                      window.location.href = '/upgrade';
+                    }}
+                  >
+                    <span className="relative">
+                      <ArrowUpCircleIcon size={16} />
+                      {collapsed && (
+                        <span className="absolute -top-1 -right-1 inline-block h-2 w-2 rounded-full bg-blue-500" />
+                      )}
+                    </span>
+                    {!collapsed && (
+                      <span className="flex items-center gap-2">
+                        Upgrade
+                        <span className="inline-flex items-center justify-center rounded-full bg-blue-500 px-1.5 py-0.5 text-[10px] font-medium leading-none text-white">
+                          v{updateAvailable}
+                        </span>
+                      </span>
+                    )}
+                  </SidebarMenuButton>
+                </TooltipTrigger>
+                {collapsed && (
+                  <TooltipContent side="right">Upgrade to v{updateAvailable}</TooltipContent>
+                )}
+              </Tooltip>
+            </SidebarMenuItem>
+          )}
+
         </SidebarMenu>
       </SidebarHeader>
 

package/lib/chat/components/icons.js

@@ -561,6 +561,27 @@ function CirclePlusIcon({ size = 16 }) {
     }
   );
 }
+function ArrowUpCircleIcon({ size = 16 }) {
+  return /* @__PURE__ */ jsxs(
+    "svg",
+    {
+      xmlns: "http://www.w3.org/2000/svg",
+      viewBox: "0 0 24 24",
+      fill: "none",
+      stroke: "currentColor",
+      strokeWidth: 2,
+      strokeLinecap: "round",
+      strokeLinejoin: "round",
+      width: size,
+      height: size,
+      children: [
+        /* @__PURE__ */ jsx("circle", { cx: "12", cy: "12", r: "10" }),
+        /* @__PURE__ */ jsx("path", { d: "m16 12-4-4-4 4" }),
+        /* @__PURE__ */ jsx("path", { d: "M12 16V8" })
+      ]
+    }
+  );
+}
 function LogOutIcon({ size = 16 }) {
   return /* @__PURE__ */ jsxs(
     "svg",
@@ -583,6 +604,7 @@ function LogOutIcon({ size = 16 }) {
   );
 }
 export {
+  ArrowUpCircleIcon,
   BellIcon,
   CheckIcon,
   ChevronDownIcon,

package/lib/chat/components/icons.jsx

@@ -555,6 +555,26 @@ export function CirclePlusIcon({ size = 16 }) {
   );
 }
 
+export function ArrowUpCircleIcon({ size = 16 }) {
+  return (
+    <svg
+      xmlns="http://www.w3.org/2000/svg"
+      viewBox="0 0 24 24"
+      fill="none"
+      stroke="currentColor"
+      strokeWidth={2}
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      width={size}
+      height={size}
+    >
+      <circle cx="12" cy="12" r="10" />
+      <path d="m16 12-4-4-4 4" />
+      <path d="M12 16V8" />
+    </svg>
+  );
+}
+
 export function LogOutIcon({ size = 16 }) {
   return (
     <svg

package/lib/chat/components/index.js

@@ -2,6 +2,7 @@ export { ChatPage } from './chat-page.js';
 export { ChatsPage } from './chats-page.js';
 export { NotificationsPage } from './notifications-page.js';
 export { SwarmPage } from './swarm-page.js';
+export { UpgradePage } from './upgrade-page.js';
 export { CronsPage } from './crons-page.js';
 export { TriggersPage } from './triggers-page.js';
 export { PageLayout } from './page-layout.js';

package/lib/chat/components/upgrade-page.js

@@ -0,0 +1,109 @@
+"use client";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useState, useEffect } from "react";
+import { PageLayout } from "./page-layout.js";
+import { ArrowUpCircleIcon, SpinnerIcon, CheckIcon } from "./icons.js";
+import { getAppVersion, triggerUpgrade } from "../actions.js";
+function UpgradePage({ session }) {
+  const [version, setVersion] = useState("");
+  const [updateAvailable, setUpdateAvailable] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [upgrading, setUpgrading] = useState(false);
+  const [result, setResult] = useState(null);
+  useEffect(() => {
+    getAppVersion().then(({ version: version2, updateAvailable: updateAvailable2 }) => {
+      setVersion(version2);
+      setUpdateAvailable(updateAvailable2);
+    }).catch(() => {
+    }).finally(() => setLoading(false));
+  }, []);
+  const handleUpgrade = async () => {
+    setUpgrading(true);
+    setResult(null);
+    try {
+      await triggerUpgrade();
+      setResult("success");
+    } catch {
+      setResult("error");
+    } finally {
+      setUpgrading(false);
+    }
+  };
+  return /* @__PURE__ */ jsxs(PageLayout, { session, children: [
+    /* @__PURE__ */ jsx("div", { className: "flex items-center justify-between mb-6", children: /* @__PURE__ */ jsx("h1", { className: "text-2xl font-semibold", children: "Upgrade" }) }),
+    loading ? /* @__PURE__ */ jsx("div", { className: "flex flex-col gap-4", children: /* @__PURE__ */ jsx("div", { className: "h-32 animate-pulse rounded-md bg-border/50" }) }) : /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-6 max-w-lg", children: [
+      /* @__PURE__ */ jsxs("div", { className: "rounded-md border bg-card p-6", children: [
+        /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3 mb-4", children: [
+          /* @__PURE__ */ jsx(ArrowUpCircleIcon, { size: 24 }),
+          /* @__PURE__ */ jsxs("div", { children: [
+            /* @__PURE__ */ jsx("p", { className: "text-sm text-muted-foreground", children: "Installed version" }),
+            /* @__PURE__ */ jsxs("p", { className: "text-lg font-mono font-semibold", children: [
+              "v",
+              version
+            ] })
+          ] })
+        ] }),
+        updateAvailable ? /* @__PURE__ */ jsx("div", { className: "rounded-md border border-blue-500/30 bg-blue-500/5 p-4 mb-4", children: /* @__PURE__ */ jsxs("p", { className: "text-sm font-medium", children: [
+          "Version ",
+          /* @__PURE__ */ jsxs("span", { className: "font-mono text-blue-500", children: [
+            "v",
+            updateAvailable
+          ] }),
+          " is available"
+        ] }) }) : /* @__PURE__ */ jsx("div", { className: "rounded-md border border-green-500/30 bg-green-500/5 p-4 mb-4", children: /* @__PURE__ */ jsx("p", { className: "text-sm font-medium text-green-600 dark:text-green-400", children: "You are on the latest version" }) }),
+        updateAvailable && /* @__PURE__ */ jsx(
+          "button",
+          {
+            onClick: handleUpgrade,
+            disabled: upgrading || result === "success",
+            className: "w-full inline-flex items-center justify-center gap-2 rounded-md px-4 py-2.5 text-sm font-medium bg-blue-500 text-white hover:bg-blue-600 disabled:opacity-50 disabled:pointer-events-none",
+            children: upgrading ? /* @__PURE__ */ jsxs(Fragment, { children: [
+              /* @__PURE__ */ jsx(SpinnerIcon, { size: 16 }),
+              "Triggering upgrade..."
+            ] }) : result === "success" ? /* @__PURE__ */ jsxs(Fragment, { children: [
+              /* @__PURE__ */ jsx(CheckIcon, { size: 16 }),
+              "Upgrade triggered"
+            ] }) : /* @__PURE__ */ jsxs(Fragment, { children: [
+              /* @__PURE__ */ jsx(ArrowUpCircleIcon, { size: 16 }),
+              "Upgrade to v",
+              updateAvailable
+            ] })
+          }
+        ),
+        result === "success" && /* @__PURE__ */ jsx("p", { className: "text-xs text-muted-foreground mt-3", children: "The upgrade workflow has been triggered. The server will update, rebuild, and reload automatically. This page will reflect the new version once the process completes." }),
+        result === "error" && /* @__PURE__ */ jsx("p", { className: "text-xs text-red-500 mt-3", children: "Failed to trigger the upgrade workflow. Check that your GitHub token has workflow permissions." })
+      ] }),
+      updateAvailable && /* @__PURE__ */ jsxs("div", { className: "rounded-md border bg-card p-6", children: [
+        /* @__PURE__ */ jsx("h2", { className: "text-sm font-medium mb-3", children: "What happens during an upgrade" }),
+        /* @__PURE__ */ jsxs("ul", { className: "text-sm text-muted-foreground space-y-2", children: [
+          /* @__PURE__ */ jsxs("li", { className: "flex gap-2", children: [
+            /* @__PURE__ */ jsx("span", { className: "text-muted-foreground/60", children: "1." }),
+            /* @__PURE__ */ jsxs("span", { children: [
+              "The ",
+              /* @__PURE__ */ jsx("code", { className: "text-xs bg-muted px-1 py-0.5 rounded", children: "upgrade-event-handler" }),
+              " GitHub Actions workflow is triggered"
+            ] })
+          ] }),
+          /* @__PURE__ */ jsxs("li", { className: "flex gap-2", children: [
+            /* @__PURE__ */ jsx("span", { className: "text-muted-foreground/60", children: "2." }),
+            /* @__PURE__ */ jsxs("span", { children: [
+              "The package is updated via ",
+              /* @__PURE__ */ jsx("code", { className: "text-xs bg-muted px-1 py-0.5 rounded", children: "npm update thepopebot" })
+            ] })
+          ] }),
+          /* @__PURE__ */ jsxs("li", { className: "flex gap-2", children: [
+            /* @__PURE__ */ jsx("span", { className: "text-muted-foreground/60", children: "3." }),
+            /* @__PURE__ */ jsx("span", { children: "A new build is created alongside the current one" })
+          ] }),
+          /* @__PURE__ */ jsxs("li", { className: "flex gap-2", children: [
+            /* @__PURE__ */ jsx("span", { className: "text-muted-foreground/60", children: "4." }),
+            /* @__PURE__ */ jsx("span", { children: "The builds are atomically swapped and the server reloads" })
+          ] })
+        ] })
+      ] })
+    ] })
+  ] });
+}
+export {
+  UpgradePage
+};

package/lib/chat/components/upgrade-page.jsx

@@ -0,0 +1,141 @@
+'use client';
+
+import { useState, useEffect } from 'react';
+import { PageLayout } from './page-layout.js';
+import { ArrowUpCircleIcon, SpinnerIcon, CheckIcon } from './icons.js';
+import { getAppVersion, triggerUpgrade } from '../actions.js';
+
+export function UpgradePage({ session }) {
+  const [version, setVersion] = useState('');
+  const [updateAvailable, setUpdateAvailable] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [upgrading, setUpgrading] = useState(false);
+  const [result, setResult] = useState(null); // 'success' | 'error'
+
+  useEffect(() => {
+    getAppVersion()
+      .then(({ version, updateAvailable }) => {
+        setVersion(version);
+        setUpdateAvailable(updateAvailable);
+      })
+      .catch(() => {})
+      .finally(() => setLoading(false));
+  }, []);
+
+  const handleUpgrade = async () => {
+    setUpgrading(true);
+    setResult(null);
+    try {
+      await triggerUpgrade();
+      setResult('success');
+    } catch {
+      setResult('error');
+    } finally {
+      setUpgrading(false);
+    }
+  };
+
+  return (
+    <PageLayout session={session}>
+      <div className="flex items-center justify-between mb-6">
+        <h1 className="text-2xl font-semibold">Upgrade</h1>
+      </div>
+
+      {loading ? (
+        <div className="flex flex-col gap-4">
+          <div className="h-32 animate-pulse rounded-md bg-border/50" />
+        </div>
+      ) : (
+        <div className="flex flex-col gap-6 max-w-lg">
+          {/* Version info card */}
+          <div className="rounded-md border bg-card p-6">
+            <div className="flex items-center gap-3 mb-4">
+              <ArrowUpCircleIcon size={24} />
+              <div>
+                <p className="text-sm text-muted-foreground">Installed version</p>
+                <p className="text-lg font-mono font-semibold">v{version}</p>
+              </div>
+            </div>
+
+            {updateAvailable ? (
+              <div className="rounded-md border border-blue-500/30 bg-blue-500/5 p-4 mb-4">
+                <p className="text-sm font-medium">
+                  Version <span className="font-mono text-blue-500">v{updateAvailable}</span> is available
+                </p>
+              </div>
+            ) : (
+              <div className="rounded-md border border-green-500/30 bg-green-500/5 p-4 mb-4">
+                <p className="text-sm font-medium text-green-600 dark:text-green-400">
+                  You are on the latest version
+                </p>
+              </div>
+            )}
+
+            {/* Upgrade button */}
+            {updateAvailable && (
+              <button
+                onClick={handleUpgrade}
+                disabled={upgrading || result === 'success'}
+                className="w-full inline-flex items-center justify-center gap-2 rounded-md px-4 py-2.5 text-sm font-medium bg-blue-500 text-white hover:bg-blue-600 disabled:opacity-50 disabled:pointer-events-none"
+              >
+                {upgrading ? (
+                  <>
+                    <SpinnerIcon size={16} />
+                    Triggering upgrade...
+                  </>
+                ) : result === 'success' ? (
+                  <>
+                    <CheckIcon size={16} />
+                    Upgrade triggered
+                  </>
+                ) : (
+                  <>
+                    <ArrowUpCircleIcon size={16} />
+                    Upgrade to v{updateAvailable}
+                  </>
+                )}
+              </button>
+            )}
+
+            {/* Feedback */}
+            {result === 'success' && (
+              <p className="text-xs text-muted-foreground mt-3">
+                The upgrade workflow has been triggered. The server will update, rebuild, and reload automatically. This page will reflect the new version once the process completes.
+              </p>
+            )}
+            {result === 'error' && (
+              <p className="text-xs text-red-500 mt-3">
+                Failed to trigger the upgrade workflow. Check that your GitHub token has workflow permissions.
+              </p>
+            )}
+          </div>
+
+          {/* What happens during upgrade */}
+          {updateAvailable && (
+            <div className="rounded-md border bg-card p-6">
+              <h2 className="text-sm font-medium mb-3">What happens during an upgrade</h2>
+              <ul className="text-sm text-muted-foreground space-y-2">
+                <li className="flex gap-2">
+                  <span className="text-muted-foreground/60">1.</span>
+                  <span>The <code className="text-xs bg-muted px-1 py-0.5 rounded">upgrade-event-handler</code> GitHub Actions workflow is triggered</span>
+                </li>
+                <li className="flex gap-2">
+                  <span className="text-muted-foreground/60">2.</span>
+                  <span>The package is updated via <code className="text-xs bg-muted px-1 py-0.5 rounded">npm update thepopebot</code></span>
+                </li>
+                <li className="flex gap-2">
+                  <span className="text-muted-foreground/60">3.</span>
+                  <span>A new build is created alongside the current one</span>
+                </li>
+                <li className="flex gap-2">
+                  <span className="text-muted-foreground/60">4.</span>
+                  <span>The builds are atomically swapped and the server reloads</span>
+                </li>
+              </ul>
+            </div>
+          )}
+        </div>
+      )}
+    </PageLayout>
+  );
+}

package/lib/cron.js

@@ -1,8 +1,95 @@
 import cron from 'node-cron';
 import fs from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
 import { cronsFile, cronDir } from './paths.js';
 import { executeAction } from './actions.js';
 
+// Read installed version once at module load (doesn't change while server runs)
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const _installedVersion = JSON.parse(
+  fs.readFileSync(join(__dirname, '..', 'package.json'), 'utf8')
+).version;
+
+// In-memory flag for available update (read by sidebar, written by cron)
+let _updateAvailable = null;
+
+/**
+ * Get the in-memory update-available version (or null).
+ * @returns {string|null}
+ */
+function getUpdateAvailable() {
+  return _updateAvailable;
+}
+
+/**
+ * Set the in-memory update-available version.
+ * @param {string|null} v
+ */
+function setUpdateAvailable(v) {
+  _updateAvailable = v;
+}
+
+/**
+ * Compare two semver strings numerically.
+ * @param {string} candidate - e.g. "1.2.40"
+ * @param {string} baseline  - e.g. "1.2.39"
+ * @returns {boolean} true if candidate > baseline
+ */
+function isVersionNewer(candidate, baseline) {
+  const a = candidate.split('.').map(Number);
+  const b = baseline.split('.').map(Number);
+  for (let i = 0; i < Math.max(a.length, b.length); i++) {
+    const av = a[i] || 0;
+    const bv = b[i] || 0;
+    if (av > bv) return true;
+    if (av < bv) return false;
+  }
+  return false;
+}
+
+/**
+ * Check npm registry for a newer version of thepopebot.
+ */
+async function runVersionCheck() {
+  try {
+    const res = await fetch('https://registry.npmjs.org/thepopebot/latest');
+    if (!res.ok) {
+      console.warn(`[version check] npm registry returned ${res.status}`);
+      return;
+    }
+    const data = await res.json();
+    const latest = data.version;
+
+    if (isVersionNewer(latest, _installedVersion)) {
+      console.log(`[version check] update available: ${_installedVersion} → ${latest}`);
+      setUpdateAvailable(latest);
+      // Persist to DB
+      const { setAvailableVersion } = await import('./db/update-check.js');
+      setAvailableVersion(latest);
+    } else {
+      setUpdateAvailable(null);
+      // Clear DB
+      const { clearAvailableVersion } = await import('./db/update-check.js');
+      clearAvailableVersion();
+    }
+  } catch (err) {
+    console.warn(`[version check] failed: ${err.message}`);
+    // Leave existing flag untouched on error
+  }
+}
+
+/**
+ * Start built-in crons (version check). Called from instrumentation.
+ */
+function startBuiltinCrons() {
+  // Schedule daily at midnight
+  cron.schedule('0 0 * * *', runVersionCheck);
+  // Run once immediately
+  runVersionCheck();
+}
+
 /**
  * Load and schedule crons from CRONS.json
  * @returns {Array} - Array of scheduled cron tasks
@@ -56,4 +143,4 @@ function loadCrons() {
   return tasks;
 }
 
-export { loadCrons };
+export { loadCrons, startBuiltinCrons, getUpdateAvailable, setUpdateAvailable };

package/lib/db/update-check.js

@@ -0,0 +1,50 @@
+import { randomUUID } from 'crypto';
+import { eq, and } from 'drizzle-orm';
+import { getDb } from './index.js';
+import { settings } from './schema.js';
+
+/**
+ * Get the stored available version from the DB.
+ * @returns {string|null}
+ */
+export function getAvailableVersion() {
+  const db = getDb();
+  const row = db
+    .select()
+    .from(settings)
+    .where(and(eq(settings.type, 'update'), eq(settings.key, 'available_version')))
+    .get();
+
+  return row ? row.value : null;
+}
+
+/**
+ * Set the available version in the DB (delete + insert upsert).
+ * @param {string} version
+ */
+export function setAvailableVersion(version) {
+  const db = getDb();
+  db.delete(settings)
+    .where(and(eq(settings.type, 'update'), eq(settings.key, 'available_version')))
+    .run();
+
+  const now = Date.now();
+  db.insert(settings).values({
+    id: randomUUID(),
+    type: 'update',
+    key: 'available_version',
+    value: version,
+    createdAt: now,
+    updatedAt: now,
+  }).run();
+}
+
+/**
+ * Clear the available version from the DB.
+ */
+export function clearAvailableVersion() {
+  const db = getDb();
+  db.delete(settings)
+    .where(and(eq(settings.type, 'update'), eq(settings.key, 'available_version')))
+    .run();
+}

package/lib/tools/github.js

@@ -255,6 +255,34 @@ async function rerunWorkflowRun(runId, failedOnly = false) {
   return { success: true };
 }
 
+/**
+ * Trigger a workflow via workflow_dispatch
+ * @param {string} workflowId - Workflow file name (e.g., 'upgrade-event-handler.yml')
+ * @param {string} [ref='main'] - Git ref to run the workflow on
+ * @param {object} [inputs={}] - Workflow inputs
+ */
+async function triggerWorkflowDispatch(workflowId, ref = 'main', inputs = {}) {
+  const { GH_OWNER, GH_REPO } = process.env;
+  const res = await fetch(
+    `https://api.github.com/repos/${GH_OWNER}/${GH_REPO}/actions/workflows/${workflowId}/dispatches`,
+    {
+      method: 'POST',
+      headers: {
+        'Authorization': `Bearer ${process.env.GH_TOKEN}`,
+        'Accept': 'application/vnd.github+json',
+        'X-GitHub-Api-Version': '2022-11-28',
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify({ ref, inputs }),
+    }
+  );
+  if (!res.ok && res.status !== 204) {
+    const error = await res.text();
+    throw new Error(`GitHub API error: ${res.status} ${error}`);
+  }
+  return { success: true };
+}
+
 export {
   githubApi,
   getWorkflowRuns,
@@ -263,4 +291,5 @@ export {
   getSwarmStatus,
   cancelWorkflowRun,
   rerunWorkflowRun,
+  triggerWorkflowDispatch,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thepopebot",
-  "version": "1.2.39",
+  "version": "1.2.41",
   "type": "module",
   "description": "Create autonomous AI agents with a two-layer architecture: Next.js Event Handler + Docker Agent.",
   "bin": {

package/templates/.github/workflows/upgrade-event-handler.yml

@@ -0,0 +1,39 @@
+name: Upgrade Event Handler
+
+on:
+  workflow_dispatch:
+
+concurrency:
+  group: deploy
+  cancel-in-progress: true
+
+jobs:
+  upgrade:
+    runs-on: self-hosted
+    steps:
+      - name: Upgrade thepopebot
+        run: |
+          docker exec thepopebot-event-handler bash -c '
+            export GH_TOKEN=$(grep "^GH_TOKEN=" /app/.env | cut -d= -f2-)
+            echo "${GH_TOKEN}" | gh auth login --with-token
+            gh auth setup-git
+
+            git fetch origin main
+            git reset --hard origin/main
+
+            # Update thepopebot package
+            npm update thepopebot
+            npm install --omit=dev
+
+            # Atomic swap build (same pattern as rebuild-event-handler)
+            rm -rf .next-new .next-old
+            NEXT_BUILD_DIR=.next-new npm run build
+
+            mv .next .next-old 2>/dev/null || true
+            mv .next-new .next
+
+            echo "Upgrade complete, reloading..."
+            npx pm2 reload all
+
+            rm -rf .next-old
+          '

package/templates/app/upgrade/page.js

@@ -0,0 +1,7 @@
+import { auth } from 'thepopebot/auth';
+import { UpgradePage } from 'thepopebot/chat';
+
+export default async function UpgradeRoute() {
+  const session = await auth();
+  return <UpgradePage session={session} />;
+}