@v587d/capital-generation 2.15.0 → 2.16.0

package/lib/agents/root-tool-policy.js

@@ -4,12 +4,14 @@
  */
 import { CAPITAL_PRESET_IDS, ROOT_PRESET_ID } from '../preset-ids.js';
 import { readPresetClaim } from '../preset-claim.js';
-/** Outbound tools (search 2 + wind 2 + named sources 9); `ocr` is excluded because only its url form is restricted. */
+/** Outbound tools (search 2 + wind 2 + named sources 11); `ocr` is excluded because only its url form is restricted. */
 export const RETRIEVAL_DENIED_TOOLS = [
     'anysearch_search', 'web_retriever_fetch',
     'wind_docs_announcements', 'wind_docs_news',
     'cls_telegraph', 'wscn_lives', 'cninfo_irm', 'sseinfo_qa',
-    'eastmoney_724', 'eastmoney_stock_news', 'eastmoney_reports', 'sina_reports', 'ths_eps_forecast',
+    'eastmoney_724', 'eastmoney_stock_news', 'eastmoney_reports',
+    'eastmoney_announcements', 'eastmoney_announcement_body',
+    'sina_reports', 'ths_eps_forecast',
 ];
 export const OCR_TOOL_NAME = 'ocr';
 /** Name-level deny cannot express the form distinction; this is a call-level guard. */

package/lib/chart/runtime.d.ts

@@ -4,4 +4,4 @@
  * back to `globalThis.LightweightCharts` — another plugin's copy could silently win. The IIFE
  * returns `{ render, version }`; nothing is attached to globals.
  */
