blun-king-cli 9.1.586 → 9.1.588

package/telegram-plugin/bin/telegram-approval-relay.cjs

@@ -1,290 +0,0 @@
-'use strict';
-
-const crypto = require('node:crypto');
-const fs = require('node:fs');
-const os = require('node:os');
-const path = require('node:path');
-
-const RELAY_VERSION = 1;
-const DEFAULT_TIMEOUT_MS = 60_000;
-const DEFAULT_POLL_INTERVAL_MS = 250;
-const MAX_LABEL_CHARS = 48;
-const ALLOWED_RESPONSES = new Set(['approved', 'approved_for_session', 'rejected']);
-
-function relayRoot(homeDir = os.homedir()) {
-  return path.join(homeDir, '.blun', 'channels', 'telegram', 'approvals');
-}
-
-function relayPaths(homeDir) {
-  const root = relayRoot(homeDir);
-  return {
-    root,
-    pending: path.join(root, 'pending'),
-    responses: path.join(root, 'responses'),
-    resolved: path.join(root, 'resolved'),
-    sent: path.join(root, 'sent'),
-  };
-}
-
-function ensureRelayDirs(homeDir) {
-  const dirs = relayPaths(homeDir);
-  for (const dir of Object.values(dirs).slice(1)) {
-    fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
-  }
-  return dirs;
-}
-
-function safeId(value) {
-  return crypto.createHash('sha256').update(String(value)).digest('hex').slice(0, 24);
-}
-
-function requestFileName(requestId) {
-  return `${safeId(requestId)}.json`;
-}
-
-function atomicWriteJson(file, value) {
-  const temp = `${file}.${process.pid}.${crypto.randomBytes(4).toString('hex')}.tmp`;
-  fs.writeFileSync(temp, `${JSON.stringify(value)}\n`, { encoding: 'utf8', mode: 0o600 });
-  fs.renameSync(temp, file);
-}
-
-function readJson(file) {
-  try {
-    return JSON.parse(fs.readFileSync(file, 'utf8'));
-  } catch {
-    return null;
-  }
-}
-
-function compactLabel(value) {
-  const normalized = String(value ?? '').replace(/\s+/gu, ' ').trim();
-  if (normalized.length <= MAX_LABEL_CHARS) return normalized;
-  return `${normalized.slice(0, MAX_LABEL_CHARS - 1)}…`;
-}
-
-function resolveTelegramApprovalTarget(allowFrom, configuredChatId) {
-  const allowed = Array.isArray(allowFrom)
-    ? [...new Set(allowFrom.map(String).filter((value) => value.length > 0))]
-    : [];
-  const configured = String(configuredChatId ?? '').trim();
-  if (configured.length > 0) return allowed.includes(configured) ? configured : null;
-  const privateChats = allowed.filter((value) => /^[1-9]\d*$/u.test(value));
-  if (privateChats.length === 1) return privateChats[0];
-  return allowed.length === 1 ? allowed[0] : null;
-}
-
-function parseTelegramApprovalCallback(data) {
-  const match = /^blun-appr:([a-f0-9]{24}):(\d+)$/u.exec(String(data ?? ''));
-  if (match === null) return null;
-  const choiceIndex = Number(match[2]);
-  if (!Number.isSafeInteger(choiceIndex)) return null;
-  return { requestId: match[1], choiceIndex };
-}
-
-function buildTelegramApprovalCard(request) {
-  return {
-    text: request.toolName,
-    reply_markup: {
-      inline_keyboard: request.choices.map((choice) => [{
-        text: choice.label,
-        callback_data: `blun-appr:${request.requestId}:${choice.index}`,
-      }]),
-    },
-  };
-}
-
-function isAuthorizedTelegramApprovalCallback(expectedChatId, senderId, chatId) {
-  if (expectedChatId === null || expectedChatId === undefined) return false;
-  return String(senderId ?? '') === String(expectedChatId)
-    && String(chatId ?? '') === String(expectedChatId);
-}
-
-function shouldRelayTelegramApproval(permissionMode) {
-  return permissionMode !== 'yolo';
-}
-
-function buildTelegramApprovalRequest(payload, options = {}) {
-  const now = Number.isFinite(options.now) ? options.now : Date.now();
-  const timeoutMs = Number.isFinite(options.timeoutMs) && options.timeoutMs > 0
-    ? options.timeoutMs
-    : DEFAULT_TIMEOUT_MS;
-  const requestId = crypto.randomBytes(12).toString('hex');
-  const nonce = crypto.randomBytes(16).toString('hex');
-  const choices = (Array.isArray(payload?.choices) ? payload.choices : [])
-    .filter((choice) => choice?.requires_feedback !== true && ALLOWED_RESPONSES.has(choice?.response))
-    .map((choice, index) => ({
-      index,
-      label: compactLabel(choice.label || choice.response),
-      response: choice.response,
-    }));
-  if (choices.length === 0) return null;
-  return {
-    v: RELAY_VERSION,
-    requestId,
-    nonce,
-    approvalId: String(payload?.id ?? ''),
-    toolName: compactLabel(payload?.tool_name || 'Werkzeug'),
-    choices,
-    createdAt: now,
-    expiresAt: now + timeoutMs,
-  };
-}
-
-function responseForChoice(request, choiceIndex) {
-  const choice = request?.choices?.find((candidate) => candidate.index === choiceIndex);
-  if (choice === undefined) return null;
-  if (choice.response === 'approved_for_session') {
-    return { decision: 'approved', scope: 'session', selectedLabel: choice.label };
-  }
-  return {
-    decision: choice.response === 'approved' ? 'approved' : 'rejected',
-    selectedLabel: choice.label,
-  };
-}
-
-function validateTelegramApprovalResponse(request, response, now = Date.now()) {
-  if (request?.v !== RELAY_VERSION || response?.v !== RELAY_VERSION) return null;
-  if (request.requestId !== response.requestId || request.nonce !== response.nonce) return null;
-  if (!Number.isFinite(request.expiresAt) || now > request.expiresAt) return null;
-  if (!Number.isInteger(response.choiceIndex)) return null;
-  return responseForChoice(request, response.choiceIndex);
-}
-
-function beginTelegramApprovalRelay(payload, options = {}) {
-  const request = buildTelegramApprovalRequest(payload, options);
-  if (request === null) return null;
-  const dirs = ensureRelayDirs(options.homeDir);
-  const fileName = requestFileName(request.requestId);
-  const pendingFile = path.join(dirs.pending, fileName);
-  const responseFile = path.join(dirs.responses, fileName);
-  const resolvedFile = path.join(dirs.resolved, fileName);
-  atomicWriteJson(pendingFile, request);
-
-  let settled = false;
-  let interval;
-  let resolvePromise;
-  const promise = new Promise((resolve) => { resolvePromise = resolve; });
-  const finish = (response) => {
-    if (settled) return false;
-    settled = true;
-    if (interval !== undefined) clearInterval(interval);
-    const persistedResponse = response?.decision === 'edited' ? { decision: 'edited' } : response;
-    try {
-      atomicWriteJson(resolvedFile, {
-        v: RELAY_VERSION,
-        requestId: request.requestId,
-        resolvedAt: Date.now(),
-        response: persistedResponse,
-      });
-    } catch (error) {
-      try { options.onError?.(error); } catch {}
-    } finally {
-      resolvePromise(response);
-    }
-    return true;
-  };
-  const poll = () => {
-    if (settled) return;
-    if (Date.now() > request.expiresAt) {
-      finish(null);
-      return;
-    }
-    const raw = readJson(responseFile);
-    if (raw === null) return;
-    const response = validateTelegramApprovalResponse(request, raw);
-    if (response !== null) finish(response);
-  };
-  interval = setInterval(poll, options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS);
-  interval.unref?.();
-  return {
-    request,
-    promise,
-    complete: finish,
-    poll,
-    dispose: () => {
-      if (interval !== undefined) clearInterval(interval);
-      interval = undefined;
-    },
-  };
-}
-
-function listPendingTelegramApprovals(options = {}) {
-  const dirs = ensureRelayDirs(options.homeDir);
-  const now = Number.isFinite(options.now) ? options.now : Date.now();
-  const results = [];
-  for (const name of fs.readdirSync(dirs.pending)) {
-    if (!name.endsWith('.json')) continue;
-    if (fs.existsSync(path.join(dirs.resolved, name))) continue;
-    const request = readJson(path.join(dirs.pending, name));
-    if (request?.v !== RELAY_VERSION || now > request.expiresAt) continue;
-    results.push(request);
-  }
-  return results.sort((left, right) => left.createdAt - right.createdAt);
-}
-
-function writeTelegramApprovalResponse(request, choiceIndex, metadata = {}, options = {}) {
-  if (responseForChoice(request, choiceIndex) === null) return false;
-  const dirs = ensureRelayDirs(options.homeDir);
-  const fileName = requestFileName(request.requestId);
-  if (fs.existsSync(path.join(dirs.resolved, fileName))) return false;
-  const response = {
-    v: RELAY_VERSION,
-    requestId: request.requestId,
-    nonce: request.nonce,
-    choiceIndex,
-    senderId: String(metadata.senderId ?? ''),
-    chatId: String(metadata.chatId ?? ''),
-    respondedAt: Number.isFinite(metadata.now) ? metadata.now : Date.now(),
-  };
-  const file = path.join(dirs.responses, fileName);
-  try {
-    fs.writeFileSync(file, `${JSON.stringify(response)}\n`, { encoding: 'utf8', mode: 0o600, flag: 'wx' });
-    return true;
-  } catch (error) {
-    if (error?.code === 'EEXIST') return false;
-    throw error;
-  }
-}
-
-function markTelegramApprovalSent(request, metadata = {}, options = {}) {
-  const dirs = ensureRelayDirs(options.homeDir);
-  const file = path.join(dirs.sent, requestFileName(request.requestId));
-  const value = {
-    v: RELAY_VERSION,
-    requestId: request.requestId,
-    chatId: String(metadata.chatId ?? ''),
-    messageId: String(metadata.messageId ?? ''),
-    sentAt: Number.isFinite(metadata.now) ? metadata.now : Date.now(),
-  };
-  try {
-    fs.writeFileSync(file, `${JSON.stringify(value)}\n`, { encoding: 'utf8', mode: 0o600, flag: 'wx' });
-    return true;
-  } catch (error) {
-    if (error?.code === 'EEXIST') return false;
-    throw error;
-  }
-}
-
-function wasTelegramApprovalSent(request, options = {}) {
-  const dirs = ensureRelayDirs(options.homeDir);
-  return fs.existsSync(path.join(dirs.sent, requestFileName(request.requestId)));
-}
-
-module.exports = {
-  DEFAULT_TIMEOUT_MS,
-  beginTelegramApprovalRelay,
-  buildTelegramApprovalCard,
-  buildTelegramApprovalRequest,
-  listPendingTelegramApprovals,
-  markTelegramApprovalSent,
-  relayPaths,
-  resolveTelegramApprovalTarget,
-  parseTelegramApprovalCallback,
-  isAuthorizedTelegramApprovalCallback,
-  requestFileName,
-  responseForChoice,
-  shouldRelayTelegramApproval,
-  validateTelegramApprovalResponse,
-  wasTelegramApprovalSent,
-  writeTelegramApprovalResponse,
-};

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

