tinybeeai 0.0.0-stage → 0.16.1

package/dist/tinybee/well-known.js.map

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

package/dist/tinybee/workflows/activity.js

@@ -0,0 +1,23 @@
+// What the engine is doing right now, kept apart from the engine so the Bee updater can ask without pulling
+// the whole workflow stack (and its import cycle through the relay client) into bee/status.ts.
+const running = new Set();
+let lastFinishedAt = 0;
+/** engine.ts: a run started / ended for this workflow. */
+export function runStarted(workflowId) {
+    running.add(workflowId);
+}
+export function runFinished(workflowId) {
+    running.delete(workflowId);
+    lastFinishedAt = Date.now();
+}
+export function isRunning(workflowId) {
+    return running.has(workflowId);
+}
+export function runningCount() {
+    return running.size;
+}
+/** For the updater: whether a run is going and when the last one ended (epoch ms, 0 when none since start). */
+export function workflowActivity() {
+    return { running: running.size, lastFinishedAt };
+}
+//# sourceMappingURL=activity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../../src/tinybee/workflows/activity.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,+FAA+F;AAC/F,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;AAClC,IAAI,cAAc,GAAG,CAAC,CAAC;AAEvB,0DAA0D;AAC1D,MAAM,UAAU,UAAU,CAAC,UAAkB;IAC3C,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AAC1B,CAAC;AACD,MAAM,UAAU,WAAW,CAAC,UAAkB;IAC5C,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC3B,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAC9B,CAAC;AACD,MAAM,UAAU,SAAS,CAAC,UAAkB;IAC1C,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AACjC,CAAC;AACD,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,CAAC,IAAI,CAAC;AACtB,CAAC;AAED,+GAA+G;AAC/G,MAAM,UAAU,gBAAgB;IAC9B,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,CAAC;AACnD,CAAC"}

package/dist/tinybee/workflows/cron.js