-export declare const CHART_RUNTIME_SOURCE = "\n(function () {\n  'use strict'\n\n  var FALLBACK = {\n    '--dsw-alias-bg-base': '#ffffff',\n    '--dsw-alias-border-l1': 'rgba(0, 0, 0, 0.10)',\n    '--dsw-alias-label-primary': '#1f2328',\n    '--dsw-alias-label-secondary': '#6b7280',\n    '--dsw-alias-brand-primary': '#2563eb',\n    '--dsw-alias-state-error-primary': '#d94a3d',\n    '--dsw-alias-state-success-primary': '#2f9e44'\n  }\n\n  // Hex colors receive alpha; other formats convert to rgba or stay unchanged, never emit invalid CSS.\n  function withAlpha(color, alpha) {\n    var text = String(color || '').trim()\n    var hex = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(text)\n    if (hex) {\n      var expanded = hex[1].length === 3\n        ? '#' + hex[1].split('').map(function (part) { return part + part }).join('')\n        : text\n      return expanded + Math.round(alpha * 255).toString(16).padStart(2, '0')\n    }\n    var rgb = /^rgba?\\(\\s*([^)]*)\\)$/i.exec(text)\n    if (rgb) {\n      var parts = rgb[1].split(/[,\\s/]+/).filter(Boolean)\n      if (parts.length >= 3 && parts.slice(0, 3).every(function (part) { return /^[-+]?\\d*\\.?\\d+%?$/.test(part) })) {\n        return 'rgba(' + parts.slice(0, 3).join(', ') + ', ' + alpha + ')'\n      }\n    }\n    return text\n  }\n\n  // First series uses brand color; later series use a stable palette so one symbol keeps its color.\n  var PALETTE = ['#f59e0b', '#10b981', '#8b5cf6', '#0ea5e9', '#ec4899']\n\n  function readToken(name) {\n    try {\n      var value = getComputedStyle(document.documentElement).getPropertyValue(name)\n      if (value && value.trim().length > 0) return value.trim()\n    } catch (error) {\n      /* Non-browser or unavailable styles fall back to defaults. */\n    }\n    return FALLBACK[name]\n  }\n\n  function resolveColors() {\n    return {\n      bg: readToken('--dsw-alias-bg-base'),\n      grid: readToken('--dsw-alias-border-l1'),\n      text: readToken('--dsw-alias-label-secondary'),\n      strong: readToken('--dsw-alias-label-primary'),\n      brand: readToken('--dsw-alias-brand-primary'),\n      up: readToken('--dsw-alias-state-error-primary'),\n      down: readToken('--dsw-alias-state-success-primary')\n    }\n  }\n\n  function showError(container, message) {\n    container.textContent = ''\n    var box = document.createElement('div')\n    box.setAttribute('data-chart-error', '1')\n    box.style.cssText = 'padding:12px;border:0.5px solid ' + readToken('--dsw-alias-border-l1') + ';border-radius:8px;color:' + readToken('--dsw-alias-label-secondary') + ';font-size:13px;line-height:1.6'\n    box.textContent = message\n    container.appendChild(box)\n  }\n\n  function applyIndexLabels(chart, labels) {\n    function format(time) {\n      var key = String(time)\n      return Object.prototype.hasOwnProperty.call(labels, key) ? labels[key] : key\n    }\n    // Replace both tick and crosshair formatters for category axes or synthetic dates leak through.\n    chart.applyOptions({\n      localization: { timeFormatter: format },\n      timeScale: { tickMarkFormatter: function (time) { return format(time) } }\n    })\n  }\n\n  /** Support both v5 plugin markers and the older series API so markers never disappear silently. */\n  function attachMarkers(anchor, markers, LWC) {\n    if (typeof LWC.createSeriesMarkers === 'function') {\n      LWC.createSeriesMarkers(anchor, markers)\n      return true\n    }\n    if (anchor && typeof anchor.setMarkers === 'function') {\n      anchor.setMarkers(markers)\n      return true\n    }\n    return false\n  }\n\n  function volumePointColor(point, colors) {\n    if (point.direction === 'up') return colors.up\n    if (point.direction === 'down') return colors.down\n    return colors.brand\n  }\n\n  function seriesColor(index, colors) {\n    return index === 0 ? colors.brand : PALETTE[(index - 1) % PALETTE.length]\n  }\n\n  function appendLegend(container, payload, colors) {\n    var items = []\n    if (payload.ohlc && payload.ohlc.label) items.push({ label: payload.ohlc.label, color: colors.up })\n    if (Array.isArray(payload.series)) {\n      payload.series.forEach(function (item, index) {\n        if (item && item.label) items.push({ label: item.label, color: seriesColor(index, colors) })\n      })\n    }\n    if (payload.volume && payload.volume.label) items.push({ label: payload.volume.label, color: colors.brand })\n    if (items.length === 0) return\n\n    var legend = document.createElement('div')\n    legend.setAttribute('data-chart-legend', '1')\n    legend.style.cssText = 'position:absolute;z-index:2;top:8px;left:8px;right:8px;display:flex;flex-wrap:wrap;gap:4px 10px;align-items:center;pointer-events:none;color:' + colors.text + ';font-size:11px;line-height:16px'\n    items.forEach(function (item) {\n      var entry = document.createElement('span')\n      entry.style.cssText = 'display:inline-flex;align-items:center;gap:4px;padding:1px 5px;border-radius:4px;background:' + withAlpha(colors.bg, 0.8)\n      var swatch = document.createElement('span')\n      swatch.style.cssText = 'width:7px;height:7px;border-radius:50%;background:' + item.color + ';flex:none'\n      var label = document.createElement('span')\n      label.textContent = item.label\n      entry.appendChild(swatch)\n      entry.appendChild(label)\n      legend.appendChild(entry)\n    })\n    container.appendChild(legend)\n  }\n\n  function renderCapitalChart(container, payload, library) {\n    if (!container) throw new Error('renderCapitalChart: container is required')\n    if (!payload || typeof payload !== 'object') throw new Error('renderCapitalChart: payload is required')\n    // Use the injected library; never fall back to a global copy owned by another plugin.\n    var LWC = library\n    if (!LWC || typeof LWC.createChart !== 'function') {\n      showError(container, '\u56FE\u8868\u5E93\u672A\u52A0\u8F7D\uFF08\u8C03\u7528\u65B9\u672A\u63D0\u4F9B LightweightCharts\uFF09\u3002')\n      return null\n    }\n\n    var colors = resolveColors()\n    container.textContent = ''\n    if (container.style) container.style.position = 'relative'\n    container.setAttribute('data-chart-id', String(payload.chart_id || ''))\n    container.setAttribute('data-chart-kind', String(payload.kind || ''))\n\n    var chart = LWC.createChart(container, {\n      autoSize: true,\n      // attributionLogo stays enabled for Apache-2.0 attribution.\n      layout: { background: { color: 'transparent' }, textColor: colors.text, fontFamily: 'inherit', attributionLogo: true },\n      grid: { vertLines: { color: colors.grid }, horzLines: { color: colors.grid } },\n      rightPriceScale: { borderColor: colors.grid, entireTextOnly: true },\n      timeScale: { borderColor: colors.grid, rightOffset: 2, barSpacing: 6, minBarSpacing: 0.5 },\n      crosshair: { mode: LWC.CrosshairMode ? LWC.CrosshairMode.Normal : 0 },\n      localization: { locale: 'zh-CN' }\n    })\n\n    if (payload.axis === 'index' && payload.labels) applyIndexLabels(chart, payload.labels)\n\n    var anchor = null\n\n    if (payload.ohlc && Array.isArray(payload.ohlc.data) && payload.ohlc.data.length > 0) {\n      // kind=bar uses BarSeries; other OHLC kinds use CandlestickSeries with the same data contract.\n      var isOhlcBar = payload.kind === 'bar'\n      var candles = chart.addSeries(isOhlcBar ? LWC.BarSeries : LWC.CandlestickSeries, {\n        upColor: colors.up,\n        downColor: colors.down,\n        borderUpColor: colors.up,\n        borderDownColor: colors.down,\n        wickUpColor: colors.up,\n        wickDownColor: colors.down\n      })\n      candles.setData(payload.ohlc.data)\n      anchor = candles\n    }\n\n    if (Array.isArray(payload.series)) {\n      for (var index = 0; index < payload.series.length; index += 1) {\n        var item = payload.series[index]\n        if (!item || !Array.isArray(item.data) || item.data.length === 0) continue\n        var color = seriesColor(index, colors)\n        var options = { title: item.label || '', priceLineVisible: false, lastValueVisible: true }\n        var series = null\n        if (item.type === 'area') {\n          options.lineColor = color\n          options.topColor = withAlpha(color, 0.2)\n          options.bottomColor = withAlpha(color, 0.02)\n          options.lineWidth = 2\n          series = chart.addSeries(LWC.AreaSeries, options)\n        } else if (item.type === 'column') {\n          // Single-value histograms need HistogramSeries; BarSeries would render an empty chart.\n          options.color = color\n          options.base = 0\n          series = chart.addSeries(LWC.HistogramSeries, options)\n        } else {\n          options.color = color\n          options.lineWidth = 2\n          series = chart.addSeries(LWC.LineSeries, options)\n        }\n        series.setData(item.data)\n        if (anchor === null) anchor = series\n      }\n    }\n\n    if (payload.volume && Array.isArray(payload.volume.data) && payload.volume.data.length > 0) {\n      var volume = chart.addSeries(LWC.HistogramSeries, {\n        title: payload.volume.label || '',\n        priceFormat: { type: 'volume' },\n        priceLineVisible: false,\n        lastValueVisible: false\n      }, 1)\n      volume.setData(payload.volume.data.map(function (point) {\n        return { time: point.time, value: point.value, color: volumePointColor(point, colors) }\n      }))\n    }\n\n    if (anchor === null) {\n      showError(container, '\u8FD9\u5F20\u56FE\u6CA1\u6709\u53EF\u6E32\u67D3\u7684\u5E8F\u5217\uFF08payload \u91CC\u65E2\u6CA1\u6709 ohlc \u4E5F\u6CA1\u6709 series\uFF09\u3002')\n      return chart\n    }\n\n    if (Array.isArray(payload.markers) && payload.markers.length > 0) {\n      attachMarkers(anchor, payload.markers.map(function (marker) {\n        return { time: marker.time, position: marker.position, text: marker.text, color: colors.strong, shape: 'circle' }\n      }), LWC)\n    }\n\n    appendLegend(container, payload, colors)\n\n    // Main/volume panes use a 3:1 ratio; a single pane has no second pane object.\n    var panes = typeof chart.panes === 'function' ? chart.panes() : []\n    if (panes.length > 1) {\n      if (typeof panes[0].setStretchFactor === 'function') panes[0].setStretchFactor(3)\n      if (typeof panes[1].setStretchFactor === 'function') panes[1].setStretchFactor(1)\n    }\n\n    chart.timeScale().fitContent()\n    return chart\n  }\n\n  return { render: renderCapitalChart, version: 1 }\n})()\n";
+export declare const CHART_RUNTIME_SOURCE = "\n(function () {\n  'use strict'\n\n  var FALLBACK = {\n    '--dsw-alias-bg-base': '#ffffff',\n    '--dsw-alias-border-l1': 'rgba(0, 0, 0, 0.10)',\n    '--dsw-alias-label-primary': '#1f2328',\n    '--dsw-alias-label-secondary': '#6b7280',\n    '--dsw-alias-brand-primary': '#2563eb',\n    '--dsw-alias-state-error-primary': '#d94a3d',\n    '--dsw-alias-state-success-primary': '#2f9e44'\n  }\n\n  // Hex colors receive alpha; other formats convert to rgba or stay unchanged, never emit invalid CSS.\n  function withAlpha(color, alpha) {\n    var text = String(color || '').trim()\n    var hex = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(text)\n    if (hex) {\n      var expanded = hex[1].length === 3\n        ? '#' + hex[1].split('').map(function (part) { return part + part }).join('')\n        : text\n      return expanded + Math.round(alpha * 255).toString(16).padStart(2, '0')\n    }\n    var rgb = /^rgba?\\(\\s*([^)]*)\\)$/i.exec(text)\n    if (rgb) {\n      var parts = rgb[1].split(/[,\\s/]+/).filter(Boolean)\n      if (parts.length >= 3 && parts.slice(0, 3).every(function (part) { return /^[-+]?\\d*\\.?\\d+%?$/.test(part) })) {\n        return 'rgba(' + parts.slice(0, 3).join(', ') + ', ' + alpha + ')'\n      }\n    }\n    return text\n  }\n\n  // First series uses brand color; later series use a stable palette so one symbol keeps its color.\n  var PALETTE = ['#f59e0b', '#10b981', '#8b5cf6', '#0ea5e9', '#ec4899']\n\n  function readToken(name) {\n    try {\n      var value = getComputedStyle(document.documentElement).getPropertyValue(name)\n      if (value && value.trim().length > 0) return value.trim()\n    } catch (error) {\n      /* Non-browser or unavailable styles fall back to defaults. */\n    }\n    return FALLBACK[name]\n  }\n\n  function resolveColors() {\n    return {\n      bg: readToken('--dsw-alias-bg-base'),\n      grid: readToken('--dsw-alias-border-l1'),\n      text: readToken('--dsw-alias-label-secondary'),\n      strong: readToken('--dsw-alias-label-primary'),\n      brand: readToken('--dsw-alias-brand-primary'),\n      up: readToken('--dsw-alias-state-error-primary'),\n      down: readToken('--dsw-alias-state-success-primary')\n    }\n  }\n\n  function showError(container, message) {\n    container.textContent = ''\n    var box = document.createElement('div')\n    box.setAttribute('data-chart-error', '1')\n    box.style.cssText = 'padding:12px;border:0.5px solid ' + readToken('--dsw-alias-border-l1') + ';border-radius:8px;color:' + readToken('--dsw-alias-label-secondary') + ';font-size:13px;line-height:1.6'\n    box.textContent = message\n    container.appendChild(box)\n  }\n\n  function applyIndexLabels(chart, labels) {\n    function format(time) {\n      var key = String(time)\n      return Object.prototype.hasOwnProperty.call(labels, key) ? labels[key] : key\n    }\n    // Replace both tick and crosshair formatters for category axes or synthetic dates leak through.\n    chart.applyOptions({\n      localization: { timeFormatter: format },\n      timeScale: { tickMarkFormatter: function (time) { return format(time) } }\n    })\n  }\n\n  var CHART_TIME_ZONE = 'Asia/Shanghai'\n  var CHART_DAY_SECONDS = 86400\n  var CHART_LOCAL_MIDNIGHT_UTC = 57600\n\n  function pad2(value) {\n    var text = String(value)\n    return text.length < 2 ? '0' + text : text\n  }\n\n  function timeLabel(time) {\n    if (typeof time === 'string') return time\n    if (time && typeof time === 'object') {\n      var year = time.year\n      var month = time.month\n      var day = time.day\n      if (year !== undefined && month !== undefined && day !== undefined) {\n        return String(year) + '-' + pad2(month) + '-' + pad2(day)\n      }\n    }\n    return String(time)\n  }\n\n  function collectNumericTimes(payload) {\n    var times = []\n    function add(list) {\n      if (!Array.isArray(list)) return\n      for (var i = 0; i < list.length; i += 1) {\n        var point = list[i]\n        if (point && typeof point.time === 'number' && isFinite(point.time)) times.push(point.time)\n      }\n    }\n    if (payload.ohlc) add(payload.ohlc.data)\n    if (Array.isArray(payload.series)) {\n      for (var i = 0; i < payload.series.length; i += 1) add(payload.series[i] && payload.series[i].data)\n    }\n    if (payload.volume) add(payload.volume.data)\n    return times\n  }\n\n  // Numeric epochs are true instants; render them in Asia/Shanghai. Business-day strings keep\n  // their own labels, so no formatter is applied when every point is a date string.\n  function makeTimeAxisFormatter(payload) {\n    var times = collectNumericTimes(payload)\n    if (times.length === 0) return null\n    var min = times[0]\n    var max = times[0]\n    var daily = true\n    for (var i = 0; i < times.length; i += 1) {\n      if (times[i] < min) min = times[i]\n      if (times[i] > max) max = times[i]\n      var mod = ((times[i] % CHART_DAY_SECONDS) + CHART_DAY_SECONDS) % CHART_DAY_SECONDS\n      if (mod !== 0 && mod !== CHART_LOCAL_MIDNIGHT_UTC) daily = false\n    }\n    var span = max - min\n    var formatter = new Intl.DateTimeFormat('en-CA', {\n      timeZone: CHART_TIME_ZONE,\n      year: 'numeric', month: '2-digit', day: '2-digit',\n      hour: '2-digit', minute: '2-digit', hourCycle: 'h23'\n    })\n    function parts(seconds) {\n      var values = formatter.formatToParts(new Date(seconds * 1000))\n      var out = {}\n      for (var j = 0; j < values.length; j += 1) out[values[j].type] = values[j].value\n      return out\n    }\n    function tick(time) {\n      if (typeof time !== 'number') return timeLabel(time)\n      var p = parts(time)\n      if (daily) {\n        if (span > 3 * 365 * CHART_DAY_SECONDS) return p.year\n        if (span > 120 * CHART_DAY_SECONDS) return p.year + '-' + p.month\n        return p.month + '-' + p.day\n      }\n      if (span > 2 * CHART_DAY_SECONDS) return p.month + '-' + p.day + ' ' + p.hour + ':' + p.minute\n      return p.hour + ':' + p.minute\n    }\n    function full(time) {\n      if (typeof time !== 'number') return timeLabel(time)\n      var p = parts(time)\n      return daily\n        ? p.year + '-' + p.month + '-' + p.day\n        : p.year + '-' + p.month + '-' + p.day + ' ' + p.hour + ':' + p.minute\n    }\n    return { tick: tick, full: full }\n  }\n\n  /** Support both v5 plugin markers and the older series API so markers never disappear silently. */\n  function attachMarkers(anchor, markers, LWC) {\n    if (typeof LWC.createSeriesMarkers === 'function') {\n      LWC.createSeriesMarkers(anchor, markers)\n      return true\n    }\n    if (anchor && typeof anchor.setMarkers === 'function') {\n      anchor.setMarkers(markers)\n      return true\n    }\n    return false\n  }\n\n  function volumePointColor(point, colors) {\n    if (point.direction === 'up') return colors.up\n    if (point.direction === 'down') return colors.down\n    return colors.brand\n  }\n\n  function seriesColor(index, colors) {\n    return index === 0 ? colors.brand : PALETTE[(index - 1) % PALETTE.length]\n  }\n\n  function appendLegend(container, payload, colors) {\n    var items = []\n    if (payload.ohlc && payload.ohlc.label) items.push({ label: payload.ohlc.label, color: colors.up })\n    if (Array.isArray(payload.series)) {\n      payload.series.forEach(function (item, index) {\n        if (item && item.label) items.push({ label: item.label, color: seriesColor(index, colors) })\n      })\n    }\n    if (payload.volume && payload.volume.label) items.push({ label: payload.volume.label, color: colors.brand })\n    if (items.length === 0) return\n\n    var legend = document.createElement('div')\n    legend.setAttribute('data-chart-legend', '1')\n    legend.style.cssText = 'position:absolute;z-index:2;top:8px;left:8px;right:8px;display:flex;flex-wrap:wrap;gap:4px 10px;align-items:center;pointer-events:none;color:' + colors.text + ';font-size:11px;line-height:16px'\n    items.forEach(function (item) {\n      var entry = document.createElement('span')\n      entry.style.cssText = 'display:inline-flex;align-items:center;gap:4px;padding:1px 5px;border-radius:4px;background:' + withAlpha(colors.bg, 0.8)\n      var swatch = document.createElement('span')\n      swatch.style.cssText = 'width:7px;height:7px;border-radius:50%;background:' + item.color + ';flex:none'\n      var label = document.createElement('span')\n      label.textContent = item.label\n      entry.appendChild(swatch)\n      entry.appendChild(label)\n      legend.appendChild(entry)\n    })\n    container.appendChild(legend)\n  }\n\n  function renderCapitalChart(container, payload, library) {\n    if (!container) throw new Error('renderCapitalChart: container is required')\n    if (!payload || typeof payload !== 'object') throw new Error('renderCapitalChart: payload is required')\n    // Use the injected library; never fall back to a global copy owned by another plugin.\n    var LWC = library\n    if (!LWC || typeof LWC.createChart !== 'function') {\n      showError(container, '\u56FE\u8868\u5E93\u672A\u52A0\u8F7D\uFF08\u8C03\u7528\u65B9\u672A\u63D0\u4F9B LightweightCharts\uFF09\u3002')\n      return null\n    }\n\n    var colors = resolveColors()\n    container.textContent = ''\n    if (container.style) container.style.position = 'relative'\n    container.setAttribute('data-chart-id', String(payload.chart_id || ''))\n    container.setAttribute('data-chart-kind', String(payload.kind || ''))\n\n    var chart = LWC.createChart(container, {\n      autoSize: true,\n      // attributionLogo stays enabled for Apache-2.0 attribution.\n      layout: { background: { color: 'transparent' }, textColor: colors.text, fontFamily: 'inherit', attributionLogo: true },\n      grid: { vertLines: { color: colors.grid }, horzLines: { color: colors.grid } },\n      rightPriceScale: { borderColor: colors.grid, entireTextOnly: true },\n      timeScale: { borderColor: colors.grid, rightOffset: 2, barSpacing: 6, minBarSpacing: 0.5 },\n      crosshair: { mode: LWC.CrosshairMode ? LWC.CrosshairMode.Normal : 0 },\n      localization: { locale: 'zh-CN' }\n    })\n\n    if (payload.axis === 'index' && payload.labels) applyIndexLabels(chart, payload.labels)\n    if (payload.axis === 'time') {\n      var timeAxis = makeTimeAxisFormatter(payload)\n      if (timeAxis) {\n        chart.applyOptions({\n          localization: { timeFormatter: timeAxis.full },\n          timeScale: { tickMarkFormatter: timeAxis.tick }\n        })\n      }\n    }\n\n    var anchor = null\n\n    if (payload.ohlc && Array.isArray(payload.ohlc.data) && payload.ohlc.data.length > 0) {\n      // kind=bar uses BarSeries; other OHLC kinds use CandlestickSeries with the same data contract.\n      var isOhlcBar = payload.kind === 'bar'\n      var candles = chart.addSeries(isOhlcBar ? LWC.BarSeries : LWC.CandlestickSeries, {\n        upColor: colors.up,\n        downColor: colors.down,\n        borderUpColor: colors.up,\n        borderDownColor: colors.down,\n        wickUpColor: colors.up,\n        wickDownColor: colors.down\n      })\n      candles.setData(payload.ohlc.data)\n      anchor = candles\n    }\n\n    if (Array.isArray(payload.series)) {\n      for (var index = 0; index < payload.series.length; index += 1) {\n        var item = payload.series[index]\n        if (!item || !Array.isArray(item.data) || item.data.length === 0) continue\n        var color = seriesColor(index, colors)\n        var options = { title: item.label || '', priceLineVisible: false, lastValueVisible: true }\n        var series = null\n        if (item.type === 'area') {\n          options.lineColor = color\n          options.topColor = withAlpha(color, 0.2)\n          options.bottomColor = withAlpha(color, 0.02)\n          options.lineWidth = 2\n          series = chart.addSeries(LWC.AreaSeries, options)\n        } else if (item.type === 'column') {\n          // Single-value histograms need HistogramSeries; BarSeries would render an empty chart.\n          options.color = color\n          options.base = 0\n          series = chart.addSeries(LWC.HistogramSeries, options)\n        } else {\n          options.color = color\n          options.lineWidth = 2\n          series = chart.addSeries(LWC.LineSeries, options)\n        }\n        series.setData(item.data)\n        if (anchor === null) anchor = series\n      }\n    }\n\n    if (payload.volume && Array.isArray(payload.volume.data) && payload.volume.data.length > 0) {\n      var volume = chart.addSeries(LWC.HistogramSeries, {\n        title: payload.volume.label || '',\n        priceFormat: { type: 'volume' },\n        priceLineVisible: false,\n        lastValueVisible: false\n      }, 1)\n      volume.setData(payload.volume.data.map(function (point) {\n        return { time: point.time, value: point.value, color: volumePointColor(point, colors) }\n      }))\n    }\n\n    if (anchor === null) {\n      showError(container, '\u8FD9\u5F20\u56FE\u6CA1\u6709\u53EF\u6E32\u67D3\u7684\u5E8F\u5217\uFF08payload \u91CC\u65E2\u6CA1\u6709 ohlc \u4E5F\u6CA1\u6709 series\uFF09\u3002')\n      return chart\n    }\n\n    if (Array.isArray(payload.markers) && payload.markers.length > 0) {\n      attachMarkers(anchor, payload.markers.map(function (marker) {\n        return { time: marker.time, position: marker.position, text: marker.text, color: colors.strong, shape: 'circle' }\n      }), LWC)\n    }\n\n    appendLegend(container, payload, colors)\n\n    // Main/volume panes use a 3:1 ratio; a single pane has no second pane object.\n    var panes = typeof chart.panes === 'function' ? chart.panes() : []\n    if (panes.length > 1) {\n      if (typeof panes[0].setStretchFactor === 'function') panes[0].setStretchFactor(3)\n      if (typeof panes[1].setStretchFactor === 'function') panes[1].setStretchFactor(1)\n    }\n\n    chart.timeScale().fitContent()\n    return chart\n  }\n\n  return { render: renderCapitalChart, version: 1 }\n})()\n";

