@nodetool-ai/telegram 0.8.1

package/README.md

@@ -0,0 +1,49 @@
+# @nodetool-ai/telegram
+
+The Telegram bridge for NodeTool. It translates Telegram updates into
+`chat_message` commands on a running NodeTool server's `/ws` chat protocol, and
+the streamed `ProcessingMessage` frames back into Telegram messages. The agent
+loop, tools, permissions, thread persistence and cost tracking stay on the
+server — this package holds no user credentials and no conversation state.
+
+Design: [docs/telegram-bot-design.md](../../docs/telegram-bot-design.md).
+Plan: [docs/telegram-bot-implementation-plan.md](../../docs/telegram-bot-implementation-plan.md).
+
+## Status
+
+Milestone M2 is landing in waves. This package currently ships the pure core:
+
+| Module | What it owns |
+|---|---|
+| `src/config.ts` | Env + `telegram-bot.json`, zod-validated at the boundary |
+| `src/chunk.ts` | 3800-char splitter that reopens fences and inline tags it cuts |
+| `src/markdown-html.ts` | Agent markdown → Telegram HTML, plain-text fallback |
+| `src/frame-renderer.ts` | Pure fold of server frames → render ops |
+
+`startTelegramBot` / `stopTelegramBot` throw until the identity client, turn
+router and Bot API adapter land (T2.5–T2.9).
+
+## Configuration
+
+```
+TELEGRAM_BOT_TOKEN           required (from @BotFather)
+NODETOOL_API_URL             default http://127.0.0.1:7777
+NODETOOL_INTEGRATION_TOKEN   required (the bot's service token)
+TELEGRAM_WEBHOOK_URL         optional; set = webhook mode, unset = long polling
+TELEGRAM_WEBHOOK_SECRET      required in webhook mode
+```
+
+```jsonc
+// telegram-bot.json (optional)
+{
+  "allowUsers": [],       // Telegram user ids allowed to link; empty = anyone
+  "editThrottleMs": 1500,
+  "maxQueuedTurns": 3
+}
+```
+
+## Tests
+
+```bash
+npm run test --workspace=packages/telegram
+```

package/dist/.nodetool-build-stamp

@@ -0,0 +1 @@
+2026-09-28T09:19:19.487Z

package/dist/bot-api.d.ts

