blun-king-cli 9.1.587 → 9.1.588

package/telegram-plugin/bin/telegram-launcher-status-queue.cjs

@@ -1,122 +0,0 @@
-'use strict';
-
-const fs = require('node:fs');
-const path = require('node:path');
-
-const QUEUE_FILE = 'launcher-status-queue.jsonl';
-const CHECKPOINT_FILE = 'launcher-status.checkpoint.json';
-const OUTBOX_FILE = 'outbox.jsonl';
-
-function readCheckpoint(filePath, fsImpl = fs) {
-  try {
-    const parsed = JSON.parse(fsImpl.readFileSync(filePath, 'utf8'));
-    return Number.isSafeInteger(parsed.offset) && parsed.offset >= 0 ? parsed.offset : 0;
-  } catch { return 0; }
-}
-
-function writeCheckpoint(filePath, offset, fsImpl = fs) {
-  const temporary = `${filePath}.${process.pid}.tmp`;
-  fsImpl.writeFileSync(temporary, `${JSON.stringify({
-    schema: 'blun.launcher-status-checkpoint/v1', offset,
-  })}\n`, { encoding: 'utf8', mode: 0o600 });
-  fsImpl.renameSync(temporary, filePath);
-}
-
-function resolveStatusChatId(access, configuredChatId) {
-  const groups = Object.keys(access?.groups || {});
-  if (configuredChatId !== undefined && configuredChatId !== null && String(configuredChatId).trim()) {
-    const requested = String(configuredChatId).trim();
-    return groups.includes(requested) ? requested : null;
-  }
-  return groups[0] || null;
-}
-
-function hasReceipt(outboxPath, eventId, fsImpl = fs) {
-  try {
-    const content = fsImpl.readFileSync(outboxPath, 'utf8');
-    return content.split(/\r?\n/u).some((line) => {
-      if (!line.trim()) return false;
-      try {
-        const entry = JSON.parse(line);
-        return entry.kind === 'launcher-status' && entry.event_id === eventId;
-      } catch { return false; }
-    });
-  } catch { return false; }
-}
-
-async function drainLauncherStatusQueue(options) {
-  const fsImpl = options.fsImpl || fs;
-  const stateDir = path.resolve(options.stateDir);
-  const queuePath = path.join(stateDir, QUEUE_FILE);
-  const checkpointPath = path.join(stateDir, CHECKPOINT_FILE);
-  const outboxPath = path.join(stateDir, OUTBOX_FILE);
-  fsImpl.mkdirSync(stateDir, { recursive: true, mode: 0o700 });
-  let buffer;
-  try { buffer = fsImpl.readFileSync(queuePath); } catch (error) {
-    if (error?.code === 'ENOENT') return { delivered: 0, pending: 0 };
-    throw error;
-  }
-  let offset = Math.min(readCheckpoint(checkpointPath, fsImpl), buffer.length);
-  let delivered = 0;
-  while (offset < buffer.length) {
-    const newline = buffer.indexOf(0x0a, offset);
-    if (newline < 0) break;
-    const nextOffset = newline + 1;
-    const line = buffer.subarray(offset, newline).toString('utf8').trim();
-    if (!line) {
-      offset = nextOffset;
-      writeCheckpoint(checkpointPath, offset, fsImpl);
-      continue;
-    }
-    let event;
-    try { event = JSON.parse(line); } catch {
-      offset = nextOffset;
-      writeCheckpoint(checkpointPath, offset, fsImpl);
-      continue;
-    }
-    if (event?.schema !== 'blun.launcher-status/v1' || typeof event.id !== 'string'
-      || typeof event.text !== 'string') {
-      offset = nextOffset;
-      writeCheckpoint(checkpointPath, offset, fsImpl);
-      continue;
-    }
-    if (hasReceipt(outboxPath, event.id, fsImpl)) {
-      offset = nextOffset;
-      writeCheckpoint(checkpointPath, offset, fsImpl);
-      continue;
-    }
-    const chatId = resolveStatusChatId(options.readAccess(), options.configuredChatId);
-    if (chatId === null) break;
-    const sent = await options.sendMessage(chatId, event.text);
-    fsImpl.appendFileSync(outboxPath, `${JSON.stringify({
-      ts: new Date().toISOString(), direction: 'out', kind: 'launcher-status',
-      chat_id: chatId, message_id: sent?.message_id, event_id: event.id, text: event.text,
-    })}\n`, { encoding: 'utf8', mode: 0o600 });
-    delivered += 1;
-    offset = nextOffset;
-    writeCheckpoint(checkpointPath, offset, fsImpl);
-  }
-  const pending = buffer.subarray(offset).toString('utf8').split(/\r?\n/u).filter((line) => line.trim()).length;
-  return { delivered, pending };
-}
-
-function startLauncherStatusWatcher(options) {
-  let busy = false;
-  let disposed = false;
-  const run = async () => {
-    if (busy || disposed) return;
-    busy = true;
-    try { await drainLauncherStatusQueue(options); } catch (error) { options.onError?.(error); }
-    finally { busy = false; }
-  };
-  const timer = setInterval(run, options.intervalMs || 1000);
-  timer.unref?.();
-  void run();
-  return { dispose() { disposed = true; clearInterval(timer); } };
-}
-
-module.exports = {
-  drainLauncherStatusQueue,
-  resolveStatusChatId,
-  startLauncherStatusWatcher,
-};