@@ -1,175 +0,0 @@
-'use strict';
-
-const { mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } = require('node:fs');
-const { join } = require('node:path');
-
-const STATUS_FILE = 'telegram-console-status.json';
-const MAX_STATUS_BYTES = 16_384;
-const MAX_TASK_CHARS = 240;
-const MAX_TOOL_NAME_CHARS = 80;
-const MAX_VERSION_CHARS = 80;
-
-function validInstant(value) {
-  if (typeof value !== 'string' || value.length === 0) return undefined;
-  return Number.isFinite(Date.parse(value)) ? value : undefined;
-}
-
-function boundedTask(value) {
-  if (typeof value !== 'string') return undefined;
-  const title = value.replace(/\s+/gu, ' ').trim();
-  return title.length > 0 ? title.slice(0, MAX_TASK_CHARS) : undefined;
-}
-
-function boundedToolName(value) {
-  if (typeof value !== 'string') return undefined;
-  const name = value.replace(/\s+/gu, ' ').trim();
-  return name.length > 0 ? name.slice(0, MAX_TOOL_NAME_CHARS) : undefined;
-}
-
-function boundedVersion(value) {
-  if (typeof value !== 'string') return undefined;
-  const version = value.trim();
-  return version.length > 0
-    && version.length <= MAX_VERSION_CHARS
-    && /^[0-9A-Za-z][0-9A-Za-z.+-]*$/u.test(version)
-    ? version
-    : undefined;
-}
-
-function instantFromMilliseconds(value) {
-  if (!Number.isFinite(value) || value < 0) return undefined;
-  try {
-    return new Date(value).toISOString();
-  } catch {
-    return undefined;
-  }
-}
-
-function buildTurnDiagnostics(turnActive, activity) {
-  if (!turnActive || activity?.active !== true) return {};
-  const turnStartedAt = instantFromMilliseconds(activity.startedAtMs);
-  const lastProgressAt = instantFromMilliseconds(activity.lastProgressAtMs);
-  const lastToolName = boundedToolName(activity.lastToolName);
-  const failedRepetitions = Number.isSafeInteger(activity.failedRepetitions)
-    && activity.failedRepetitions >= 0
-    && activity.failedRepetitions <= 100
-    ? activity.failedRepetitions
-    : undefined;
-  return {
-    ...(turnStartedAt === undefined ? {} : { turnStartedAt }),
-    ...(lastProgressAt === undefined ? {} : { lastProgressAt }),
-    ...(lastToolName === undefined ? {} : { lastToolName }),
-    ...(failedRepetitions === undefined ? {} : { failedRepetitions }),
-  };
-}
-
-function buildTelegramConsoleStatus(input = {}) {
-  const capturedAt = validInstant(input.capturedAt);
-  const loadedVersion = boundedVersion(input.loadedVersion);
-  const processStartedAt = validInstant(input.processStartedAt);
-  const pid = Number.isSafeInteger(input.pid) && input.pid > 1 ? input.pid : undefined;
-  const step = Number.isSafeInteger(input.step) && input.step >= 0 ? input.step : 0;
-  if (capturedAt === undefined || processStartedAt === undefined || pid === undefined
-      || typeof input.turnActive !== 'boolean') {
-    throw new TypeError('invalid Telegram console status');
-  }
-  const activeTask = input.turnActive
-    ? boundedTask(input.todos?.find((todo) => todo?.status === 'in_progress')?.title)
-    : undefined;
-  return {
-    version: 1,
-    ...(loadedVersion === undefined ? {} : { loadedVersion }),
-    pid,
-    capturedAt,
-    processStartedAt,
-    turnActive: input.turnActive,
-    step,
-    ...(activeTask === undefined ? {} : { activeTask }),
-    ...buildTurnDiagnostics(input.turnActive, input.turnActivity),
-  };
-}
-
-function parseTelegramConsoleStatus(value, options = {}) {
-  try {
-    const text = typeof value === 'string' ? value : JSON.stringify(value);
-    if (text.length === 0 || Buffer.byteLength(text, 'utf8') > MAX_STATUS_BYTES) return undefined;
-    const parsed = typeof value === 'string' ? JSON.parse(value) : value;
-    if (parsed?.version !== 1 || !Number.isSafeInteger(parsed.pid) || parsed.pid <= 1
-        || (options.expectedPid !== undefined && parsed.pid !== options.expectedPid)
-        || validInstant(parsed.capturedAt) === undefined
-        || validInstant(parsed.processStartedAt) === undefined
-        || typeof parsed.turnActive !== 'boolean'
-        || !Number.isSafeInteger(parsed.step) || parsed.step < 0) return undefined;
-    const activeTask = boundedTask(parsed.activeTask);
-    const hasLoadedVersion = Object.hasOwn(parsed, 'loadedVersion');
-    const loadedVersion = boundedVersion(parsed.loadedVersion);
-    const hasTurnStartedAt = Object.hasOwn(parsed, 'turnStartedAt');
-    const hasLastProgressAt = Object.hasOwn(parsed, 'lastProgressAt');
-    const hasLastToolName = Object.hasOwn(parsed, 'lastToolName');
-    const hasFailedRepetitions = Object.hasOwn(parsed, 'failedRepetitions');
-    const turnStartedAt = validInstant(parsed.turnStartedAt);
-    const lastProgressAt = validInstant(parsed.lastProgressAt);
-    const lastToolName = boundedToolName(parsed.lastToolName);
-    const failedRepetitions = parsed.failedRepetitions;
-    if ((hasLoadedVersion && loadedVersion === undefined)
-        || (hasTurnStartedAt && turnStartedAt === undefined)
-        || (hasLastProgressAt && lastProgressAt === undefined)
-        || (hasLastToolName && lastToolName === undefined)
-        || (hasFailedRepetitions && (!Number.isSafeInteger(failedRepetitions)
-          || failedRepetitions < 0 || failedRepetitions > 100))) return undefined;
-    const diagnostics = parsed.turnActive ? {
-      ...(turnStartedAt === undefined ? {} : { turnStartedAt }),
-      ...(lastProgressAt === undefined ? {} : { lastProgressAt }),
-      ...(lastToolName === undefined ? {} : { lastToolName }),
-      ...(hasFailedRepetitions ? { failedRepetitions } : {}),
-    } : {};
-    return {
-      version: 1,
-      ...(loadedVersion === undefined ? {} : { loadedVersion }),
-      pid: parsed.pid,
-      capturedAt: parsed.capturedAt,
-      processStartedAt: parsed.processStartedAt,
-      turnActive: parsed.turnActive,
-      step: parsed.step,
-      ...(parsed.turnActive && activeTask !== undefined ? { activeTask } : {}),
-      ...diagnostics,
-    };
-  } catch {
-    return undefined;
-  }
-}
-
-function writeTelegramConsoleStatus(input = {}) {
-  const status = buildTelegramConsoleStatus(input);
-  const directory = input.directory;
-  if (typeof directory !== 'string' || directory.length === 0) {
-    throw new TypeError('invalid Telegram console status directory');
-  }
-  mkdirSync(directory, { recursive: true, mode: 0o700 });
-  const target = join(directory, STATUS_FILE);
-  const temporary = join(directory, `.telegram-console-status.${status.pid}.${Date.now()}.tmp`);
-  try {
-    writeFileSync(temporary, `${JSON.stringify(status)}\n`, { encoding: 'utf8', mode: 0o600 });
-    renameSync(temporary, target);
-  } finally {
-    rmSync(temporary, { force: true });
-  }
-  return status;
-}
-
-function readTelegramConsoleStatus(directory, options = {}) {
-  try {
-    return parseTelegramConsoleStatus(readFileSync(join(directory, STATUS_FILE), 'utf8'), options);
-  } catch {
-    return undefined;
-  }
-}
-
-module.exports = {
-  STATUS_FILE,
-  buildTelegramConsoleStatus,
-  parseTelegramConsoleStatus,
-  readTelegramConsoleStatus,
-  writeTelegramConsoleStatus,
-};
-

