loopengine 0.3.10 → 0.3.11

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

@@ -71,6 +71,10 @@ export interface StarterTemplate {
     candidate: AgentCandidate;
     setup: TemplateSetup;
 }
+/** @deprecated Templates are now workflow examples
+ * (./workflow-examples.ts). Kept for a project server from an older
+ * template, whose Templates page still lists these: each example as the
+ * template it creates as a new agent. */
 export declare const STARTER_TEMPLATES: readonly StarterTemplate[];
 export declare function starterTemplate(id: string): StarterTemplate | undefined;
 /** The first run of a template's schedule: its time of day (and weekday)

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

@@ -1,452 +1,24 @@
 import { nextTimeOfDay, parseTimeOfDay, workspaceTimeZone } from '../time-zone.js';
-const GMAIL_KEYS = ['GMAIL_CLIENT_ID', 'GMAIL_CLIENT_SECRET', 'GMAIL_REFRESH_TOKEN'];
-const SHOPIFY_KEYS = ['SHOPIFY_STORE_DOMAIN', 'SHOPIFY_ADMIN_TOKEN'];
-const GITHUB_APP = 'io.github.github/github-mcp-server';
-const FIRECRAWL_APP = 'io.github.firecrawl/firecrawl-mcp-server';
-const policiesNote = (what, skill) => `Write ${what} into its ${skill} skill (Advanced → Skills): the agent answers from it and nothing else`;
-export const STARTER_TEMPLATES = [
-    {
-        id: 'customer-email-replies',
-        category: 'Customer service',
-        candidate: {
-            title: 'Answer customer emails',
-            summary: 'Checks the support inbox every 10 minutes, looks up each customer\'s order, and replies. Every reply waits for your approval until you trust it; refund requests are left for a person.',
-            trigger: { kind: 'schedule', description: 'every 10 minutes, for new emails', every: '10m' },
-            hoursPerWeek: 5,
-            fit: 7,
-            risk: 'medium',
-            asksFirst: ['sending a reply'],
-            needs: [
-                { kind: 'ability', name: '@loopengine-co/gmail', description: 'your support inbox' },
-                { kind: 'ability', name: '@loopengine-co/shopify', description: 'your store\'s orders' },
-                { kind: 'other', name: 'Your policies', description: 'shipping, returns and the rest, in its support-policies skill' },
-            ],
-            agent: {
-                name: 'customer-email-replies',
-                systemPrompt: `You answer customer emails for our business, from our support inbox.
-
-When asked to handle new emails:
-1. Find them with gmail_search, query "is:unread in:inbox". Skip newsletters, receipts, automatic notifications and "no-reply" senders: mark those read and move on.
-2. For each customer email, read the whole conversation with gmail_get_thread first.
-3. Work out what they want: order status, a product question, a return or refund, a complaint, or something else.
-4. Look up what you need before answering: the order with shopify_find_orders (by the order number they give, or their email) and shopify_get_order, and our policies in the support-policies skill (open it with Skill). Never guess an order detail, a date or a policy.
-5. Reply with gmail_send, passing reply_to_message_id so it stays in the same thread: short, friendly, in the customer's language, using their name, answering the question first and saying what happens next.
-6. Mark the email read with gmail_modify_labels (remove "UNREAD").
-
-Rules:
-- Refunds, returns and replacements are handled by a person: reply that their request has been passed to the team, then star the email (add "STARRED") instead of acting on it.
-- If the customer is angry, mentions a lawyer, a chargeback or a safety problem, don't promise anything; save a calm reply with gmail_create_draft and star the email for a person.
-- If you can't find the order or the answer, say so and ask for the order number; don't invent one.
-- Never share one customer's information with anyone else.`,
-                scheduleMessage: 'Handle new customer emails in the support inbox.',
-                exampleMessage: 'Handle new customer emails in the support inbox.',
-            },
-        },
-        setup: {
-            abilities: ['@loopengine-co/gmail', '@loopengine-co/shopify'],
-            keys: [...GMAIL_KEYS, ...SHOPIFY_KEYS],
-            skills: [{
-                    id: 'support-policies',
-                    description: 'Our shipping, returns, refunds and other customer policies. Read it before telling a customer anything about a policy.',
-                    body: `# Our customer policies
-
-Edit this: replace each [bracket] with your own policy. The agent answers customers from this and nothing else.
-
-## Shipping
-- Where we ship: [countries]
-- How long it takes: [e.g. 3–5 business days]
-- Tracking: [when and how customers get it]
-
-## Returns and refunds
-- Return window: [e.g. 30 days from delivery]
-- What can't be returned: [e.g. sale items, opened cosmetics]
-- How refunds are paid: [e.g. to the original payment method, in 5–10 business days]
-
-## Other questions
-- [Order changes and cancellations]
-- [Warranty]
-- [Anything customers often ask]
-`,
-                }],
-            rules: [
-                { name: 'template-read-mail-allowed', tool: 'gmail_search', decision: 'allow' },
-                { name: 'template-read-thread-allowed', tool: 'gmail_get_thread', decision: 'allow' },
-                { name: 'template-drafts-allowed', tool: 'gmail_create_draft', decision: 'allow' },
-                { name: 'template-labels-allowed', tool: 'gmail_modify_labels', decision: 'allow' },
-                { name: 'template-replies-need-approval', tool: 'gmail_send', decision: 'ask' },
-                { name: 'template-no-refunds', tool: 'shopify_create_refund', decision: 'deny' },
-            ],
-            schedule: { every: '10m', name: 'Check the support inbox', message: 'Handle new customer emails in the support inbox.' },
-            needsApprovals: true,
-            notes: [policiesNote('your policies', 'support-policies')],
-        },
-    },
-    {
-        id: 'refund-approvals',
-        category: 'Customer service',
-        candidate: {
-            title: 'Refund approvals',
-            summary: 'Checks the inbox for refund and return requests, checks each against the order and your return policy, and proposes the refund and the reply. Both wait for your approval.',
-            trigger: { kind: 'schedule', description: 'every 10 minutes, for new refund requests', every: '10m' },
-            hoursPerWeek: 3,
-            fit: 7,
-            risk: 'high',
-            asksFirst: ['issuing a refund', 'sending the reply'],
-            needs: [
-                { kind: 'ability', name: '@loopengine-co/gmail', description: 'your support inbox' },
-                { kind: 'ability', name: '@loopengine-co/shopify', description: 'your store\'s orders and refunds' },
-                { kind: 'other', name: 'Your return policy', description: 'in its return-policy skill' },
-            ],
-            agent: {
-                name: 'refund-approvals',
-                systemPrompt: `You handle refund and return requests for our store, from our support inbox.
-
-When asked to handle new refund requests:
-1. Find them with gmail_search, query "is:unread in:inbox (refund OR return OR damaged OR broken OR "money back")". Read each conversation with gmail_get_thread. If an email isn't really a refund or return request, leave it unread for the support team.
-2. Find the order with shopify_find_orders (the order number they give, or their email) and read it with shopify_get_order: what was bought, when, how much, what's already been refunded, whether it was delivered.
-3. Check the request against our return policy in the return-policy skill (open it with Skill): the return window, whether the item is eligible, and whether the reason is covered.
-4. Decide what to propose: a full refund, a partial refund, refunding shipping, or no refund (and which part of the policy says so).
-5. Work out the exact amount with shopify_preview_refund. Never state an amount you haven't previewed.
-6. Issue it with shopify_create_refund, with a note giving the policy rule and the facts from the order. A person approves it first.
-7. Once the refund is done, reply with gmail_send (reply_to_message_id set): what was refunded, to which payment method, and that it takes 5–10 business days to arrive. Then mark the email read with gmail_modify_labels.
-
-Rules:
-- Never refund more than was paid, and never refund an order twice: check refunds on the order first.
-- If the refund is denied, don't try again; save a reply with gmail_create_draft explaining what you'd suggest instead, and star the email for a person.
-- If the order can't be found, ask the customer for the order number; don't guess.
-- If the customer mentions a chargeback, a lawyer or a safety problem, don't act; star the email for a person.`,
-                scheduleMessage: 'Handle new refund and return requests in the support inbox.',
-                exampleMessage: 'Handle new refund and return requests in the support inbox.',
-            },
-        },
-        setup: {
-            abilities: ['@loopengine-co/gmail', '@loopengine-co/shopify'],
-            keys: [...GMAIL_KEYS, ...SHOPIFY_KEYS],
-            skills: [{
-                    id: 'return-policy',
-                    description: 'Our return and refund policy: the window, what qualifies, and how much is refunded. Read it before proposing any refund.',
-                    body: `# Our return policy
-
-Edit this: replace each [bracket] with your own policy. The agent proposes refunds from this and nothing else.
-
-- Return window: [e.g. 30 days from delivery]
-- Eligible items: [e.g. unused, in the original packaging]
-- Not eligible: [e.g. sale items, gift cards, personalised items]
-- Damaged or wrong items: [e.g. full refund including shipping, no return needed]
-- Change of mind: [e.g. refund of the item price, customer pays return shipping]
-- Shipping costs: [when they're refunded]
-- Partial refunds: [when you offer one, and how much]
-`,
-                }],
-            rules: [
-                { name: 'template-read-mail-allowed', tool: 'gmail_search', decision: 'allow' },
-                { name: 'template-read-thread-allowed', tool: 'gmail_get_thread', decision: 'allow' },
-                { name: 'template-drafts-allowed', tool: 'gmail_create_draft', decision: 'allow' },
-                { name: 'template-labels-allowed', tool: 'gmail_modify_labels', decision: 'allow' },
-                { name: 'template-preview-allowed', tool: 'shopify_preview_refund', decision: 'allow' },
-                { name: 'template-refunds-need-approval', tool: 'shopify_create_refund', decision: 'ask' },
-                { name: 'template-replies-need-approval', tool: 'gmail_send', decision: 'ask' },
-            ],
-            schedule: { every: '10m', name: 'Check for refund requests', message: 'Handle new refund and return requests in the support inbox.' },
-            needsApprovals: true,
-            notes: [policiesNote('your return policy', 'return-policy')],
-        },
-    },
-    {
-        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 the deploys and changes that likely caused it, and sends a summary to Slack. Opening or commenting on issues waits for approval.',
-            trigger: { kind: 'event', description: 'when your alerting tool calls its webhook, or someone passes it an alert in Chat or Slack' },
-            hoursPerWeek: 3,
-            fit: 6,
-            risk: 'medium',
-            asksFirst: ['opening or commenting on issues'],
-            needs: [
-                { kind: 'app', name: 'GitHub', description: 'your repository\'s commits, deploys and issues' },
-                { kind: 'messaging', name: 'Slack', description: 'where each summary is sent (its Messaging tab)' },
-            ],
-            agent: {
-                name: 'incident-triage',
-                systemPrompt: `You help the on-call engineer triage incidents.
-
-Our repository on GitHub: [owner/name] (edit this). Pass its owner and repo to every GitHub tool.
-
-When you get an alert, error or bug report, follow your triage-incident workflow.
-
-Rules:
-- Only read on your own; never roll anything back yourself.
-- 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".',
-            },
-        },
-        setup: {
-            abilities: [],
-            apps: [{ id: GITHUB_APP, title: 'GitHub', tools: ['list_commits', 'list_pull_requests', 'actions_list', 'search_issues', 'issue_read', 'issue_write', 'add_issue_comment'] }],
-            keys: [],
-            skills: [{
-                    id: 'triage-incident',
-                    description: 'Triage an alert, error or bug report: what broke, how bad it is, and the change that likely caused it.',
-                    workflow: { title: 'Triage an incident', parameters: { alert: { description: 'The alert, error or bug report', required: true } }, webhook: true },
-                    body: `Triage the alert you were given.
-
-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. Find what changed shortly before it started: github_actions_list (method list_workflow_runs) for recent deploys and failed builds, github_list_pull_requests (state closed) for recently merged changes, and github_list_commits (narrowed with since and path) for detail. Match times carefully.
-4. Check whether it's already known with github_search_issues; read a match with github_issue_read (method get).
-5. If an issue already tracks it, add your findings with github_add_issue_comment; otherwise, for SEV1 or SEV2, open one with github_issue_write (method create). Both ask a person first.
-6. End with the summary, which is sent to Slack: what's broken, severity, the most likely cause with links, and one next step (who should look, what to check, or whether to roll back).`,
-                }],
-            rules: [
-                { name: 'template-new-issues-need-approval', tool: 'github_issue_write', decision: 'ask' },
-                { name: 'template-comments-need-approval', tool: 'github_add_issue_comment', decision: 'ask' },
-            ],
-            needsApprovals: true,
-            notes: ['Send it alerts: paste one into Chat, mention it in Slack, or have your alerting tool call its webhook'],
-        },
-    },
-    {
-        id: 'expense-approvals',
-        category: 'Finance',
-        candidate: {
-            title: 'Check expense claims',
-            summary: 'Checks the claims inbox, reads each claim and its receipt, checks it against your expense policy, and sends the approver a one-line verdict. Replies to claimants wait for your approval.',
-            trigger: { kind: 'schedule', description: 'every 15 minutes, for new claims', every: '15m' },
-            hoursPerWeek: 3,
-            fit: 7,
-            risk: 'high',
-            asksFirst: ['replying to the claimant'],
-            needs: [
-                { kind: 'ability', name: '@loopengine-co/gmail', description: 'the inbox where claims arrive' },
-                { kind: 'other', name: 'Your expense policy', description: 'in its expense-policy skill' },
-            ],
-            agent: {
-                name: 'expense-approvals',
-                systemPrompt: `You check expense claims against our expense policy.
-
-When asked to check new claims:
-1. Find them with gmail_search, query "is:unread in:inbox". Read each with gmail_get_thread.
-2. Read the amount, currency, date, merchant, category and who submitted it, from the email and its receipt (the attachment names show whether a receipt is there).
-3. Check it against our expense policy in the expense-policy skill (open it with Skill): 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 (search the inbox for the same merchant and amount).
-4. Write a one-line verdict: "Within policy" or "Outside policy: <reason>", then the details you checked.
-5. Email the verdict to the approver at the address in the EXPENSE_APPROVER_EMAIL setting with gmail_send, then mark the claim read with gmail_modify_labels.
-
-Rules:
-- Never approve or pay a claim yourself. A person always decides.
-- If the receipt is missing or unreadable, draft a reply to the claimant asking for it with gmail_create_draft; don't fill in values.
-- If the policy doesn't cover the case, say which part is unclear rather than deciding.`,
-                scheduleMessage: 'Check the new expense claims in the inbox.',
-                exampleMessage: 'Check the new expense claims in the inbox.',
-            },
-        },
-        setup: {
-            abilities: ['@loopengine-co/gmail'],
-            keys: [...GMAIL_KEYS],
-            skills: [{
-                    id: 'expense-policy',
-                    description: 'Our expense policy: what can be claimed, the limits, and what a claim needs. Read it before giving any verdict.',
-                    body: `# Our expense policy
-
-Edit this: replace each [bracket] with your own policy. The agent checks claims against this and nothing else.
-
-## What can be claimed, and the limits
-- Travel: [e.g. economy flights and trains; taxis when there's no public transport]
-- Hotels: [e.g. up to 150 per night]
-- Meals: [e.g. up to 50 per day when travelling]
-- Equipment and software: [e.g. up to 200 without pre-approval]
-
-## What can't be claimed
-- [e.g. alcohol, fines, personal entertainment]
-
-## What every claim needs
-- An itemised receipt showing the amount, date and merchant
-- [Pre-approval for anything over a limit]
-- Submitted within [e.g. 60 days]
-`,
-                }],
-            rules: [
-                { name: 'template-read-mail-allowed', tool: 'gmail_search', decision: 'allow' },
-                { name: 'template-read-thread-allowed', tool: 'gmail_get_thread', decision: 'allow' },
-                { name: 'template-drafts-allowed', tool: 'gmail_create_draft', decision: 'allow' },
-                { name: 'template-labels-allowed', tool: 'gmail_modify_labels', decision: 'allow' },
-                { name: 'template-emails-need-approval', tool: 'gmail_send', decision: 'ask' },
-            ],
-            schedule: { every: '15m', name: 'Check for new claims', message: 'Check the new expense claims in the inbox.' },
-            needsApprovals: true,
-            notes: [policiesNote('your expense policy', 'expense-policy'), 'Set EXPENSE_APPROVER_EMAIL (Environment tab) to the approver\'s address'],
-        },
-    },
-    {
-        id: 'lead-follow-up',
-        category: 'Sales',
-        candidate: {
-            title: 'Lead follow-up',
-            summary: 'Every hour, picks up new leads in HubSpot, researches each on the web, and drafts a short, personal first email. Sending and updating the CRM wait for your approval.',
-            trigger: { kind: 'schedule', description: 'every hour, for new leads', every: '1h' },
-            hoursPerWeek: 3,
-            fit: 6,
-            risk: 'medium',
-            asksFirst: ['sending the first email', 'updating the lead'],
-            needs: [
-                { kind: 'ability', name: '@loopengine-co/hubspot', description: 'your leads in HubSpot' },
-                { kind: 'app', name: 'Firecrawl', description: 'researching each lead on the web' },
-                { kind: 'ability', name: '@loopengine-co/gmail', description: 'the inbox to send from' },
-            ],
-            agent: {
-                name: 'lead-follow-up',
-                systemPrompt: `You follow up with new leads for our business.
-
-What we sell (edit this):
-- [What your product does, in one sentence]
-- [Who it is for]
-- [The one result customers care about most]
-
-When asked to follow up with new leads:
-1. Find them with hubspot_find_contacts: lead_status "NEW", created_in_last_days 2.
-2. For each, read hubspot_get_contact. Skip anyone with an owner, recent notes, or a last-contacted date: someone is already on it.
-3. Research them with firecrawl_search and firecrawl_scrape: what their company does, its size, and anything recent that matters (funding, hiring, a launch). Note your sources.
-4. Work out what they most likely need from us, in one sentence.
-5. Send a short first email (under 120 words) with gmail_send: a specific opening based on your research, one sentence on how we help with that need, and one easy question to reply to. A person approves it first.
-6. Log what you sent and found with hubspot_add_note, and set the lead to "ATTEMPTED_TO_CONTACT" with hubspot_update_contact.
-
-Rules:
-- Never invent facts about a lead. If research finds nothing reliable, write a simple, honest email instead.
-- No pressure tactics, fake urgency or discounts you weren't told about.
-- If the lead looks like a competitor, a student or spam, add a note saying so and don't email them.`,
-                scheduleMessage: 'Follow up with the new leads in HubSpot.',
-                exampleMessage: 'Follow up with the new leads in HubSpot.',
-            },
-        },
-        setup: {
-            abilities: ['@loopengine-co/hubspot', '@loopengine-co/gmail'],
-            apps: [{ id: FIRECRAWL_APP, title: 'Firecrawl', tools: ['firecrawl_search', 'firecrawl_scrape'] }],
-            keys: ['HUBSPOT_ACCESS_TOKEN', ...GMAIL_KEYS],
-            rules: [
-                { name: 'template-search-allowed', tool: 'firecrawl_search', decision: 'allow' },
-                { name: 'template-read-pages-allowed', tool: 'firecrawl_scrape', decision: 'allow' },
-                { name: 'template-notes-allowed', tool: 'hubspot_add_note', decision: 'allow' },
-                { name: 'template-lead-updates-need-approval', tool: 'hubspot_update_contact', decision: 'ask' },
-                { name: 'template-no-new-contacts', tool: 'hubspot_create_contact', decision: 'deny' },
-                { name: 'template-emails-need-approval', tool: 'gmail_send', decision: 'ask' },
-            ],
-            schedule: { every: '1h', name: 'Follow up with new leads', message: 'Follow up with the new leads in HubSpot.' },
-            needsApprovals: true,
-            notes: ['Edit "What we sell" at the top of its instructions (Overview tab)'],
-        },
-    },
-    {
-        id: 'inbox-to-tasks',
-        category: 'Operations',
-        candidate: {
-            title: 'Inbox to tasks',
-            summary: 'Checks a shared inbox every 10 minutes and turns each request into a task (a GitHub issue) with an owner and a due date, then tells the sender who is handling it.',
-            trigger: { kind: 'schedule', description: 'every 10 minutes, for new emails', every: '10m' },
-            hoursPerWeek: 3,
-            fit: 7,
-            risk: 'low',
-            asksFirst: ['replying to the sender'],
-            needs: [
-                { kind: 'ability', name: '@loopengine-co/gmail', description: 'the shared inbox' },
-                { kind: 'app', name: 'GitHub', description: 'tasks, as GitHub issues' },
-            ],
-            agent: {
-                name: 'inbox-to-tasks',
-                systemPrompt: `You turn requests in our shared inbox into tasks, kept as GitHub issues.
-
-Tasks live in this GitHub repository: [owner/name] (edit this). Pass its owner and repo to every GitHub tool.
-
-Who handles what (edit this; GitHub usernames):
-- Billing and invoices: [username]
-- Technical problems: [username]
-- Everything else: [username]
-
-When asked to handle new emails:
-1. Find them with gmail_search, query "is:unread in:inbox". Read each with gmail_get_thread.
-2. Decide whether it's a request someone needs to act on. Newsletters, receipts, out-of-office replies and spam are not: mark them read and move on.
-3. Check whether a task already exists with github_search_issues (the sender and subject). If so, add the new details with github_add_issue_comment instead.
-4. Otherwise open one with github_issue_write (method create): a short title starting with a verb, a two-line summary, the sender, the due date (the date they asked for, or 2 working days if they didn't say), and the owner from the list above as the assignee.
-5. Reply to the sender with gmail_send (reply_to_message_id set): who is handling it and by when. A person approves it first.
-6. Mark the email read with gmail_modify_labels.
-
-Rules:
-- If an email holds several requests, make one task for each.
-- Never promise a fix or a refund in the reply; only say who is handling it and by when.`,
-                scheduleMessage: 'Turn the new emails in the shared inbox into tasks.',
-                exampleMessage: 'Turn the new emails in the shared inbox into tasks.',
-            },
-        },
-        setup: {
-            abilities: ['@loopengine-co/gmail'],
-            apps: [{ id: GITHUB_APP, title: 'GitHub', tools: ['search_issues', 'issue_write', 'add_issue_comment'] }],
-            keys: [...GMAIL_KEYS],
-            rules: [
-                { name: 'template-read-mail-allowed', tool: 'gmail_search', decision: 'allow' },
-                { name: 'template-read-thread-allowed', tool: 'gmail_get_thread', decision: 'allow' },
-                { name: 'template-labels-allowed', tool: 'gmail_modify_labels', decision: 'allow' },
-                { name: 'template-tasks-allowed', tool: 'github_issue_write', decision: 'allow' },
-                { name: 'template-task-updates-allowed', tool: 'github_add_issue_comment', decision: 'allow' },
-                { name: 'template-replies-need-approval', tool: 'gmail_send', decision: 'ask' },
-            ],
-            schedule: { every: '10m', name: 'Check the shared inbox', message: 'Turn the new emails in the shared inbox into tasks.' },
-            needsApprovals: true,
-            notes: ['Edit "Who handles what" at the top of its instructions (Overview tab)', 'Point GITHUB_DEFAULT_REPO at the repository your team keeps tasks in'],
-        },
-    },
-    {
-        id: 'weekly-research-digest',
-        category: 'Research',
-        candidate: {
-            title: 'Weekly research digest',
-            summary: 'Every Monday morning, searches the web for news on the topics you choose and sends a short digest with links to Slack.',
-            trigger: { kind: 'schedule', description: 'Mondays at 9:00', every: '7d' },
-            hoursPerWeek: 2,
-            fit: 6,
-            risk: 'low',
-            asksFirst: [],
-            needs: [
-                { kind: 'app', name: 'Firecrawl', description: 'searching the web and reading pages' },
-                { kind: 'messaging', name: 'Slack', description: 'where each digest is sent (its Messaging tab)' },
-            ],
-            agent: {
-                name: 'weekly-research-digest',
-                systemPrompt: `You write a weekly research digest. Your answer is the digest: it's sent to Slack as it is.
-
-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 with firecrawl_search for what happened in the last 7 days on each topic.
-2. Open the most relevant pages with firecrawl_scrape 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.
-5. Answer with the digest alone, nothing before or after it.
-
-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.',
-            },
-        },
+import { WORKFLOW_EXAMPLES } from './workflow-examples.js';
+import { workflowTemplate } from './workflow-planner.js';
+/** @deprecated Templates are now workflow examples
+ * (./workflow-examples.ts). Kept for a project server from an older
+ * template, whose Templates page still lists these: each example as the
+ * template it creates as a new agent. */
+export const STARTER_TEMPLATES = WORKFLOW_EXAMPLES.map(({ id, category, plan }) => {
+    const template = workflowTemplate(plan);
+    const [own, ...rest] = template.setup.skills ?? [];
+    return {
+        ...template,
+        id,
+        category,
         setup: {
-            abilities: [],
-            apps: [{ id: FIRECRAWL_APP, title: 'Firecrawl', tools: ['firecrawl_search', 'firecrawl_scrape'] }],
-            keys: [],
-            rules: [
-                { name: 'template-search-allowed', tool: 'firecrawl_search', decision: 'allow' },
-                { name: 'template-read-pages-allowed', tool: 'firecrawl_scrape', decision: 'allow' },
-            ],
-            schedule: { every: '7d', at: '09:00', weekday: 1, name: 'Weekly research digest', message: 'Write this week\'s research digest.', notify: true },
-            needsApprovals: false,
-            notes: ['Edit "Topics to follow" at the top of its instructions (Overview tab)'],
+            ...template.setup,
+            // Its own skill is the workflow its schedule runs.
+            skills: [{ ...own, workflow: { title: plan.name, ...(Object.keys(plan.parameters).length ? { parameters: plan.parameters } : {}) } }, ...rest],
         },
-    },
-];
+    };
+});
 export function starterTemplate(id) {
     return STARTER_TEMPLATES.find((t) => t.id === id);
 }

package/dist/core/system-agents/workflow-examples.d.ts

@@ -0,0 +1,10 @@
+import type { WorkflowPlan } from './workflow-planner.js';
+export interface WorkflowExample {
+    /** Stable id, used in links: lowercase-hyphenated. */
+    id: string;
+    /** Groups examples on the page: "Customer service", "Operations"… */
+    category: string;
+    plan: WorkflowPlan;
+}
+export declare const WORKFLOW_EXAMPLES: readonly WorkflowExample[];
+export declare function workflowExample(id: string): WorkflowExample | undefined;