package/telegram-plugin/bin/telegram-private-conversation-policy.cjs

@@ -1,186 +0,0 @@
-'use strict';
-
-const { closeSync, openSync, readSync, statSync } = require('node:fs');
-
-const PRIVATE_CHAT_ID = /^[1-9]\d*$/u;
-const WORK_PERMISSION_QUESTION = /^(?:kann|darf|soll) ich\b.{0,100}\b(?:arbeit(?:en)?|weiterarbeiten|weitermachen|fortfahren|weiterbauen|umbau|bau)\b/u;
-const TRAILING_WORK_PERMISSION_QUESTION = /(?:^|\r?\n\s*\r?\n)(?:kann|darf|soll)\s+ich\b[^\r\n]{0,160}\b(?:arbeit(?:en)?|weiterarbeiten|weitermachen|fortfahren|weiterbauen|umbau|bau)\b[^\r\n]*$/iu;
-const INTERNAL_CONTROL_MARKER = /\b(?:cron|loop|checkpoint|handoff|resume|session|sha|tool|werkzeug|hook|queue|lane|inbound|outbound|arbeitsstand|arbeitsauftrag|bau freigabe|freigabe dieser lane|turn|zug|status|private nachricht|telegram nachricht|reply|verlauf|basis|qa gate|wartezustand|f\d+|m\d+|w\d+)\b/gu;
-const NO_USER_VALUE = /\b(?:keine neue aktion|keine neue information|keine neue nachricht|kein neuer auftrag|kein neuer zweck|kein neuer inbound bedarf|kein offener handlungsbedarf|nichts neues zu melden|nichts zu melden|bleibt pausiert|warte auf (?:dein|sein|ihr|papas) (?:zeichen|go|freigabe|antwort)|ich warte|ich sende nichts|wiederholen wäre spam|keine weitere nachricht|bereits geantwortet|bereits gesendet|kein werkzeugaufruf nötig|stand unverändert|zug läuft seit|kein bau ohne|qa gate steht noch aus|wartezustand)\b/u;
-const EMPTY_COMPLETION_STATUS = /^(?:(?:status|arbeitsstand|checkpoint)\s+)?(?:fertig\s+)?nichts weiteres(?:\s+(?:offen|zu melden|zu tun))?$/u;
-
-const MEDIA_PROGRESS_MARKER = /\b(?:bildgenerierung|bildjob|generateimage|getmedia|media job|medienjob)\b/u;
-const MEDIA_PENDING_STATE = /\b(?:auftrag wurde angenommen|job wurde angenommen|job angenommen|aufruf wurde abgesetzt|angestossen|angestoßen|processing|verarbeitung)\b/u;
-const MEDIA_NO_RESULT = /\b(?:kein neues bild|noch kein bild|kein bild liefern|nichts angekommen|nichts neues gelandet|nicht verfuegbar|nicht verfügbar|getmedia fehlt)\b/u;
-
-const DUPLICATE_LOG_TAIL_BYTES = 512 * 1024;
-const DUPLICATE_MAX_AGE_MS = 24 * 60 * 60 * 1000;
-const NEAR_DUPLICATE_MIN_CHARS = 120;
-const NEAR_DUPLICATE_SIMILARITY = 0.88;
-const SUCCESSFUL_REPLY_KINDS = new Set(['reply', 'reply-fallback']);
-
-function normalize(text) {
-  return String(text ?? '')
-    .normalize('NFKC')
-    .toLocaleLowerCase('de-DE')
-    .replace(/[^\p{L}\p{N}\s]/gu, ' ')
-    .replace(/\s+/gu, ' ')
-    .trim();
-}
-
-function readJsonlTail(file, maxBytes = DUPLICATE_LOG_TAIL_BYTES) {
-  try {
-    const size = statSync(file).size;
-    if (size <= 0) return [];
-    const start = Math.max(0, size - maxBytes);
-    const length = size - start;
-    const buffer = Buffer.allocUnsafe(length);
-    const descriptor = openSync(file, 'r');
-    let bytesRead = 0;
-    try {
-      while (bytesRead < length) {
-        const count = readSync(descriptor, buffer, bytesRead, length - bytesRead, start + bytesRead);
-        if (count === 0) break;
-        bytesRead += count;
-      }
-    } finally {
-      closeSync(descriptor);
-    }
-    let raw = buffer.subarray(0, bytesRead).toString('utf8');
-    if (start > 0) {
-      const firstNewline = raw.indexOf('\n');
-      raw = firstNewline < 0 ? '' : raw.slice(firstNewline + 1);
-    }
-    return raw.split(/\r?\n/u).flatMap((line) => {
-      if (line.trim().length === 0) return [];
-      try {
-        const entry = JSON.parse(line);
-        return typeof entry === 'object' && entry !== null ? [entry] : [];
-      } catch {
-        return [];
-      }
-    });
-  } catch {
-    return [];
-  }
-}
-
-function normalizedTokens(text) {
-  return normalize(text).match(/[\p{L}\p{N}_]+/gu) ?? [];
-}
-
-function tokenBigrams(tokens) {
-  const bigrams = [];
-  for (let index = 0; index + 1 < tokens.length; index += 1) {
-    bigrams.push(`${tokens[index]}\u0000${tokens[index + 1]}`);
-  }
-  return bigrams;
-}
-
-function diceSimilarity(leftItems, rightItems) {
-  const left = new Set(leftItems);
-  const right = new Set(rightItems);
-  if (left.size === 0 || right.size === 0) return 0;
-  let intersection = 0;
-  for (const item of left) {
-    if (right.has(item)) intersection += 1;
-  }
-  return (2 * intersection) / (left.size + right.size);
-}
-
-function outboundReplySimilarity(left, right) {
-  const leftNormalized = normalize(left);
-  const rightNormalized = normalize(right);
-  if (leftNormalized.length === 0 || rightNormalized.length === 0) return 0;
-  if (leftNormalized === rightNormalized) return 1;
-  if (leftNormalized.length < NEAR_DUPLICATE_MIN_CHARS || rightNormalized.length < NEAR_DUPLICATE_MIN_CHARS) return 0;
-  const leftTokens = normalizedTokens(leftNormalized);
-  const rightTokens = normalizedTokens(rightNormalized);
-  if (leftTokens.length < 12 || rightTokens.length < 12) return 0;
-  const tokenScore = diceSimilarity(leftTokens, rightTokens);
-  const bigramScore = diceSimilarity(tokenBigrams(leftTokens), tokenBigrams(rightTokens));
-  return (tokenScore + bigramScore) / 2;
-}
-
-function entryTime(entry) {
-  const raw = entry?.ts ?? entry?.meta?.timestamp;
-  const value = Date.parse(String(raw ?? ''));
-  return Number.isFinite(value) ? value : Number.NEGATIVE_INFINITY;
-}
-
-function entryChatId(entry) {
-  return String(entry?.chat_id ?? entry?.meta?.chat_id ?? '');
-}
-
-function findDuplicateReplyWithoutNewInbound({
-  chatId,
-  inboundFile,
-  now = Date.now(),
-  outboxFile,
-  text,
-}) {
-  const wantedChat = String(chatId ?? '').trim();
-  const candidate = String(text ?? '').trim();
-  if (wantedChat.length === 0 || candidate.length === 0) return null;
-
-  const outbound = readJsonlTail(outboxFile).filter((entry) => (
-    SUCCESSFUL_REPLY_KINDS.has(entry.kind)
-    && entryChatId(entry) === wantedChat
-    && typeof entry.text === 'string'
-  ));
-  if (outbound.length === 0) return null;
-  const latestOutboundAt = Math.max(...outbound.map(entryTime));
-  if (!Number.isFinite(latestOutboundAt)) return null;
-
-  const inboundTimes = readJsonlTail(inboundFile)
-    .filter((entry) => entryChatId(entry) === wantedChat)
-    .map(entryTime)
-    .filter(Number.isFinite);
-  if (inboundTimes.length === 0) return null;
-  if (Math.max(...inboundTimes) > latestOutboundAt) return null;
-
-  const cutoff = Number(now) - DUPLICATE_MAX_AGE_MS;
-  for (let index = outbound.length - 1; index >= 0; index -= 1) {
-    const previous = outbound[index];
-    const previousAt = entryTime(previous);
-    if (previousAt < cutoff || previousAt > Number(now)) continue;
-    const similarity = outboundReplySimilarity(previous.text, candidate);
-    if (similarity < NEAR_DUPLICATE_SIMILARITY) continue;
-    return {
-      kind: previous.kind,
-      similarity,
-      ts: previous.ts,
-    };
-  }
-  return null;
-}
-
-function sanitizePrivateConversationReply(chatId, text) {
-  const value = String(text ?? '');
-  if (!PRIVATE_CHAT_ID.test(String(chatId ?? '').trim())) return value;
-  return value.replace(TRAILING_WORK_PERMISSION_QUESTION, '').trim();
-}
-
-function isPrivateInternalStatusReply(chatId, text) {
-  if (!PRIVATE_CHAT_ID.test(String(chatId ?? '').trim())) return false;
-  const sanitized = sanitizePrivateConversationReply(chatId, text);
-  const value = normalize(sanitized.length === 0 ? text : sanitized);
-  if (value.length === 0) return false;
-  if (sanitized.length === 0 && WORK_PERMISSION_QUESTION.test(value)) return true;
-  if (MEDIA_PROGRESS_MARKER.test(value) && MEDIA_PENDING_STATE.test(value) && MEDIA_NO_RESULT.test(value)) return true;
-
-  const internalMarkers = value.match(INTERNAL_CONTROL_MARKER) ?? [];
-  return internalMarkers.length > 0 && (NO_USER_VALUE.test(value) || EMPTY_COMPLETION_STATUS.test(value));
-}
-
-module.exports = {
-  readJsonlTail,
-  DUPLICATE_LOG_TAIL_BYTES,
-  DUPLICATE_MAX_AGE_MS,
-  NEAR_DUPLICATE_MIN_CHARS,
-  NEAR_DUPLICATE_SIMILARITY,
-  findDuplicateReplyWithoutNewInbound,
-  isPrivateInternalStatusReply,
-  outboundReplySimilarity,
-  sanitizePrivateConversationReply,
-};

