@tita-agent/dsh-data-table 0.0.0-stage → 0.2.0

package/package.json

@@ -1,6 +1,109 @@
 {
   "name": "@tita-agent/dsh-data-table",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "description": "Univer spreadsheet terminal (Table): Agent and user edits share revisioned workbook operations through the official right Sidebar + CSV export",
+  "version": "0.2.0",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "lib/types/index.js",
+  "types": "lib/types/index.d.ts",
+  "imports": {
+    "#contracts": {
+      "types": "./lib/contracts.d.ts",
+      "default": "./lib/contracts.js"
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/types/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/types/invariant.js"
+    },
+    "./client": "./lib/client.js",
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "src",
+    "cordis.patch.yml"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@tita-agent/dsh-surface-bridge",
+        "@deepseek-ai/dsh-client-ui-sidebar-right",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-primitives",
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-ui-renderer"
+      ]
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "~4.0.4",
+    "@deepseek-ai/dsh-client-connection": ">=0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-locale": ">=0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": ">=0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-layout": ">=0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": ">=0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": ">=0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-sidebar-right": ">=0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.2.0-rc.1",
+    "@deepseek-ai/dsh-tools": ">=0.2.0-rc.1",
+    "@deepseek-ai/dsh-util-values": ">=0.2.0-rc.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "~4.0.4",
+    "@deepseek-ai/dsh-agent": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-connection": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-locale": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-layout": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-sidebar-right": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-invariants": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-llm": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-ptc-runtime": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-sandbox": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-sandbox-policy": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-scope": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-session": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-tools": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-user-approval": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-util-values": "0.2.0-rc.1",
+    "@types/node": "^26.0.0",
+    "@types/react": "~18.3.1",
+    "@univerjs/presets": "0.25.1",
+    "@univerjs/sheets-crosshair-highlight": "0.25.1",
+    "@univerjs/ui": "0.25.1",
+    "esbuild": "^0.25.0",
+    "lightningcss": "^1.28.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "rxjs": "^7.8.2",
+    "typescript": "^5.9.0",
+    "@tita-agent/ui": "0.1.0"
+  },
+  "dependencies": {
+    "xlsx": "^0.18.5",
+    "@tita-agent/dsh-surface-bridge": "0.1.0"
+  },
+  "scripts": {
+    "build": "pnpm --filter @tita-agent/ui build && rm -rf lib && node ../../scripts/copy-plugin-contracts.mjs && tsc -p tsconfig.json && node build-client.mjs",
+    "test": "pnpm build && node --test tests/*.test.mjs",
+    "sync:profile": "node scripts/sync-profile.mjs"
+  }
 }

package/src/audit.ts

@@ -0,0 +1,58 @@
+/**
+ * Audit lineage (docs/issue/0022 P3).
+ *
+ * Workbook writes carry who asked for them: the ids the model passed, filled in
+ * from the active intent recorder when it is installed. Both transports need
+ * this — the browser sends them in a request body, the Agent receives them in
+ * tool arguments — so it is neither one's private concern.
+ */
+import type { LineageContext } from '#contracts'
+
+export function lineageOfValue(value: unknown): LineageContext | undefined {
+  if (typeof value !== 'object' || value === null || Array.isArray(value)) return undefined
+  const args = value as Record<string, unknown>
+  const lineage: LineageContext = {}
+  const fields: Array<[keyof LineageContext, string]> = [
+    ['sessionId', 'sessionId'], ['turnId', 'turnId'], ['intentId', 'intentId'],
+    ['taskId', 'taskId'], ['subtaskId', 'subtaskId'], ['parentSubtaskId', 'parentSubtaskId'], ['runId', 'runId'],
+    ['traceId', 'traceId'], ['domain', 'domain'],
+  ]
+  for (const [target, source] of fields) if (typeof args[source] === 'string' && args[source].trim()) lineage[target] = args[source].trim().slice(0, 160)
+  return Object.keys(lineage).length > 0 ? lineage : undefined
+}
+
+/**
+ * Active-recorder lineage supplied by `dsh-data-domain-knowledge`'s intent
+ * service (`titaDataAgentIntent`; the module was its own package until 0020).
+ * Optional: without the recorder plugin, workbook writes keep carrying only the
+ * lineage the model passed explicitly.
+ */
+export interface LineageProvider {
+  activeLineage(sessionKey: string): { lineage: Partial<LineageContext>; committed: boolean } | undefined
+}
+
+/**
+ * The scope the intent recorder is resolved from. `apply()` sets it once; it is
+ * module state because the recorder is a host service rather than an argument.
+ */
+export let lineageScope: { get(name: string, strict?: boolean): unknown } | undefined
+
+export function setLineageScope(scope: { get(name: string, strict?: boolean): unknown } | undefined): void {
+  lineageScope = scope
+}
+
+export function lineageProvider(): LineageProvider | undefined {
+  const scope = lineageScope
+  // Test harnesses pass a minimal context; only a real cordis scope can resolve services.
+  if (typeof scope?.get !== 'function') return undefined
+  return scope.get('titaDataAgentIntent', false) as LineageProvider | undefined
+}
+
+export function lineageOfArgs(args: Record<string, unknown>, exec?: { agent?: { session?: { header?: { id?: string } } } }): LineageContext | undefined {
+  const lineage = lineageOfValue(args)
+  const sessionId = lineage?.sessionId ?? exec?.agent?.session?.header?.id
+  if (!sessionId) return lineage
+  // Explicit arguments win; the recorder only fills the ids a call omitted.
+  const inherited = lineageProvider()?.activeLineage(sessionId)?.lineage
+  return { sessionId, ...inherited, ...lineage }
+}

