@hedeqiang/dsh-nl2sql 0.14.3 → 0.14.5

package/CHANGELOG.md

@@ -5,6 +5,16 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+## [0.14.5] - 2026-11-13
+
+### Changed
+- **Data health settings** are laid out like the Settings page: two groups (Data freshness, Data quality patrol) with switches and one explanation per row; a group's fields are hidden while it is off. With freshness off, its table and events are no longer shown on the Data health page either — just a note and the switch.
+
+## [0.14.4] - 2026-11-13
+
+### Added
+- Data freshness can be switched off, or hidden from the page only (**Manage → Data health → Settings**). When off, nothing is shown under results or in Schema, no scheduled checks run and the agent's `nl2sql_freshness` tool reports that it is off; "hide on page" keeps checks and notifications but removes the warning bars and the Schema panel. The Data health page keeps showing the data either way.
+
 ## [0.14.3] - 2026-11-13
 
 ### Changed
@@ -159,7 +169,9 @@ These features are tested with local databases and fake IM / Lark servers; real
 
 - Redesigned UI; Lark push (Markdown and native charts); access control, feedback loop, dashboard global filters; PostgreSQL / Elasticsearch, SSH tunnels, privacy settings, automatic overviews, scheduled reports; semantic layer, ER graph, scan guard, history and audit, dashboards; first version.
 
-[Unreleased]: https://github.com/hedeqiang/dsh-nl2sql/compare/v0.14.3...HEAD
+[Unreleased]: https://github.com/hedeqiang/dsh-nl2sql/compare/v0.14.5...HEAD
+[0.14.5]: https://github.com/hedeqiang/dsh-nl2sql/compare/v0.14.4...v0.14.5
+[0.14.4]: https://github.com/hedeqiang/dsh-nl2sql/compare/v0.14.3...v0.14.4
 [0.14.3]: https://github.com/hedeqiang/dsh-nl2sql/compare/v0.14.2...v0.14.3
 [0.14.2]: https://github.com/hedeqiang/dsh-nl2sql/compare/v0.14.1...v0.14.2
 [0.14.1]: https://github.com/hedeqiang/dsh-nl2sql/compare/v0.14.0...v0.14.1

package/lib/client.js