package/telegram-plugin/bin/telegram-remote-status-policy.cjs

@@ -1,121 +0,0 @@
-'use strict';
-
-const STABLE_VERSION_RE = /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)$/u;
-
-function trustedVersion(value) {
-  const version = typeof value === 'string' ? value.trim() : '';
-  return STABLE_VERSION_RE.test(version) ? version : undefined;
-}
-
-function resolveTelegramRemoteVersion(input = {}) {
-  return trustedVersion(input.activeRuntimeVersion)
-    || trustedVersion(input.bridgePackageVersion)
-    || 'unbekannt';
-}
-
-function resolveVersionDisplay(input = {}) {
-  const loaded = trustedVersion(input.consoleStatus?.loadedVersion)
-    || trustedVersion(input.version)
-    || 'unbekannt';
-  const installed = trustedVersion(input.installedVersion);
-  return installed !== undefined && installed !== loaded
-    ? `${loaded} -> ${installed}`
-    : loaded;
-}
-
-function formatDuration(seconds) {
-  const minutes = Math.max(0, Math.floor(Number(seconds) / 60));
-  if (minutes < 60) return `${minutes} min`;
-  const hours = Math.floor(minutes / 60);
-  return `${hours} h ${minutes % 60} min`;
-}
-
-function formatBytes(bytes) {
-  const value = Math.max(0, Number(bytes) || 0);
-  if (value < 1024) return `${Math.round(value)} B`;
-  if (value < 1024 * 1024) return `${(value / 1024).toFixed(1).replace('.', ',')} KB`;
-  return `${(value / (1024 * 1024)).toFixed(1).replace('.', ',')} MB`;
-}
-
-function formatAge(value, capturedAt) {
-  const then = Date.parse(value);
-  const now = Date.parse(capturedAt);
-  if (!Number.isFinite(then) || !Number.isFinite(now) || then > now) return undefined;
-  const seconds = Math.floor((now - then) / 1000);
-  return seconds < 60 ? `vor ${seconds} s` : `vor ${formatDuration(seconds)}`;
-}
-
-function resolveTelegramQueueSnapshot(input = {}) {
-  const totalBytes = Number.isSafeInteger(input.queueBytes) && input.queueBytes >= 0
-    ? input.queueBytes
-    : 0;
-  const checkpoint = input.checkpoint;
-  const checkpointValid = checkpoint?.version === 1
-    && typeof input.queueFileId === 'string'
-    && input.queueFileId.length > 0
-    && checkpoint.fileId === input.queueFileId
-    && Number.isSafeInteger(checkpoint.offset)
-    && checkpoint.offset >= 0
-    && checkpoint.offset <= totalBytes;
-  return {
-    totalBytes,
-    unreadBytes: checkpointValid ? totalBytes - checkpoint.offset : undefined,
-    checkpointValid,
-  };
-}
-
-function buildTelegramRemoteStatus(input) {
-  if (!input?.access?.allowFrom?.includes(String(input.senderId))) {
-    return 'Nicht verbunden. Sende eine Nachricht, um einen Verbindungscode zu erhalten.';
-  }
-
-  const username = input.username ? `@${String(input.username).replace(/^@/u, '')}` : 'verbundener Nutzer';
-  const tui = input.tuiFresh
-    ? `verbunden${Number.isInteger(input.tuiPid) ? ` (PID ${input.tuiPid}${input.consoleStatus?.processStartedAt
-      ? `, ${formatDuration((Date.parse(input.capturedAt) - Date.parse(input.consoleStatus.processStartedAt)) / 1000)}`
-      : ''})` : ''}`
-    : 'nicht verbunden';
-  const delivery = input.deliveryTarget === 'tui'
-    ? 'Konsolen-Warteschlange'
-    : 'Brücke ohne Konsole';
-  const heartbeatAge = formatAge(input.tuiHeartbeatAt, input.capturedAt);
-  const checkpointAge = formatAge(input.queueCheckpointAt, input.capturedAt);
-  const workLines = input.consoleStatus === undefined
-    ? ['Arbeitsstatus: nicht verfügbar']
-    : input.consoleStatus.turnActive
-      ? [
-          `Arbeitsstatus: aktiv, Schritt ${input.consoleStatus.step}`,
-          ...(input.consoleStatus.activeTask === undefined ? [] : [`Aktive Aufgabe: ${input.consoleStatus.activeTask}`]),
-          ...(formatAge(input.consoleStatus.turnStartedAt, input.capturedAt) === undefined
-            ? [] : [`Zugbeginn: ${formatAge(input.consoleStatus.turnStartedAt, input.capturedAt)}`]),
-          ...(formatAge(input.consoleStatus.lastProgressAt, input.capturedAt) === undefined
-            ? [] : [`Letzter Fortschritt: ${formatAge(input.consoleStatus.lastProgressAt, input.capturedAt)}`]),
-          ...(input.consoleStatus.lastToolName === undefined
-            ? [] : [`Letztes Werkzeug: ${input.consoleStatus.lastToolName}`]),
-          ...(input.consoleStatus.failedRepetitions === undefined
-            ? [] : [`Wiederholte Fehler: ${input.consoleStatus.failedRepetitions}`]),
-        ]
-      : ['Arbeitsstatus: Leerlauf'];
-  return [
-    `BLUN-Fernstatus für ${username}`,
-    `Rechner: ${input.machineName || 'unbekannt'}`,
-    `Version: ${resolveVersionDisplay(input)}`,
-    `Brücke: aktiv (PID ${input.bridgePid}, ${formatDuration(input.bridgeUptimeSeconds)})`,
-    `Konsole: ${tui}`,
-    `Zustellung: ${delivery}`,
-    `Warteschlange: ${input.queueUnreadBytes === undefined ? 'unbekannt' : `${formatBytes(input.queueUnreadBytes)} ungelesen`} (${formatBytes(input.queueBytes)} gesamt)`,
-    ...(heartbeatAge === undefined ? [] : [`Konsolen-Herzschlag: ${heartbeatAge}`]),
-    ...(checkpointAge === undefined ? [] : [`Warteschlangen-Fortschritt: ${checkpointAge}`]),
-    ...workLines,
-    `Gemessen: ${input.capturedAt}`,
-  ].join('\n');
-}
-
-module.exports = {
-  buildTelegramRemoteStatus,
-  formatBytes,
-  formatDuration,
-  resolveTelegramQueueSnapshot,
-  resolveTelegramRemoteVersion,
-};
-