package/telegram-plugin/bin/telegram-delivery-lifecycle.cjs

@@ -1,125 +0,0 @@
-'use strict';
-
-const crypto = require('node:crypto');
-const fs = require('node:fs');
-const path = require('node:path');
-
-const DEFAULT_MAX_BYTES = 2 * 1024 * 1024;
-const JOURNAL_NAME = 'delivery-lifecycle.jsonl';
-const PREVIOUS_NAME = 'delivery-lifecycle.previous.jsonl';
-
-function cleanToken(value, maximum = 80) {
-  if (value === undefined || value === null) return undefined;
-  const text = String(value).replace(/[^a-zA-Z0-9_.:-]/gu, '_').slice(0, maximum);
-  return text.length > 0 ? text : undefined;
-}
-
-function boundedInteger(value) {
-  const number = Number(value);
-  if (!Number.isSafeInteger(number) || number < 0) return undefined;
-  return Math.min(number, Number.MAX_SAFE_INTEGER);
-}
-
-function numericMessageId(value) {
-  if (value === undefined || value === null) return undefined;
-  const text = String(value);
-  return /^[1-9][0-9]{0,39}$/u.test(text) ? text : undefined;
-}
-
-function strictChatHash(value) {
-  if (value === undefined || value === null) return undefined;
-  const text = String(value);
-  return /^[a-f0-9]{12}$/u.test(text) ? text : undefined;
-}
-
-function hashChatId(chatId) {
-  if (chatId === undefined || chatId === null || String(chatId).length === 0) return undefined;
-  return crypto.createHash('sha256').update(String(chatId)).digest('hex').slice(0, 12);
-}
-
-function telegramDeliveryIdentity(meta = {}) {
-  const messageId = numericMessageId(meta.message_id ?? meta.messageId);
-  const chatHash = hashChatId(meta.chat_id ?? meta.chatId);
-  return {
-    ...(messageId === undefined ? {} : { messageId }),
-    ...(chatHash === undefined ? {} : { chatHash }),
-  };
-}
-
-function lifecycleRecord(event, now, pid) {
-  const messageId = numericMessageId(event.messageId);
-  const chatHash = event.chatHash === undefined
-    ? undefined
-    : strictChatHash(event.chatHash);
-  const identity = {
-    ...(messageId === undefined ? {} : { messageId }),
-    ...(event.chatHash === undefined
-      ? telegramDeliveryIdentity({ chatId: event.chatId })
-      : chatHash === undefined ? {} : { chatHash }),
-  };
-  const record = {
-    version: 1,
-    at: now().toISOString(),
-    pid,
-    stage: cleanToken(event.stage, 48) ?? 'unknown',
-    ...identity,
-  };
-  for (const [key, limit] of [
-    ['route', 24],
-    ['priority', 24],
-    ['turnId', 48],
-    ['reason', 48],
-  ]) {
-    const value = cleanToken(event[key], limit);
-    if (value !== undefined) record[key] = value;
-  }
-  for (const key of ['queueDepth', 'attempt', 'checkpointOffset']) {
-    const value = boundedInteger(event[key]);
-    if (value !== undefined) record[key] = value;
-  }
-  return record;
-}
-
-function rotateJournal(file, previous, maximum) {
-  try {
-    if (fs.statSync(file).size < maximum) return;
-  } catch {
-    return;
-  }
-  try {
-    fs.rmSync(previous, { force: true });
-    fs.renameSync(file, previous);
-  } catch {}
-}
-
-function createTelegramDeliveryLifecycle(options = {}) {
-  const directory = options.stateDir;
-  const maximum = Number.isSafeInteger(options.maxBytes) && options.maxBytes > 0
-    ? options.maxBytes
-    : DEFAULT_MAX_BYTES;
-  const now = typeof options.now === 'function' ? options.now : () => new Date();
-  const pid = Number.isSafeInteger(options.pid) ? options.pid : process.pid;
-  const file = path.join(directory, JOURNAL_NAME);
-  const previous = path.join(directory, PREVIOUS_NAME);
-
-  return {
-    record(event) {
-      try {
-        fs.mkdirSync(directory, { recursive: true });
-        rotateJournal(file, previous, maximum);
-        fs.appendFileSync(file, `${JSON.stringify(lifecycleRecord(event, now, pid))}\n`, {
-          encoding: 'utf8',
-          mode: 0o600,
-        });
-        return true;
-      } catch {
-        return false;
-      }
-    },
-  };
-}
-
-module.exports = {
-  createTelegramDeliveryLifecycle,
-  telegramDeliveryIdentity,
-};