package/src/client/ProjectImportMenu.tsx

@@ -0,0 +1,100 @@
+/**
+ * The workbook import menu, and the chooser behind it.
+ *
+ * Import used to start and end in the operating system's file dialog. It now
+ * starts in the project: the menu opens a listing of `<project>/storages` with
+ * each file's creation and modification time, because a project that keeps its
+ * data beside itself should offer its own files first.
+ *
+ * It is still not a wall. Containment says where a project's files live, not
+ * what a user may open, so the chooser's footer keeps "从项目外导入…" — the same
+ * OS dialog as before, one click away rather than two.
+ *
+ * The bytes of a chosen file are read by the Host (a browser cannot open a path),
+ * and from there the pipeline is the one that already existed: the buffer goes
+ * back as `data-sheet:import-bytes` and `univer/plugins/export.ts` parses it.
+ *
+ * @module dsh-data-table/client/ProjectImportMenu
+ */
+import { useState, type ReactElement } from 'react'
+import { FilePickerDialog, ToolbarMenu } from '@tita-agent/ui'
+import { FileSpreadsheet, FileText, Upload } from '@tita-agent/ui/icons'
+import { fetchProjectFiles, readProjectFile, type ProjectFileEntry } from './transport/workbookApi.ts'
+
+/** The two formats the workbook import understands. */
+type ImportFormat = 'xlsx' | 'csv'
+
+/** Extensions each format accepts, as the chooser's filter. */
+const ACCEPT: Record<ImportFormat, string[]> = { xlsx: ['.xlsx', '.xls'], csv: ['.csv'] }
+
+/** Copy for each format, used in the menu hint and the dialog's title. */
+const FORMAT_LABEL: Record<ImportFormat, string> = { xlsx: 'Excel', csv: 'CSV' }
+
+export interface ProjectImportMenuProps {
+  /** True while no workbook is open: importing has nowhere to land. */
+  disabled: boolean
+}
+
+/**
+ * The 导入 menu plus the project file chooser it opens.
+ *
+ * @param props - See {@link ProjectImportMenuProps}.
+ * @returns the menu and, when open, the chooser.
+ */
+export function ProjectImportMenu({ disabled }: ProjectImportMenuProps): ReactElement {
+  const [format, setFormat] = useState<ImportFormat | null>(null)
+
+  /** Hand a chosen file's bytes to the import pipeline. */
+  const readAndImport = (entry: ProjectFileEntry, chosen: ImportFormat): void => {
+    setFormat(null)
+    void readProjectFile(entry.path)
+      .then(file => {
+        window.dispatchEvent(new CustomEvent('data-sheet:import-bytes', {
+          detail: { data: file.data, name: file.name, format: chosen },
+        }))
+      })
+      .catch((error: unknown) => {
+        // The panel already listens for this event, so a failure to read the
+        // file reports itself the same way a failure to parse it does.
+        window.dispatchEvent(new CustomEvent('data-sheet:import-error', {
+          detail: { message: error instanceof Error ? error.message : String(error) },
+        }))
+      })
+  }
+
+  return (
+    <>
+      <ToolbarMenu
+        label="导入"
+        icon={<Upload size={14} aria-hidden="true" />}
+        disabled={disabled}
+        groups={[{
+          items: [
+            { id: 'xlsx', label: '导入 Excel', hint: '从项目 storages/ 选择文件', icon: <FileSpreadsheet size={15} aria-hidden="true" />, onSelect: () => { setFormat('xlsx') } },
+            { id: 'csv', label: '导入 CSV', hint: '从项目 storages/ 选择文件', icon: <FileText size={15} aria-hidden="true" />, onSelect: () => { setFormat('csv') } },
+          ],
+        }]}
+      />
+      {format !== null && (
+        <FilePickerDialog
+          open
+          onOpenChange={next => { if (!next) setFormat(null) }}
+          title={`导入 ${FORMAT_LABEL[format]} 文件`}
+          description={`选择项目 storages/ 下的文件；内容读入当前工作簿，原文件不会被移动或改动。`}
+          accept={ACCEPT[format]}
+          load={fetchProjectFiles}
+          onPick={entry => { readAndImport(entry, format) }}
+          onImportOutside={() => {
+            const outside = format
+            setFormat(null)
+            // Literal event names rather than a template: the Univer bridge is
+            // looked up by these exact strings, and a name assembled at runtime
+            // is a bridge nobody can grep for.
+            if (outside === 'csv') window.dispatchEvent(new CustomEvent('data-sheet:request-import-csv'))
+            else window.dispatchEvent(new CustomEvent('data-sheet:request-import-xlsx'))
+          }}
+        />
+      )}
+    </>
+  )
+}