package/telegram-plugin/bin/telegram-reply-parts.cjs

@@ -1,149 +0,0 @@
-'use strict';
-
-const { createHash, randomUUID } = require('node:crypto');
-const fs = require('node:fs');
-const path = require('node:path');
-const { DatabaseSync } = require('node:sqlite');
-
-const MAX_FILE_BYTES = 50 * 1024 * 1024;
-const MAX_PARTS = 1024;
-const MAX_RECEIPTS = 10000;
-const digest = (value) => createHash('sha256').update(value).digest('hex');
-
-function snapshot(file, assertSendable) {
-  assertSendable(file);
-  const fd = fs.openSync(file, 'r');
-  try {
-    const info = fs.fstatSync(fd);
-    if (!info.isFile() || info.size > MAX_FILE_BYTES) throw new Error('attachment is not a regular file of at most 50MB');
-    const buffer = Buffer.alloc(info.size + 1);
-    let read = 0;
-    while (read < buffer.length) {
-      const n = fs.readSync(fd, buffer, read, buffer.length - read, null);
-      if (!n) break;
-      read += n;
-    }
-    if (read !== info.size) throw new Error('attachment changed while reading');
-    return buffer.subarray(0, read);
-  } finally {
-    fs.closeSync(fd);
-  }
-}
-
-function explicitlyRejected(error) {
-  return error?.name === 'GrammyError' && error.ok === false
-    && Number.isInteger(error.error_code) && error.error_code >= 400 && error.error_code < 500;
-}
-
-function openStore(directory) {
-  fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
-  let lease;
-  let db;
-  try {
-    // A separate SQLite writer transaction is an OS-released cross-process lease.
-    // The receipt database can commit before/after each network request under it.
-    lease = new DatabaseSync(path.join(directory, 'reply-lease.sqlite'));
-    lease.exec('PRAGMA busy_timeout=0; BEGIN IMMEDIATE;');
-    db = new DatabaseSync(path.join(directory, 'reply-parts.sqlite'));
-    const version = db.prepare('PRAGMA user_version').get().user_version;
-    if (version !== 0 && version !== 1) throw new Error('unsupported reply receipt version');
-    db.exec(`PRAGMA busy_timeout=0; PRAGMA synchronous=FULL;
-      CREATE TABLE IF NOT EXISTS receipts (
-        id TEXT PRIMARY KEY, manifest TEXT NOT NULL, implicit INTEGER NOT NULL,
-        total INTEGER NOT NULL, next INTEGER NOT NULL, inflight INTEGER NOT NULL,
-        ids TEXT NOT NULL, fallbacks INTEGER NOT NULL, completed INTEGER NOT NULL
-      );
-      CREATE INDEX IF NOT EXISTS pending_manifest ON receipts(manifest, implicit, completed);`);
-    if (version === 0) db.exec('PRAGMA user_version=1;');
-    return { db, close() { try { db.close(); } finally { lease.close(); } } };
-  } catch (error) {
-    db?.close();
-    lease?.close();
-    throw new Error(`reply receipt storage unavailable or busy: ${error.message}`, { cause: error });
-  }
-}
-
-function checkedReceipt(row, manifest, total) {
-  if (row.manifest !== manifest || row.total !== total) throw new Error('delivery_id payload conflict; do not reuse an ID for different content or recipients');
-  let ids;
-  try { ids = JSON.parse(row.ids); } catch { throw new Error('invalid reply receipt'); }
-  if (!Array.isArray(ids) || ids.length !== row.next || row.next < 0 || row.next > total
-      || !ids.every((id) => Number.isSafeInteger(id) && id > 0)
-      || ![0, 1].includes(row.inflight) || ![0, 1].includes(row.completed)
-      || !Number.isSafeInteger(row.fallbacks) || row.fallbacks < 0 || row.fallbacks > row.next
-      || row.completed !== Number(row.next === total) || (row.completed && row.inflight)) {
-    throw new Error('invalid reply receipt');
-  }
-  return ids;
-}
-
-async function deliverFileReply(options) {
-  const { directory, botId, chatId, chunks, files, replyTo, replyMode, parseMode,
-    assertSendable, photoExts, sendText, sendFile } = options;
-  let deliveryId = options.deliveryId;
-  if (deliveryId !== undefined && (typeof deliveryId !== 'string'
-      || !/^[A-Za-z0-9._:-]{1,128}$/.test(deliveryId))) throw new Error('invalid delivery_id');
-  const textParts = chunks.filter((text) => text.length > 0);
-  if (textParts.length + files.length > MAX_PARTS) throw new Error('reply exceeds 1024 parts');
-  const attachments = files.map((file) => {
-    const bytes = snapshot(file, assertSendable);
-    return { file: path.resolve(file), name: path.basename(file), size: bytes.length,
-      sha256: digest(bytes), kind: photoExts.has(path.extname(file).toLowerCase()) ? 'photo' : 'document' };
-  });
-  const parts = textParts.map((text, index) => ({ kind: 'text', text,
-    replyTo: replyTo !== undefined && replyMode !== 'off' && (replyMode === 'all' || index === 0) ? replyTo : null }));
-  parts.push(...attachments.map((file) => ({ ...file, replyTo: replyTo !== undefined && replyMode !== 'off' ? replyTo : null })));
-  const manifest = digest(JSON.stringify({ botId, chatId, parseMode: parseMode ?? null, parts }));
-  const store = openStore(directory);
-  try {
-    const db = store.db;
-    let row = deliveryId !== undefined
-      ? db.prepare('SELECT * FROM receipts WHERE id=?').get(deliveryId)
-      : db.prepare('SELECT * FROM receipts WHERE manifest=? AND implicit=1 AND completed=0').get(manifest);
-    if (row) deliveryId = row.id;
-    else {
-      if (db.prepare('SELECT count(*) AS n FROM receipts').get().n >= MAX_RECEIPTS) throw new Error('reply receipt store is full; preserve receipts before maintenance');
-      const implicit = deliveryId === undefined ? 1 : 0;
-      deliveryId ??= randomUUID();
-      db.prepare('INSERT INTO receipts VALUES (?, ?, ?, ?, 0, 0, ?, 0, 0)')
-        .run(deliveryId, manifest, implicit, parts.length, '[]');
-      row = db.prepare('SELECT * FROM receipts WHERE id=?').get(deliveryId);
-    }
-    const ids = checkedReceipt(row, manifest, parts.length);
-    if (row.inflight) throw new Error('Telegram acceptance is unknown; automatic retry stopped to avoid duplicates');
-    let fallbacks = row.fallbacks;
-    for (let index = row.next; index < parts.length; index += 1) {
-      const part = parts[index];
-      let bytes;
-      if (part.kind !== 'text') {
-        bytes = snapshot(part.file, assertSendable);
-        if (bytes.length !== part.size || digest(bytes) !== part.sha256) throw new Error('attachment changed since this delivery was prepared');
-      }
-      const replyOptions = part.replyTo === null ? {} : { reply_parameters: { message_id: part.replyTo } };
-      db.prepare('UPDATE receipts SET inflight=1 WHERE id=?').run(deliveryId);
-      let result;
-      try {
-        result = part.kind === 'text'
-          ? await sendText(part.text, replyOptions, parseMode)
-          : { sent: await sendFile(part.kind, bytes, part.name, replyOptions), plainTextFallback: false };
-      } catch (error) {
-        if (explicitlyRejected(error)) db.prepare('UPDATE receipts SET inflight=0 WHERE id=?').run(deliveryId);
-        throw error;
-      }
-      const messageId = result?.sent?.message_id;
-      if (!Number.isSafeInteger(messageId) || messageId <= 0) throw new Error('Telegram acceptance is unknown: missing message_id');
-      ids.push(messageId);
-      if (result.plainTextFallback) fallbacks += 1;
-      // If committing the acknowledgement fails, inflight stays set: never blind-retry.
-      db.prepare('UPDATE receipts SET next=?, inflight=0, ids=?, fallbacks=?, completed=? WHERE id=?')
-        .run(index + 1, JSON.stringify(ids), fallbacks, Number(index + 1 === parts.length), deliveryId);
-    }
-    return { sentIds: ids, plainTextFallbacks: fallbacks, deliveryId, replayed: row.completed === 1 };
-  } catch (error) {
-    throw new Error(`${error.message}; delivery_id=${deliveryId ?? 'unassigned'}. Reuse this ID and unchanged arguments for a retry; never replace it just to bypass an uncertain result.`, { cause: error });
-  } finally {
-    store.close();
-  }
-}
-
-module.exports = { deliverFileReply };