@@ -0,0 +1,210 @@
+// A five-field cron matcher with a time zone (docs/tinybee/03 section 6.2). No dependency: the
+// subset is minute hour day-of-month month day-of-week with `*`, lists, ranges, steps and names.
+// Times are read in the zone through Intl, so "0 8 * * 1-5" in Asia/Ho_Chi_Minh means 08:00 there.
+const MONTHS = ['jan', 'feb', 'mar', 'apr', 'may', 'jun', 'jul', 'aug', 'sep', 'oct', 'nov', 'dec'];
+const DAYS = ['sun', 'mon', 'tue', 'wed', 'thu', 'fri', 'sat'];
+export class CronInvalid extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CronInvalid';
+    }
+}
+function named(v, names) {
+    const i = names.indexOf(v.toLowerCase());
+    return i < 0 ? undefined : i;
+}
+function parseField(field, min, max, names) {
+    const out = new Set();
+    for (const part of field.split(',')) {
+        const m = /^([^/]+)(?:\/(\d+))?$/.exec(part.trim());
+        if (!m)
+            throw new CronInvalid(`Cannot read "${part}".`);
+        const [, range, stepRaw] = m;
+        const step = stepRaw ? Number(stepRaw) : 1;
+        if (!Number.isInteger(step) || step < 1)
+            throw new CronInvalid(`Bad step in "${part}".`);
+        let lo;
+        let hi;
+        if (range === '*') {
+            lo = min;
+            hi = max;
+        }
+        else {
+            const r = range.split('-');
+            if (r.length > 2)
+                throw new CronInvalid(`Cannot read "${part}".`);
+            const num = (s) => {
+                const n = names ? (named(s, names) ?? Number(s)) : Number(s);
+                if (!Number.isInteger(n))
+                    throw new CronInvalid(`Cannot read "${s}".`);
+                return n;
+            };
+            lo = num(r[0]);
+            hi = r.length === 2 ? num(r[1]) : stepRaw ? max : lo;
+            if (lo < min || hi > max || lo > hi)
+                throw new CronInvalid(`"${part}" is outside ${min}-${max}.`);
+        }
+        for (let v = lo; v <= hi; v += step)
+            out.add(v);
+    }
+    return out;
+}
+export function parseCron(expr) {
+    const parts = expr.trim().split(/\s+/);
+    if (parts.length !== 5)
+        throw new CronInvalid('A schedule has five fields: minute hour day month weekday.');
+    const dow = parseField(parts[4], 0, 7, DAYS);
+    if (dow.has(7)) {
+        dow.delete(7);
+        dow.add(0);
+    }
+    return {
+        minute: parseField(parts[0], 0, 59),
+        hour: parseField(parts[1], 0, 23),
+        dom: parseField(parts[2], 1, 31),
+        month: parseField(parts[3], 1, 12, MONTHS),
+        dow,
+        domAny: parts[2] === '*',
+        dowAny: parts[4] === '*',
+    };
+}
+export function isValidCron(expr) {
+    try {
+        parseCron(expr);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function validZone(tz) {
+    if (!tz)
+        return Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC';
+    try {
+        new Intl.DateTimeFormat('en-GB', { timeZone: tz });
+        return tz;
+    }
+    catch {
+        return 'UTC';
+    }
+}
+const fmtCache = new Map();
+function formatter(tz) {
+    let f = fmtCache.get(tz);
+    if (!f) {
+        f = new Intl.DateTimeFormat('en-US', {
+            timeZone: tz,
+            hour12: false,
+            year: 'numeric',
+            month: 'numeric',
+            day: 'numeric',
+            hour: 'numeric',
+            minute: 'numeric',
+            weekday: 'short',
+        });
+        fmtCache.set(tz, f);
+    }
+    return f;
+}
+/** The wall-clock fields of an instant in a zone. */
+export function zonedParts(at, tz) {
+    const parts = formatter(validZone(tz)).formatToParts(at);
+    const get = (type) => parts.find((p) => p.type === type)?.value ?? '0';
+    const hour = Number(get('hour')) % 24;
+    return {
+        minute: Number(get('minute')),
+        hour,
+        dom: Number(get('day')),
+        month: Number(get('month')),
+        dow: DAYS.indexOf(get('weekday').toLowerCase().slice(0, 3)),
+        year: Number(get('year')),
+    };
+}
+export function cronMatches(fields, at, tz) {
+    const p = zonedParts(at, tz);
+    if (!fields.minute.has(p.minute) || !fields.hour.has(p.hour) || !fields.month.has(p.month))
+        return false;
+    const domOk = fields.dom.has(p.dom);
+    const dowOk = fields.dow.has(p.dow);
+    if (fields.domAny && fields.dowAny)
+        return true;
+    if (fields.domAny)
+        return dowOk;
+    if (fields.dowAny)
+        return domOk;
+    return domOk || dowOk;
+}
+/** The next `n` minutes after `from` that match, searched minute by minute for up to 366 days. */
+export function nextRuns(expr, tz, from = new Date(), n = 3) {
+    const fields = parseCron(expr);
+    const out = [];
+    const t = new Date(from);
+    t.setUTCSeconds(0, 0);
+    t.setUTCMinutes(t.getUTCMinutes() + 1);
+    const limit = t.getTime() + 366 * 86_400_000;
+    while (out.length < n && t.getTime() < limit) {
+        if (cronMatches(fields, t, tz))
+            out.push(new Date(t));
+        t.setUTCMinutes(t.getUTCMinutes() + 1);
+    }
+    return out;
+}
+const two = (n) => String(n).padStart(2, '0');
+/** "Every 10 min, 7:00–21:00", "Daily at 8:00", "Weekdays at 9:00", "Mondays at 8:00": what the list row says. */
+export function cronSummary(expr) {
+    let f;
+    try {
+        f = parseCron(expr);
+    }
+    catch {
+        return expr;
+    }
+    const parts = expr.trim().split(/\s+/);
+    const hours = [...f.hour].sort((a, b) => a - b);
+    const minutes = [...f.minute].sort((a, b) => a - b);
+    const days = () => {
+        if (f.dowAny && f.domAny)
+            return '';
+        if (!f.dowAny) {
+            const d = [...f.dow].sort((a, b) => a - b);
+            if (d.length === 5 && d.join() === '1,2,3,4,5')
+                return 'Weekdays';
+            if (d.length === 2 && d.join() === '0,6')
+                return 'Weekends';
+            if (d.length === 1)
+                return `${['Sundays', 'Mondays', 'Tuesdays', 'Wednesdays', 'Thursdays', 'Fridays', 'Saturdays'][d[0]]}`;
+            return d.map((x) => DAYS[x][0].toUpperCase() + DAYS[x].slice(1)).join(', ');
+        }
+        const dom = [...f.dom].sort((a, b) => a - b);
+        return dom.length === 1 ? `Day ${dom[0]} of the month` : `Days ${dom.join(', ')}`;
+    };
+    const window = () => hours.length === 24
+        ? ''
+        : hours.length === hours[hours.length - 1] - hours[0] + 1
+            ? `, ${hours[0]}:00–${hours[hours.length - 1] + 1 > 23 ? 23 : hours[hours.length - 1] + 1}:00`
+            : `, at ${hours.map((h) => `${h}:00`).join(', ')}`;
+    const stepM = /^\*\/(\d+)$/.exec(parts[0]);
+    const d = days();
+    if (stepM) {
+        const n = Number(stepM[1]);
+        const base = n === 1 ? 'Every minute' : `Every ${n} min`;
+        return `${base}${window()}${d ? `, ${d.toLowerCase()}` : ''}`;
+    }
+    if (minutes.length === 1 && /^\*\/(\d+)$/.test(parts[1])) {
+        const n = Number(/^\*\/(\d+)$/.exec(parts[1])[1]);
+        return `${n === 1 ? 'Every hour' : `Every ${n} hours`}${minutes[0] ? ` at :${two(minutes[0])}` : ''}${d ? `, ${d.toLowerCase()}` : ''}`;
+    }
+    if (minutes.length === 1 && hours.length >= 1 && hours.length <= 3) {
+        const times = hours.map((h) => `${h}:${two(minutes[0])}`).join(' and ');
+        return `${d || 'Daily'} at ${times}`;
+    }
+    if (minutes.length === 1)
+        return `Every hour at :${two(minutes[0])}${window()}${d ? `, ${d.toLowerCase()}` : ''}`;
+    return expr;
+}
+/** A short time in the zone, "14:50", for "Next: 14:50" toasts. */
+export function timeInZone(at, tz) {
+    const p = zonedParts(at, tz);
+    return `${p.hour}:${two(p.minute)}`;
+}
+//# sourceMappingURL=cron.js.map

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

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

package/dist/tinybee/workflows/engine.js

@@ -0,0 +1,371 @@
+// Runs one workflow (docs/tinybee/05 section 6.3): fetch the inputs, let the model read them against the
+// instructions, then do the outputs. Every outward output goes through gate() with the dot's rules, which the
+// permissions wrote (types.ts rulesOf), so "ask" becomes an approval card and "deny" a hand-off note. A push
+// that went out is relayed to Hive as well when the laptop is paired, so the phone hears it through the tunnel
+// or not. A dry run (the editor's Test button) records what it would do and sends nothing.
+import { createHash } from 'node:crypto';
+import { gate } from '../../agent/rules.js';
+import { addStep, finishRun, getRun, startRun } from '../../agent/runs.js';
+import { bindingsFor, callConnectionTool } from '../../connections/tools.js';
+import { getConnection, listConnections } from '../../connections/store.js';
+import { log } from '../../config.js';
+import { enqueue, registerHandler } from '../../queue.js';
+import { hiveCall } from '../../bee/hive-client.js';
+import { setRelaySource } from '../../bee/relay-client.js';
+import { llmForTier } from '../../bee/models.js';
+import { readBeeState } from '../../bee/state.js';
+import { isRunning, runFinished, runStarted, runningCount } from './activity.js';
+import { addNote, appendDigest, listDigest, listNotes, markSeen, unseen, workflowWatch } from './store.js';
+import { TOOL_REGISTRY } from './types.js';
+export const MAX_INPUT_CHARS = 20_000;
+/** The web fetch stops reading here: enough text for a page, not a whole site. */
+const MAX_FETCH_BYTES = 512 * 1024;
+const hash = (s) => createHash('sha256').update(s).digest('hex').slice(0, 16);
+export class WorkflowRunError extends Error {
+}
+export { workflowActivity } from './activity.js';
+export function registerWorkflowHandler() {
+    registerHandler('workflow', async (job) => {
+        const w = workflowWatch(job.watchId);
+        if (!w)
+            return;
+        const p = (job.payload ?? {});
+        await runWorkflow(w, { trigger: p.trigger ?? 'schedule', slot: p.slot, by: p.by });
+    });
+}
+/** Queues a run. Returns the job id, or null when the same slot was queued before. */
+export function enqueueWorkflowRun(w, opts) {
+    const dedupeKey = opts.slot ? `wf:${w.id}:${opts.slot}` : undefined;
+    return enqueue({ kind: 'workflow', watchId: w.id, payload: { trigger: opts.trigger, slot: opts.slot, by: opts.by }, dedupeKey });
+}
+export async function runWorkflow(w, opts) {
+    const def = w.workflow;
+    const now = opts.now ?? (() => new Date());
+    const dedupeKey = opts.dryRun
+        ? `wf:${w.id}:dry:${now().toISOString()}`
+        : opts.slot
+            ? `wf:${w.id}:${opts.slot}`
+            : `wf:${w.id}:${opts.trigger}:${now().toISOString()}`;
+    const run = startRun(w.id, 'workflow', {
+        source: opts.trigger === 'schedule' ? 'schedule' : 'user',
+        kind: opts.trigger === 'schedule' ? 'schedule' : 'chat',
+        dedupeKey,
+        title: opts.dryRun ? `Test run of ${def.name}` : opts.trigger === 'schedule' ? `${def.name} on schedule` : `${def.name}, asked by ${opts.by ?? 'you'}`,
+    });
+    if (isRunning(w.id) && !opts.dryRun) {
+        addStep(run.id, 'Skipped', 'An earlier run of this workflow is still going.', 'warn');
+        return finishRun(run.id, 'done');
+    }
+    runStarted(w.id);
+    setRelaySource(def.name);
+    let timer;
+    const deadline = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new WorkflowRunError(`Stopped after ${def.limits.max_runtime_s} s, the workflow's time limit.`)), def.limits.max_runtime_s * 1000);
+    });
+    try {
+        await Promise.race([execute(w, run.id, opts), deadline]);
+        return finishRun(run.id, 'done');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        addStep(run.id, 'Failed', message, 'error');
+        return finishRun(run.id, 'failed');
+    }
+    finally {
+        clearTimeout(timer);
+        runFinished(w.id);
+        if (runningCount() === 0)
+            setRelaySource(undefined);
+    }
+}
+async function execute(w, runId, opts) {
+    const def = w.workflow;
+    if (opts.dryRun)
+        addStep(runId, 'Test run', 'Nothing is sent or written; every step below says what a real run would do.');
+    // 1. Inputs.
+    const fetched = [];
+    for (const input of def.inputs)
+        fetched.push(await fetchInput(w, input, runId, opts));
+    const errors = fetched.filter((f) => !f.ok);
+    // 2. Only what an earlier run did not handle.
+    const fresh = fetched.map((f) => ({ ...f, keys: opts.dryRun ? f.keys : unseen(w.id, f.keys) }));
+    const nothingNew = fetched.length > 0 && fresh.every((f) => f.ok && f.keys.length === 0 && f.text !== '');
+    if (nothingNew)
+        addStep(runId, 'Nothing new', 'Every item was handled by an earlier run.', 'info');
+    // 3. Reading.
+    const reading = nothingNew ? { match: false, summary: 'Nothing new since the last run.', source: 'rules' } : await read(def, fresh, runId);
+    addStep(runId, reading.match ? 'Found something' : 'Nothing to tell', reading.summary.slice(0, 1000), reading.match ? 'ok' : 'info');
+    // 4. Outputs.
+    const vars = { summary: reading.summary, instructions: def.agent.instructions, name: def.name };
+    let actions = 0;
+    for (const out of def.outputs) {
+        const due = out.on === 'always' || (out.on === 'match' && reading.match) || (out.on === 'error' && errors.length > 0);
+        if (!due)
+            continue;
+        if (actions >= def.limits.max_actions) {
+            addStep(runId, 'Action limit reached', `The workflow may do ${def.limits.max_actions} things per run; the rest wait for the next run.`, 'warn');
+            break;
+        }
+        actions++;
+        const text = render(out.template ?? '{{summary}}', { ...vars, summary: out.on === 'error' ? errors.map((e) => e.error).join('; ') : vars.summary });
+        await doOutput(w, runId, out, text, actions, opts);
+    }
+    if (!opts.dryRun)
+        for (const f of fresh)
+            if (f.ok)
+                markSeen(w.id, f.keys);
+}
+function render(template, vars) {
+    return template.replace(/\{\{\s*(\w+)\s*\}\}/g, (_, k) => vars[k] ?? '').trim();
+}
+/** A connection of this dot that answers for the input's source (gmail, drive, sheets): by id, preset or name. */
+function connectionFor(w, source) {
+    const attached = (w.connections ?? []).map((id) => getConnection(id)).filter((c) => !!c);
+    const pool = attached.length ? attached : listConnections();
+    const s = source.toLowerCase();
+    return pool.find((c) => c.id === source || (c.preset ?? '').toLowerCase().includes(s) || c.name.toLowerCase().includes(s));
+}
+async function fetchInput(w, input, runId, opts) {
+    if (input.connection === 'web')
+        return fetchWeb(input, runId, opts);
+    const conn = connectionFor(w, input.connection);
+    if (!conn) {
+        addStep(runId, `Needs a connection: ${input.connection}`, `Connect ${input.connection} under Connections and attach it to this workflow.`, 'warn');
+        return { input, ok: false, text: '', keys: [], error: `${input.connection} is not connected` };
+    }
+    if (conn.status !== 'connected' || !conn.enabled) {
+        addStep(runId, `Connection off: ${conn.name}`, 'Turn it on under Connections.', 'warn');
+        return { input, ok: false, text: '', keys: [], error: `${conn.name} is off` };
+    }
+    const watch = { ...w, connections: [conn.id] };
+    const bindings = bindingsFor(watch);
+    const readTool = Array.from(bindings.entries()).find(([, b]) => b.tool.readOnly && /search|list|query|read|get/i.test(b.tool.name));
+    if (!readTool) {
+        addStep(runId, `No read tool on ${conn.name}`, 'The connection offers nothing that reads.', 'warn');
+        return { input, ok: false, text: '', keys: [], error: `${conn.name} has no read tool` };
+    }
+    const [fullName, binding] = readTool;
+    const argName = Object.keys(binding.tool.inputSchema?.properties ?? {}).find((k) => /q|query|search|range|filter/i.test(k)) ?? 'query';
+    const outcome = await callConnectionTool(watch, fullName, { [argName]: input.query }, runId);
+    if (!outcome.ok || outcome.status !== 'executed')
+        return { input, ok: false, text: '', keys: [], error: ('message' in outcome && outcome.message) || `${conn.name} did not answer` };
+    const text = (outcome.result?.text ?? '').slice(0, MAX_INPUT_CHARS);
+    const keys = itemKeys(text).map((k) => `${input.connection}:${k}`);
+    return { input, ok: true, text, keys };
+}
+async function fetchWeb(input, runId, opts) {
+    const url = input.query;
+    if (!/^https?:\/\//i.test(url)) {
+        addStep(runId, 'Bad URL', `${url} is not an http(s) address.`, 'error');
+        return { input, ok: false, text: '', keys: [], error: 'bad url' };
+    }
+    try {
+        const res = await (opts.fetchImpl ?? fetch)(url, {
+            signal: AbortSignal.timeout(15_000),
+            headers: { 'user-agent': 'TinyBee/1.0 (+workflow)' },
+            redirect: 'follow',
+        });
+        const raw = (await res.text()).slice(0, MAX_FETCH_BYTES);
+        const text = htmlToText(raw).slice(0, MAX_INPUT_CHARS);
+        if (!res.ok) {
+            addStep(runId, `Page answered ${res.status}`, url, 'warn');
+            return { input, ok: false, text, keys: [], error: `${url} answered ${res.status}` };
+        }
+        addStep(runId, 'Fetched the page', `${url} (${text.length} characters)`);
+        return { input, ok: true, text, keys: [`web:${hash(text)}`] };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        addStep(runId, 'Page did not answer', `${url}: ${message}`, 'warn');
+        return { input, ok: false, text: '', keys: [], error: `${url} did not answer: ${message}` };
+    }
+}
+export function htmlToText(html) {
+    return html
+        .replace(/<script[\s\S]*?<\/script>/gi, ' ')
+        .replace(/<style[\s\S]*?<\/style>/gi, ' ')
+        .replace(/<[^>]+>/g, ' ')
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/** One key per item in a tool answer: ids when the text carries them, else a hash of each paragraph. */
+function itemKeys(text) {
+    const ids = Array.from(text.matchAll(/"(?:id|messageId|threadId|rowId)"\s*:\s*"([^"]+)"/g)).map((m) => m[1]);
+    if (ids.length)
+        return Array.from(new Set(ids));
+    const parts = text
+        .split(/\n{2,}/)
+        .map((p) => p.trim())
+        .filter(Boolean);
+    if (parts.length === 0)
+        return [];
+    return Array.from(new Set(parts.map(hash)));
+}
+async function read(def, inputs, runId) {
+    const material = inputs
+        .filter((f) => f.ok && f.text)
+        .map((f) => `## ${f.input.connection}: ${f.input.query}\n${f.text}`)
+        .join('\n\n')
+        .slice(0, MAX_INPUT_CHARS);
+    // Nothing fetched (a reminder, or every input failed): there is nothing for the model to read.
+    if (!material) {
+        if (def.inputs.length === 0)
+            return { match: true, summary: def.agent.instructions, source: 'rules' };
+        return { match: false, summary: 'Nothing could be read.', source: 'rules' };
+    }
+    const picked = safeLlm(def.agent.model_tier);
+    if (picked?.llm.write) {
+        try {
+            const raw = await picked.llm.write({
+                system: `You run a small personal workflow. Read the material against the instructions and answer JSON only: {"match": boolean, "summary": string}. "match" is true when the instructions say the person should hear about something in the material. "summary" is at most five short lines in ${def.agent.output_language ?? 'the language of the instructions'}, written to the person, no preamble. With no material, answer from the instructions alone.`,
+                prompt: `Instructions:\n${def.agent.instructions}\n\nMaterial:\n${material || '(none)'}`,
+                timeoutMs: Math.min(120_000, def.limits.max_runtime_s * 1000),
+            });
+            const json = JSON.parse(raw.slice(raw.indexOf('{'), raw.lastIndexOf('}') + 1));
+            if (typeof json.summary === 'string') {
+                addStep(runId, 'Read with the model', `${picked.label} · ${json.summary.length} characters`);
+                return { match: json.match === true, summary: json.summary.trim(), source: 'model' };
+            }
+        }
+        catch (err) {
+            addStep(runId, 'The model could not read this', err instanceof Error ? err.message : String(err), 'warn');
+        }
+    }
+    // No model: new material is the news.
+    const hasNew = inputs.some((f) => f.ok && f.keys.length > 0);
+    if (def.inputs.length === 0)
+        return { match: true, summary: def.agent.instructions, source: 'rules' };
+    const summary = hasNew
+        ? inputs
+            .filter((f) => f.ok && f.keys.length > 0)
+            .map((f) => `${f.keys.length} new from ${f.input.connection}: ${f.text.slice(0, 200)}`)
+            .join('\n')
+        : 'Nothing new.';
+    return { match: hasNew, summary, source: 'rules' };
+}
+/**
+ * The backend for a tier (the tier map on the AI screen, else the active backend), on this laptop only. None set
+ * up: undefined, and the reading falls back to rules. Hive's AI is never used for host work (docs 02 section 7).
+ */
+function safeLlm(tier) {
+    try {
+        const picked = llmForTier(tier);
+        if (picked.label === 'mock')
+            return undefined;
+        return picked;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function doOutput(w, runId, out, text, n, opts) {
+    const def = w.workflow;
+    const permission = def.agent.permissions[out.action] ?? (toolOf(out.action)?.kind === 'internal' ? 'auto' : 'ask');
+    if (permission === 'deny') {
+        addStep(runId, `Not allowed: ${label(out.action)}`, 'This workflow may not do that. Change it under Permissions.', 'warn');
+        return;
+    }
+    if (opts.dryRun) {
+        addStep(runId, `Would ${label(out.action)}${permission === 'ask' ? ' (after you approve)' : ''}`, text.slice(0, 500));
+        return;
+    }
+    switch (out.action) {
+        case 'digest.append':
+            appendDigest(w.id, runId, text);
+            addStep(runId, 'Added to the digest', text.slice(0, 300), 'ok');
+            return;
+        case 'memory.note':
+            addNote(w.id, text);
+            addStep(runId, 'Kept a note', text.slice(0, 300), 'ok');
+            return;
+        case 'notify.push': {
+            const action = {
+                kind: 'push_notify',
+                target: 'push',
+                title: `${def.emoji ? `${def.emoji} ` : ''}${def.name}`,
+                body: text,
+                meta: { key: `wf:${w.id}:${runId}:${n}`, url: `/#/workflows/${def.id}?run=${runId}`, urgency: 'normal' },
+            };
+            const result = await gate(action, w, runId);
+            if (result === 'executed') {
+                addStep(runId, 'Pushed to your phone', text.slice(0, 300), 'ok');
+                await relayToHive(action, runId);
+            }
+            else if (result === 'pending_approval')
+                addStep(runId, 'Waiting for your OK', 'The push is on the approvals list.', 'warn');
+            return;
+        }
+        default:
+            await doConnectionOutput(w, runId, out.action, text);
+    }
+}
+/** gmail.label, gmail.draft, gmail.send, sheets.append: the matching write tool of the attached connection, through gate() as mcp_tool. */
+async function doConnectionOutput(w, runId, action, text) {
+    const [source, verb] = action.split('.');
+    const conn = connectionFor(w, source);
+    if (!conn || conn.status !== 'connected' || !conn.enabled) {
+        addStep(runId, `Needs a connection: ${source}`, `Connect ${source} under Connections to ${label(action)}.`, 'warn');
+        return;
+    }
+    const watch = { ...w, connections: [conn.id] };
+    const bindings = bindingsFor(watch);
+    const want = verb === 'append' ? /append|add|insert/i : verb === 'label' ? /label|modify/i : verb === 'draft' ? /draft/i : /send/i;
+    const found = Array.from(bindings.entries()).find(([, b]) => !b.tool.readOnly && want.test(b.tool.name));
+    if (!found) {
+        addStep(runId, `No tool to ${label(action)} on ${conn.name}`, 'The connection offers no such tool.', 'warn');
+        return;
+    }
+    const [fullName, binding] = found;
+    const argName = Object.keys(binding.tool.inputSchema?.properties ?? {}).find((k) => /body|text|content|values|label|message/i.test(k)) ?? 'text';
+    const outcome = await callConnectionTool(watch, fullName, { [argName]: text }, runId);
+    if (outcome.status === 'executed' && outcome.ok)
+        addStep(runId, `Did ${label(action)}`, text.slice(0, 300), 'ok');
+    else if (outcome.status === 'pending_approval')
+        addStep(runId, 'Waiting for your OK', `${label(action)} is on the approvals list.`, 'warn');
+    else if (outcome.status === 'error')
+        addStep(runId, `Could not ${label(action)}`, ('message' in outcome && outcome.message) || '', 'error');
+}
+function label(action) {
+    return toolOf(action)?.label.toLowerCase() ?? action;
+}
+function toolOf(name) {
+    return TOOL_REGISTRY.find((t) => t.name === name);
+}
+/** A push that went out on the laptop also reaches the phone through Hive when the laptop is paired. */
+async function relayToHive(action, runId) {
+    const paired = readBeeState().paired;
+    if (!paired)
+        return;
+    try {
+        await hiveCall('/presence/notify', {
+            method: 'POST',
+            body: {
+                title: action.title,
+                body: action.body.slice(0, 1000),
+                url: String(action.meta?.url ?? '/#/workflows').replace(/^\//, ''),
+                tag: `wf:${runId}`,
+                urgency: 'normal',
+            },
+            timeoutMs: 8000,
+        });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        log.warn(`tinybee: push relay to Hive failed: ${message}`);
+        addStep(runId, 'Hive did not take the push', `${message}. The laptop notice still went out.`, 'warn');
+    }
+}
+/** The run's timeline for the detail screen, with the digest entries and notes it produced. */
+export function runDetail(runId) {
+    const run = getRun(runId);
+    if (!run)
+        return undefined;
+    const w = workflowWatch(run.watchId);
+    return { ...run, workflowId: w?.workflow.id, digest: listDigest({ limit: 100 }).filter((d) => d.runId === runId), notes: w ? listNotes(w.id, 5) : [] };
+}
+//# sourceMappingURL=engine.js.map