tinybeeai 0.0.0-stage → 0.16.1

package/dist/tinybee/workflows/skills.js

@@ -0,0 +1,227 @@
+// The skills library (docs/tinybee/05 section 6.2): starting points grouped the way the grid shows them.
+// The five localdost role presets are skills too (00-README: Skill = role preset), under Website & monitoring.
+import { ROLE_PRESETS } from '../../routes/roles.js';
+const base = { enabled: true, limits: { max_runtime_s: 120, max_tokens: 20_000, max_actions: 5 } };
+export const SKILLS = [
+    {
+        key: 'gmail-digest',
+        group: 'Inbox & messages',
+        emoji: '📬',
+        title: 'Inbox digest',
+        summary: 'Reads new mail and tells you what matters.',
+        bullets: [
+            'Checks your inbox every 10 minutes during the day',
+            'Sorts what needs you from what can wait',
+            'One push per thing that matters, the rest in the digest',
+        ],
+        accounts: ['gmail'],
+        schedule: 'Every 10 min, 7:00–21:00',
+        workflow: {
+            ...base,
+            name: 'Inbox digest',
+            emoji: '📬',
+            skill: 'gmail-digest',
+            trigger: { type: 'schedule', cron: '*/10 7-21 * * *' },
+            inputs: [{ connection: 'gmail', query: 'is:unread newer_than:1d' }],
+            agent: {
+                model_tier: 'cheap',
+                instructions: 'Read the new mail. Tell me only about mail that needs an answer from me or mentions money, a deadline or a customer. Everything else goes to the digest.',
+                tools: ['gmail.read', 'gmail.search', 'notify.push', 'digest.append'],
+                permissions: { 'notify.push': 'auto' },
+            },
+            outputs: [
+                { on: 'match', action: 'notify.push', template: '{{summary}}' },
+                { on: 'always', action: 'digest.append', template: '{{summary}}' },
+            ],
+        },
+    },
+    {
+        key: 'gmail-triage',
+        group: 'Inbox & messages',
+        emoji: '🏷️',
+        title: 'Label and draft replies',
+        summary: 'Labels new mail and drafts the easy replies for you.',
+        bullets: ['Labels mail by what it is about', 'Drafts a short reply when the answer is obvious', 'Never sends; you read the draft first'],
+        accounts: ['gmail'],
+        schedule: 'Every 30 min, 8:00–18:00',
+        workflow: {
+            ...base,
+            name: 'Label and draft replies',
+            emoji: '🏷️',
+            skill: 'gmail-triage',
+            trigger: { type: 'schedule', cron: '*/30 8-18 * * 1-5' },
+            inputs: [{ connection: 'gmail', query: 'is:unread -category:promotions newer_than:1d' }],
+            agent: {
+                model_tier: 'cheap',
+                instructions: 'Label each new mail (Invoice, Customer, Internal, Newsletter). When a mail asks a simple question I can answer in two sentences, draft the reply in my usual tone.',
+                tools: ['gmail.read', 'gmail.label', 'gmail.draft'],
+                permissions: { 'gmail.label': 'auto', 'gmail.draft': 'ask' },
+            },
+            outputs: [{ on: 'match', action: 'gmail.draft' }],
+        },
+    },
+    {
+        key: 'sheet-watch',
+        group: 'Sheets & documents',
+        emoji: '📊',
+        title: 'Watch a sheet',
+        summary: 'Tells you when a row changes or a number crosses a line.',
+        bullets: ['Reads one sheet range on a schedule', 'Compares it with the last run', 'Pushes a note when something changed'],
+        accounts: ['sheets'],
+        schedule: 'Every hour, 8:00–20:00',
+        workflow: {
+            ...base,
+            name: 'Watch a sheet',
+            emoji: '📊',
+            skill: 'sheet-watch',
+            trigger: { type: 'schedule', cron: '0 8-20 * * *' },
+            inputs: [{ connection: 'sheets', query: 'Sheet1!A1:F50' }],
+            agent: {
+                model_tier: 'cheap',
+                instructions: 'Compare the range with the last run. Tell me which rows changed and whether any total went down.',
+                tools: ['sheets.read', 'notify.push'],
+                permissions: {},
+            },
+            outputs: [{ on: 'match', action: 'notify.push', template: '{{summary}}' }],
+        },
+    },
+    {
+        key: 'drive-summary',
+        group: 'Sheets & documents',
+        emoji: '📄',
+        title: 'Summarize new documents',
+        summary: 'A short summary of every new file in a folder.',
+        bullets: ['Looks for new files in a Drive folder', 'Writes a five-line summary of each', 'Adds the summaries to the digest'],
+        accounts: ['drive'],
+        schedule: 'Daily at 18:00',
+        workflow: {
+            ...base,
+            name: 'Summarize new documents',
+            emoji: '📄',
+            skill: 'drive-summary',
+            trigger: { type: 'schedule', cron: '0 18 * * 1-5' },
+            inputs: [{ connection: 'drive', query: "modifiedTime > 'today' and mimeType != 'application/vnd.google-apps.folder'" }],
+            agent: {
+                model_tier: 'cheap',
+                instructions: 'Summarize each new document in five lines: what it is, who it is for, what it asks.',
+                tools: ['drive.read', 'drive.search', 'digest.append'],
+                permissions: {},
+            },
+            outputs: [{ on: 'always', action: 'digest.append', template: '{{summary}}' }],
+        },
+    },
+    {
+        key: 'morning-digest',
+        group: 'Reports & digests',
+        emoji: '☀️',
+        title: 'Morning digest',
+        summary: 'One message at 8:00 with everything from the night.',
+        bullets: ['Collects what the other workflows added to the digest', 'Writes it as one short message', 'Pushes it at 8:00 on weekdays'],
+        accounts: [],
+        schedule: 'Weekdays at 8:00',
+        workflow: {
+            ...base,
+            name: 'Morning digest',
+            emoji: '☀️',
+            skill: 'morning-digest',
+            trigger: { type: 'schedule', cron: '0 8 * * 1-5' },
+            inputs: [],
+            agent: {
+                model_tier: 'cheap',
+                instructions: 'Write the digest entries since the last digest as one message, most important first, at most ten lines.',
+                tools: ['notify.push'],
+                permissions: { 'notify.push': 'auto' },
+            },
+            outputs: [{ on: 'always', action: 'notify.push', template: '{{summary}}' }],
+        },
+    },
+    {
+        key: 'reminder',
+        group: 'Reminders',
+        emoji: '⏰',
+        title: 'Reminder',
+        summary: 'A push at the time you choose, with the words you choose.',
+        bullets: ['Runs at one time of day', 'Sends the text you wrote', 'No account needed'],
+        accounts: [],
+        schedule: 'Daily at 9:00',
+        workflow: {
+            ...base,
+            name: 'Reminder',
+            emoji: '⏰',
+            skill: 'reminder',
+            trigger: { type: 'schedule', cron: '0 9 * * *' },
+            inputs: [],
+            agent: { model_tier: 'local', instructions: 'Remind me: stand up and drink water.', tools: ['notify.push'], permissions: { 'notify.push': 'auto' } },
+            outputs: [{ on: 'always', action: 'notify.push', template: '{{instructions}}' }],
+        },
+    },
+    {
+        key: 'url-monitor',
+        group: 'Website & monitoring',
+        emoji: '🌐',
+        title: 'Watch a web page',
+        summary: 'Tells you when a page changes or stops answering.',
+        bullets: ['Fetches one URL on a schedule', 'Compares the text with the last run', 'Pushes a note when it changed or failed'],
+        accounts: [],
+        schedule: 'Every 15 min',
+        workflow: {
+            ...base,
+            name: 'Watch a web page',
+            emoji: '🌐',
+            skill: 'url-monitor',
+            trigger: { type: 'schedule', cron: '*/15 * * * *' },
+            inputs: [{ connection: 'web', query: 'https://example.com/status' }],
+            agent: {
+                model_tier: 'local',
+                instructions: 'Tell me when the page text changes or the page does not answer.',
+                tools: ['web.fetch', 'notify.push'],
+                permissions: { 'notify.push': 'auto' },
+            },
+            outputs: [
+                { on: 'match', action: 'notify.push', template: '{{summary}}' },
+                { on: 'error', action: 'notify.push', template: 'The page did not answer: {{summary}}' },
+            ],
+        },
+    },
+];
+const ROLE_EMOJI = { 'product-area': '🧩', 'qa-lead': '🧑‍✈️', 'release-guard': '🛡️', 'ticket-reviewer': '🎫', 'prod-watcher': '📡' };
+/** The localdost role presets as skills: a dot of that role, created through the dots API. */
+export function roleSkills() {
+    return ROLE_PRESETS.filter((p) => p.key !== 'custom').map((p) => ({
+        key: `role:${p.key}`,
+        group: 'Website & monitoring',
+        emoji: ROLE_EMOJI[p.key] ?? '🤖',
+        title: p.label,
+        summary: p.description,
+        bullets: [
+            p.defaults.mission ?? p.description,
+            p.defaults.notifyWhen ?? 'Tells you when something breaks.',
+            p.defaults.mustNot ?? 'Never merges or reverts.',
+        ],
+        accounts: ['github'],
+        schedule: 'On every change',
+        workflow: {
+            ...base,
+            name: p.label,
+            emoji: ROLE_EMOJI[p.key] ?? '🤖',
+            skill: `role:${p.key}`,
+            trigger: { type: 'event', event: 'github/push' },
+            inputs: [{ connection: 'github', query: '' }],
+            agent: {
+                model_tier: 'strong',
+                instructions: p.defaults.instructions ?? p.defaults.mission ?? '',
+                tools: ['notify.push'],
+                permissions: { 'notify.push': 'auto' },
+            },
+            outputs: [{ on: 'match', action: 'notify.push', template: '{{summary}}' }],
+        },
+    }));
+}
+export function allSkills() {
+    return [...SKILLS, ...roleSkills()];
+}
+export function skillByKey(key) {
+    return allSkills().find((s) => s.key === key);
+}
+export const SKILL_GROUPS = ['Inbox & messages', 'Sheets & documents', 'Reports & digests', 'Reminders', 'Website & monitoring'];
+//# sourceMappingURL=skills.js.map

