loopengine 0.1.91 → 0.1.93

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');
@@ -1476,7 +1485,9 @@ ${consoleShellScript}
   };
 
   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, ' + new Date(s.run_at).toLocaleString() : 'Every ' + escapeHtml(s.every) + (s.anchor ? '<div class="hint">from ' + escapeHtml(new Date(s.anchor).toLocaleString()) + '</div>' : '');
   }
 
   function renderScheduleRow(t) {
@@ -1520,7 +1531,9 @@ ${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.</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>' +
@@ -1565,7 +1578,12 @@ ${consoleShellScript}
         if (!data.get('runAt')) { result.textContent = 'Pick a date and time.'; return; }
         schedule = { run_at: new Date(data.get('runAt')).toISOString() };
       } else {
-        schedule = { every: String(data.get('everyN')) + data.get('everyUnit') };
+        // Weeks go to the scheduler as days; the start comes from the
+        // browser's own time zone.
+        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 = new Date(data.get('everyStart')).toISOString();
       }
       result.textContent = 'Scheduling' + String.fromCharCode(8230);
       fetchJsonRetryOnce('/agents/' + encodeURIComponent(name) + '/schedules', {

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

@@ -50,13 +50,13 @@ ${consoleSidebarHtml}
       <div class="le-title"><button type="button" class="le-menu-btn" data-le-menu aria-label="Open navigation">&#9776;</button>
         <div><h1>Agents</h1><p>Every agent under agents/ in this project. Open one to chat with it or change its tools, permissions and settings.</p></div>
       </div>
-      <div style="display:flex;gap:8px;flex-wrap:wrap"><a href="/interview" style="padding:6px 12px;border:1px solid var(--line);border-radius:6px;text-decoration:none;color:var(--ink);font-size:13px">Find your first agent</a>
+      <div style="display:flex;gap:8px;flex-wrap:wrap"><a href="/templates" style="padding:6px 12px;border:1px solid var(--line);border-radius:6px;text-decoration:none;color:var(--ink);font-size:13px">Templates</a><a href="/interview" style="padding:6px 12px;border:1px solid var(--line);border-radius:6px;text-decoration:none;color:var(--ink);font-size:13px">Find your first agent</a>
       <button type="button" id="newAgentBtn" class="primary">New agent</button></div>
     </div>
   </div>
   <div class="le-scroll"><div class="le-page">
     <form id="newAgentForm" style="display:none">
-      <p class="hint" style="margin:0">Not sure what to build? <a href="/interview">Find your first agent</a>: a short interview that suggests one and creates it.</p>
+      <p class="hint" style="margin:0">Not sure what to build? <a href="/templates">Start from a template</a>, or <a href="/interview">find your first agent</a>: a short interview that suggests one and creates it.</p>
       <h2>New agent</h2>
       <label>Name <span class="hint">(lowercase, hyphens allowed: becomes agents/&lt;name&gt;/)</span>
         <input type="text" name="name" placeholder="weather-agent" pattern="[a-z0-9]+(-[a-z0-9]+)*" required>

package/dist/web/console-shell.js

@@ -22,6 +22,7 @@ export const consoleSidebarHtml = `<aside class="le-sidebar" aria-label="Console
   <a class="le-brand" href="/agents"><span class="le-brand-mark">${BRAND_MARK}</span><span class="le-brand-name">LoopEngine</span></a>
   <div class="le-nav-label"><span>Agents</span><a href="/agents?new=1">+ New</a></div>
   <ul class="le-agent-list" id="leAgentList"></ul>
+  <a class="le-find" href="/templates" data-le-nav="templates">Start from a template</a>
   <a class="le-find" href="/interview" data-le-nav="interview">Find your first agent</a>
   <nav class="le-foot" aria-label="Settings">
     <a href="/config?section=models" data-le-nav="models">Models</a>
@@ -160,7 +161,7 @@ export const consoleShellScript = `<script>
   }
 
   var section = params.get('section');
-  var foot = page === 'config' ? (section === 'gateways' ? 'integrations' : section === 'settings' ? 'settings' : 'models') : page === 'interview' ? 'interview' : '';
+  var foot = page === 'config' ? (section === 'gateways' ? 'integrations' : section === 'settings' ? 'settings' : 'models') : page === 'interview' || page === 'templates' ? page : '';
   var footLinks = document.querySelectorAll('[data-le-nav]');
   for (var i = 0; i < footLinks.length; i++) {
     if (footLinks[i].getAttribute('data-le-nav') === foot) footLinks[i].setAttribute('aria-current', 'page');

package/dist/web/dev-ui-styles.js

@@ -121,6 +121,7 @@ export const devUiCss = `
   .le-agent-list { list-style: none; margin: 0; padding: 0 8px; overflow-y: auto; flex: 1; min-height: 0; }
   .le-find { margin: 6px 16px 10px; font-size: 12.5px; font-weight: 500; color: var(--accent-ink); text-decoration: none; }
   .le-find[aria-current="page"] { font-weight: 600; }
+  .le-find + .le-find { margin-top: -4px; }
   .le-agent-item { display: grid; grid-template-columns: 8px minmax(0, 1fr) auto; align-items: center; gap: 10px; padding: 7px 8px; border-radius: 6px; color: var(--ink); text-decoration: none; }
   .le-agent-item:hover { background: var(--surface-2); }
   .le-agent-item[aria-current="page"] { background: var(--accent-soft); }

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

@@ -52,6 +52,9 @@ export interface CandidatePreview {
 /** What's still needed once the agent exists, each linked to where it's done. */
 export declare function setupChecklist(candidate: AgentCandidate, agentName: string): ChecklistItem[];
 export declare function previewCandidate(id: string, index: number, deps: Pick<CreateDeps, 'agentExists'>): CandidatePreview;
+/** What creating `candidate` would make, under the first free name.
+ * Shared with templates (web/templates-admin.ts). */
+export declare function describeCandidate(candidate: AgentCandidate, deps: Pick<CreateDeps, 'agentExists'>): CandidatePreview;
 export interface CreatedAgent {
     name: string;
     checklist: ChecklistItem[];
@@ -62,6 +65,11 @@ export interface CreatedAgent {
 /** Creates the agent: unmatched tools ask (a new agent's default is to
  * deny), and a schedule, if any, is created paused until setup is done. */
 export declare function createFromCandidate(id: string, index: number, deps: CreateDeps): Promise<CreatedAgent>;
+/** Creates `candidate` as an agent under the first free name: the agent
+ * itself, its permission default switched to "ask", and a paused
+ * schedule when it runs on a timer. Shared with templates
+ * (web/templates-admin.ts). */
+export declare function createAgentFromCandidate(candidate: AgentCandidate, deps: CreateDeps): Promise<CreatedAgent>;
 /** A registered agent, as the adapter's registry has it. */
 export interface InterviewAgentSource {
     name: string;
@@ -80,5 +88,9 @@ export interface InterviewModel {
  * agent that has one set, preferring one whose provider key is set.
  * undefined when no agent names a model. */
 export declare function pickInterviewModel(agents: InterviewAgentSource[]): InterviewModel | undefined;
+/** The model a new agent should start on: the same one the interviewer
+ * would pick, without building a model call (which throws when its key
+ * isn't set). Templates use it. */
+export declare function pickAgentModel(agents: InterviewAgentSource[]): InterviewModel['model'] | undefined;
 /** The interviewer's read-only tools over this workspace. */
 export declare function interviewTools(agents: InterviewAgentSource[]): InterviewTools;

package/dist/web/interview-admin.js

@@ -140,7 +140,11 @@ export function setupChecklist(candidate, agentName) {
     return items;
 }
 export function previewCandidate(id, index, deps) {
-    const candidate = candidateAt(getInterview(id), index);
+    return describeCandidate(candidateAt(getInterview(id), index), deps);
+}
+/** What creating `candidate` would make, under the first free name.
+ * Shared with templates (web/templates-admin.ts). */
+export function describeCandidate(candidate, deps) {
     const name = freeAgentName(candidate.agent.name, deps.agentExists);
     return {
         name,
@@ -159,33 +163,53 @@ export async function createFromCandidate(id, index, deps) {
         if (interview.created[String(index)] && deps.agentExists(interview.created[String(index)])) {
             throw new InterviewError(`Already created as ${interview.created[String(index)]}`);
         }
-        const name = freeAgentName(candidate.agent.name, deps.agentExists);
-        await deps.createAgent(name, candidate.agent.systemPrompt);
-        setDefaultDecision(name, 'ask');
-        let scheduleError;
-        if (candidate.trigger.kind === 'schedule') {
-            try {
-                const task = await createScheduledTask({
-                    agent: name,
-                    message: candidate.agent.scheduleMessage ?? candidate.summary,
-                    schedule: { every: candidate.trigger.every ?? '1d' },
-                    task_name: candidate.title,
-                });
-                await pauseScheduledTask(task.task_id);
-            }
-            catch (err) {
-                scheduleError = err instanceof Error ? err.message : String(err);
-            }
-        }
-        interview.created[String(index)] = name;
+        const created = await createAgentFromCandidate(candidate, deps);
+        interview.created[String(index)] = created.name;
         save(interview);
-        return { name, checklist: setupChecklist(candidate, name), ...(candidate.agent.exampleMessage ? { exampleMessage: candidate.agent.exampleMessage } : {}), ...(scheduleError ? { scheduleError } : {}) };
+        return created;
     });
 }
+/** Creates `candidate` as an agent under the first free name: the agent
+ * itself, its permission default switched to "ask", and a paused
+ * schedule when it runs on a timer. Shared with templates
+ * (web/templates-admin.ts). */
+export async function createAgentFromCandidate(candidate, deps) {
+    const name = freeAgentName(candidate.agent.name, deps.agentExists);
+    await deps.createAgent(name, candidate.agent.systemPrompt);
+    setDefaultDecision(name, 'ask');
+    let scheduleError;
+    if (candidate.trigger.kind === 'schedule') {
+        try {
+            const task = await createScheduledTask({
+                agent: name,
+                message: candidate.agent.scheduleMessage ?? candidate.summary,
+                schedule: { every: candidate.trigger.every ?? '1d' },
+                task_name: candidate.title,
+            });
+            await pauseScheduledTask(task.task_id);
+        }
+        catch (err) {
+            scheduleError = err instanceof Error ? err.message : String(err);
+        }
+    }
+    return { name, checklist: setupChecklist(candidate, name), ...(candidate.agent.exampleMessage ? { exampleMessage: candidate.agent.exampleMessage } : {}), ...(scheduleError ? { scheduleError } : {}) };
+}
 /** The interviewer runs on the workspace's own model: borrowed from an
  * agent that has one set, preferring one whose provider key is set.
  * undefined when no agent names a model. */
 export function pickInterviewModel(agents) {
+    const chosen = pickModelAgent(agents);
+    if (!chosen)
+        return undefined;
+    return { modelCall: chosen.agent.createModelCall(), model: chosen.model };
+}
+/** The model a new agent should start on: the same one the interviewer
+ * would pick, without building a model call (which throws when its key
+ * isn't set). Templates use it. */
+export function pickAgentModel(agents) {
+    return pickModelAgent(agents)?.model;
+}
+function pickModelAgent(agents) {
     const withModel = agents.filter((a) => a.config.model && typeof a.config.model === 'object' && 'provider' in a.config.model);
     const keyed = withModel.find((a) => {
         const envVar = modelKeyEnvVar(a.config.model.provider);
@@ -195,7 +219,7 @@ export function pickInterviewModel(agents) {
     if (!chosen)
         return undefined;
     const m = chosen.config.model;
-    return { modelCall: chosen.createModelCall(), model: { provider: m.provider, ...(m.model ? { model: m.model } : {}) } };
+    return { agent: chosen, model: { provider: m.provider, ...(m.model ? { model: m.model } : {}) } };
 }
 /** The interviewer's read-only tools over this workspace. */
 export function interviewTools(agents) {

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

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

@@ -0,0 +1,93 @@
+import { type StarterTemplate, type TemplateSchedule } from '../core/system-agents/templates.js';
+export declare class TemplateError extends Error {
+}
+export interface TemplateCreateDeps {
+    agentExists(name: string): boolean;
+    /** Writes agents/<name>/index.ts, as Agents → + New does, without loading it. */
+    scaffoldAgent(name: string, systemPrompt: string): Promise<void>;
+    /** Loads the finished agent into the running server. */
+    registerAgent(name: string): Promise<void>;
+    /** Installs an ability (an npm spec) into the agent. Absent where
+     * installing isn't allowed (no admin login): the abilities then head the
+     * checklist instead. */
+    installAbility?: (name: string, spec: string) => Promise<void>;
+    /** A setting as the agent sees it (its own, else the shared one). */
+    envValue(name: string, variable: string): string | undefined;
+    /** Whether approval requests from the agent reach anyone. */
+    messagingConfigured(name: string): boolean;
+}
+/** What a project's adapters/http.ts from before full template setups
+ * (create-loopengine 0.1.74) passes: one call that writes and loads the
+ * agent. Still accepted, so upgrading loopengine alone doesn't break the
+ * Templates page; it just can't install abilities before the agent loads. */
+export interface LegacyTemplateCreateDeps {
+    agentExists(name: string): boolean;
+    createAgent(name: string, systemPrompt: string): Promise<void>;
+}
+export interface TemplateChecklistItem {
+    label: string;
+    href?: string;
+}
+/** A template as the page's cards show it. */
+export interface TemplateSummary {
+    id: string;
+    category: string;
+    title: string;
+    summary: string;
+    trigger: string;
+    asksFirst: string[];
+    abilities: string[];
+    schedule: string | null;
+}
+export interface TemplatePreview {
+    name: string;
+    systemPrompt: string;
+    abilities: string[];
+    skills: string[];
+    rules: {
+        tool: string;
+        decision: string;
+    }[];
+    keys: {
+        names: string[];
+        set: boolean;
+    }[];
+    settings: Record<string, string>;
+    schedule: string | null;
+    needsApprovals: boolean;
+    notes: string[];
+}
+export interface CreatedTemplateAgent {
+    name: string;
+    abilities: {
+        installed: string[];
+        failed: {
+            name: string;
+            error: string;
+        }[];
+    };
+    checklist: TemplateChecklistItem[];
+    exampleMessage?: string;
+    schedule?: {
+        description: string;
+        next_run_at?: string;
+    };
+    /** Set when the schedule couldn't be created; the agent still was. */
+    scheduleError?: string;
+    /** Set when the agent was written but couldn't be loaded. */
+    loadError?: string;
+}
+/** A failed install, in a line the checklist can show: npm's own output
+ * runs to many lines of command and log paths. */
+export declare function installFailureReason(err: unknown): string;
+export declare function describeTemplateSchedule(schedule: TemplateSchedule): string;
+export declare function listTemplates(): TemplateSummary[];
+export declare function previewTemplate(id: string, deps: Pick<TemplateCreateDeps, 'agentExists'> & Partial<Pick<TemplateCreateDeps, 'envValue'>>): TemplatePreview;
+/** What's left once the agent exists, each linked to where it's done. */
+export declare function templateChecklist(template: StarterTemplate, name: string, deps: Pick<TemplateCreateDeps, 'envValue' | 'messagingConfigured'>, failed?: {
+    name: string;
+    error: string;
+}[]): TemplateChecklistItem[];
+/** Creates a new agent from the template, with its whole setup, under the
+ * first free name, so the same template can be used more than once. */
+export declare function createFromTemplate(id: string, deps: TemplateCreateDeps | LegacyTemplateCreateDeps): Promise<CreatedTemplateAgent>;

package/dist/web/templates-admin.js

@@ -0,0 +1,227 @@
+// Backs the console's Templates page (/templates): the ready-made agents
+// in core/system-agents/templates.ts, previewed and created with their
+// whole setup in one go — instructions, permission rules, abilities,
+// skills, settings and a paused schedule — before the agent first loads,
+// so nothing needs a restart. What only the person can do (their keys,
+// where approvals go, turning the schedule on) becomes the checklist.
+//
+// Every agent made from a template asks before anything not covered by a
+// rule. Its template's rules are written before its abilities' own, so
+// they take precedence where both name the same tool.
+import { createScheduledTask, pauseScheduledTask } from '../core/scheduler.js';
+import { STARTER_TEMPLATES, starterTemplate, templateScheduleStart } from '../core/system-agents/templates.js';
+import { ActauthRuleExistsError, addActauthRule, setDefaultDecision } from './actauth-admin.js';
+import { setAgentEnvVar } from './env-admin.js';
+import { freeAgentName } from './interview-admin.js';
+import { writeSkill } from './skills-admin.js';
+export class TemplateError extends Error {
+}
+/** A failed install, in a line the checklist can show: npm's own output
+ * runs to many lines of command and log paths. */
+export function installFailureReason(err) {
+    const text = err instanceof Error ? err.message : String(err);
+    if (/E404|404 Not Found|is not in this registry/i.test(text))
+        return "it isn't published on npm yet";
+    if (/ENOTFOUND|ECONNREFUSED|ETIMEDOUT|EAI_AGAIN/.test(text))
+        return 'npm could not be reached; try again from the Abilities tab';
+    const line = text.split('\n').map((l) => l.trim()).find((l) => l && !/^Command failed:/.test(l)) ?? text.split('\n')[0];
+    return line.length > 200 ? `${line.slice(0, 200)}…` : line;
+}
+function templateAt(id) {
+    const template = starterTemplate(id);
+    if (!template)
+        throw new TemplateError('No such template');
+    return template;
+}
+const UNITS = { s: ['second', 'seconds'], m: ['minute', 'minutes'], h: ['hour', 'hours'], d: ['day', 'days'] };
+const WEEKDAYS = ['Sundays', 'Mondays', 'Tuesdays', 'Wednesdays', 'Thursdays', 'Fridays', 'Saturdays'];
+export function describeTemplateSchedule(schedule) {
+    if (schedule.at && schedule.weekday !== undefined && schedule.every === '7d')
+        return `${WEEKDAYS[schedule.weekday]} at ${schedule.at}`;
+    if (schedule.at && schedule.every === '1d')
+        return `daily at ${schedule.at}`;
+    const match = /^(\d+)([smhd])$/.exec(schedule.every);
+    if (!match)
+        return `every ${schedule.every}`;
+    const n = Number(match[1]);
+    const [one, many] = UNITS[match[2]];
+    return `every ${n === 1 ? one : `${n} ${many}`}${schedule.at ? `, from ${schedule.at}` : ''}`;
+}
+export function listTemplates() {
+    return STARTER_TEMPLATES.map(({ id, category, candidate: c, setup }) => ({
+        id,
+        category,
+        title: c.title,
+        summary: c.summary,
+        trigger: setup.schedule ? describeTemplateSchedule(setup.schedule) : c.trigger.description,
+        asksFirst: c.asksFirst,
+        abilities: setup.abilities,
+        schedule: setup.schedule ? describeTemplateSchedule(setup.schedule) : null,
+    }));
+}
+function keyGroups(template) {
+    return template.setup.keys.map((k) => (Array.isArray(k) ? k : [k]));
+}
+export function previewTemplate(id, deps) {
+    const template = templateAt(id);
+    const name = freeAgentName(template.candidate.agent.name, deps.agentExists);
+    const envValue = deps.envValue ?? (() => undefined);
+    const { setup } = template;
+    return {
+        name,
+        systemPrompt: template.candidate.agent.systemPrompt,
+        abilities: setup.abilities,
+        skills: (setup.skills ?? []).map((s) => s.id),
+        rules: setup.rules.map((r) => ({ tool: r.tool, decision: r.decision })),
+        // A key set for the whole project already counts for a new agent.
+        keys: keyGroups(template).map((names) => ({ names, set: names.some((n) => Boolean(envValue(name, n))) })),
+        settings: setup.env ?? {},
+        schedule: setup.schedule ? `${describeTemplateSchedule(setup.schedule)} (created paused)` : null,
+        needsApprovals: setup.needsApprovals,
+        notes: setup.notes ?? [],
+    };
+}
+/** What's left once the agent exists, each linked to where it's done. */
+export function templateChecklist(template, name, deps, failed = []) {
+    const tab = (t) => `/agents/config?agent=${encodeURIComponent(name)}&tab=${t}`;
+    const items = [];
+    for (const f of failed)
+        items.push({ label: `Install the ${f.name} ability (it couldn't be installed: ${f.error})`, href: tab('abilities') });
+    const missing = keyGroups(template).filter((names) => !names.some((n) => deps.envValue(name, n)));
+    const single = missing.filter((g) => g.length === 1).map((g) => g[0]);
+    if (single.length)
+        items.push({ label: `Add ${single.length === 1 ? 'its key' : 'its keys'}: ${single.join(', ')}`, href: tab('env') });
+    for (const group of missing.filter((g) => g.length > 1)) {
+        items.push({ label: `Add one of ${group.slice(0, -1).join(', ')} or ${group.at(-1)}`, href: tab('env') });
+    }
+    if (template.setup.needsApprovals && !deps.messagingConfigured(name)) {
+        items.push({ label: 'Choose where approval requests go: Slack, email, Lark or a webhook', href: tab('messaging') });
+    }
+    for (const note of template.setup.notes ?? [])
+        items.push({ label: note });
+    if (template.setup.schedule) {
+        items.push({ label: `Turn on its schedule (${describeTemplateSchedule(template.setup.schedule)}) once it works in Chat`, href: tab('schedules') });
+    }
+    return items;
+}
+/** Creates a new agent from the template, with its whole setup, under the
+ * first free name, so the same template can be used more than once. */
+export async function createFromTemplate(id, deps) {
+    if (!('scaffoldAgent' in deps))
+        return createFromTemplateLegacy(id, deps);
+    const template = templateAt(id);
+    const { candidate, setup } = template;
+    const name = freeAgentName(candidate.agent.name, deps.agentExists);
+    // 1. The agent, and its permissions: everything asks unless a rule says
+    //    otherwise, and the template's rules come first.
+    await deps.scaffoldAgent(name, candidate.agent.systemPrompt);
+    setDefaultDecision(name, 'ask');
+    for (const rule of setup.rules) {
+        try {
+            addActauthRule(name, { name: rule.name, scope: '*/*', tool: rule.tool, decision: rule.decision });
+        }
+        catch (err) {
+            if (!(err instanceof ActauthRuleExistsError))
+                throw err;
+        }
+    }
+    // 2. Abilities: their tools, skills and rules. One failing doesn't stop
+    //    the rest; it heads the checklist.
+    const installed = [];
+    const failed = [];
+    for (const spec of setup.abilities) {
+        if (!deps.installAbility) {
+            failed.push({ name: spec, error: 'installing abilities needs LOOPENGINE_ADMIN_AUTH set on the server' });
+            continue;
+        }
+        try {
+            await deps.installAbility(name, spec);
+            installed.push(spec);
+        }
+        catch (err) {
+            failed.push({ name: spec, error: installFailureReason(err) });
+        }
+    }
+    // 3. Its own skills and non-secret settings.
+    for (const skill of setup.skills ?? [])
+        writeSkill(name, skill.id, { description: skill.description, body: skill.body });
+    for (const [variable, value] of Object.entries(setup.env ?? {}))
+        await setAgentEnvVar(name, variable, value);
+    // 4. Load it, now that everything is in place.
+    let loadError;
+    try {
+        await deps.registerAgent(name);
+    }
+    catch (err) {
+        loadError = err instanceof Error ? err.message : String(err);
+    }
+    // 5. Its schedule, paused until the person turns it on.
+    let schedule;
+    let scheduleError;
+    if (setup.schedule) {
+        try {
+            const startAt = templateScheduleStart(setup.schedule);
+            const task = await createScheduledTask({
+                agent: name,
+                message: setup.schedule.message,
+                schedule: { every: setup.schedule.every, ...(startAt ? { start_at: startAt } : {}) },
+                task_name: setup.schedule.name,
+            });
+            await pauseScheduledTask(task.task_id);
+            schedule = { description: describeTemplateSchedule(setup.schedule), ...(startAt ? { next_run_at: startAt } : {}) };
+        }
+        catch (err) {
+            scheduleError = err instanceof Error ? err.message : String(err);
+        }
+    }
+    return {
+        name,
+        abilities: { installed, failed },
+        checklist: templateChecklist(template, name, deps, failed),
+        ...(candidate.agent.exampleMessage ? { exampleMessage: candidate.agent.exampleMessage } : {}),
+        ...(schedule ? { schedule } : {}),
+        ...(scheduleError ? { scheduleError } : {}),
+        ...(loadError ? { loadError } : {}),
+    };
+}
+/** An older project adapter's create: the agent with its instructions,
+ * permissions and paused schedule, as before; its abilities head the
+ * checklist with how to get them installed automatically. */
+async function createFromTemplateLegacy(id, deps) {
+    const template = templateAt(id);
+    const { candidate, setup } = template;
+    const name = freeAgentName(candidate.agent.name, deps.agentExists);
+    await deps.createAgent(name, candidate.agent.systemPrompt);
+    setDefaultDecision(name, 'ask');
+    for (const rule of setup.rules) {
+        try {
+            addActauthRule(name, { name: rule.name, scope: '*/*', tool: rule.tool, decision: rule.decision });
+        }
+        catch (err) {
+            if (!(err instanceof ActauthRuleExistsError))
+                throw err;
+        }
+    }
+    const failed = setup.abilities.map((spec) => ({ name: spec, error: "this project's server is from an older LoopEngine template; update it from Settings → Upgrade to have templates install abilities" }));
+    let schedule;
+    let scheduleError;
+    if (setup.schedule) {
+        try {
+            const startAt = templateScheduleStart(setup.schedule);
+            const task = await createScheduledTask({ agent: name, message: setup.schedule.message, schedule: { every: setup.schedule.every, ...(startAt ? { start_at: startAt } : {}) }, task_name: setup.schedule.name });
+            await pauseScheduledTask(task.task_id);
+            schedule = { description: describeTemplateSchedule(setup.schedule), ...(startAt ? { next_run_at: startAt } : {}) };
+        }
+        catch (err) {
+            scheduleError = err instanceof Error ? err.message : String(err);
+        }
+    }
+    return {
+        name,
+        abilities: { installed: [], failed },
+        checklist: templateChecklist(template, name, { envValue: () => undefined, messagingConfigured: () => false }, failed),
+        ...(candidate.agent.exampleMessage ? { exampleMessage: candidate.agent.exampleMessage } : {}),
+        ...(schedule ? { schedule } : {}),
+        ...(scheduleError ? { scheduleError } : {}),
+    };
+}

package/dist/web/templates-page.d.ts

@@ -0,0 +1 @@
+export declare const templatesPageHtml: string;