@withbuddi/buddi 0.1.0-pre.36 → 0.1.0-pre.38

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

@@ -0,0 +1,249 @@
+/**
+ * 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`).
+ *
+ * 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: `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/missions/report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/missions/report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAQL,KAAK,aAAa,EAClB,KAAK,cAAc,EAEpB,MAAM,aAAa,CAAC;AAGrB,oDAAoD;AACpD,eAAO,MAAM,cAAc,YAAY,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,gBAAgB,OAAqB,CAAC;AAEnD,0FAA0F;AAC1F,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGpE;AAED,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,eAAe,GACvB;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAClC,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAyED,MAAM,MAAM,YAAY,GAAG;IAAE,SAAS,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAC1H,MAAM,MAAM,YAAY,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAoBjD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,GAAG,cAAc,CAmDlH;AAED,qEAAqE;AACrE,eAAO,MAAM,oBAAoB,QAOtB,CAAC"}
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/missions/report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAQL,KAAK,aAAa,EAClB,KAAK,cAAc,EAEpB,MAAM,aAAa,CAAC;AAGrB,oDAAoD;AACpD,eAAO,MAAM,cAAc,YAAY,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,gBAAgB,OAAqB,CAAC;AAEnD,0FAA0F;AAC1F,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGpE;AAED,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,eAAe,GACvB;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAClC,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAyED,MAAM,MAAM,YAAY,GAAG;IAAE,SAAS,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAC1H,MAAM,MAAM,YAAY,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAoBjD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,GAAG,cAAc,CAoDlH;AAED,qEAAqE;AACrE,eAAO,MAAM,oBAAoB,QAOtB,CAAC"}

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

@@ -111,6 +111,7 @@ export function createMissionManifest(sink, opts = {}) {
         description: 'Send this text to the owner as the result of this scheduled run, and finish. Call it once, with the finished message; the text you pass is exactly what is delivered. You may attach a few actions the owner can take about it — they become buttons where the surface has them and a plain list where it does not. ' +
             'You may also give a dashboard link it opens, and the Files id of a voice note you made in this run. If there is nothing worth an interruption, call mission.silent instead.',
         tier: 'auto',
+        sideEffect: true,
         input: reportInputFor(max),
         async execute(input, ctx) {
             const audio = input.audio ? await reportAudio(input.audio, ctx) : undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/missions/report.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/missions/report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EACL,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,GAKZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,oDAAoD;AACpD,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC;AAExC;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAEnD,0FAA0F;AAC1F,MAAM,UAAU,WAAW,CAAC,KAAgC;IAC1D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,GAAG;QAAE,OAAO,gBAAgB,CAAC;IAClG,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;AAC3C,CAAC;AA+BD,8DAA8D;AAC9D,MAAM,KAAK,GAAG,6CAA6C,CAAC;AAC5D,MAAM,IAAI,GAAG,iEAAiE,CAAC;AAE/E,MAAM,cAAc,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/C,OAAO,EAAE,CAAC;SACP,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;SAC1B,QAAQ,CACP,yHAAyH,CAC1H;IACH,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CACP,+EAA+E,GAAG,sFAAsF,CACzK;IACH,OAAO,EAAE,CAAC;SACP,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,eAAe,CAAC;aACpB,QAAQ,CACP,oHAAoH,CACrH;QACH,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,gBAAgB,CAAC;aACrB,QAAQ,CACP,uQAAuQ,CACxQ;KACJ,CAAC,CACH;SACA,GAAG,CAAC,UAAU,CAAC;SACf,QAAQ,EAAE;SACV,QAAQ,CACP,WAAW,UAAU,4SAA4S,CAClU;IACH,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,KAAK,CAAC,KAAK,EAAE,gCAAgC,CAAC;SAC9C,QAAQ,EAAE;SACV,QAAQ,CAAC,6IAA6I,CAAC;IAC1J,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CAAC,gGAAgG,CAAC;IAC7G,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC;SACzB,QAAQ,EAAE;SACV,QAAQ,CAAC,qJAAqJ,CAAC;CACnK,CAAC,CAAC;AAIH,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CACP,qJAAqJ,CACtJ;CACJ,CAAC,CAAC;AAKH;;;;GAIG;AACH,KAAK,UAAU,WAAW,CAAC,MAAc,EAAE,GAAoB;IAC7D,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAChE,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,WAAW,CAAC,CAAC;IACxE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,UAAU,MAAM,OAAO,GAAG,CAAC,IAAI,oBAAoB,CAAC,CAAC;IACvH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,CAAqC,0DAA0D,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1I,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,eAAe,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IACzG,kHAAkH;IAClH,IAAI,CAAC,GAAG,CAAC,cAAc,IAAI,YAAY,KAAK,GAAG,CAAC,cAAc,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,UAAU,MAAM,iEAAiE,CAAC,CAAC;IACrG,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC;AACtG,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAkB,EAAE,OAAsC,EAAE;IAChG,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,MAAM,GAA8C;QACxD,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,sTAAsT;YACtT,6KAA6K;QAC/K,IAAI,EAAE,MAAM;QACZ,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC;QAC1B,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;YACtB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,GAAsB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC/F,IAAI,CAAC,QAAQ,GAAG;gBACd,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;gBACvB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE;gBAC5B,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3C,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/E,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5B,CAAC;YACF,OAAO;gBACL,SAAS,EAAE,QAAQ;gBACnB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM;gBAC/B,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3C,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/E,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5B,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,MAAM,MAAM,GAA8D;QACxE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,iLAAiL;QACnL,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,WAAW;QAClB,KAAK,CAAC,OAAO,CAAC,KAAK;YACjB,IAAI,CAAC,QAAQ,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YAChE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAC/B,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,OAAO;QAChB,0EAA0E;QAC1E,wBAAwB;QACxB,MAAM,EAAE,MAAM;QACd,aAAa,EAAE,EAAE;QACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;KACxB,CAAC;AACJ,CAAC;AAED,qEAAqE;AACrE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,+CAA+C;IAC/C,mGAAmG;IACnG,kHAAkH;IAClH,sHAAsH;IACtH,0JAA0J;IAC1J,6LAA6L;CAC9L,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/packages/gateway/dist/ollama-local.d.ts

@@ -0,0 +1,90 @@
+import { type HttpTransport } from '@buddi/runtime';
+export interface LocalModelChoice {
+    /** The Ollama model tag, as `ollama pull` takes it. */
+    model: string;
+    /** About how much it downloads, in GB, for the button and the progress line. */
+    sizeGb: number;
+    /** Memory from which it is the pick, in GiB as the machine reports it. */
+    fromGb: number;
+}
+/**
+ * The table: the largest model that leaves room for the rest of the machine.
+ * All four answer tool calls through Ollama's OpenAI-compatible endpoint,
+ * which an agent needs. The thresholds sit a little under 8, 16 and 32 so a
+ * machine that reports 7.7 GiB of its 8 is not treated as a 4 GB one.
+ */
+export declare const LOCAL_MODELS: readonly LocalModelChoice[];
+export declare function recommendLocalModel(totalBytes: number): LocalModelChoice;
+export type LocalGpu = 'apple' | 'nvidia' | 'amd' | 'none';
+export interface OllamaInstallHelp {
+    /** Where Ollama is downloaded: data for the page, which names no host. */
+    url: string;
+    /** The one command that installs it here, shown with a copy button and never run by buddi. */
+    command?: string;
+}
+export interface OllamaMachine {
+    platform: NodeJS.Platform;
+    /** The machine's memory, in GiB, one decimal. */
+    memoryGb: number;
+    gpu: LocalGpu;
+    /** An `ollama` program or the Ollama app is on this machine, running or not. */
+    installed: boolean;
+    /** The model the first run offers to pull here. */
+    recommended: LocalModelChoice;
+    install: OllamaInstallHelp;
+    /**
+     * A model on this machine would be slow enough that Ollama Cloud is the
+     * better first brain: little memory, or no graphics chip Ollama can use.
+     */
+    cloudSuggested: boolean;
+}
+export declare const OLLAMA_INSTALL_URL = "https://ollama.com/download";
+/** The official Linux installer, exactly as ollama.com prints it. */
+export declare const OLLAMA_LINUX_COMMAND = "curl -fsSL https://ollama.com/install.sh | sh";
+export declare const OLLAMA_BREW_COMMAND = "brew install ollama";
+export declare function ollamaInstallHelp(platform: NodeJS.Platform): OllamaInstallHelp;
+export interface MachineDeps {
+    platform?: NodeJS.Platform;
+    arch?: string;
+    totalmem?: () => number;
+    exists?: (file: string) => boolean;
+    env?: NodeJS.ProcessEnv;
+}
+export declare function ollamaMachine(deps?: MachineDeps): OllamaMachine;
+export interface OllamaPull {
+    model: string;
+    state: 'pulling' | 'done' | 'failed';
+    /** Bytes fetched so far, over every layer Ollama has named. */
+    completed: number;
+    /** Bytes in all, as far as Ollama has said; 0 until the first layer. */
+    total: number;
+    /** Ollama's own last status line ("pulling manifest", "verifying sha256 digest"). */
+    status: string;
+    error?: string;
+}
+/** A model name as `ollama pull` takes it; nothing that could reach past the field. */
+export declare const OLLAMA_MODEL_NAME: RegExp;
+export declare class PullRefusal extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+export interface OllamaPullsDeps {
+    /** Where Ollama answers, without `/v1`. */
+    baseUrl: string;
+    transport?: HttpTransport;
+}
+/**
+ * One pull at a time, remembered until the next one. A pull of gigabytes
+ * goes quiet between layers, so the socket may be idle for a while; it is
+ * abandoned only after the transport's usual five minutes of silence.
+ */
+export declare function createOllamaPulls(deps: OllamaPullsDeps): {
+    /** Start pulling `model`, or answer the pull of it already going. */
+    start(model: string): OllamaPull;
+    /** The last pull, as it stands. */
+    read(): OllamaPull | null;
+    /** For tests: the pull's end. */
+    settled(): Promise<void>;
+};
+export type OllamaPulls = ReturnType<typeof createOllamaPulls>;
+//# sourceMappingURL=ollama-local.d.ts.map

