@yejiming/dsh-data-agent 0.0.12 → 0.0.13

package/lib/defaults-Cngd8Tf8.js

@@ -0,0 +1,131 @@
+//#region src/database-types.ts
+/**
+* Browser-safe database type descriptors shared by every DSH surface.
+* Keep this module dependency-free: server-only client/process details belong
+* in the database adapters, not in Web or persistence bundles.
+*/
+const DATABASE_TYPES = [
+	"mysql",
+	"postgres",
+	"sqlite",
+	"oracle",
+	"hive",
+	"impala",
+	"clickhouse",
+	"doris",
+	"sqlserver"
+];
+const DATABASE_TYPE_DESCRIPTORS = {
+	mysql: {
+		type: "mysql",
+		label: "MySQL",
+		localeKey: "type.mysql",
+		defaultPort: 3306,
+		defaultUser: "root",
+		fileBased: false
+	},
+	postgres: {
+		type: "postgres",
+		label: "PostgreSQL",
+		localeKey: "type.postgres",
+		defaultPort: 5432,
+		defaultUser: "postgres",
+		fileBased: false
+	},
+	sqlite: {
+		type: "sqlite",
+		label: "SQLite",
+		localeKey: "type.sqlite",
+		defaultPort: 0,
+		defaultUser: "",
+		fileBased: true
+	},
+	oracle: {
+		type: "oracle",
+		label: "Oracle",
+		localeKey: "type.oracle",
+		defaultPort: 1521,
+		defaultUser: "",
+		fileBased: false
+	},
+	hive: {
+		type: "hive",
+		label: "Hive",
+		localeKey: "type.hive",
+		defaultPort: 1e4,
+		defaultUser: "",
+		fileBased: false
+	},
+	impala: {
+		type: "impala",
+		label: "Impala",
+		localeKey: "type.impala",
+		defaultPort: 21050,
+		defaultUser: "",
+		fileBased: false
+	},
+	clickhouse: {
+		type: "clickhouse",
+		label: "ClickHouse",
+		localeKey: "type.clickhouse",
+		defaultPort: 8123,
+		securePort: 8443,
+		defaultUser: "default",
+		fileBased: false
+	},
+	doris: {
+		type: "doris",
+		label: "Apache Doris",
+		localeKey: "type.doris",
+		defaultPort: 9030,
+		defaultUser: "root",
+		fileBased: false
+	},
+	sqlserver: {
+		type: "sqlserver",
+		label: "SQL Server",
+		localeKey: "type.sqlserver",
+		defaultPort: 1433,
+		defaultUser: "sa",
+		fileBased: false
+	}
+};
+function isDatabaseType(value) {
+	return typeof value === "string" && DATABASE_TYPES.includes(value);
+}
+function defaultDatabasePort(type, secure = false) {
+	const descriptor = DATABASE_TYPE_DESCRIPTORS[type];
+	return secure && descriptor.securePort !== void 0 ? descriptor.securePort : descriptor.defaultPort;
+}
+function defaultDatabaseUser(type) {
+	return DATABASE_TYPE_DESCRIPTORS[type].defaultUser;
+}
+function databaseTypeLabel(type) {
+	return DATABASE_TYPE_DESCRIPTORS[type].label;
+}
+//#endregion
+//#region src/defaults.ts
+/**
+* Package-wide defaults shared by the server half (`src/index.ts`) and the
+* database tool half (`src/tool.ts`). Loader schemas carry these as their
+* defaults so a deployment may override every one of them in cordis.yml.
+* @module @yejiming/dsh-data-agent/defaults
+*/
+/** Preset directory name installed into `$DSH_HOME/.agent-presets/`. */
+const DEFAULT_PRESET_ID = "data-agent";
+/** End-to-end deadline for one `/connect` connectivity check, milliseconds. */
+const DEFAULT_CONNECT_TIMEOUT_MS = 1e4;
+/** End-to-end deadline for one database-tool query, milliseconds. */
+const DEFAULT_QUERY_TIMEOUT_MS = 3e4;
+/** In-memory cap on database-tool captured output (stdout and stderr each). */
+const DEFAULT_MAX_RESULT_CHARS = 2e4;
+/** Hard row cap for one structured Web workbench result/export. */
+const WORKBENCH_MAX_EXPORT_ROWS = 5e4;
+/** Bounded capture size for the larger structured Web workbench result. */
+const WORKBENCH_MAX_RESULT_CHARS = 33554432;
+/** Cap on one /query SQL text length (abuse guard; the wire body stays small). */
+const DEFAULT_MAX_QUERY_CHARS = 65536;
+/** Grace period for the subprocess terminate escalation. */
+const DEFAULT_GRACE_MS = 5e3;
+//#endregion
+export { DEFAULT_PRESET_ID as a, WORKBENCH_MAX_RESULT_CHARS as c, defaultDatabasePort as d, defaultDatabaseUser as f, DEFAULT_MAX_RESULT_CHARS as i, DATABASE_TYPES as l, DEFAULT_GRACE_MS as n, DEFAULT_QUERY_TIMEOUT_MS as o, isDatabaseType as p, DEFAULT_MAX_QUERY_CHARS as r, WORKBENCH_MAX_EXPORT_ROWS as s, DEFAULT_CONNECT_TIMEOUT_MS as t, databaseTypeLabel as u };

