@v587d/capital-generation 2.15.1 → 2.16.0

package/config/client.src.cjs

@@ -9,6 +9,8 @@ const {
   Switch,
   Tag,
   Modal,
+  Menu,
+  IconChevronDownOutlineRegular,
   IconRightUpOutlineRegular,
 } = require('@deepseek-ai/dsh-client-ui-primitives')
 const { SELECTED_SKILL_CATALOG, SELECTED_SKILL_TAG_LABELS } = require('../selected-skills/catalog.js')
@@ -25,6 +27,7 @@ const {
   SELECTED_SKILL_PRESET_ORDER,
   SELECTED_SKILL_ROUTING,
 } = require('../selected-skills/routing.js')
+const { WORKSPACES_ROUTE } = require('../automation/contract.js')
 
 /**
  * Two different strings: `ENTRY_ID` is the settings namespace (= profile entry
@@ -64,6 +67,8 @@ const DOC_URLS = {
 /** Render order = array order; one list drives status, refs, drafts and event refresh. */
 const CREDENTIAL_FIELDS = ['fuyao', 'ftshare', 'anysearch', 'wind', 'paddleocr']
 const AUTOMATION_FIELDS = ['tickMs', 'runTimeoutMinutes', 'idleTimeoutMinutes', 'maxSteps', 'maxToolCalls', 'inAppNotifications']
