@yejiming/dsh-data-agent 0.0.10 → 0.0.12

package/lib/types/client/locales.d.ts

@@ -40,12 +40,15 @@ export declare const zh: {
     'state.disconnected': string;
     'state.checking': string;
     'state.reconnecting': string;
+    'state.reconnectRequired': string;
     'workbench.open.connected': string;
     'workbench.open.disconnected': string;
     'workbench.open.checking': string;
     'workbench.open.error': string;
+    'workbench.open.reconnectRequired': string;
     'composer.placeholder.disconnected': string;
     'composer.placeholder.connected': string;
+    'composer.placeholder.reconnectRequired': string;
     'wb.workbench.title': string;
     'wb.workbench.description': string;
     'wb.workbench.tabs': string;
@@ -125,12 +128,15 @@ export declare const en: {
     'state.disconnected': string;
     'state.checking': string;
     'state.reconnecting': string;
+    'state.reconnectRequired': string;
     'workbench.open.connected': string;
     'workbench.open.disconnected': string;
     'workbench.open.checking': string;
     'workbench.open.error': string;
+    'workbench.open.reconnectRequired': string;
     'composer.placeholder.disconnected': string;
     'composer.placeholder.connected': string;
+    'composer.placeholder.reconnectRequired': string;
     'wb.workbench.title': string;
     'wb.workbench.description': string;
     'wb.workbench.tabs': string;

package/lib/types/client/persistence.d.ts

@@ -24,7 +24,7 @@ export interface SavedConnection {
     /** Non-secret credential reference; mutually exclusive with `password`. */
     passwordRef?: string;
     /** Explicit form mode; absent legacy records infer it from passwordRef. */
-    credentialMode?: 'password' | 'reference';
+    credentialMode?: 'none' | 'password' | 'reference';
     /** Opt-in flag; when true, {@link saveConnection} may write `password`. */
     persistPassword?: boolean;
     readonly?: boolean;

package/lib/types/connections.d.ts

@@ -14,6 +14,8 @@ import { type QueryResult } from './query.ts';
 export declare const WILDCARD_SESSION = "*";
 /** Supported database client kinds. */
 export type DatabaseType = 'mysql' | 'postgres' | 'sqlite' | 'oracle' | 'hive' | 'impala';
+/** How a non-SQLite profile authenticates without ever persisting a secret. */
+export type CredentialMode = 'none' | 'password' | 'reference';
 /** Safe credential facts returned to UI/command surfaces. */
 export interface CredentialSummary {
     configured: boolean;
@@ -38,6 +40,8 @@ export interface DatabaseConnectionInput {
 }
 /** Runtime connection. `tables` and temporary `password` are never durable. */
 export interface DatabaseConnection extends DatabaseConnectionInput {
+    /** Internal authentication shape retained in the non-secret durable profile. */
+    credentialMode?: CredentialMode;
     tables?: string[];
 }
 /** Password-free public connection view. */
@@ -53,6 +57,11 @@ export interface ConnectionSummary {
     name?: string;
     tables?: string[];
     credential?: CredentialSummary;
+    credentialMode?: CredentialMode;
+    /** True only when the current process can execute a database operation now. */
+    ready?: boolean;
+    /** A saved profile exists, but its credential must be supplied/configured again. */
+    reconnectRequired?: boolean;
 }
 /** Value stored in the `profiles` domain table. Never add secrets here. */
 export interface PersistedConnectionProfile {
@@ -64,6 +73,7 @@ export interface PersistedConnectionProfile {
     database: string;
     readonly?: boolean;
     passwordRef?: string;
+    credentialMode?: CredentialMode;
     updatedAt: string;
 }
 /** Value stored in the `bindings` domain table. */

package/lib/types/index.d.ts

@@ -166,12 +166,11 @@ export declare function resolveDshHome(env?: Record<string, string | undefined>)
 /**
  * Install the packaged `preset/data-agent/` directory into
  * `$DSH_HOME/.agent-presets/<presetId>/`. Idempotent: an existing target is
- * normally left untouched. The exact package-owned 0.0.9 composition is
- * migrated once because its two dynamic package rows are incompatible with
- * DSH Desktop's unpacked-ASAR loader; user-edited compositions are never
- * overwritten. `installPreset: false` never calls this. Best-effort — a
- * failure logs a warning with manual install instructions instead of failing
- * the boot.
+ * normally left untouched. Exact package-owned legacy compositions are
+ * migrated once when their runtime contract changes; user-edited compositions
+ * are never overwritten. `installPreset: false` never calls this. Best-effort
+ * — a failure logs a warning with manual install instructions instead of
+ * failing the boot.
  */
 export declare function installPreset(ctx: Context, presetId: string): Promise<boolean>;
 /** Public for regression tests of the non-destructive preset migration gate. */

package/lib/types/presentation-text.d.ts

@@ -0,0 +1,3 @@
+/** Surface-neutral control-sequence sanitization for generic tool cards. */
+/** Remove control effects while keeping their presence visible to the user. */
+export declare function sanitizePresentationText(value: unknown): string;

package/lib/types/storage.d.ts

@@ -31,6 +31,11 @@ export declare const persistedConnectionProfileSchema: z.ZodObject<{
     database: z.ZodString;
     readonly: z.ZodOptional<z.ZodBoolean>;
     passwordRef: z.ZodOptional<z.ZodString>;
+    credentialMode: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        password: "password";
+        reference: "reference";
+    }>>;
     updatedAt: z.ZodString;
 }, z.core.$strict>;
 /** Durable session-to-profile binding schema. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@yejiming/dsh-data-agent",
   "description": "Data Agent for DSH Web and TUI: shared database connections, a masked TUI form, secure credential references, SQL tools, and the data-agent preset",
-  "version": "0.0.10",
+  "version": "0.0.12",
   "publishConfig": {
     "access": "public"
   },
@@ -78,25 +78,25 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-tool": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-commands": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-credentials": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-scope": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-storage": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-storage-domain": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-storage-json": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-subprocess": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-user-questions": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-agent": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-tool": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-commands": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-credentials": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-scope": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-storage": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-storage-domain": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-storage-json": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-subprocess": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-user-questions": "^0.1.0-rc.7",
     "react": "^18.2.0 || ^19.0.0"
   },
   "peerDependenciesMeta": {
@@ -130,26 +130,26 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-tool": "0.1.0-rc.6",
-    "@deepseek-ai/dsh-commands": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-credentials": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-scope": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-storage": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-storage-domain": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-storage-json": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-subprocess": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-subprocess-local": "0.1.0-rc.6",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-user-questions": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-agent": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-tool": "0.1.0-rc.7",
+    "@deepseek-ai/dsh-commands": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-credentials": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-scope": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-storage": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-storage-domain": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-storage-json": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-subprocess": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-subprocess-local": "0.1.0-rc.7",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-user-questions": "^0.1.0-rc.7",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
     "@types/node": "^25.0.0",

package/preset/data-agent/agent.cordis.yml

@@ -27,9 +27,11 @@
       你是数据工程师 Agent。工作目录 {{cwd}}。可用工具：sql-query（只读 SQL，返回结构化
       JSON 结果）、sql-write（写/管理 SQL，单条自动提交）、sql-cmd（原始客户端输出，兼容
       SHOW TABLES、DESCRIBE users 等命令）、str_replace_editor（查看、创建和修改本地文件）。
-      Web 界面可用时另有 render-analysis：把一次调用渲染成一份版本化分析报告（1-6 个只读
-      数据集、1-8 个 metric/line/bar/pie/scatter/table 视图，同一数据集可被多个视图通过
-      datasetId 复用）。是否生成分析由你自主判断：先用 sql-query 探查表结构与样例数据并
+      另有 render-analysis：把一次调用渲染成一份版本化分析
+      报告（1-6 个只读数据集、1-8 个 metric/line/bar/pie/scatter/table 视图，同一数据集可被
+      多个视图通过 datasetId 复用），并在当前工作目录的 analysis-reports/ 中保存离线 HTML
+      Dashboard。Web 可同时打开分析面板；TUI 只返回 HTML 路径，不输出字符图。是否生成分析
+      由你自主判断：先用 sql-query 探查表结构与样例数据并
       核对事实（禁止臆造表名与列名）；schema 探查、单标量或原始明细等无视觉增益的查询
       直接回答、不强制画图；简单关系可生成一个主图，涉及多指标、时间或分群的复杂问题可
       生成 3-6 个互补视图。聚合、Top N、排序必须写在 SQL 中，line/time 数据需 ORDER BY。