charness 0.0.0-stage → 3.0.0

package/dist/connectors/telegram/inbound.js

@@ -0,0 +1,278 @@
+"use strict";
+/**
+ * @description The Telegram connector's inbound half — everything that turns a
+ * raw Telegram update into the core's platform-neutral {@link InboundEvent},
+ * plus the membership vocabulary the access policy used to import from telegraf
+ * directly.
+ *
+ * Nothing here decides policy. It translates: Telegram's nine `ChatMember`
+ * statuses become one `hasElevatedRights` boolean, its six media fields become
+ * five {@link AttachmentKind}s, and its `/name@bot args` syntax becomes an
+ * {@link InboundCommand} the neutral router can dispatch.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPlatformMembers = getPlatformMembers;
+exports.checkShouldInvalidateAdminCache = checkShouldInvalidateAdminCache;
+exports.getNormalizedAttachments = getNormalizedAttachments;
+exports.getTelegramCommand = getTelegramCommand;
+exports.getTelegramReplyQuoteBlock = getTelegramReplyQuoteBlock;
+exports.getInboundEvent = getInboundEvent;
+exports.createTelegramConnectorInbound = createTelegramConnectorInbound;
+const commandRouter_1 = require("../../platform/commandRouter");
+const accessControl_1 = require("../../accessControl");
+const fileIntake_1 = require("./fileIntake");
+const replyQuote_1 = require("../../utils/replyQuote");
+/**
+ * @description The two Telegram membership statuses that grant elevated rights
+ * in a group. The core never sees these literals — that is the point of the
+ * mapping below.
+ */
+const elevatedTelegramStatuses = ['creator', 'administrator'];
+/**
+ * @description A Telegram chat id as it appears in a {@link SessionKey}'s
+ * `space`: an integer, negative for supergroups. Deliberately the same shape the
+ * key codec recognises, so a `space` minted by another platform is refused here
+ * rather than silently coerced.
+ */
+const telegramChatIdPattern = /^-?\d+$/;
+function checkHasElevatedRights(status) {
+    return elevatedTelegramStatuses.includes(status);
+}
+/** A Telegram user's best available human-readable name. */
+function getDisplayName(user) {
+    const full = [user.first_name, user.last_name].filter(Boolean).join(' ').trim();
+    return full || user.username || user.id.toString();
+}
+/**
+ * @description Reduce a `getChatAdministrators` response to the core's neutral
+ * member shape. Bots are kept but flagged, so the policy's "real person" rule
+ * stays in the policy instead of being silently pre-applied here.
+ */
+function getPlatformMembers(members) {
+    return members.map((member) => ({
+        id: member.user.id.toString(),
+        displayName: getDisplayName(member.user),
+        isBot: member.user.is_bot,
+        hasElevatedRights: checkHasElevatedRights(member.status),
+    }));
+}
+/**
+ * @description Should a `chat_member` status transition invalidate the cached
+ * admin set? Only transitions that TOUCH elevated status matter — someone was
+ * or becomes creator/administrator (promotion, demotion, an admin leaving).
+ * Joins/leaves of regular members can't change the admin set, so they must not
+ * trigger a `getChatAdministrators` refetch.
+ *
+ * Lives in the connector because the decision is expressed entirely in
+ * Telegram's status vocabulary.
+ */
+function checkShouldInvalidateAdminCache(oldStatus, newStatus) {
+    return checkHasElevatedRights(oldStatus) || checkHasElevatedRights(newStatus);
+}
+/**
+ * @description Telegram's six ingestible media kinds collapsed onto the core's
+ * five. `video_note` (a round video) and `animation` (a GIF) are Telegram UI
+ * distinctions with no bearing on how the core treats the bytes.
+ */
+const attachmentKindByTelegramKind = {
+    photo: 'photo',
+    document: 'document',
+    video: 'video',
+    video_note: 'video',
+    animation: 'video',
+    audio: 'audio',
+};
+/**
+ * @description Normalize a message's media into the core's attachment shape.
+ *
+ * Voice is handled separately from {@link getTelegramFileMeta} because the bot
+ * routes it to transcription rather than file intake — but the core still needs
+ * to see that the message CARRIED something, so it is normalized here.
+ */
+function getNormalizedAttachments(message) {
+    if ('voice' in message && message.voice) {
+        return [
+            {
+                kind: 'voice',
+                handle: message.voice.file_id,
+                uniqueId: message.voice.file_unique_id,
+                fileName: null,
+                sizeBytes: message.voice.file_size ?? null,
+                caption: 'caption' in message ? (message.caption ?? null) : null,
+            },
+        ];
+    }
+    const meta = (0, fileIntake_1.getTelegramFileMeta)(message);
+    if (!meta)
+        return [];
+    return [
+        {
+            kind: attachmentKindByTelegramKind[meta.kind],
+            handle: meta.fileId,
+            uniqueId: meta.fileUniqueId,
+            fileName: meta.fileName ?? null,
+            sizeBytes: meta.fileSize ?? null,
+            caption: meta.caption ?? null,
+        },
+    ];
+}
+/**
+ * @description Recognise Telegram's command syntax in a text message.
+ *
+ * Deliberately mirrors telegraf's own `Composer.command` matching rule so
+ * routing commands through the neutral router cannot change which messages
+ * count as commands:
+ *
+ *   - the message's FIRST entity must be a `bot_command` at offset 0;
+ *   - `/name@someone` only counts when `someone` is this bot (case-insensitive),
+ *     so a command addressed to another bot in the same group falls through;
+ *   - everything after the command token is the argument remainder.
+ *
+ * Returns `null` when the message is not a command — the caller then treats it
+ * as plain text.
+ */
+function getTelegramCommand(message, identity) {
+    const commandEntity = message.entities?.[0];
+    if (commandEntity?.type !== 'bot_command' || commandEntity.offset > 0)
+        return null;
+    const [commandPart, addressee] = message.text.slice(0, commandEntity.length).split('@');
+    if (!commandPart)
+        return null;
+    if (addressee && addressee.toLowerCase() !== identity.username?.toLowerCase())
+        return null;
+    const name = commandPart.slice(1);
+    if (!name)
+        return null;
+    return { name, ...(0, commandRouter_1.splitCommandArgs)(message.text.slice(commandEntity.length)) };
+}
+function getInboundAuthor(user) {
+    if (!user)
+        return { id: '', displayName: '' };
+    return { id: user.id.toString(), displayName: getDisplayName(user) };
+}
+/**
+ * @description The file a replied-to message carries, for the quote to name: a
+ * voice note (never saved, its transcript went to the agent) or one of the six
+ * intake kinds, with the bot's saved copy when `findSavedFile` has one.
+ */
+function getReplyQuoteAttachment(replied, findSavedFile) {
+    if ('voice' in replied && replied.voice)
+        return { kind: 'voice' };
+    const meta = (0, fileIntake_1.getTelegramFileMeta)(replied);
+    if (!meta)
+        return undefined;
+    return { kind: meta.kind, fileName: meta.fileName, savedPath: findSavedFile?.(meta) };
+}
+/**
+ * @description A message's Telegram REPLY reduced to the structural input of
+ * {@link extractReplyQuote}, or `undefined` when the message replies to nothing.
+ * Read off the message itself, so a typed text and a voice note reply the same
+ * way — the reply is a property of the message, not of its content.
+ */
+function getReplyQuoteSource(message, identity, findSavedFile) {
+    const replied = 'reply_to_message' in message ? message.reply_to_message : undefined;
+    if (!replied)
+        return undefined;
+    return {
+        manualQuoteText: 'quote' in message ? message.quote?.text : undefined,
+        replyText: 'text' in replied ? replied.text : undefined,
+        replyCaption: 'caption' in replied ? replied.caption : undefined,
+        replyAttachment: getReplyQuoteAttachment(replied, findSavedFile),
+        replyMessageId: replied.message_id,
+        topicRootId: 'message_thread_id' in message ? message.message_thread_id : undefined,
+        isServiceMessage: 'forum_topic_created' in replied,
+        fromBot: identity.userId !== undefined && replied.from?.id === identity.userId,
+    };
+}
+/**
+ * @description The replied-to message reduced to what the core renders into the
+ * agent prompt.
+ *
+ * The candidate order and the exclusions (service message, forum topic-root
+ * "post in this topic" reply, nothing quotable) are NOT restated here — they are
+ * {@link extractReplyQuote}, the same pure helper the reply-quote prompt block
+ * already uses. A second, subtly weaker copy is exactly how the highlighted
+ * partial quote (`message.quote`) would silently stop winning.
+ */
+function getInboundReplyTo(message, identity) {
+    const replied = 'reply_to_message' in message ? message.reply_to_message : undefined;
+    const quote = (0, replyQuote_1.extractReplyQuote)(getReplyQuoteSource(message, identity));
+    if (!replied || !quote)
+        return undefined;
+    return {
+        text: quote.quotedText,
+        author: 'from' in replied ? getInboundAuthor(replied.from) : null,
+        isFromAssistant: quote.fromBot,
+    };
+}
+/**
+ * @description The agent-facing reply-quote block for a message the bot forwards
+ * as a prompt — a typed text, a voice note whose transcript becomes one, or a
+ * file whose announcement does — or `undefined` when there is nothing to fold in
+ * (no reply, the topic root, a service message, nothing quotable). One reader for
+ * all of them, so a spoken reply or a file sent as a reply carries exactly the
+ * block a typed reply to the same message does. A reply TO a file names that
+ * file, with the path `findSavedFile` returns for it.
+ */
+function getTelegramReplyQuoteBlock(message, identity, findSavedFile) {
+    return (0, replyQuote_1.buildReplyQuoteBlock)((0, replyQuote_1.extractReplyQuote)(getReplyQuoteSource(message, identity, findSavedFile))) ?? undefined;
+}
+/**
+ * @description Turn one Telegram message into the core's {@link InboundEvent}.
+ *
+ * `key` is passed in rather than derived here because resolving it needs the
+ * surface configuration (owner id, served group, chat mode) that lives in the
+ * bot's routing layer, not in this translation step.
+ *
+ * `raw` overrides what lands on the event's connector-private escape hatch. It
+ * exists because the not-yet-relocated command handlers still read Telegram
+ * fields off the telegraf CONTEXT rather than off the bare message; once they
+ * move into this directory the override goes away and `raw` is the message.
+ */
+function getInboundEvent(message, key, identity, raw = message) {
+    const text = ('text' in message ? message.text : undefined) ?? '';
+    const caption = ('caption' in message ? message.caption : undefined) ?? '';
+    const command = 'text' in message ? (getTelegramCommand(message, identity) ?? undefined) : undefined;
+    return {
+        key,
+        author: getInboundAuthor('from' in message ? message.from : undefined),
+        text: text || caption,
+        attachments: getNormalizedAttachments(message),
+        replyTo: getInboundReplyTo(message, identity),
+        command,
+        raw,
+    };
+}
+function createTelegramConnectorInbound(deps) {
+    let onEvent = null;
+    return {
+        async start(handler) {
+            onEvent = handler;
+        },
+        async stop() {
+            onEvent = null;
+        },
+        async listMembersWithElevatedRights(space) {
+            // REJECT rather than resolve `[]`: an empty resolve is a SUCCESSFUL fetch
+            // to `AdminCache`, which would stamp it fresh and lock every admin out for
+            // the whole TTL with no retry and nothing logged. A rejection is the only
+            // answer that keeps the last-known set and re-tries on the failure backoff.
+            // Matched syntactically, not via `Number`, which turns `""` into a
+            // perfectly finite `0` and would hand `getChatAdministrators` a bogus id.
+            if (!telegramChatIdPattern.test(space)) {
+                throw new Error(`telegram: "${space}" is not a chat id, cannot list its members`);
+            }
+            const members = getPlatformMembers(await deps.listAdministrators(Number(space)));
+            return (0, accessControl_1.getElevatedMemberIds)(members);
+        },
+        async deliver(message, key, raw) {
+            // Dropped rather than queued when inbound is not armed: an event that
+            // arrives before `start` (or after `stop`) has no core to route to, and
+            // buffering it would replay stale work at an arbitrary later moment.
+            if (!onEvent)
+                return;
+            await onEvent(getInboundEvent(message, key, deps.getIdentity(), raw ?? message));
+        },
+    };
+}
+//# sourceMappingURL=inbound.js.map