package/dist/tinybee/workflows/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../../src/tinybee/workflows/skills.ts"],"names":[],"mappings":"AAAA,yGAAyG;AACzG,+GAA+G;AAC/G,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAsBrD,MAAM,IAAI,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;AAEnG,MAAM,CAAC,MAAM,MAAM,GAAY;IAC7B;QACE,GAAG,EAAE,cAAc;QACnB,KAAK,EAAE,kBAAkB;QACzB,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,cAAc;QACrB,OAAO,EAAE,4CAA4C;QACrD,OAAO,EAAE;YACP,mDAAmD;YACnD,yCAAyC;YACzC,yDAAyD;SAC1D;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,QAAQ,EAAE,0BAA0B;QACpC,QAAQ,EAAE;YACR,GAAG,IAAI;YACP,IAAI,EAAE,cAAc;YACpB,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,cAAc;YACrB,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,iBAAiB,EAAE;YACtD,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;YACnE,KAAK,EAAE;gBACL,UAAU,EAAE,OAAO;gBACnB,YAAY,EACV,0JAA0J;gBAC5J,KAAK,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,CAAC;gBACrE,WAAW,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE;aACvC;YACD,OAAO,EAAE;gBACP,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE;gBAC/D,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,EAAE;aACnE;SACF;KACF;IACD;QACE,GAAG,EAAE,cAAc;QACnB,KAAK,EAAE,kBAAkB;QACzB,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,yBAAyB;QAChC,OAAO,EAAE,sDAAsD;QAC/D,OAAO,EAAE,CAAC,iCAAiC,EAAE,iDAAiD,EAAE,uCAAuC,CAAC;QACxI,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,QAAQ,EAAE,0BAA0B;QACpC,QAAQ,EAAE;YACR,GAAG,IAAI;YACP,IAAI,EAAE,yBAAyB;YAC/B,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,cAAc;YACrB,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,mBAAmB,EAAE;YACxD,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,8CAA8C,EAAE,CAAC;YACxF,KAAK,EAAE;gBACL,UAAU,EAAE,OAAO;gBACnB,YAAY,EACV,oKAAoK;gBACtK,KAAK,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,aAAa,CAAC;gBACnD,WAAW,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE;aAC7D;YACD,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;SAClD;KACF;IACD;QACE,GAAG,EAAE,aAAa;QAClB,KAAK,EAAE,oBAAoB;QAC3B,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,eAAe;QACtB,OAAO,EAAE,0DAA0D;QACnE,OAAO,EAAE,CAAC,qCAAqC,EAAE,+BAA+B,EAAE,sCAAsC,CAAC;QACzH,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,QAAQ,EAAE,wBAAwB;QAClC,QAAQ,EAAE;YACR,GAAG,IAAI;YACP,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE;YACnD,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;YAC1D,KAAK,EAAE;gBACL,UAAU,EAAE,OAAO;gBACnB,YAAY,EAAE,kGAAkG;gBAChH,KAAK,EAAE,CAAC,aAAa,EAAE,aAAa,CAAC;gBACrC,WAAW,EAAE,EAAE;aAChB;YACD,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;SAC3E;KACF;IACD;QACE,GAAG,EAAE,eAAe;QACpB,KAAK,EAAE,oBAAoB;QAC3B,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,yBAAyB;QAChC,OAAO,EAAE,gDAAgD;QACzD,OAAO,EAAE,CAAC,uCAAuC,EAAE,oCAAoC,EAAE,kCAAkC,CAAC;QAC5H,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,QAAQ,EAAE,gBAAgB;QAC1B,QAAQ,EAAE;YACR,GAAG,IAAI;YACP,IAAI,EAAE,yBAAyB;YAC/B,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,eAAe;YACtB,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE;YACnD,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,6EAA6E,EAAE,CAAC;YACvH,KAAK,EAAE;gBACL,UAAU,EAAE,OAAO;gBACnB,YAAY,EAAE,qFAAqF;gBACnG,KAAK,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,eAAe,CAAC;gBACtD,WAAW,EAAE,EAAE;aAChB;YACD,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;SAC9E;KACF;IACD;QACE,GAAG,EAAE,gBAAgB;QACrB,KAAK,EAAE,mBAAmB;QAC1B,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,gBAAgB;QACvB,OAAO,EAAE,qDAAqD;QAC9D,OAAO,EAAE,CAAC,uDAAuD,EAAE,gCAAgC,EAAE,+BAA+B,CAAC;QACrI,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,kBAAkB;QAC5B,QAAQ,EAAE;YACR,GAAG,IAAI;YACP,IAAI,EAAE,gBAAgB;YACtB,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,gBAAgB;YACvB,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,EAAE;YAClD,MAAM,EAAE,EAAE;YACV,KAAK,EAAE;gBACL,UAAU,EAAE,OAAO;gBACnB,YAAY,EAAE,yGAAyG;gBACvH,KAAK,EAAE,CAAC,aAAa,CAAC;gBACtB,WAAW,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE;aACvC;YACD,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;SAC5E;KACF;IACD;QACE,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,WAAW;QAClB,KAAK,EAAE,GAAG;QACV,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,2DAA2D;QACpE,OAAO,EAAE,CAAC,yBAAyB,EAAE,0BAA0B,EAAE,mBAAmB,CAAC;QACrF,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,eAAe;QACzB,QAAQ,EAAE;YACR,GAAG,IAAI;YACP,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE;YAChD,MAAM,EAAE,EAAE;YACV,KAAK,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,sCAAsC,EAAE,KAAK,EAAE,CAAC,aAAa,CAAC,EAAE,WAAW,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE;YACpJ,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC;SACjF;KACF;IACD;QACE,GAAG,EAAE,aAAa;QAClB,KAAK,EAAE,sBAAsB;QAC7B,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,kBAAkB;QACzB,OAAO,EAAE,mDAAmD;QAC5D,OAAO,EAAE,CAAC,+BAA+B,EAAE,qCAAqC,EAAE,yCAAyC,CAAC;QAC5H,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,cAAc;QACxB,QAAQ,EAAE;YACR,GAAG,IAAI;YACP,IAAI,EAAE,kBAAkB;YACxB,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE;YACnD,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC;YACpE,KAAK,EAAE;gBACL,UAAU,EAAE,OAAO;gBACnB,YAAY,EAAE,iEAAiE;gBAC/E,KAAK,EAAE,CAAC,WAAW,EAAE,aAAa,CAAC;gBACnC,WAAW,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE;aACvC;YACD,OAAO,EAAE;gBACP,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE;gBAC/D,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,sCAAsC,EAAE;aACzF;SACF;KACF;CACF,CAAC;AAEF,MAAM,UAAU,GAA2B,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;AAE/J,8FAA8F;AAC9F,MAAM,UAAU,UAAU;IACxB,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChE,GAAG,EAAE,QAAQ,CAAC,CAAC,GAAG,EAAE;QACpB,KAAK,EAAE,sBAA+B;QACtC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI;QAChC,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,OAAO,EAAE,CAAC,CAAC,WAAW;QACtB,OAAO,EAAE;YACP,CAAC,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC,WAAW;YACnC,CAAC,CAAC,QAAQ,CAAC,UAAU,IAAI,kCAAkC;YAC3D,CAAC,CAAC,QAAQ,CAAC,OAAO,IAAI,0BAA0B;SACrB;QAC7B,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,QAAQ,EAAE,iBAAiB;QAC3B,QAAQ,EAAE;YACR,GAAG,IAAI;YACP,IAAI,EAAE,CAAC,CAAC,KAAK;YACb,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI;YAChC,KAAK,EAAE,QAAQ,CAAC,CAAC,GAAG,EAAE;YACtB,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE;YAChD,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YAC7C,KAAK,EAAE;gBACL,UAAU,EAAE,QAAQ;gBACpB,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,YAAY,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE;gBACjE,KAAK,EAAE,CAAC,aAAa,CAAC;gBACtB,WAAW,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE;aACvC;YACD,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;SAC3E;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAiB,CAAC,kBAAkB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,WAAW,EAAE,sBAAsB,CAAC,CAAC"}

