loopengine 0.3.11 → 0.3.13

package/LICENSE

@@ -1,13 +1,102 @@
-MIT License
+# Functional Source License, Version 1.1, MIT Future License
 
-Copyright (c) 2026 Evan Yan
+## Abbreviation
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+FSL-1.1-MIT
+
+## Notice
+
+Copyright 2026 Evan Yan
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the MIT license that is effective on the second anniversary of the date we make
+the Software available. On or after that date, you may use the Software under
+the MIT license, in which case the following will apply:
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
 
 The above copyright notice and this permission notice shall be included in all
 copies or substantial portions of the Software.

package/README.md

@@ -481,3 +481,19 @@ and doesn't count as activity.
 
 `deploy/workspace/Dockerfile` is a runtime image for this: it serves a
 scaffolded project mounted at `/workspace` instead of baking agents in.
+
+## License
+
+LoopEngine is under the [Functional Source License, Version 1.1, MIT
+Future License](LICENSE) (FSL-1.1-MIT). In short:
+
+- You can use, change and self-host it for anything, including running
+  your own business on it, except offering it to others as a competing
+  commercial product or service, such as a hosted LoopEngine.
+- Each version becomes MIT-licensed two years after its release.
+- Versions up to and including 0.3.12 were released under MIT and stay
+  under MIT.
+
+The license text is what applies; this summary isn't legal advice.
+Third-party software included in LoopEngine keeps its own license: see
+[THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,35 @@
+# Third-party notices
+
+LoopEngine includes the following third-party software, under its own
+license. This notice is kept with every copy of LoopEngine, as that
+license requires.
+
+## LobeHub Icons
+
+The model provider logos in `web/provider-icons.ts` are from LobeHub's
+icon set, `@lobehub/icons-static-svg` 1.101.0
+(https://github.com/lobehub/lobe-icons), under the MIT License:
+
+```
+MIT License
+
+Copyright (c) 2023 LobeHub
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```

package/dist/core/system-agents/workflow-example-messages.d.ts

@@ -0,0 +1,13 @@
+export interface WorkflowExampleMessage {
+    /** Stable id: lowercase-hyphenated. */
+    id: string;
+    category: string;
+    title: string;
+    /** What a person would type to describe it. */
+    message: string;
+    /** The apps it would work with, by name. */
+    apps: string[];
+    /** What it would ask before doing, in plain words. */
+    asksFirst: string[];
+}
+export declare const WORKFLOW_EXAMPLE_MESSAGES: readonly WorkflowExampleMessage[];

package/dist/core/system-agents/workflow-example-messages.js

@@ -0,0 +1,116 @@
+// Workflow examples as messages: jobs across many areas, each as what a
+// person would type on the New workflow page. Using one fills in the
+// description, for the planner to plan; unlike the ready-made examples
+// (./workflow-examples.ts) nothing is planned in advance. The same list
+// is on loopengine.co/workflows.
+export const WORKFLOW_EXAMPLE_MESSAGES = [
+    { id: "weekly-blog-post", category: "Marketing", title: "Weekly blog post", message: "Every Monday, find timely blog ideas about our product area, ask me which one to write, draft it, and let me review it before it's published.", apps: ["Firecrawl"], asksFirst: ["picking the idea", "publishing the post"] },
+    { id: "competitor-pricing-watch", category: "Marketing", title: "Competitor pricing watch", message: "Every weekday, read our three competitors' pricing pages and tell me what changed since yesterday.", apps: ["Firecrawl"], asksFirst: [] },
+    { id: "release-posts", category: "Marketing", title: "Posts about each release", message: "When we publish a release on GitHub, write a short post for X about what's new, and let me approve it before it goes out.", apps: ["GitHub", "X"], asksFirst: ["posting on X"] },
+    { id: "sales-call-brief", category: "Sales", title: "Sales call brief", message: "When I send you a company's name before a sales call, research the company and its recent news, check what we know about them in HubSpot, and send me a one-page brief.", apps: ["Firecrawl", "HubSpot"], asksFirst: [] },
+    { id: "renewal-check-ins", category: "Customer success", title: "Renewal check-ins", message: "Every Monday, find customers whose subscription renews in the next 30 days in Stripe, and draft a check-in email for each. Ask me before any email is sent.", apps: ["Stripe", "Gmail"], asksFirst: ["sending an email"] },
+    { id: "monday-metrics", category: "Finance", title: "Monday metrics", message: "Every Monday at 9, pull last week's revenue, new customers and cancellations from Stripe, compare them with the week before, and send me a short summary.", apps: ["Stripe"], asksFirst: [] },
+    { id: "overdue-invoices", category: "Finance", title: "Overdue invoice reminders", message: "Every morning, find invoices in Stripe that are more than 7 days overdue, and write a polite reminder to each customer. Ask me before any reminder is sent.", apps: ["Stripe", "Gmail"], asksFirst: ["sending a reminder"] },
+    { id: "release-notes", category: "Engineering", title: "Release notes", message: "When a release is tagged on GitHub, read the pull requests merged since the last one and draft release notes for me to edit.", apps: ["GitHub"], asksFirst: [] },
+    { id: "stale-pull-requests", category: "Engineering", title: "Stale pull requests", message: "Every weekday at 10, find pull requests that have waited more than two days for a review, and remind me which ones and who they're waiting on.", apps: ["GitHub"], asksFirst: [] },
+    { id: "new-hire-onboarding", category: "People", title: "New hire onboarding", message: "When I tell you someone new is joining, write their onboarding page in Notion and create their first-week tasks in Linear. Show me the plan before anything is created.", apps: ["Notion", "Linear"], asksFirst: ["creating the pages and tasks"] },
+    { id: "candidate-summaries", category: "People", title: "Candidate summaries", message: "Every morning, read new applications in our hiring inbox, compare each CV with the job description, and send me a short summary of each with its strengths and gaps. Never reply to a candidate yourself.", apps: ["Gmail"], asksFirst: [] },
+    { id: "low-stock-reorders", category: "E-commerce", title: "Low stock reorders", message: "Every morning, check Shopify for products running low, estimate when each will sell out at the current pace, and send me a reorder list.", apps: ["Shopify"], asksFirst: [] },
+    { id: "software-renewals", category: "Operations", title: "Software renewals", message: "On the first of each month, list the software subscriptions in our Airtable that renew in the next 30 days, with their cost and who uses them, and send it to me.", apps: ["Airtable"], asksFirst: [] },
+    { id: "help-center-gaps", category: "Customer service", title: "Help center gaps", message: "Every Friday, read this week's support emails, find the questions we answer most that aren't in our help center in Notion, and draft an article for each. Let me review them first.", apps: ["Gmail", "Notion"], asksFirst: ["publishing an article"] },
+    { id: "escalate-upset-customers", category: "Customer service", title: "Escalate upset customers", message: "Every 15 minutes, check the support inbox for angry customers or anyone mentioning a chargeback or a lawyer, and message me in Slack with a summary and a suggested reply.", apps: ["Gmail", "Slack"], asksFirst: [] },
+    { id: "where-is-my-order", category: "Customer service", title: "Where is my order?", message: "When a customer asks where their order is, look it up in Shopify, find the tracking link, and reply with the latest status. Let me approve replies for the first week.", apps: ["Gmail", "Shopify"], asksFirst: ["sending a reply"] },
+    { id: "weekly-support-report", category: "Customer service", title: "Weekly support report", message: "Every Monday, count last week's support emails by topic, note which took longest to answer, and send me a short report.", apps: ["Gmail"], asksFirst: [] },
+    { id: "bug-reports-to-linear", category: "Customer service", title: "Bug reports to Linear", message: "When a customer reports a bug by email, check Linear for an existing issue, add their report to it or open a new one, and tell them we're on it. Ask me before replying.", apps: ["Gmail", "Linear"], asksFirst: ["replying to the customer"] },
+    { id: "new-customer-check-in", category: "Customer success", title: "New customer check-in", message: "Three days after a customer signs up in Stripe, send them a short check-in email with the two help articles new customers need most. Let me approve the first ten.", apps: ["Stripe", "Gmail"], asksFirst: ["sending an email"] },
+    { id: "usage-drop-alerts", category: "Customer success", title: "Usage drop alerts", message: "Every Monday, find accounts in PostHog whose usage dropped by half over the last two weeks, and send me a list with what changed for each.", apps: ["PostHog"], asksFirst: [] },
+    { id: "low-score-follow-up", category: "Customer success", title: "Low survey score follow-up", message: "When a Typeform survey response comes in with a score of 6 or less, read it, find the customer in HubSpot, and draft a personal reply for me to send.", apps: ["Typeform", "HubSpot"], asksFirst: [] },
+    { id: "quarterly-review-prep", category: "Customer success", title: "Quarterly review prep", message: "Before each quarterly review, pull the customer's usage from PostHog, their invoices from Stripe and their open issues from Linear, and write me a one-page summary.", apps: ["PostHog", "Stripe", "Linear"], asksFirst: [] },
+    { id: "demo-request-routing", category: "Sales", title: "Demo request routing", message: "When a demo request comes in through our Typeform, research the company, score it against our ideal customer, add the contact to HubSpot, and tell me in Slack who it is.", apps: ["Typeform", "HubSpot", "Firecrawl", "Slack"], asksFirst: [] },
+    { id: "stalled-deal-follow-ups", category: "Sales", title: "Stalled deal follow-ups", message: "Every morning, find HubSpot deals with no activity for 10 days, and draft a follow-up email for each. Ask me before any is sent.", apps: ["HubSpot", "Gmail"], asksFirst: ["sending a follow-up"] },
+    { id: "call-notes-to-crm", category: "Sales", title: "Call notes to the CRM", message: "When I paste my notes after a call, summarise them, log them on the contact in HubSpot, and list the next steps with dates.", apps: ["HubSpot"], asksFirst: [] },
+    { id: "proposal-drafts", category: "Sales", title: "Proposal drafts", message: "When a deal reaches the proposal stage in HubSpot, draft the proposal in Notion from our template with the client's details and pricing, for me to edit.", apps: ["HubSpot", "Notion"], asksFirst: [] },
+    { id: "win-loss-reasons", category: "Sales", title: "Win and loss reasons", message: "Every month, read the notes on the deals we won and lost in HubSpot, and tell me the three most common reasons for each.", apps: ["HubSpot"], asksFirst: [] },
+    { id: "prospect-list", category: "Sales", title: "Weekly prospect list", message: "Every Monday, find 20 companies that match our ideal customer and are hiring for roles we help with, and add them to an Airtable list with a line on why each fits.", apps: ["Firecrawl", "Airtable"], asksFirst: [] },
+    { id: "newsletter-draft", category: "Marketing", title: "Newsletter draft", message: "Every other Thursday, collect what we shipped and wrote in the last two weeks, and draft our newsletter for me to edit.", apps: ["Linear", "Notion"], asksFirst: [] },
+    { id: "blog-content-audit", category: "Marketing", title: "Blog content audit", message: "Every month, read our blog posts on Webflow, find the ones with outdated facts or broken links, and send me a list of what to fix.", apps: ["Webflow"], asksFirst: [] },
+    { id: "campaign-results", category: "Marketing", title: "Campaign results", message: "Every Monday, pull last week's signups by source from PostHog, compare them with the week before, and tell me which campaigns are working.", apps: ["PostHog"], asksFirst: [] },
+    { id: "landing-page-copy", category: "Marketing", title: "Landing page copy", message: "When I describe a new feature, write three versions of the landing page headline and copy, in our voice, for me to choose from.", apps: [], asksFirst: [] },
+    { id: "webinar-follow-up", category: "Marketing", title: "Webinar follow-up", message: "After each webinar, email everyone who registered: the recording for those who came, and a short summary for those who didn't. Let me approve the emails first.", apps: ["Gmail"], asksFirst: ["sending the emails"] },
+    { id: "case-study-drafts", category: "Marketing", title: "Case study drafts", message: "When I paste a customer interview, turn it into a case study draft in Notion: the problem, what they did, and the results with numbers.", apps: ["Notion"], asksFirst: [] },
+    { id: "daily-x-post", category: "Social media", title: "Daily post on X", message: "Every weekday at 10, write one post for X from our latest blog post or release, and let me approve it before it's posted.", apps: ["X"], asksFirst: ["posting on X"] },
+    { id: "mention-replies", category: "Social media", title: "Replies to mentions", message: "Every hour, search X for mentions of our product, like the positive ones, and draft replies to questions for me to approve.", apps: ["X"], asksFirst: ["replying on X"] },
+    { id: "social-calendar", category: "Social media", title: "Social calendar", message: "Every Friday, plan next week's posts for X from our blog and releases, and put them in a Notion calendar for me to review.", apps: ["X", "Notion"], asksFirst: [] },
+    { id: "conversations-to-join", category: "Social media", title: "Conversations to join", message: "Every morning, find what people on X are saying about our industry, and send me the five posts most worth replying to.", apps: ["X"], asksFirst: [] },
+    { id: "customer-shout-outs", category: "Social media", title: "Customer shout-outs", message: "When a customer posts something good about us on X, repost it and thank them. Ask me before each repost.", apps: ["X"], asksFirst: ["reposting"] },
+    { id: "competitor-social-recap", category: "Social media", title: "Competitor social recap", message: "Every Monday, summarise what our three competitors posted on X last week and which posts got the most attention.", apps: ["X"], asksFirst: [] },
+    { id: "refund-risk-check", category: "E-commerce", title: "Refund risk check", message: "Before any refund over $200, check the customer's order history in Shopify for earlier refunds, and tell me if anything looks off.", apps: ["Shopify"], asksFirst: [] },
+    { id: "daily-sales-summary", category: "E-commerce", title: "Daily sales summary", message: "Every evening, total today's Shopify orders, revenue and refunds, compare them with the same day last week, and send me the numbers.", apps: ["Shopify"], asksFirst: [] },
+    { id: "best-customer-thank-yous", category: "E-commerce", title: "Best customer thank-yous", message: "Every month, find our 20 best customers by spend in Shopify and draft a personal thank-you email for each. Ask me before sending.", apps: ["Shopify", "Gmail"], asksFirst: ["sending an email"] },
+    { id: "delivery-delay-updates", category: "E-commerce", title: "Delivery delay updates", message: "Every morning, find Shopify orders shipped more than 7 days ago that still haven't arrived, and email each customer an update. Ask me before sending.", apps: ["Shopify", "Gmail"], asksFirst: ["sending an update"] },
+    { id: "returns-report", category: "E-commerce", title: "Returns report", message: "Every month, list the products returned most often in Shopify, with the reasons customers gave, and send me the list.", apps: ["Shopify"], asksFirst: [] },
+    { id: "wholesale-orders", category: "E-commerce", title: "Wholesale orders", message: "When a wholesale order arrives by email, check the items and quantities, and draft the order summary and the Stripe invoice for me to approve.", apps: ["Gmail", "Stripe"], asksFirst: ["sending the invoice"] },
+    { id: "month-end-checklist", category: "Finance", title: "Month-end checklist", message: "On the last working day of the month, check Stripe for unpaid invoices, failed payments and refunds, and send me a month-end checklist.", apps: ["Stripe"], asksFirst: [] },
+    { id: "failed-payment-notes", category: "Finance", title: "Failed payment notes", message: "When a payment fails in Stripe, email the customer a friendly note with a link to update their card. Ask me before sending the first few.", apps: ["Stripe", "Gmail"], asksFirst: ["sending a note"] },
+    { id: "monthly-spend-summary", category: "Finance", title: "Monthly spend summary", message: "Every month, total our spending by category from the receipts in our finance inbox, and send me a summary with anything unusual.", apps: ["Gmail"], asksFirst: [] },
+    { id: "supplier-invoice-check", category: "Finance", title: "Supplier invoice check", message: "When a supplier invoice arrives by email, check it against our Airtable list of approved suppliers and amounts, and flag anything that doesn't match.", apps: ["Gmail", "Airtable"], asksFirst: [] },
+    { id: "cash-forecast", category: "Finance", title: "Cash forecast", message: "Every Monday, list the invoices due to us in the next 30 days from Stripe and the bills we owe from our Airtable, and tell me the week-by-week cash position.", apps: ["Stripe", "Airtable"], asksFirst: [] },
+    { id: "paypal-disputes", category: "Finance", title: "PayPal disputes", message: "When a PayPal dispute opens, find the order and its delivery, and draft our response with the evidence. Ask me before it's submitted.", apps: ["PayPal"], asksFirst: ["submitting the response"] },
+    { id: "weekly-company-update", category: "Operations", title: "Weekly company update", message: "Every Friday, read what each team closed in Linear this week, and write a short company update for me to post.", apps: ["Linear"], asksFirst: [] },
+    { id: "meeting-action-items", category: "Operations", title: "Meeting action items", message: "When I paste a meeting transcript, list the decisions and action items, and create a Todoist task for each with its owner and due date.", apps: ["Todoist"], asksFirst: [] },
+    { id: "standup-digest", category: "Operations", title: "Standup digest", message: "Every morning, collect yesterday's closed and in-progress Jira issues, and send the team a short standup summary in Slack.", apps: ["Jira", "Slack"], asksFirst: [] },
+    { id: "process-docs", category: "Operations", title: "Process docs", message: "When I describe how we do something, turn it into a step-by-step process page in Notion, and point out anything that seems unclear.", apps: ["Notion"], asksFirst: [] },
+    { id: "stale-board-items", category: "Operations", title: "Stale board items", message: "Every Friday, find items on our monday.com boards with no update for two weeks, and ask their owners whether they're still active.", apps: ["monday.com"], asksFirst: [] },
+    { id: "new-error-triage", category: "Engineering", title: "New error triage", message: "When a new error shows up in Sentry, find the commit that likely caused it on GitHub, and open an issue with the details. Ask me before opening it.", apps: ["Sentry", "GitHub"], asksFirst: ["opening an issue"] },
+    { id: "failed-build-summary", category: "Engineering", title: "Failed build summary", message: "When a CircleCI build fails on main, read the logs, find the failing test and the change that broke it, and send me a summary.", apps: ["CircleCI", "GitHub"], asksFirst: [] },
+    { id: "dependency-updates", category: "Engineering", title: "Dependency updates", message: "Every Monday, list the open dependency update pull requests on GitHub, and say which look safe to merge and which need a closer look.", apps: ["GitHub"], asksFirst: [] },
+    { id: "pull-request-summaries", category: "Engineering", title: "Pull request summaries", message: "When a pull request is opened, summarise what it changes and what to check carefully, as a comment for the reviewer. Ask me before posting.", apps: ["GitHub"], asksFirst: ["posting a comment"] },
+    { id: "deploy-notes", category: "Engineering", title: "Deploy notes", message: "After each Vercel production deploy, list the changes it shipped and send them to the team.", apps: ["Vercel"], asksFirst: [] },
+    { id: "issue-labeling", category: "Engineering", title: "Issue labeling", message: "Every hour, label new GitHub issues by area and priority, and ask the reporter for steps to reproduce when they're missing. Ask me before commenting.", apps: ["GitHub"], asksFirst: ["commenting on an issue"] },
+    { id: "feature-request-log", category: "Product", title: "Feature request log", message: "When a customer asks for a feature by email, add it to our Airtable of requests, or add their name to an existing one, so we can see what's asked for most.", apps: ["Gmail", "Airtable"], asksFirst: [] },
+    { id: "weekly-product-metrics", category: "Product", title: "Weekly product metrics", message: "Every Monday, pull last week's active users, signups and the three most used features from PostHog, and send me a short summary.", apps: ["PostHog"], asksFirst: [] },
+    { id: "funnel-drop-off", category: "Product", title: "Funnel drop-off", message: "Every week, check our signup funnel in Amplitude, and tell me where the biggest drop-off was and how it compares with last week.", apps: ["Amplitude"], asksFirst: [] },
+    { id: "interview-themes", category: "Product", title: "User interview themes", message: "When I paste notes from user interviews, group what people said into themes, with quotes, on a Notion page.", apps: ["Notion"], asksFirst: [] },
+    { id: "one-page-spec", category: "Product", title: "One-page spec", message: "When I describe a feature in a few sentences, write a one-page spec in Notion: the problem, who it's for, what's in and out, and open questions.", apps: ["Notion"], asksFirst: [] },
+    { id: "customer-changelog", category: "Product", title: "Customer changelog", message: "Every two weeks, write our public changelog from the Linear issues we completed, in plain words for customers, for me to edit.", apps: ["Linear"], asksFirst: [] },
+    { id: "figma-comment-roundup", category: "Design", title: "Figma comment roundup", message: "Every Friday, collect the open comments on our Figma files, and send each designer a list of what's waiting on them.", apps: ["Figma"], asksFirst: [] },
+    { id: "design-guideline-check", category: "Design", title: "Design guideline check", message: "When I share a Figma link, review the screens against our design guidelines in Notion, and list what doesn't match.", apps: ["Figma", "Notion"], asksFirst: [] },
+    { id: "blog-social-images", category: "Design", title: "Social images for posts", message: "When a blog post is published, make three social images for it in Canva from our template, for me to choose from.", apps: ["Canva"], asksFirst: [] },
+    { id: "time-off-requests", category: "People", title: "Time-off requests", message: "When someone emails a time-off request, check it against our team calendar and leave policy in Notion, and draft my reply.", apps: ["Gmail", "Notion"], asksFirst: [] },
+    { id: "handbook-answers", category: "People", title: "Handbook answers", message: "When someone asks an HR question in Slack, answer from our handbook in Notion, and tell them who to ask when the handbook doesn't say.", apps: ["Slack", "Notion"], asksFirst: [] },
+    { id: "offboarding-checklist", category: "People", title: "Offboarding checklist", message: "When I tell you someone is leaving, make their offboarding checklist in Notion: accounts to close, equipment to return, and handover tasks.", apps: ["Notion"], asksFirst: [] },
+    { id: "work-anniversaries", category: "People", title: "Work anniversaries", message: "On each work anniversary in our Airtable, draft a short note from me thanking them for something specific they did this year.", apps: ["Airtable"], asksFirst: [] },
+    { id: "job-descriptions", category: "People", title: "Job descriptions", message: "When I describe a role in a few lines, write the job description in our usual format, with the responsibilities and what we're looking for.", apps: [], asksFirst: [] },
+    { id: "interview-feedback", category: "People", title: "Interview feedback summary", message: "After each candidate's interviews, collect the interviewers' notes from Notion, and summarise the strengths, concerns and recommendation.", apps: ["Notion"], asksFirst: [] },
+    { id: "contract-review", category: "Legal", title: "Contract review", message: "When I send you a contract, list the clauses that differ from our standard terms in Notion, and flag anything unusual about liability, payment or termination.", apps: ["Notion"], asksFirst: [] },
+    { id: "nda-check", category: "Legal", title: "NDA check", message: "When an NDA arrives by email, compare it with our standard NDA, list the differences, and draft a reply asking for our usual changes. Ask me before sending.", apps: ["Gmail", "Notion"], asksFirst: ["sending a reply"] },
+    { id: "contract-renewal-dates", category: "Legal", title: "Contract renewal dates", message: "Every month, list the contracts in our Airtable that renew or can be cancelled in the next 60 days, with the notice period for each.", apps: ["Airtable"], asksFirst: [] },
+    { id: "data-deletion-requests", category: "Legal", title: "Data deletion requests", message: "When someone emails asking for their data to be deleted, find them in HubSpot and Stripe, list what we hold, and draft the reply. Ask me before anything is deleted or sent.", apps: ["Gmail", "HubSpot", "Stripe"], asksFirst: ["deleting anything", "sending a reply"] },
+    { id: "access-review", category: "IT", title: "Access review", message: "Every quarter, list who has admin access to GitHub and our other tools from our Airtable, and ask each team lead to confirm it's still needed.", apps: ["Airtable", "GitHub"], asksFirst: [] },
+    { id: "equipment-requests", category: "IT", title: "Equipment requests", message: "When someone asks for equipment in Slack, log it in our Airtable with the date and owner, and tell them when to expect it.", apps: ["Slack", "Airtable"], asksFirst: [] },
+    { id: "outage-alerts", category: "IT", title: "Outage alerts", message: "Every 15 minutes, check the status pages of the tools we rely on, and message me in Slack as soon as something goes down.", apps: ["Firecrawl", "Slack"], asksFirst: [] },
+    { id: "software-request-check", category: "IT", title: "Software request check", message: "When someone asks for a new tool, check whether we already pay for something similar in our Airtable, and send me the request with that answer.", apps: ["Airtable"], asksFirst: [] },
+    { id: "morning-market-news", category: "Research", title: "Morning market news", message: "Every morning, search for news about our market and our top five customers, and send me anything worth knowing in five bullet points.", apps: ["Firecrawl"], asksFirst: [] },
+    { id: "regulation-watch", category: "Research", title: "Regulation watch", message: "Every Monday, check for new regulations or guidance that affect our industry in the countries we sell to, and summarise what changed.", apps: ["Firecrawl"], asksFirst: [] },
+    { id: "new-papers", category: "Research", title: "New papers", message: "Every Friday, find new papers about AI agents, and summarise the three most relevant, with links.", apps: ["Firecrawl"], asksFirst: [] },
+    { id: "grant-finder", category: "Research", title: "Grant finder", message: "Every month, find grants and funding programmes we could apply for, with their deadlines and requirements, in an Airtable list.", apps: ["Firecrawl", "Airtable"], asksFirst: [] },
+    { id: "company-brief", category: "Research", title: "Company brief", message: "When I send you a company name, research what it does, its size, funding, leadership and recent news, and write a one-page brief.", apps: ["Firecrawl"], asksFirst: [] },
+    { id: "weekly-kpis", category: "Data & reporting", title: "Weekly KPIs", message: "Every Monday at 8, pull revenue from Stripe, signups from PostHog and the number of open support emails, and send the leadership team one KPI summary.", apps: ["Stripe", "PostHog", "Gmail"], asksFirst: [] },
+    { id: "anomaly-alerts", category: "Data & reporting", title: "Anomaly alerts", message: "Every hour, check signups and payments, and message me in Slack if either is far below the usual for that time of day.", apps: ["Stripe", "PostHog", "Slack"], asksFirst: [] },
+    { id: "morning-database-report", category: "Data & reporting", title: "Morning database report", message: "Every morning, run our usual report queries on Supabase, and send me the results with anything that changed a lot.", apps: ["Supabase"], asksFirst: [] },
+    { id: "survey-analysis", category: "Data & reporting", title: "Survey analysis", message: "When a Typeform survey closes, read every response, group the answers into themes with counts and quotes, and write up the findings.", apps: ["Typeform"], asksFirst: [] },
+    { id: "evening-inbox-sort", category: "Personal", title: "Evening inbox sort", message: "Every evening, sort my inbox: label newsletters, archive receipts, and list the emails that need my reply tomorrow.", apps: ["Gmail"], asksFirst: [] },
+    { id: "morning-brief", category: "Personal", title: "Morning brief", message: "Every morning at 7, send me a short brief: today's top tasks from Todoist, the emails waiting on me, and the news I follow.", apps: ["Todoist", "Gmail", "Firecrawl"], asksFirst: [] },
+    { id: "reading-list", category: "Personal", title: "Reading list", message: "When I send you a link, read the article, save a three-line summary to my Notion reading list, and tag it by topic.", apps: ["Firecrawl", "Notion"], asksFirst: [] },
+    { id: "trip-planning", category: "Personal", title: "Trip planning", message: "When I tell you where I'm travelling and when, find flights and hotels near my meetings, and send me three options for each.", apps: ["Firecrawl"], asksFirst: [] },
+    { id: "weekly-review", category: "Personal", title: "Weekly review", message: "Every Friday afternoon, list what I finished in Todoist this week and what slipped, and suggest my three priorities for next week.", apps: ["Todoist"], asksFirst: [] },
+    { id: "unanswered-emails", category: "Personal", title: "Unanswered emails", message: "Every morning, find emails I sent over three days ago that never got a reply, and draft a polite follow-up for each. Ask me before sending.", apps: ["Gmail"], asksFirst: ["sending a follow-up"] },
+    { id: "listing-descriptions", category: "Real estate", title: "Listing descriptions", message: "When I send you a property's details, write the listing description and a short post for X, in our style.", apps: [], asksFirst: [] },
+    { id: "listing-enquiries", category: "Real estate", title: "Listing enquiries", message: "When someone asks about a listing by email, reply with its details and the next viewing times, and ask what they're looking for. Let me approve the first few replies.", apps: ["Gmail"], asksFirst: ["sending a reply"] },
+    { id: "student-questions", category: "Education", title: "Student questions", message: "When a student emails a question about the course, answer from our course handbook in Notion, and pass anything about grades or refunds to me.", apps: ["Gmail", "Notion"], asksFirst: [] },
+    { id: "lesson-plans", category: "Education", title: "Lesson plans", message: "When I give you a topic and a level, write a lesson plan with goals, activities and a short quiz.", apps: [], asksFirst: [] },
+    { id: "donor-thank-yous", category: "Nonprofits", title: "Donor thank-yous", message: "When a donation comes in through Stripe, draft a personal thank-you to the donor that mentions what their gift pays for. Ask me before sending.", apps: ["Stripe", "Gmail"], asksFirst: ["sending a thank-you"] },
+    { id: "grant-reports", category: "Nonprofits", title: "Grant reports", message: "Every quarter, collect our programme numbers from Airtable, and draft the report for each funder in their format.", apps: ["Airtable"], asksFirst: [] },
+    { id: "client-weekly-update", category: "Agencies", title: "Client weekly update", message: "Every Friday, write each client a short update on what we did this week from our Linear projects, for me to review before it's sent.", apps: ["Linear", "Gmail"], asksFirst: ["sending an update"] },
+    { id: "monthly-client-invoices", category: "Agencies", title: "Monthly client invoices", message: "At the end of each month, total each client's hours from our Airtable time log and draft their invoice in Stripe. Ask me before any invoice is sent.", apps: ["Airtable", "Stripe"], asksFirst: ["sending an invoice"] },
+];

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

@@ -4,6 +4,12 @@ export interface WorkflowExample {
     id: string;
     /** Groups examples on the page: "Customer service", "Operations"… */
     category: string;
+    /** Its card: what a person would type to describe it, the apps it
+     * works with, and what it asks before doing (the same as
+     * ./workflow-example-messages.ts and loopengine.co/workflows). */
+    message: string;
+    apps: string[];
+    asksFirst: string[];
     plan: WorkflowPlan;
 }
 export declare const WORKFLOW_EXAMPLES: readonly WorkflowExample[];

package/dist/core/system-agents/workflow-examples.js

@@ -69,10 +69,11 @@ Edit this: replace each [bracket] with your own policy. The agent checks claims
 `,
 };
 /** The parts every example's plan shares. */
-function example(id, category, plan) {
+function example(id, category, card, plan) {
     return {
         id,
         category,
+        ...card,
         plan: {
             parameters: {},
             notify: { on: false, reason: '' },
@@ -83,7 +84,7 @@ function example(id, category, plan) {
     };
 }
 export const WORKFLOW_EXAMPLES = [
-    example('customer-email-replies', 'Customer service', {
+    example('customer-email-replies', 'Customer service', { message: "Every 10 minutes, check our support inbox. For each customer email, look up their order in Shopify and our policies, and reply in the thread. Let me approve every reply, and leave refund requests for the team.", apps: ["Gmail", "Shopify"], asksFirst: ["sending a reply"] }, {
         name: 'Answer customer emails',
         id: 'answer-customer-emails',
         summary: 'Checks the support inbox every 10 minutes, looks up each customer\'s order and your policies, and replies. Every reply waits for your approval until you trust it; refund requests are left for a person.',
@@ -134,7 +135,7 @@ Rules:
         skills: [SUPPORT_POLICIES],
         notes: [policiesNote('your policies', 'support-policies')],
     }),
-    example('refund-approvals', 'Customer service', {
+    example('refund-approvals', 'Customer service', { message: "Every 10 minutes, find refund and return requests in our inbox. Check each against the Shopify order and our return policy, work out the amount, and refund it. Ask me before any refund or reply goes out.", apps: ["Gmail", "Shopify"], asksFirst: ["issuing a refund", "sending the reply"] }, {
         name: 'Refund approvals',
         id: '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.',
@@ -186,7 +187,7 @@ Rules:
         skills: [RETURN_POLICY],
         notes: [policiesNote('your return policy', 'return-policy')],
     }),
-    example('incident-triage', 'Operations', {
+    example('incident-triage', 'Operations', { message: "When our alerting tool sends an alert, rate how bad it is, check GitHub for the deploys and merged changes that likely caused it, and send me a short summary in Slack. Ask me before opening or commenting on an issue.", apps: ["GitHub", "Slack"], asksFirst: ["opening or commenting on issues"] }, {
         name: 'Triage an incident',
         id: 'triage-incident',
         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 you a summary. Opening or commenting on issues waits for approval.',
@@ -232,7 +233,7 @@ Rules:
         },
         notes: ['Send it alerts: add a webhook to this workflow (Workflows tab) with "Message me the result when it finishes" on, and paste its URL into your alerting tool; or mention it in Slack, or paste an alert into Chat'],
     }),
-    example('expense-approvals', 'Finance', {
+    example('expense-approvals', 'Finance', { message: "Every 15 minutes, read new claims in the claims inbox with their receipts, check each against our expense policy, and email the approver a one-line verdict. Never approve or pay anything yourself.", apps: ["Gmail"], asksFirst: ["replying to the claimant"] }, {
         name: 'Check expense claims',
         id: '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.',
@@ -277,7 +278,7 @@ Rules:
         skills: [EXPENSE_POLICY],
         notes: [policiesNote('your expense policy', 'expense-policy'), 'Set EXPENSE_APPROVER_EMAIL (Environment tab) to the approver\'s address'],
     }),
-    example('lead-follow-up', 'Sales', {
+    example('lead-follow-up', 'Sales', { message: "Every hour, pick up new leads in HubSpot, research each company on the web, and send a short, personal first email. Ask me before sending, and before updating the lead.", apps: ["HubSpot", "Firecrawl", "Gmail"], asksFirst: ["sending the first email", "updating the lead"] }, {
         name: 'Lead follow-up',
         id: 'lead-follow-up',
         summary: 'Every hour, picks up new leads in HubSpot, researches each on the web, and sends a short, personal first email. Sending and updating the CRM wait for your approval.',
@@ -329,7 +330,7 @@ Rules:
         },
         notes: ['Edit "What we sell" at the top of its instructions (Overview tab)'],
     }),
-    example('inbox-to-tasks', 'Operations', {
+    example('inbox-to-tasks', 'Operations', { message: "Every 10 minutes, turn each request in our shared inbox into a GitHub issue with an owner and a due date, then tell the sender who is handling it. Let me approve the reply.", apps: ["Gmail", "GitHub"], asksFirst: ["replying to the sender"] }, {
         name: 'Inbox to tasks',
         id: '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.',
@@ -382,7 +383,7 @@ Rules:
         },
         notes: ['Edit "Who handles what" and the repository at the top of its instructions (Overview tab)'],
     }),
-    example('weekly-research-digest', 'Research', {
+    example('weekly-research-digest', 'Research', { message: "Every Monday at 9, search the web for last week's news on our topics and competitors, and send me a short digest with links.", apps: ["Firecrawl", "Slack"], asksFirst: [] }, {
         name: 'Weekly research digest',
         id: 'weekly-research-digest',
         summary: 'Every Monday morning, searches the web for news on the topics you choose and sends you a short digest with links.',

package/dist/index.d.ts

@@ -88,6 +88,7 @@ export { workflowPageHtml } from './web/workflow-page.js';
 export { WorkflowError, checkWorkflowForAgent, createWorkflow, forgetWorkflow, migrateAgentWorkflows, getPlanJob, listAgentWorkflows, planWorkflow, resolveConnections, prepareWorkflowRun, updateWorkflow, startPlanJob, type AgentWorkflowView, type CreatedWorkflow, type PlanJob, type PlannedWorkflow, type WorkflowAgentInfo, type WorkflowCheck, type WorkflowConflict, type WorkflowCreateDeps, type WorkflowMcpDeps, type WorkflowMcpCreateDeps, resolveMcpServers, prepareMcpAbilities, } from './web/workflow-admin.js';
 export { WORKFLOW_PLANNER_PROMPT, planParameters, planWorkflowWithModel, validateWorkflowPlan, workflowTemplate, type WorkflowPlan, type WorkflowPlannerTools, type WorkflowStep } from './core/system-agents/workflow-planner.js';
 export { WORKFLOW_EXAMPLES, workflowExample, type WorkflowExample } from './core/system-agents/workflow-examples.js';
+export { WORKFLOW_EXAMPLE_MESSAGES, type WorkflowExampleMessage } from './core/system-agents/workflow-example-messages.js';
 export { createTrigger, updateTrigger, rotateTrigger, listTriggers, findTriggerByToken, publicTrigger, checkTriggerSettings, verifySenderSignature, parsePayload, valueAt, deliveryId, passesFilter, paramsFromPayload, recordDelivery as recordTriggerDelivery, FileTriggerStore, getTriggerStore, setTriggerStore, TriggerError, type WorkflowTrigger, type PublicTrigger, type TriggerSettings, type TriggerVerify, type TriggerFilter, type TriggerSender, type SignatureAlgorithm, type TriggerDelivery, type TriggerOutcome, type TriggerStore } from './core/workflow-triggers.js';
 export { checkCallbackUrl, callbackSecret, signCallback, deliverCallback, runCallbackPayload, isPrivateAddress, CallbackUrlError, type CallbackDelivery, type RunCallbackEvent } from './core/run-callbacks.js';
 export { WorkflowRunner, FileRunStore, getRunStore, setRunStore, listRuns, getRun, isUnderWay, RunError, type WorkflowRun, type WorkflowRunStatus, type RunStore, type ExecuteRun, type RunOutcome, type StartRunInput } from './core/workflow-runs.js';

package/dist/index.js

@@ -81,6 +81,7 @@ export { workflowPageHtml } from './web/workflow-page.js';
 export { WorkflowError, checkWorkflowForAgent, createWorkflow, forgetWorkflow, migrateAgentWorkflows, getPlanJob, listAgentWorkflows, planWorkflow, resolveConnections, prepareWorkflowRun, updateWorkflow, startPlanJob, resolveMcpServers, prepareMcpAbilities, } from './web/workflow-admin.js';
 export { WORKFLOW_PLANNER_PROMPT, planParameters, planWorkflowWithModel, validateWorkflowPlan, workflowTemplate } from './core/system-agents/workflow-planner.js';
 export { WORKFLOW_EXAMPLES, workflowExample } from './core/system-agents/workflow-examples.js';
+export { WORKFLOW_EXAMPLE_MESSAGES } from './core/system-agents/workflow-example-messages.js';
 export { createTrigger, updateTrigger, rotateTrigger, listTriggers, findTriggerByToken, publicTrigger, checkTriggerSettings, verifySenderSignature, parsePayload, valueAt, deliveryId, passesFilter, paramsFromPayload, recordDelivery as recordTriggerDelivery, FileTriggerStore, getTriggerStore, setTriggerStore, TriggerError } from './core/workflow-triggers.js';
 export { checkCallbackUrl, callbackSecret, signCallback, deliverCallback, runCallbackPayload, isPrivateAddress, CallbackUrlError } from './core/run-callbacks.js';
 export { WorkflowRunner, FileRunStore, getRunStore, setRunStore, listRuns, getRun, isUnderWay, RunError } from './core/workflow-runs.js';

package/dist/web/workflow-page.js

@@ -18,13 +18,26 @@ export const workflowPageHtml = `<!doctype html>
 <style>${devUiCss}
   .wf { max-width: 860px; display: grid; gap: 18px; }
   .wf textarea { width: 100%; min-height: 130px; box-sizing: border-box; font: inherit; padding: 10px 12px; border: 1px solid var(--line); border-radius: var(--radius); background: var(--surface); color: var(--ink); }
-  .wf-ex-group { display: grid; gap: 8px; }
-  .wf-ex-group h3 { margin: 4px 0 0; font-size: 12px; font-weight: 600; color: var(--ink-muted); text-transform: uppercase; letter-spacing: 0.05em; }
-  .wf-ex-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(260px, 1fr)); gap: 10px; }
-  .wf-ex { border: 1px solid var(--line); border-radius: var(--radius); padding: 12px 14px; display: grid; gap: 6px; align-content: start; background: var(--bg); }
+  .wf-ex-search { width: 100%; box-sizing: border-box; font: inherit; padding: 8px 12px; border: 1px solid var(--line); border-radius: var(--radius); background: var(--surface); color: var(--ink); }
+  .wf-ex-cats { display: flex; flex-wrap: wrap; gap: 6px; }
+  .wf-ex-cats button { font: inherit; font-size: 12.5px; font-weight: 600; padding: 5px 12px; border-radius: 999px; border: 1px solid var(--line); background: var(--bg); color: var(--ink); cursor: pointer; }
+  .wf-ex-cats button[aria-pressed="true"] { background: var(--ink); border-color: var(--ink); color: var(--bg); }
+  .wf-ex-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(240px, 1fr)); gap: 10px; }
+  .wf-ex { border: 1px solid var(--line); border-radius: var(--radius); padding: 12px 14px; display: flex; flex-direction: column; gap: 6px; background: var(--bg); }
+  .wf-ex:hover { border-color: var(--accent); }
+  .wf-ex-head { display: flex; gap: 6px; flex-wrap: wrap; align-items: center; }
+  .wf-ex-cat { font-size: 10.5px; font-weight: 600; letter-spacing: 0.05em; text-transform: uppercase; padding: 1px 8px; border-radius: 999px; background: var(--accent-soft); color: var(--accent-ink); }
   .wf-ex strong { font-size: 14px; }
   .wf-ex p { margin: 0; font-size: 13px; color: var(--ink-muted); }