package/lib/ecosystem.js

@@ -0,0 +1,19 @@
+import { defineFacet } from "@dsh-std/sdk";
+//#region src/ecosystem.ts
+/**
+* Community v0.15 host facet.
+*
+* This facet intentionally publishes no commands, tools, UI, routes, storage,
+* credentials, or database effects. The existing Cordis bundle remains the
+* sole functional runtime so hosts may discover the ecosystem declaration
+* without double-registering data-agent behavior.
+*/
+/** Stable degraded snapshot for declaration-only ecosystem discovery. */
+const ECOSYSTEM_SNAPSHOT = Object.freeze({
+	state: "degraded",
+	message: "Native Cordis runtime owns all data-agent effects; this facet publishes declarations only.",
+	extensions: Object.freeze([])
+});
+const ecosystemFacet = defineFacet(() => void 0, () => void 0, () => ECOSYSTEM_SNAPSHOT);
+//#endregion
+export { ECOSYSTEM_SNAPSHOT, ecosystemFacet as default };

package/lib/index.js

@@ -1,7 +1,7 @@
-import { o as clientsSchema, t as createConnectionService } from "./connections-5sfdEDsG.js";
-import { a as DEFAULT_PRESET_ID, i as DEFAULT_MAX_RESULT_CHARS, o as DEFAULT_QUERY_TIMEOUT_MS, r as DEFAULT_MAX_QUERY_CHARS, t as DEFAULT_CONNECT_TIMEOUT_MS } from "./defaults-DP4RyRh1.js";
-import { r as apply$1 } from "./command-DuCpwVbl.js";
-import { n as apply$2 } from "./tool-DgL0fBfj.js";
+import { a as DEFAULT_PRESET_ID, i as DEFAULT_MAX_RESULT_CHARS, l as DATABASE_TYPES, o as DEFAULT_QUERY_TIMEOUT_MS, r as DEFAULT_MAX_QUERY_CHARS, t as DEFAULT_CONNECT_TIMEOUT_MS } from "./defaults-Cngd8Tf8.js";
+import { c as clientsSchema, t as createConnectionService } from "./connections-CHY4uB6z.js";
+import { r as apply$1 } from "./command-utC5MHd9.js";
+import { n as apply$2 } from "./tool-ZTOS4B33.js";
 import { createHash } from "node:crypto";
 import { access, cp, mkdir, readFile, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
@@ -29,19 +29,13 @@ const CONNECTION_STORAGE_DOMAIN = "data_agent_connections";
 /** Durable profile schema. There is deliberately no `password` field. */
 const persistedConnectionProfileSchema = z$1.object({
 	name: z$1.string().min(1).optional(),
-	type: z$1.enum([
-		"mysql",
-		"postgres",
-		"sqlite",
-		"oracle",
-		"hive",
-		"impala"
-	]),
+	type: z$1.enum(DATABASE_TYPES),
 	host: z$1.string().optional(),
 	port: z$1.number().int().min(1).max(65535).optional(),
 	user: z$1.string().optional(),
 	database: z$1.string().min(1),
 	readonly: z$1.boolean().optional(),
+	secure: z$1.boolean().optional(),
 	passwordRef: z$1.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/).optional(),
 	credentialMode: z$1.enum([
 		"none",
@@ -57,19 +51,13 @@ const sessionConnectionBindingSchema = z$1.object({
 }).strict();
 /** Session form draft schema. Secret-shaped fields are rejected by strict mode. */
 const persistedConnectionFormDraftSchema = z$1.object({
-	type: z$1.enum([
-		"mysql",
-		"postgres",
-		"sqlite",
-		"oracle",
-		"hive",
-		"impala"
-	]),
+	type: z$1.enum(DATABASE_TYPES),
 	host: z$1.string(),
 	port: z$1.string(),
 	user: z$1.string(),
 	database: z$1.string(),
 	readonly: z$1.boolean(),
+	secure: z$1.boolean().optional(),
 	updatedAt: z$1.string().min(1)
 }).strict();
 /** Single source of truth for the storage layout and durable validation. */
@@ -82,6 +70,15 @@ const connectionStorageSpec = defineDomain({
 		drafts: domainTable(persistedConnectionFormDraftSchema)
 	}
 });
+/** Select the newest successful profile with a deterministic id tie-break. */
+function latestConnectionProfile(entries) {
+	let latest;
+	for (const [profileId, profile] of entries) if (latest === void 0 || profile.updatedAt > latest.profile.updatedAt || profile.updatedAt === latest.profile.updatedAt && profileId > latest.profileId) latest = {
+		profileId,
+		profile
+	};
+	return latest;
+}
 /** Project a typed DSH domain handle onto the service's persistence seam. */
 function createDomainConnectionPersistence(domain) {
 	const profiles = domain.table("profiles");
@@ -91,6 +88,9 @@ function createDomainConnectionPersistence(domain) {
 		getProfile(profileId) {
 			return profiles.get(profileId);
 		},
+		getLatestProfile() {
+			return latestConnectionProfile(profiles.entries());
+		},
 		putProfile(profileId, profile) {
 			return profiles.put(profileId, profile);
 		},
@@ -111,6 +111,9 @@ function createDomainConnectionPersistence(domain) {
 		},
 		putDraft(sessionId, draft) {
 			return drafts.put(sessionId, draft);
+		},
+		deleteDraft(sessionId) {
+			return drafts.delete(sessionId);
 		}
 	};
 }
@@ -163,13 +166,17 @@ const Config = z.object({
 			z.const("sqlite"),
 			z.const("oracle"),
 			z.const("hive"),
-			z.const("impala")
+			z.const("impala"),
+			z.const("clickhouse"),
+			z.const("doris"),
+			z.const("sqlserver")
 		]),
 		host: z.string(),
 		port: z.natural(),
 		user: z.string(),
 		database: z.string(),
 		readonly: z.boolean(),
+		secure: z.boolean(),
 		passwordRef: z.string().pattern(/^[A-Za-z_][A-Za-z0-9_]*$/),
 		password: z.never().hidden()
 	})).default({})
