loopengine 0.1.81 → 0.1.82

package/README.md

@@ -178,9 +178,9 @@ webhook, Slack or Lark target for one agent (saved to
 an older `notifier.yml` is still read), sends a test and shows recent
 deliveries. With Slack, people can also reply in a request's thread to
 ask the agent about it, and it answers there (**Answer replies in a
-request's thread**, on by default). The Permissions tab lists every
-decision still waiting with Approve/Deny buttons, and warns you when an
-agent has `ask` rules but nobody would be told.
+request's thread**, on by default). The same tab lists every decision
+still waiting with Approve/Deny buttons (its count shows on the tab), and
+warns you when an agent has `ask` rules but nobody would be told.
 
 Every notification links to a **decision page**: a signed, single-use
 link (`/decide/<token>`, valid 7 days) where whoever got the message can

package/dist/web/agents-config-page.js

@@ -615,10 +615,49 @@ ${consoleShellScript}
       card('skills', 'Skills', String(cfg.skills.length), escapeHtml(cfg.skills.map(function (k) { return k.name; }).join(', ')) || 'None yet') +
       card('actauth', 'Permissions', rules.length + (rules.length === 1 ? ' rule' : ' rules'),
         (asks ? asks + ' need approval \u00b7 ' : '') + 'unmatched calls: ' + escapeHtml(cfg.permissions.defaultDecision)) +
+      card('messaging', 'Messaging', '<span id="ovMessagingValue">&hellip;</span>', '<span id="ovMessagingDetail">Loading&hellip;</span>') +
+      card('schedules', 'Schedules', '<span id="ovSchedulesValue">&hellip;</span>', '<span id="ovSchedulesDetail">Loading&hellip;</span>') +
       card('env', 'Environment', 'Settings', '<span data-le-env-count="' + escapeHtml(cfg.name) + '">' + leShell.envCountHtml(cfg.name) + '</span> Values your installed abilities read') +
     '</div>';
   }
 