package/dist/connectors/telegram/inbound.js.map

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

package/dist/connectors/telegram/languagePicker.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @description Pure builder for the `/language` inline picker keyboard — the
+ * endonym-button replacement for the old plain comma-separated code list. One
+ * button per LOCALE labelled with its endonym, two per row, plus a full-width
+ * `🌐 Auto` reset row. All 12 locales fit in ONE message (Telegram allows ~100
+ * buttons per inline keyboard), so there is no pagination / nav row.
+ *
+ * Kept pure (no `t()`, no bot state) so the layout — `✓` placement, endonym
+ * labels, Auto row — is unit-testable without booting Telegraf. The `🌐 Auto`
+ * label is a fixed glyph+word (recognisable across locales), not a translated
+ * string, so no per-locale dict key is needed.
+ *
+ * Wire ids (matched by the `bot.action(...)` handlers — keep in lockstep):
+ *   `lang_<code>` · `lang_auto`.
+ * All are ≤ 64 bytes (`lang_` + a 2-letter code), well inside Telegram's cap.
+ */
+import { Markup } from 'telegraf';
+import { type Locale } from '../../i18n';
+/** «Reset to auto» button — clears the chat's explicit locale override. */
+export declare const languageAutoCallback = "lang_auto";
+/**
+ * @description Build the single-page `/language` picker (all 12 locales),
+ * ordered A→Z by the language's ENGLISH NAME (the buttons themselves stay
+ * endonym-labelled). Only the DISPLAY order is sorted here — the global
+ * `localeCodes` array stays `en`-first canonical for fallback/parity.
+ *
+ * @param current the chat's explicit override locale, or `null` for auto (drives
+ *   which button carries the `✓` — a locale button when set, the `🌐 Auto` row
+ *   when `null`).
+ */
+export declare function buildLanguagePicker(current: Locale | null): Markup.Markup<import("@telegraf/types").InlineKeyboardMarkup>;
+//# sourceMappingURL=languagePicker.d.ts.map