package/dist/tinybee/workflows/store.js

@@ -0,0 +1,205 @@
+// Where workflows live: each is a dot (`watches` row) with `workflow` set to its definition, `paused`
+// mirroring `enabled`, and `rules` derived from the permissions, so gate(), runs and approvals need
+// nothing new. Seen items (section 6.3 idempotency) and digest entries have small tables of their own.
+import { db, createWatch, get, list, newId, remove, update } from '../../db.js';
+import { cronSummary, isValidCron, nextRuns, CronInvalid, parseCron } from './cron.js';
+import { normalizeWorkflow, rulesOf, slugOf, WorkflowInvalid } from './types.js';
+import { toYaml } from './yaml.js';
+/** Workflows are custom dots: no localdost role preset applies. */
+export const WORKFLOW_ROLE = 'custom';
+export function isWorkflowWatch(w) {
+    return !!w && typeof w.workflow === 'object' && w.workflow !== null;
+}
+let ensured = false;
+export function ensureTables() {
+    if (ensured)
+        return;
+    db.exec(`CREATE TABLE IF NOT EXISTS tb_seen (watchId TEXT NOT NULL, key TEXT NOT NULL, at TEXT NOT NULL, PRIMARY KEY (watchId, key))`);
+    db.exec(`CREATE TABLE IF NOT EXISTS tb_digest (id TEXT PRIMARY KEY, watchId TEXT NOT NULL, runId TEXT, at TEXT NOT NULL, text TEXT NOT NULL, read INTEGER NOT NULL DEFAULT 0)`);
+    db.exec(`CREATE TABLE IF NOT EXISTS tb_notes (id TEXT PRIMARY KEY, watchId TEXT NOT NULL, at TEXT NOT NULL, text TEXT NOT NULL)`);
+    ensured = true;
+}
+/** Throws WorkflowInvalid when the definition cannot be stored. */
+export function validateWorkflow(input) {
+    const def = normalizeWorkflow(input);
+    if (def.trigger.type === 'schedule') {
+        try {
+            parseCron(def.trigger.cron ?? '');
+        }
+        catch (err) {
+            throw new WorkflowInvalid('trigger.cron', err instanceof CronInvalid ? err.message : 'Bad schedule.');
+        }
+    }
+    return def;
+}
+function uniqueId(base, exceptWatchId) {
+    const taken = new Set(listWorkflowWatches()
+        .filter((w) => w.id !== exceptWatchId)
+        .map((w) => w.workflow.id));
+    if (!taken.has(base))
+        return base;
+    for (let n = 2; n < 1000; n++)
+        if (!taken.has(`${base}-${n}`))
+            return `${base}-${n}`;
+    return `${base}-${newId().slice(0, 6)}`;
+}
+function watchFieldsOf(def) {
+    return {
+        name: def.name,
+        mission: def.agent.instructions || def.name,
+        notifyWhen: def.outputs.some((o) => o.action === 'notify.push') ? 'When the workflow finds something.' : 'Never by itself.',
+        mustNot: 'Never send, label or write anything the permissions do not allow.',
+        rules: rulesOf(def),
+        paused: !def.enabled,
+        role: WORKFLOW_ROLE,
+        mascot: 'pip',
+        instructions: def.agent.instructions,
+        connections: Array.from(new Set(def.inputs.map((i) => i.connection))),
+        probes: [],
+        statusPages: [],
+    };
+}
+export function listWorkflowWatches() {
+    ensureTables();
+    return list('watches')
+        .filter((w) => isWorkflowWatch(w) && !w.archived)
+        .map((w) => w);
+}
+export function workflowWatch(idOrWatchId) {
+    ensureTables();
+    const byWatch = get('watches', idOrWatchId);
+    if (isWorkflowWatch(byWatch) && !byWatch.archived)
+        return byWatch;
+    return listWorkflowWatches().find((w) => w.workflow.id === idOrWatchId);
+}
+export function createWorkflow(input) {
+    ensureTables();
+    const def = validateWorkflow(input);
+    def.id = uniqueId(def.id || slugOf(def.name));
+    const w = createWatch({ ...watchFieldsOf(def), name: def.name, workflow: def });
+    return w;
+}
+export function updateWorkflow(idOrWatchId, patch) {
+    const w = workflowWatch(idOrWatchId);
+    if (!w)
+        return undefined;
+    const merged = deepMerge(w.workflow, patch);
+    const def = validateWorkflow(merged);
+    def.id = w.workflow.id;
+    update('watches', w.id, { ...watchFieldsOf(def), workflow: def, updatedAt: new Date().toISOString() });
+    return get('watches', w.id);
+}
+export function toggleWorkflow(idOrWatchId, enabled) {
+    const w = workflowWatch(idOrWatchId);
+    if (!w)
+        return undefined;
+    return updateWorkflow(w.id, { enabled: enabled ?? !w.workflow.enabled });
+}
+export function deleteWorkflow(idOrWatchId) {
+    const w = workflowWatch(idOrWatchId);
+    if (!w)
+        return false;
+    remove('watches', w.id);
+    db.prepare('DELETE FROM tb_seen WHERE watchId = ?').run(w.id);
+    return true;
+}
+export function duplicateWorkflow(idOrWatchId) {
+    const w = workflowWatch(idOrWatchId);
+    if (!w)
+        return undefined;
+    return createWorkflow({ ...w.workflow, id: '', name: `${w.workflow.name} copy`, enabled: false });
+}
+function deepMerge(base, patch) {
+    if (!patch || typeof patch !== 'object' || Array.isArray(patch))
+        return base;
+    const out = { ...base };
+    for (const [k, v] of Object.entries(patch)) {
+        const cur = out[k];
+        if (v && typeof v === 'object' && !Array.isArray(v) && cur && typeof cur === 'object' && !Array.isArray(cur))
+            out[k] = deepMerge(cur, v);
+        else
+            out[k] = v;
+    }
+    return out;
+}
+export function triggerSummary(def) {
+    const t = def.trigger;
+    if (t.type === 'manual')
+        return 'Only when I ask';
+    if (t.type === 'event')
+        return `When something happens: ${t.event ?? ''}`.trim();
+    return isValidCron(t.cron ?? '') ? cronSummary(t.cron ?? '') : 'Bad schedule';
+}
+export function nextRunTimes(def, from = new Date(), n = 3) {
+    if (def.trigger.type !== 'schedule' || !def.enabled || !isValidCron(def.trigger.cron ?? ''))
+        return [];
+    return nextRuns(def.trigger.cron ?? '', def.trigger.timezone, from, n).map((d) => d.toISOString());
+}
+export function outcomeOf(run) {
+    if (run.status === 'running')
+        return 'running';
+    if (run.status === 'cancelled')
+        return 'cancelled';
+    if (run.status === 'failed' || run.status === 'interrupted')
+        return 'failed';
+    if (run.actions.some((a) => a.result === 'pending_approval') || run.steps.some((s) => s.status === 'warn' || s.status === 'error'))
+        return 'warn';
+    return 'ok';
+}
+export function lastRunOf(watchId) {
+    const [run] = list('runs', { watchId }, { orderBy: 'createdAt DESC', limit: 1 });
+    if (!run)
+        return null;
+    return { id: run.id, status: run.status, outcome: outcomeOf(run), at: run.finishedAt ?? run.createdAt };
+}
+export function workflowView(w, now = new Date()) {
+    const def = w.workflow;
+    return {
+        ...def,
+        watchId: w.id,
+        createdAt: w.createdAt,
+        updatedAt: w.updatedAt ?? w.createdAt,
+        triggerSummary: triggerSummary(def),
+        nextRuns: nextRunTimes(def, now),
+        lastRun: lastRunOf(w.id),
+    };
+}
+/** The YAML file of a workflow, the shape of section 6.1. */
+export function workflowYaml(def) {
+    const { id, name, emoji, enabled, trigger, inputs, agent, outputs, limits, skill } = def;
+    return toYaml({ id, name, ...(emoji ? { emoji } : {}), enabled, ...(skill ? { skill } : {}), trigger, inputs, agent, outputs, limits });
+}
+// Seen items: a run skips what an earlier run already handled.
+export function markSeen(watchId, keys, at = new Date()) {
+    ensureTables();
+    const ins = db.prepare('INSERT OR IGNORE INTO tb_seen (watchId, key, at) VALUES (?, ?, ?)');
+    let n = 0;
+    for (const k of keys)
+        n += Number(ins.run(watchId, k, at.toISOString()).changes);
+    return n;
+}
+export function unseen(watchId, keys) {
+    ensureTables();
+    const q = db.prepare('SELECT 1 FROM tb_seen WHERE watchId = ? AND key = ?');
+    return keys.filter((k) => !q.get(watchId, k));
+}
+export function appendDigest(watchId, runId, text) {
+    ensureTables();
+    const e = { id: newId(), watchId, runId: runId ?? null, at: new Date().toISOString(), text, read: false };
+    db.prepare('INSERT INTO tb_digest (id, watchId, runId, at, text, read) VALUES (?, ?, ?, ?, ?, 0)').run(e.id, e.watchId, e.runId, e.at, e.text);
+    return e;
+}
+export function listDigest(opts = {}) {
+    ensureTables();
+    const rows = db.prepare(`SELECT * FROM tb_digest${opts.unreadOnly ? ' WHERE read = 0' : ''} ORDER BY at DESC LIMIT ?`).all(opts.limit ?? 50);
+    return rows.map((r) => ({ ...r, read: r.read === 1 }));
+}
+export function addNote(watchId, text) {
+    ensureTables();
+    db.prepare('INSERT INTO tb_notes (id, watchId, at, text) VALUES (?, ?, ?, ?)').run(newId(), watchId, new Date().toISOString(), text);
+}
+export function listNotes(watchId, limit = 20) {
+    ensureTables();
+    return db.prepare('SELECT at, text FROM tb_notes WHERE watchId = ? ORDER BY at DESC LIMIT ?').all(watchId, limit);
+}
+//# sourceMappingURL=store.js.map