@@ -17,6 +17,20 @@ window.__ModuleLoader__.load({
     // ------------------------------------------------------------ locale
 
     const zh = {
+      'fq.admin.fOffNote': "数据新鲜度已关闭：不检查、不推送，页面上也不显示。需要时在下方「设置」中开启。",
+      'fq.set.gFresh': "数据新鲜度",
+      'fq.set.gQuality': "数据质量巡检",
+      'fq.set.fEnabledShort': "启用",
+      'fq.set.fEnabledHint': "定时检查各表最新数据时间，滞后时推送通知；Agent 回答「今天 / 昨天」等近期数据前会先检查。关闭后以上全部停止，页面上也不再显示。",
+      'fq.set.showShort': "在页面上显示",
+      'fq.set.showHint': "查询结果下方的「数据滞后」提示和表结构页的新鲜度面板。隐藏后仍会定时检查和推送通知。",
+      'fq.set.staleHint': "超过这个时长没有新数据即视为滞后；每张表可在上方表格单独设置，0 表示不监控。",
+      'fq.set.fChannelHint': "每次滞后只推送一次，恢复时再推送一次。",
+      'fq.set.qEnabledHint': "每天定时检查空值、重复键、异常值、未来时间与负值，并给出健康分。",
+      'fq.set.on': "已开启",
+      'fq.set.off': "已关闭",
+      'fq.set.shown': "显示",
+      'fq.set.hidden': "已隐藏",
       'mcp.client.claudeCode': 'Claude Code', 'mcp.client.cline': 'Cline', 'mcp.client.windsurf': 'Windsurf', 'mcp.client.codex': 'Codex CLI', 'mcp.client.gemini': 'Gemini CLI', 'mcp.client.zed': 'Zed', 'mcp.client.continue': 'Continue',
       'mcp.where.claudeCode': '在终端运行（HTTP 直连；下方为 stdio 桥接写法）。', 'mcp.where.cline': '写入 cline_mcp_settings.json（Cline 面板 → MCP Servers → Configure）。', 'mcp.where.windsurf': '写入 Windsurf 的 mcp_config.json（Cascade → MCP → 打开配置文件）。', 'mcp.where.codex': '写入 ~/.codex/config.toml（或项目的 .codex/config.toml）。', 'mcp.where.gemini': '写入 ~/.gemini/settings.json 或项目的 .gemini/settings.json。', 'mcp.where.zed': '写入 Zed 的 settings.json。', 'mcp.where.continue': '保存为工作区 .continue/mcpServers/nl2sql.yaml。',
       'mcp.test': '测试连接', 'mcp.testOk': '连接正常：发现 {n} 个工具。', 'mcp.testFail': '连接失败：{error}', 'mcp.testFailSteps': '连接测试未通过：',
@@ -80,7 +94,6 @@ window.__ModuleLoader__.load({
       "fq.admin.qOff": "每日质量巡检已关闭",
       "fq.admin.noDs": "请先添加数据源",
       "fq.set.title": "设置",
-      "fq.set.fEnabled": "定时检查数据新鲜度",
       "fq.set.qEnabled": "每日数据质量巡检",
       "fq.set.interval": "新鲜度检查间隔（分钟）",
       "fq.set.time": "质量巡检时间",
@@ -89,7 +102,6 @@ window.__ModuleLoader__.load({
       "fq.set.fChannel": "数据延迟通知渠道",
       "fq.set.qChannel": "健康分下降通知渠道",
       "fq.set.noPush": "不推送",
-      "fq.set.hint": "每张表的阈值可在上方表格中单独设置（0 表示不监控）；延迟通知每个滞后周期只推送一次，恢复时再推送一次。",
       "fq.saved": "已保存",
       'pro.close': '关闭', 'pro.sendNow': '立即推送', 'pro.sent': '已推送', 'pro.deleteConfirm': '删除「{name}」？', 'pro.weekday': '星期',
       'pro.wd.0': '周日', 'pro.wd.1': '周一', 'pro.wd.2': '周二', 'pro.wd.3': '周三', 'pro.wd.4': '周四', 'pro.wd.5': '周五', 'pro.wd.6': '周六',
@@ -1178,6 +1190,20 @@ window.__ModuleLoader__.load({
       'policy.tablesLabel': '可访问的表',
     }
     const en = {
+      'fq.admin.fOffNote': "Data freshness is off: no checks, no notifications, nothing shown on the page. Turn it on in Settings below.",
+      'fq.set.gFresh': "Data freshness",
+      'fq.set.gQuality': "Data quality patrol",
+      'fq.set.fEnabledShort': "Enabled",
+      'fq.set.fEnabledHint': "Checks the latest timestamp of every table on a schedule and notifies when data stops updating; the agent checks it before answering about recent periods. When off, all of this stops and nothing is shown on the page.",
+      'fq.set.showShort': "Show on the page",
+      'fq.set.showHint': "Stale-data bars under results and the freshness panel in Schema. Checks and notifications keep running when hidden.",
+      'fq.set.staleHint': "Data older than this counts as stale; set per-table thresholds in the table above (0 = not monitored).",
+      'fq.set.fChannelHint': "One notification per stale episode, and one when it recovers.",
+      'fq.set.qEnabledHint': "Daily check of null rates, duplicate keys, outliers, future timestamps and negative amounts, with a health score.",
+      'fq.set.on': "On",
+      'fq.set.off': "Off",
+      'fq.set.shown': "Shown",
+      'fq.set.hidden': "Hidden",
       'mcp.client.claudeCode': 'Claude Code', 'mcp.client.cline': 'Cline', 'mcp.client.windsurf': 'Windsurf', 'mcp.client.codex': 'Codex CLI', 'mcp.client.gemini': 'Gemini CLI', 'mcp.client.zed': 'Zed', 'mcp.client.continue': 'Continue',
       'mcp.where.claudeCode': 'Run in a terminal (HTTP; the stdio bridge variant is below).', 'mcp.where.cline': 'Add to cline_mcp_settings.json (Cline panel → MCP Servers → Configure).', 'mcp.where.windsurf': 'Add to Windsurf\'s mcp_config.json (Cascade → MCP → open config file).', 'mcp.where.codex': 'Add to ~/.codex/config.toml (or the project\'s .codex/config.toml).', 'mcp.where.gemini': 'Add to ~/.gemini/settings.json or the project\'s .gemini/settings.json.', 'mcp.where.zed': 'Add to Zed\'s settings.json.', 'mcp.where.continue': 'Save as .continue/mcpServers/nl2sql.yaml in the workspace.',
       'mcp.test': 'Test connection', 'mcp.testOk': 'Connected: {n} tools discovered.', 'mcp.testFail': 'Connection failed: {error}', 'mcp.testFailSteps': 'Connection test failed:',
@@ -1241,7 +1267,6 @@ window.__ModuleLoader__.load({
       "fq.admin.qOff": "Daily quality patrol is off",
       "fq.admin.noDs": "Add a data source first",
       "fq.set.title": "Settings",
-      "fq.set.fEnabled": "Check data freshness on a schedule",
       "fq.set.qEnabled": "Daily data quality patrol",
       "fq.set.interval": "Freshness check interval (min)",
       "fq.set.time": "Quality patrol time",
@@ -1250,7 +1275,6 @@ window.__ModuleLoader__.load({
       "fq.set.fChannel": "Delay notification channel",
       "fq.set.qChannel": "Score drop notification channel",
       "fq.set.noPush": "Do not push",
-      "fq.set.hint": "Per-table thresholds can be set in the table above (0 = not monitored). A delay is pushed once per stale episode, and once more when it recovers.",
       "fq.saved": "Saved",
       'pro.close': 'Close', 'pro.sendNow': 'Send now', 'pro.sent': 'Sent', 'pro.deleteConfirm': 'Delete "{name}"?', 'pro.weekday': 'Weekday',
       'pro.wd.0': 'Sunday', 'pro.wd.1': 'Monday', 'pro.wd.2': 'Tuesday', 'pro.wd.3': 'Wednesday', 'pro.wd.4': 'Thursday', 'pro.wd.5': 'Friday', 'pro.wd.6': 'Saturday',
@@ -2367,6 +2391,9 @@ window.__ModuleLoader__.load({
 .n2s-mcp-steps{margin:6px 0 0;padding-left:18px;font-size:12.5px}
 .n2s-mcp-log .n2s-select{max-width:200px}
 .n2s-mcp-logtable td{vertical-align:middle}
+.n2s-fq-settings{padding-top:6px}
+.n2s-fq-setgroup{margin:14px 0 2px;font-size:12.5px;font-weight:600;color:var(--n2s-muted);letter-spacing:.02em}
+.n2s-fq-setgroup:first-child{margin-top:4px}
 /* ---- dashboard v2 ---- */
 .n2s-srcbadge{display:inline-flex;align-items:center;gap:3px;max-width:160px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;flex:none}
 .n2s-seg.small button{height:26px;padding:0 10px;font-size:12px}
@@ -6630,19 +6657,21 @@ window.__ModuleLoader__.load({
           const key = `${datasourceId}\u0000${sql ?? ''}`
           const hit = map.get(key)
           if (hit && Date.now() - hit.at < TTL) return hit.promise
-          const promise = call('freshnessFor', { datasourceId, ...(sql ? { sql } : {}) })
+          const promise = call('freshnessFor', { datasourceId, panel: true, ...(sql ? { sql } : {}) })
           map.set(key, { at: Date.now(), promise })
           promise.catch(() => map.delete(key))
           return promise
         },
         async refresh(datasourceId) {
-          const v = await call('freshnessFor', { datasourceId, refresh: true })
+          const v = await call('freshnessFor', { datasourceId, refresh: true, panel: true })
           for (const k of [...map.keys()]) if (k.startsWith(`${datasourceId}\u0000`)) map.delete(k)
           map.set(`${datasourceId}\u0000`, { at: Date.now(), promise: Promise.resolve(v) })
           rev++
           for (const f of subs) f()
           return v
         },
+        /** Drop everything (e.g. after the show / enable settings change) and re-render subscribers. */
+        reset() { map.clear(); rev++; for (const f of subs) f() },
         subscribe(f) { subs.add(f); return () => subs.delete(f) },
         rev: () => rev,
       }
@@ -6691,6 +6720,7 @@ window.__ModuleLoader__.load({
         fqCache.get(dsId, sql).then(v => alive && setView(v), () => {})
         return () => { alive = false }
       }, [dsId, sql, rev])
+      if (view?.disabled) return null
       const stale = (view?.tables ?? []).filter(x => x.stale)
       if (!stale.length) return null
       return h('div', { className: 'n2s-fq-bar', role: 'status' },
@@ -6719,7 +6749,7 @@ window.__ModuleLoader__.load({
         return () => { alive = false }
       }, [ds?.id, rev])
       const v = state.value
-      if (!ds || state.error || !v || !v.tables?.length) return null
+      if (!ds || state.error || !v || v.disabled || !v.tables?.length) return null
       const stale = v.tables.filter(x => x.stale).length
       const warn = v.tables.filter(x => x.status === 'warn').length
       const expanded = open ?? stale > 0
@@ -6786,28 +6816,35 @@ window.__ModuleLoader__.load({
           const { overrides: _o, ...freshness } = form.freshness
           const out = await call('saveHealthSettings', { freshness: { ...freshness, intervalMin: Number(freshness.intervalMin), staleHours: Number(freshness.staleHours), channelId: freshness.channelId || null }, quality: { ...form.quality, dropPoints: Number(form.quality.dropPoints), channelId: form.quality.channelId || null } })
           setForm(structuredClone(out))
+          fqCache.reset()
           notify(t('fq.saved'), 'ok')
           onSaved?.()
         } catch (e) { notifyError(e) }
       })
-      return h('div', { className: 'n2s-card' },
-        h('div', { className: 'n2s-form' },
-          h('label', { className: 'n2s-check' }, h('input', { type: 'checkbox', checked: Boolean(form.freshness.enabled), onChange: e => setF('enabled', e.target.checked) }), t('fq.set.fEnabled')),
-          h('label', { className: 'n2s-check' }, h('input', { type: 'checkbox', checked: Boolean(form.quality.enabled), onChange: e => setQ('enabled', e.target.checked) }), t('fq.set.qEnabled')),
-          h('label', { className: 'n2s-field' }, h('span', null, t('fq.set.interval')), h('input', { className: 'n2s-input', type: 'number', min: 5, max: 1440, value: form.freshness.intervalMin, onChange: e => setF('intervalMin', e.target.value) })),
-          h('label', { className: 'n2s-field' }, h('span', null, t('fq.set.time')), h('input', { className: 'n2s-input', type: 'time', value: form.quality.time, onChange: e => setQ('time', e.target.value) })),
-          h('label', { className: 'n2s-field' }, h('span', null, t('fq.set.staleHours')), h('input', { className: 'n2s-input', type: 'number', min: 0.25, step: 0.25, value: form.freshness.staleHours, onChange: e => setF('staleHours', e.target.value) })),
-          h('label', { className: 'n2s-field' }, h('span', null, t('fq.set.drop')), h('input', { className: 'n2s-input', type: 'number', min: 1, max: 100, value: form.quality.dropPoints, onChange: e => setQ('dropPoints', e.target.value) })),
-          h('div', { className: 'n2s-field' }, h('label', { htmlFor: 'n2s-fq-fch', className: 'n2s-flabel' }, t('fq.set.fChannel')), h(ChannelPicker, { t, id: 'n2s-fq-fch', value: form.freshness.channelId ?? '', noneLabel: t('fq.set.noPush'), onChange: v => setF('channelId', v) })),
-          h('div', { className: 'n2s-field' }, h('label', { htmlFor: 'n2s-fq-qch', className: 'n2s-flabel' }, t('fq.set.qChannel')), h(ChannelPicker, { t, id: 'n2s-fq-qch', value: form.quality.channelId ?? '', noneLabel: t('fq.set.noPush'), onChange: v => setQ('channelId', v) }))),
-        h('div', { className: 'n2s-faint n2s-small', style: { marginTop: 10 } }, t('fq.set.hint')),
-        h('div', { className: 'n2s-row', style: { marginTop: 12, justifyContent: 'flex-end' } },
+      const fOn = Boolean(form.freshness.enabled)
+      const qOn = Boolean(form.quality.enabled)
+      const sw = (checked, onChange, label, disabled) => h('label', { className: 'n2s-switch' }, h('input', { type: 'checkbox', role: 'switch', checked, disabled, 'aria-label': label, onChange: e => onChange(e.target.checked) }), h('span', null, label))
+      const num = (id, value, onChange, attrs) => h('input', { id, className: 'n2s-input', type: 'number', style: { maxWidth: 160 }, value, onChange: e => onChange(e.target.value), ...attrs })
+      const picker = (id, value, onChange) => h('div', { style: { maxWidth: 360 } }, h(ChannelPicker, { t, id, value: value ?? '', noneLabel: t('fq.set.noPush'), onChange }))
+      return h('div', { className: 'n2s-card n2s-fq-settings' },
+        h('div', { className: 'n2s-fq-setgroup' }, t('fq.set.gFresh')),
+        h(SettingRow, { label: t('fq.set.fEnabledShort'), hint: t('fq.set.fEnabledHint') }, sw(fOn, v => setF('enabled', v), fOn ? t('fq.set.on') : t('fq.set.off'))),
+        fOn && h(SettingRow, { label: t('fq.set.showShort'), hint: t('fq.set.showHint') }, sw(form.freshness.showInUi !== false, v => setF('showInUi', v), form.freshness.showInUi !== false ? t('fq.set.shown') : t('fq.set.hidden'))),
+        fOn && h(SettingRow, { label: t('fq.set.interval'), htmlFor: 'n2s-fq-int' }, num('n2s-fq-int', form.freshness.intervalMin, v => setF('intervalMin', v), { min: 5, max: 1440 })),
+        fOn && h(SettingRow, { label: t('fq.set.staleHours'), htmlFor: 'n2s-fq-stale', hint: t('fq.set.staleHint') }, num('n2s-fq-stale', form.freshness.staleHours, v => setF('staleHours', v), { min: 0.25, step: 0.25 })),
+        fOn && h(SettingRow, { label: t('fq.set.fChannel'), htmlFor: 'n2s-fq-fch', hint: t('fq.set.fChannelHint') }, picker('n2s-fq-fch', form.freshness.channelId, v => setF('channelId', v))),
+        h('div', { className: 'n2s-fq-setgroup' }, t('fq.set.gQuality')),
+        h(SettingRow, { label: t('fq.set.qEnabled'), hint: t('fq.set.qEnabledHint') }, sw(qOn, v => setQ('enabled', v), qOn ? t('fq.set.on') : t('fq.set.off'))),
+        qOn && h(SettingRow, { label: t('fq.set.time'), htmlFor: 'n2s-fq-time' }, h('input', { id: 'n2s-fq-time', className: 'n2s-input', type: 'time', style: { maxWidth: 160 }, value: form.quality.time, onChange: e => setQ('time', e.target.value) })),
+        qOn && h(SettingRow, { label: t('fq.set.qChannel'), htmlFor: 'n2s-fq-qch' }, picker('n2s-fq-qch', form.quality.channelId, v => setQ('channelId', v))),
+        qOn && form.quality.channelId && h(SettingRow, { label: t('fq.set.drop'), htmlFor: 'n2s-fq-drop' }, num('n2s-fq-drop', form.quality.dropPoints, v => setQ('dropPoints', v), { min: 1, max: 100 })),
+        h('div', { className: 'n2s-row', style: { marginTop: 14, justifyContent: 'flex-end' } },
           h('button', { type: 'button', className: 'n2s-btn primary', disabled: busy, onClick: save }, busy ? h('span', { className: 'n2s-spin' }) : null, t('ds.save'))))
     }
 
     function HealthFreshnessTable({ t, dsId }) {
       const rev = useFqRev()
-      const fr = useAsync(() => (dsId ? fqCache.get(dsId) : null), [dsId, rev])
+      const fr = useAsync(() => (dsId ? call('freshnessFor', { datasourceId: dsId }) : null), [dsId, rev])
       const settings = useAsync(() => call('healthSettings'), [dsId, rev])
       const events = useAsync(() => (dsId ? call('freshnessEvents', { datasourceId: dsId, limit: 10 }) : []), [dsId, rev])
       const [busy, setBusy] = useState(false)
@@ -6898,7 +6935,10 @@ window.__ModuleLoader__.load({
           ' · ',
           status.value.quality.enabled ? fmt(t, 'fq.admin.nextQ', { time: status.value.quality.time }) : t('fq.admin.qOff')),
         !dsId ? h('div', { className: 'n2s-empty' }, h('h3', null, t('fq.admin.noDs'))) : h(React.Fragment, null,
-          h(HealthFreshnessTable, { key: `f-${dsId}`, t, dsId }),
+          // When freshness is turned off, its table and events are not shown (and not queried).
+          status.value && !status.value.freshness.enabled
+            ? h('div', { className: 'n2s-notice', style: { marginBottom: 6 } }, t('fq.admin.fOffNote'))
+            : h(HealthFreshnessTable, { key: `f-${dsId}`, t, dsId }),
           h(HealthQuality, { key: `q-${dsId}`, t, dsId })),
         h('div', { className: 'n2s-setsub' }, t('fq.set.title')),
         h(HealthSettings, { t, onSaved: () => status.reload() }))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hedeqiang/dsh-nl2sql",
-  "version": "0.14.3",
+  "version": "0.14.5",
   "description": "Ask MySQL, PostgreSQL, Elasticsearch and CSV/Excel in plain language inside DeepSeek Harness: charts, dashboards, alerts, and IM push and bots for Lark/Feishu, Telegram, WeCom and DingTalk.",
   "type": "module",
   "bin": {

package/service/freshness.js

@@ -19,7 +19,8 @@ import { UserError, lastDailySlot, newId } from './shared.js'
 
 // ------------------------------------------------------------------ constants
 
-export const FRESHNESS_DEFAULTS = { enabled: true, intervalMin: 30, staleHours: 24, overrides: {}, channelId: null }
+// enabled: scheduled checks + notifications + the agent tool; showInUi: warning bars under results and the schema panel.
+export const FRESHNESS_DEFAULTS = { enabled: true, showInUi: true, intervalMin: 30, staleHours: 24, overrides: {}, channelId: null }
 export const QUALITY_DEFAULTS = { enabled: false, time: '06:30', channelId: null, dropPoints: 10, maxTableRows: 5000000, maxTables: 60 }
 const DATE_TYPES = new Set(['date', 'datetime', 'timestamp', 'timestamptz'])
 const NUM_TYPES = new Set(['tinyint', 'smallint', 'mediumint', 'int', 'integer', 'bigint', 'decimal', 'numeric', 'float', 'double', 'real'])
@@ -271,6 +272,7 @@ export const methods = {
     if (freshness) {
       const s = this.freshnessState().settings
       if (freshness.enabled !== undefined) s.enabled = Boolean(freshness.enabled)
+      if (freshness.showInUi !== undefined) s.showInUi = Boolean(freshness.showInUi)
       if (freshness.intervalMin !== undefined) s.intervalMin = Math.round(intIn(freshness.intervalMin, 5, 1440, 'intervalMin'))
       if (freshness.staleHours !== undefined) s.staleHours = intIn(freshness.staleHours, 0.25, 24 * 90, 'staleHours')
       if (freshness.channelId !== undefined) s.channelId = channel(freshness.channelId)
@@ -422,9 +424,12 @@ export const methods = {
   },
 
   /** RPC: stored freshness (computed on first use or when refresh); `sql` narrows to referenced tables. */
-  async freshnessFor({ datasourceId, refresh = false, sql } = {}) {
+  async freshnessFor({ datasourceId, refresh = false, sql, panel = false } = {}) {
     const ds = this.requireDatasource(datasourceId ?? this.state.current)
     const f = this.freshnessState()
+    // Page panels (result bars, schema panel) ask with panel: true; when the feature or its
+    // page display is off they get nothing and no query runs.
+    if (panel && (!f.settings.enabled || f.settings.showInUi === false)) return { datasourceId: ds.id, disabled: true, tables: [] }
     let store = f[ds.id]
     if (refresh || !store) {
       if (refresh) store = await this.withJobLock(`freshness:${ds.id}`, () => this.refreshFreshness(ds))
@@ -737,6 +742,7 @@ export const FEATURE = {
       presentCall: (args) => ({ card: 'generic', title: args?.tables?.length ? `数据新鲜度 ${args.tables.join(', ')}` : '数据新鲜度', kind: 'read' }),
       execute: async (args, exec) => {
         try {
+          if (!service.freshnessState().settings.enabled) return { disabled: true, message: 'Data freshness checks are turned off by the administrator (Data Q&A → Manage → Data health). Answer without freshness warnings.' }
           return await service.freshnessForSession({ sessionId: exec?.agent?.id, datasource: args?.datasource, tables: args?.tables })
         } catch (error) {
           throw error instanceof UserError ? new Error(error.message) : error