package/lib/chart/runtime.js

@@ -84,6 +84,92 @@ export const CHART_RUNTIME_SOURCE = `
     })
   }
 
+  var CHART_TIME_ZONE = 'Asia/Shanghai'
+  var CHART_DAY_SECONDS = 86400
+  var CHART_LOCAL_MIDNIGHT_UTC = 57600
+
+  function pad2(value) {
+    var text = String(value)
+    return text.length < 2 ? '0' + text : text
+  }
+
+  function timeLabel(time) {
+    if (typeof time === 'string') return time
+    if (time && typeof time === 'object') {
+      var year = time.year
+      var month = time.month
+      var day = time.day
+      if (year !== undefined && month !== undefined && day !== undefined) {
+        return String(year) + '-' + pad2(month) + '-' + pad2(day)
+      }
+    }
+    return String(time)
+  }
+
+  function collectNumericTimes(payload) {
+    var times = []
+    function add(list) {
+      if (!Array.isArray(list)) return
+      for (var i = 0; i < list.length; i += 1) {
+        var point = list[i]
+        if (point && typeof point.time === 'number' && isFinite(point.time)) times.push(point.time)
+      }
+    }
+    if (payload.ohlc) add(payload.ohlc.data)
+    if (Array.isArray(payload.series)) {
+      for (var i = 0; i < payload.series.length; i += 1) add(payload.series[i] && payload.series[i].data)
+    }
+    if (payload.volume) add(payload.volume.data)
+    return times
+  }
+
+  // Numeric epochs are true instants; render them in Asia/Shanghai. Business-day strings keep
+  // their own labels, so no formatter is applied when every point is a date string.
+  function makeTimeAxisFormatter(payload) {
+    var times = collectNumericTimes(payload)
+    if (times.length === 0) return null
+    var min = times[0]
+    var max = times[0]
+    var daily = true
+    for (var i = 0; i < times.length; i += 1) {
+      if (times[i] < min) min = times[i]
+      if (times[i] > max) max = times[i]
+      var mod = ((times[i] % CHART_DAY_SECONDS) + CHART_DAY_SECONDS) % CHART_DAY_SECONDS
+      if (mod !== 0 && mod !== CHART_LOCAL_MIDNIGHT_UTC) daily = false
+    }
+    var span = max - min
+    var formatter = new Intl.DateTimeFormat('en-CA', {
+      timeZone: CHART_TIME_ZONE,
+      year: 'numeric', month: '2-digit', day: '2-digit',
+      hour: '2-digit', minute: '2-digit', hourCycle: 'h23'
+    })
+    function parts(seconds) {
+      var values = formatter.formatToParts(new Date(seconds * 1000))
+      var out = {}
+      for (var j = 0; j < values.length; j += 1) out[values[j].type] = values[j].value
+      return out
+    }
+    function tick(time) {
+      if (typeof time !== 'number') return timeLabel(time)
+      var p = parts(time)
+      if (daily) {
+        if (span > 3 * 365 * CHART_DAY_SECONDS) return p.year
+        if (span > 120 * CHART_DAY_SECONDS) return p.year + '-' + p.month
+        return p.month + '-' + p.day
+      }
+      if (span > 2 * CHART_DAY_SECONDS) return p.month + '-' + p.day + ' ' + p.hour + ':' + p.minute
+      return p.hour + ':' + p.minute
+    }
+    function full(time) {
+      if (typeof time !== 'number') return timeLabel(time)
+      var p = parts(time)
+      return daily
+        ? p.year + '-' + p.month + '-' + p.day
+        : p.year + '-' + p.month + '-' + p.day + ' ' + p.hour + ':' + p.minute
+    }
+    return { tick: tick, full: full }
+  }
+
   /** Support both v5 plugin markers and the older series API so markers never disappear silently. */
   function attachMarkers(anchor, markers, LWC) {
     if (typeof LWC.createSeriesMarkers === 'function') {
@@ -163,6 +249,15 @@ export const CHART_RUNTIME_SOURCE = `
     })
 
     if (payload.axis === 'index' && payload.labels) applyIndexLabels(chart, payload.labels)