package/dist/connectors/telegram/languagePicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"languagePicker.d.ts","sourceRoot":"","sources":["../../../src/connectors/telegram/languagePicker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAuD,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAE9F,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB,cAAc,CAAC;AAQhD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,iEAiBzD"}

package/dist/connectors/telegram/languagePicker.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.languageAutoCallback = void 0;
+exports.buildLanguagePicker = buildLanguagePicker;
+/**
+ * @description Pure builder for the `/language` inline picker keyboard — the
+ * endonym-button replacement for the old plain comma-separated code list. One
+ * button per LOCALE labelled with its endonym, two per row, plus a full-width
+ * `🌐 Auto` reset row. All 12 locales fit in ONE message (Telegram allows ~100
+ * buttons per inline keyboard), so there is no pagination / nav row.
+ *
+ * Kept pure (no `t()`, no bot state) so the layout — `✓` placement, endonym
+ * labels, Auto row — is unit-testable without booting Telegraf. The `🌐 Auto`
+ * label is a fixed glyph+word (recognisable across locales), not a translated
+ * string, so no per-locale dict key is needed.
+ *
+ * Wire ids (matched by the `bot.action(...)` handlers — keep in lockstep):
+ *   `lang_<code>` · `lang_auto`.
+ * All are ≤ 64 bytes (`lang_` + a 2-letter code), well inside Telegram's cap.
+ */
+const telegraf_1 = require("telegraf");
+const i18n_1 = require("../../i18n");
+/** «Reset to auto» button — clears the chat's explicit locale override. */
+exports.languageAutoCallback = 'lang_auto';
+function buildLocaleButton(locale, current) {
+    const endonym = (0, i18n_1.getLocaleEndonym)(locale);
+    const label = locale === current ? `✓ ${endonym}` : endonym;
+    return telegraf_1.Markup.button.callback(label, `lang_${locale}`);
+}
+/**
+ * @description Build the single-page `/language` picker (all 12 locales),
+ * ordered A→Z by the language's ENGLISH NAME (the buttons themselves stay
+ * endonym-labelled). Only the DISPLAY order is sorted here — the global
+ * `localeCodes` array stays `en`-first canonical for fallback/parity.
+ *
+ * @param current the chat's explicit override locale, or `null` for auto (drives
+ *   which button carries the `✓` — a locale button when set, the `🌐 Auto` row
+ *   when `null`).
+ */
+function buildLanguagePicker(current) {
+    const orderedCodes = [...i18n_1.localeCodes].sort((a, b) => (0, i18n_1.getLocaleEnglishName)(a).localeCompare((0, i18n_1.getLocaleEnglishName)(b)));
+    const rows = [];
+    for (let i = 0; i < orderedCodes.length; i += 2) {
+        const row = [buildLocaleButton(orderedCodes[i], current)];
+        if (orderedCodes[i + 1])
+            row.push(buildLocaleButton(orderedCodes[i + 1], current));
+        rows.push(row);
+    }
+    // Full-width 🌐 Auto row; `✓` when the chat has no explicit override.
+    rows.push([
+        telegraf_1.Markup.button.callback(current === null ? '✓ 🌐 Auto' : '🌐 Auto', exports.languageAutoCallback),
+    ]);
+    return telegraf_1.Markup.inlineKeyboard(rows);
+}
+//# sourceMappingURL=languagePicker.js.map