package/telegram-plugin/bin/telegram-direct-reply-policy.cjs

@@ -1,48 +0,0 @@
-'use strict';
-
-const { readJsonlTail } = require('./telegram-private-conversation-policy.cjs');
-const MAX_AGE_MS = 30 * 60 * 1000;
-const PRESENCE_ANSWER = /^(?:(?:ja )?(?:bin da|bin hier|ich bin da|hier bin ich|ich bin hier|bereit|i am here|i m here|here|ready))(?: (?:was brauchst du|was gibt es|was liegt an|wie kann ich helfen|what do you need|how can i help))?$/u;
-const PRESENCE_QUESTION = /^(?:bist du da|bist du hier|bist du erreichbar|are you there|are you here)$/u;
-
-function normalize(value) {
-  return String(value ?? '').normalize('NFKC').toLocaleLowerCase('de-DE')
-    .replace(/[^\p{L}\p{N}\s]/gu, ' ').replace(/\s+/gu, ' ').trim();
-}
-
-function messageId(value) {
-  if (typeof value !== 'string' && typeof value !== 'number') return null;
-  if (!/^[1-9]\d*$/u.test(String(value))) return null;
-  const number = Number(value);
-  return Number.isSafeInteger(number) ? number : null;
-}
-
-function ownPresenceQuestion(content, recipientName) {
-  if (typeof content !== 'string' || content.length > 512) return false;
-  if (typeof recipientName !== 'string' || recipientName.length > 128) return false;
-  const name = normalize(recipientName), text = normalize(content);
-  if (!name) return false;
-  if (text === name) return true;
-  return text.startsWith(name + ' ') && PRESENCE_QUESTION.test(text.slice(name.length + 1));
-}
-
-function permitsPresenceReply({ text, chatId, replyTo, inboxFile,
-  recipientName = process.env.BLUN_TELEGRAM_PERSONA_NAME || '', now = Date.now() }) {
-  if (typeof text !== 'string' || text.length > 160 || !PRESENCE_ANSWER.test(normalize(text))) return false;
-  const wantedId = messageId(replyTo), wantedChat = String(chatId ?? '');
-  if (wantedId === null || !/^-[1-9]\d*$/u.test(wantedChat) || !Number.isFinite(now)) return false;
-  // A semantic marker is shared by legacy recipients; only a bound own-name ping can refine it.
-  const records = readJsonlTail(inboxFile);
-  for (let index = records.length - 1; index >= 0; index -= 1) {
-    const record = records[index], meta = record.meta;
-    if (record.direction !== 'in' || !meta || String(meta.chat_id) !== wantedChat || messageId(meta.message_id) !== wantedId) continue;
-    const timestamp = Date.parse(String(meta.ts ?? record.ts ?? ''));
-    if (!Number.isFinite(timestamp) || timestamp > now || now - timestamp > MAX_AGE_MS) return false;
-    return meta.addressed === true || meta.addressed === 'true'
-      || meta.addressed === 1 || meta.addressed === '1'
-      || (meta.addressed === 'semantic' && ownPresenceQuestion(record.content, recipientName));
-  }
-  return false;
-}
-
-module.exports = { MAX_AGE_MS, messageId, ownPresenceQuestion, permitsPresenceReply };