cli-jaw 2.0.1 → 2.0.2

package/dist/src/shared/tool-log-sanitize.js

@@ -0,0 +1,191 @@
+export const MAX_TOOL_LOG_RAW_INPUT_CHARS = 180_000;
+export const MAX_TOOL_LOG_ENTRIES = 160;
+export const MAX_TOOL_LOG_STRING_CHARS = 240;
+export const MAX_TOOL_LOG_DETAIL_CHARS = 3_000;
+export const MAX_TOOL_LOG_TOTAL_DETAIL_CHARS = 24_000;
+export const MAX_TOOL_LOG_JSON_CHARS = 64_000;
+const TRUNCATION_ICON = '⚠️';
+const TRUNCATION_LABEL = 'Tool log truncated';
+const TRUNCATION_DETAIL = 'Inline preview capped.';
+const TRACE_RUN_ID_RE = /^tr_[A-Za-z0-9_-]{16,80}$/;
+function asBoundedString(value, max) {
+    if (value == null)
+        return undefined;
+    const raw = String(value);
+    if (!raw)
+        return undefined;
+    if (raw.length <= max)
+        return raw;
+    return `${raw.slice(0, Math.max(0, max - 1))}…`;
+}
+function truncationNotice(kept, total) {
+    return `[detail truncated: kept ${kept} of ${total} chars]`;
+}
+function makeOverflowEntry(omitted) {
+    const suffix = omitted > 0 ? `${omitted} tool event${omitted === 1 ? '' : 's'} omitted` : TRUNCATION_LABEL;
+    return {
+        icon: TRUNCATION_ICON,
+        label: asBoundedString(suffix, MAX_TOOL_LOG_STRING_CHARS) || TRUNCATION_LABEL,
+        toolType: 'tool',
+        status: 'done',
+        detail: TRUNCATION_DETAIL,
+    };
+}
+function boundedNumber(value, max) {
+    const n = Number(value);
+    if (!Number.isFinite(n) || n < 0)
+        return undefined;
+    return Math.min(Math.floor(n), max);
+}
+export function sanitizeToolLogEntry(entry, detailBudget = MAX_TOOL_LOG_DETAIL_CHARS) {
+    const detailRaw = entry.detail == null ? '' : String(entry.detail);
+    const allowedDetail = Math.max(0, Math.min(MAX_TOOL_LOG_DETAIL_CHARS, detailBudget));
+    let detail = asBoundedString(detailRaw, allowedDetail);
+    if (detail && detailRaw.length > allowedDetail) {
+        const notice = truncationNotice(detail.length, detailRaw.length);
+        const room = Math.max(0, allowedDetail - notice.length - 1);
+        detail = `${detailRaw.slice(0, room)}\n${notice}`;
+    }
+    const sanitized = {
+        icon: asBoundedString(entry.icon, MAX_TOOL_LOG_STRING_CHARS) || '🔧',
+        label: asBoundedString(entry.label, MAX_TOOL_LOG_STRING_CHARS) || 'tool',
+    };
+    const rawIcon = asBoundedString(entry.rawIcon, MAX_TOOL_LOG_STRING_CHARS);
+    const toolType = asBoundedString(entry.toolType, MAX_TOOL_LOG_STRING_CHARS);
+    const stepRef = asBoundedString(entry.stepRef, MAX_TOOL_LOG_STRING_CHARS);
+    const status = asBoundedString(entry.status, MAX_TOOL_LOG_STRING_CHARS);
+    const traceRunId = asBoundedString(entry.traceRunId, 96);
+    const traceSeq = boundedNumber(entry.traceSeq, Number.MAX_SAFE_INTEGER);
+    const detailBytes = boundedNumber(entry.detailBytes, Number.MAX_SAFE_INTEGER);
+    const rawRetentionStatus = asBoundedString(entry.rawRetentionStatus, 32);
+    if (rawIcon)
+        sanitized.rawIcon = rawIcon;
+    if (detail)
+        sanitized.detail = detail;
+    if (toolType)
+        sanitized.toolType = toolType;
+    if (stepRef)
+        sanitized.stepRef = stepRef;
+    if (status)
+        sanitized.status = status;
+    if (entry['isEmployee'] === true)
+        sanitized.isEmployee = true;
+    if (traceRunId && TRACE_RUN_ID_RE.test(traceRunId))
+        sanitized.traceRunId = traceRunId;
+    if (traceSeq != null && traceSeq > 0)
+        sanitized.traceSeq = traceSeq;
+    if (entry.detailAvailable === true)
+        sanitized.detailAvailable = true;
+    if (detailBytes != null)
+        sanitized.detailBytes = detailBytes;
+    if (rawRetentionStatus)
+        sanitized.rawRetentionStatus = rawRetentionStatus;
+    return sanitized;
+}
+export function sanitizeToolLogForDurableStorage(entries) {
+    if (!Array.isArray(entries) || entries.length === 0)
+        return [];
+    const overflow = Math.max(0, entries.length - MAX_TOOL_LOG_ENTRIES);
+    const cappedEntries = entries.slice(0, MAX_TOOL_LOG_ENTRIES);
+    const output = [];
+    let detailBudgetLeft = MAX_TOOL_LOG_TOTAL_DETAIL_CHARS;
+    for (const raw of cappedEntries) {
+        const entry = (raw && typeof raw === 'object')
+            ? raw
+            : { label: raw };
+        const detailRawLength = entry.detail == null ? 0 : String(entry.detail).length;
+        const detailBudget = Math.min(MAX_TOOL_LOG_DETAIL_CHARS, detailBudgetLeft);
+        const sanitized = sanitizeToolLogEntry(entry, detailBudget);
+        output.push(sanitized);
+        detailBudgetLeft = Math.max(0, detailBudgetLeft - Math.min(detailRawLength, detailBudget));
+        if (detailBudgetLeft <= 0)
+            detailBudgetLeft = 0;
+    }
+    if (overflow > 0) {
+        if (output.length >= MAX_TOOL_LOG_ENTRIES)
+            output.pop();
+        output.push(makeOverflowEntry(overflow));
+    }
+    return fitToolLogToJsonCap(output);
+}
+function shrinkEntryForJson(entry) {
+    const shrunk = {
+        icon: asBoundedString(entry.icon, 24) || '🔧',
+        label: asBoundedString(entry.label, 80) || 'tool',
+    };
+    const toolType = asBoundedString(entry.toolType, 48);
+    const stepRef = asBoundedString(entry.stepRef, 80);
+    const status = asBoundedString(entry.status, 24);
+    const detail = asBoundedString(entry.detail, 180);
+    const traceRunId = asBoundedString(entry.traceRunId, 96);
+    const traceSeq = boundedNumber(entry.traceSeq, Number.MAX_SAFE_INTEGER);
+    const detailBytes = boundedNumber(entry.detailBytes, Number.MAX_SAFE_INTEGER);
+    const rawRetentionStatus = asBoundedString(entry.rawRetentionStatus, 32);
+    if (toolType)
+        shrunk.toolType = toolType;
+    if (stepRef)
+        shrunk.stepRef = stepRef;
+    if (status)
+        shrunk.status = status;
+    if (detail)
+        shrunk.detail = detail;
+    if (entry.isEmployee === true)
+        shrunk.isEmployee = true;
+    if (traceRunId && TRACE_RUN_ID_RE.test(traceRunId))
+        shrunk.traceRunId = traceRunId;
+    if (traceSeq != null && traceSeq > 0)
+        shrunk.traceSeq = traceSeq;
+    if (entry.detailAvailable === true)
+        shrunk.detailAvailable = true;
+    if (detailBytes != null)
+        shrunk.detailBytes = detailBytes;
+    if (rawRetentionStatus)
+        shrunk.rawRetentionStatus = rawRetentionStatus;
+    return shrunk;
+}
+function fitToolLogToJsonCap(entries) {
+    let fitted = entries.map(shrinkEntryForJson);
+    let json = JSON.stringify(fitted);
+    while (json.length > MAX_TOOL_LOG_JSON_CHARS && fitted.length > 1) {
+        fitted.splice(Math.max(0, fitted.length - 2), 1);
+        fitted[fitted.length - 1] = makeOverflowEntry(entries.length - fitted.length + 1);
+        json = JSON.stringify(fitted);
+    }
+    if (json.length <= MAX_TOOL_LOG_JSON_CHARS)
+        return fitted;
+    const minimal = [{
+            icon: TRUNCATION_ICON,
+            label: TRUNCATION_LABEL,
+            toolType: 'tool',
+            status: 'done',
+            detail: TRUNCATION_DETAIL,
+        }];
+    return JSON.stringify(minimal).length <= MAX_TOOL_LOG_JSON_CHARS ? minimal : [];
+}
+export function serializeSanitizedToolLog(entries) {
+    const sanitized = sanitizeToolLogForDurableStorage(entries);
+    if (sanitized.length === 0)
+        return null;
+    const json = JSON.stringify(sanitized);
+    if (json.length <= MAX_TOOL_LOG_JSON_CHARS)
+        return json;
+    return JSON.stringify(fitToolLogToJsonCap(sanitized));
+}
+export function parseToolLogBounded(raw) {
+    if (!raw)
+        return [];
+    if (raw.length > MAX_TOOL_LOG_RAW_INPUT_CHARS) {
+        return [makeOverflowEntry(1)];
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        return sanitizeToolLogForDurableStorage(parsed);
+    }
+    catch {
+        return [];
+    }
+}
+export function sanitizeSerializedToolLog(raw) {
+    return serializeSanitizedToolLog(parseToolLogBounded(raw));
+}
+//# sourceMappingURL=tool-log-sanitize.js.map