@@ -0,0 +1,115 @@
+/**
+ * The Bot API surface the bridge uses — eight methods over `fetch`, no SDK
+ * (design §13). Everything HTTP about Telegram lives here: the URL shape, the
+ * `{ok, result, description}` envelope, and the two failures that are routine
+ * rather than exceptional (429 with `retry_after`, and 400 for text the parse
+ * mode rejects).
+ */
+export declare const TELEGRAM_API_BASE = "https://api.telegram.org";
+/** Max upload the Bot API accepts from a bot. */
+export declare const TELEGRAM_UPLOAD_LIMIT_BYTES: number;
+export interface BotApiOptions {
+    readonly botToken: string;
+    readonly fetch: typeof fetch;
+    /** Defaults to {@link TELEGRAM_API_BASE}. */
+    readonly baseUrl?: string;
+}
+/** A Bot API call that answered `ok: false` or a non-2xx status. */
+export declare class BotApiError extends Error {
+    readonly method: string;
+    readonly status: number;
+    readonly description: string;
+    /** Seconds Telegram asked the bot to wait, when it answered 429. */
+    readonly retryAfterSeconds: number | null;
+    constructor(init: {
+        method: string;
+        status: number;
+        description: string;
+        retryAfterSeconds: number | null;
+    });
+    /** The text was rejected by the parse mode; resending unparsed will work. */
+    get isParseFailure(): boolean;
+    /** An edit whose text equals what the message already shows. */
+    get isUnmodified(): boolean;
+    /** Another `getUpdates` consumer holds the bot token. */
+    get isConflict(): boolean;
+}
+/** A Telegram message, narrowed to the fields the bridge reads. */
+export interface TelegramMessage {
+    readonly message_id: number;
+    readonly text?: string;
+    readonly caption?: string;
+    readonly date?: number;
+    readonly chat: {
+        readonly id: number;
+        readonly type: string;
+    };
+    readonly from?: {
+        readonly id: number;
+        readonly username?: string;
+        readonly first_name?: string;
+    };
+    readonly entities?: readonly {
+        readonly type: string;
+        readonly offset: number;
+        readonly length: number;
+    }[];
+    readonly photo?: readonly unknown[];
+    readonly document?: unknown;
+    readonly voice?: unknown;
+    readonly audio?: unknown;
+    readonly video?: unknown;
+}
+export interface TelegramCallbackQuery {
+    readonly id: string;
+    readonly data?: string;
+    readonly from: {
+        readonly id: number;
+    };
+    readonly message?: {
+        readonly message_id: number;
+        readonly chat: {
+            readonly id: number;
+            readonly type: string;
+        };
+    };
+}
+export interface TelegramUpdate {
+    readonly update_id: number;
+    readonly message?: TelegramMessage;
+    readonly edited_message?: TelegramMessage;
+    readonly callback_query?: TelegramCallbackQuery;
+}
+/** One command as `setMyCommands` takes it. */
+export interface BotCommandSpec {
+    readonly command: string;
+    readonly description: string;
+}
+/** Raw Bot API client. One method per call the bridge makes. */
+export declare class BotApi {
+    private readonly botToken;
+    private readonly fetchImpl;
+    private readonly baseUrl;
+    constructor(options: BotApiOptions);
+    /** Call a Bot API method with a JSON body. */
+    call<T = unknown>(method: string, payload: Record<string, unknown>): Promise<T>;
+    /** Call a Bot API method with a multipart body, for file uploads. */
+    callMultipart<T = unknown>(method: string, form: FormData): Promise<T>;
+    /**
+     * Long-poll for updates. `timeout` is the Bot API's own long-poll seconds,
+     * so the request itself blocks rather than the bridge spinning.
+     */
+    getUpdates(offset: number, timeoutSeconds: number): Promise<TelegramUpdate[]>;
+    sendMessage(payload: Record<string, unknown>): Promise<TelegramMessage>;
+    editMessageText(payload: Record<string, unknown>): Promise<unknown>;
+    sendChatAction(chatId: string, action: string): Promise<unknown>;
+    answerCallbackQuery(callbackQueryId: string, text?: string): Promise<unknown>;
+    setMyCommands(commands: readonly BotCommandSpec[]): Promise<unknown>;
+    getMe(): Promise<{
+        id: number;
+        username?: string;
+    }>;
+    private url;
+    private unwrap;
+}
+//# sourceMappingURL=bot-api.d.ts.map

package/dist/bot-api.d.ts.map

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

package/dist/bot-api.js

