@withbuddi/buddi 0.1.0-pre.37 → 0.1.0-pre.39

package/packages/gateway/dist/missions/parked.js

@@ -0,0 +1,255 @@
+/**
+ * A mission run parked on the owner (docs/browser.md, "Missions").
+ *
+ * A mission that opted in (`browser: own`) looks at pages in buddi's own
+ * browser while nobody is there. Four moments in that browser need a person —
+ * Look? (a click that may not have landed), Keep going? (the task's steps or
+ * hour are spent), Sign in, Human check — and on an interactive surface each
+ * is a question card in the chat. In a mission there is no chat to hold it,
+ * so the card becomes an owner notification with an action and the run parks:
+ *
+ *   the card       the same question card `conversation.ask` records
+ *                  (`core.questions`), open for the parking time, in the
+ *                  mission's own conversation;
+ *   the reach      a `question` notification (always reaches, even in a
+ *                  focus), drawn with the card's buttons on Telegram and
+ *                  held on Home / Needs you as "Asked you a question";
+ *   the run        a suspended job (`awaiting-owner:<question id>`), holding
+ *                  no worker, no transaction and no model call.
+ *
+ * The answer, from any of those places, resumes the job in the same
+ * conversation with the owner's words as its next turn. No answer within the
+ * parking time (an hour by default, `missionWaitMinutes` in the browser's
+ * settings) and the run ends as "needed you" with one report line — never
+ * silently.
+ *
+ * The job is tied to its question before the card goes out, and an answer is
+ * written onto the job in the same statement that wakes it: an answer that
+ * lands while the worker is still suspending the job is kept there, and the
+ * suspension wakes the job when it finds one (`wakeIf`).
+ *
+ * A mission's own question parks the same way (docs/browser.md, "Any mission
+ * may ask"): an unattended run may call `conversation.ask` once, and its
+ * question becomes the card, with its choices as the buttons.
+ *
+ * Take over is a wait of its own: the run parks again, on the page rather
+ * than a card (`page:<conversation>`), until the owner gives the page back.
+ */
+import { askQuestion, appendEvent, closeQuestion, notifyOwner, questionKey, resumeJob, } from '@buddi/core';
+import { QUESTION_ASKED, QUESTION_CLEARED } from '../web/attention.js';
+/** The suspended reason a parked mission job carries. */
+export const PARKED_REASON_PREFIX = 'awaiting-owner:';
+/** The parking time when the browser has no setting to read. */
+export const DEFAULT_MISSION_WAIT_MS = 60 * 60_000;
+export function parkedRunOf(value) {
+    if (typeof value !== 'object' || value === null)
+        return null;
+    const p = value;
+    if (typeof p.questionId !== 'string' || typeof p.conversationId !== 'string' || typeof p.until !== 'string')
+        return null;
+    return {
+        questionId: p.questionId,
+        conversationId: p.conversationId,
+        question: typeof p.question === 'string' ? p.question : '',
+        until: p.until,
+        waitMs: typeof p.waitMs === 'number' && p.waitMs > 0 ? p.waitMs : DEFAULT_MISSION_WAIT_MS,
+        ...(p.handback === true ? { handback: true } : {}),
+    };
+}
+/** The question id a run parked on a taken-over page waits under: the page, not a card. */
+export function handbackQuestionId(conversationId) {
+    return `page:${conversationId}`;
+}
+/** A real question card's id (a run parked on a page has no card to close). */
+export function isCardQuestion(questionId) {
+    return !questionId.startsWith('page:');
+}
+/** What the run is told when the owner took the page themselves and gave it back. */
+export const GAVE_BACK_ANSWER = 'I took over the page myself and gave it back.';
+export function parkedAnswerOf(value) {
+    if (typeof value !== 'object' || value === null)
+        return null;
+    const p = value;
+    if (typeof p.questionId !== 'string')
+        return null;
+    return {
+        questionId: p.questionId,
+        ...(typeof p.text === 'string' ? { text: p.text } : {}),
+        ...(p.timedOut === true ? { timedOut: true } : {}),
+    };
+}
+/** "an hour", "45 minutes": how long it waited, in the report line. */
+export function waitWords(ms) {
+    const minutes = Math.max(1, Math.round(ms / 60_000));
+    if (minutes % 60 === 0) {
+        const hours = minutes / 60;
+        return hours === 1 ? 'an hour' : `${hours} hours`;
+    }
+    return `${minutes} minutes`;
+}
+/** The one line a run that waited in vain delivers. */
+export function neededYouLine(input) {
+    // A browser card is its title, a newline and a line of why: the title is what was asked.
+    const title = (input.question.trim().split('\n')[0] ?? '').trim().replace(/\s+/g, ' ');
+    const asked = /[.?!]$/.test(title) ? title : `${title}.`;
+    if (input.handback) {
+        return `${input.missionName} waited for you to give the page back and stopped: "${asked}" The page was not given back within ${waitWords(input.waitedMs)}, so it ended there. Run it again from Missions when you are done with it.`;
+    }
+    return `${input.missionName} needed you and stopped: "${asked}" No answer came within ${waitWords(input.waitedMs)}, so it ended there. Run it again from Missions when you can take a look.`;
+}
+/**
+ * Put the card in front of the owner and say how the run waits. Returns what
+ * the job writes on itself; the caller returns the suspension.
+ */
+export async function parkMissionRun(deps, input) {
+    const now = deps.now();
+    const until = new Date(now.getTime() + input.waitMs);
+    // The owner may also say it in their own words ("take over", "skip it"): the browser reads answers loosely.
+    const question = await askQuestion(deps.pool, {
+        agentId: input.agentId,
+        conversationId: input.conversationId,
+        question: input.asked.question,
+        options: input.asked.options,
+        allowOther: true,
+        now,
+        ttlMs: input.waitMs,
+    });
+    // Home / Needs you and the agent's face: "Asked you a question", for the parking time rather than fifteen minutes.
+    await appendEvent(deps.pool, QUESTION_ASKED, { agentId: input.agentId, questionId: question.id, missionId: input.missionId, until: until.toISOString() }, input.conversationId);
+    const parked = { questionId: question.id, conversationId: input.conversationId, question: question.question, until: until.toISOString(), waitMs: input.waitMs };
+    // Before anyone can see the card: an answer that comes back at once finds this job.
+    if (input.jobId)
+        await tieJob(deps.pool, input.jobId, parked);
+    try {
+        await notifyOwner(deps.pool, { now: deps.now, ...(deps.timezone ? { timezone: deps.timezone } : {}), ...(deps.log ? { log: deps.log } : {}) }, {
+            kind: 'question',
+            urgency: 'now',
+            title: `${input.missionName}: ${question.question}`,
+            text: input.browser === false
+                ? `It is running while you are away and needs your answer to carry on. It waits ${waitWords(input.waitMs)}, then stops and tells you.`
+                : `It is running while you are away, in buddi's own browser, and needs you here. It waits ${waitWords(input.waitMs)}, then stops and tells you.`,
+            action: question.question,
+            link: { route: `#/chat/${encodeURIComponent(input.agentId)}/${encodeURIComponent(input.conversationId)}` },
+            agentId: input.agentId,
+            dedupeKey: questionKey(question.id),
+        });
+    }
+    catch (err) {
+        // The card is stored and Home shows it: a channel that failed costs the phone, never the run.
+        deps.log?.(`mission ${input.missionId}: could not send the card as a notification: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    await appendEvent(deps.pool, 'mission.parked', { missionId: input.missionId, agentId: input.agentId, questionId: question.id, until: until.toISOString() }, input.conversationId);
+    return parked;
+}
+/**
+ * Park on the page the owner just took over: no card and no notification (the
+ * owner is at the page already). The run waits until the page is given back
+ * (`resumeParkedForPage`), or until the parking time runs out.
+ */
+export async function parkForHandback(deps, input) {
+    const until = new Date(deps.now().getTime() + input.waitMs);
+    const parked = { questionId: handbackQuestionId(input.conversationId), conversationId: input.conversationId, question: input.question, until: until.toISOString(), waitMs: input.waitMs, handback: true };
+    if (input.jobId)
+        await tieJob(deps.pool, input.jobId, parked);
+    await appendEvent(deps.pool, 'mission.parked', { missionId: input.missionId, agentId: input.agentId, questionId: parked.questionId, until: parked.until, handback: true }, input.conversationId);
+    return parked;
+}
+/** Write what the run waits on onto its (still leased) job, with no answer yet. */
+async function tieJob(pool, jobId, parked) {
+    await pool.query(`update core.jobs
+        set payload = coalesce(payload, '{}'::jsonb) || jsonb_build_object('parked', $2::jsonb, 'answer', null),
+            updated_at = now()
+      where id = $1::uuid and state = 'leased'`, [jobId, JSON.stringify(parked)]);
+}
+/**
+ * Hand an answer to the job parked on `questionId`, in one statement: a job
+ * already suspended is woken with it; a job still being suspended (its worker
+ * has not landed the suspension yet) keeps it in its payload, and the
+ * suspension wakes it (`wakeIf`). An answer already given is never replaced.
+ * Returns the job's id, or null when no run waits on this question.
+ */
+async function answerParkedJob(pool, questionId, answer) {
+    const { rows } = await pool.query(`update core.jobs
+        set payload = coalesce(payload, '{}'::jsonb) || jsonb_build_object('answer', $2::jsonb),
+            state = case when state = 'suspended' then 'pending' else state end,
+            suspended_reason = case when state = 'suspended' then null else suspended_reason end,
+            run_after = case when state = 'suspended' then now() else run_after end,
+            attempts = case when state = 'suspended' and attempts > 0 then attempts - 1 else attempts end,
+            updated_at = now()
+      where payload->'parked'->>'questionId' = $1
+        and ((state = 'suspended' and suspended_reason = $3) or state = 'leased')
+        and coalesce(payload->'answer'->>'questionId', '') <> $1
+      returning id, state, kind, conversation_id`, [questionId, JSON.stringify(answer), `${PARKED_REASON_PREFIX}${questionId}`]);
+    const row = rows[0];
+    if (!row)
+        return null;
+    if (row.state === 'pending') {
+        await appendEvent(pool, 'job.resumed', { jobId: row.id, kind: row.kind, patched: ['answer'] }, row.conversation_id ?? undefined).catch(() => undefined);
+    }
+    return row.id;
+}
+/**
+ * The owner answered a question card. If a parked mission run is waiting on
+ * it, wake that run with the answer and say so (`true`): the surface then
+ * starts no turn of its own. `false` for every ordinary question.
+ */
+export async function resumeParkedForQuestion(pool, question, answerText) {
+    const answer = { questionId: question.id, text: question.answer ?? answerText ?? '' };
+    if (!(await answerParkedJob(pool, question.id, answer)))
+        return false;
+    // The face and Home stop saying "Asked you a question".
+    await appendEvent(pool, QUESTION_CLEARED, { agentId: question.agentId }, question.conversationId).catch(() => undefined);
+    return true;
+}
+/**
+ * The owner gave back a page in this conversation. A mission run waiting on
+ * it carries on: one parked on the page after Take over, or one still parked
+ * on its card (the owner took the page from the Canvas rather than the card;
+ * that card is closed). `true` when a run was woken.
+ */
+export async function resumeParkedForPage(pool, conversationId, now) {
+    const handback = handbackQuestionId(conversationId);
+    if (await answerParkedJob(pool, handback, { questionId: handback, text: GAVE_BACK_ANSWER }))
+        return true;
+    const { rows } = await pool.query(`select payload->'parked'->>'questionId' as question_id
+       from core.jobs
+      where payload->'parked'->>'conversationId' = $1
+        and ((state = 'suspended' and suspended_reason like $2) or state = 'leased')
+        and coalesce(payload->'answer'->>'questionId', '') <> coalesce(payload->'parked'->>'questionId', '')
+      order by updated_at desc limit 1`, [conversationId, `${PARKED_REASON_PREFIX}%`]);
+    const questionId = rows[0]?.question_id;
+    if (!questionId)
+        return false;
+    if (!(await answerParkedJob(pool, questionId, { questionId, text: GAVE_BACK_ANSWER })))
+        return false;
+    if (isCardQuestion(questionId)) {
+        const closed = await pool.query(`update core.questions set answered_at = $2, answered_via = 'browser', answer = $3
+        where id = $1::uuid and answered_at is null returning agent_id`, [questionId, now, GAVE_BACK_ANSWER]).catch(() => ({ rows: [] }));
+        if (closed.rows[0])
+            await appendEvent(pool, QUESTION_CLEARED, { agentId: closed.rows[0].agent_id }, conversationId).catch(() => undefined);
+    }
+    return true;
+}
+/**
+ * The clock's half: every parked run whose time is up is closed and woken as
+ * timed out; its handler delivers the "needed you" line. Safe to run from two
+ * processes: the resume is guarded by the job's state.
+ */
+export async function expireParkedRuns(pool, now) {
+    const { rows } = await pool.query(`select id, payload->'parked'->>'questionId' as question_id
+       from core.jobs
+      where state = 'suspended'
+        and suspended_reason like $1
+        and payload->'parked'->>'until' is not null
+        and (payload->'parked'->>'until')::timestamptz <= $2`, [`${PARKED_REASON_PREFIX}%`, now]);
+    let woken = 0;
+    for (const row of rows) {
+        if (row.question_id && isCardQuestion(row.question_id))
+            await closeQuestion(pool, { id: row.question_id, via: 'timeout', now }).catch(() => false);
+        const answer = { questionId: row.question_id, timedOut: true };
+        if (await resumeJob(pool, row.id, { payloadPatch: { answer } }))
+            woken++;
+    }
+    return woken;
+}
+//# sourceMappingURL=parked.js.map

package/packages/gateway/dist/missions/parked.js.map

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

package/packages/gateway/dist/serve.d.ts

@@ -3,6 +3,7 @@ import { runScheduler, runWorker, type Job, type JobHandler, type Mission, type
 import type { Pool } from 'pg';
 import type { ApprovalResume } from '@buddi/runtime';
 import { type MissionRunControl, type MissionRunResult } from './missions/execute.js';
+import { type ParkedAnswer, type ParkedRun } from './missions/parked.js';
 import { createInlineMissionRunner, type InlineMissionDeps } from './missions/inline.js';
 /**
  * `/recap` now lives in `missions/inline.ts`, so a surface that is not this
@@ -65,6 +66,8 @@ export declare const REMINDER_TICK_MS = 60000;
  * speak, it only notices — the aggregation window inside it decides that.
  */
 export declare const DEAD_LETTER_TICK_MS = 60000;
+/** How often parked mission runs are checked for a parking time that ran out. */
+export declare const PARKED_TICK_MS = 60000;
 /** How often held and shown notifications are looked at: escalations, quiet hours, the end of the day. */
 export declare const NOTIFICATIONS_TICK_MS = 60000;
 /** The scheduler's kind: run one occurrence of a scheduled mission. */
@@ -89,6 +92,10 @@ export interface MissionJobPayload {
         conversationId: string;
     };
     approval?: ApprovalResume;
+    /** Written when the run parks on a browser card (docs/browser.md, "Missions"). */
+    parked?: ParkedRun;
+    /** Merged in by the owner's answer, or by the clock when nobody answered. */
+    answer?: ParkedAnswer;
 }
 /** The three shapes a loop has when it is not running at all: see `idleLoops`. */
 export interface IdleLoops {

package/packages/gateway/dist/serve.d.ts.map

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

package/packages/gateway/dist/serve.js

@@ -36,6 +36,7 @@ import { AGENT_RUN_JOB_KIND, createAgentRunHandler, OFFER_HINT_PREFIX } from './
 import { composePrepare, createMissionExecutor, } from './missions/execute.js';
 import { withNudgeBudget } from './missions/getting-started.js';
 import { createDeadLetterWatch } from './missions/dead-letter.js';
+import { expireParkedRuns, parkedAnswerOf, parkedRunOf, PARKED_REASON_PREFIX } from './missions/parked.js';
 import { createInlineMissionRunner } from './missions/inline.js';
 import { createDigestPrepare } from './missions/recap.js';
 import { createMailWatcherPrepare } from './missions/watcher-mail.js';
@@ -106,6 +107,8 @@ export const REMINDER_TICK_MS = 60_000;
  * speak, it only notices — the aggregation window inside it decides that.
  */
 export const DEAD_LETTER_TICK_MS = 60_000;
+/** How often parked mission runs are checked for a parking time that ran out. */
+export const PARKED_TICK_MS = 60_000;
 /** How often held and shown notifications are looked at: escalations, quiet hours, the end of the day. */
 export const NOTIFICATIONS_TICK_MS = 60_000;
 /** The scheduler's kind: run one occurrence of a scheduled mission. */
@@ -141,6 +144,8 @@ function missionJobPayload(payload) {
         ...(approval && typeof approval.actionId === 'string' && typeof approval.state === 'string'
             ? { approval: approval }
             : {}),
+        ...(parkedRunOf(p.parked) ? { parked: parkedRunOf(p.parked) } : {}),
+        ...(parkedAnswerOf(p.answer) ? { answer: parkedAnswerOf(p.answer) } : {}),
     };
 }
 /**
@@ -279,17 +284,23 @@ export function createMissionJobHandler(deps) {
         // A job coming back from an approval carries the decision in its payload.
         // The run continues in the conversation it suspended in; the occurrence was
         // deliberately left claimed while it waited.
+        // Or back from a browser card: the owner's answer, or the clock saying nobody came.
+        const answered = payload.parked && payload.answer && payload.answer.questionId === payload.parked.questionId
+            ? { parked: payload.parked, ...(payload.answer.text !== undefined ? { text: payload.answer.text } : {}), ...(payload.answer.timedOut ? { timedOut: true } : {}) }
+            : null;
         const control = {
             jobId: job.id,
             signal: jobContext.signal,
-            ...(payload.approval && payload.awaiting
-                ? {
-                    resume: {
-                        conversationId: payload.awaiting.conversationId,
-                        approval: payload.approval,
-                    },
-                }
-                : {}),
+            ...(answered
+                ? { answer: answered }
+                : payload.approval && payload.awaiting
+                    ? {
+                        resume: {
+                            conversationId: payload.awaiting.conversationId,
+                            approval: payload.approval,
+                        },
+                    }
+                    : {}),
         };
         try {
             const result = await deps.execute(occurrence, mission, control);
@@ -300,7 +311,19 @@ export function createMissionJobHandler(deps) {
                 log(`mission ${mission.id}: suspended on action ${result.awaiting.actionId} — waiting for the owner`);
                 return {
                     suspended: `awaiting-approval:${result.awaiting.actionId}`,
-                    payloadPatch: { awaiting: result.awaiting },
+                    // A browser card answered earlier is done with: only the decision brings this back.
+                    payloadPatch: { awaiting: result.awaiting, parked: null, answer: null },
+                };
+            }
+            // Parked on a browser card: the answer, or the parking time running out, brings it back.
+            if (result.parked) {
+                log(`mission ${mission.id}: parked on the owner's card (question ${result.parked.questionId}) — waiting for the owner until ${result.parked.until}`);
+                return {
+                    suspended: `${PARKED_REASON_PREFIX}${result.parked.questionId}`,
+                    // No `answer: null` here: the run cleared it when it tied the job to the card, and
+                    // an answer that came back while this suspension was on its way is kept and wakes it.
+                    payloadPatch: { parked: result.parked, awaiting: null, approval: null },
+                    wakeIf: { answer: { questionId: result.parked.questionId } },
                 };
             }
             await finishOccurrence(deps.pool, occurrence.id, {
@@ -628,6 +651,8 @@ export async function main() {
                 imageReady: async () => wiring.registry.has('image.generate') && (await wiring.registry.readiness('image', wiring.ctx))?.ready === true,
             })),
             askApproval,
+            // A mission that browses (`browser: own`): the owner's answer touches its page; the parking time is the browser's setting.
+            browser: browserHost(process.env),
         }), {
             pool,
             now,
@@ -908,6 +933,19 @@ export async function main() {
             },
             log: logErr,
         });