package/telegram-plugin/bin/telegram-text-chunk-policy.cjs

@@ -1,63 +0,0 @@
-'use strict';
-
-const TELEGRAM_TEXT_LIMIT = 4096;
-
-function preferredCut(text, start, hardEnd) {
-  const minimum = start + Math.floor((hardEnd - start) / 2);
-  const boundaries = [
-    ['\n\n', 2],
-    ['\n', 1],
-    [' ', 1],
-  ];
-  for (const [boundary, width] of boundaries) {
-    const index = text.lastIndexOf(boundary, hardEnd - 1);
-    if (index >= minimum) return index + width;
-  }
-  return hardEnd;
-}
-
-function preserveSurrogatePair(text, start, end) {
-  if (end <= start || end >= text.length) return end;
-  const before = text.charCodeAt(end - 1);
-  const after = text.charCodeAt(end);
-  const splitsPair = before >= 0xD800 && before <= 0xDBFF && after >= 0xDC00 && after <= 0xDFFF;
-  return splitsPair && end - 1 > start ? end - 1 : end;
-}
-
-function splitTelegramText(value, limit = TELEGRAM_TEXT_LIMIT) {
-  const text = typeof value === 'string' ? value : String(value ?? '');
-  if (text.length === 0) return [];
-  if (!Number.isSafeInteger(limit) || limit <= 0) {
-    throw new TypeError('Telegram text chunk limit must be a positive safe integer');
-  }
-
-  const chunks = [];
-  let start = 0;
-  while (start < text.length) {
-    const hardEnd = Math.min(text.length, start + limit);
-    let end = hardEnd < text.length ? preferredCut(text, start, hardEnd) : hardEnd;
-    end = preserveSurrogatePair(text, start, end);
-    if (end <= start) end = hardEnd;
-    chunks.push(text.slice(start, end));
-    start = end;
-  }
-  return chunks;
-}
-
-async function sendTelegramTextChunks(value, sendChunk, limit = TELEGRAM_TEXT_LIMIT) {
-  if (typeof sendChunk !== 'function') {
-    throw new TypeError('Telegram chunk sender must be a function');
-  }
-  const chunks = splitTelegramText(value, limit);
-  const results = [];
-  for (let index = 0; index < chunks.length; index += 1) {
-    results.push(await sendChunk(chunks[index], index, chunks.length));
-  }
-  return { chunks, results };
-}
-
-module.exports = {
-  TELEGRAM_TEXT_LIMIT,
-  sendTelegramTextChunks,
-  splitTelegramText,
-};