@jsonstudio/llms 0.6.1164 → 0.6.1354

package/dist/filters/special/request-tool-list-filter.js

@@ -15,6 +15,60 @@ function getEnvServers() {
         return [];
     return raw.split(',').map(s => s.trim()).filter(Boolean);
 }
+function extractMcpServerLabelsFromOutput(output) {
+    const found = [];
+    const add = (v) => {
+        if (typeof v === 'string') {
+            const s = v.trim();
+            if (s)
+                found.push(s);
+        }
+    };
+    try {
+        if (Array.isArray(output)) {
+            for (const item of output) {
+                if (typeof item === 'string')
+                    add(item);
+                else if (isObject(item))
+                    add(item.server);
+            }
+            return found;
+        }
+        if (!isObject(output))
+            return found;
+        // Common aggregator shapes:
+        // - { servers: ["context7", ...] }
+        // - { resources: [{ server: "..." }, ...] }
+        // - { resourceTemplates: [{ server: "..." }, ...] }
+        const servers = output.servers;
+        if (Array.isArray(servers)) {
+            for (const s of servers)
+                add(s);
+        }
+        const resources = output.resources;
+        if (Array.isArray(resources)) {
+            for (const r of resources) {
+                if (!isObject(r))
+                    continue;
+                add(r.server);
+                add(r.source?.server);
+            }
+        }
+        const templates = output.resourceTemplates;
+        if (Array.isArray(templates)) {
+            for (const t of templates) {
+                if (!isObject(t))
+                    continue;
+                add(t.server);
+                add(t.source?.server);
+            }
+        }
+    }
+    catch {
+        // best-effort
+    }
+    return found;
+}
 function collectServersFromMessages(messages) {
     const out = new Set();
     try {
@@ -22,47 +76,103 @@ function collectServersFromMessages(messages) {
             if (!m || typeof m !== 'object')
                 continue;
             const role = String(m.role || '').toLowerCase();
-            if (role === 'assistant') {
-                const tcs = Array.isArray(m.tool_calls) ? m.tool_calls : [];
-                for (const tc of tcs) {
-                    try {
-                        const fn = tc.function;
-                        const a = fn?.arguments;
-                        let parsed = null;
-                        if (typeof a === 'string') {
-                            try {
-                                parsed = JSON.parse(a);
-                            }
-                            catch { /* ignore */ }
-                        }
-                        else if (a && typeof a === 'object')
-                            parsed = a;
-                        const s = parsed?.server;
-                        if (typeof s === 'string' && s.trim())
-                            out.add(s.trim());
-                    }
-                    catch { /* one tool_call */ }
+            if (role !== 'tool')
+                continue;
+            const c = m.content;
+            if (typeof c !== 'string' || c.trim().length === 0)
+                continue;
+            // IMPORTANT: Only trust tool *results* (not assistant guesses in tool_calls).
+            // Extract server labels only from rcc.tool.v1 envelope outputs for list_mcp_resources.
+            try {
+                const parsed = JSON.parse(c);
+                if (!parsed || typeof parsed !== 'object')
+                    continue;
+                // rcc.tool.v1 envelope: { version, tool:{name}, result:{output} }
+                if (parsed.version === 'rcc.tool.v1' && parsed.tool && typeof parsed.tool.name === 'string') {
+                    const toolName = String(parsed.tool.name).toLowerCase();
+                    if (toolName !== 'list_mcp_resources')
+                        continue;
+                    const output = parsed.result?.output;
+                    for (const s of extractMcpServerLabelsFromOutput(output))
+                        out.add(s);
+                    continue;
                 }
+                // Fallback: some environments may return raw shapes (no envelope).
+                // Only accept when output clearly advertises server labels, not echoed arguments.
+                for (const s of extractMcpServerLabelsFromOutput(parsed.output ?? parsed))
+                    out.add(s);
+            }
+            catch {
+                // ignore parse errors
             }
-            else if (role === 'tool') {
-                const c = m.content;
-                if (typeof c === 'string') {
-                    try {
-                        const obj = JSON.parse(c);
-                        const s1 = obj?.arguments?.server;
-                        if (typeof s1 === 'string' && s1.trim())
-                            out.add(s1.trim());
-                        const s2 = obj?.server;
-                        if (typeof s2 === 'string' && s2.trim())
-                            out.add(s2.trim());
+        }
+    }
+    catch {
+        // ignore errors
+    }
+    return Array.from(out);
+}
+function detectEmptyMcpListFromMessages(messages) {
+    try {
+        for (const m of messages) {
+            if (!m || typeof m !== 'object')
+                continue;
+            const role = String(m.role || '').toLowerCase();
+            if (role !== 'tool')
+                continue;
+            const c = m.content;
+            if (typeof c !== 'string' || c.trim().length === 0)
+                continue;
+            const lowered = c.toLowerCase();
+            // Some clients surface MCP "resources/list" unsupported as a plain error string.
+            if (lowered.includes('-32601') || (lowered.includes('method') && lowered.includes('not found'))) {
+                return true;
+            }
+            try {
+                const parsed = JSON.parse(c);
+                if (!parsed || typeof parsed !== 'object')
+                    continue;
+                // rcc.tool.v1 envelope: { version, tool:{name}, result:{output} }
+                if (parsed.version === 'rcc.tool.v1' && parsed.tool && typeof parsed.tool.name === 'string') {
+                    const toolName = String(parsed.tool.name).toLowerCase();
+                    if (toolName !== 'list_mcp_resources')
+                        continue;
+                    const out = parsed.result?.output;
+                    if (Array.isArray(out) && out.length === 0)
+                        return true;
+                    if (out && typeof out === 'object' && Array.isArray(out.resources) && out.resources.length === 0) {
+                        return true;
+                    }
+                    if (out && typeof out === 'object' && Array.isArray(out.servers) && out.servers.length === 0) {
+                        return true;
                     }
-                    catch { /* ignore */ }
+                    continue;
                 }
+                // Fallback: raw shapes (no envelope).
+                const payload = parsed.output ?? parsed;
+                if (payload && typeof payload === 'object') {
+                    if (Array.isArray(payload.resources) && payload.resources.length === 0)
+                        return true;
+                    if (Array.isArray(payload.servers) && payload.servers.length === 0)
+                        return true;
+                    const err = payload.error ?? parsed.error;
+                    if (err && typeof err === 'object') {
+                        const code = err.code;
+                        const msg = typeof err.message === 'string' ? String(err.message).toLowerCase() : '';
+                        if (code === -32601 || msg.includes('method not found'))
+                            return true;
+                    }
+                }
+            }
+            catch {
+                // ignore parse errors
             }
         }
     }
-    catch { /* ignore */ }
-    return Array.from(out);
+    catch {
+        // ignore errors
+    }
+    return false;
 }
 function ensureFunctionTool(tools, name, description, parameters) {
     const idx = tools.findIndex(t => t && typeof t === 'object' && t.type === 'function' && t.function && t.function.name === name);
@@ -70,13 +180,10 @@ function ensureFunctionTool(tools, name, description, parameters) {
         const cur = tools[idx];
         const fn = (cur.function = cur.function || {});
         fn.name = name;
-        if (typeof fn.description !== 'string')
+        if (typeof fn.description !== 'string' || !String(fn.description).trim())
             fn.description = description;
         fn.parameters = parameters;
     }
-    else {
-        tools.push({ type: 'function', function: { name, description, parameters } });
-    }
 }
 function removeToolByName(tools, name) {
     for (let i = tools.length - 1; i >= 0; i--) {
@@ -98,15 +205,22 @@ export class RequestToolListFilter {
         try {
             const out = JSON.parse(JSON.stringify(input || {}));
             const hadIncomingTools = Array.isArray(out.tools);
-            const tools = hadIncomingTools ? out.tools : [];
+            // IMPORTANT: do not force-inject any tools. If the inbound request didn't include `tools`,
+            // keep it absent.
             if (!hadIncomingTools) {
-                out.tools = tools;
+                return { ok: true, data: out };
+            }
+            const tools = out.tools;
+            const hasMcpTool = Array.isArray(tools) &&
+                tools.some((t) => t && typeof t === 'object' && t.type === 'function' && t.function && typeof t.function.name === 'string' && (t.function.name === 'list_mcp_resources' ||
+                    t.function.name === 'list_mcp_resource_templates' ||
+                    t.function.name === 'read_mcp_resource'));
+            if (!hasMcpTool) {
+                return { ok: true, data: out };
             }
             const mode = envMode();
             if (mode === 'off') {
-                if (!hadIncomingTools && tools.length === 0) {
-                    delete out.tools;
-                }
+                // Explicitly do not mutate tools when disabled.
                 return { ok: true, data: out };
             }
             const messages = Array.isArray(out.messages) ? out.messages : [];
@@ -116,11 +230,21 @@ export class RequestToolListFilter {
             for (const s of collectServersFromMessages(messages))
                 servers.add(s);
             const knownServers = Array.from(servers);
+            const mcpListEmpty = detectEmptyMcpListFromMessages(messages);
+            const formatKnownServers = (list) => {
+                if (!Array.isArray(list) || list.length === 0)
+                    return '';
+                const shown = list.slice(0, 8);
+                const suffix = list.length > shown.length ? ` (+${list.length - shown.length} more)` : '';
+                return `Known MCP servers: ${shown.join(', ')}${suffix}.`;
+            };
+            const mcpServerReminder = 'Note: arguments.server is an MCP server label (NOT a tool name like shell/exec_command/apply_patch).';
+            // IMPORTANT: do not remove tools based on session history. Tool list must remain stable for Gemini/Antigravity.
             // MCP tool schemas
             const listResParams = {
                 type: 'object',
                 properties: {
-                    server: { type: 'string' },
+                    server: knownServers.length > 0 ? { type: 'string', enum: knownServers, minLength: 1 } : { type: 'string', minLength: 1 },
                     filter: { type: 'string' },
                     root: { type: 'string' }
                 },
@@ -130,7 +254,7 @@ export class RequestToolListFilter {
                 type: 'object',
                 properties: {
                     cursor: { type: 'string' },
-                    server: { type: 'string' }
+                    server: knownServers.length > 0 ? { type: 'string', enum: knownServers, minLength: 1 } : { type: 'string', minLength: 1 }
                 },
                 additionalProperties: false
             };
@@ -143,31 +267,41 @@ export class RequestToolListFilter {
                 required: ['server', 'uri'],
                 additionalProperties: false
             };
-            const profileKey = String(ctx?.profile || '').toLowerCase();
-            const endpointKey = String(ctx?.endpoint || '').toLowerCase();
-            const prefersLegacyListDescription = profileKey.includes('anthropic') ||
-                endpointKey.includes('/v1/messages');
-            const listDescription = prefersLegacyListDescription
-                ? 'List resources from an MCP server.'
-                : 'List resources from a given MCP server (arguments.server = server label).';
+            const listDescription = [
+                'List resources exposed by MCP servers.',
+                'Only use this for MCP resources (not MCP tools). Many MCP servers expose tools only; if the result is empty, do not retry.',
+                'If you do not know the MCP server name yet, call this tool with {} once; then reuse the returned server names for subsequent calls.',
+                mcpServerReminder,
+                formatKnownServers(knownServers)
+            ].filter(Boolean).join('\n');
+            const templatesDescription = [
+                'List resource templates exposed by MCP servers.',
+                'Only use this for MCP resources (not MCP tools). If list_mcp_resources returns empty, do not retry.',
+                'If you do not know the MCP server name yet, call list_mcp_resources({}) once first.',
+                mcpServerReminder,
+                formatKnownServers(knownServers)
+            ].filter(Boolean).join('\n');
+            const readDescription = [
+                'Read a specific MCP resource by { server, uri }.',
+                'Only use this for MCP resources (not MCP tools). If list_mcp_resources returns empty, do not retry.',
+                'If you do not know the MCP server name yet, call list_mcp_resources({}) once first.',
+                mcpServerReminder,
+                formatKnownServers(knownServers)
+            ].filter(Boolean).join('\n');
             if (mode === 'all') {
                 ensureFunctionTool(tools, 'list_mcp_resources', listDescription, listResParams);
-                ensureFunctionTool(tools, 'list_mcp_resource_templates', 'List resource templates from MCP servers.', listTplParams);
-                ensureFunctionTool(tools, 'read_mcp_resource', 'Read a specific MCP resource.', readResParamsBase);
+                ensureFunctionTool(tools, 'list_mcp_resource_templates', templatesDescription, listTplParams);
+                ensureFunctionTool(tools, 'read_mcp_resource', readDescription, readResParamsBase);
             }
             else {
                 // phase
                 ensureFunctionTool(tools, 'list_mcp_resources', listDescription, listResParams);
-                ensureFunctionTool(tools, 'list_mcp_resource_templates', 'List resource templates from MCP servers.', listTplParams);
+                ensureFunctionTool(tools, 'list_mcp_resource_templates', templatesDescription, listTplParams);
                 // read is only exposed when we have known servers
                 if (knownServers.length > 0) {
                     const withEnum = JSON.parse(JSON.stringify(readResParamsBase));
                     withEnum.properties.server = { type: 'string', enum: knownServers };
-                    ensureFunctionTool(tools, 'read_mcp_resource', 'Read a specific MCP resource.', withEnum);
-                }
-                else {
-                    // remove any existing read tool to prevent premature exposure
-                    removeToolByName(tools, 'read_mcp_resource');
+                    ensureFunctionTool(tools, 'read_mcp_resource', readDescription, withEnum);
                 }
             }
             out.tools = tools;

package/dist/filters/special/request-tools-normalize.js

@@ -93,7 +93,7 @@ export class RequestOpenAIToolsNormalizeFilter {
                         if ('strict' in item.function)
                             delete item.function.strict;
                     }
-                    catch { }
+                    catch { /* ignore */ }
                     finalTools.push(item);
                 }
             }

package/dist/filters/special/response-tool-text-canonicalize.d.ts

@@ -1,13 +1,10 @@
 import type { Filter, FilterContext, FilterResult, JsonObject } from '../types.js';
 /**
- * Canonicalize assistant textual tool markup into tool_calls (Chat path).
+ * Canonicalize structured tool_calls (Chat path).
  *
- * 行为分两步：
- * 1. 使用 text-markup-normalizer 将纯文本中的工具标记（含 apply_patch）提升为 tool_calls；
- * 2. 再通过 canonicalizeChatResponseTools 统一 tool_calls 形态（content=null、arguments 为字符串等）。
- *
- * 这样可以保证：无论上游 provider 是哪种协议，只要在文本中输出符合规范的 apply_patch / shell 等片段，
- * 在响应侧都会被折叠为标准的 tool_calls，供后续工具治理与客户端透明消费。
+ * 注意：该 filter 不会将纯文本中的“工具标记”提升为 tool_calls。
+ * 在 processMode=chat 的严格路径下，工具调用应以结构化 tool_calls 形态出现；
+ * 若上游以文本形式输出工具调用，应作为问题暴露给上层（而不是在此处兜底转换）。
  */
 export declare class ResponseToolTextCanonicalizeFilter implements Filter<JsonObject> {
     readonly name = "response_tool_text_canonicalize";

package/dist/filters/special/response-tool-text-canonicalize.js

@@ -1,44 +1,16 @@
+import { canonicalizeChatResponseTools } from '../../conversion/shared/tool-canonicalizer.js';
 /**
- * Canonicalize assistant textual tool markup into tool_calls (Chat path).
+ * Canonicalize structured tool_calls (Chat path).
  *
- * 行为分两步：
- * 1. 使用 text-markup-normalizer 将纯文本中的工具标记（含 apply_patch）提升为 tool_calls；
- * 2. 再通过 canonicalizeChatResponseTools 统一 tool_calls 形态（content=null、arguments 为字符串等）。
- *
- * 这样可以保证：无论上游 provider 是哪种协议，只要在文本中输出符合规范的 apply_patch / shell 等片段，
- * 在响应侧都会被折叠为标准的 tool_calls，供后续工具治理与客户端透明消费。
+ * 注意：该 filter 不会将纯文本中的“工具标记”提升为 tool_calls。
+ * 在 processMode=chat 的严格路径下，工具调用应以结构化 tool_calls 形态出现；
+ * 若上游以文本形式输出工具调用，应作为问题暴露给上层（而不是在此处兜底转换）。
  */
 export class ResponseToolTextCanonicalizeFilter {
     name = 'response_tool_text_canonicalize';
     stage = 'response_pre';
     apply(input) {
-        try {
-            // eslint-disable-next-line @typescript-eslint/no-var-requires
-            const { canonicalizeChatResponseTools } = require('../../conversion/shared/tool-canonicalizer.js');
-            // eslint-disable-next-line @typescript-eslint/no-var-requires
-            const { normalizeAssistantTextToToolCalls } = require('../../conversion/shared/text-markup-normalizer.js');
-            // 先在文本层面抽取工具调用（apply_patch / shell / MCP 等）
-            let working = input && typeof input === 'object' ? JSON.parse(JSON.stringify(input)) : input;
-            try {
-                const choices = Array.isArray(working?.choices) ? working.choices : [];
-                for (const ch of choices) {
-                    if (!ch || typeof ch !== 'object')
-                        continue;
-                    const msg = ch.message;
-                    if (msg && typeof msg === 'object') {
-                        ch.message = normalizeAssistantTextToToolCalls(msg);
-                    }
-                }
-                working.choices = choices;
-            }
-            catch {
-                // best-effort：文本解析失败时保留原始 payload
-            }
-            const out = canonicalizeChatResponseTools(working);
-            return { ok: true, data: out };
-        }
-        catch {
-            return { ok: true, data: input };
-        }
+        const out = canonicalizeChatResponseTools(input);
+        return { ok: true, data: out };
     }
 }

package/dist/filters/special/tool-filter-hooks.js

@@ -110,6 +110,46 @@ function isMcpToolName(name) {
 function deriveMcpSessionState(messages) {
     let listRequested = false;
     let listEmpty = false;
+    const extractToolContentText = (content) => {
+        if (typeof content === 'string')
+            return content;
+        if (!Array.isArray(content))
+            return '';
+        const parts = [];
+        for (const part of content) {
+            if (!part || typeof part !== 'object')
+                continue;
+            const p = part;
+            if (typeof p.text === 'string' && p.text.trim().length) {
+                parts.push(p.text);
+            }
+        }
+        return parts.join('\n');
+    };
+    const markListEmptyFromPayload = (payload) => {
+        if (!payload || typeof payload !== 'object')
+            return;
+        const out = payload.output ?? payload;
+        if (!out || typeof out !== 'object')
+            return;
+        if (Array.isArray(out.resources) && out.resources.length === 0) {
+            listRequested = true;
+            listEmpty = true;
+        }
+        if (Array.isArray(out.servers) && out.servers.length === 0) {
+            listRequested = true;
+            listEmpty = true;
+        }
+        const err = out.error ?? payload.error;
+        if (err && typeof err === 'object') {
+            const code = err.code;
+            const msg = typeof err.message === 'string' ? String(err.message).toLowerCase() : '';
+            if (code === -32601 || msg.includes('method not found')) {
+                listRequested = true;
+                listEmpty = true;
+            }
+        }
+    };
     try {
         for (const m of messages) {
             if (!m || typeof m !== 'object')
@@ -133,9 +173,18 @@ function deriveMcpSessionState(messages) {
                 }
             }
             // tool 角色消息：检查 rcc.tool.v1 包装的结果是否为空
-            if (role === 'tool' && typeof m.content === 'string') {
+            if (role === 'tool') {
                 try {
-                    const parsed = JSON.parse(m.content);
+                    const rawText = extractToolContentText(m.content);
+                    if (!rawText || rawText.trim().length === 0) {
+                        continue;
+                    }
+                    const lowered = rawText.toLowerCase();
+                    if (lowered.includes('-32601') || (lowered.includes('method') && lowered.includes('not found'))) {
+                        listRequested = true;
+                        listEmpty = true;
+                    }
+                    const parsed = JSON.parse(rawText);
                     if (parsed &&
                         typeof parsed === 'object' &&
                         parsed.version === 'rcc.tool.v1' &&
@@ -155,7 +204,11 @@ function deriveMcpSessionState(messages) {
                                 listEmpty = true;
                             }
                         }
+                        continue;
                     }
+                    // Non-wrapped tool output (common for Codex tool responses).
+                    // If the payload looks like list_mcp_resources output and is empty/unsupported, disable MCP tools for this session.
+                    markListEmptyFromPayload(parsed);
                 }
                 catch {
                     // ignore parse errors
@@ -208,66 +261,9 @@ const mcpToolHook = ctx => {
         }
         return;
     }
-    // 会话内阶段性策略：
-    // 1) 如果 list_mcp_resources 从未在本会话中被请求过 → 仅暴露 list_mcp_resources，过滤 read/templates。
-    // 2) 如果 list_mcp_resources 已请求且结果为空 → 完全过滤所有 MCP 工具。
-    const { listRequested, listEmpty } = deriveMcpSessionState(messages);
-    const next = [];
-    for (const t of tools) {
-        let name = '';
-        try {
-            name =
-                t &&
-                    typeof t === 'object' &&
-                    t.function &&
-                    typeof t.function.name === 'string'
-                    ? String(t.function.name)
-                    : '';
-        }
-        catch {
-            name = '';
-        }
-        const lower = name.toLowerCase();
-        const isMcp = isMcpToolName(name);
-        if (!isMcp) {
-            next.push(t);
-            continue;
-        }
-        if (!listRequested) {
-            // list 未被请求过：保留 list_mcp_resources，其它 MCP 工具全部过滤
-            if (lower === 'list_mcp_resources') {
-                next.push(t);
-                recordDecision({
-                    name,
-                    action: 'allow',
-                    category: 'mcp',
-                    reason: 'mcp_list_exposed_before_first_use',
-                });
-            }
-            else {
-                recordDecision({
-                    name,
-                    action: 'block',
-                    category: 'mcp',
-                    reason: 'mcp_non_list_blocked_until_list_called',
-                });
-            }
-            continue;
-        }
-        if (listEmpty) {
-            // list 已请求且结果为空：完全屏蔽所有 MCP 工具
-            recordDecision({
-                name,
-                action: 'block',
-                category: 'mcp',
-                reason: 'mcp_disabled_for_session_after_empty_list',
-            });
-            continue;
-        }
-        // list 已请求且非空：保留现有行为（交由其它层/配置控制）
-        next.push(t);
-    }
-    ctx.tools = next;
+    // IMPORTANT: Do not mutate MCP tool lists based on session history.
+    // Gemini/Antigravity are sensitive to tool-list drift (history vs current declarations).
+    // We keep the inbound tool list stable and rely on schema/description hints instead.
 };
 const requestHooks = [visionToolHook, mcpToolHook];
 export class ToolFilterHookFilter {

package/dist/guidance/index.js

@@ -158,7 +158,11 @@ function augmentMCP(fn, toolName) {
     const marker = `[Codex MCP Guidance:${toolName}]`;
     const guidance = [
         marker,
-        'Use MCP resources sparingly. Provide only required fields; avoid unnecessary large reads.'
+        'Use MCP resources sparingly. Provide only required fields; avoid unnecessary large reads.',
+        'Do not call MCP resource tools unless you actually need MCP resources (not MCP tools).',
+        'If list_mcp_resources returns an empty list or a "Method not found" error (-32601), do not retry; assume no MCP resources are available in this session.',
+        'If you need MCP resources but do not know the MCP server label, call list_mcp_resources({}) once and reuse the returned server labels.',
+        'Note: arguments.server is an MCP server label (NOT a tool name like shell/exec_command/apply_patch).'
     ].join('\n');
     fn.description = appendOnce(fn.description, guidance, marker);
 }

package/dist/http/sse-response.js

@@ -15,7 +15,7 @@ export function sendNodeSSE(res, stream) {
     try {
         res.write(': ok\n\n');
     }
-    catch { }
+    catch { /* ignore */ }
     stream.on('data', (chunk) => {
         res.write(typeof chunk === 'string' ? chunk : chunk.toString());
     });
@@ -23,7 +23,7 @@ export function sendNodeSSE(res, stream) {
         try {
             res.write(':\n\n');
         }
-        catch { }
+        catch { /* ignore */ }
         res.end();
     });
     stream.on('error', (err) => {
@@ -31,7 +31,7 @@ export function sendNodeSSE(res, stream) {
             res.write(`event: error\n`);
             res.write(`data: ${JSON.stringify({ message: String(err?.message || 'sse_error') })}\n\n`);
         }
-        catch { }
+        catch { /* ignore */ }
         res.end();
     });
 }
@@ -50,7 +50,7 @@ export function sendExpressSSE(res, stream) {
     try {
         res.write(': ok\n\n');
     }
-    catch { }
+    catch { /* ignore */ }
     stream.on('data', (chunk) => res.write(typeof chunk === 'string' ? chunk : chunk.toString()));
     stream.on('end', () => res.end());
     stream.on('error', (err) => {
@@ -58,7 +58,7 @@ export function sendExpressSSE(res, stream) {
             res.write(`event: error\n`);
             res.write(`data: ${JSON.stringify({ message: String(err?.message || 'sse_error') })}\n\n`);
         }
-        catch { }
+        catch { /* ignore */ }
         res.end();
     });
 }
@@ -97,7 +97,7 @@ export function sendSSEOrJSON(resOrReply, payload) {
         try {
             resOrReply.setHeader?.('Content-Type', 'application/json; charset=utf-8');
         }
-        catch { }
+        catch { /* ignore */ }
         return resOrReply.end(jsonTxt);
     }
 }