+    if (payload.axis === 'time') {
+      var timeAxis = makeTimeAxisFormatter(payload)
+      if (timeAxis) {
+        chart.applyOptions({
+          localization: { timeFormatter: timeAxis.full },
+          timeScale: { tickMarkFormatter: timeAxis.tick }
+        })
+      }
+    }
 
     var anchor = null
 

package/lib/chart/series.d.ts

@@ -68,16 +68,16 @@ export declare function extractRows(value: unknown): {
     shape: string;
 };
 interface ParsedTime {
-    /** Value handed to the library: 'YYYY-MM-DD' business day, or UTC seconds. */
+    /** Value handed to the library: 'YYYY-MM-DD' business day, or epoch seconds. */
     display: string | number;
-    /** Comparison key (UTC seconds) for sort/filter/alignment. */
+    /** Comparison key (epoch seconds); date-only and naive datetime values use Asia/Shanghai. */
     seconds: number;
     /** True when the value came from a date-only string; decides business-day rendering. */
     dateOnly: boolean;
 }
 /**
- * Deterministic across machines: date-only stays a business-day string (no TZ shift), naive
- * datetime is UTC, numbers >= 1e11 are epoch ms, unparseable means the row has no time.
+ * Deterministic across machines: date-only is an Asia/Shanghai calendar day, naive datetime is
+ * Asia/Shanghai wall clock, numbers >= 1e11 are epoch ms, unparseable means the row has no time.
  */
 export declare function parseTimeValue(value: unknown): ParsedTime | undefined;
 export interface BuildChartPayloadInput {

package/lib/chart/series.js

@@ -17,6 +17,8 @@ const INDEX_EPOCH_SECONDS = Date.UTC(2000, 0, 1) / 1000;
 const SECONDS_PER_DAY = 86_400;
 /** Values >= 1e11 are epoch ms (1e11 seconds is year 5138). */
 const MILLISECONDS_THRESHOLD = 1e11;
+/** Chart convention: data timestamps are Asia/Shanghai wall clock; UTC+8 has no DST for supported dates. */
+const CHART_UTC_OFFSET_MS = 8 * 3_600_000;
 function isRecord(value) {
     return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
 }
@@ -89,9 +91,24 @@ function toNumber(value) {
 }
 const DATE_ONLY = /^(\d{4})-(\d{2})-(\d{2})$/;
 const DATE_TIME = /^(\d{4})-(\d{2})-(\d{2})[ T](\d{2}):(\d{2})(?::(\d{2}))?(?:\.\d+)?(Z|[+-]\d{2}:?\d{2})?$/;
+/** Calendar-valid UTC midnight, or undefined for 2025-02-30 style input. */
+function calendarUtcMs(year, month, day) {
+    const utc = Date.UTC(year, month - 1, day);
+    const check = new Date(utc);
+    if (check.getUTCFullYear() !== year || check.getUTCMonth() + 1 !== month || check.getUTCDate() !== day)
+        return undefined;
+    return utc;
+}
+/** Asia/Shanghai wall clock to epoch ms; fixed offset matches every supported market date. */
+function shanghaiEpochMs(year, month, day, hour, minute, second) {
+    const utc = calendarUtcMs(year, month, day);
+    if (utc === undefined)
+        return undefined;
+    return utc - CHART_UTC_OFFSET_MS + hour * 3_600_000 + minute * 60_000 + second * 1000;
+}
 /**
- * Deterministic across machines: date-only stays a business-day string (no TZ shift), naive
- * datetime is UTC, numbers >= 1e11 are epoch ms, unparseable means the row has no time.
+ * Deterministic across machines: date-only is an Asia/Shanghai calendar day, naive datetime is
+ * Asia/Shanghai wall clock, numbers >= 1e11 are epoch ms, unparseable means the row has no time.
  */
 export function parseTimeValue(value) {
     if (typeof value === 'number') {
@@ -110,16 +127,26 @@ export function parseTimeValue(value) {
         const year = Number(dateOnly[1]);
         const month = Number(dateOnly[2]);
         const day = Number(dateOnly[3]);
-        const check = new Date(Date.UTC(year, month - 1, day));
-        if (check.getUTCFullYear() !== year || check.getUTCMonth() + 1 !== month || check.getUTCDate() !== day)
+        const epoch = shanghaiEpochMs(year, month, day, 0, 0, 0);
+        if (epoch === undefined)
             return undefined;
-        return { display: text, seconds: Math.round(check.getTime() / 1000), dateOnly: true };
+        return { display: text, seconds: Math.round(epoch / 1000), dateOnly: true };
     }
     const dateTime = DATE_TIME.exec(text);
     if (dateTime) {
-        const normalized = `${dateTime[1]}-${dateTime[2]}-${dateTime[3]}T${dateTime[4]}:${dateTime[5]}:${dateTime[6] ?? '00'}${dateTime[7] ?? 'Z'}`;
-        const parsed = Date.parse(normalized);
-        if (!Number.isFinite(parsed))
+        const year = Number(dateTime[1]);
+        const month = Number(dateTime[2]);
+        const day = Number(dateTime[3]);
+        const hour = Number(dateTime[4]);
+        const minute = Number(dateTime[5]);
+        const second = Number(dateTime[6] ?? '00');
+        if (calendarUtcMs(year, month, day) === undefined)
+            return undefined;
+        // An explicit Z/offset is an instant; a timezone-less value is Asia/Shanghai wall clock.
+        const parsed = dateTime[7] === undefined
+            ? shanghaiEpochMs(year, month, day, hour, minute, second)
+            : Date.parse(`${dateTime[1]}-${dateTime[2]}-${dateTime[3]}T${dateTime[4]}:${dateTime[5]}:${dateTime[6] ?? '00'}${dateTime[7]}`);
+        if (parsed === undefined || !Number.isFinite(parsed))
             return undefined;
         return { display: Math.round(parsed / 1000), seconds: Math.round(parsed / 1000), dateOnly: false };
     }
@@ -130,6 +157,13 @@ export function parseTimeValue(value) {
         return undefined;
     return { display: Math.round(parsed / 1000), seconds: Math.round(parsed / 1000), dateOnly: false };
 }
+/** `to` on a date-only bound includes the whole Asia/Shanghai calendar day, not just midnight. */
+function rangeBound(value, edge) {
+    const parsed = parseTimeValue(value);
+    if (parsed === undefined)
+        return undefined;
+    return parsed.dateOnly && edge === 'to' ? parsed.seconds + SECONDS_PER_DAY - 1 : parsed.seconds;
+}
 export function buildChartPayload(input) {
     const { spec } = input;
     const warnings = [];
@@ -204,8 +238,8 @@ export function buildChartPayload(input) {
         if (axis === 'index') {
             throw new ChartError('chart_spec_invalid', 'spec.range requires a time axis; remove range for category data or provide a parseable time field in spec.x');
         }
-        const from = spec.range.from === undefined ? undefined : parseTimeValue(spec.range.from)?.seconds;
-        const to = spec.range.to === undefined ? undefined : parseTimeValue(spec.range.to)?.seconds;
+        const from = spec.range.from === undefined ? undefined : rangeBound(spec.range.from, 'from');
+        const to = spec.range.to === undefined ? undefined : rangeBound(spec.range.to, 'to');
         if (spec.range.from !== undefined && from === undefined)
             throw new ChartError('chart_spec_invalid', 'spec.range.from is not a recognizable date');
         if (spec.range.to !== undefined && to === undefined)

package/lib/data-collector/dataset-tools.js

@@ -144,6 +144,17 @@ const datasetRefProperties = { dataset_id: { type: 'string' },
     captured_at: { type: 'integer' },
     retention_until: { type: 'integer' },
     params_digest: { type: 'string' },
+    time_coverage: {
+        type: 'object',
+        properties: {
+            column: { oneOf: [{ type: 'string' }, { type: 'null' }] },
+            from: { oneOf: [{ type: 'string' }, { type: 'null' }] },
+            to: { oneOf: [{ type: 'string' }, { type: 'null' }] },
+            format: { type: 'string', enum: ['epoch_ms', 'date_string', 'datetime_string', 'none'] },
+        },
+        required: ['column', 'from', 'to', 'format'],
+        additionalProperties: false,
+    },
 };
 const datasetRefWithAccessSchema = jsonObject({
     ...datasetRefProperties,
@@ -288,6 +299,17 @@ const describeResultSchema = jsonObject({
     captured_at: { type: 'integer' },
     retention_until: { type: 'integer' },
     params_digest: { type: 'string' },
+    time_coverage: {
+        type: 'object',
+        properties: {
+            column: { oneOf: [{ type: 'string' }, { type: 'null' }] },
+            from: { oneOf: [{ type: 'string' }, { type: 'null' }] },
+            to: { oneOf: [{ type: 'string' }, { type: 'null' }] },
+            format: { type: 'string', enum: ['epoch_ms', 'date_string', 'datetime_string', 'none'] },
+        },
+        required: ['column', 'from', 'to', 'format'],
+        additionalProperties: false,
+    },
     query_access: jsonObject({
         readable: { type: 'boolean' },
         shape: { type: 'string', enum: ['array', 'envelope_item', 'document', 'none'] },

package/lib/data-collector/describe.js

@@ -171,6 +171,7 @@ export async function describeDataset(input) {
         captured_at: inspection.captured_at,
         retention_until: inspection.retention_until,
         params_digest: inspection.params_digest,
+        time_coverage: inspection.time_coverage,
         query_access: inspection.query_access,
         profile_id: profile.profile_id,
         profile_ref: profile.artifact_ref,

package/lib/data-collector/hub.js

@@ -1,3 +1,4 @@
+import { summarizeTimeCoverage } from './time-axis.js';
 /** Normalize an internal data_key token; data_key is host-only and never model-visible. */
 export function normalizeKeyToken(value) {
     return value.replace(/[\\/:]+/g, '.')
@@ -320,6 +321,9 @@ export class DataCollectorHub {
                     throw new Error(`data source ${source.schema.name} returned data incompatible with its output contract`);
                 }
                 const { format, rowCount, rowKey } = shapeOf(output.data, source.schema.rowShape);
+                const rows = Array.isArray(output.data)
+                    ? output.data
+                    : (rowKey === undefined ? [] : rowsAtPath(output.data, rowKey) ?? []);
                 const ref = await this.store.save({
                     session: item.request.session,
                     capability: item.request.capability,
@@ -331,6 +335,7 @@ export class DataCollectorHub {
                     row_count: rowCount,
                     data: output.data,
                     row_key: rowKey,
+                    ...(format === 'json_rows' ? { time_coverage: summarizeTimeCoverage(rows) } : {}),
                 });
                 for (const waiter of [...item.waiters])
                     this.settleWaiter(item, waiter, { kind: 'ok', ref });

package/lib/data-collector/store.d.ts

@@ -1,4 +1,5 @@
 import { type QueryResult, type QuerySpec } from './query.js';
+import { type DatasetTimeCoverage } from './time-axis.js';
 /**
  * Workspace-local Dataset/profile store: immutable artifacts, host-written only. Agents receive
  * dataset_id / opaque artifact_ref, never real paths; raw rows never enter agent messages.
@@ -38,6 +39,8 @@ export interface DatasetRef {
     captured_at: number;
     retention_until: number;
     params_digest: string;
+    /** Host-computed from the stored rows; omitted only by manifests written before this field existed. */
+    time_coverage?: DatasetTimeCoverage;
 }
 export type DatasetShape = 'array' | 'envelope_item' | 'document' | 'none';
 export interface DatasetInspection extends DatasetRef {
@@ -293,6 +296,8 @@ export interface SaveDatasetInput {
     data: unknown;
     /** Host-only row key for envelope-shaped json_rows data. */
     row_key?: string;
+    /** Computed by the Hub from the same rows it is about to persist. */
+    time_coverage?: DatasetTimeCoverage;
     signal?: AbortSignal;
 }
 export interface WriteProfileInput {

package/lib/data-collector/store.js

@@ -140,6 +140,7 @@ export class WorkspaceDatasetStore {
             captured_at: capturedAt,
             retention_until: capturedAt + this.retentionMs,
             params_digest: input.params_digest,
+            ...(input.time_coverage === undefined ? {} : { time_coverage: input.time_coverage }),
         };
         const storedManifest = {
             ...manifest,
@@ -1103,6 +1104,19 @@ function profileQuantile(sorted, probability) {
         return sorted[lower];
     return sorted[lower] + (sorted[upper] - sorted[lower]) * (position - lower);
 }
+function validTimeCoverage(value) {
+    if (!isRecord(value))
+        return false;
+    if (Object.keys(value).some((key) => !['column', 'from', 'to', 'format'].includes(key)))
+        return false;
+    if (!['epoch_ms', 'date_string', 'datetime_string', 'none'].includes(String(value.format)))
+        return false;
+    if (value.format === 'none')
+        return value.column === null && value.from === null && value.to === null;
+    return typeof value.column === 'string' && value.column.length > 0 && value.column.length <= 128
+        && typeof value.from === 'string' && value.from.length > 0
+        && typeof value.to === 'string' && value.to.length > 0;
+}
 function validateStoredDatasetManifest(value, datasetId) {
     if (!isRecord(value))
         return undefined;
@@ -1130,6 +1144,8 @@ function validateStoredDatasetManifest(value, datasetId) {
         return undefined;
     if (value.row_key !== undefined && (typeof value.row_key !== 'string' || value.row_key.length === 0 || value.row_key.length > 128))
         return undefined;
+    if (value.time_coverage !== undefined && !validTimeCoverage(value.time_coverage))
+        return undefined;
     const ref = {
         dataset_id: value.dataset_id,
         task_id: value.task_id,
@@ -1143,6 +1159,7 @@ function validateStoredDatasetManifest(value, datasetId) {
         captured_at: value.captured_at,
         retention_until: value.retention_until,
         params_digest: value.params_digest,
+        ...(value.time_coverage === undefined ? {} : { time_coverage: value.time_coverage }),
     };
     return {
         ...ref,

package/lib/data-collector/time-axis.d.ts

@@ -15,6 +15,21 @@ export interface AxisBounds {
     data_from: string | null;
     data_to: string | null;
 }
+/**
+ * Host-computed coverage for a DatasetRef. `format: 'none'` is intentional: a quote source
+ * without a time column must not look like it has an as-of time.
+ */
+export interface DatasetTimeCoverage {
+    column: string | null;
+    from: string | null;
+    to: string | null;
+    format: 'epoch_ms' | 'date_string' | 'datetime_string' | 'none';
+}
+/**
+ * Pick one time column by name and return its real min/max. This is a host fact for DatasetRef;
+ * it deliberately does not convert quote times across markets (their offsets stay in the string).
+ */
+export declare function summarizeTimeCoverage(rows: unknown[]): DatasetTimeCoverage;
 /**
  * Translate a date-like filter value into comparable bounds. Dates mean whole days: `=` expands
  * to >=/<=, while `>`, `<`, `in` and `!=` fail loudly instead of silently shifting a day.

package/lib/data-collector/time-axis.js

@@ -126,6 +126,79 @@ export function probeTimeAxis(column, values) {
         return { column, value_format: 'date_string', aligned_to: 'calendar_day' };
     return { column, value_format: 'unknown' };
 }
+const TIME_COLUMN_PRIORITY = [
+    'quote_time', 'event_time_beijing', 'datetime', 'report_date', 'trade_date',
+    'stat_date', 'quote_date', 'collect_date', 'date', 'time',
+    'quote_time_ms', 'event_time_ms', 'report_date_ms', 'trade_date_ms',
+    'stat_date_ms', 'quote_date_ms', 'collect_date_ms', 'date_ms', 'time_ms',
+];
+const COVERAGE_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+const COVERAGE_DATETIME_RE = /^\d{4}-\d{2}-\d{2}[ T]\d{2}:\d{2}(?::\d{2}(?:\.\d{1,9})?)?(?:Z|[+-]\d{2}:\d{2})?$/;
+function coverageOfColumn(column, rows) {
+    const values = [];
+    for (const row of rows) {
+        const cell = cellOf(row, column);
+        if (!cell.present || cell.value === null || cell.value === undefined)
+            continue;
+        values.push(cell.value);
+    }
+    if (values.length === 0)
+        return undefined;
+    const numbers = values.filter((value) => typeof value === 'number' && Number.isFinite(value));
+    if (numbers.length === values.length) {
+        let min = Number.POSITIVE_INFINITY;
+        let max = Number.NEGATIVE_INFINITY;
+        for (const value of numbers) {
+            if (!Number.isSafeInteger(value) || value < MIN_EPOCH_MS || value > 8_640_000_000_000_000)
+                return undefined;
+            if (value < min)
+                min = value;
+            if (value > max)
+                max = value;
+        }
+        const axis = probeTimeAxis(column, numbers);
+        const zone = axis.time_zone ?? 'UTC';
+        const text = (value) => axis.aligned_to === 'local_midnight'
+            ? isoDateFromEpoch(value, zone)
+            : new Date(value).toISOString();
+        return { column, from: text(min), to: text(max), format: 'epoch_ms' };
+    }
+    const strings = values.filter((value) => typeof value === 'string');
+    if (strings.length !== values.length)
+        return undefined;
+    const trimmed = strings.map((value) => value.trim());
+    if (trimmed.every((value) => COVERAGE_DATE_RE.test(value))) {
+        const sorted = [...trimmed].sort();
+        return { column, from: sorted[0], to: sorted[sorted.length - 1], format: 'date_string' };
+    }
+    if (trimmed.every((value) => COVERAGE_DATETIME_RE.test(value))) {
+        const sorted = [...trimmed].map((value) => value.replace('T', ' ')).sort();
+        return { column, from: sorted[0], to: sorted[sorted.length - 1], format: 'datetime_string' };
+    }
+    return undefined;
+}
+/**
+ * Pick one time column by name and return its real min/max. This is a host fact for DatasetRef;
+ * it deliberately does not convert quote times across markets (their offsets stay in the string).
+ */
+export function summarizeTimeCoverage(rows) {
+    if (rows.length === 0)
+        return { column: null, from: null, to: null, format: 'none' };
+    const first = rows.find((row) => isRecordLike(row));
+    if (!isRecordLike(first))
+        return { column: null, from: null, to: null, format: 'none' };
+    const keys = Object.keys(first);
+    const ordered = [
+        ...TIME_COLUMN_PRIORITY.filter((column) => keys.includes(column)),
+        ...keys.filter((column) => !TIME_COLUMN_PRIORITY.includes(column) && /(^|_)(date|time)(_|$)|_ms$/i.test(column)),
+    ];
+    for (const column of ordered) {
+        const coverage = coverageOfColumn(column, rows);
+        if (coverage !== undefined)
+            return coverage;
+    }
+    return { column: null, from: null, to: null, format: 'none' };
+}
 /**
  * Translate a date-like filter value into comparable bounds. Dates mean whole days: `=` expands
  * to >=/<=, while `>`, `<`, `in` and `!=` fail loudly instead of silently shifting a day.

package/lib/data-collector/tools.d.ts

@@ -29,4 +29,4 @@ export interface DataCollectorDiagnostics {
 }
 export declare function registerDataCollectorTools(ctx: Context, hub: DataCollectorHub, diagnostics?: DataCollectorDiagnostics): void;
 /** Model-visible DatasetRef field whitelist (tests and host assertions). */
-export declare const DATASET_REF_FIELDS: readonly ["dataset_id", "task_id", "session_id", "artifact_ref", "format", "capability", "source_label", "schema", "row_count", "captured_at", "retention_until", "params_digest"];
+export declare const DATASET_REF_FIELDS: readonly ["dataset_id", "task_id", "session_id", "artifact_ref", "format", "capability", "source_label", "schema", "row_count", "captured_at", "retention_until", "params_digest", "time_coverage"];

package/lib/data-collector/tools.js

@@ -42,6 +42,17 @@ const datasetRefSchema = () => jsonObject({
     captured_at: { type: 'integer' },
     retention_until: { type: 'integer' },
     params_digest: { type: 'string' },
+    time_coverage: {
+        type: 'object',
+        properties: {
+            column: { oneOf: [{ type: 'string' }, { type: 'null' }] },
+            from: { oneOf: [{ type: 'string' }, { type: 'null' }] },
+            to: { oneOf: [{ type: 'string' }, { type: 'null' }] },
+            format: { type: 'string', enum: ['epoch_ms', 'date_string', 'datetime_string', 'none'] },
+        },
+        required: ['column', 'from', 'to', 'format'],
+        additionalProperties: false,
+    },
 }, ['dataset_id', 'task_id', 'session_id', 'artifact_ref', 'format', 'capability', 'source_label', 'schema', 'row_count', 'captured_at', 'retention_until', 'params_digest']);
 function render(_args, value) {
     // ToolOutputDefinition.render(args, value): the first parameter is the input, the second the output.
@@ -215,5 +226,5 @@ export function registerDataCollectorTools(ctx, hub, diagnostics) {
 export const DATASET_REF_FIELDS = [
     'dataset_id', 'task_id', 'session_id', 'artifact_ref', 'format',
     'capability', 'source_label', 'schema', 'row_count', 'captured_at',
-    'retention_until', 'params_digest',
+    'retention_until', 'params_digest', 'time_coverage',
 ];

package/lib/index.d.ts

@@ -20,6 +20,7 @@ export interface Config {
         maxSteps?: number;
         maxToolCalls?: number;
         inAppNotifications?: boolean;
+        defaultWorkspaceId?: string;
     };
     retriever?: RetrieverConfig;
 }
@@ -40,6 +41,7 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         maxSteps: z<number, number, "defined">;
         maxToolCalls: z<number, number, "defined">;
         inAppNotifications: z<boolean, boolean, "defined">;
+        defaultWorkspaceId: z<string, string, "defined">;
     }>>, Schemastery.ObjectT<NoInfer<{
         tickMs: z<number, number, "defined">;
         runTimeoutMinutes: z<number, number, "defined">;
@@ -47,6 +49,7 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         maxSteps: z<number, number, "defined">;
         maxToolCalls: z<number, number, "defined">;
         inAppNotifications: z<boolean, boolean, "defined">;
+        defaultWorkspaceId: z<string, string, "defined">;
     }>>, "defined">;
     retriever: z<Schemastery.ObjectS<NoInfer<{
         baseURL: z<string, string, "defined">;
@@ -142,6 +145,7 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         maxSteps: z<number, number, "defined">;
         maxToolCalls: z<number, number, "defined">;
         inAppNotifications: z<boolean, boolean, "defined">;
+        defaultWorkspaceId: z<string, string, "defined">;
     }>>, Schemastery.ObjectT<NoInfer<{
         tickMs: z<number, number, "defined">;
         runTimeoutMinutes: z<number, number, "defined">;
@@ -149,6 +153,7 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         maxSteps: z<number, number, "defined">;
         maxToolCalls: z<number, number, "defined">;
         inAppNotifications: z<boolean, boolean, "defined">;
+        defaultWorkspaceId: z<string, string, "defined">;
     }>>, "defined">;
     retriever: z<Schemastery.ObjectS<NoInfer<{
         baseURL: z<string, string, "defined">;