-  .wf-ex .wf-btn { justify-self: start; }
+  .wf-ex-apps { display: flex; flex-wrap: wrap; gap: 4px; margin-top: auto; padding-top: 4px; }
+  .wf-ex-apps span { font-size: 11.5px; padding: 1px 6px; border: 1px solid var(--line); border-radius: 5px; background: var(--surface); color: var(--ink); }
+  .wf-ex-asks strong { font-size: 12px; color: var(--warn); }
+  .wf-ex .wf-btn { align-self: flex-start; margin-top: 4px; }
+  .wf-ex-pager { display: flex; flex-wrap: wrap; gap: 6px; justify-content: center; align-items: center; }
+  .wf-ex-pager button { font: inherit; font-size: 13px; font-weight: 600; min-width: 34px; padding: 5px 10px; border-radius: 6px; border: 1px solid var(--line); background: var(--bg); color: var(--ink); cursor: pointer; }
+  .wf-ex-pager button:not(:disabled):not([aria-current]):hover { border-color: var(--accent); background: var(--accent-soft); color: var(--accent-ink); }
+  .wf-ex-pager button[aria-current] { background: var(--ink); border-color: var(--ink); color: var(--bg); }
+  .wf-ex-pager button:disabled { opacity: 0.4; cursor: default; }
   .wf-instructions textarea { min-height: 180px; font-family: var(--font-mono); font-size: 12px; }
   .wf-card { border: 1px solid var(--line); border-radius: var(--radius); padding: 14px 16px; display: grid; gap: 10px; background: var(--bg); }
   .wf-card h2 { margin: 0; font-size: 18px; }