+        // Mission runs parked on a browser card whose parking time is up: each ends
+        // as "needed you" with its one report line (docs/browser.md, "Missions").
+        const parkedLoop = recovering ? idle.loop : startLoop({
+            name: 'parked-missions',
+            everyMs: PARKED_TICK_MS,
+            abortAfterMs: PARKED_TICK_MS * 2,
+            run: async () => {
+                const woken = await expireParkedRuns(pool, now());
+                if (woken > 0)
+                    console.log(`missions: ${woken} parked run${woken === 1 ? '' : 's'} ran out of time waiting for you`);
+            },
+            log: logErr,
+        });
         // Notifications that were shown or held and whose moment came: an unseen
         // one escalates, a focus ends, the day ends (docs/notifications.md).
         const notificationsLoop = recovering ? idle.loop : startLoop({
@@ -1066,6 +1104,7 @@ export async function main() {
                     reminderLoop.stop();
                     deadLetterLoop.stop();
                     notificationsLoop.stop();
+                    parkedLoop.stop();
                     proposalLoop.stop();
                     requirementsLoop.stop();
                     datesLoop.stop();
@@ -1140,6 +1179,7 @@ export async function main() {
             reminderLoop.stop();
             deadLetterLoop.stop();
             notificationsLoop.stop();
+            parkedLoop.stop();
             proposalLoop.stop();
             requirementsLoop.stop();
             datesLoop.stop();