package/packages/gateway/dist/ollama-local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama-local.d.ts","sourceRoot":"","sources":["../src/ollama-local.ts"],"names":[],"mappings":"AAaA,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAMzE,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,gBAAgB,EAKnD,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAGxE;AAMD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,GAAG,EAAE,MAAM,CAAC;IACZ,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,QAAQ,CAAC;IACd,gFAAgF;IAChF,SAAS,EAAE,OAAO,CAAC;IACnB,mDAAmD;IACnD,WAAW,EAAE,gBAAgB,CAAC;IAC9B,OAAO,EAAE,iBAAiB,CAAC;IAC3B;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,eAAO,MAAM,kBAAkB,gCAAgC,CAAC;AAChE,qEAAqE;AACrE,eAAO,MAAM,oBAAoB,kDAAkD,CAAC;AACpF,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAEzD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,iBAAiB,CAI9E;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAuBD,wBAAgB,aAAa,CAAC,IAAI,GAAE,WAAgB,GAAG,aAAa,CA0BnE;AAMD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IACrC,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,uFAAuF;AACvF,eAAO,MAAM,iBAAiB,QAA6E,CAAC;AAE5G,qBAAa,WAAY,SAAQ,KAAK;IAElC,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM;CAIlB;AAED,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe;IAoEnD,qEAAqE;iBACxD,MAAM,GAAG,UAAU;IAahC,mCAAmC;YAC3B,UAAU,GAAG,IAAI;IAGzB,iCAAiC;eACtB,OAAO,CAAC,IAAI,CAAC;EAI3B;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/packages/gateway/dist/ollama-local.js

