@songsid/agend 2.2.0-beta.1 → 2.2.0-beta.3

package/dist/channel/telegram-markdown.js

@@ -0,0 +1,104 @@
+/**
+ * Markdown → Telegram HTML (parse_mode "HTML") for text an agent wrote as markdown.
+ *
+ * Escape first, by construction: every character of the input is escaped (`&`, `<`, `>`) before any tag is added, and
+ * the only tags in the output are the ones this file writes — so `a<b`, `&` or a literal `<b>` in the input are shown
+ * as text, never parsed. A fixed set of inline forms becomes tags: `code`, **bold**, ~~strike~~, *italic* / _italic_
+ * and [text](http(s) URL). Each tag pair wraps text that contains no tag yet (code spans, fences and link targets are
+ * cut out before emphasis runs; emphasis content excludes `<` `>`), so the output is always well-formed. A fence or
+ * any other run of two or more backticks keeps its text exactly — escaped, backticks and all, never formatted.
+ * Tables and headings stay as their literal characters.
+ *
+ * Linear time: the text can be as long as a tool argument allows (far beyond Telegram's 4096), and this runs on the
+ * fleet's event loop before any API call. One left-to-right pass; each scan stops at the next character that could
+ * start another token, and the emphasis patterns stop at their own next delimiter.
+ */
+import { GrammyError } from "grammy";
+const escapeHtml = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+/** Emphasis on already-escaped text. Bold first; strike and italic never span a tag (their content excludes < >). */
+function emphasis(escaped) {
+    return escaped
+        .replace(/\*\*([^*\n]+?)\*\*/g, "<b>$1</b>")
+        .replace(/~~([^~\n<>]+?)~~/g, "<s>$1</s>")
+        .replace(/(^|[^\w*])\*([^*\s<>](?:[^*\n<>]*?[^*\s<>])?)\*(?![\w*])/g, "$1<i>$2</i>")
+        // `_` only at word edges, so snake_case stays as it is.
+        .replace(/(^|[^\w])_([^_\s<>](?:[^_\n<>]*?[^_\s<>])?)_(?!\w)/g, "$1<i>$2</i>");
+}
+/** `(http(s)://target)` right after a link's `]`; the target stops at whitespace, parentheses, quotes and < >. */
+const LINK_TARGET = /\((https?:\/\/[^\s()<>"]+)\)/y;
+/** Every maximal run of 2+ backticks, by length — so finding a fence's closing run never rescans the text. */
+function backtickRuns(text) {
+    const runs = new Map();
+    for (let i = text.indexOf("`"); i >= 0; i = text.indexOf("`", i)) {
+        let n = 1;
+        while (text[i + n] === "`")
+            n++;
+        if (n >= 2)
+            (runs.get(n) ?? runs.set(n, []).get(n)).push(i);
+        i += n;
+    }
+    return runs;
+}
+export function markdownToTelegramHtml(text) {
+    const runs = backtickRuns(text);
+    const cursor = new Map();
+    /** The first run of exactly `n` backticks starting at or after `from` (callers ask with a rising `from`). */
+    const nextRun = (n, from) => {
+        const list = runs.get(n) ?? [];
+        let k = cursor.get(n) ?? 0;
+        while (k < list.length && list[k] < from)
+            k++;
+        cursor.set(n, k);
+        return k < list.length ? list[k] : -1;
+    };
+    let out = "", from = 0, i = 0;
+    const token = (start, end, html) => {
+        if (start > from)
+            out += emphasis(escapeHtml(text.slice(from, start)));
+        out += html;
+        from = i = end;
+    };
+    while (i < text.length) {
+        const c = text[i];
+        if (c === "`") {
+            let n = 1;
+            while (text[i + n] === "`")
+                n++;
+            if (n >= 2) {
+                // A fence or a multi-backtick span: literal through its closing run of the same length (or just the run).
+                const close = nextRun(n, i + n);
+                const end = close < 0 ? i + n : close + n;
+                token(i, end, escapeHtml(text.slice(i, end)));
+                continue;
+            }
+            const j = text.indexOf("`", i + 1);
+            if (j > i + 1 && text[j + 1] !== "`" && !text.slice(i + 1, j).includes("\n")) {
+                token(i, j + 1, `<code>${escapeHtml(text.slice(i + 1, j))}</code>`);
+                continue;
+            }
+        }
+        else if (c === "[") {
+            let k = i + 1;
+            while (k < text.length && text[k] !== "]" && text[k] !== "[" && text[k] !== "\n")
+                k++;
+            if (text[k] === "]" && k > i + 1) {
+                LINK_TARGET.lastIndex = k + 1;
+                const m = LINK_TARGET.exec(text);
+                if (m) {
+                    token(i, k + 1 + m[0].length, `<a href="${escapeHtml(m[1])}">${emphasis(escapeHtml(text.slice(i + 1, k)))}</a>`);
+                    continue;
+                }
+            }
+        }
+        i++;
+    }
+    return out + emphasis(escapeHtml(text.slice(from)));
+}
+/**
+ * Telegram refused the text's markup itself ("Bad Request: can't parse entities: …"): a definite 400 before anything
+ * changed, so sending the same text again without a parse mode is safe and cannot double-apply.
+ */
+export function isTelegramParseRefusal(err) {
+    return err instanceof GrammyError && err.error_code === 400 && /can't parse entities/i.test(err.description);
+}
+//# sourceMappingURL=telegram-markdown.js.map

package/dist/channel/telegram-markdown.js.map

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

package/dist/channel/tool-router.js

@@ -63,7 +63,8 @@ extra = {}) {
                 return true;
             }
             const replyThreadId = args.thread_id ?? threadId;
-            const format = args.format === "markdown" ? "html" : undefined;
+            // #1658: markdown reaches the adapter as markdown — Telegram converts it escape-first (its rich path is unchanged).
+            const format = args.format === "markdown" ? "markdown" : undefined;
             // Stickers (#1226) go with the text, as the platform does it — and were checked by the fleet before this
             // call; an adapter that cannot send them says so rather than dropping them.
             const stickers = Array.isArray(args.stickers) ? args.stickers.filter((x) => typeof x === "string") : [];
@@ -100,11 +101,16 @@ extra = {}) {
                 .then(() => respond("ok"))
                 .catch(e => respond(null, e.message));
             return true;
-        case "edit_message":
-            adapter.editMessage(chatId, args.message_id ?? "", args.text ?? "", threadId)
+        case "edit_message": {
+            // #1651: "markdown" reaches the adapter as markdown — Telegram converts it escape-first, so a `<` or `&` in the
+            // text is shown, not refused. A text edit is the call it always was — no options argument at all.
+            const format = args.format === "markdown" ? "markdown" : undefined;
+            const messageId = args.message_id ?? "", text = args.text ?? "";
+            (format ? adapter.editMessage(chatId, messageId, text, threadId, { format }) : adapter.editMessage(chatId, messageId, text, threadId))
                 .then(() => respond("ok"))
                 .catch(e => respond(null, e.message));
             return true;
+        }
         case "download_attachment":
             adapter.downloadAttachment(args.file_id ?? "")
                 .then(path => respond(path))

package/dist/channel/tool-router.js.map

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

package/dist/channel/types.d.ts

@@ -102,7 +102,11 @@ export interface ChannelAdapter extends EventEmitter {
     sendFile(chatId: string, filePath: string, opts?: SendOpts): Promise<SentMessage>;
     /** threadId locates the message when it lives in a topic/thread (Discord forum
      * topics are their own channel and won't be found by a guild text-channel scan). */
-    editMessage(chatId: string, messageId: string, text: string, threadId?: string): Promise<void>;
+    /** #1651: "html" is the platform's parse mode, as on sendText; "markdown" is an agent's markdown (Telegram converts it
+     * escape-first to HTML). Discord always renders Markdown. */
+    editMessage(chatId: string, messageId: string, text: string, threadId?: string, opts?: {
+        format?: "html" | "markdown";
+    }): Promise<void>;
     /** Edit a message's text AND remove any inline buttons/components. Used to
      * retire a Cancel button after the agent replies or a timeout elapses.
      * threadId locates the message when it lives in a topic/thread (Discord
@@ -142,6 +146,13 @@ export interface ChannelAdapter extends EventEmitter {
      * Lottie sticker, or an animated Telegram sticker without a thumbnail.
      */
     fetchStickerPreview?(sticker: StickerInfo): Promise<StickerPreview | null>;
+    /**
+     * #1630: this bot's own avatar, downloaded here (a Telegram file URL carries the token, which must not leave the
+     * adapter). null when the bot has none set — a platform default says nothing about which bot it is.
+     */
+    fetchBotAvatar?(): Promise<StickerPreview | null>;
+    /** #1630: this bot's colour (its highest coloured role) in the server `channelId` belongs to, or null for none. */
+    botAccentColor?(channelId?: string): Promise<string | null>;
     /**
      * Send stickers, after `text` when there is any (#1226). Discord: on the same
      * message as the text's last chunk (`sticker_ids`); Telegram: the text, then
@@ -233,7 +244,8 @@ export interface SendOpts {
     };
     threadId?: string;
     replyTo?: string;
-    format?: "text" | "html";
+    /** "html": the caller's own platform HTML. "markdown": an agent's markdown (#1658 — Telegram converts it escape-first). */
+    format?: "text" | "html" | "markdown";
     chunkLimit?: number;
     /** Suppress the link/web-page preview for URLs in the message (Telegram). */
     disablePreview?: boolean;

package/dist/cli.js

@@ -1546,7 +1546,8 @@ program
             catch {
                 return false;
             } },
-            // `agend install` activates by default; the update owns stop/start, so only the file is refreshed here.
+            // `agend install` activates by default; the update owns stop/start, so only the file is refreshed here. Only
+            // an existing service is refreshed: a detached fleet's update never calls this (#1631).
             refresh: () => {
                 const result = capture(newAgend.command, [...newAgend.args, "install", "--no-activate"]);
                 if (result.status === 0)
@@ -1663,6 +1664,42 @@ program
         process.exitCode = 1;
         return;
     }
+    // ── Check if npm global needs sudo (read-only; decides the nvm path the preflight judges) ──
+    let needsSudo = false;
+    try {
+        const prefix = execSync("npm config get prefix", { encoding: "utf-8" }).trim();
+        const { accessSync, constants } = await import("node:fs");
+        try {
+            accessSync(prefix, constants.W_OK);
+        }
+        catch {
+            needsSudo = true;
+        }
+    }
+    catch { /* assume no sudo needed */ }
+    // ── #1441 B: can the target run here, on the Node it will actually run on? ──
+    // Read where the install runs (#1623 review): a direct install runs `npm` and the release's `node` from this
+    // environment, so it is decided now, before anything is touched. An nvm install runs nvm's npm and Node 22, which
+    // exist only once nvm has selected them: runUpdateInstall decides it there, before the lock and npm.
+    const preflight = targetVersion ? await import("./update-preflight.js") : null;
+    if (preflight && targetVersion && !needsSudo) {
+        const verdict = preflight.preflightUpdate({
+            run: (argv, timeoutMs) => {
+                const r = spawnSync(argv[0], argv.slice(1), { encoding: "utf-8", timeout: timeoutMs, stdio: ["ignore", "pipe", "ignore"] });
+                return { status: r.status, stdout: r.stdout ?? "" };
+            },
+            npm: "npm",
+        }, pkg, targetVersion, "the `node` on PATH");
+        if (verdict.kind === "refuse") {
+            console.error(`\n${verdict.message}\n`);
+            // A chat-started /update (Discord, Telegram, an agent) is waiting on this: the reason is its outcome.
+            setUpdateProgressStage(DATA_DIR, "failed", { error: `Not updated: ${verdict.summary}. Nothing was changed.` });
+            process.exitCode = 1;
+            return;
+        }
+        if (verdict.kind === "unknown")
+            console.log(verdict.note);
+    }
     if (targetVersion) {
         console.log(`\n  Updating AgEnD v${pkgVersion} → v${targetVersion}...\n`);
     }
@@ -1684,19 +1721,6 @@ program
         process.exit(1);
     };
     setUpdateProgressStage(DATA_DIR, "downloading");
-    // ── Check if npm global needs sudo ──
-    let needsSudo = false;
-    try {
-        const prefix = execSync("npm config get prefix", { encoding: "utf-8" }).trim();
-        const { accessSync, constants } = await import("node:fs");
-        try {
-            accessSync(prefix, constants.W_OK);
-        }
-        catch {
-            needsSudo = true;
-        }
-    }
-    catch { /* assume no sudo needed */ }
     if (needsSudo) {
         // ── nvm path: install without sudo ──
         if (!existsSync(nvmSh)) {
@@ -1728,6 +1752,9 @@ program
     process.once("exit", () => releaseLock());
     const installed = runUpdateInstall({
         pkg, targetVersion, viaNvm: needsSudo, nvmSh, rollback: true,
+        ...(preflight && targetVersion && needsSudo
+            ? { preflight: preflight.installPreflight(pkg, targetVersion, "the Node 22 nvm selected", { log: m => console.log(m), error: m => console.error(m) }) }
+            : {}),
         lock: prefix => {
             const lock = acquireInstallLock(prefix, { spec: pkg, agendHome: DATA_DIR }, {
                 pid: process.pid, processStart: admission.processStart, newToken: () => randomBytes(16).toString("hex"),
@@ -1786,7 +1813,19 @@ program
     .option("--activate", "Deprecated; service activation is now the default")
     .option("--no-activate", "Write the service file without activating it")
     .action(async (opts) => {
-    const { installService, activateService, detectPlatform, renderLaunchdPlist, launchdPlistPath } = await import("./service-installer.js");
+    const { installService, activateService, detectPlatform, renderLaunchdPlist, launchdPlistPath, getServicePath, getSystemServicePath } = await import("./service-installer.js");
+    // #1631 B: an older updater (2.2.0-beta.1 and before) refreshes a hand-started fleet's service too, through this
+    // command — which would CREATE a unit or plist, and every later update would then take a manager it may not reach
+    // as the authority. When no service exists and it is certain this is that updater's refresh, write nothing. A
+    // manual `agend install` (with or without --no-activate) creates the service as always.
+    if (opts.activate === false && getServicePath() === null && getSystemServicePath() === null) {
+        const { startedByUpdater, systemUpdaterCallerProbe } = await import("./updater-caller.js");
+        const caller = startedByUpdater(systemUpdaterCallerProbe(DATA_DIR, pkgVersion));
+        if (caller.updater) {
+            console.log("  No service to refresh: this update runs a hand-started fleet, so none was created (`agend install` creates one).");
+            return;
+        }
+    }
     const execPath = canonicalCliEntry();
     const serviceVars = {
         label: "com.agend.fleet",
@@ -2578,7 +2617,7 @@ program
     console.log("Web token rotated.");
     console.log("Every previously issued dashboard link and browser session is now rejected.");
     console.log("A running fleet picks this up immediately — no restart needed.");
-    console.log("Sign in again with `agend web` (prints a one-time code), or /dashboard in your chat channel.");
+    console.log("Sign in again with `agend web` (prints a one-time code), or /web in your chat channel.");
 });
 program
     .command("view")