@@ -306,7 +313,8 @@ async function apply(ctx, config) {
 				...spec.port !== void 0 ? { port: spec.port } : {},
 				...spec.user !== void 0 ? { user: spec.user } : {},
 				...spec.passwordRef !== void 0 ? { passwordRef: spec.passwordRef } : {},
-				...spec.readonly !== void 0 ? { readonly: spec.readonly } : {}
+				...spec.readonly !== void 0 ? { readonly: spec.readonly } : {},
+				...spec.secure !== void 0 ? { secure: spec.secure } : {}
 			};
 			store.set(sessionId, connection);
 		}

package/lib/routes.js

@@ -1,4 +1,4 @@
-import { i as DEFAULT_MAX_RESULT_CHARS, o as DEFAULT_QUERY_TIMEOUT_MS, r as DEFAULT_MAX_QUERY_CHARS, t as DEFAULT_CONNECT_TIMEOUT_MS } from "./defaults-DP4RyRh1.js";
+import { i as DEFAULT_MAX_RESULT_CHARS, l as DATABASE_TYPES, o as DEFAULT_QUERY_TIMEOUT_MS, p as isDatabaseType, r as DEFAULT_MAX_QUERY_CHARS, t as DEFAULT_CONNECT_TIMEOUT_MS } from "./defaults-Cngd8Tf8.js";
 import { resolve } from "node:path";
 import z from "schemastery";
 //#region src/routes.ts