@@ -0,0 +1,201 @@
+/**
+ * Ollama on this computer, for the zero-key first run: is it installed, how
+ * would the owner install it, which small model suits this machine, and a
+ * pull of that model with progress.
+ *
+ * Asked from the gateway, never from the page, for the reason the probe is
+ * (`web/onboarding.ts`): the dashboard reaches no host but its own, and the
+ * answers are about the machine buddi runs on. Nothing here installs Ollama:
+ * the install command is *shown*, and the owner runs it.
+ */
+import { existsSync, statSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { createHttpTransport } from '@buddi/runtime';
+/**
+ * The table: the largest model that leaves room for the rest of the machine.
+ * All four answer tool calls through Ollama's OpenAI-compatible endpoint,
+ * which an agent needs. The thresholds sit a little under 8, 16 and 32 so a
+ * machine that reports 7.7 GiB of its 8 is not treated as a 4 GB one.
+ */
+export const LOCAL_MODELS = [
+    { model: 'qwen3:14b', sizeGb: 9.3, fromGb: 30 },
+    { model: 'qwen3:8b', sizeGb: 5.2, fromGb: 15 },
+    { model: 'qwen3:4b', sizeGb: 2.5, fromGb: 7 },
+    { model: 'qwen3:1.7b', sizeGb: 1.4, fromGb: 0 },
+];
+export function recommendLocalModel(totalBytes) {
+    const gb = totalBytes / 1024 ** 3;
+    return LOCAL_MODELS.find((row) => gb >= row.fromGb) ?? LOCAL_MODELS[LOCAL_MODELS.length - 1];
+}
+export const OLLAMA_INSTALL_URL = 'https://ollama.com/download';
+/** The official Linux installer, exactly as ollama.com prints it. */
+export const OLLAMA_LINUX_COMMAND = 'curl -fsSL https://ollama.com/install.sh | sh';
+export const OLLAMA_BREW_COMMAND = 'brew install ollama';
+export function ollamaInstallHelp(platform) {
+    if (platform === 'linux')
+        return { url: OLLAMA_INSTALL_URL, command: OLLAMA_LINUX_COMMAND };
+    if (platform === 'darwin')
+        return { url: OLLAMA_INSTALL_URL, command: OLLAMA_BREW_COMMAND };
+    return { url: OLLAMA_INSTALL_URL };
+}
+function isFile(file) {
+    try {
+        return statSync(file).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Where an `ollama` may live. The service's PATH is often a short one
+ * (launchd, systemd), so the usual install places are looked at as well.
+ */
+function candidates(platform, env) {
+    const dirs = (env.PATH ?? '').split(path.delimiter).filter((dir) => dir !== '');
+    const fixed = ['/usr/local/bin', '/usr/bin', '/opt/homebrew/bin', '/snap/bin'];
+    const exe = platform === 'win32' ? 'ollama.exe' : 'ollama';
+    const files = [...new Set([...dirs, ...fixed])].map((dir) => path.join(dir, exe));
+    if (platform === 'darwin')
+        files.push('/Applications/Ollama.app/Contents/Resources/ollama');
+    return files;
+}
+export function ollamaMachine(deps = {}) {
+    const platform = deps.platform ?? process.platform;
+    const arch = deps.arch ?? process.arch;
+    const exists = deps.exists ?? existsSync;
+    const total = (deps.totalmem ?? os.totalmem)();
+    const memoryGb = Math.round((total / 1024 ** 3) * 10) / 10;
+    const gpu = platform === 'darwin'
+        ? arch === 'arm64' ? 'apple' : 'none'
+        : platform === 'linux'
+            ? exists('/dev/nvidia0') || exists('/proc/driver/nvidia/version') ? 'nvidia' : exists('/dev/kfd') ? 'amd' : 'none'
+            : 'none';
+    const fileExists = deps.exists ?? isFile;
+    const installed = candidates(platform, deps.env ?? process.env).some((file) => fileExists(file)) ||
+        (platform === 'darwin' && exists('/Applications/Ollama.app'));
+    const recommended = recommendLocalModel(total);
+    return {
+        platform,
+        memoryGb,
+        gpu,
+        installed,
+        recommended,
+        install: ollamaInstallHelp(platform),
+        cloudSuggested: memoryGb < 7 || gpu === 'none',
+    };
+}
+/** A model name as `ollama pull` takes it; nothing that could reach past the field. */
+export const OLLAMA_MODEL_NAME = /^[a-z0-9][a-z0-9._-]*(\/[a-z0-9][a-z0-9._-]*)*(:[a-z0-9][a-z0-9._-]*)?$/i;
+export class PullRefusal extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+    }
+}
+/**
+ * One pull at a time, remembered until the next one. A pull of gigabytes
+ * goes quiet between layers, so the socket may be idle for a while; it is
+ * abandoned only after the transport's usual five minutes of silence.
+ */
+export function createOllamaPulls(deps) {
+    const transport = deps.transport ?? createHttpTransport();
+    const base = deps.baseUrl.replace(/\/+$/, '');
+    let current = null;
+    let running = null;
+    const apply = (pull, layers, line) => {
+        let row;
+        try {
+            row = JSON.parse(line);
+        }
+        catch {
+            return;
+        }
+        if (typeof row.error === 'string') {
+            pull.state = 'failed';
+            pull.error = row.error;
+            return;
+        }
+        if (typeof row.status === 'string')
+            pull.status = row.status;
+        if (typeof row.digest === 'string' && typeof row.total === 'number') {
+            const completed = typeof row.completed === 'number' ? row.completed : 0;
+            const before = layers.get(row.digest);
+            layers.set(row.digest, { total: row.total, completed: Math.max(before?.completed ?? 0, completed) });
+            pull.total = [...layers.values()].reduce((sum, layer) => sum + layer.total, 0);
+            pull.completed = [...layers.values()].reduce((sum, layer) => sum + Math.min(layer.completed, layer.total), 0);
+        }
+        if (row.status === 'success') {
+            pull.state = 'done';
+            pull.completed = pull.total;
+        }
+    };
+    const run = async (pull) => {
+        const layers = new Map();
+        let carry = '';
+        try {
+            const res = await transport(`${base}/api/pull`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', Accept: 'application/x-ndjson' },
+                body: JSON.stringify({ model: pull.model, stream: true }),
+                onChunk: (text) => {
+                    carry += text;
+                    const lines = carry.split('\n');
+                    carry = lines.pop() ?? '';
+                    for (const line of lines)
+                        if (line.trim())
+                            apply(pull, layers, line);
+                },
+            });
+            // The whole body is here as well: read whatever the tap did not see.
+            if (carry.trim())
+                apply(pull, layers, carry);
+            if (pull.state === 'pulling') {
+                const lines = (await res.text()).split('\n').filter((line) => line.trim());
+                for (const line of lines)
+                    if (pull.state === 'pulling')
+                        apply(pull, layers, line);
+            }
+            if (!res.ok && pull.state !== 'failed') {
+                pull.state = 'failed';
+                pull.error = pull.error ?? `Ollama answered ${res.status}.`;
+            }
+            if (pull.state === 'pulling') {
+                pull.state = 'failed';
+                pull.error = 'Ollama stopped before the model was complete. Try again.';
+            }
+        }
+        catch (err) {
+            pull.state = 'failed';
+            pull.error = `Ollama is not answering: ${err instanceof Error ? err.message : String(err)}`;
+        }
+    };
+    return {
+        /** Start pulling `model`, or answer the pull of it already going. */
+        start(model) {
+            const name = model.trim();
+            if (!OLLAMA_MODEL_NAME.test(name) || name.length > 120)
+                throw new PullRefusal(400, 'That is not a model name Ollama knows.');
+            if (current?.state === 'pulling') {
+                if (current.model === name)
+                    return { ...current };
+                throw new PullRefusal(409, `Ollama is already fetching ${current.model}. Wait for it, then try again.`);
+            }
+            const pull = { model: name, state: 'pulling', completed: 0, total: 0, status: 'starting' };
+            current = pull;
+            const snapshot = { ...pull };
+            running = run(pull);
+            return snapshot;
+        },
+        /** The last pull, as it stands. */
+        read() {
+            return current ? { ...current } : null;
+        },
+        /** For tests: the pull's end. */
+        settled() {
+            return running ?? Promise.resolve();
+        },
+    };
+}
+//# sourceMappingURL=ollama-local.js.map

package/packages/gateway/dist/ollama-local.js.map

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

package/packages/gateway/dist/plugins-cli.d.ts

@@ -78,6 +78,14 @@ export declare function stagedListing(staged: StagedPlugin[], now?: Date): strin
  * Pure over the stage and the imported manifest.
  */
 export declare function describeJson(staged: StagedPlugin, manifest: PluginManifest): Record<string, unknown>;
+/**
+ * The widgets a listing claims: each one checked the way register checks it
+ * (a declaration that would not load throws here too), as the market shows
+ * them — id, title, sizes, whether it is sensitive, what each placement can
+ * set (keys, kinds and labels; options read from the owner's data are not
+ * listed), and the sample body the plugin declares as `preview`, if any.
+ */
+export declare function widgetClaims(manifest: PluginManifest): Array<Record<string, unknown>>;
 /**
  * Stage, import the manifest, print, delete the stage.
  *