package/dist/src/shared/tool-log-sanitize.js.map

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

package/dist/src/telegram/bot.js

@@ -4,6 +4,7 @@ import { Bot } from 'grammy';
 import { sequentialize } from '@grammyjs/runner';
 import { addBroadcastListener, removeBroadcastListener } from '../core/bus.js';
 import { settings } from '../core/config.js';
+import { stripUndefined } from '../core/strip-undefined.js';
 import { t, normalizeLocale } from '../core/i18n.js';
 import { isResetIntent } from '../orchestrator/pipeline.js';
 import { submitMessage } from '../orchestrator/gateway.js';
@@ -36,28 +37,28 @@ const telegramForwarderLifecycle = createForwarderLifecycle({
     addListener: addBroadcastListener,
     removeListener: removeBroadcastListener,
     buildForwarder: ({ bot }) => createTelegramForwarder({
-        bot,
+        bot: bot,
         getLastChatId: () => {
             const chatIds = Array.from(telegramActiveChatIds);
-            return chatIds.length ? chatIds[chatIds.length - 1] : null;
+            return chatIds.length ? (chatIds[chatIds.length - 1] ?? null) : null;
         },
-        shouldSkip: (data) => data.origin === 'telegram', // handled by tgOrchestrate already
+        shouldSkip: (data) => data["origin"] === 'telegram', // handled by tgOrchestrate already
         log: ({ chatId, preview }) => {
             console.log(`[tg:forward] → chat ${chatId}: ${String(preview).slice(0, 60)}...`);
         },
     }),
 });
 function currentLocale() {
-    return normalizeLocale(settings.locale, 'ko');
+    return normalizeLocale(settings["locale"], 'ko');
 }
 function markChatActive(chatId, ctx) {
     // Refresh insertion order so Array.from(set).at(-1) points to latest active chat.
     telegramActiveChatIds.delete(chatId);
     telegramActiveChatIds.add(chatId);
     // Auto-persist to settings.json so forwarding survives server restart
-    const allowed = settings.telegram?.allowedChatIds || [];
+    const allowed = settings["telegram"]?.allowedChatIds || [];
     if (!allowed.includes(chatId)) {
-        settings.telegram.allowedChatIds = [...allowed, chatId];
+        settings["telegram"].allowedChatIds = [...allowed, chatId];
         import('../core/config.js').then(m => m.saveSettings(settings)).catch(() => { });
     }
     // Update messaging runtime targets
@@ -95,8 +96,8 @@ export function getLatestTelegramChatId() {
     return Array.from(telegramActiveChatIds).at(-1) ?? null;
 }
 export function getTelegramTargetIds() {
-    return settings.telegram.allowedChatIds?.length
-        ? [...settings.telegram.allowedChatIds]
+    return settings["telegram"].allowedChatIds?.length
+        ? [...settings["telegram"].allowedChatIds]
         : [...telegramActiveChatIds];
 }
 export async function sendTelegramText(chatId, text) {
@@ -107,13 +108,13 @@ export async function sendTelegramText(chatId, text) {
 function buildTelegramTarget(ctx) {
     const chatType = ctx.chat?.type;
     const isGroup = chatType === 'group' || chatType === 'supergroup';
-    return {
+    return stripUndefined({
         channel: 'telegram',
         targetKind: 'channel',
         peerKind: isGroup ? 'group' : 'direct',
-        targetId: String(ctx.chat.id),
+        targetId: String(ctx.chat?.id ?? ''),
         threadId: ctx.message?.message_thread_id ? String(ctx.message.message_thread_id) : undefined,
-    };
+    });
 }
 async function telegramSendHandler(req) {
     if (!telegramBot)
@@ -144,7 +145,7 @@ async function telegramSendHandler(req) {
         return { ok: false, error: 'file_path required for non-text types' };
     const { validateFileSize, sendTelegramFile } = await import('./telegram-file.js');
     validateFileSize(filePath, req.type);
-    const result = await sendTelegramFile(telegramBot, chatId, filePath, req.type, { caption: req.caption });
+    const result = await sendTelegramFile(telegramBot, chatId, filePath, req.type, stripUndefined({ caption: req.caption }));
     return result;
 }
 // Register transport at module load time
@@ -162,7 +163,7 @@ function syncTelegramCommands(bot) {
     const cmds = getTelegramMenuCommands()
         .map((c) => ({
         command: c.name,
-        description: toTelegramCommandDescription(c.tgDescKey ? t(c.tgDescKey, {}, locale) : (c.descKey ? t(c.descKey, {}, locale) : c.desc)),
+        description: toTelegramCommandDescription((c.tgDescKey ? t(c.tgDescKey, {}, locale) : (c.descKey ? t(c.descKey, {}, locale) : c.desc)) ?? ''),
     }));
     // Set commands with language_code per Telegram Bot API
     // Also set default (no language_code) for users without language preference
@@ -222,34 +223,37 @@ async function _initTelegramInner() {
             await new Promise(r => setTimeout(r, 2000));
         }
     }
-    const envToken = process.env.TELEGRAM_TOKEN;
+    const envToken = process.env["TELEGRAM_TOKEN"];
     if (envToken)
-        settings.telegram.token = envToken;
-    const envChatIds = process.env.TELEGRAM_ALLOWED_CHAT_IDS;
+        settings["telegram"].token = envToken;
+    const envChatIds = process.env["TELEGRAM_ALLOWED_CHAT_IDS"];
     if (envChatIds) {
-        settings.telegram.allowedChatIds = envChatIds
+        settings["telegram"].allowedChatIds = envChatIds
             .split(',')
             .map(id => parseInt(id.trim(), 10))
             .filter(id => !isNaN(id));
     }
-    if (!settings.telegram?.enabled || !settings.telegram?.token) {
+    if (!settings["telegram"]?.enabled || !settings["telegram"]?.token) {
         console.log('[tg] ⏭️  Telegram pending (disabled or no token)');
         return;
     }
     // Pre-seed telegramActiveChatIds from persisted allowedChatIds
-    if (settings.telegram.allowedChatIds?.length) {
-        for (const id of settings.telegram.allowedChatIds)
+    if (settings["telegram"].allowedChatIds?.length) {
+        for (const id of settings["telegram"].allowedChatIds)
             telegramActiveChatIds.add(id);
-        console.log(`[tg] Pre-seeded ${settings.telegram.allowedChatIds.length} chat(s) from allowedChatIds`);
+        console.log(`[tg] Pre-seeded ${settings["telegram"].allowedChatIds.length} chat(s) from allowedChatIds`);
     }
     const ipv4Agent = new https.Agent({ family: 4 });
     const ipv4Fetch = (url, init = {}) => {
         return new Promise((resolve, reject) => {
             const u = new URL(url);
+            const headersInit = init["headers"];
             const opts = {
                 hostname: u.hostname, port: u.port || 443, path: u.pathname + u.search,
-                method: init.method || 'GET', agent: ipv4Agent,
-                headers: init.headers instanceof Headers ? Object.fromEntries(init.headers) : (init.headers || {}),
+                method: init["method"] || 'GET', agent: ipv4Agent,
+                headers: headersInit instanceof Headers
+                    ? Object.fromEntries(headersInit)
+                    : (headersInit || {}),
             };
             const req = https.request(opts, (res) => {
                 let data = '';
@@ -262,12 +266,13 @@ async function _initTelegramInner() {
                 }));
             });
             req.on('error', reject);
-            if (init.body)
-                req.write(typeof init.body === 'string' ? init.body : JSON.stringify(init.body));
+            const body = init["body"];
+            if (body)
+                req.write(typeof body === 'string' ? body : JSON.stringify(body));
             req.end();
         });
     };
-    const bot = new Bot(settings.telegram.token, {
+    const bot = new Bot(settings["telegram"].token, {
         client: { fetch: ipv4Fetch },
     });
     bot.catch((err) => console.error('[tg:error]', err.message || err));
@@ -277,7 +282,7 @@ async function _initTelegramInner() {
         await next();
     });
     bot.use(async (ctx, next) => {
-        const allowed = settings.telegram.allowedChatIds;
+        const allowed = settings["telegram"].allowedChatIds;
         if (allowed?.length > 0 && !allowed.includes(ctx.chat?.id)) {
             console.log(`[tg:blocked] chatId=${ctx.chat?.id}`);
             return;
@@ -286,7 +291,7 @@ async function _initTelegramInner() {
     });
     // Group chat @mention gating (configurable)
     bot.use(async (ctx, next) => {
-        if (settings.telegram.mentionOnly === false) {
+        if (settings["telegram"].mentionOnly === false) {
             await next();
             return;
         }
@@ -300,19 +305,22 @@ async function _initTelegramInner() {
         await next();
     });
     bot.command('start', (ctx) => ctx.reply(t('tg.connected', {}, currentLocale())));
-    bot.command('id', (ctx) => ctx.reply(`Chat ID: <code>${ctx.chat.id}</code>`, { parse_mode: 'HTML' }));
+    bot.command('id', (ctx) => ctx.reply(`Chat ID: <code>${ctx.chat?.id ?? ''}</code>`, { parse_mode: 'HTML' }));
     async function tgOrchestrate(ctx, prompt, displayMsg) {
         const chatId = ctx.chat?.id;
-        const result = submitMessage(prompt, { origin: 'telegram', displayText: displayMsg, skipOrchestrate: true, chatId });
+        if (!ctx.chat)
+            return;
+        const chat = ctx.chat;
+        const result = submitMessage(prompt, stripUndefined({ origin: 'telegram', displayText: displayMsg, skipOrchestrate: true, chatId }));
         if (result.action === 'queued') {
             console.log(`[tg:queue] agent busy, queued (${result.pending} pending)`);
             await ctx.reply(t('tg.queued', { count: result.pending }, currentLocale()));
             // 큐 처리 후 응답을 이 채팅으로 전달 — requestId로 request-level 격리
             const requestId = result.requestId;
             const queueHandler = (type, data) => {
-                if (type === 'orchestrate_done' && data.text && data.origin === 'telegram' && data.requestId === requestId) {
+                if (type === 'orchestrate_done' && data["text"] && data["origin"] === 'telegram' && data["requestId"] === requestId) {
                     removeBroadcastListener(queueHandler);
-                    const html = markdownToTelegramHtml(data.text);
+                    const html = markdownToTelegramHtml(String(data["text"]));
                     const chunks = chunkTelegramMessage(html);
                     for (const chunk of chunks) {
                         ctx.reply(chunk, { parse_mode: 'HTML' })
@@ -330,7 +338,7 @@ async function _initTelegramInner() {
         }
         // result.action === 'started' — TG 출력 로직 진입
         const submitRequestId = result.requestId;
-        markChatActive(ctx.chat.id, ctx);
+        markChatActive(chat.id, ctx);
         await ctx.replyWithChatAction('typing')
             .then(() => console.log('[tg:typing] ✅ sent'))
             .catch((e) => console.log('[tg:typing] ❌', e.message));
@@ -339,7 +347,7 @@ async function _initTelegramInner() {
                 .then(() => console.log('[tg:typing] ✅ refresh'))
                 .catch((e) => console.log('[tg:typing] ❌ refresh', e.message));
         }, 4000);
-        const showTools = settings.telegram?.showToolUse !== false;
+        const showTools = settings["telegram"]?.showToolUse !== false;
         let statusMsgId = null;
         let statusMsgCreatePromise = null;
         let statusUpdateTimer = null;
@@ -365,7 +373,7 @@ async function _initTelegramInner() {
                 await statusMsgCreatePromise;
                 return;
             }
-            await ctx.api.editMessageText(ctx.chat.id, statusMsgId, `🔄 ${display}`)
+            await ctx.api.editMessageText(chat.id, statusMsgId, `🔄 ${display}`)
                 .catch(() => { });
         };
         const scheduleStatusUpdate = () => {
@@ -400,19 +408,19 @@ async function _initTelegramInner() {
         };
         const toolHandler = showTools ? (type, data) => {
             if (type === 'agent_retry') {
-                pushToolLine(`⏳ ${data.cli} 429 — ${data.delay}s 후 재시도`);
+                pushToolLine(`⏳ ${data["cli"]} 429 — ${data["delay"]}s 후 재시도`);
             }
             else if (type === 'agent_fallback') {
-                pushToolLine(`⚡ ${data.from} → ${data.to}`);
+                pushToolLine(`⚡ ${data["from"]} → ${data["to"]}`);
             }
             else if (type === 'agent_smoke') {
-                console.log(`[tg:smoke] ${data.cli} smoke detected — auto-continuing`);
+                console.log(`[tg:smoke] ${data["cli"]} smoke detected — auto-continuing`);
             }
-            else if (type === 'agent_tool' && data.icon && data.label) {
+            else if (type === 'agent_tool' && data["icon"] && data["label"]) {
                 // Copilot ACP emits many thought chunks; hide them on Telegram to avoid message storms.
-                if (data.icon === '💭')
+                if (data["icon"] === '💭')
                     return;
-                pushToolLine(`${data.icon} ${data.label}`);
+                pushToolLine(`${data["icon"]} ${data["label"]}`);
             }
             else {
                 return;
@@ -421,7 +429,7 @@ async function _initTelegramInner() {
         if (toolHandler)
             addBroadcastListener(toolHandler);
         try {
-            const result = await orchestrateAndCollect(prompt, { origin: 'telegram', chatId: ctx.chat.id, requestId: submitRequestId, _skipInsert: true });
+            const result = await orchestrateAndCollect(prompt, { origin: 'telegram', chatId: chat.id, requestId: submitRequestId, _skipInsert: true });
             clearInterval(typingInterval);
             if (statusUpdateTimer) {
                 clearTimeout(statusUpdateTimer);
@@ -430,7 +438,7 @@ async function _initTelegramInner() {
             if (toolHandler)
                 removeBroadcastListener(toolHandler);
             if (statusMsgId) {
-                ctx.api.deleteMessage(ctx.chat.id, statusMsgId).catch(() => { });
+                ctx.api.deleteMessage(chat.id, statusMsgId).catch(() => { });
             }
             const html = markdownToTelegramHtml(result);
             const chunks = chunkTelegramMessage(html);
@@ -442,7 +450,7 @@ async function _initTelegramInner() {
                     await ctx.reply(chunk.replace(/<[^>]+>/g, ''));
                 }
             }
-            console.log(`[tg:out] ${ctx.chat.id}: ${result.slice(0, 80)}`);
+            console.log(`[tg:out] ${chat.id}: ${result.slice(0, 80)}`);
         }
         catch (err) {
             clearInterval(typingInterval);
@@ -453,13 +461,15 @@ async function _initTelegramInner() {
             if (toolHandler)
                 removeBroadcastListener(toolHandler);
             if (statusMsgId) {
-                ctx.api.deleteMessage(ctx.chat.id, statusMsgId).catch(() => { });
+                ctx.api.deleteMessage(chat.id, statusMsgId).catch(() => { });
             }
             console.error('[tg:error]', err);
             await ctx.reply(`❌ Error: ${err.message}`);
         }
     }
     bot.on('message:text', async (ctx) => {
+        if (!ctx.chat)
+            return;
         markChatActive(ctx.chat.id, ctx);
         let text = ctx.message.text;
         if (botUsername) {
@@ -496,7 +506,7 @@ async function _initTelegramInner() {
             }
             return;
         }
-        console.log(`[tg:in] ${ctx.chat.id}: ${text.slice(0, 80)}`);
+        console.log(`[tg:in] ${ctx.chat?.id}: ${text.slice(0, 80)}`);
         // Reset intent: use submitMessage gateway for consistency
         if (isResetIntent(text)) {
             const result = submitMessage(text, { origin: 'telegram' });
@@ -514,14 +524,14 @@ async function _initTelegramInner() {
         const photos = ctx.message.photo;
         const largest = photos[photos.length - 1];
         const caption = ctx.message.caption || '';
-        console.log(`[tg:photo] ${ctx.chat.id}: fileId=${largest.file_id.slice(0, 20)}... caption=${caption.slice(0, 40)}`);
+        console.log(`[tg:photo] ${ctx.chat?.id}: fileId=${largest.file_id.slice(0, 20)}... caption=${caption.slice(0, 40)}`);
         try {
-            const dlResult = await downloadTelegramFile(largest.file_id, settings.telegram.token, {
+            const dlResult = await downloadTelegramFile(largest.file_id, settings["telegram"].token, stripUndefined({
                 kind: 'photo',
                 maxBytes: TELEGRAM_DOWNLOAD_LIMITS.photo,
                 fileSize: largest.file_size,
-            });
-            const filePath = saveUpload(dlResult.buffer, `photo${dlResult.ext}`);
+            }));
+            const filePath = saveUpload(dlResult["buffer"], `photo${dlResult["ext"]}`);
             const prompt = buildMediaPrompt(filePath, caption);
             tgOrchestrate(ctx, prompt, `${t('tg.imageCaption', { caption }, currentLocale())}`);
         }
@@ -533,14 +543,14 @@ async function _initTelegramInner() {
     bot.on('message:document', async (ctx) => {
         const doc = ctx.message.document;
         const caption = ctx.message.caption || '';
-        console.log(`[tg:doc] ${ctx.chat.id}: ${doc.file_name} (${doc.file_size} bytes)`);
+        console.log(`[tg:doc] ${ctx.chat?.id}: ${doc.file_name} (${doc.file_size} bytes)`);
         try {
-            const dlResult = await downloadTelegramFile(doc.file_id, settings.telegram.token, {
+            const dlResult = await downloadTelegramFile(doc.file_id, settings["telegram"].token, stripUndefined({
                 kind: 'document',
                 maxBytes: TELEGRAM_DOWNLOAD_LIMITS.document,
                 fileSize: doc.file_size,
-            });
-            const filePath = saveUpload(dlResult.buffer, doc.file_name || 'document');
+            }));
+            const filePath = saveUpload(dlResult["buffer"], doc.file_name || 'document');
             const prompt = buildMediaPrompt(filePath, caption);
             tgOrchestrate(ctx, prompt, `[📎 ${doc.file_name || 'file'}] ${caption}`);
         }
@@ -551,7 +561,7 @@ async function _initTelegramInner() {
     });
     bot.on('message:voice', (ctx) => handleVoice(ctx, currentLocale, tgOrchestrate));
     // ─── Global Forwarding: non-Telegram responses → Telegram ───
-    if (settings.telegram?.forwardAll !== false) {
+    if (settings["telegram"]?.forwardAll !== false) {
         attachTelegramForwarder(bot);
     }
     void syncTelegramCommands(bot).catch((e) => {