@@ -20,12 +20,13 @@ function validateConnectBody(value, cwd = process.cwd()) {
 	const candidate = value;
 	const sessionId = requireString(candidate.sessionId, "sessionId");
 	const type = candidate.type;
-	if (!isDatabaseType(type)) throw new Error("type 必须是 \"mysql\"、\"postgres\"、\"sqlite\"、\"oracle\"、\"hive\" 或 \"impala\"");
+	if (!isDatabaseType(type)) throw new Error(`type 必须是受支持的数据库类型：${DATABASE_TYPES.join("、")}`);
 	const database = requireString(candidate.database, "database");
 	const password = optionalString(candidate.password, "password");
 	const passwordRef = optionalString(candidate.passwordRef, "passwordRef");
 	if (password !== void 0 && passwordRef !== void 0) throw new Error("password 与 passwordRef 不能同时提供");
 	const readonly = optionalBoolean(candidate.readonly, "readonly");
+	const secure = optionalBoolean(candidate.secure, "secure");
 	const profileId = optionalString(candidate.profileId, "profileId");
 	const profileName = optionalString(candidate.name, "name");
 	const request = {
@@ -34,6 +35,7 @@ function validateConnectBody(value, cwd = process.cwd()) {
 		database: type === "sqlite" ? resolve(cwd, database) : database
 	};
 	if (readonly !== void 0) request.readonly = readonly;
+	if (type === "clickhouse" && secure !== void 0) request.secure = secure;
 	if (profileId !== void 0) request.profileId = profileId;
 	if (profileName !== void 0) request.name = profileName;
 	if (type === "sqlite") return request;
@@ -133,7 +135,7 @@ function apply(ctx, _config) {
 							const sql = requireString(body.sql, "sql");
 							writeJson(200, {
 								ok: true,
-								result: await scope.dataAgentConnections.query(sessionId, sql, signal)
+								result: await scope.dataAgentConnections.executeInteractive(sessionId, sql, signal)
 							});
 							return;
 						}
@@ -177,8 +179,5 @@ function optionalBoolean(value, label) {
 	if (typeof value !== "boolean") throw new Error(`${label} 必须是布尔值`);
 	return value;
 }
-function isDatabaseType(value) {
-	return value === "mysql" || value === "postgres" || value === "sqlite" || value === "oracle" || value === "hive" || value === "impala";
-}
 //#endregion
 export { Config, DATA_AGENT_PATH, apply, inject, name, validateConnectBody };

package/lib/{tool-DgL0fBfj.js → tool-ZTOS4B33.js}

@@ -1,5 +1,5 @@
-import { a as classifyStatement, c as assertSingleStatement, i as runClientQuery, n as redactQueryResult, o as clientsSchema, r as redactSecretText, s as enforceReadRowLimit } from "./connections-5sfdEDsG.js";
-import { i as DEFAULT_MAX_RESULT_CHARS, o as DEFAULT_QUERY_TIMEOUT_MS, r as DEFAULT_MAX_QUERY_CHARS } from "./defaults-DP4RyRh1.js";
+import { i as DEFAULT_MAX_RESULT_CHARS, o as DEFAULT_QUERY_TIMEOUT_MS, r as DEFAULT_MAX_QUERY_CHARS } from "./defaults-Cngd8Tf8.js";
+import { a as parseStructuredQueryOutput, c as clientsSchema, l as enforceReadRowLimit, n as redactQueryResult, o as runClientQuery, r as redactSecretText, s as classifyStatement, u as assertSingleStatement } from "./connections-CHY4uB6z.js";
 import { randomUUID } from "node:crypto";
 import { link, mkdir, unlink, writeFile } from "node:fs/promises";
 import { resolve } from "node:path";
@@ -607,168 +607,6 @@ const ANALYSIS_REPORT_OUTPUT_SCHEMA = {
 	additionalProperties: false
 };
 //#endregion
-//#region src/structured.ts
-function normalizeNewlines(text) {
-	return text.replace(/\r\n?/g, "\n");
-}
-function splitLine(line, delimiter) {
-	return line.split(delimiter);
-}
-/** Make column names valid unique JSON object keys. */
-function uniqueColumns(columns) {
-	const used = /* @__PURE__ */ new Set();
-	return columns.map((raw, index) => {
-		let name = raw.trim();
-		if (name.length === 0) name = `column_${index + 1}`;
-		if (used.has(name)) {
-			let suffix = 2;
-			while (used.has(`${name}_${suffix}`)) suffix += 1;
-			name = `${name}_${suffix}`;
-		}
-		used.add(name);
-		return name;
-	});
-}
-function rowObject(columns, fields) {
-	const row = {};
-	for (let index = 0; index < columns.length; index += 1) row[columns[index]] = fields[index] ?? null;
-	return row;
-}
-function emptyOutput() {
-	return {
-		columns: [],
-		rows: [],
-		rowLimitExceeded: false
-	};
-}
-function skipLeadingBlank(lines) {
-	let index = 0;
-	while (index < lines.length && lines[index].trim().length === 0) index += 1;
-	return index;
-}
-/** PostgreSQL `-A` appends a `(N rows)` / `(N row)` footer after SELECT output. */
-function isPostgresFooter(line) {
-	return /^\(\d+ rows?\)$/.test(line.trim());
-}
-function parseDelimited(stdout, delimiter, maxRows, skipFooter = false) {
-	const lines = normalizeNewlines(stdout).split("\n");
-	if (lines.length > 0 && lines[lines.length - 1] === "") lines.pop();
-	const headerIndex = skipLeadingBlank(lines);
-	if (headerIndex >= lines.length) return emptyOutput();
-	const columns = uniqueColumns(splitLine(lines[headerIndex], delimiter));
-	const rows = [];
-	let rowLimitExceeded = false;
-	for (let index = headerIndex + 1; index < lines.length; index += 1) {
-		const line = lines[index];
-		if (skipFooter && isPostgresFooter(line)) continue;
-		if (rows.length >= maxRows) {
-			rowLimitExceeded = true;
-			break;
-		}
-		rows.push(rowObject(columns, splitLine(line, delimiter)));
-	}
-	return {
-		columns,
-		rows,
-		rowLimitExceeded
-	};
-}
-/** Minimal RFC-4180-style parser for sqlite3 `-csv` output. */
-function parseCsv(text) {
-	const records = [];
-	let record = [];
-	let field = "";
-	let quoted = false;
-	let index = 0;
-	const pushField = () => {
-		record.push(field);
-		field = "";
-	};
-	const pushRecord = () => {
-		pushField();
-		records.push(record);
-		record = [];
-	};
-	while (index < text.length) {
-		const char = text[index];
-		if (quoted) {
-			if (char === "\"") {
-				if (text[index + 1] === "\"") {
-					field += "\"";
-					index += 2;
-					continue;
-				}
-				quoted = false;
-				index += 1;
-				continue;
-			}
-			field += char;
-			index += 1;
-			continue;
-		}
-		if (char === "\"" && field.length === 0) {
-			quoted = true;
-			index += 1;
-			continue;
-		}
-		if (char === ",") {
-			pushField();
-			index += 1;
-			continue;
-		}
-		if (char === "\n") {
-			pushRecord();
-			index += 1;
-			continue;
-		}
-		if (char === "\r") {
-			if (text[index + 1] === "\n") index += 1;
-			pushRecord();
-			index += 1;
-			continue;
-		}
-		field += char;
-		index += 1;
-	}
-	if (field.length > 0 || record.length > 0) pushRecord();
-	return records;
-}
-function parseCsvOutput(stdout, maxRows) {
-	const records = parseCsv(normalizeNewlines(stdout)).filter((record) => !(record.length === 1 && record[0] === ""));
-	if (records.length === 0) return emptyOutput();
-	const columns = uniqueColumns(records[0]);
-	const rows = [];
-	let rowLimitExceeded = false;
-	for (let index = 1; index < records.length; index += 1) {
-		if (rows.length >= maxRows) {
-			rowLimitExceeded = true;
-			break;
-		}
-		rows.push(rowObject(columns, records[index]));
-	}
-	return {
-		columns,
-		rows,
-		rowLimitExceeded
-	};
-}
-/**
-* Parse one database type's structured-query stdout. The matching template is
-* `buildStructuredQueryTemplate`: mysql tab-separated with a header, postgres
-* pipe-separated with a header and row-count footer, sqlite CSV with a header,
-* oracle pipe-separated with heading on, hive/impala tsv with a header.
-*/
-function parseStructuredQueryOutput(type, stdout, maxRows) {
-	switch (type) {
-		case "mysql": return parseDelimited(stdout, "	", maxRows);
-		case "postgres": return parseDelimited(stdout, "|", maxRows, true);
-		case "sqlite": return parseCsvOutput(stdout, maxRows);
-		case "oracle": return parseDelimited(stdout, "|", maxRows);
-		case "hive":
-		case "impala": return parseDelimited(stdout, "	", maxRows);
-	}
-}
-//#endregion
 //#region src/structured-read.ts
 /** Look up the session connection, failing with the same message for every tool. */
 async function requireToolConnection(ctx, exec, toolName) {
@@ -803,7 +641,7 @@ function runnerOptions(resolved, mode) {
 /**
 * Execute one read-only SQL through the structured client template and parse
 * it into the canonical { columns, rows } shape, with maxRows enforced at both
-* the SQL level (LIMIT injection) and the parse level.
+* the SQL level (dialect rewrite) and the parse level.
 */
 async function runStructuredReadQuery(ctx, connection, sql, resolved, toolName, signal) {
 	if (sql.trim().length === 0) throw new Error(toolName + ": sql 不能为空");
@@ -1099,7 +937,7 @@ function apply(ctx, config) {
 		parameters: { sql: {
 			type: "string",
 			required: true,
-			description: "一条只读 SQL，如 \"SELECT * FROM orders LIMIT 5;\"、\"SHOW TABLES;\"、\"DESCRIBE users;\""
+			description: "一条符合当前数据库方言的只读 SQL，如 \"SELECT * FROM orders;\"、\"SHOW TABLES;\"、\"DESCRIBE users;\""
 		} },
 		output: {
 			schema: {
@@ -1221,7 +1059,7 @@ function apply(ctx, config) {
 		parameters: { sql: {
 			type: "string",
 			required: true,
-			description: "一条 SQL 文本（或客户端命令），如 \"SHOW TABLES;\"、\"DESCRIBE users;\"、\"SELECT * FROM orders LIMIT 5;\""
+			description: "一条符合当前数据库方言的 SQL 文本（或数据库命令），如 \"SHOW TABLES;\"、\"DESCRIBE users;\"、\"SELECT * FROM orders;\""
 		} },
 		output: {
 			schema: {

package/lib/tool.js

@@ -1,2 +1,2 @@
-import { i as name, n as apply, r as inject, t as Config } from "./tool-DgL0fBfj.js";
+import { i as name, n as apply, r as inject, t as Config } from "./tool-ZTOS4B33.js";
 export { Config, apply, inject, name };

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

@@ -1,6 +1,5 @@
 import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
-/** Database kinds offered by the connection form. */
-export type DatabaseType = 'mysql' | 'postgres' | 'sqlite' | 'oracle' | 'hive' | 'impala';
+export type { DatabaseType } from '../database-types.ts';
 /** The sessions-list slice the workbench needs (structural; avoids a runtime import). */
 export interface SessionListLike {
     byId: Record<string, {

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

@@ -0,0 +1,13 @@
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+export interface StructuredWorkbenchResult {
+    kind: 'table';
+    columns: string[];
+    rows: Record<string, string | null>[];
+    elapsedMs: number;
+    truncated: boolean;
+    maxRows: number;
+}
+export declare function QueryResultTable({ result, t, }: {
+    result: StructuredWorkbenchResult;
+    t: TranslateNS<'data-agent'>;
+}): import("react").JSX.Element;

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

@@ -13,6 +13,9 @@ export declare const zh: {
     'type.oracle': string;
     'type.hive': string;
     'type.impala': string;
+    'type.clickhouse': string;
+    'type.doris': string;
+    'type.sqlserver': string;
     'form.host': string;
     'form.port': string;
     'form.user': string;
@@ -28,6 +31,8 @@ export declare const zh: {
     'form.rememberPassword.hint': string;
     'form.readonly': string;
     'form.readonly.hint': string;
+    'form.secure': string;
+    'form.secure.hint': string;
     'form.database': string;
     'form.database.oracle': string;
     'form.database.hive': string;
@@ -57,10 +62,29 @@ export declare const zh: {
     'wb.columns': string;
     'wb.sql': string;
     'wb.sql.placeholder': string;
+    'wb.sql.placeholder.sqlserver': string;
     'wb.sql.run': string;
     'wb.sql.running': string;
     'wb.sql.shortcut': string;
     'wb.sql.empty': string;
+    'wb.sql.result.summary': string;
+    'wb.sql.result.capped': string;
+    'wb.sql.result.outputTruncated': string;
+    'wb.sql.result.table': string;
+    'wb.sql.result.noRows': string;
+    'wb.sql.command.done': string;
+    'wb.sql.export.actions': string;
+    'wb.sql.export.excel': string;
+    'wb.sql.export.csv': string;
+    'wb.sql.export.clipboard': string;
+    'wb.sql.exporting': string;
+    'wb.sql.copying': string;
+    'wb.sql.export.done': string;
+    'wb.sql.copy.done': string;
+    'wb.sql.export.failed': string;
+    'wb.sql.page.summary': string;
+    'wb.sql.page.previous': string;
+    'wb.sql.page.next': string;
     'wb.loading': string;
     'wb.empty': string;
     'wb.modal.title': string;
@@ -101,6 +125,9 @@ export declare const en: {
     'type.oracle': string;
     'type.hive': string;
     'type.impala': string;
+    'type.clickhouse': string;
+    'type.doris': string;
+    'type.sqlserver': string;
     'form.host': string;
     'form.port': string;
     'form.user': string;
@@ -116,6 +143,8 @@ export declare const en: {
     'form.rememberPassword.hint': string;
     'form.readonly': string;
     'form.readonly.hint': string;
+    'form.secure': string;
+    'form.secure.hint': string;
     'form.database': string;
     'form.database.oracle': string;
     'form.database.hive': string;
@@ -145,10 +174,29 @@ export declare const en: {
     'wb.columns': string;
     'wb.sql': string;
     'wb.sql.placeholder': string;
+    'wb.sql.placeholder.sqlserver': string;
     'wb.sql.run': string;
     'wb.sql.running': string;
     'wb.sql.shortcut': string;
     'wb.sql.empty': string;
+    'wb.sql.result.summary': string;
+    'wb.sql.result.capped': string;
+    'wb.sql.result.outputTruncated': string;
+    'wb.sql.result.table': string;
+    'wb.sql.result.noRows': string;
+    'wb.sql.command.done': string;
+    'wb.sql.export.actions': string;
+    'wb.sql.export.excel': string;
+    'wb.sql.export.csv': string;
+    'wb.sql.export.clipboard': string;
+    'wb.sql.exporting': string;
+    'wb.sql.copying': string;
+    'wb.sql.export.done': string;
+    'wb.sql.copy.done': string;
+    'wb.sql.export.failed': string;
+    'wb.sql.page.summary': string;
+    'wb.sql.page.previous': string;
+    'wb.sql.page.next': string;
     'wb.loading': string;
     'wb.empty': string;
     'wb.modal.title': string;

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

@@ -9,7 +9,7 @@
  * key is versioned so a future shape change can migrate or ignore old data.
  * @module @yejiming/dsh-data-agent/persistence
  */
-import type { DatabaseType } from './DataAgentWorkbench.tsx';
+import { type DatabaseType } from '../database-types.ts';
 /** localStorage key holding the most recent connection configuration. */
 export declare const CONNECTION_STORAGE_KEY = "dsh-data-agent.connection.v1";
 /** The persisted connection configuration. */
@@ -28,6 +28,8 @@ export interface SavedConnection {
     /** Opt-in flag; when true, {@link saveConnection} may write `password`. */
     persistPassword?: boolean;
     readonly?: boolean;
+    /** ClickHouse only: HTTPS with normal certificate verification. */
+    secure?: boolean;
     /** Diagnostic timestamp of the save. */
     savedAt: string;
 }

package/lib/types/client/query-export.d.ts

@@ -0,0 +1,11 @@
+/** One structured result shape accepted by every workbench export. */
+export interface QueryExportData {
+    columns: readonly string[];
+    rows: readonly Readonly<Record<string, string | null>>[];
+}
+/** UTF-8 CSV with BOM so desktop Excel opens Chinese text correctly. */
+export declare function queryResultToCsv(data: QueryExportData): string;
+/** Tabular plain text suitable for spreadsheet clipboard paste. */
+export declare function queryResultToTsv(data: QueryExportData): string;
+/** Build a real XLSX workbook using inline strings, frozen headers, and filters. */
+export declare function queryResultToXlsx(data: QueryExportData): Uint8Array;