package/dist/tinybee/workflows/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/tinybee/workflows/store.ts"],"names":[],"mappings":"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"}

package/dist/tinybee/workflows/types.js

@@ -0,0 +1,180 @@
+export const DEFAULT_LIMITS = { max_runtime_s: 120, max_tokens: 20_000, max_actions: 5 };
+/** The tool registry (section 7). Reads run by themselves; everything that leaves the laptop asks first. */
+export const TOOL_REGISTRY = [
+    { name: 'gmail.read', kind: 'read', connection: 'gmail', label: 'Read Gmail' },
+    { name: 'gmail.search', kind: 'read', connection: 'gmail', label: 'Search Gmail' },
+    { name: 'gmail.label', kind: 'write', connection: 'gmail', label: 'Label or move mail' },
+    { name: 'gmail.draft', kind: 'write', connection: 'gmail', label: 'Draft a reply' },
+    { name: 'gmail.send', kind: 'send', connection: 'gmail', label: 'Send mail' },
+    { name: 'drive.read', kind: 'read', connection: 'drive', label: 'Read Drive files' },
+    { name: 'drive.search', kind: 'read', connection: 'drive', label: 'Search Drive' },
+    { name: 'sheets.read', kind: 'read', connection: 'sheets', label: 'Read a sheet' },
+    { name: 'sheets.append', kind: 'write', connection: 'sheets', label: 'Write to a sheet' },
+    { name: 'web.fetch', kind: 'read', label: 'Fetch a web page' },
+    { name: 'notify.push', kind: 'send', label: 'Notify me' },
+    { name: 'digest.append', kind: 'internal', label: 'Add to digest' },
+    { name: 'memory.note', kind: 'internal', label: 'Remember a note' },
+];
+export const TOOL_NAMES = new Set(TOOL_REGISTRY.map((t) => t.name));
+/** Global defaults (section 7): reads and internal tools run, writes and sends ask. */
+export function defaultPermission(tool) {
+    const t = TOOL_REGISTRY.find((x) => x.name === tool);
+    return !t || t.kind === 'read' || t.kind === 'internal' ? 'auto' : 'ask';
+}
+export function permissionOf(def, tool) {
+    return def.agent.permissions[tool] ?? defaultPermission(tool);
+}
+/** Which localdost rule a tool runs under: pushes are `push_notify`, connection writes are `mcp_tool`. */
+export function actionKindOf(tool) {
+    if (tool === 'notify.push')
+        return 'push_notify';
+    const t = TOOL_REGISTRY.find((x) => x.name === tool);
+    if (!t || t.kind === 'read' || t.kind === 'internal')
+        return null;
+    return 'mcp_tool';
+}
+export const PERMISSION_TO_RULE = { auto: 'act', ask: 'ask', deny: 'hand_off' };
+/** The rules of the dot behind a workflow: the strictest permission of every tool that shares a rule wins. */
+export function rulesOf(def) {
+    const order = ['act', 'ask', 'hand_off'];
+    const out = {};
+    for (const tool of def.agent.tools) {
+        const kind = actionKindOf(tool);
+        if (!kind)
+            continue;
+        const level = PERMISSION_TO_RULE[permissionOf(def, tool)];
+        const cur = out[kind];
+        if (!cur || order.indexOf(level) > order.indexOf(cur))
+            out[kind] = level;
+    }
+    // Outputs that are not listed as tools still count.
+    return out;
+}
+export class WorkflowInvalid extends Error {
+    field;
+    constructor(field, message) {
+        super(message);
+        this.field = field;
+        this.name = 'WorkflowInvalid';
+    }
+}
+const str = (v, max = 2000) => (typeof v === 'string' ? v.trim().slice(0, max) : '');
+const obj = (v) => (v && typeof v === 'object' && !Array.isArray(v) ? v : {});
+const arr = (v) => (Array.isArray(v) ? v : []);
+const int = (v, fallback, min, max) => {
+    const n = typeof v === 'number' ? v : typeof v === 'string' && v.trim() ? Number(v) : NaN;
+    if (!Number.isFinite(n))
+        return fallback;
+    return Math.min(max, Math.max(min, Math.round(n)));
+};
+export function slugOf(name) {
+    const s = name
+        .toLowerCase()
+        .normalize('NFKD')
+        .replace(/[̀-ͯ]/g, '')
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 40);
+    return s || 'workflow';
+}
+/**
+ * Turns a loose object (from the editor, from YAML or from the model) into a definition, filling the
+ * defaults and refusing what cannot run. `id` is kept when given; the store assigns one otherwise.
+ */
+export function normalizeWorkflow(input, opts = {}) {
+    const raw = obj(input);
+    const name = str(raw.name, 80);
+    if (!name && opts.requireName !== false)
+        throw new WorkflowInvalid('name', 'Give the workflow a name.');
+    const t = obj(raw.trigger);
+    const type = t.type === 'event' || t.type === 'manual' ? t.type : 'schedule';
+    const trigger = { type };
+    if (type === 'schedule') {
+        trigger.cron = str(t.cron, 60) || '0 8 * * *';
+        const tz = str(t.timezone, 60);
+        if (tz) {
+            try {
+                new Intl.DateTimeFormat('en-GB', { timeZone: tz });
+            }
+            catch {
+                throw new WorkflowInvalid('trigger.timezone', `Unknown time zone "${tz}".`);
+            }
+            trigger.timezone = tz;
+        }
+    }
+    else if (type === 'event') {
+        trigger.event = str(t.event, 80);
+        if (!trigger.event)
+            throw new WorkflowInvalid('trigger.event', 'Say which event starts the workflow, for example gmail/message.new.');
+    }
+    const inputs = arr(raw.inputs)
+        .map((i) => ({ connection: str(obj(i).connection, 80), query: str(obj(i).query, 500) }))
+        .filter((i) => i.connection);
+    const a = obj(raw.agent);
+    const tier = a.model_tier === 'strong' || a.model_tier === 'local' ? a.model_tier : 'cheap';
+    const tools = Array.from(new Set(arr(a.tools)
+        .map((x) => str(x, 40))
+        .filter(Boolean)));
+    for (const tool of tools)
+        if (!TOOL_NAMES.has(tool))
+            throw new WorkflowInvalid('agent.tools', `Unknown tool "${tool}".`);
+    const permissions = {};
+    for (const [k, v] of Object.entries(obj(a.permissions))) {
+        if (!TOOL_NAMES.has(k))
+            throw new WorkflowInvalid('agent.permissions', `Unknown tool "${k}" in permissions.`);
+        if (v === 'auto' || v === 'ask' || v === 'deny')
+            permissions[k] = v;
+        else if (v === 'off' || v === false)
+            permissions[k] = 'deny';
+        else if (v === true)
+            permissions[k] = 'auto';
+        else
+            throw new WorkflowInvalid('agent.permissions', `Permission for ${k} must be auto, ask or deny.`);
+    }
+    const outputs = [];
+    for (const o of arr(raw.outputs)) {
+        const r = obj(o);
+        const action = str(r.action, 40);
+        if (!action)
+            continue;
+        if (!TOOL_NAMES.has(action) || (actionKindOf(action) === null && action !== 'digest.append' && action !== 'memory.note'))
+            throw new WorkflowInvalid('outputs', `"${action}" is not an output action.`);
+        const on = r.on === 'match' || r.on === 'error' ? r.on : 'always';
+        const template = str(r.template, 1000);
+        outputs.push({ on, action: action, ...(template ? { template } : {}) });
+    }
+    // Every output tool is a tool the agent may use, so its permission has a place to live.
+    for (const o of outputs)
+        if (!tools.includes(o.action))
+            tools.push(o.action);
+    const l = obj(raw.limits);
+    const limits = {
+        max_runtime_s: int(l.max_runtime_s, DEFAULT_LIMITS.max_runtime_s, 10, 3600),
+        max_tokens: int(l.max_tokens, DEFAULT_LIMITS.max_tokens, 500, 500_000),
+        max_actions: int(l.max_actions, DEFAULT_LIMITS.max_actions, 0, 100),
+    };
+    const def = {
+        id: str(raw.id, 60) || '',
+        name: name || 'Untitled workflow',
+        enabled: raw.enabled === undefined ? true : raw.enabled === true || raw.enabled === 'true',
+        trigger,
+        inputs,
+        agent: {
+            model_tier: tier,
+            instructions: str(a.instructions, 4000),
+            tools,
+            permissions,
+            ...(str(a.output_language, 40) ? { output_language: str(a.output_language, 40) } : {}),
+        },
+        outputs,
+        limits,
+    };
+    const emoji = str(raw.emoji, 8);
+    if (emoji)
+        def.emoji = emoji;
+    const skill = str(raw.skill, 60);
+    if (skill)
+        def.skill = skill;
+    return def;
+}
+//# sourceMappingURL=types.js.map