package/dist/connectors/telegram/languagePicker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"languagePicker.js","sourceRoot":"","sources":["../../../src/connectors/telegram/languagePicker.ts"],"names":[],"mappings":";;;AAuCA,kDAiBC;AAxDD;;;;;;;;;;;;;;;GAeG;AACH,uCAAkC;AAElC,qCAA8F;AAE9F,2EAA2E;AAC9D,QAAA,oBAAoB,GAAG,WAAW,CAAC;AAEhD,SAAS,iBAAiB,CAAC,MAAc,EAAE,OAAsB;IAC/D,MAAM,OAAO,GAAG,IAAA,uBAAgB,EAAC,MAAM,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IAC5D,OAAO,iBAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,MAAM,EAAE,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,mBAAmB,CAAC,OAAsB;IACxD,MAAM,YAAY,GAAG,CAAC,GAAG,kBAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAClD,IAAA,2BAAoB,EAAC,CAAC,CAAC,CAAC,aAAa,CAAC,IAAA,2BAAoB,EAAC,CAAC,CAAC,CAAC,CAC/D,CAAC;IACF,MAAM,IAAI,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,GAAG,GAAG,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1D,IAAI,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QACnF,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC;IAED,sEAAsE;IACtE,IAAI,CAAC,IAAI,CAAC;QACR,iBAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,EAAE,4BAAoB,CAAC;KACzF,CAAC,CAAC;IAEH,OAAO,iBAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC"}