@@ -83,7 +96,8 @@ ${consoleShellScript}
   var DASH = String.fromCharCode(8212);
   var LABELS = { allow: 'Allow', ask: 'Ask me', deny: 'Never' };
   var SENDERS = { stripe: 'Stripe', github: 'GitHub', shopify: 'Shopify', standard: 'Standard Webhooks', custom: 'your app' };
-  var state = { description: '', planned: null, agents: [], examples: [], ready: false, canInstall: false };
+  var state = { description: '', planned: null, agents: [], examples: [], messages: [], ready: false, canInstall: false, exQuery: '', exCat: 'All', exPage: 1 };
+  var EX_PAGE = 6;
 
   function esc(s) {
     return String(s == null ? '' : s).replace(/[&<>"']/g, function (c) {
@@ -111,10 +125,7 @@ ${consoleShellScript}
       '<p class="hint">Rather start from something ready-made? <a href="#examples">Choose a workflow example</a>, or <a href="/interview">find your first agent</a>.</p>' +
       examplesHtml();
     var text = document.getElementById('wfText');
-    var examples = page.querySelectorAll('[data-example]');
-    for (var i = 0; i < examples.length; i++) {
-      examples[i].addEventListener('click', function (ev) { openExample(ev.currentTarget.dataset.example); });
-    }
+    wireExamples();
     if (location.hash === '#examples') {
       var box = document.getElementById('examples');
       if (box) box.scrollIntoView();
@@ -132,28 +143,113 @@ ${consoleShellScript}
     });
   }
 
-  // Ready-made plans, by category: opening one goes straight to the
-  // review, with nothing planned by a model.
+  // Examples: the ready-made ones (a plan, no model call) and the rest as
+  // messages (they fill in the description, for the planner), searched,
+  // filtered by area and paged.
+  function allExamples() {
+    return state.examples.map(function (e) {
+      return { id: e.id, category: e.category, title: e.plan.name, message: e.message, apps: e.apps || [], asksFirst: e.asksFirst || [], ready: true };
+    }).concat(state.messages.map(function (m) {
+      return { id: m.id, category: m.category, title: m.title, message: m.message, apps: m.apps || [], asksFirst: m.asksFirst || [], ready: false };
+    }));
+  }
+
   function examplesHtml() {
-    if (!state.examples.length) return '';
-    var groups = [];
-    state.examples.forEach(function (e) {
-      var g = groups.filter(function (x) { return x.name === e.category; })[0];
-      if (!g) { g = { name: e.category, items: [] }; groups.push(g); }
-      g.items.push(e);
-    });
+    if (!state.examples.length && !state.messages.length) return '';
     return '<div class="wf-card" id="examples"><h2>Start from an example</h2>' +
-      '<p class="hint" style="margin:0">Ready-made and tested. You see the whole plan, and can change it, before anything is created.</p>' +
-      groups.map(function (g) {
-        return '<div class="wf-ex-group"><h3>' + esc(g.name) + '</h3><div class="wf-ex-grid">' + g.items.map(function (e) {
-          return '<div class="wf-ex"><strong>' + esc(e.plan.name) + '</strong><p>' + esc(e.plan.summary) + '</p>' +
-            '<p><strong>Starts:</strong> ' + esc(e.plan.trigger.description) + '</p>' +
-            '<button type="button" class="wf-btn plain" data-example="' + esc(e.id) + '">Use this</button></div>';
-        }).join('') + '</div></div>';
-      }).join('') +
+      '<p class="hint" style="margin:0">Ready-made ones open the plan straight away. The rest fill in the description above, for you to change and plan.</p>' +
+      '<input type="search" class="wf-ex-search" id="wfExSearch" placeholder="Search examples, e.g. invoices, GitHub, Shopify" aria-label="Search examples" value="' + esc(state.exQuery) + '">' +
+      '<div class="wf-ex-cats" id="wfExCats" role="group" aria-label="Filter examples"></div>' +
+      '<div class="wf-ex-grid" id="wfExList"></div>' +
+      '<nav class="wf-ex-pager" id="wfExPager" aria-label="Example pages"></nav>' +
       '</div>';
   }
 
+  function exampleMatches(e) {
+    if (state.exCat !== 'All' && e.category !== state.exCat) return false;
+    var q = state.exQuery.trim().toLowerCase();
+    if (!q) return true;
+    var text = (e.title + ' ' + e.message + ' ' + e.category + ' ' + e.apps.join(' ')).toLowerCase();
+    return q.split(' ').every(function (word) { return !word || text.indexOf(word) !== -1; });
+  }
+
+  // The page numbers to show: first, last and around the current one.
+  function pageNumbers(current, count) {
+    var out = [];
+    for (var n = 1; n <= count; n++) {
+      if (n === 1 || n === count || Math.abs(n - current) <= 1) out.push(n);
+      else if (out[out.length - 1] !== null) out.push(null);
+    }
+    return out;
+  }
+
+  function renderExampleList() {
+    var list = document.getElementById('wfExList');
+    if (!list) return;
+    var all = allExamples();
+    var cats = ['All'];
+    all.forEach(function (e) { if (cats.indexOf(e.category) === -1) cats.push(e.category); });
+    document.getElementById('wfExCats').innerHTML = cats.map(function (c) {
+      return '<button type="button" data-ex-cat="' + esc(c) + '" aria-pressed="' + (c === state.exCat) + '">' + esc(c) + '</button>';
+    }).join('');
+    var matching = all.filter(exampleMatches);
+    var pages = Math.max(1, Math.ceil(matching.length / EX_PAGE));
+    if (state.exPage > pages) state.exPage = pages;
+    var shown = matching.slice((state.exPage - 1) * EX_PAGE, state.exPage * EX_PAGE);
+    list.innerHTML = shown.length ? shown.map(function (e) {
+      return '<div class="wf-ex">' +
+        '<div class="wf-ex-head"><span class="wf-ex-cat">' + esc(e.category) + '</span>' + (e.ready ? '<span class="le-pill good">Ready-made</span>' : '') + '</div>' +
+        '<strong>' + esc(e.title) + '</strong>' +
+        '<p>' + String.fromCharCode(8220) + esc(e.message) + String.fromCharCode(8221) + '</p>' +
+        (e.apps.length ? '<div class="wf-ex-apps">' + e.apps.map(function (a) { return '<span>' + esc(a) + '</span>'; }).join('') + '</div>' : '') +
+        (e.asksFirst.length ? '<p class="wf-ex-asks"><strong>Asks you before:</strong> ' + esc(e.asksFirst.join('; ')) + '</p>' : '') +
+        '<button type="button" class="wf-btn plain" data-example="' + esc(e.id) + '">' + (e.ready ? 'Use this plan' : 'Use this') + '</button>' +
+        '</div>';
+    }).join('') : '<p class="hint">No examples match ' + String.fromCharCode(8220) + esc(state.exQuery.trim()) + String.fromCharCode(8221) + (state.exCat === 'All' ? '' : ' in ' + esc(state.exCat)) + '. Describe it in your own words above instead.</p>';
+    var pager = document.getElementById('wfExPager');
+    pager.innerHTML = pages > 1
+      ? '<button type="button" data-ex-page="' + (state.exPage - 1) + '"' + (state.exPage === 1 ? ' disabled' : '') + '>' + String.fromCharCode(8249) + ' Previous</button>' +
+        pageNumbers(state.exPage, pages).map(function (n) {
+          return n === null ? '<span class="hint" aria-hidden="true">' + ELLIPSIS + '</span>'
+            : '<button type="button" data-ex-page="' + n + '" aria-label="Page ' + n + '"' + (n === state.exPage ? ' aria-current="page"' : '') + '>' + n + '</button>';
+        }).join('') +
+        '<button type="button" data-ex-page="' + (state.exPage + 1) + '"' + (state.exPage === pages ? ' disabled' : '') + '>Next ' + String.fromCharCode(8250) + '</button>'
+      : '';
+  }
+
+  function wireExamples() {
+    var box = document.getElementById('examples');
+    if (!box) return;
+    renderExampleList();
+    document.getElementById('wfExSearch').addEventListener('input', function (ev) {
+      state.exQuery = ev.target.value;
+      state.exPage = 1;
+      renderExampleList();
+    });
+    box.addEventListener('click', function (ev) {
+      var t = ev.target.closest('button');
+      if (!t) return;
+      if (t.dataset.exCat) { state.exCat = t.dataset.exCat; state.exPage = 1; renderExampleList(); return; }
+      if (t.dataset.exPage) { state.exPage = Number(t.dataset.exPage); renderExampleList(); box.scrollIntoView({ block: 'start' }); return; }
+      if (t.dataset.example) useExample(t.dataset.example);
+    });
+  }
+
+  // A ready-made example opens its plan; any other fills in the
+  // description, to change and plan.
+  function useExample(id) {
+    if (state.examples.some(function (e) { return e.id === id; })) { openExample(id); return; }
+    var m = state.messages.filter(function (x) { return x.id === id; })[0];
+    if (!m) return;
+    state.description = m.message;
+    renderDescribe();
+    window.scrollTo(0, 0);
+    var text = document.getElementById('wfText');
+    text.focus();
+    var status = document.getElementById('wfStatus');
+    if (status) status.textContent = 'Change it to fit what you need, then plan it.';
+  }
+
   function openExample(id) {
     var e = state.examples.filter(function (x) { return x.id === id; })[0];
     if (!e) return;
@@ -466,6 +562,7 @@ ${consoleShellScript}
       state.canInstall = Boolean(d.canInstallAbilities);
       state.agents = d.agents || [];
       state.examples = d.examples || [];
+      state.messages = d.messages || [];
       renderDescribe();
     })
     .catch(function (err) { page.innerHTML = '<p class="error">Could not load: ' + esc(err.message) + '</p>'; });

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "loopengine",
-  "version": "0.3.11",
+  "version": "0.3.13",
   "type": "module",
   "description": "Runtime for tool-using AI agents with a transparent ReAct loop.",
-  "license": "MIT",
+  "license": "FSL-1.1-MIT",
   "homepage": "https://loopengine.co",
   "repository": {
     "type": "git",
@@ -137,7 +137,8 @@
     "dist/web",
     "protocol/loop-event.schema.json",
     "PROTOCOL.md",
-    "LICENSE"
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md"
   ],
   "scripts": {
     "build": "tsc; s=$?; chmod +x dist/bin/cli.js; rm -rf dist/core/system-skills; cp -r core/system-skills dist/core/system-skills; tsx scripts/write-dist-package-json.ts; exit $s",