+  var APP_NAMES = { slack: 'Slack', lark: 'Lark', webhook: 'Webhook', email: 'Email', database: 'Database', redis: 'Redis' };
+
+  // Messaging and Schedules come from their own endpoints, so their
+  // cards are filled in once those answer. Called after every render of
+  // Overview, which is also re-rendered after edits.
+  function fillOverviewCards(name) {
+    Promise.all([
+      fetchJsonRetryOnce('/agents/' + encodeURIComponent(name) + '/notifier'),
+      fetchJsonRetryOnce('/agents/' + encodeURIComponent(name) + '/pending'),
+      fetchJsonRetryOnce('/agents/' + encodeURIComponent(name) + '/schedules'),
+    ]).then(function (results) {
+      if (currentName !== name) return;
+      var set = function (id, html) { var el = detail.querySelector('#' + id); if (el) el.innerHTML = html; };
+      var n = results[0].ok ? results[0].body : null;
+      var pending = (results[1].ok && results[1].body.pending) || [];
+      var connected = n && (n.source === 'file' || n.source === 'code' || n.source === 'default');
+      set('ovMessagingValue', !n ? '&mdash;' : connected ? escapeHtml(APP_NAMES[n.channel] || n.channel) + (n.source === 'default' ? ' (default)' : '') : 'Not connected');
+      var messagingDetail = [];
+      if (pending.length) messagingDetail.push(pending.length + ' waiting for a decision');
+      if (n && connected && n.channel === 'slack' && n.plan !== 'free' && (!n.file || n.file.conversations !== false)) messagingDetail.push('answers replies in threads');
+      if (n && !connected) messagingDetail.push(n.missingSecret ? 'Saved, but its secret isn' + String.fromCharCode(8217) + 't set' : 'Send approvals and questions to Slack, Lark or a webhook');
+      if (!messagingDetail.length && n) messagingDetail.push('Sends ' + escapeHtml((n.events || []).join(', ')));
+      set('ovMessagingDetail', messagingDetail.join(' \u00b7 '));
+      showPendingCount(pending.length);
+
+      var tasks = (results[2].ok && results[2].body.tasks) || [];
+      var active = tasks.filter(function (t) { return t.status !== 'cancelled' && t.status !== 'done'; });
+      var waiting = active.filter(function (t) { return t.status === 'awaiting_approval'; }).length;
+      var next = active.map(function (t) { return t.next_run_at; }).filter(Boolean).sort()[0];
+      set('ovSchedulesValue', String(active.length));
+      var schedulesDetail = [];
+      if (waiting) schedulesDetail.push(waiting + ' waiting for approval');
+      if (next) schedulesDetail.push('Next run ' + escapeHtml(new Date(next).toLocaleString()));
+      set('ovSchedulesDetail', schedulesDetail.join(' \u00b7 ') || (active.length ? 'None due' : 'Run this agent on a timer'));
+    });
+  }
+
   function renderOverviewHtml(cfg) {
     var systemPromptSection =
       '<h3>System prompt <button type="button" class="edit-btn" id="editSystemPromptBtn">Edit</button></h3>' +
@@ -754,6 +793,7 @@ ${consoleShellScript}
             if (!result.ok) throw new Error(result.body.error || 'request failed');
             currentCfg = result.body;
             overviewPanel.innerHTML = renderOverviewHtml(result.body);
+            fillOverviewCards(currentName);
             wireOverviewHandlers(name);
           })
           .catch(function (err) {
@@ -802,6 +842,7 @@ ${consoleShellScript}
             if (!result.ok) throw new Error(result.body.error || 'request failed');
             currentCfg = result.body;
             overviewPanel.innerHTML = renderOverviewHtml(result.body);
+            fillOverviewCards(currentName);
             wireOverviewHandlers(name);
           })
           .catch(function (err) {
@@ -849,6 +890,7 @@ ${consoleShellScript}
             if (!result.ok) throw new Error(result.body.error || 'request failed');
             currentCfg = result.body;
             overviewPanel.innerHTML = renderOverviewHtml(result.body);
+            fillOverviewCards(currentName);
             wireOverviewHandlers(name);
           })
           .catch(function (err) {
@@ -897,14 +939,40 @@ ${consoleShellScript}
   // opened. ----
 
   function renderActauthTabPlaceholder() {
-    return '<div id="pendingContent"></div>' +
+    return '<div id="pendingNote"></div>' +
       '<section id="actauthSection"><div id="actauthContent"><p class="hint">Loading&hellip;</p></div></section>';
   }
 
-  // The Messaging tab: where approval requests and questions go, and
-  // whether the agent answers replies there. Filled by loadApprovalsSection.
+  // The Messaging tab: the decisions still waiting, where approval
+  // requests and questions go, and whether the agent answers replies
+  // there. Filled by loadApprovalsSection.
   function renderMessagingTabPlaceholder() {
-    return '<div id="approvalsContent"><p class="hint">Loading&hellip;</p></div>';
+    return '<div id="pendingContent"></div>' +
+      '<div id="approvalsContent"><p class="hint">Loading&hellip;</p></div>';
+  }
+
+  // How many decisions are waiting: a badge on the Messaging tab, seen
+  // from every tab, and a line at the top of Permissions.
+  function showPendingCount(n) {
+    leShell.setCount('messaging', n);
+    var link = detail.querySelector('.le-tab[data-tab="messaging"]');
+    var badge = link && link.querySelector('.le-count');
+    if (badge) {
+      badge.className = 'le-count warn';
+      if (!n) badge.remove();
+    }
+    var note = detail.querySelector('#pendingNote');
+    if (note) {
+      note.innerHTML = n
+        ? '<div class="approvals-nudge">' + (n === 1 ? '1 request is' : n + ' requests are') + ' waiting for a decision. <a href="?tab=messaging" data-tab="messaging">See Messaging</a></div>'
+        : '';
+    }
+  }
+
+  function refreshPendingCount(name) {
+    fetchJsonRetryOnce('/agents/' + encodeURIComponent(name) + '/pending').then(function (r) {
+      if (currentName === name && r.ok) showPendingCount((r.body.pending || []).length);
+    });
   }
 
   function renderActauthRuleRow(r) {
@@ -968,12 +1036,11 @@ ${consoleShellScript}
         '</form></section>';
   }
 
-  // ---- Messaging tab: where "ask" decisions go when nobody is in Chat,
-  // and whether the agent answers replies there (web/notifier-admin.ts
-  // behind GET/PUT/DELETE .../notifier), plus recent deliveries. The
-  // decisions still waiting (GET .../pending) show at the top of
-  // Permissions. Reloaded every time either tab opens, so the waiting
-  // list is current. ----
+  // ---- Messaging tab: the decisions still waiting (GET .../pending),
+  // where "ask" decisions go when nobody is in Chat, and whether the
+  // agent answers replies there (web/notifier-admin.ts behind
+  // GET/PUT/DELETE .../notifier), plus recent deliveries. Reloaded every
+  // time the tab opens, so the waiting list is current. ----
 
   var lastNotifier = null;
   var NOTIFIER_EVENTS = [
@@ -1111,7 +1178,7 @@ ${consoleShellScript}
     if (tools.length && n && n.source === 'none') {
       html += '<div class="approvals-nudge"><strong>Approval requests aren&#39;t sent anywhere yet.</strong> ' +
         escapeHtml(tools.slice(0, 3).join(', ')) + (tools.length > 3 ? ' and more' : '') + ' can stop for approval, but when an app calls this agent over HTTP nobody is notified. ' +
-        '<a href="?tab=messaging" data-tab="messaging">Choose where they go</a></div>';
+        'Choose where they go below.</div>';
     }
     if (pending.length) html += '<section><h3>Waiting for a decision (' + pending.length + ')</h3>' + renderPendingTable(pending) + '</section>';
     return html;
@@ -1289,10 +1356,12 @@ ${consoleShellScript}
       content.innerHTML = renderApprovalsHtml(results[0].body);
       wireApprovalsHandlers(name);
       var pendingEl = detail.querySelector('#pendingContent');
+      var pending = (results[1].ok && results[1].body.pending) || [];
       if (pendingEl) {
-        pendingEl.innerHTML = renderPendingHtml((results[1].ok && results[1].body.pending) || [], results[0].body);
+        pendingEl.innerHTML = renderPendingHtml(pending, results[0].body);
         wirePendingHandlers(name);
       }
+      showPendingCount(pending.length);
       if (message) { var r = content.querySelector('#notifierResult'); if (r) r.textContent = message; }
     }).catch(function (err) {
       if (currentName !== name) return;
@@ -1347,7 +1416,7 @@ ${consoleShellScript}
         '<div class="schedule-result hint">' + escapeHtml(t.message) + '</div></td>' +
       '<td>' + scheduleText(t.schedule) + (t.next_run_at ? '<div class="hint">next ' + escapeHtml(new Date(t.next_run_at).toLocaleString()) + '</div>' : '') + '</td>' +
       '<td><span class="le-pill ' + (SCHEDULE_PILLS[t.status] || 'neutral') + '">' + escapeHtml(SCHEDULE_LABELS[t.status] || t.status) + '</span>' +
-        (t.status === 'awaiting_approval' ? '<div class="hint"><a href="#" class="schedule-to-approvals">Decide in Permissions</a></div>' : '') + '</td>' +
+        (t.status === 'awaiting_approval' ? '<div class="hint"><a href="#" class="schedule-to-approvals">Decide in Messaging</a></div>' : '') + '</td>' +
       '<td style="min-width:200px">' + last + (history ? '<details><summary class="hint">History (' + (t.history || []).length + ')</summary><ul class="schedule-history">' + history + '</ul></details>' : '') + '</td>' +
       '<td><div style="display:flex;gap:6px;flex-wrap:wrap">' + actions.map(function (a) {
         return '<button type="button" class="schedule-action' + (a[0] === 'run' ? ' primary' : '') + (a[0] === 'cancel' || a[0] === 'delete' ? ' delete-btn' : '') + '" data-id="' + escapeHtml(t.task_id) + '" data-action="' + a[0] + '">' + a[1] + '</button>';
@@ -1400,7 +1469,7 @@ ${consoleShellScript}
     }
     var toApprovals = content.querySelectorAll('.schedule-to-approvals');
     for (var j = 0; j < toApprovals.length; j++) {
-      toApprovals[j].addEventListener('click', function (ev) { ev.preventDefault(); switchTab('actauth'); });
+      toApprovals[j].addEventListener('click', function (ev) { ev.preventDefault(); switchTab('messaging'); });
     }
     var form = content.querySelector('#scheduleForm');
     var result = content.querySelector('#scheduleResult');
@@ -2940,7 +3009,8 @@ ${consoleShellScript}
     if (tab === 'actauth' && actauthLoadedFor !== currentName) {
       loadActauthTab(currentName);
     }
-    if (tab === 'actauth' || tab === 'messaging') loadApprovalsSection(currentName);
+    if (tab === 'messaging') loadApprovalsSection(currentName);
+    if (tab === 'actauth') refreshPendingCount(currentName);
     if (tab === 'env' && envLoadedFor !== currentName) {
       loadEnvTab(currentName);
     }
@@ -2969,6 +3039,7 @@ ${consoleShellScript}
         var overviewPanel = detail.querySelector('[data-tab-panel="overview"]');
         if (overviewPanel) {
           overviewPanel.innerHTML = renderOverviewHtml(cfg);
+          fillOverviewCards(currentName);
           wireOverviewHandlers(name);
         }
       })
@@ -3012,6 +3083,7 @@ ${consoleShellScript}
         var skillsPanel = skillsPanelEl();
         if (overviewPanel) {
           overviewPanel.innerHTML = renderOverviewHtml(cfg);
+          fillOverviewCards(currentName);
           wireOverviewHandlers(name);
         }
         if (skillsPanel) {
@@ -3059,6 +3131,7 @@ ${consoleShellScript}
     empty.style.display = 'none';
     detail.style.display = 'flex';
     switchTab(currentTab);
+    fillOverviewCards(cfg.name);
   }
 
   function selectAgent(name) {

package/dist/web/console-shell.js

@@ -43,7 +43,7 @@ export const consoleShellScript = `<script>
   // after the list loads.
   var toSet = {};
   var TABS = [
-    ['chat', 'Chat'], ['overview', 'Overview'], ['abilities', 'Abilities'], ['tools', 'Tools'],
+    ['overview', 'Overview'], ['chat', 'Chat'], ['abilities', 'Abilities'], ['tools', 'Tools'],
     ['skills', 'Skills'], ['actauth', 'Permissions'], ['messaging', 'Messaging'], ['schedules', 'Schedules'], ['env', 'Environment']
   ];
 

package/dist/web/decide-page.js

@@ -53,7 +53,7 @@ ${script}
 }
 /** A link that's malformed, tampered with, or past its expiry. */
 export function renderDecideInvalidPage() {
-    return shell('Link not valid', '<h1>This link isn&#39;t valid</h1><p class="muted">It may have expired or been copied incompletely. Ask for a new one, or decide from the agent&#39;s Permissions tab.</p>');
+    return shell('Link not valid', '<h1>This link isn&#39;t valid</h1><p class="muted">It may have expired or been copied incompletely. Ask for a new one, or decide from the agent&#39;s Messaging tab.</p>');
 }
 /** A valid link whose decision has already been made. */
 export function renderDecideGonePage() {

package/dist/web/global-config-page.js

@@ -314,13 +314,19 @@ ${consoleShellScript}
 
   function upgradeBox() { return document.getElementById('upgradeBox'); }
 
+  // When npm was last asked, and a link to ask again now.
+  function upgradeCheckedLine(u) {
+    var when = u.checkedAt ? 'Checked at ' + escapeHtml(new Date(u.checkedAt).toLocaleTimeString()) + '. ' : '';
+    return '<p class="hint" style="margin:6px 0 0">' + when + '<a href="#" id="upgradeRecheck">Check again</a></p>';
+  }
+
   function renderUpgrade(u) {
     var box = upgradeBox();
     if (!box) return;
     if (u.unavailableReason && !u.updateAvailable) {
-      box.innerHTML = '<p class="hint">' + escapeHtml(u.unavailableReason) + '</p>';
+      box.innerHTML = '<p class="hint">' + escapeHtml(u.unavailableReason) + '</p>' + (u.templateVersion ? upgradeCheckedLine(u) : '');
     } else if (!u.updateAvailable) {
-      box.innerHTML = '<p>You' + String.fromCharCode(8217) + 're on the latest version, <code>' + escapeHtml(u.current) + '</code>.</p>';
+      box.innerHTML = '<p>You' + String.fromCharCode(8217) + 're on the latest version, <code>' + escapeHtml(u.current) + '</code>.</p>' + upgradeCheckedLine(u);
     } else if (u.unavailableReason) {
       box.innerHTML = '<p>LoopEngine <code>' + escapeHtml(u.latest) + '</code> is available (this server runs <code>' + escapeHtml(u.current) + '</code>).</p><p class="hint">' + escapeHtml(u.unavailableReason) + '</p>';
     } else if (!u.canUpgrade) {
@@ -333,8 +339,8 @@ ${consoleShellScript}
     }
   }
 
-  function loadUpgrade() {
-    fetch('/config/upgrade')
+  function loadUpgrade(refresh) {
+    fetch('/config/upgrade' + (refresh ? '?refresh=1' : ''), { cache: 'no-store' })
       .then(function (r) { return r.json(); })
       .then(renderUpgrade)
       .catch(function (err) {
@@ -366,6 +372,14 @@ ${consoleShellScript}
   }
 
   document.getElementById('settingsContent').addEventListener('click', function (ev) {
+    var recheck = ev.target.closest('#upgradeRecheck');
+    if (recheck) {
+      ev.preventDefault();
+      var box = upgradeBox();
+      if (box) box.innerHTML = '<p class="hint">Checking for a newer LoopEngine' + String.fromCharCode(8230) + '</p>';
+      loadUpgrade(true);
+      return;
+    }
     var btn = ev.target.closest('#upgradeBtn');
     if (!btn) return;
     if (btn.getAttribute('data-armed') !== '1') {

package/dist/web/upgrade-admin.d.ts

@@ -4,6 +4,8 @@ export interface UpgradeStatus {
     current: string;
     /** Latest loopengine on npm; null when npm couldn't be reached. */
     latest: string | null;
+    /** When npm was last asked for `latest`. */
+    checkedAt: string | null;
     updateAvailable: boolean;
     /** The create-loopengine version this project was scaffolded or last
      * upgraded from (.create-loopengine.json); null when the project
@@ -29,7 +31,10 @@ export interface UpgradeOutcome {
 type Runner = (cmd: string, args: string[], cwd: string, timeoutMs: number) => Promise<string>;
 /** Tests replace npm/npx with a fake. */
 export declare function setUpgradeRunner(next: Runner | undefined): void;
-export declare function describeUpgrade(projectDir?: string): Promise<UpgradeStatus>;
+/** `refresh`: ask npm again even if it was asked a moment ago. */
+export declare function describeUpgrade(projectDir?: string, options?: {
+    refresh?: boolean;
+}): Promise<UpgradeStatus>;
 /**
  * Runs the upgrade. `busy` is checked first: upgrading under a running
  * chat turn or scheduled run would restart the server mid-reply. Resolves

package/dist/web/upgrade-admin.js

@@ -40,6 +40,8 @@ export function setUpgradeRunner(next) {
     run = next ?? realRun;
     latestCache = undefined;
 }
+// A minute, so reloading Settings doesn't ask npm every time while a
+// release that just came out shows up soon (the page's Check again skips it).
 let latestCache;
 async function latestLoopengine(projectDir) {
     if (latestCache && latestCache.until > Date.now())
@@ -51,7 +53,7 @@ async function latestLoopengine(projectDir) {
     catch {
         value = null;
     }
-    latestCache = { value, until: Date.now() + (value ? 10 * 60_000 : 60_000) };
+    latestCache = { value, until: Date.now() + 60_000, at: new Date().toISOString() };
     return value;
 }
 function templateVersion(projectDir) {
@@ -66,13 +68,17 @@ function templateVersion(projectDir) {
     }
 }
 let running = false;
-export async function describeUpgrade(projectDir = process.cwd()) {
+/** `refresh`: ask npm again even if it was asked a moment ago. */
+export async function describeUpgrade(projectDir = process.cwd(), options = {}) {
+    if (options.refresh)
+        latestCache = undefined;
     const current = loopengineVersion();
     const latest = await latestLoopengine(projectDir);
     const template = templateVersion(projectDir);
     const status = {
         current,
         latest,
+        checkedAt: latestCache?.at ?? null,
         updateAvailable: Boolean(latest && semver.valid(current) && semver.gt(latest, current)),
         templateVersion: template,
         running,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loopengine",
-  "version": "0.1.81",
+  "version": "0.1.82",
   "type": "module",
   "description": "Runtime for tool-using AI agents with a transparent ReAct loop.",
   "license": "MIT",