package/dist/connectors/telegram/messageSplit.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @description Split agent output into Telegram-sized chunks, keeping
+ * ```` ``` ```` code fences valid across chunk boundaries.
+ *
+ * Pure + dependency-free so it stays unit-testable without booting Telegraf
+ * (importing `bot.ts` constructs a `Telegraf` instance at module load, which
+ * needs a real token). Both the durable-output and status paths in `bot.ts`
+ * route through {@link splitMessage}.
+ */
+/** Telegram caps a message at 4096 chars; we leave headroom for markdown noise. */
+export declare const MAX_MESSAGE_LEN = 4000;
+/** Telegram's hard per-message limit. A rendered chunk that crosses this is
+ *  rejected with a 400 "message is too long". */
+export declare const TELEGRAM_HARD_LIMIT = 4096;
+/**
+ * Margin reserved below {@link TELEGRAM_HARD_LIMIT} when splitting by rendered
+ * length. The render-aware check runs on a candidate chunk BEFORE
+ * {@link rebalanceFences}, which can still GROW the rendered output: closing an
+ * open fence at the cut and reopening one at the next chunk's start wraps bare
+ * text into an extra `<pre><code>…</code></pre>`. That wrapper adds
+ * `<pre><code>` (11) + `</code></pre>` (13) = 24 rendered chars; we round up to
+ * leave slack so a post-rebalance chunk can never cross the hard limit.
+ */
+export declare const RENDERED_REBALANCE_MARGIN = 32;
+/** Effective rendered cap a candidate chunk must fit under so it still fits the
+ *  hard limit after {@link rebalanceFences} may add fence wrappers. */
+export declare const RENDERED_CHUNK_CAP: number;
+/**
+ * Smallest source slice the render-aware back-off may shrink a chunk to. Guards
+ * against an infinite loop / empty chunk when a single un-splittable token
+ * renders huge (e.g. one very long word full of escapable `< & >`): once the
+ * candidate is this short we stop backing off and emit it even if it still
+ * measures over the cap, so the split always makes forward progress.
+ */
+export declare const MIN_RENDER_AWARE_CHUNK_LEN = 1;
+/**
+ * @description Re-balance ```` ``` ```` fences across chunk boundaries. A tool
+ * diff / output (fenced by the Claude adapter) can exceed the chunk size; cut
+ * mid-fence, the first chunk has an unclosed fence and the next an orphan
+ * closer, so `renderAgentHtml` renders literal ```` ``` ```` instead of a
+ * `<pre>`. Closing an open fence at the cut and reopening it at the start of
+ * the next chunk keeps every chunk independently valid. No-op for text with
+ * balanced (or no) fences. Counts only line-start fences (block fences).
+ */
+export declare function rebalanceFences(chunks: string[]): string[];
+/**
+ * @description Split agent text into Telegram-sized chunks.
+ *
+ * Without `measureRendered` the cut is purely SOURCE-length based (newline
+ * preferred) — exactly the legacy behaviour. With `measureRendered` the split
+ * is RENDER-AWARE: `renderAgentHtml` inflates the source (HTML-escaping
+ * `& < >`, adding `<b>`/`<pre>` tags), so a 4000-char source chunk can render
+ * past Telegram's 4096 cap. The caller injects the measure (keeping this module
+ * dependency-free); each candidate chunk is shrunk until its rendered length
+ * fits {@link RENDERED_CHUNK_CAP}, which leaves margin for the fence wrappers
+ * {@link rebalanceFences} may still add afterwards.
+ *
+ * @param measureRendered Maps a candidate source chunk to its rendered length.
+ *   Omitted → source-length splitting, byte-identical to the legacy output.
+ */
+export declare function splitMessage(text: string, maxLen?: number, measureRendered?: (chunk: string) => number): string[];
+//# sourceMappingURL=messageSplit.d.ts.map

package/dist/connectors/telegram/messageSplit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageSplit.d.ts","sourceRoot":"","sources":["../../../src/connectors/telegram/messageSplit.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,mFAAmF;AACnF,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC;iDACiD;AACjD,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C;uEACuE;AACvE,eAAO,MAAM,kBAAkB,QAAkD,CAAC;AAElF;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAU1D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,MAAwB,EAChC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAC1C,MAAM,EAAE,CAmBV"}

package/dist/connectors/telegram/messageSplit.js

@@ -0,0 +1,119 @@
+"use strict";
+/**
+ * @description Split agent output into Telegram-sized chunks, keeping
+ * ```` ``` ```` code fences valid across chunk boundaries.
+ *
+ * Pure + dependency-free so it stays unit-testable without booting Telegraf
+ * (importing `bot.ts` constructs a `Telegraf` instance at module load, which
+ * needs a real token). Both the durable-output and status paths in `bot.ts`
+ * route through {@link splitMessage}.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MIN_RENDER_AWARE_CHUNK_LEN = exports.RENDERED_CHUNK_CAP = exports.RENDERED_REBALANCE_MARGIN = exports.TELEGRAM_HARD_LIMIT = exports.MAX_MESSAGE_LEN = void 0;
+exports.rebalanceFences = rebalanceFences;
+exports.splitMessage = splitMessage;
+/** Telegram caps a message at 4096 chars; we leave headroom for markdown noise. */
+exports.MAX_MESSAGE_LEN = 4000;
+/** Telegram's hard per-message limit. A rendered chunk that crosses this is
+ *  rejected with a 400 "message is too long". */
+exports.TELEGRAM_HARD_LIMIT = 4096;
+/**
+ * Margin reserved below {@link TELEGRAM_HARD_LIMIT} when splitting by rendered
+ * length. The render-aware check runs on a candidate chunk BEFORE
+ * {@link rebalanceFences}, which can still GROW the rendered output: closing an
+ * open fence at the cut and reopening one at the next chunk's start wraps bare
+ * text into an extra `<pre><code>…</code></pre>`. That wrapper adds
+ * `<pre><code>` (11) + `</code></pre>` (13) = 24 rendered chars; we round up to
+ * leave slack so a post-rebalance chunk can never cross the hard limit.
+ */
+exports.RENDERED_REBALANCE_MARGIN = 32;
+/** Effective rendered cap a candidate chunk must fit under so it still fits the
+ *  hard limit after {@link rebalanceFences} may add fence wrappers. */
+exports.RENDERED_CHUNK_CAP = exports.TELEGRAM_HARD_LIMIT - exports.RENDERED_REBALANCE_MARGIN;
+/**
+ * Smallest source slice the render-aware back-off may shrink a chunk to. Guards
+ * against an infinite loop / empty chunk when a single un-splittable token
+ * renders huge (e.g. one very long word full of escapable `< & >`): once the
+ * candidate is this short we stop backing off and emit it even if it still
+ * measures over the cap, so the split always makes forward progress.
+ */
+exports.MIN_RENDER_AWARE_CHUNK_LEN = 1;
+/**
+ * @description Re-balance ```` ``` ```` fences across chunk boundaries. A tool
+ * diff / output (fenced by the Claude adapter) can exceed the chunk size; cut
+ * mid-fence, the first chunk has an unclosed fence and the next an orphan
+ * closer, so `renderAgentHtml` renders literal ```` ``` ```` instead of a
+ * `<pre>`. Closing an open fence at the cut and reopening it at the start of
+ * the next chunk keeps every chunk independently valid. No-op for text with
+ * balanced (or no) fences. Counts only line-start fences (block fences).
+ */
+function rebalanceFences(chunks) {
+    let carryOpen = false;
+    return chunks.map(chunk => {
+        let text = carryOpen ? '```\n' + chunk : chunk;
+        const fenceCount = (text.match(/^\s*```/gm) ?? []).length;
+        const endsOpen = fenceCount % 2 === 1;
+        if (endsOpen)
+            text = text + '\n```';
+        carryOpen = endsOpen;
+        return text;
+    });
+}
+/**
+ * @description Split agent text into Telegram-sized chunks.
+ *
+ * Without `measureRendered` the cut is purely SOURCE-length based (newline
+ * preferred) — exactly the legacy behaviour. With `measureRendered` the split
+ * is RENDER-AWARE: `renderAgentHtml` inflates the source (HTML-escaping
+ * `& < >`, adding `<b>`/`<pre>` tags), so a 4000-char source chunk can render
+ * past Telegram's 4096 cap. The caller injects the measure (keeping this module
+ * dependency-free); each candidate chunk is shrunk until its rendered length
+ * fits {@link RENDERED_CHUNK_CAP}, which leaves margin for the fence wrappers
+ * {@link rebalanceFences} may still add afterwards.
+ *
+ * @param measureRendered Maps a candidate source chunk to its rendered length.
+ *   Omitted → source-length splitting, byte-identical to the legacy output.
+ */
+function splitMessage(text, maxLen = exports.MAX_MESSAGE_LEN, measureRendered) {
+    if (text.length <= maxLen && (!measureRendered || measureRendered(text) <= exports.RENDERED_CHUNK_CAP)) {
+        return [text];
+    }
+    const parts = [];
+    let remaining = text;
+    while (remaining.length > 0) {
+        if (remaining.length <= maxLen &&
+            (!measureRendered || measureRendered(remaining) <= exports.RENDERED_CHUNK_CAP)) {
+            parts.push(remaining);
+            break;
+        }
+        const cutAt = getChunkCutAt(remaining, maxLen, measureRendered);
+        parts.push(remaining.slice(0, cutAt));
+        remaining = remaining.slice(cutAt).replace(/^\n/, '');
+    }
+    return rebalanceFences(parts);
+}
+/**
+ * @description Choose the source index to cut `remaining` at for the next
+ * chunk. Starts from the newline-preferred SOURCE boundary (legacy behaviour),
+ * then — only when a render measure is supplied — retreats while the rendered
+ * candidate exceeds {@link RENDERED_CHUNK_CAP}: first to the previous newline,
+ * then shrinking progressively. A floor of {@link MIN_RENDER_AWARE_CHUNK_LEN}
+ * guarantees forward progress (never an empty chunk, never an infinite loop)
+ * even for a single un-splittable escapable-heavy token.
+ */
+function getChunkCutAt(remaining, maxLen, measureRendered) {
+    let cutAt = maxLen;
+    const lastNewline = remaining.lastIndexOf('\n', maxLen);
+    if (lastNewline > maxLen * 0.5)
+        cutAt = lastNewline;
+    if (!measureRendered)
+        return cutAt;
+    while (cutAt > exports.MIN_RENDER_AWARE_CHUNK_LEN && measureRendered(remaining.slice(0, cutAt)) > exports.RENDERED_CHUNK_CAP) {
+        // Prefer retreating to the previous newline (keeps lines intact); if there
+        // is none within the candidate, halve the slice to shrink it geometrically.
+        const previousNewline = remaining.lastIndexOf('\n', cutAt - 1);
+        cutAt = previousNewline > exports.MIN_RENDER_AWARE_CHUNK_LEN ? previousNewline : Math.floor(cutAt / 2);
+    }
+    return Math.max(cutAt, exports.MIN_RENDER_AWARE_CHUNK_LEN);
+}
+//# sourceMappingURL=messageSplit.js.map

package/dist/connectors/telegram/messageSplit.js.map

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

package/dist/connectors/telegram/outbound.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @description The Telegram connector's outbound half — everything that turns
+ * the core's semantic {@link OutboundContent} into Telegram messages.
+ *
+ * It owns the surface's UI idioms (inline keyboards, pins, the typing action)
+ * and delegates the streaming mechanics to the existing `OutputTransport`,
+ * which is a TELEGRAM CHAT-MODE seam (group edit-in-place vs DM draft cursor),
+ * NOT a platform seam. That distinction is why the transport is composed here
+ * as an internal detail instead of being promoted to the platform boundary.
+ */
+import type { InlineKeyboardMarkup } from 'telegraf/typings/core/types/typegram';
+import type { SessionKey } from '../../sessionKey';
+import type { OutputTransport } from '../../types';
+import type { SendFilesToThread } from '../../utils/fileSendService';
+import type { ConnectorCapabilities, ConnectorOutbound, OutboundOption } from '../../platform/outbound';
+/**
+ * @description Telegram's self-declared surface. Every flag is `true` because
+ * Telegram is the surface the core was originally written against — which is
+ * exactly why the degraded paths need the S5 test double to be exercised at
+ * all.
+ *
+ * `maxMessageChars` is the splitter's working cap (4000), deliberately under
+ * Telegram's hard 4096 so an HTML render that inflates the source still fits.
+ */
+export declare const telegramCapabilities: ConnectorCapabilities;
+/**
+ * @description Render the core's options as a one-button-per-row inline
+ * keyboard. Labels are elided to Telegram's practical button width — the full
+ * text is still readable in the message body, which always enumerates the
+ * options.
+ */
+export declare function buildOptionsKeyboard(options: OutboundOption[]): InlineKeyboardMarkup | undefined;
+/**
+ * @description Bot primitives the Telegram outbound routes through, injected as
+ * closures so this module never imports `bot.ts` (a cycle) and stays testable
+ * without a live Telegraf instance.
+ */
+export interface TelegramOutboundDeps {
+    /**
+     * The boot-selected chat-mode transport. Read lazily (not captured) because
+     * it is registered later in the boot sequence than this connector.
+     */
+    getOutputTransport: () => OutputTransport;
+    /**
+     * Send `text` as its OWN message — HTML-rendered with a plain-text retry, with
+     * an optional inline keyboard. Resolves the message id, or `null` when both
+     * attempts failed.
+     */
+    sendStandaloneMessage: (key: SessionKey, text: string, replyMarkup?: InlineKeyboardMarkup) => Promise<number | null>;
+    /** Pin a message so a muted topic still fires a notification. */
+    pinMessage: (key: SessionKey, messageId: number) => Promise<void>;
+    /** Start (`true`) or stop (`false`) the repeating `sendChatAction('typing')` loop. */
+    setTypingLoader: (key: SessionKey, isActive: boolean) => void;
+    /** One `sendChatAction('typing')`, no loop — a booting session that has nothing to stream. */
+    sendTypingPing: (key: SessionKey) => void;
+    /** The reusable file-send service, already composed with the Telegram gateway. */
+    sendFiles: SendFilesToThread;
+    /** Serialize a key for the string-keyed file-send service. */
+    encodeKey: (key: SessionKey) => string;
+}
+export declare function createTelegramConnectorOutbound(deps: TelegramOutboundDeps): ConnectorOutbound;
+//# sourceMappingURL=outbound.d.ts.map

package/dist/connectors/telegram/outbound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound.d.ts","sourceRoot":"","sources":["../../../src/connectors/telegram/outbound.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,OAAO,KAAK,EAEV,qBAAqB,EACrB,iBAAiB,EAKjB,cAAc,EACf,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,EAAE,qBASlC,CAAC;AAKF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,oBAAoB,GAAG,SAAS,CAahG;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,kBAAkB,EAAE,MAAM,eAAe,CAAC;IAC1C;;;;OAIG;IACH,qBAAqB,EAAE,CACrB,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,oBAAoB,KAC/B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5B,iEAAiE;IACjE,UAAU,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,sFAAsF;IACtF,eAAe,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9D,8FAA8F;IAC9F,cAAc,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;IAC1C,kFAAkF;IAClF,SAAS,EAAE,iBAAiB,CAAC;IAC7B,8DAA8D;IAC9D,SAAS,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,MAAM,CAAC;CACxC;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,oBAAoB,GAAG,iBAAiB,CA8D7F"}