loopengine 0.1.91 → 0.1.92

package/README.md

@@ -205,6 +205,14 @@ first, and a paused schedule if it runs on a timer, plus a checklist of
 what's left to connect. The interviewer runs on the model of one of your
 agents, can't see your systems, and creates nothing until you click.
 
+Or skip the interview: **Templates** (`/templates`, linked from the
+sidebar and the Agents page) are ready-made agents: answer customer
+emails, triage incidents, check expense claims, and a weekly research
+digest. Preview one's instructions and setup checklist, then create it
+the same way, as many times as you like. Templates live in
+`core/system-agents/templates.ts`, in the same shape the interview
+suggests.
+
 Every notification links to a **decision page**: a signed, single-use
 link (`/decide/<token>`, valid 7 days) where whoever got the message can
 approve, deny, edit the arguments or answer a question, with no login and

package/dist/bin/cli.js

@@ -37,9 +37,10 @@ const MODEL_ENV_VAR = {
 // literal in generated code — an operator-supplied systemPrompt (from
 // the admin UI's Create new agent form, say) containing a literal quote
 // or backslash would otherwise produce invalid, or silently different,
-// generated TypeScript.
+// generated TypeScript. Line breaks too: a multi-line prompt (from a
+// template or the interview) would otherwise end the literal mid-line.
 function tsStringLiteral(value) {
-    return "'" + value.replace(/\\/g, '\\\\').replace(/'/g, "\\'") + "'";
+    return "'" + value.replace(/\\/g, '\\\\').replace(/'/g, "\\'").replace(/\r/g, '\\r').replace(/\n/g, '\\n') + "'";
 }
 /** 'loopengine' for a real consumer project — the only thing that ever
  * resolves once this package is genuinely installed as a dependency. A

package/dist/core/system-agents/templates.d.ts

@@ -0,0 +1,10 @@
+import type { AgentCandidate } from './interviewer.js';
+export interface StarterTemplate {
+    /** Stable id, used in URLs: lowercase-hyphenated. */
+    id: string;
+    /** Groups templates on the page: "Customer service", "Operations"… */
+    category: string;
+    candidate: AgentCandidate;
+}
+export declare const STARTER_TEMPLATES: readonly StarterTemplate[];
+export declare function starterTemplate(id: string): StarterTemplate | undefined;

package/dist/core/system-agents/templates.js

@@ -0,0 +1,146 @@
+export const STARTER_TEMPLATES = [
+    {
+        id: 'customer-email-replies',
+        category: 'Customer service',
+        candidate: {
+            title: 'Answer customer emails',
+            summary: 'Reads each new customer email, looks up what it needs, and drafts a reply. Routine answers go out once you allow them; refunds and anything unusual wait for you.',
+            trigger: { kind: 'event', description: 'each new customer email' },
+            hoursPerWeek: 5,
+            fit: 7,
+            risk: 'medium',
+            asksFirst: ['sending a reply', 'refunds', 'discounts'],
+            needs: [
+                { kind: 'api', name: 'Email', description: 'your support inbox' },
+                { kind: 'ability', name: 'lp-docs-search', description: 'your help articles and policies, so replies follow them' },
+                { kind: 'messaging', name: 'Slack', description: 'Slack, to approve replies and refunds' },
+            ],
+            agent: {
+                name: 'customer-email-replies',
+                systemPrompt: `You answer customer emails for our business.
+
+For each email:
+1. Work out what the customer wants: order status, a product question, a return or refund, a complaint, or something else.
+2. Look up what you need before answering, such as the order, its shipping status, or our policies. Never guess an order detail, a date or a policy.
+3. Draft a short, friendly reply in the customer's language. Use their name, answer the question first, and say what happens next.
+4. Send it with the email tool.
+
+Rules:
+- Refunds, discounts, replacements and anything that costs money: draft it, explain your reasoning in one line, and let a person approve it.
+- If the customer is angry, mentions a lawyer, a chargeback or a safety problem, don't promise anything; draft a calm reply for a person to review.
+- If you can't find the order or the answer, say so in the draft rather than inventing one.
+- Never share another customer's information.`,
+                exampleMessage: 'New email from Sam Lee: "Hi, my order #1042 still hasn\'t arrived and it\'s been 10 days. Where is it?"',
+            },
+        },
+    },
+    {
+        id: 'incident-triage',
+        category: 'Operations',
+        candidate: {
+            title: 'Triage incidents',
+            summary: 'Takes an alert or a bug report, works out what broke and how bad it is, finds related recent changes, and proposes the next step for the on-call person to approve.',
+            trigger: { kind: 'on_request', description: 'when an alert or report is passed to it in Chat or Slack' },
+            hoursPerWeek: 3,
+            fit: 6,
+            risk: 'medium',
+            asksFirst: ['opening or changing issues', 'posting to channels', 'any action on a system'],
+            needs: [
+                { kind: 'api', name: 'GitHub', description: 'GitHub or your issue tracker' },
+                { kind: 'messaging', name: 'Slack', description: 'Slack, so on-call can approve from the alert thread' },
+            ],
+            agent: {
+                name: 'incident-triage',
+                systemPrompt: `You help the on-call engineer triage incidents.
+
+When you get an alert, error or bug report:
+1. Summarise it in two sentences: what is failing and who is affected.
+2. Rate the severity: SEV1 (customers can't use the product), SEV2 (a major feature is broken), SEV3 (degraded or a workaround exists), SEV4 (minor).
+3. Look for likely causes: recent deploys, merged changes and open issues touching the same area. List the top two or three with links.
+4. Propose one next step: who should look, what to check first, and whether to roll back.
+
+Rules:
+- Only read on your own. Opening or editing an issue, posting to a channel, paging someone or any rollback needs a person's approval.
+- Say how sure you are. If the evidence is thin, say what would confirm it instead of guessing.
+- Keep the summary short enough to read on a phone.`,
+                exampleMessage: 'Alert: checkout-api error rate 18% (normally under 1%) since 14:05 UTC. Errors: "timeout connecting to payments".',
+            },
+        },
+    },
+    {
+        id: 'expense-approvals',
+        category: 'Finance',
+        candidate: {
+            title: 'Check expense claims',
+            summary: 'Reads each expense claim and its receipt, checks it against your policy, and routes it: claims within policy are prepared for approval, anything outside policy is flagged with the reason.',
+            trigger: { kind: 'event', description: 'each new expense claim' },
+            hoursPerWeek: 3,
+            fit: 7,
+            risk: 'high',
+            asksFirst: ['approving a claim', 'paying anything out', 'replying to the claimant'],
+            needs: [
+                { kind: 'api', name: 'Email', description: 'the inbox or form where claims arrive' },
+                { kind: 'ability', name: 'lp-docs-search', description: 'your expense policy, so checks follow it' },
+                { kind: 'messaging', name: 'Slack', description: 'Slack, so approvers decide in one click' },
+            ],
+            agent: {
+                name: 'expense-approvals',
+                systemPrompt: `You check expense claims against our expense policy.
+
+For each claim:
+1. Read the amount, currency, date, merchant, category and who submitted it, from the claim and its receipt.
+2. Check it against the policy: the category is allowed, it's under the limit, the receipt matches the amount and date, and it isn't a duplicate of an earlier claim.
+3. Write a one-line verdict: "Within policy" or "Outside policy: <reason>", followed by the details you checked.
+4. Send the verdict to the approver. Within-policy claims are prepared for approval; outside-policy ones are flagged.
+
+Rules:
+- Never approve or pay a claim yourself. A person always decides.
+- If the receipt is missing or unreadable, say so and ask the claimant for it; don't fill in values.
+- If the policy doesn't cover the case, say which part is unclear rather than deciding.`,
+                exampleMessage: 'New claim from Priya: client dinner, Bistro 21, 2026-10-20, $186.40 for 3 people. Receipt attached.',
+            },
+        },
+    },
+    {
+        id: 'weekly-research-digest',
+        category: 'Research',
+        candidate: {
+            title: 'Weekly research digest',
+            summary: 'Once a week, searches the web for news on the topics you choose and writes a short digest with links.',
+            trigger: { kind: 'schedule', description: 'once a week', every: '7d' },
+            hoursPerWeek: 2,
+            fit: 6,
+            risk: 'low',
+            asksFirst: ['sending the digest to anyone'],
+            needs: [
+                { kind: 'ability', name: 'lp-web-search', description: 'web search' },
+                { kind: 'key', name: 'TAVILY_API_KEY', description: 'a web search key (Tavily, Brave or Firecrawl)' },
+            ],
+            agent: {
+                name: 'weekly-research-digest',
+                systemPrompt: `You write a weekly research digest.
+
+Topics to follow (edit this list):
+- [Your industry or market]
+- [Competitors, by name]
+- [Technologies or regulations you care about]
+
+Each week:
+1. Search the web for what happened in the last 7 days on each topic.
+2. Open the most relevant pages and read them; don't rely on search snippets.
+3. Write the digest: for each topic, up to three items, each with a one-sentence summary, why it matters to us, and the link.
+4. End with "Worth a closer look": the single most important item, and why.
+
+Rules:
+- Only include things published in the last 7 days, and give each item's date.
+- Prefer original sources over aggregators. Never invent a link.
+- If a topic had no real news, say so in one line.`,
+                scheduleMessage: 'Write this week\'s research digest.',
+                exampleMessage: 'Write this week\'s research digest.',
+            },
+        },
+    },
+];
+export function starterTemplate(id) {
+    return STARTER_TEMPLATES.find((t) => t.id === id);
+}

package/dist/index.d.ts

@@ -71,8 +71,11 @@ export type { HttpToolSpec, HttpToolField } from './web/http-tool-admin.js';
 export { agentsConfigPageHtml } from './web/agents-config-page.js';
 export { agentsListPageHtml } from './web/agents-list-page.js';
 export { interviewPageHtml } from './web/interview-page.js';
-export { InterviewError, answerInterview, createFromCandidate, deleteInterview, finishInterview, getInterview, interviewTools, listInterviews, pickInterviewModel, previewCandidate, startInterview, setInterviewProject, setupChecklist, type Interview, type InterviewAgentSource, type CandidatePreview, type CreatedAgent, type ChecklistItem, } from './web/interview-admin.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 { globalConfigPageHtml } from './web/global-config-page.js';
 export { playgroundHtml } from './web/playground.js';
 export { readSkill, writeSkill, deleteSkill, SkillInvalidIdError, SkillNotFoundError } from './web/skills-admin.js';

package/dist/index.js

@@ -66,8 +66,11 @@ export { createHttpTool, updateHttpTool, readHttpToolSpec, listEditableHttpToolN
 export { agentsConfigPageHtml } from './web/agents-config-page.js';
 export { agentsListPageHtml } from './web/agents-list-page.js';
 export { interviewPageHtml } from './web/interview-page.js';
-export { InterviewError, answerInterview, createFromCandidate, deleteInterview, finishInterview, getInterview, interviewTools, listInterviews, pickInterviewModel, previewCandidate, startInterview, setInterviewProject, setupChecklist, } from './web/interview-admin.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 { globalConfigPageHtml } from './web/global-config-page.js';
 export { playgroundHtml } from './web/playground.js';
 export { readSkill, writeSkill, deleteSkill, SkillInvalidIdError, SkillNotFoundError } from './web/skills-admin.js';

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/templates-admin.d.ts

@@ -0,0 +1,19 @@
+import { type CandidatePreview, type CreateDeps, type CreatedAgent } from './interview-admin.js';
+export declare class TemplateError extends Error {
+}
+/** A template as the page's cards show it. */
+export interface TemplateSummary {
+    id: string;
+    category: string;
+    title: string;
+    summary: string;
+    trigger: string;
+    asksFirst: string[];
+    needs: string[];
+    schedule: boolean;
+}
+export declare function listTemplates(): TemplateSummary[];
+export declare function previewTemplate(id: string, deps: Pick<CreateDeps, 'agentExists'>): CandidatePreview;
+/** Creates a new agent from the template, under the first free name, so
+ * the same template can be used more than once. */
+export declare function createFromTemplate(id: string, deps: CreateDeps): Promise<CreatedAgent>;

package/dist/web/templates-admin.js

@@ -0,0 +1,37 @@
+// Backs the console's Templates page (/templates): the ready-made agents
+// in core/system-agents/templates.ts, previewed and created the same way
+// as a "Find your first agent" suggestion (web/interview-admin.ts), so a
+// template agent starts exactly like one: its instructions, every tool
+// asking first, a paused schedule when it runs on a timer, and a Finish
+// setup checklist. Unlike the interview it needs no model call, so it
+// works before any agent has a model or key.
+import { STARTER_TEMPLATES, starterTemplate } from '../core/system-agents/templates.js';
+import { createAgentFromCandidate, describeCandidate } from './interview-admin.js';
+export class TemplateError extends Error {
+}
+function templateAt(id) {
+    const template = starterTemplate(id);
+    if (!template)
+        throw new TemplateError('No such template');
+    return template;
+}
+export function listTemplates() {
+    return STARTER_TEMPLATES.map(({ id, category, candidate: c }) => ({
+        id,
+        category,
+        title: c.title,
+        summary: c.summary,
+        trigger: c.trigger.description,
+        asksFirst: c.asksFirst,
+        needs: c.needs.map((n) => (n.kind === 'key' ? n.description : n.name ?? n.description)),
+        schedule: c.trigger.kind === 'schedule',
+    }));
+}
+export function previewTemplate(id, deps) {
+    return describeCandidate(templateAt(id).candidate, deps);
+}
+/** Creates a new agent from the template, under the first free name, so
+ * the same template can be used more than once. */
+export async function createFromTemplate(id, deps) {
+    return createAgentFromCandidate(templateAt(id).candidate, deps);
+}

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

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

package/dist/web/templates-page.js

@@ -0,0 +1,130 @@
+// The console's Templates page (/templates): ready-made agents
+// (core/system-agents/templates.ts) a person can preview and create in
+// one click (web/templates-admin.ts behind /starter-templates/*). Same
+// shell and styles as the other console pages. Like them, its inline
+// script avoids backslashes and template placeholders, since it lives
+// inside a template literal.
+import { devUiCss } from './dev-ui-styles.js';
+import { consoleShellScript, consoleSidebarHtml } from './console-shell.js';
+export const templatesPageHtml = `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Templates</title>
+<style>${devUiCss}
+  .tp-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(300px, 1fr)); gap: 12px; max-width: 1000px; }
+  .tp-card { border: 1px solid var(--line); border-radius: var(--radius); padding: 14px 16px; display: grid; gap: 8px; align-content: start; }
+  .tp-card h3 { margin: 0; font-size: 15px; }
+  .tp-cat { justify-self: start; font-size: 11.5px; font-weight: 600; color: var(--ink-muted); background: var(--surface); padding: 2px 8px; border-radius: 999px; }
+  .tp-card .meta { font-size: 12.5px; color: var(--ink-muted); display: grid; gap: 4px; }
+  .tp-card .row { display: flex; gap: 8px; flex-wrap: wrap; }
+  .tp-preview { border-top: 1px solid var(--line); padding-top: 10px; display: grid; gap: 8px; font-size: 13px; }
+  .tp-preview pre { white-space: pre-wrap; max-height: 220px; overflow: auto; margin: 0; }
+  .tp-btn { display: inline-block; padding: 6px 12px; border-radius: 6px; text-decoration: none; font-size: 13px; font-weight: 500; background: var(--accent); color: var(--on-accent); }
+  .tp-btn.plain { background: none; color: var(--ink); border: 1px solid var(--line); }
+  .hint { font-size: 12px; color: var(--ink-muted); }
+  .error { font-size: 13px; color: var(--bad); }
+</style>
+</head>
+<body data-le-page="templates">
+<div class="le-app">
+${consoleSidebarHtml}
+<main class="le-main">
+  <div class="le-head plain">
+    <div class="le-head-row">
+      <div class="le-title"><button type="button" class="le-menu-btn" data-le-menu aria-label="Open navigation">&#9776;</button>
+        <div><h1>Templates</h1><p>Ready-made agents to start from. Each one asks you before it sends, pays, changes or deletes anything.</p></div>
+      </div>
+    </div>
+  </div>
+  <div class="le-scroll"><div class="le-page" id="tpPage"><p class="hint">Loading&hellip;</p></div></div>
+</main>
+</div>
+${consoleShellScript}
+<script>
+(function () {
+  var page = document.getElementById('tpPage');
+  var ELLIPSIS = String.fromCharCode(8230);
+
+  function esc(s) {
+    return String(s == null ? '' : s).replace(/[&<>"']/g, function (c) {
+      return { '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[c];
+    });
+  }
+  function api(method, path) {
+    return fetch(path, { method: method, cache: 'no-store' })
+      .then(function (r) { return r.json().then(function (j) { return { ok: r.ok, body: j }; }); });
+  }
+  function checklistHtml(items) {
+    if (!items.length) return '<p>Nothing else to set up.</p>';
+    return '<ul style="margin:0;padding-left:18px">' + items.map(function (it) {
+      return '<li>' + (it.href ? '<a href="' + esc(it.href) + '">' + esc(it.label) + '</a>' : esc(it.label)) + '</li>';
+    }).join('') + '</ul>';
+  }
+
+  function cardHtml(t) {
+    return '<div class="tp-card" data-id="' + esc(t.id) + '">' +
+      '<span class="tp-cat">' + esc(t.category) + '</span>' +
+      '<h3>' + esc(t.title) + '</h3>' +
+      '<div>' + esc(t.summary) + '</div>' +
+      '<div class="meta">' +
+        '<div><strong>Starts:</strong> ' + esc(t.trigger) + '</div>' +
+        (t.asksFirst.length ? '<div><strong>Asks you first:</strong> ' + esc(t.asksFirst.join(', ')) + '</div>' : '') +
+        (t.needs.length ? '<div><strong>Needs:</strong> ' + esc(t.needs.join(', ')) + '</div>' : '') +
+      '</div>' +
+      '<div class="row"><button type="button" class="primary tp-use">Use this template</button></div>' +
+      '<div class="tp-slot"></div></div>';
+  }
+
+  function show() {
+    api('GET', '/starter-templates').then(function (r) {
+      if (!r.ok) { page.innerHTML = '<p class="error">' + esc(r.body.error || 'Could not load the templates') + '</p>'; return; }
+      page.innerHTML = '<div class="tp-grid">' + r.body.templates.map(cardHtml).join('') + '</div>' +
+        '<p class="hint" style="margin-top:16px">Not what you need? <a href="/interview">Find your first agent</a> suggests one from your own work, or <a href="/agents?new=1">start from a blank agent</a>.</p>';
+      Array.prototype.forEach.call(page.querySelectorAll('.tp-use'), function (btn) {
+        btn.addEventListener('click', function () { preview(btn.closest('.tp-card')); });
+      });
+    });
+  }
+
+  function preview(card) {
+    var id = card.getAttribute('data-id');
+    var slot = card.querySelector('.tp-slot');
+    slot.innerHTML = '<p class="hint">Loading' + ELLIPSIS + '</p>';
+    api('GET', '/starter-templates/' + encodeURIComponent(id) + '/preview').then(function (r) {
+      if (!r.ok) { slot.innerHTML = '<p class="error">' + esc(r.body.error || 'Could not prepare it') + '</p>'; return; }
+      var p = r.body;
+      slot.innerHTML = '<div class="tp-preview">' +
+        '<div><strong>Agent:</strong> <code>' + esc(p.name) + '</code></div>' +
+        '<div><strong>Instructions</strong> <span class="hint">(edit them later in its Overview tab)</span><pre>' + esc(p.systemPrompt) + '</pre></div>' +
+        '<div><strong>Permissions:</strong> ' + esc(p.permissions) + '</div>' +
+        (p.schedule ? '<div><strong>Schedule:</strong> ' + esc(p.schedule) + '</div>' : '') +
+        '<div><strong>Then, to finish setup:</strong>' + checklistHtml(p.checklist) + '</div>' +
+        '<div class="row"><button type="button" class="primary tp-create">Create it</button><button type="button" class="tp-cancel">Cancel</button></div>' +
+        '<div class="hint tp-status"></div></div>';
+      slot.querySelector('.tp-cancel').addEventListener('click', function () { slot.innerHTML = ''; });
+      slot.querySelector('.tp-create').addEventListener('click', function (ev) {
+        var btn = ev.currentTarget;
+        btn.disabled = true;
+        slot.querySelector('.tp-status').textContent = 'Creating' + ELLIPSIS;
+        api('POST', '/starter-templates/' + encodeURIComponent(id) + '/create').then(function (r2) {
+          if (!r2.ok) { btn.disabled = false; slot.querySelector('.tp-status').textContent = r2.body.error || 'Could not create it'; return; }
+          var c = r2.body;
+          slot.innerHTML = '<div class="tp-preview">' +
+            '<div><strong>Created <code>' + esc(c.name) + '</code>.</strong> It asks you before every tool until you change that in its Permissions tab.</div>' +
+            (c.scheduleError ? '<div class="error">Its schedule wasn' + String.fromCharCode(8217) + 't created: ' + esc(c.scheduleError) + '. Add one in its Schedules tab.</div>' : '') +
+            '<div><strong>Finish setup:</strong>' + checklistHtml(c.checklist) + '</div>' +
+            (c.exampleMessage ? '<div><strong>Try it</strong> in Chat with: <em>' + esc(c.exampleMessage) + '</em></div>' : '') +
+            '<div class="row"><a class="tp-btn" href="/agents/config?agent=' + encodeURIComponent(c.name) + '">Open ' + esc(c.name) + '</a>' +
+            '<a class="tp-btn plain" href="' + esc(leShell.tabHref(c.name, 'chat')) + '">Try it in Chat</a></div></div>';
+        }).catch(function () { btn.disabled = false; slot.querySelector('.tp-status').textContent = 'Could not reach the server; try again.'; });
+      });
+    });
+  }
+
+  show();
+})();
+</script>
+</body>
+</html>`;

package/package.json

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