+const AUTOMATION_WORKSPACE_FIELD = 'defaultWorkspaceId'
+const WORKSPACE_DEDICATED_MENU_ID = '__capgen_dedicated_workspace__'
 const AUTOMATION_DEFAULTS = {
   tickMs: 60_000,
   runTimeoutMinutes: 60,
@@ -125,6 +130,12 @@ const zh = {
   automationMaxSteps: '最大步骤',
   automationMaxToolCalls: '最大工具调用',
   automationInApp: '写入应用内通知',
+  automationDefaultWorkspace: '默认工作区',
+  automationWorkspacePath: '默认位置：{path}',
+  automationWorkspaceMissing: '原工作区已被移除，运行会回退到专属默认工作区。',
+  automationWorkspaceLoading: '工作区列表读取中…',
+  automationWorkspaceUnavailable: '工作区列表暂时读不到；任务仍会使用默认工作区，切回本格会重试。',
+  automationWorkspaceFallback: '专属默认工作区',
   windLabel: 'Wind Alice API Key',
   windHint: 'Wind 金融信披类文档检索接口。保存后新自动模式会话生效。',
   paddleocrLabel: 'PaddleOCR 文档解析 Token',
@@ -190,6 +201,12 @@ const en = {
   automationMaxSteps: 'Max steps',
   automationMaxToolCalls: 'Max tool calls',
   automationInApp: 'Write in-app notifications',
+  automationDefaultWorkspace: 'Default workspace',
+  automationWorkspacePath: 'Location: {path}',
+  automationWorkspaceMissing: 'That workspace was removed; runs fall back to the dedicated default workspace.',
+  automationWorkspaceLoading: 'Loading workspaces…',
+  automationWorkspaceUnavailable: 'The workspace list is unavailable; runs still use the default workspace. Re-entering this tab retries.',
+  automationWorkspaceFallback: 'Dedicated default workspace',
   windLabel: 'Wind Alice API Key',
   windHint: 'Wind financial disclosure document retrieval interface. Takes effect in new Auto mode sessions.',
   paddleocrLabel: 'PaddleOCR document token',
@@ -261,10 +278,17 @@ function installStyles() {
     .capital-config-automation-group { display: flex; flex-direction: column; gap: 8px; }
     .capital-config-automation-group > .capital-config-group-label { color: var(--dsw-alias-label-secondary); font-size: 12px; font-weight: 500; line-height: 18px; }
     .capital-config-number { display: flex; flex-direction: column; gap: 4px; min-width: 0; }
+    .capital-config-workspace { display: flex; flex-direction: column; gap: 4px; min-width: 0; }
     .capital-config-number-head { display: flex; flex-wrap: wrap; align-items: baseline; gap: 2px 8px; min-width: 0; }
     .capital-config-number-head .capital-config-write-failed { font-size: 11px; line-height: 16px; }
     .capital-config-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(140px, 1fr)); gap: 8px; }
     .capital-config-automation input[type="number"] { width: 100%; box-sizing: border-box; padding: 6px 8px; border: .5px solid var(--dsw-alias-border-l1); border-radius: 8px; background: var(--dsw-alias-bg-module-platform); color: var(--dsw-alias-label-primary); font: inherit; font-size: 12px; }
+    .capital-config-select { box-sizing: border-box; display: inline-flex; align-items: center; justify-content: space-between; gap: 10px; width: 100%; min-width: 0; height: 34px; padding: 0 10px 0 12px; border: 0; border-radius: 10px; background: var(--dsw-alias-bg-module-platform); color: var(--dsw-alias-label-primary); font: inherit; font-size: 12.5px; line-height: 20px; text-align: left; cursor: pointer; transition: background .15s, opacity .15s; }
+    .capital-config-select:hover:not(:disabled) { background: var(--dsw-alias-interactive-bg-hover); }
+    .capital-config-select:focus-visible { outline: 2px solid var(--dsw-focus-ring-color, var(--dsw-alias-brand-primary)); outline-offset: 0; }
+    .capital-config-select:disabled { opacity: .5; cursor: not-allowed; }
+    .capital-config-selectvalue { min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+    .capital-config-select > svg { flex: none; color: var(--dsw-alias-label-tertiary); }
     .capital-config-selected-mode { padding: 12px 14px; border: 0.5px solid var(--dsw-alias-border-l1); border-radius: 10px; background: var(--dsw-alias-bg-layer-2); }
     .capital-config-switch-row { align-items: center; gap: 12px; display: flex; }
     .capital-config-switch-text { min-width: 0; flex: 1; display: flex; flex-direction: column; gap: 4px; }
@@ -323,6 +347,89 @@ function installStyles() {
   return () => style.remove()
 }
 
+/**
+ * Dedicated workspace is the empty value, so the dropdown can keep one "follow default"
+ * entry even when the registry list is empty or the saved id has been removed.
+ */
+function workspaceProjection(details, rawSelected, state) {
+  const selectedId = typeof rawSelected === 'string' ? rawSelected.trim() : ''
+  const items = Array.isArray(details?.workspaces) ? details.workspaces : []
+  const dedicated = items.find((item) => item?.dedicated === true)
+  const dedicatedPath = typeof dedicated?.path === 'string' ? dedicated.path : ''
+  const options = [{
+    id: '',
+    title: typeof dedicated?.title === 'string' ? dedicated.title : '',
+    path: typeof dedicated?.displayPath === 'string' ? dedicated.displayPath : '',
+    dedicated: true,
+    missing: false,
+  }]
+  for (const item of items) {
+    if (item?.dedicated === true || (dedicatedPath !== '' && item?.path === dedicatedPath) || typeof item?.id !== 'string') continue
+    options.push({
+      id: item.id,
+      title: typeof item.title === 'string' ? item.title : item.id,
+      path: typeof item.displayPath === 'string' ? item.displayPath : '',
+      dedicated: false,
+      missing: false,
+    })
+  }
+  const missing = selectedId !== '' && !options.some((option) => option.id === selectedId)
+  if (missing) options.push({ id: selectedId, title: '', path: '', dedicated: false, missing: true })
+  const current = options.find((option) => option.id === selectedId) ?? options[0]
+  return { options, selectedId, current, missing, ...state }
+}
+
+/**
+ * DSH General-settings style selector: same filled pill + host `Menu` surface as the
+ * automation page. Native `<select>` is avoided so light/dark themes follow host tokens.
+ */
+function WorkspaceSelect({ value, options, onChange, disabled, label, describedBy }) {
+  const [open, setOpen] = useState(false)
+  const triggerRef = useRef(null)
+  const currentValue = typeof value === 'string' ? value : ''
+  const items = options.map((option) => ({
+    id: option.id === '' ? WORKSPACE_DEDICATED_MENU_ID : option.id,
+    label: option.label,
+  }))
+  const menuValue = currentValue === '' ? WORKSPACE_DEDICATED_MENU_ID : currentValue
+  const current = items.find((item) => item.id === menuValue) ?? items[0]
+  useEffect(() => {
+    if (disabled === true && open) setOpen(false)
+  }, [disabled, open])
+  const closeMenu = () => setOpen(false)
+  const selectValue = (id) => {
+    setOpen(false)
+    triggerRef.current?.focus?.({ preventScroll: true })
+    const next = id === WORKSPACE_DEDICATED_MENU_ID ? '' : id
+    if (next === currentValue) return undefined
+    return onChange(next)
+  }
+  const trigger = h('button', {
+    ref: triggerRef,
+    type: 'button',
+    className: 'capital-config-select',
+    disabled,
+    'aria-label': current?.label ? `${label}：${current.label}` : label,
+    'aria-haspopup': 'menu',
+    'aria-expanded': open ? 'true' : 'false',
+    'aria-describedby': describedBy,
+    title: current?.label,
+    onClick: () => setOpen((currentOpen) => !currentOpen),
+  },
+  h('span', { className: 'capital-config-selectvalue', title: current?.label }, current?.label ?? ''),
+  h(IconChevronDownOutlineRegular, { size: 14 }))
+  return h(Menu, {
+    open,
+    anchor: trigger,
+    items,
+    selectedId: menuValue,
+    onSelect: selectValue,
+    onClose: closeMenu,
+    align: 'start',
+    portal: true,
+  })
+}
+
 class CapitalCardController {
   constructor(scope, ctx) {
     this.scope = scope
@@ -337,6 +444,11 @@ class CapitalCardController {
     this.automationWriting = new Set()
     this.automationFailed = new Set()
     this.automationInvalid = new Set()
+    this.workspaceWriting = false
+    this.workspaceFailed = false
+    this.workspaceDetails = null
+    this.workspacesInFlight = false
+    this.workspacesFailed = false
     // Row count is external: null = unknown, never 0; fetch only after the card is shown.
     this.bundleRows = null
     this.rowsRequested = false
@@ -393,6 +505,12 @@ class CapitalCardController {
         failed: this.automationFailed.has(field),
         invalid: this.automationInvalid.has(field),
       }])),
+      workspace: workspaceProjection(this.workspaceDetails, snapshot.value?.automation?.[AUTOMATION_WORKSPACE_FIELD], {
+        loading: this.workspacesInFlight,
+        unavailable: this.workspacesFailed && this.workspaceDetails === null,
+        writing: this.workspaceWriting,
+        failed: this.workspaceFailed,
+      }),
       // `count === null` means unknown, not zero: the card decides whether to draw it.
       components: { count: this.bundleRows },
     }
@@ -582,6 +700,51 @@ class CapitalCardController {
     this.store.set(this.projection())
   }
 
+  /**
+   * Workspace ids come from the automation route (same auth plane as its page), never from
+   * a path in settings. Failures are not cached: re-entering the tab retries.
+   */
+  async ensureWorkspaces() {
+    if (this.workspaceDetails !== null || this.workspacesInFlight) return
+    this.workspacesInFlight = true
+    this.workspacesFailed = false
+    this.store.set(this.projection())
+    try {
+      if (typeof fetch !== 'function') throw new Error('fetch_unavailable')
+      const response = await fetch(WORKSPACES_ROUTE, { method: 'GET', cache: 'no-store', credentials: 'same-origin' })
+      if (!response?.ok) throw new Error(`http_${response?.status ?? 0}`)
+      const payload = await response.json()
+      if (!Array.isArray(payload?.workspaces)) throw new Error('invalid_payload')
+      this.workspaceDetails = {
+        workspaces: payload.workspaces.filter((item) => item !== null && typeof item === 'object' && typeof item.id === 'string'),
+      }
+    } catch {
+      this.workspacesFailed = true
+    }
+    this.workspacesInFlight = false
+    this.store.set(this.projection())
+  }
+
+  async writeAutomationWorkspace(value) {
+    if (this.workspaceWriting) return 'ignored'
+    const snapshot = this.scope.getSnapshot()
+    if (snapshot.status !== 'ready' || !snapshot.writable) return 'ignored'
+    const next = typeof value === 'string' ? value.trim() : ''
+    this.workspaceWriting = true
+    this.workspaceFailed = false
+    this.store.set(this.projection())
+    try {
+      await this.scope.mutate([{ op: 'set', path: ['automation', AUTOMATION_WORKSPACE_FIELD], value: next }])
+    } catch {
+      // The landed check below reports the failure.
+    }
+    this.workspaceWriting = false
+    const landed = (this.scope.getSnapshot().value?.automation?.[AUTOMATION_WORKSPACE_FIELD] ?? '') === next
+    if (!landed) this.workspaceFailed = true
+    this.store.set(this.projection())
+    return landed ? 'saved' : 'failed'
+  }
+
   inject() {
     return {
       hooks: {
@@ -594,6 +757,8 @@ class CapitalCardController {
       toggleSelectedSkill: (field, value) => this.toggleSelectedSkill(field, value),
       toggleSelectedSkillsMode: (auto) => this.toggleSelectedSkillsMode(auto),
       ensureBundleRows: () => this.ensureBundleRows(),
+      ensureWorkspaces: () => this.ensureWorkspaces(),
+      writeAutomationWorkspace: (value) => this.writeAutomationWorkspace(value),
     }
   }
 }
@@ -802,6 +967,10 @@ function CapitalCard(props) {
   const [presetFilter, setPresetFilter] = useState(SELECTED_SKILL_FILTER_ALL)
   // Fetch on mount: tab labels carry numbers; hooks must precede the unavailable return.
   useEffect(() => { props.ensureBundleRows() }, [])
+  // The workspace list lives behind the automation route; fetch when its tab first opens.
+  useEffect(() => {
+    if (tab === 'automation') props.ensureWorkspaces()
+  }, [tab])
   // Pinned order is snapshotted on tab entry so rows never move under the cursor.
   const enabledKeys = () => new Set(SELECTED_SKILL_CATALOG
     .filter((entry) => state.selectedSkills?.[entry.key]?.on === true)
@@ -887,7 +1056,60 @@ function CapitalCard(props) {
     h('span', { className: 'capital-config-group-label' }, t(labelKey)),
     ...children,
   )
+  const workspaceState = state.workspace ?? {
+    options: [],
+    selectedId: '',
+    current: null,
+    missing: false,
+    loading: false,
+    unavailable: false,
+    writing: false,
+    failed: false,
+  }
+  const workspacePathId = 'capital-config-automation-workspace-path'
+  const namedWorkspaceOptions = workspaceState.options.map((option) => ({
+    id: option.id,
+    path: option.path,
+    label: option.id === ''
+      ? (option.title || t('automationWorkspaceFallback'))
+      : option.missing ? t('automationWorkspaceMissing') : option.title,
+  }))
+  const workspaceLabelCounts = new Map()
+  for (const option of namedWorkspaceOptions) {
+    workspaceLabelCounts.set(option.label, (workspaceLabelCounts.get(option.label) ?? 0) + 1)
+  }
+  const workspaceOptions = namedWorkspaceOptions.map((option) => {
+    if (option.id === '' || !option.path || (workspaceLabelCounts.get(option.label) ?? 0) < 2) return option
+    // Two registered workspaces may legitimately share a title; path keeps the menu unambiguous.
+    return { ...option, label: `${option.label} · ${option.path}` }
+  })
+  const workspaceSection = h('div', { className: 'capital-config-workspace' },
+    h('span', { className: 'capital-config-number-head' },
+      h('span', { className: 'capital-config-switch-label' }, t('automationDefaultWorkspace')),
+      workspaceState.failed
+        ? h('span', { role: 'status', className: 'capital-config-write-failed' }, t('saveFailed'))
+        : null,
+    ),
+    h(WorkspaceSelect, {
+      value: workspaceState.selectedId,
+      options: workspaceOptions,
+      onChange: (next) => props.writeAutomationWorkspace(next),
+      disabled: disabled || state.saving || workspaceState.writing,
+      label: t('automationDefaultWorkspace'),
+      describedBy: workspaceState.current?.path ? workspacePathId : undefined,
+    }),
+    workspaceState.unavailable
+      ? h('p', { role: 'status', className: 'capital-config-hint' }, t('automationWorkspaceUnavailable'))
+      : workspaceState.loading
+        ? h('p', { className: 'capital-config-hint' }, t('automationWorkspaceLoading'))
+        : workspaceState.missing
+          ? h('p', { role: 'status', className: 'capital-config-write-failed' }, t('automationWorkspaceMissing'))
+          : workspaceState.current?.path
+            ? h('p', { id: workspacePathId, className: 'capital-config-hint' }, t('automationWorkspacePath', { path: workspaceState.current.path }))
+            : null,
+  )
   const automationSection = h('div', { className: 'capital-config-automation' },
+    workspaceSection,
     automationGroup('automationScheduleGroup', [
       h('div', { className: 'capital-config-grid' },
         automationNumber('tickMs', 'automationTick'),
@@ -1008,6 +1230,7 @@ function CapitalCard(props) {
         setTab(next)
         // Re-read on every switch to this tab: a previous failure retries here.
         if (next === 'components') props.ensureBundleRows()
+        if (next === 'automation') props.ensureWorkspaces()
         // Re-pin only when entering Skills, so the row under the cursor never jumps.
         if (next === 'skills') setPinnedSkills(enabledKeys())
       },

package/config/index.js

@@ -83,6 +83,7 @@ export const Config = z.object({
     maxSteps: z.number().default(300).volatile().description('单次运行最大步骤数（100–2000）'),
     maxToolCalls: z.number().default(1_200).volatile().description('单次运行最大工具调用数（100–5000）'),
     inAppNotifications: z.boolean().default(true).volatile().description('是否写入应用内通知'),
+    defaultWorkspaceId: z.string().default('').volatile().description('统一默认工作区 id；空 = 专属默认工作区'),
   }).default({
     tickMs: 60_000,
     runTimeoutMinutes: 60,
@@ -90,6 +91,7 @@ export const Config = z.object({
     maxSteps: 300,
     maxToolCalls: 1_200,
     inAppNotifications: true,
+    defaultWorkspaceId: '',
   }).description('投研自动化默认值；任务级覆盖优先'),
   retriever: z.object({
     baseURL: z.string().default('').volatile().description('AnySearch API 地址'),

package/config/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v587d/config",
-  "version": "2.15.1",
+  "version": "2.16.0",
   "description": "自动模式的取数凭据与偏好配置行：卡片坐在 @v587d/capital-generation 插件主页的「配置」段，点这一行本身没有表单。",
   "license": "MIT",
   "type": "module",

package/lib/agents/root-tool-policy.d.ts

@@ -2,8 +2,8 @@
  * Root Agent tool convergence on the root's own scope: preset-level deny would also hit
  * children. Listeners must live on `ctx.root`; tagged standing-scope listeners miss agent/created.
  */
-/** Outbound tools (search 2 + wind 2 + named sources 9); `ocr` is excluded because only its url form is restricted. */
-export declare const RETRIEVAL_DENIED_TOOLS: readonly ["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"];
+/** Outbound tools (search 2 + wind 2 + named sources 11); `ocr` is excluded because only its url form is restricted. */
+export declare const RETRIEVAL_DENIED_TOOLS: readonly ["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", "eastmoney_announcements", "eastmoney_announcement_body", "sina_reports", "ths_eps_forecast"];
 export declare const OCR_TOOL_NAME = "ocr";
 /** Name-level deny cannot express the form distinction; this is a call-level guard. */
 export declare const OCR_ROOT_URL_DENIED: string;
@@ -12,7 +12,7 @@ export declare function ocrUrlFormRequested(exec: GuardedExecution | undefined):
 export declare function ocrFormGuardReasonFor(ctx: PolicyContext): (exec: GuardedExecution | undefined) => string | undefined;
 /** Mounted as a platform pair; recognize both everywhere or the other platform's gate is dead. */
 export declare const SHELL_TOOL_NAMES: readonly ["bash", "pwsh"];
-export declare const ROOT_AGENT_DENIED_TOOLS: readonly ["render_chart", "prepare_chart_source", "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", "write", "edit"];
+export declare const ROOT_AGENT_DENIED_TOOLS: readonly ["render_chart", "prepare_chart_source", "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", "eastmoney_announcements", "eastmoney_announcement_body", "sina_reports", "ths_eps_forecast", "write", "edit"];
 export declare const CAPITAL_PRESET_ID = "capital-generation";
 interface ToolRestriction {
     allow?: readonly string[];

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/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"];