@@ -0,0 +1,145 @@
+/**
+ * The Bot API surface the bridge uses — eight methods over `fetch`, no SDK
+ * (design §13). Everything HTTP about Telegram lives here: the URL shape, the
+ * `{ok, result, description}` envelope, and the two failures that are routine
+ * rather than exceptional (429 with `retry_after`, and 400 for text the parse
+ * mode rejects).
+ */
+/** Base URL of the Bot API. Overridable so tests never resolve a real host. */
+import { trimTrailingSlashes } from "./strings.js";
+export const TELEGRAM_API_BASE = "https://api.telegram.org";
+/** Max upload the Bot API accepts from a bot. */
+export const TELEGRAM_UPLOAD_LIMIT_BYTES = 50 * 1024 * 1024;
+/** A Bot API call that answered `ok: false` or a non-2xx status. */
+export class BotApiError extends Error {
+    method;
+    status;
+    description;
+    /** Seconds Telegram asked the bot to wait, when it answered 429. */
+    retryAfterSeconds;
+    constructor(init) {
+        super(`Telegram ${init.method} failed (${init.status}): ${init.description}`);
+        this.name = "BotApiError";
+        this.method = init.method;
+        this.status = init.status;
+        this.description = init.description;
+        this.retryAfterSeconds = init.retryAfterSeconds;
+    }
+    /** The text was rejected by the parse mode; resending unparsed will work. */
+    get isParseFailure() {
+        return this.status === 400 && /can't parse entities/i.test(this.description);
+    }
+    /** An edit whose text equals what the message already shows. */
+    get isUnmodified() {
+        return this.status === 400 && /message is not modified/i.test(this.description);
+    }
+    /** Another `getUpdates` consumer holds the bot token. */
+    get isConflict() {
+        return this.status === 409;
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readRetryAfter(body) {
+    if (!isRecord(body)) {
+        return null;
+    }
+    const parameters = body.parameters;
+    if (!isRecord(parameters)) {
+        return null;
+    }
+    const value = parameters.retry_after;
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function readDescription(body, fallback) {
+    if (isRecord(body) && typeof body.description === "string" && body.description.length > 0) {
+        return body.description;
+    }
+    return fallback;
+}
+/** Raw Bot API client. One method per call the bridge makes. */
+export class BotApi {
+    botToken;
+    fetchImpl;
+    baseUrl;
+    constructor(options) {
+        this.botToken = options.botToken;
+        this.fetchImpl = options.fetch;
+        this.baseUrl = trimTrailingSlashes(options.baseUrl ?? TELEGRAM_API_BASE);
+    }
+    /** Call a Bot API method with a JSON body. */
+    async call(method, payload) {
+        const response = await this.fetchImpl(this.url(method), {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify(payload)
+        });
+        return this.unwrap(method, response);
+    }
+    /** Call a Bot API method with a multipart body, for file uploads. */
+    async callMultipart(method, form) {
+        const response = await this.fetchImpl(this.url(method), { method: "POST", body: form });
+        return this.unwrap(method, response);
+    }
+    /**
+     * Long-poll for updates. `timeout` is the Bot API's own long-poll seconds,
+     * so the request itself blocks rather than the bridge spinning.
+     */
+    getUpdates(offset, timeoutSeconds) {
+        return this.call("getUpdates", {
+            offset,
+            timeout: timeoutSeconds,
+            allowed_updates: ["message", "callback_query"]
+        });
+    }
+    sendMessage(payload) {
+        return this.call("sendMessage", payload);
+    }
+    editMessageText(payload) {
+        return this.call("editMessageText", payload);
+    }
+    sendChatAction(chatId, action) {
+        return this.call("sendChatAction", { chat_id: chatId, action });
+    }
+    answerCallbackQuery(callbackQueryId, text) {
+        const payload = { callback_query_id: callbackQueryId };
+        if (text !== undefined) {
+            payload.text = text;
+        }
+        return this.call("answerCallbackQuery", payload);
+    }
+    setMyCommands(commands) {
+        return this.call("setMyCommands", { commands });
+    }
+    getMe() {
+        return this.call("getMe", {});
+    }
+    url(method) {
+        return `${this.baseUrl}/bot${this.botToken}/${method}`;
+    }
+    async unwrap(method, response) {
+        const text = await response.text();
+        let body = null;
+        if (text.length > 0) {
+            try {
+                body = JSON.parse(text);
+            }
+            catch {
+                // Telegram answers JSON; anything else is a proxy in the way, and the
+                // status is then the only signal.
+                body = null;
+            }
+        }
+        if (!response.ok || !(isRecord(body) && body.ok === true)) {
+            throw new BotApiError({
+                method,
+                status: response.status,
+                description: readDescription(body, text.slice(0, 200) || response.statusText),
+                retryAfterSeconds: readRetryAfter(body)
+            });
+        }
+        return body.result;
+    }
+}
+//# sourceMappingURL=bot-api.js.map

package/dist/bot-api.js.map

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

package/dist/chunk.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Splitting long agent output into Telegram-sized messages.
+ *
+ * Telegram caps a message at 4096 characters, so the bridge splits at 3800 to
+ * leave headroom for the tags a chunk has to reopen. Two things make this more
+ * than `slice()`:
+ *
+ * - A boundary must never land inside a markup token. Cutting `&` in half
+ *   or `<b` in half produces a message Telegram rejects outright.
+ * - A boundary inside a fenced code block or an open inline tag must close the
+ *   markup and reopen it on the next chunk, or every following chunk renders
+ *   as broken HTML.
+ *
+ * The scanner therefore understands both markdown fences and the five HTML
+ * tags Telegram's HTML parse mode accepts, so the same function is correct
+ * whether it is handed raw agent markdown or the converted HTML.
+ */
+/** Default split length: 4096 minus headroom for reopened markup. */
+export declare const DEFAULT_CHUNK_MAX = 3800;
+/** Telegram's hard limit on a text message. */
+export declare const TELEGRAM_MESSAGE_LIMIT = 4096;
+/**
+ * Split `text` into chunks no longer than `max`, reopening any fence or inline
+ * tag a chunk was cut inside of. Every returned chunk is non-empty.
+ */
+export declare function chunkText(text: string, max?: number): string[];
+/**
+ * Split off the largest leading chunk that fits in `max`, returning it with
+ * the untouched remainder. The renderer uses this for rollover: it needs the
+ * rest as source text, not as a finished chunk.
+ */
+export declare function splitOnce(text: string, max?: number): {
+    head: string;
+    rest: string;
+};
+//# sourceMappingURL=chunk.d.ts.map

package/dist/chunk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.d.ts","sourceRoot":"","sources":["../src/chunk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,+CAA+C;AAC/C,eAAO,MAAM,sBAAsB,OAAO,CAAC;AA4N3C;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAA0B,GAAG,MAAM,EAAE,CA2DjF;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,MAA0B,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAgBhC"}

package/dist/chunk.js

@@ -0,0 +1,280 @@
+/**
+ * Splitting long agent output into Telegram-sized messages.
+ *
+ * Telegram caps a message at 4096 characters, so the bridge splits at 3800 to
+ * leave headroom for the tags a chunk has to reopen. Two things make this more
+ * than `slice()`:
+ *
+ * - A boundary must never land inside a markup token. Cutting `&` in half
+ *   or `<b` in half produces a message Telegram rejects outright.
+ * - A boundary inside a fenced code block or an open inline tag must close the
+ *   markup and reopen it on the next chunk, or every following chunk renders
+ *   as broken HTML.
+ *
+ * The scanner therefore understands both markdown fences and the five HTML
+ * tags Telegram's HTML parse mode accepts, so the same function is correct
+ * whether it is handed raw agent markdown or the converted HTML.
+ */
+/** Default split length: 4096 minus headroom for reopened markup. */
+export const DEFAULT_CHUNK_MAX = 3800;
+/** Telegram's hard limit on a text message. */
+export const TELEGRAM_MESSAGE_LIMIT = 4096;
+/** Tags Telegram's HTML parse mode understands. */
+const SUPPORTED_TAGS = new Set(["b", "strong", "i", "em", "u", "s", "code", "pre", "a"]);
+const EMPTY_STATE = { fence: null, tags: [] };
+const FENCE_LINE = /^ {0,3}(`{3,}|~{3,})(.*)$/;
+// No whitespace tolerated after "<" or "/": Telegram's HTML mode rejects it,
+// our converter never emits it, and the adjacent-\s* ambiguity it needed is
+// quadratic on adversarial input (CodeQL js/polynomial-redos).
+const TAG = /^<(\/?)([a-zA-Z][a-zA-Z0-9]*)(\s[^<>]*)?>/;
+const ENTITY = /^&(#[0-9]{1,7}|#[xX][0-9a-fA-F]{1,6}|[a-zA-Z][a-zA-Z0-9]{1,31});/;
+function fenceMarker(openingLine) {
+    const match = FENCE_LINE.exec(openingLine);
+    return match ? match[1] : "```";
+}
+/**
+ * Split the source into markup-atomic tokens. Fence delimiter lines are
+ * atomic; everything between them is plain text (a `<` inside a code block is
+ * content, not a tag).
+ */
+function tokenize(text) {
+    const tokens = [];
+    let textStart = 0;
+    let i = 0;
+    let fenceOpen = null;
+    const flushText = (end) => {
+        if (end > textStart) {
+            tokens.push({
+                kind: "text",
+                start: textStart,
+                end,
+                raw: text.slice(textStart, end)
+            });
+        }
+    };
+    while (i < text.length) {
+        const atLineStart = i === 0 || text[i - 1] === "\n";
+        if (atLineStart) {
+            const lineEnd = text.indexOf("\n", i);
+            const line = text.slice(i, lineEnd === -1 ? text.length : lineEnd);
+            const match = FENCE_LINE.exec(line);
+            const closes = fenceOpen !== null && match !== null && match[1][0] === fenceMarker(fenceOpen)[0];
+            if (match !== null && (fenceOpen === null || closes)) {
+                flushText(i);
+                tokens.push({
+                    kind: "fence",
+                    start: i,
+                    end: i + line.length,
+                    raw: line
+                });
+                fenceOpen = fenceOpen === null ? line : null;
+                i += line.length;
+                textStart = i;
+                continue;
+            }
+        }
+        if (fenceOpen === null && text[i] === "<") {
+            const match = TAG.exec(text.slice(i));
+            if (match !== null && SUPPORTED_TAGS.has(match[2].toLowerCase())) {
+                flushText(i);
+                tokens.push({
+                    kind: match[1] === "/" ? "tag-close" : "tag-open",
+                    start: i,
+                    end: i + match[0].length,
+                    raw: match[0],
+                    name: match[2].toLowerCase()
+                });
+                i += match[0].length;
+                textStart = i;
+                continue;
+            }
+        }
+        if (fenceOpen === null && text[i] === "&") {
+            const match = ENTITY.exec(text.slice(i));
+            if (match !== null) {
+                flushText(i);
+                tokens.push({
+                    kind: "entity",
+                    start: i,
+                    end: i + match[0].length,
+                    raw: match[0]
+                });
+                i += match[0].length;
+                textStart = i;
+                continue;
+            }
+        }
+        i += 1;
+    }
+    flushText(text.length);
+    return tokens;
+}
+function applyToken(state, token) {
+    switch (token.kind) {
+        case "fence":
+            return { fence: state.fence === null ? token.raw : null, tags: state.tags };
+        case "tag-open":
+            return { fence: state.fence, tags: [...state.tags, token.raw] };
+        case "tag-close": {
+            const tags = [...state.tags];
+            for (let i = tags.length - 1; i >= 0; i -= 1) {
+                if (tagNameOf(tags[i]) === token.name) {
+                    tags.splice(i, 1);
+                    return { fence: state.fence, tags };
+                }
+            }
+            return state;
+        }
+        default:
+            return state;
+    }
+}
+function tagNameOf(openingTag) {
+    const match = TAG.exec(openingTag);
+    return match ? match[2].toLowerCase() : "";
+}
+/** Markup to reopen at the start of a chunk that begins mid-markup. */
+function prefixFor(state) {
+    const tags = state.tags.join("");
+    return state.fence === null ? tags : `${tags}${state.fence}\n`;
+}
+/** Markup to close at the end of a chunk that ends mid-markup. */
+function suffixFor(state) {
+    const closers = [...state.tags]
+        .reverse()
+        .map((tag) => `</${tagNameOf(tag)}>`)
+        .join("");
+    return state.fence === null ? closers : `\n${fenceMarker(state.fence)}${closers}`;
+}
+/**
+ * Nudge `index` off any markup token it would cut in half, moving left to the
+ * token's start. Returns -1 when no safe index at or below `index` exists.
+ */
+function safeIndex(tokens, index) {
+    for (const token of tokens) {
+        if (index <= token.start) {
+            return index;
+        }
+        if (index < token.end) {
+            return token.kind === "text" ? index : token.start;
+        }
+    }
+    return index;
+}
+/** State of the markup after everything strictly before `index`. */
+function stateAt(tokens, from, index) {
+    let state = from;
+    for (const token of tokens) {
+        if (token.end > index) {
+            break;
+        }
+        state = applyToken(state, token);
+    }
+    return state;
+}
+/**
+ * Best split offset inside `text[0, budget]`, preferring a paragraph break,
+ * then a line break, then a word break, and finally a hard cut. Boundaries
+ * that would cut a markup token in half are moved left off it.
+ */
+function findBoundary(text, tokens, budget) {
+    const window = text.slice(0, budget);
+    const floor = Math.floor(budget * 0.3);
+    const candidates = [
+        window.lastIndexOf("\n\n") >= 0 ? window.lastIndexOf("\n\n") + 2 : -1,
+        window.lastIndexOf("\n") >= 0 ? window.lastIndexOf("\n") + 1 : -1,
+        window.lastIndexOf(" ") >= 0 ? window.lastIndexOf(" ") + 1 : -1
+    ];
+    for (const candidate of candidates) {
+        if (candidate <= floor) {
+            continue;
+        }
+        const safe = safeIndex(tokens, candidate);
+        if (safe > 0) {
+            return safe;
+        }
+    }
+    const hard = safeIndex(tokens, budget);
+    return hard > 0 ? hard : budget;
+}
+/**
+ * Split `text` into chunks no longer than `max`, reopening any fence or inline
+ * tag a chunk was cut inside of. Every returned chunk is non-empty.
+ */
+export function chunkText(text, max = DEFAULT_CHUNK_MAX) {
+    if (max <= 0) {
+        throw new Error("chunkText: max must be greater than zero");
+    }
+    if (text.length === 0) {
+        return [];
+    }
+    if (text.length <= max) {
+        const single = text.trimEnd();
+        return single.length > 0 ? [single] : [];
+    }
+    const chunks = [];
+    let remaining = text;
+    let carried = EMPTY_STATE;
+    while (remaining.length > 0) {
+        const tokens = tokenize(remaining);
+        const prefix = prefixFor(carried);
+        if (prefix.length + remaining.length <= max) {
+            const tail = (prefix + remaining).trimEnd();
+            if (tail.length > 0) {
+                chunks.push(tail);
+            }
+            break;
+        }
+        // The suffix depends on the boundary, and the boundary on the suffix.
+        // Two passes settle it: guess with no suffix, then re-cut with the real one.
+        let budget = max - prefix.length;
+        let boundary = findBoundary(remaining, tokens, budget);
+        let endState = stateAt(tokens, carried, boundary);
+        let suffix = suffixFor(endState);
+        if (prefix.length + boundary + suffix.length > max) {
+            budget = Math.max(1, max - prefix.length - suffix.length);
+            boundary = findBoundary(remaining, tokens, budget);
+            endState = stateAt(tokens, carried, boundary);
+            suffix = suffixFor(endState);
+        }
+        if (boundary <= 0) {
+            // Nothing splittable fits — emit the whole remainder rather than loop.
+            chunks.push((prefix + remaining).trimEnd());
+            break;
+        }
+        const body = remaining.slice(0, boundary).trimEnd();
+        const chunk = `${prefix}${body}${suffix}`;
+        if (chunk.length > 0) {
+            chunks.push(chunk);
+        }
+        carried = endState;
+        remaining = remaining.slice(boundary).replace(/^[ \t]*\n?/, "");
+        if (remaining.trim().length === 0) {
+            break;
+        }
+    }
+    return chunks.filter((chunk) => chunk.length > 0);
+}
+/**
+ * Split off the largest leading chunk that fits in `max`, returning it with
+ * the untouched remainder. The renderer uses this for rollover: it needs the
+ * rest as source text, not as a finished chunk.
+ */
+export function splitOnce(text, max = DEFAULT_CHUNK_MAX) {
+    if (max <= 0) {
+        throw new Error("splitOnce: max must be greater than zero");
+    }
+    if (text.length <= max) {
+        return { head: text, rest: "" };
+    }
+    const tokens = tokenize(text);
+    const boundary = findBoundary(text, tokens, max);
+    if (boundary <= 0) {
+        return { head: text.slice(0, max), rest: text.slice(max) };
+    }
+    return {
+        head: text.slice(0, boundary).trimEnd(),
+        rest: text.slice(boundary).replace(/^[ \t]*\n?/, "")
+    };
+}
+//# sourceMappingURL=chunk.js.map

package/dist/chunk.js.map

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