@ashlr/hub 3.13.0 → 3.14.0

package/dist/core/integrations/telegram.d.ts

@@ -19,18 +19,55 @@
  *
  * Offset persistence: ~/.ashlr/comms/telegram-offset (plain text, one integer).
  *
+ * Formatting (3.14): every send uses parse_mode=HTML, so text is ESCAPED by
+ * default (escapeTelegramHtml) — a stray `<` in model text used to make
+ * Telegram reject the whole send. Callers that build Telegram HTML themselves
+ * pass `html: true`. Messages over 4096 chars are split on line boundaries;
+ * buttons ride on the last chunk. A send Telegram rejects for bad markup is
+ * retried once as plain text.
+ *
+ * Threading (3.14): sends can reply to a message (replyToMessageId) and
+ * report every message_id they produced; inbound events carry the message's
+ * own id and the id it replied to, so the comms layer can map Telegram
+ * messages to Leader-thread messages.
+ *
  * Never throws — all errors silently degrade to {ok:false} / [].
  */
 import type { AshlrConfig } from '../types.js';
+export { escapeTelegramHtml, splitTelegramText, TELEGRAM_MAX_MESSAGE } from './telegram-format.js';
+/** One inline-keyboard button: a callback (data ≤ 64 bytes) or a public URL. */
+export type TelegramButton = {
+    text: string;
+    data: string;
+} | {
+    text: string;
+    url: string;
+};
 export interface TelegramSendOpts {
-    /** Inline button labels. One per row. callback_data = "<requestId>:<optionIndex>". */
+    /**
+     * Inline button labels. One per row. callback_data = "<requestId>:<optionIndex>".
+     * A label of the form "Label|target" sends `target` as the callback_data
+     * instead (or as a URL button when target is a public http(s) URL; local
+     * URLs Telegram cannot open are dropped).
+     */
     buttons?: string[];
     /** requestId to embed in callback_data (required when buttons is set). */
     requestId?: string;
+    /** Explicit inline keyboard (rows of buttons). Takes precedence over `buttons`. */
+    keyboard?: TelegramButton[][];
+    /** The text is caller-built Telegram HTML — do not escape it. Default false. */
+    html?: boolean;
+    /** Send as a reply to this Telegram message id (ignored if it no longer exists). */
+    replyToMessageId?: number;
 }
 export interface TelegramSendResult {
     ok: boolean;
+    /** message_id of the FIRST chunk (the one a reply should target). */
     messageId?: number;
+    /** message_id of every chunk that was delivered, in order. */
+    messageIds?: number[];
+    /** True when the text was split and a later chunk failed after the first landed. */
+    partial?: boolean;
 }
 /** An inbound event parsed from a Telegram update. */
 export interface InboundEvent {
@@ -46,6 +83,16 @@ export interface InboundEvent {
     fromChatId: string;
     /** Telegram callback_query id — needed to ack via answerCallbackQuery. */
     callbackQueryId?: string;
+    /** kind='text': this message's id. kind='callback': the id of the message whose button was tapped. */
+    messageId?: number;
+    /** kind='text': the id of the message Mason replied to (reply_to_message), if any. */
+    replyToMessageId?: number;
+    /**
+     * kind='callback': the raw callback_data, set for routed prefixes
+     * (`lt:` Leader-thread buttons, `revert:` merge buttons) that are not
+     * "<requestId>:<index>" pairs.
+     */
+    data?: string;
 }
 export interface PollResult {
     updates: InboundEvent[];
@@ -53,11 +100,20 @@ export interface PollResult {
 }
 /** True when Telegram transport is usably configured. */
 export declare function telegramEnabled(cfg: AshlrConfig): boolean;
+/**
+ * Test seam: a fake Bot API transport. Receives the METHOD name (never the
+ * URL, so the token cannot leak into a fake) and the JSON body; returns the
+ * parsed API response (or null for a network failure). Null restores HTTPS.
+ */
+export type TelegramTransport = (method: string, body: Record<string, unknown>) => Promise<unknown>;
+export declare function setTelegramTransportForTests(t: TelegramTransport | null): void;
 /**
  * Send a Telegram message to cfg.comms.telegram.chatId.
  *
- * When opts.buttons is set, each button becomes a row in an inline_keyboard.
- * callback_data = "<requestId>:<0-based-index>" for clean resolution.
+ * Text is escaped for parse_mode=HTML unless opts.html is set, and split into
+ * ≤4096-char chunks (buttons ride on the last chunk; replyToMessageId applies
+ * to the first). When opts.buttons is set, each button becomes a row in an
+ * inline_keyboard with callback_data = "<requestId>:<0-based-index>".
  *
  * No-op (ok:false) when not configured. Never throws.
  */
@@ -74,4 +130,4 @@ export declare function pollTelegramUpdates(cfg: AshlrConfig): Promise<PollResul
  * Acknowledge a Telegram callback_query so the spinner on the button is removed.
  * Fire-and-forget; never throws.
  */
-export declare function answerCallbackQuery(callbackQueryId: string, cfg: AshlrConfig): Promise<void>;
+export declare function answerCallbackQuery(callbackQueryId: string, cfg: AshlrConfig, text?: string): Promise<void>;

package/dist/core/integrations/telegram.js

@@ -19,11 +19,27 @@
  *
  * Offset persistence: ~/.ashlr/comms/telegram-offset (plain text, one integer).
  *
+ * Formatting (3.14): every send uses parse_mode=HTML, so text is ESCAPED by
+ * default (escapeTelegramHtml) — a stray `<` in model text used to make
+ * Telegram reject the whole send. Callers that build Telegram HTML themselves
+ * pass `html: true`. Messages over 4096 chars are split on line boundaries;
+ * buttons ride on the last chunk. A send Telegram rejects for bad markup is
+ * retried once as plain text.
+ *
+ * Threading (3.14): sends can reply to a message (replyToMessageId) and
+ * report every message_id they produced; inbound events carry the message's
+ * own id and the id it replied to, so the comms layer can map Telegram
+ * messages to Leader-thread messages.
+ *
  * Never throws — all errors silently degrade to {ok:false} / [].
  */
 import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
+import { splitTelegramText, telegramHtmlToPlain } from './telegram-format.js';
+export { escapeTelegramHtml, splitTelegramText, TELEGRAM_MAX_MESSAGE } from './telegram-format.js';
+/** callback_data prefixes routed by the comms layer instead of the request store. */
+const ROUTED_CALLBACK_PREFIXES = ['lt:', 'revert:'];
 // ---------------------------------------------------------------------------
 // Internal helpers
 // ---------------------------------------------------------------------------
@@ -82,6 +98,21 @@ function scrubToken(msg, token) {
     // Replace all occurrences of the token (it may appear in a URL)
     return msg.split(token).join('[REDACTED]');
 }
+let _transport = null;
+export function setTelegramTransportForTests(t) {
+    _transport = t;
+}
+async function callApi(cfg, method, body) {
+    if (_transport) {
+        try {
+            return await _transport(method, body);
+        }
+        catch {
+            return null;
+        }
+    }
+    return postJson(apiUrl(cfg, method), body, resolveToken(cfg));
+}
 /** Make an HTTPS POST with JSON body. Returns parsed response body or null on error. */
 async function postJson(url, body, _token) {
     const payload = JSON.stringify(body);
@@ -123,11 +154,74 @@ async function postJson(url, body, _token) {
 // ---------------------------------------------------------------------------
 // sendTelegramMessage
 // ---------------------------------------------------------------------------
+const CALLBACK_DATA_MAX_BYTES = 64;
+function isPublicHttpUrl(target) {
+    try {
+        const u = new URL(target);
+        if (u.protocol !== 'http:' && u.protocol !== 'https:')
+            return false;
+        const h = u.hostname.toLowerCase();
+        // Telegram rejects the WHOLE send for a URL button it cannot open.
+        return !(h === 'localhost' || h.endsWith('.localhost') || h === '0.0.0.0' || h.startsWith('127.') || h === '[::1]');
+    }
+    catch {
+        return false;
+    }
+}
+function callbackDataOk(data) {
+    const bytes = Buffer.byteLength(data, 'utf8');
+    return bytes > 0 && bytes <= CALLBACK_DATA_MAX_BYTES;
+}
+/** Build the inline keyboard for a send (null = no keyboard). */
+function buildKeyboard(opts) {
+    if (opts?.keyboard && opts.keyboard.length > 0) {
+        const rows = opts.keyboard
+            .map((row) => row
+            .filter((b) => ('url' in b ? isPublicHttpUrl(b.url) : callbackDataOk(b.data)))
+            .map((b) => ('url' in b ? { text: b.text, url: b.url } : { text: b.text, callback_data: b.data })))
+            .filter((row) => row.length > 0);
+        return rows.length > 0 ? rows : null;
+    }
+    if (opts?.buttons && opts.buttons.length > 0) {
+        const reqId = opts.requestId ?? 'unknown';
+        const rows = [];
+        opts.buttons.forEach((label, idx) => {
+            const pipe = label.indexOf('|');
+            if (pipe < 0) {
+                rows.push([{ text: label, callback_data: `${reqId}:${idx}` }]);
+                return;
+            }
+            const text = label.slice(0, pipe);
+            const target = label.slice(pipe + 1);
+            if (/^https?:\/\//i.test(target)) {
+                if (isPublicHttpUrl(target))
+                    rows.push([{ text, url: target }]);
+                return; // a local URL cannot be opened from a phone — drop the button
+            }
+            if (callbackDataOk(target))
+                rows.push([{ text, callback_data: target }]);
+        });
+        return rows.length > 0 ? rows : null;
+    }
+    return null;
+}
+function parseSendResponse(resp) {
+    if (!resp || typeof resp !== 'object')
+        return { ok: false };
+    const r = resp;
+    if (r['ok'] === true) {
+        const result = r['result'];
+        return { ok: true, messageId: typeof result?.['message_id'] === 'number' ? result['message_id'] : undefined };
+    }
+    return { ok: false, description: typeof r['description'] === 'string' ? r['description'] : undefined };
+}
 /**
  * Send a Telegram message to cfg.comms.telegram.chatId.
  *
- * When opts.buttons is set, each button becomes a row in an inline_keyboard.
- * callback_data = "<requestId>:<0-based-index>" for clean resolution.
+ * Text is escaped for parse_mode=HTML unless opts.html is set, and split into
+ * ≤4096-char chunks (buttons ride on the last chunk; replyToMessageId applies
+ * to the first). When opts.buttons is set, each button becomes a row in an
+ * inline_keyboard with callback_data = "<requestId>:<0-based-index>".
  *
  * No-op (ok:false) when not configured. Never throws.
  */
@@ -137,28 +231,43 @@ export async function sendTelegramMessage(text, opts, cfg) {
     const token = resolveToken(cfg);
     const chatId = resolveChatId(cfg);
     try {
-        const body = {
-            chat_id: chatId,
-            text,
-            parse_mode: 'HTML',
-        };
-        if (opts?.buttons && opts.buttons.length > 0) {
-            const reqId = opts.requestId ?? 'unknown';
-            body['reply_markup'] = {
-                inline_keyboard: opts.buttons.map((label, idx) => [
-                    { text: label, callback_data: `${reqId}:${idx}` },
-                ]),
+        const chunks = splitTelegramText(String(text ?? ''), { html: opts?.html === true }).filter((c) => c.length > 0);
+        if (chunks.length === 0)
+            return { ok: false };
+        const keyboard = buildKeyboard(opts);
+        const messageIds = [];
+        for (let i = 0; i < chunks.length; i++) {
+            const chunk = chunks[i];
+            const body = {
+                chat_id: chatId,
+                text: chunk,
+                parse_mode: 'HTML',
             };
+            if (i === 0 && typeof opts?.replyToMessageId === 'number' && opts.replyToMessageId > 0) {
+                // allow_sending_without_reply: a deleted original must not fail the send.
+                body['reply_parameters'] = { message_id: opts.replyToMessageId, allow_sending_without_reply: true };
+            }
+            if (i === chunks.length - 1 && keyboard) {
+                body['reply_markup'] = { inline_keyboard: keyboard };
+            }
+            let res = parseSendResponse(await callApi(cfg, 'sendMessage', body));
+            if (!res.ok && res.description && /pars|entit/i.test(res.description)) {
+                // Markup Telegram cannot parse: retry once as plain text (no parse_mode).
+                const plain = { ...body, text: telegramHtmlToPlain(chunk) };
+                delete plain['parse_mode'];
+                res = parseSendResponse(await callApi(cfg, 'sendMessage', plain));
+            }
+            if (!res.ok) {
+                // First chunk failed → nothing landed. A later chunk failing still
+                // counts as delivered (re-sending would duplicate what Mason has).
+                return messageIds.length === 0 && i === 0
+                    ? { ok: false }
+                    : { ok: true, messageId: messageIds[0], messageIds, partial: true };
+            }
+            if (typeof res.messageId === 'number')
+                messageIds.push(res.messageId);
         }
-        const url = apiUrl(cfg, 'sendMessage');
-        const resp = await postJson(url, body, token);
-        if (resp &&
-            typeof resp === 'object' &&
-            resp['ok'] === true) {
-            const result = resp['result'];
-            return { ok: true, messageId: typeof result?.['message_id'] === 'number' ? result['message_id'] : undefined };
-        }
-        return { ok: false };
+        return { ok: true, messageId: messageIds[0], messageIds };
     }
     catch (err) {
         // Scrub token from any error that might surface it
@@ -190,8 +299,7 @@ export async function pollTelegramUpdates(cfg) {
         };
         if (offset > 0)
             body['offset'] = offset;
-        const url = apiUrl(cfg, 'getUpdates');
-        const resp = await postJson(url, body, token);
+        const resp = await callApi(cfg, 'getUpdates', body);
         if (!resp ||
             typeof resp !== 'object' ||
             resp['ok'] !== true) {
@@ -219,7 +327,16 @@ export async function pollTelegramUpdates(cfg) {
                     continue; // auth: drop foreign
                 const text = typeof msg['text'] === 'string' ? msg['text'] : undefined;
                 if (text !== undefined) {
-                    events.push({ kind: 'text', text, fromChatId });
+                    const messageId = typeof msg['message_id'] === 'number' ? msg['message_id'] : undefined;
+                    const replied = msg['reply_to_message'];
+                    const replyToMessageId = replied && typeof replied['message_id'] === 'number' ? replied['message_id'] : undefined;
+                    events.push({
+                        kind: 'text',
+                        text,
+                        fromChatId,
+                        ...(messageId !== undefined ? { messageId } : {}),
+                        ...(replyToMessageId !== undefined ? { replyToMessageId } : {}),
+                    });
                 }
             }
             // Callback query (button tap)
@@ -231,6 +348,18 @@ export async function pollTelegramUpdates(cfg) {
                     continue; // auth: drop foreign
                 const callbackQueryId = typeof cbq['id'] === 'string' ? cbq['id'] : undefined;
                 const data = typeof cbq['data'] === 'string' ? cbq['data'] : '';
+                const cbMsg = cbq['message'];
+                const tappedMessageId = typeof cbMsg?.['message_id'] === 'number' ? cbMsg['message_id'] : undefined;
+                if (ROUTED_CALLBACK_PREFIXES.some((p) => data.startsWith(p))) {
+                    events.push({
+                        kind: 'callback',
+                        data,
+                        fromChatId,
+                        callbackQueryId,
+                        ...(tappedMessageId !== undefined ? { messageId: tappedMessageId } : {}),
+                    });
+                    continue;
+                }
                 // Parse callback_data = "<requestId>:<optionIndex>"
                 const colonIdx = data.lastIndexOf(':');
                 if (colonIdx < 0)
@@ -246,6 +375,7 @@ export async function pollTelegramUpdates(cfg) {
                     optionIndex: idxRaw,
                     fromChatId,
                     callbackQueryId,
+                    ...(tappedMessageId !== undefined ? { messageId: tappedMessageId } : {}),
                 });
             }
         }
@@ -267,12 +397,15 @@ export async function pollTelegramUpdates(cfg) {
  * Acknowledge a Telegram callback_query so the spinner on the button is removed.
  * Fire-and-forget; never throws.
  */
-export async function answerCallbackQuery(callbackQueryId, cfg) {
+export async function answerCallbackQuery(callbackQueryId, cfg, text) {
     if (!telegramEnabled(cfg))
         return;
     try {
-        const url = apiUrl(cfg, 'answerCallbackQuery');
-        await postJson(url, { callback_query_id: callbackQueryId }, resolveToken(cfg));
+        const body = { callback_query_id: callbackQueryId };
+        // A toast is plain text (no parse_mode) and capped at 200 chars by Telegram.
+        if (text)
+            body['text'] = text.slice(0, 200);
+        await callApi(cfg, 'answerCallbackQuery', body);
     }
     catch {
         // best-effort ack — failure is harmless (spinner times out on its own)

package/dist/core/integrations/telegram.js.map

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

package/dist/core/mcp-registry.d.ts

@@ -28,6 +28,18 @@ export declare function knownConfigPaths(): string[];
  * via redactEnv().
  */
 export declare function discoverMcpServers(paths?: string[]): McpRegistry;
+/**
+ * {@link discoverMcpServers} for a server's request path (GET /api/verse/mcp):
+ * the same files, order, de-duplication and answer, but the reads happen off
+ * the event loop, concurrently, and a file whose size and mtime have not
+ * changed since the last call is not re-read or re-parsed. ~/.claude.json
+ * alone is routinely several MB (Claude Code keeps per-project history in
+ * it), and reading plus parsing it synchronously on every request stalled
+ * every other route for the duration. Never throws.
+ */
+export declare function discoverMcpServersAsync(paths?: string[]): Promise<McpRegistry>;
+/** Test seam: forget every cached parse. */
+export declare function resetMcpRegistryCache(): void;
 /**
  * Return a copy of the spec with all env values replaced by the literal
  * string '<set>'.  Use this before printing or serialising for display.

package/dist/core/mcp-registry.js

@@ -8,6 +8,7 @@
  * redactEnv() before displaying any spec.
  */
 import { readFileSync, existsSync } from 'node:fs';
+import { readFile, stat } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 // ---------------------------------------------------------------------------
@@ -74,6 +75,75 @@ export function discoverMcpServers(paths) {
     }
     return { servers };
 }
+/**
+ * {@link discoverMcpServers} for a server's request path (GET /api/verse/mcp):
+ * the same files, order, de-duplication and answer, but the reads happen off
+ * the event loop, concurrently, and a file whose size and mtime have not
+ * changed since the last call is not re-read or re-parsed. ~/.claude.json
+ * alone is routinely several MB (Claude Code keeps per-project history in
+ * it), and reading plus parsing it synchronously on every request stalled
+ * every other route for the duration. Never throws.
+ */
+export async function discoverMcpServersAsync(paths) {
+    const configPaths = paths ?? knownConfigPaths();
+    const perFile = await Promise.all(configPaths.map((configPath) => specsFromFileAsync(configPath)));
+    const seen = new Set();
+    const servers = [];
+    for (const specsFromFile of perFile) {
+        for (const spec of specsFromFile) {
+            if (!seen.has(spec.name)) {
+                seen.add(spec.name);
+                servers.push(spec);
+            }
+        }
+    }
+    return { servers };
+}
+/** Last parse of each config file, keyed by path; reused while size and mtime match. */
+const parsedConfigCache = new Map();
+/** Test seam: forget every cached parse. */
+export function resetMcpRegistryCache() {
+    parsedConfigCache.clear();
+}
+async function specsFromFileAsync(configPath) {
+    let before;
+    try {
+        before = await stat(configPath);
+    }
+    catch {
+        // Missing (or unreadable): skipped, as `existsSync` skips it.
+        parsedConfigCache.delete(configPath);
+        return [];
+    }
+    const cached = parsedConfigCache.get(configPath);
+    if (cached && cached.size === before.size && cached.mtimeMs === before.mtimeMs) {
+        return structuredClone(cached.specs);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(await readFile(configPath, 'utf8'));
+    }
+    catch {
+        // Unreadable or malformed: skip silently per contract.
+        parsedConfigCache.delete(configPath);
+        return [];
+    }
+    const specs = extractSpecsFromConfig(parsed, configPath);
+    // Cache only a parse whose file did not change underneath the read.
+    try {
+        const after = await stat(configPath);
+        if (after.size === before.size && after.mtimeMs === before.mtimeMs) {
+            parsedConfigCache.set(configPath, { size: after.size, mtimeMs: after.mtimeMs, specs: structuredClone(specs) });
+        }
+        else {
+            parsedConfigCache.delete(configPath);
+        }
+    }
+    catch {
+        parsedConfigCache.delete(configPath);
+    }
+    return specs;
+}
 /**
  * Return a copy of the spec with all env values replaced by the literal
  * string '<set>'.  Use this before printing or serialising for display.

package/dist/core/mcp-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-registry.js","sourceRoot":"","sources":["../../src/core/mcp-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,OAAO;QACL,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC;QAC1B,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,eAAe,CAAC;QACtC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC;QACvB,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,eAAe,CAAC;QACzC,2DAA2D;QAC3D,IAAI,CAAC,IAAI,EAAE,kBAAkB,EAAE,eAAe,CAAC;QAC/C,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,eAAe,CAAC;QAClC,0FAA0F;QAC1F,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,CAAC;KACtC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAgB;IACjD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAoB,EAAE,CAAC;IAEpC,6EAA6E;IAC7E,2CAA2C;IAC3C,MAAM,WAAW,GAAG,KAAK,IAAI,gBAAgB,EAAE,CAAC;IAEhD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,SAAS;QAEtC,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAC7C,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,wDAAwD;YACxD,SAAS;QACX,CAAC;QAED,0DAA0D;QAC1D,MAAM,aAAa,GAAG,sBAAsB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACjE,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAmB;IAC3C,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACxC,QAAQ,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;IAC1B,CAAC;IACD,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;AACpC,CAAC;AAaD;;;;;;;;;GASG;AACH,SAAS,sBAAsB,CAAC,MAAe,EAAE,MAAc;IAC7D,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,GAAG,GAAG,MAAiC,CAAC;IAC9C,MAAM,KAAK,GAAoB,EAAE,CAAC;IAElC,gCAAgC;IAChC,IAAI,GAAG,CAAC,YAAY,CAAC,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,sBAAsB,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,kCAAkC;IAClC,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;IACjC,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClF,MAAM,WAAW,GAAG,QAAmC,CAAC;QACxD,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YAClD,MAAM,OAAO,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;YACxC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/E,MAAM,IAAI,GAAG,OAAkC,CAAC;gBAChD,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,SAAS,EAAE,CAAC;oBACrC,MAAM,WAAW,GAAG,sBAAsB,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;oBACvE,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,SAAS,sBAAsB,CAAC,GAAY,EAAE,MAAc;IAC1D,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAClE,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,GAAG,GAAG,GAA8B,CAAC;IAC3C,MAAM,KAAK,GAAoB,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACxE,SAAS;QACX,CAAC;QAED,MAAM,CAAC,GAAG,KAAuB,CAAC;QAElC,4CAA4C;QAC5C,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC7D,SAAS;QACX,CAAC;QAED,sCAAsC;QACtC,IAAI,IAAI,GAAa,EAAE,CAAC;QACxB,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;QAClE,CAAC;QAED,0DAA0D;QAC1D,IAAI,GAAuC,CAAC;QAC5C,IAAI,CAAC,CAAC,GAAG,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YACzE,MAAM,MAAM,GAAG,CAAC,CAAC,GAA8B,CAAC;YAChD,MAAM,OAAO,GAA2B,EAAE,CAAC;YAC3C,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpC,IAAI,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;oBAClC,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAW,CAAC;gBACnC,CAAC;YACH,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpC,GAAG,GAAG,OAAO,CAAC;YAChB,CAAC;QACH,CAAC;QAED,MAAM,IAAI,GAAkB;YAC1B,IAAI;YACJ,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE;YACzB,IAAI;YACJ,MAAM;SACP,CAAC;QACF,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACjB,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"mcp-registry.js","sourceRoot":"","sources":["../../src/core/mcp-registry.ts"],"names":[],"mappings":"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"}

package/dist/core/observability/rollup.d.ts

@@ -86,17 +86,19 @@ export interface CachedRollup {
     ageMs: number;
 }
 /**
- * Stale-while-revalidate rollup for request handlers.
- *   - cold: await one computation (single-flight across concurrent callers);
- *   - fresh (< TTL): return immediately;
- *   - stale (< MAX_STALE): return immediately with `stale: true` and start
- *     one background refresh;
- *   - older: wait for a refresh (serving hour-old numbers as current is a lie).
- * `compute` defaults to buildRollupAsync; the Verse server passes a
- * read-projection-worker reader so the refresh never runs on the request
- * thread at all. A failed refresh keeps the last good value. Throws only when
- * there is no value at all and the computation fails.
+ * The cached rollup WITHOUT ever waiting for, or computing, one on the
+ * calling thread — for request paths that only decorate their answer with it
+ * (the Verse cockpit's quota row). Returns the cached value (null when there
+ * is none, or it is older than ROLLUP_CACHE_MAX_STALE_MS) and, when it is
+ * missing or past ROLLUP_CACHE_TTL_MS, starts one background refresh through
+ * `compute` — only if a `compute` is given: a caller without a worker gets
+ * whatever another caller cached and never pays for the rollup itself (its
+ * usage collection and per-repo git state reads are synchronous; the repos
+ * are operator folders, see verse/folder-io.ts). Never throws.
  */
+export declare function peekCachedRollup(window: '1d' | '7d' | '30d', cfg: AshlrConfig, opts?: {
+    compute?: () => Promise<ActivityRollup>;
+}): CachedRollup | null;
 export declare function getCachedRollup(window: '1d' | '7d' | '30d', cfg: AshlrConfig, opts?: {
     project?: string;
     compute?: () => Promise<ActivityRollup>;