loopengine 0.1.92 → 0.1.94

package/dist/core/time-zone.js

@@ -0,0 +1,138 @@
+// The workspace's time zone: what "9:00" means in a schedule, a
+// template's start time and the console's date fields. Set from the
+// console's Settings (LOOPENGINE_TIME_ZONE, an IANA name such as
+// "America/New_York"); unset, it's the server's own, which on a hosted
+// workspace is UTC.
+//
+// Times are worked out with Intl alone, no time zone data of our own:
+// a wall-clock time is turned into an instant by guessing its offset
+// and correcting it twice, which settles on the right answer either side
+// of a daylight-saving change. A time the clocks skip (02:30 on the
+// morning they spring forward) lands an hour later; a time that happens
+// twice (the hour they fall back) is the first of the two.
+export const TIME_ZONE_ENV = 'LOOPENGINE_TIME_ZONE';
+const formatters = new Map();
+function formatter(timeZone) {
+    let f = formatters.get(timeZone);
+    if (!f) {
+        f = new Intl.DateTimeFormat('en-US', {
+            timeZone,
+            hourCycle: 'h23',
+            year: 'numeric',
+            month: 'numeric',
+            day: 'numeric',
+            hour: 'numeric',
+            minute: 'numeric',
+            second: 'numeric',
+            weekday: 'short',
+        });
+        formatters.set(timeZone, f);
+    }
+    return f;
+}
+export function isValidTimeZone(timeZone) {
+    if (typeof timeZone !== 'string' || !timeZone.trim())
+        return false;
+    try {
+        new Intl.DateTimeFormat('en-US', { timeZone });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** The server's own time zone. */
+export function serverTimeZone() {
+    return Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC';
+}
+/** The workspace's time zone: LOOPENGINE_TIME_ZONE when it's a real one,
+ * else the server's. */
+export function workspaceTimeZone() {
+    const configured = process.env[TIME_ZONE_ENV]?.trim();
+    return configured && isValidTimeZone(configured) ? configured : serverTimeZone();
+}
+/** Every time zone this server knows, for the console's picker. */
+export function listTimeZones() {
+    const supported = Intl.supportedValuesOf?.('timeZone') ?? [];
+    return supported.includes('UTC') ? supported : ['UTC', ...supported];
+}
+const WEEKDAY_INDEX = { Sun: 0, Mon: 1, Tue: 2, Wed: 3, Thu: 4, Fri: 5, Sat: 6 };
+/** The wall-clock time (and weekday, 0 = Sunday) at `ms` in `timeZone`. */
+export function wallTimeAt(ms, timeZone) {
+    const parts = {};
+    for (const p of formatter(timeZone).formatToParts(new Date(ms)))
+        parts[p.type] = p.value;
+    return {
+        year: Number(parts.year),
+        month: Number(parts.month),
+        day: Number(parts.day),
+        hour: Number(parts.hour),
+        minute: Number(parts.minute),
+        second: Number(parts.second),
+        weekday: WEEKDAY_INDEX[parts.weekday] ?? 0,
+    };
+}
+function asUtcMs(t) {
+    return Date.UTC(t.year, t.month - 1, t.day, t.hour, t.minute, t.second);
+}
+/** How far ahead of UTC `timeZone` is at `ms`, in ms. */
+function offsetAt(ms, timeZone) {
+    return asUtcMs(wallTimeAt(Math.floor(ms / 1000) * 1000, timeZone)) - Math.floor(ms / 1000) * 1000;
+}
+/** The instant a wall-clock time in `timeZone` happens. Fields may
+ * overflow (day 32, hour 25), as with Date.UTC. */
+export function instantOf(t, timeZone) {
+    const naive = asUtcMs(t);
+    const first = naive - offsetAt(naive, timeZone);
+    const second = naive - offsetAt(first, timeZone);
+    // Either side of a change the two guesses differ; the earlier one is
+    // right for a repeated hour, the later one for a skipped hour.
+    if (first === second)
+        return first;
+    return offsetAt(Math.min(first, second), timeZone) === naive - Math.min(first, second) ? Math.min(first, second) : Math.max(first, second);
+}
+const LOCAL_TIMESTAMP = /^(\d{4})-(\d{2})-(\d{2})[T ](\d{2}):(\d{2})(?::(\d{2})(?:\.\d+)?)?$/;
+/** An ISO 8601 timestamp as ms. One with a "Z" or an offset is exact;
+ * one without ("2026-11-02T09:00") is a wall-clock time in `timeZone`.
+ * NaN when it isn't a timestamp. */
+export function parseTimestamp(value, timeZone) {
+    const local = LOCAL_TIMESTAMP.exec(value.trim());
+    if (!local)
+        return Date.parse(value);
+    const [, y, mo, d, h, mi, s] = local;
+    const t = { year: Number(y), month: Number(mo), day: Number(d), hour: Number(h), minute: Number(mi), second: Number(s ?? 0) };
+    if (t.month < 1 || t.month > 12 || t.day < 1 || t.day > 31 || t.hour > 23 || t.minute > 59 || t.second > 59)
+        return Number.NaN;
+    return instantOf(t, timeZone);
+}
+const TIME_OF_DAY = /^([01]?\d|2[0-3]):([0-5]\d)$/;
+/** "09:00" as [hours, minutes], or undefined when it isn't a time. */
+export function parseTimeOfDay(value) {
+    const match = TIME_OF_DAY.exec(value.trim());
+    return match ? [Number(match[1]), Number(match[2])] : undefined;
+}
+/** The next time it's `at` ("09:00") in `timeZone`, strictly after
+ * `nowMs`, on `weekday` (0 = Sunday) when given. */
+export function nextTimeOfDay(at, nowMs, timeZone, weekday) {
+    const today = wallTimeAt(nowMs, timeZone);
+    const ahead = weekday === undefined ? 0 : (weekday - today.weekday + 7) % 7;
+    const step = weekday === undefined ? 1 : 7;
+    for (let days = ahead;; days += step) {
+        const ms = instantOf({ year: today.year, month: today.month, day: today.day + days, hour: at[0], minute: at[1], second: 0 }, timeZone);
+        if (ms > nowMs)
+            return ms;
+    }
+}
+/** `ms` moved by whole calendar days in `timeZone`, keeping its time of
+ * day across a daylight-saving change. */
+export function addCalendarDays(ms, days, timeZone) {
+    const t = wallTimeAt(ms, timeZone);
+    return instantOf({ ...t, day: t.day + days }, timeZone);
+}
+/** `ms` as "2026-11-02 09:00" in `timeZone`, for tool results the model
+ * reads back to a person. */
+export function formatWallTime(ms, timeZone) {
+    const t = wallTimeAt(ms, timeZone);
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${t.year}-${pad(t.month)}-${pad(t.day)} ${pad(t.hour)}:${pad(t.minute)}`;
+}

package/dist/index.d.ts

@@ -10,7 +10,7 @@ export { setUsageSink, recordUsage, type UsageEvent, type UsageSink } from '#cor
 export { readNotifierFile, writeNotifierFile, removeNotifierFile, validateNotifierFile, notifierConfigFromFile, NotifierFileError, NOTIFIER_SECRET_VARS, type NotifierFile, type MessagingApprover } from '#core/notifier-file.js';
 export { listDeliveries, recordDelivery, type NotifierDelivery } from '#core/notifier-deliveries.js';
 export { describeNotifier } from '#core/http-notifier.js';
-export { Scheduler, ScheduleError, FileSchedulerStore, getSchedulerStore, setSchedulerStore, createScheduledTask, listScheduledTasks, getScheduledTask, cancelScheduledTask, pauseScheduledTask, resumeScheduledTask, runScheduledTaskNow, deleteScheduledTask, nextScheduledWakeAt, importLegacyScheduledTasks, parseEvery, describeSchedule, type ScheduledTask, type ScheduledTaskRun, type ScheduledTaskStatus, type Schedule, type SchedulerStore, type FireTask, type CreateScheduledTaskInput } from '#core/scheduler.js';
+export { Scheduler, ScheduleError, FileSchedulerStore, getSchedulerStore, setSchedulerStore, createScheduledTask, listScheduledTasks, getScheduledTask, cancelScheduledTask, pauseScheduledTask, resumeScheduledTask, runScheduledTaskNow, deleteScheduledTask, nextScheduledWakeAt, moveScheduledTasksToTimeZone, importLegacyScheduledTasks, parseEvery, describeSchedule, type ScheduledTask, type ScheduledTaskRun, type ScheduledTaskStatus, type Schedule, type SchedulerStore, type FireTask, type CreateScheduledTaskInput } from '#core/scheduler.js';
 export { NOTIFIER_SLACK_SIGNING_SECRET_VAR } from '#core/notifier-file.js';
 export { firstSighting, handleInboundMessage, handleMessagingAction, settleThreadChoice, isPlainApproval, type MessagingDeps, type MessagingDecision, type DecisionOutcome } from '#core/messaging/engine.js';
 export { formatArgs, formatChange, labelFor } from '#core/messaging/format-args.js';
@@ -74,8 +74,8 @@ export { interviewPageHtml } from './web/interview-page.js';
 export { InterviewError, answerInterview, createFromCandidate, createAgentFromCandidate, describeCandidate, deleteInterview, finishInterview, getInterview, interviewTools, listInterviews, pickAgentModel, pickInterviewModel, previewCandidate, startInterview, setInterviewProject, setupChecklist, type Interview, type InterviewAgentSource, type CandidatePreview, type CreatedAgent, type ChecklistItem, type CreateDeps, } from './web/interview-admin.js';
 export { runInterviewTurn, rankCandidates, validateCandidate, INTERVIEWER_PROMPT, type AgentCandidate, type InterviewStage } from './core/system-agents/interviewer.js';
 export { templatesPageHtml } from './web/templates-page.js';
-export { TemplateError, createFromTemplate, listTemplates, previewTemplate, type TemplateSummary } from './web/templates-admin.js';
-export { STARTER_TEMPLATES, starterTemplate, type StarterTemplate } from './core/system-agents/templates.js';
+export { TemplateError, createFromTemplate, describeTemplateSchedule, listTemplates, previewTemplate, templateChecklist, type CreatedTemplateAgent, type LegacyTemplateCreateDeps, type TemplateChecklistItem, type TemplateCreateDeps, type TemplatePreview, type TemplateSummary, } from './web/templates-admin.js';
+export { STARTER_TEMPLATES, starterTemplate, templateScheduleStart, type StarterTemplate, type TemplateRule, type TemplateSchedule, type TemplateSetup, type TemplateSkill, } from './core/system-agents/templates.js';
 export { globalConfigPageHtml } from './web/global-config-page.js';
 export { playgroundHtml } from './web/playground.js';
 export { readSkill, writeSkill, deleteSkill, SkillInvalidIdError, SkillNotFoundError } from './web/skills-admin.js';
@@ -88,10 +88,11 @@ export { installAbility, upgradeAbility, removeAbility, listInstalledAbilities,
 export type { InstalledAbilityRecord, AbilityEnvDecl, UpgradeFileResult } from './bin/ability-manager.js';
 export { searchPublicAbilities, fetchLatestAbilityVersion } from './web/abilities-admin.js';
 export type { PublicAbilitySearchResult } from './web/abilities-admin.js';
-export { describeModelProviders, describeGateways, setModelProviderKey, clearModelProviderKey, ModelKeyError } from './web/global-config.js';
+export { describeModelProviders, describeGateways, setModelProviderKey, clearModelProviderKey, ModelKeyError, describeTimeZone, setWorkspaceTimeZone, TimeZoneError } from './web/global-config.js';
 export { loopengineVersion } from './core/version.js';
 export { describeUpgrade, runUpgrade, UpgradeError } from './web/upgrade-admin.js';
-export type { ModelProviderInfo, AgentModelUsage, ModelsView, GatewayProviderInfo, GatewaysView } from './web/global-config.js';
+export type { ModelProviderInfo, AgentModelUsage, ModelsView, GatewayProviderInfo, GatewaysView, TimeZoneView } from './web/global-config.js';
+export { workspaceTimeZone, serverTimeZone, isValidTimeZone, TIME_ZONE_ENV } from '#core/time-zone.js';
 export { createTrackedApprover, listApprovals, decideApproval, findApproval } from './web/web-approver.js';
 export { scaffoldAgent, scaffoldSubagent, AgentNameError, AgentExistsError, AgentNotFoundError, AgentModelError } from './bin/cli.js';
 export type { AgentTemplateOptions } from './bin/cli.js';

package/dist/index.js

@@ -12,7 +12,7 @@ export { setUsageSink, recordUsage } from '#core/usage.js';
 export { readNotifierFile, writeNotifierFile, removeNotifierFile, validateNotifierFile, notifierConfigFromFile, NotifierFileError, NOTIFIER_SECRET_VARS } from '#core/notifier-file.js';
 export { listDeliveries, recordDelivery } from '#core/notifier-deliveries.js';
 export { describeNotifier } from '#core/http-notifier.js';
-export { Scheduler, ScheduleError, FileSchedulerStore, getSchedulerStore, setSchedulerStore, createScheduledTask, listScheduledTasks, getScheduledTask, cancelScheduledTask, pauseScheduledTask, resumeScheduledTask, runScheduledTaskNow, deleteScheduledTask, nextScheduledWakeAt, importLegacyScheduledTasks, parseEvery, describeSchedule } from '#core/scheduler.js';
+export { Scheduler, ScheduleError, FileSchedulerStore, getSchedulerStore, setSchedulerStore, createScheduledTask, listScheduledTasks, getScheduledTask, cancelScheduledTask, pauseScheduledTask, resumeScheduledTask, runScheduledTaskNow, deleteScheduledTask, nextScheduledWakeAt, moveScheduledTasksToTimeZone, importLegacyScheduledTasks, parseEvery, describeSchedule } from '#core/scheduler.js';
 export { NOTIFIER_SLACK_SIGNING_SECRET_VAR } from '#core/notifier-file.js';
 export { firstSighting, handleInboundMessage, handleMessagingAction, settleThreadChoice, isPlainApproval } from '#core/messaging/engine.js';
 export { formatArgs, formatChange, labelFor } from '#core/messaging/format-args.js';
@@ -69,8 +69,8 @@ export { interviewPageHtml } from './web/interview-page.js';
 export { InterviewError, answerInterview, createFromCandidate, createAgentFromCandidate, describeCandidate, deleteInterview, finishInterview, getInterview, interviewTools, listInterviews, pickAgentModel, pickInterviewModel, previewCandidate, startInterview, setInterviewProject, setupChecklist, } from './web/interview-admin.js';
 export { runInterviewTurn, rankCandidates, validateCandidate, INTERVIEWER_PROMPT } from './core/system-agents/interviewer.js';
 export { templatesPageHtml } from './web/templates-page.js';
-export { TemplateError, createFromTemplate, listTemplates, previewTemplate } from './web/templates-admin.js';
-export { STARTER_TEMPLATES, starterTemplate } from './core/system-agents/templates.js';
+export { TemplateError, createFromTemplate, describeTemplateSchedule, listTemplates, previewTemplate, templateChecklist, } from './web/templates-admin.js';
+export { STARTER_TEMPLATES, starterTemplate, templateScheduleStart, } from './core/system-agents/templates.js';
 export { globalConfigPageHtml } from './web/global-config-page.js';
 export { playgroundHtml } from './web/playground.js';
 export { readSkill, writeSkill, deleteSkill, SkillInvalidIdError, SkillNotFoundError } from './web/skills-admin.js';
@@ -78,8 +78,9 @@ export { listDeclaredEnvVars, setEnvVar, unsetEnvVar, setAgentEnvVar, unsetAgent
 export { readActauthConfig, addActauthRule, updateActauthRule, removeActauthRule, setDefaultDecision, ActauthRuleExistsError, ActauthRuleNotFoundError, } from './web/actauth-admin.js';
 export { installAbility, upgradeAbility, removeAbility, listInstalledAbilities, backfillDependencies, AbilityManifestError, AbilityVersionError, AbilityCollisionError, AbilityAlreadyInstalledError, AbilityNotInstalledError, } from './bin/ability-manager.js';
 export { searchPublicAbilities, fetchLatestAbilityVersion } from './web/abilities-admin.js';
-export { describeModelProviders, describeGateways, setModelProviderKey, clearModelProviderKey, ModelKeyError } from './web/global-config.js';
+export { describeModelProviders, describeGateways, setModelProviderKey, clearModelProviderKey, ModelKeyError, describeTimeZone, setWorkspaceTimeZone, TimeZoneError } from './web/global-config.js';
 export { loopengineVersion } from './core/version.js';
 export { describeUpgrade, runUpgrade, UpgradeError } from './web/upgrade-admin.js';
+export { workspaceTimeZone, serverTimeZone, isValidTimeZone, TIME_ZONE_ENV } from '#core/time-zone.js';
 export { createTrackedApprover, listApprovals, decideApproval, findApproval } from './web/web-approver.js';
 export { scaffoldAgent, scaffoldSubagent, AgentNameError, AgentExistsError, AgentNotFoundError, AgentModelError } from './bin/cli.js';

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

@@ -641,7 +641,7 @@ ${consoleShellScript}
       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 (n && !connected) messagingDetail.push(n.missingSecret ? 'Saved, but its secret isn' + String.fromCharCode(8217) + 't set' : 'Send approvals and questions to Slack, Lark, email or a webhook');
       if (!messagingDetail.length && n) messagingDetail.push('Sends ' + escapeHtml((n.events || []).join(', ')));
       set('ovMessagingDetail', messagingDetail.join(' \u00b7 '));
       showPendingCount(pending.length);
@@ -1076,7 +1076,7 @@ ${consoleShellScript}
     if (n.source === 'file') return 'Sending to <strong>' + escapeHtml(n.channel) + '</strong> for: ' + escapeHtml((n.events || []).join(', ')) + '.';
     if (n.missingSecret) return 'Saved, but not sending yet: set the secret below (<code>' + escapeHtml(n.missingSecret) + '</code>).';
     if (n.source === 'default') return 'Using the project-wide default webhook (<code>LOOPENGINE_DEFAULT_WEBHOOK_URL</code>, ' + escapeHtml(n.defaultWebhookUrl) + '). Set one below to use a different target for this agent.';
-    return '<strong>Nowhere yet</strong>, so nobody is notified. Choose a webhook, Slack channel or Lark chat below.';
+    return '<strong>Nowhere yet</strong>, so nobody is notified. Choose a Slack channel, Lark chat, email address or webhook below.';
   }
 
   // Slack only: whether replies in a request's thread are answered. On
@@ -1114,7 +1114,7 @@ ${consoleShellScript}
     function secretPlaceholder(isSet, missing) {
       return isSet ? 'Saved ' + String.fromCharCode(8212) + ' type a new one only to replace it' : missing;
     }
-    var SECRET_HINTS = { slack: 'xoxb-' + String.fromCharCode(8230) + ' from OAuth & Permissions', webhook: 'A long random string, or Generate', lark: 'App Secret from the Lark developer console' };
+    var SECRET_HINTS = { slack: 'xoxb-' + String.fromCharCode(8230) + ' from OAuth & Permissions', webhook: 'A long random string, or Generate', lark: 'App Secret from the Lark developer console', email: 'An API key from your email provider' };
     function secretField(channel, label) {
       var isSet = n.secretsSet && n.secretsSet[channel];
       return '<label>' + secretHead(label, isSet) + '<span class="hint">(stored in this agent&#39;s env as ' + escapeHtml(n.secretVars[channel]) + ')</span>' +
@@ -1123,7 +1123,7 @@ ${consoleShellScript}
     }
     return '<form class="add-source" id="notifierForm" style="max-width:560px">' +
       '<label>Send to<select name="channel" id="notifierChannel">' +
-        ['webhook', 'slack', 'lark'].map(function (c) { return '<option value="' + c + '"' + (f.channel === c ? ' selected' : '') + '>' + { webhook: 'Webhook (your app)', slack: 'Slack channel', lark: 'Lark / Feishu chat' }[c] + '</option>'; }).join('') +
+        ['webhook', 'slack', 'lark', 'email'].map(function (c) { return '<option value="' + c + '"' + (f.channel === c ? ' selected' : '') + '>' + { webhook: 'Webhook (your app)', slack: 'Slack channel', lark: 'Lark / Feishu chat', email: 'Email' }[c] + '</option>'; }).join('') +
       '</select></label>' +
       field('webhook', '<label>Webhook URL<input type="url" name="url" placeholder="https://your-app.example.com/hooks/loopengine" value="' + escapeHtml(f.url || '') + '"></label>' + secretField('webhook', 'Signing secret') +
         '<p class="hint" style="margin:0">Your app checks the <code>X-Actauth-Signature</code> header (HMAC-SHA256 of the body with the signing secret). Each payload carries a <code>decideUrl</code> it can simply forward to a person, or it can decide itself by sending <code>{"decision":"approve"}</code> or <code>{"decision":"deny"}</code> to <code>resolveUrl</code>.</p>') +
@@ -1149,6 +1149,14 @@ ${consoleShellScript}
         renderConversationsField(n, f) +
         '<p class="hint" style="margin:0" id="slackEventsNote"></p>') +
       field('lark', '<label>App ID<input name="appId" value="' + escapeHtml(f.appId || '') + '"></label><label>Chat ID<input name="chatId" value="' + escapeHtml(f.chatId || '') + '"></label>' + secretField('lark', 'App secret')) +
+      field('email',
+        '<label>Email addresses <span class="hint">(who gets the requests; separate several with commas)</span><input name="emailTo" placeholder="ops@example.com, lead@example.com" value="' + escapeHtml(f.to || '') + '"></label>' +
+        '<label>Sent by <span class="hint">(your email provider must allow sending from this address)</span><input name="emailFrom" placeholder="LoopEngine &lt;approvals@example.com&gt;" value="' + escapeHtml(f.from || '') + '"></label>' +
+        '<label>Email provider<select name="emailProvider">' +
+          [['resend', 'Resend'], ['sendgrid', 'SendGrid'], ['postmark', 'Postmark']].map(function (p) { return '<option value="' + p[0] + '"' + (f.provider === p[0] ? ' selected' : '') + '>' + p[1] + '</option>'; }).join('') +
+        '</select></label>' +
+        secretField('email', 'API key') +
+        '<p class="hint" style="margin:0">Each email links to a page where the person approves, denies, edits or answers, with no login. The link address below must be one they can open.</p>') +
       '<label>Link address <span class="hint">(messages link here so people can approve without logging in; use an address they can reach)</span>' +
         '<input type="url" name="publicUrl" id="notifierPublicUrl" value="' + escapeHtml(n.publicUrl || f.publicUrl || location.origin) + '"' + (n.publicUrl ? ' disabled title="Set by LOOPENGINE_PUBLIC_URL"' : '') + '></label>' +
       '<div class="body-field">Send' +
@@ -1392,6 +1400,7 @@ ${consoleShellScript}
       var data = new FormData(form);
       var channel = data.get('channel');
       var body = { channel: channel, events: data.getAll('events'), url: data.get('url'), channelId: data.get('channelId'), appId: data.get('appId'), chatId: data.get('chatId'), publicUrl: data.get('publicUrl') };
+      if (channel === 'email') { body.to = data.get('emailTo'); body.from = data.get('emailFrom'); body.provider = data.get('emailProvider'); }
       var secret = data.get('secret_' + channel);
       if (secret) body.secret = secret;
       if (channel === 'slack' && data.get('signingSecret')) body.signingSecret = data.get('signingSecret');
@@ -1475,8 +1484,22 @@ ${consoleShellScript}
     scheduled: 'scheduled', running: 'running', awaiting_approval: 'waiting for approval', paused: 'paused', done: 'done', cancelled: 'cancelled'
   };
 
+  // The workspace's time zone, from GET /agents/:name/schedules (an
+  // older project adapter doesn't send it: then the browser's own).
+  var schedulesTimeZone = null;
+
+  function fmtScheduleTime(iso) {
+    var d = new Date(iso);
+    if (schedulesTimeZone) {
+      try { return d.toLocaleString(undefined, { timeZone: schedulesTimeZone, timeZoneName: 'short' }); } catch (e) {}
+    }
+    return d.toLocaleString();
+  }
+
   function scheduleText(s) {
-    return s.run_at ? 'Once, ' + new Date(s.run_at).toLocaleString() : 'Every ' + escapeHtml(s.every);
+    // A repeating task's anchor is its first run, so it says when the
+    // later ones fall (e.g. every 1d from 9:00).
+    return s.run_at ? 'Once, ' + escapeHtml(fmtScheduleTime(s.run_at)) : 'Every ' + escapeHtml(s.every) + (s.anchor ? '<div class="hint">from ' + escapeHtml(fmtScheduleTime(s.anchor)) + '</div>' : '');
   }
 
   function renderScheduleRow(t) {
@@ -1488,17 +1511,17 @@ ${consoleShellScript}
     if (t.status === 'cancelled' || t.status === 'done') actions.push(['delete', 'Delete']);
     var last = t.last_run_at
       ? '<span class="le-pill ' + (t.last_status === 'ok' ? 'good' : 'bad') + '">' + escapeHtml(t.last_status) + '</span> ' +
-        '<span class="hint">' + escapeHtml(new Date(t.last_run_at).toLocaleString()) + '</span>' +
+        '<span class="hint">' + escapeHtml(fmtScheduleTime(t.last_run_at)) + '</span>' +
         '<div class="schedule-result">' + escapeHtml(t.last_status === 'ok' ? (t.last_result || '') : (t.last_error || '')) + '</div>'
       : '<span class="hint">not run yet</span>';
     var history = (t.history || []).slice().reverse().map(function (h) {
-      return '<li><span class="le-pill ' + (h.status === 'ok' ? 'good' : 'bad') + '">' + escapeHtml(h.status) + '</span> <span class="hint">' + escapeHtml(new Date(h.ran_at).toLocaleString()) + '</span>' +
+      return '<li><span class="le-pill ' + (h.status === 'ok' ? 'good' : 'bad') + '">' + escapeHtml(h.status) + '</span> <span class="hint">' + escapeHtml(fmtScheduleTime(h.ran_at)) + '</span>' +
         '<div class="schedule-result">' + escapeHtml(h.status === 'ok' ? (h.result || '') : (h.error || '')) + '</div></li>';
     }).join('');
     return '<tr>' +
       '<td style="min-width:180px"><strong>' + escapeHtml(t.task_name || 'Untitled') + '</strong>' + (t.notify ? ' <span class="le-pill accent" title="Each result goes through this agent&#39;s notifier">notifies</span>' : '') +
         '<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>' + scheduleText(t.schedule) + (t.next_run_at ? '<div class="hint">next ' + escapeHtml(fmtScheduleTime(t.next_run_at)) + '</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 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>' +
@@ -1520,7 +1543,10 @@ ${consoleShellScript}
           '<div class="body-field">When' +
             '<div class="schedule-when"><input type="radio" name="when" value="every" id="whenEvery" checked><label for="whenEvery">Every</label>' +
               '<input type="number" name="everyN" value="1" min="1" aria-label="How many">' +
-              '<select name="everyUnit" aria-label="Unit"><option value="m">minutes</option><option value="h" selected>hours</option><option value="d">days</option></select></div>' +
+              '<select name="everyUnit" aria-label="Unit"><option value="m">minutes</option><option value="h" selected>hours</option><option value="d">days</option><option value="w">weeks</option></select>' +
+              '<label for="everyStart">starting</label><input type="datetime-local" name="everyStart" id="everyStart" aria-label="First run"></div>' +
+            '<p class="hint" style="margin:0 0 4px 22px">Optional. The first run, which sets the time of day (and the weekday, for weeks) every later run keeps, e.g. every 1 day starting tomorrow 09:00. Without it, the first run is one interval from now.' +
+              (schedulesTimeZone ? ' Times are in ' + escapeHtml(schedulesTimeZone.replace(/_/g, ' ')) + ' (<a href="/config?section=settings">change</a>).' : '') + '</p>' +
             '<div class="schedule-when"><input type="radio" name="when" value="once" id="whenOnce"><label for="whenOnce">Once at</label>' +
               '<input type="datetime-local" name="runAt" aria-label="Date and time"></div>' +
           '</div>' +
@@ -1531,6 +1557,13 @@ ${consoleShellScript}
         '</form></section>';
   }
 
+  // A date field's value ("2026-11-02T09:00") goes as it is, for the
+  // server to read in the workspace's time zone; with no workspace time
+  // zone known, it's the browser's.
+  function scheduleFormTime(value) {
+    return schedulesTimeZone ? value : new Date(value).toISOString();
+  }
+
   function wireSchedulesHandlers(name) {
     var content = schedulesContentEl();
     if (!content) return;
@@ -1563,9 +1596,13 @@ ${consoleShellScript}
       var schedule;
       if (data.get('when') === 'once') {
         if (!data.get('runAt')) { result.textContent = 'Pick a date and time.'; return; }
-        schedule = { run_at: new Date(data.get('runAt')).toISOString() };
+        schedule = { run_at: scheduleFormTime(data.get('runAt')) };
       } else {
-        schedule = { every: String(data.get('everyN')) + data.get('everyUnit') };
+        // Weeks go to the scheduler as days.
+        var unit = data.get('everyUnit');
+        var n = Number(data.get('everyN')) || 1;
+        schedule = { every: unit === 'w' ? String(n * 7) + 'd' : String(n) + unit };
+        if (data.get('everyStart')) schedule.start_at = scheduleFormTime(data.get('everyStart'));
       }
       result.textContent = 'Scheduling' + String.fromCharCode(8230);
       fetchJsonRetryOnce('/agents/' + encodeURIComponent(name) + '/schedules', {
@@ -1586,6 +1623,7 @@ ${consoleShellScript}
       if (currentName !== name) return;
       if (!r.ok) throw new Error(r.body.error || 'request failed');
       var tasks = r.body.tasks || [];
+      schedulesTimeZone = r.body.time_zone || null;
       content.innerHTML = renderSchedulesHtml(tasks);
       wireSchedulesHandlers(name);
       leShell.setCount('schedules', tasks.filter(function (t) { return t.status !== 'cancelled' && t.status !== 'done'; }).length);

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

@@ -298,14 +298,78 @@ ${consoleShellScript}
       ['Environment name', '<code>' + escapeHtml(d.environment) + '</code> <span class="hint">(LOOPENGINE_ENV)</span>'],
       ['Public address', d.publicUrl ? '<code>' + escapeHtml(d.publicUrl) + '</code>' : '<span class="hint">Not set (LOOPENGINE_PUBLIC_URL); links in notifications use the address saved with each notifier</span>'],
       ['Scheduled tasks', d.scheduler === 'off' ? 'Off on this server (LOOPENGINE_SCHEDULER=off)' : 'Run by this server'],
+      ['Time zone', d.timeZone ? '<code>' + escapeHtml(d.timeZone) + '</code>' : '<span class="hint">The server' + String.fromCharCode(8217) + 's own. Update the template below to choose one here.</span>'],
       ['Theme', 'Follows your system'],
     ];
     return '<section><table><thead><tr><th>Setting</th><th>Value</th></tr></thead><tbody>' +
       rows.map(function (r) { return '<tr><td>' + r[0] + '</td><td>' + r[1] + '</td></tr>'; }).join('') +
       '</tbody></table></section>' +
+      (d.timeZone ? '<section><h3>Time zone</h3><div class="source" id="timeZoneBox"><p class="hint">Loading' + String.fromCharCode(8230) + '</p></div></section>' : '') +
       '<section><h3>Updates</h3><div class="source" id="upgradeBox"><p class="hint">Checking for a newer LoopEngine' + String.fromCharCode(8230) + '</p></div></section>';
   }
 
+  // ---- Time zone ----
+
+  function renderTimeZone(t) {
+    var box = document.getElementById('timeZoneBox');
+    if (!box) return;
+    var intro = '<p>Schedules and templates use this for times of day: &ldquo;daily at 09:00&rdquo; runs at 9:00 here, and daily and weekly schedules keep that time when the clocks change. ' +
+      (t.chosen ? '' : 'Not chosen yet, so it' + String.fromCharCode(8217) + 's the server' + String.fromCharCode(8217) + 's (<code>' + escapeHtml(t.server) + '</code>).') + '</p>';
+    if (!t.canSave) {
+      box.innerHTML = intro + '<p>In use: <code>' + escapeHtml(t.timeZone) + '</code></p><p class="hint">Set LOOPENGINE_ADMIN_AUTH to change it here, or put <code>LOOPENGINE_TIME_ZONE</code> in .env.</p>';
+      return;
+    }
+    var browserZone = '';
+    try { browserZone = Intl.DateTimeFormat().resolvedOptions().timeZone || ''; } catch (e) {}
+    var options = t.zones.map(function (z) {
+      return '<option value="' + escapeHtml(z) + '"' + (z === t.timeZone ? ' selected' : '') + '>' + escapeHtml(z.replace(/_/g, ' ')) + '</option>';
+    }).join('');
+    box.innerHTML = intro +
+      '<form id="timeZoneForm" style="display:flex;flex-direction:column;gap:10px;max-width:480px">' +
+        '<label for="timeZoneSelect">Time zone</label>' +
+        '<select id="timeZoneSelect" name="timeZone">' + options + '</select>' +
+        (browserZone && browserZone !== t.timeZone && t.zones.indexOf(browserZone) >= 0
+          ? '<p class="hint" style="margin:0"><a href="#" id="timeZoneUseBrowser">Use this browser' + String.fromCharCode(8217) + 's, ' + escapeHtml(browserZone) + '</a></p>' : '') +
+        '<label style="display:flex;gap:8px;align-items:center"><input type="checkbox" name="moveSchedules" checked> Move existing daily and weekly schedules too, keeping their time of day</label>' +
+        '<div><button type="submit" class="primary">Save</button></div>' +
+        '<div id="timeZoneMsg" class="hint"></div>' +
+      '</form>';
+    var form = document.getElementById('timeZoneForm');
+    var useBrowser = document.getElementById('timeZoneUseBrowser');
+    if (useBrowser) useBrowser.addEventListener('click', function (ev) { ev.preventDefault(); form.timeZone.value = browserZone; });
+    form.addEventListener('submit', function (ev) {
+      ev.preventDefault();
+      var msg = document.getElementById('timeZoneMsg');
+      var btn = form.querySelector('button[type="submit"]');
+      btn.disabled = true;
+      msg.textContent = 'Saving' + String.fromCharCode(8230);
+      fetch('/config/time-zone', {
+        method: 'PUT',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ timeZone: form.timeZone.value, moveSchedules: form.moveSchedules.checked }),
+      })
+        .then(function (r) { return r.json().then(function (b) { return { ok: r.ok, body: b }; }); })
+        .then(function (r) {
+          btn.disabled = false;
+          if (!r.ok) { msg.innerHTML = '<span class="error">' + escapeHtml(r.body.error || 'Could not save') + '</span>'; return; }
+          msg.textContent = 'Saved: ' + r.body.timeZone.replace(/_/g, ' ') + '.' +
+            (r.body.moved ? ' Moved ' + r.body.moved + ' schedule' + (r.body.moved === 1 ? '' : 's') + '.' : '');
+        })
+        .catch(function (err) { btn.disabled = false; msg.innerHTML = '<span class="error">' + escapeHtml(err.message) + '</span>'; });
+    });
+  }
+
+  function loadTimeZone() {
+    if (!document.getElementById('timeZoneBox')) return;
+    fetch('/config/time-zone', { cache: 'no-store' })
+      .then(function (r) { return r.json(); })
+      .then(renderTimeZone)
+      .catch(function (err) {
+        var box = document.getElementById('timeZoneBox');
+        if (box) box.innerHTML = '<p class="error">Could not load the time zone: ' + escapeHtml(err.message) + '</p>';
+      });
+  }
+
   // ---- Upgrade ----
 
   var UPGRADE_NOTE = 'Updates this server' + String.fromCharCode(8217) + 's LoopEngine code and restarts it, which takes a minute or two. ' +
@@ -436,6 +500,7 @@ ${consoleShellScript}
       .then(function (d) {
         content.innerHTML = renderSettings(d);
         loadedSections.settings = true;
+        loadTimeZone();
         loadUpgrade();
       })
       .catch(function (err) {

package/dist/web/global-config.d.ts

@@ -69,3 +69,27 @@ export declare function modelKeyEnvVar(provider: string): string | undefined;
  */
 export declare function setModelProviderKey(provider: string, key: unknown): Promise<void>;
 export declare function clearModelProviderKey(provider: string): Promise<void>;
+export declare class TimeZoneError extends Error {
+}
+export interface TimeZoneView {
+    /** The one in use. */
+    timeZone: string;
+    /** Whether it was chosen (LOOPENGINE_TIME_ZONE), not the server's. */
+    chosen: boolean;
+    server: string;
+    zones: string[];
+}
+export declare function describeTimeZone(): TimeZoneView;
+/**
+ * The console's Settings → Time zone: saved like a model key (the
+ * project's .env by default) and applied to this process at once. New
+ * schedules and template start times use it from then on; with
+ * `moveSchedules`, existing daily and weekly schedules move to it too,
+ * keeping their time of day. An empty value goes back to the server's.
+ */
+export declare function setWorkspaceTimeZone(value: unknown, options?: {
+    moveSchedules?: boolean;
+}): Promise<{
+    timeZone: string;
+    moved: number;
+}>;

package/dist/web/global-config.js

@@ -1,4 +1,6 @@
 import { getComposioAuthStatus } from '../core/gateway-tools.js';
+import { moveScheduledTasksToTimeZone } from '../core/scheduler.js';
+import { TIME_ZONE_ENV, isValidTimeZone, listTimeZones, serverTimeZone, workspaceTimeZone } from '../core/time-zone.js';
 import { setEnvVar, unsetEnvVar } from './env-admin.js';
 export class ModelKeyError extends Error {
 }
@@ -102,3 +104,31 @@ export async function clearModelProviderKey(provider) {
         throw new ModelKeyError(`unknown provider '${provider}'`);
     await unsetEnvVar(envVar);
 }
+export class TimeZoneError extends Error {
+}
+export function describeTimeZone() {
+    const timeZone = workspaceTimeZone();
+    const configured = process.env[TIME_ZONE_ENV]?.trim();
+    return { timeZone, chosen: Boolean(configured && isValidTimeZone(configured)), server: serverTimeZone(), zones: listTimeZones() };
+}
+/**
+ * The console's Settings → Time zone: saved like a model key (the
+ * project's .env by default) and applied to this process at once. New
+ * schedules and template start times use it from then on; with
+ * `moveSchedules`, existing daily and weekly schedules move to it too,
+ * keeping their time of day. An empty value goes back to the server's.
+ */
+export async function setWorkspaceTimeZone(value, options = {}) {
+    const requested = typeof value === 'string' ? value.trim() : '';
+    if (requested && !isValidTimeZone(requested))
+        throw new TimeZoneError(`"${requested}" isn't a time zone this server knows, such as America/New_York or Europe/London`);
+    const before = workspaceTimeZone();
+    // Saved by its canonical name ("america/new_york" → "America/New_York").
+    if (requested)
+        await setEnvVar(TIME_ZONE_ENV, new Intl.DateTimeFormat('en-US', { timeZone: requested }).resolvedOptions().timeZone);
+    else
+        await unsetEnvVar(TIME_ZONE_ENV);
+    const timeZone = workspaceTimeZone();
+    const moved = options.moveSchedules && timeZone !== before ? await moveScheduledTasksToTimeZone(before, timeZone) : 0;
+    return { timeZone, moved };
+}

package/dist/web/notifier-admin.js

@@ -143,7 +143,7 @@ function activeNotifierTarget(config, defaultWebhook) {
     const dir = agentDirFor(config);
     const file = readNotifierFile(dir);
     if (file) {
-        const { config: fromFile } = notifierConfigFromFile(file, createAgentEnv(config.name, dir));
+        const { config: fromFile } = notifierConfigFromFile(file, createAgentEnv(config.name, dir), config.name);
         if (fromFile)
             return fromFile;
     }
@@ -185,7 +185,7 @@ export async function testAgentNotifier(config, defaultWebhook) {
         const dir = agentDirFor(config);
         const file = readNotifierFile(dir);
         if (file) {
-            const { config: fromFile, missingSecret } = notifierConfigFromFile(file, createAgentEnv(config.name, dir));
+            const { config: fromFile, missingSecret } = notifierConfigFromFile(file, createAgentEnv(config.name, dir), config.name);
             if (!fromFile)
                 return { ok: false, channel: file.channel, error: `${missingSecret} is not set for this agent` };
             target = fromFile;
@@ -202,6 +202,15 @@ export async function testAgentNotifier(config, defaultWebhook) {
     if (target.channel === 'slack') {
         return { channel: 'slack', ...(await sendTestSlackMessage(target.config.botToken, target.config.channelId, `Test from LoopEngine: approvals for ${config.name} will be posted here.`)) };
     }
+    if (target.channel === 'email') {
+        try {
+            await target.config.sendEmail(target.config.to, `Test from LoopEngine: ${config.name}`, `<p>This is a test. Approval requests and questions from <b>${config.name}</b> will be emailed here, each with a link to approve, deny or answer.</p>`, { kind: 'test' });
+            return { channel: 'email', ok: true };
+        }
+        catch (err) {
+            return { channel: 'email', ok: false, error: err instanceof Error ? err.message : String(err) };
+        }
+    }
     return { ok: false, channel: target.channel, error: `Send test isn't supported for ${target.channel} yet` };
 }
 /** Every decision still waiting for this agent, oldest first, each with