@yejiming/dsh-data-agent 0.0.1

package/lib/query-DAjhNTo8.js

@@ -0,0 +1,86 @@
+import { c as buildIntrospectTemplate, s as buildClientTemplate } from "./defaults-D__D30ED.js";
+//#region src/query.ts
+/** Read one collected stream from offset 0. */
+function readCaptured(reader) {
+	if (reader === void 0) return {
+		text: "",
+		truncated: false
+	};
+	const read = reader.readFrom(0);
+	return {
+		text: read.text,
+		truncated: read.lossy
+	};
+}
+/**
+* Run one SQL text through the type's CLI client. The SQL is written to the
+* child's stdin (`{ data }` batch disposition) so it never appears in argv;
+* passwords travel in the env entries built by the template.
+*
+* Failure classification:
+* - the caller's external signal (e.g. the tool exec signal) aborts → the
+*   abort reason propagates;
+* - the internal timeout fires → an Error naming the deadline is thrown;
+* - the executable cannot be resolved → an Error naming the command is thrown;
+* - the process runs to completion → `{ exitCode, stdout, stderr, truncated }`
+*   is returned even for a non-zero exit (the caller decides what that means).
+* @param ctx - context exposing the subprocess service.
+* @param connection - the stored connection (password included).
+* @param sql - the SQL text (or client command) to run.
+* @param options - timeouts, caps, client overrides.
+* @param externalSignal - caller-owned cancellation (the tool exec signal).
+* @param introspect - use the machine-readable introspection flag set.
+* @returns the captured outcome.
+*/
+async function runClientQuery(ctx, connection, sql, options, externalSignal, introspect = false) {
+	const template = introspect ? buildIntrospectTemplate(connection.type, connection, options.clients[connection.type]) : buildClientTemplate(connection.type, connection, options.clients[connection.type]);
+	const controller = new AbortController();
+	const timer = setTimeout(() => controller.abort(/* @__PURE__ */ new Error(`查询超过 ${options.timeoutMs}ms 未完成，已终止客户端进程`)), options.timeoutMs);
+	const onExternalAbort = () => {
+		controller.abort(externalSignal.reason);
+	};
+	if (externalSignal.aborted) controller.abort(externalSignal.reason);
+	else externalSignal.addEventListener("abort", onExternalAbort, { once: true });
+	try {
+		let executable;
+		try {
+			executable = await ctx.subprocess.resolveExecutable(template.command, template.env, controller.signal);
+		} catch (error) {
+			controller.signal.throwIfAborted();
+			throw new Error(`无法解析数据库客户端 "${template.command}"（${error instanceof Error ? error.message : String(error)}）；请确认客户端已安装，或在 data-agent 插件配置的 clients 中覆盖命令名/路径`);
+		}
+		const handle = ctx.subprocess.spawn({
+			argv: [executable, ...template.args],
+			cwd: process.cwd(),
+			stdio: {
+				stdin: { data: `${template.stdinPrefix}${sql}\n` },
+				stdout: { maxBytes: options.maxResultChars },
+				stderr: { maxBytes: options.maxResultChars }
+			},
+			graceMs: options.graceMs ?? 5e3,
+			signal: controller.signal,
+			env: template.env
+		});
+		let outcome;
+		try {
+			outcome = await handle.done;
+		} catch (error) {
+			controller.signal.throwIfAborted();
+			throw new Error(`启动数据库客户端失败：${error instanceof Error ? error.message : String(error)}`);
+		}
+		if (controller.signal.aborted) controller.signal.throwIfAborted();
+		const stdout = readCaptured(handle.collected.stdout);
+		const stderr = readCaptured(handle.collected.stderr);
+		return {
+			exitCode: outcome.exitCode,
+			stdout: stdout.text,
+			stderr: stderr.text,
+			truncated: stdout.truncated || stderr.truncated
+		};
+	} finally {
+		clearTimeout(timer);
+		externalSignal.removeEventListener("abort", onExternalAbort);
+	}
+}
+//#endregion
+export { runClientQuery as t };

package/lib/routes.js

@@ -0,0 +1,250 @@
+import { d as parseColumns, f as parseListing, i as DEFAULT_MAX_RESULT_CHARS, m as tableListingSql, o as DEFAULT_QUERY_TIMEOUT_MS, p as parseTableListing, r as DEFAULT_MAX_QUERY_CHARS, t as DEFAULT_CONNECT_TIMEOUT_MS, u as metadataQuery } from "./defaults-D__D30ED.js";
+import { t as runClientQuery } from "./query-DAjhNTo8.js";
+import { resolve } from "node:path";
+import z from "schemastery";
+//#region src/routes.ts
+/** Cordis plugin name (diagnostics only). */
+const name = "data-agent-routes";
+/**
+* No top-level `inject` export: the row must ACTIVATE even in headless
+* profiles where `webServer` never exists (a permanently pending entry
+* breaks one-shot runs). The routes register through a nested inject fiber
+* the moment the webserver and the connection store are both available.
+*/
+const inject = [];
+/** Route prefix owned by this plugin (the browser half calls under it). */
+const DATA_AGENT_PATH = "/plugins/data-agent";
+/** Loader schema with deployment defaults (no library defaults). */
+const Config = z.object({
+	connectTimeoutMs: z.number().step(1).min(1e3).default(DEFAULT_CONNECT_TIMEOUT_MS),
+	introspectMaxTables: z.number().step(1).min(1).default(500),
+	maxResultChars: z.number().step(1).min(1024).default(DEFAULT_MAX_RESULT_CHARS),
+	queryTimeoutMs: z.number().step(1).min(1e3).default(DEFAULT_QUERY_TIMEOUT_MS),
+	maxQueryChars: z.number().step(1).min(1024).default(DEFAULT_MAX_QUERY_CHARS)
+});
+/**
+* Validate an untrusted /connect body; sqlite paths resolve to absolute
+* (the client resolves the path relative to its own cwd, so the server pins
+* it at connect time). Oracle/Hive/Impala follow the mysql/postgres shape:
+* host/port/user/database (Oracle database = service name/SID, Hive/Impala
+* database = default schema).
+*/
+function validateConnectBody(value, cwd = process.cwd()) {
+	if (value === null || typeof value !== "object" || Array.isArray(value)) throw new Error("请求体必须是 JSON 对象");
+	const candidate = value;
+	const sessionId = candidate.sessionId;
+	if (typeof sessionId !== "string" || sessionId.length === 0) throw new Error("sessionId 必须是非空字符串");
+	const type = candidate.type;
+	if (type !== "mysql" && type !== "postgres" && type !== "sqlite" && type !== "oracle" && type !== "hive" && type !== "impala") throw new Error("type 必须是 \"mysql\"、\"postgres\"、\"sqlite\"、\"oracle\"、\"hive\" 或 \"impala\"");
+	const database = candidate.database;
+	if (typeof database !== "string" || database.length === 0) throw new Error("database 必须是非空字符串" + (type === "sqlite" ? "（SQLite 为数据库文件路径）" : ""));
+	if (type === "sqlite") return {
+		sessionId,
+		type,
+		database: resolve(cwd, database)
+	};
+	const host = candidate.host;
+	if (host !== void 0 && typeof host !== "string") throw new Error("host 必须是字符串");
+	const port = candidate.port;
+	if (port !== void 0 && (typeof port !== "number" || !Number.isInteger(port) || port < 1 || port > 65535)) throw new Error("port 必须是 1-65535 的整数");
+	const user = candidate.user;
+	if (user !== void 0 && typeof user !== "string") throw new Error("user 必须是字符串");
+	const password = candidate.password;
+	if (password !== void 0 && typeof password !== "string") throw new Error("password 必须是字符串");
+	const connection = {
+		type,
+		database
+	};
+	if (typeof host === "string" && host.length > 0) connection.host = host;
+	if (port !== void 0) connection.port = port;
+	if (typeof user === "string" && user.length > 0) connection.user = user;
+	if (typeof password === "string" && password.length > 0) connection.password = password;
+	return {
+		sessionId,
+		type,
+		database,
+		...connection.host !== void 0 ? { host: connection.host } : {},
+		...connection.port !== void 0 ? { port: connection.port } : {},
+		...connection.user !== void 0 ? { user: connection.user } : {},
+		...connection.password !== void 0 ? { password: connection.password } : {}
+	};
+}
+/** Identifier whitelist for schema/table names in metadata queries. */
+const IDENTIFIER_PATTERN = /^[A-Za-z0-9_$#.-]+$/;
+/** Validate one schema/table identifier (rejects any injection-shaped input). */
+function requireIdentifier(value, label) {
+	if (value === null || value.length === 0) throw new Error(`${label} 不能为空`);
+	if (!IDENTIFIER_PATTERN.test(value)) throw new Error(`${label} 含非法字符（仅允许字母、数字与 _ $ # . -）`);
+	return value;
+}
+/**
+* Mount the data-agent routes against the host webserver, when one exists.
+* The registration rides a nested inject fiber so this row activates in every
+* profile; headless profiles simply never get routes.
+* @param ctx - host cordis context.
+* @param config - validated loader configuration.
+*/
+function apply(ctx, config) {
+	ctx.inject([
+		"webServer",
+		"subprocess",
+		"dataAgentConnections"
+	], (scope) => {
+		const store = scope.dataAgentConnections;
+		const connectOptions = {
+			clients: {},
+			timeoutMs: config.connectTimeoutMs,
+			maxResultChars: config.maxResultChars
+		};
+		const queryOptions = {
+			clients: {},
+			timeoutMs: config.queryTimeoutMs,
+			maxResultChars: config.maxResultChars
+		};
+		const introspectMaxTables = config.introspectMaxTables;
+		/** Collect the request body into a parsed JSON value. */
+		const readJson = async (req) => {
+			const chunks = [];
+			for await (const chunk of req) chunks.push(chunk);
+			const raw = Buffer.concat(chunks).toString("utf8");
+			if (raw.length === 0) return {};
+			return JSON.parse(raw);
+		};
+		/** The stored connection for one session, failing loud when absent. */
+		const requireConnection = (sessionId) => {
+			const connection = store.getWithSecret(sessionId);
+			if (connection === void 0) throw new Error("请先连接数据库（未找到当前会话的连接），再执行该操作");
+			return connection;
+		};
+		/**
+		* Run one metadata query in machine-readable mode and return its stdout;
+		* a non-zero exit throws with the client's stderr as the message.
+		*/
+		const runMetadata = async (connection, kind, schema, table) => {
+			const result = await runClientQuery(scope, connection, metadataQuery(kind, connection.type, schema, table), queryOptions, new AbortController().signal, true);
+			if (result.exitCode !== 0) {
+				const detail = result.stderr.trim() !== "" ? result.stderr.trim() : result.stdout.trim();
+				throw new Error(`元数据查询失败（exit ${result.exitCode}）：${detail}`);
+			}
+			return result.stdout;
+		};
+		scope.effect(() => {
+			const dispose = scope.webServer.register({
+				kind: "prefix",
+				path: DATA_AGENT_PATH,
+				handler: async (req, res) => {
+					const writeJson = (status, body) => {
+						res.writeHead(status, { "content-type": "application/json; charset=utf-8" });
+						res.end(JSON.stringify(body));
+					};
+					try {
+						const url = new URL(req.url ?? "/", "http://dsh.internal");
+						const segments = url.pathname.slice(19).split("/").filter(Boolean);
+						if (req.method === "POST" && segments.length === 1 && segments[0] === "connect") {
+							const request = validateConnectBody(await readJson(req));
+							const connection = {
+								type: request.type,
+								database: request.database,
+								...request.host !== void 0 ? { host: request.host } : {},
+								...request.port !== void 0 ? { port: request.port } : {},
+								...request.user !== void 0 ? { user: request.user } : {},
+								...request.password !== void 0 ? { password: request.password } : {}
+							};
+							const listing = await runClientQuery(scope, connection, tableListingSql(connection.type, connection), connectOptions, new AbortController().signal, true);
+							if (listing.exitCode !== 0) {
+								const detail = listing.stderr.trim() !== "" ? listing.stderr.trim() : listing.stdout.trim();
+								writeJson(200, {
+									ok: false,
+									error: `数据库连接验证失败（exit ${listing.exitCode}）：${detail}`
+								});
+								return;
+							}
+							const tables = parseTableListing(connection.type, listing.stdout).slice(0, introspectMaxTables);
+							connection.tables = tables;
+							store.set(request.sessionId, connection);
+							writeJson(200, {
+								ok: true,
+								tables
+							});
+							return;
+						}
+						if (req.method === "POST" && segments.length === 1 && segments[0] === "disconnect") {
+							const sessionId = (await readJson(req)).sessionId;
+							if (typeof sessionId !== "string" || sessionId.length === 0) throw new Error("sessionId 必须是非空字符串");
+							store.clear(sessionId);
+							writeJson(200, { ok: true });
+							return;
+						}
+						if (req.method === "GET" && segments.length === 1 && segments[0] === "status") {
+							const sessionId = url.searchParams.get("sessionId") ?? "";
+							const summary = store.get(sessionId);
+							writeJson(200, summary === void 0 ? { connected: false } : {
+								connected: true,
+								summary
+							});
+							return;
+						}
+						if (req.method === "GET" && segments.length === 1 && segments[0] === "schemas") {
+							const sessionId = url.searchParams.get("sessionId") ?? "";
+							if (sessionId.length === 0) throw new Error("sessionId 不能为空");
+							const connection = requireConnection(sessionId);
+							const stdout = await runMetadata(connection, "schemas");
+							writeJson(200, {
+								ok: true,
+								schemas: parseListing(connection.type, stdout).slice(0, introspectMaxTables)
+							});
+							return;
+						}
+						if (req.method === "GET" && segments.length === 1 && segments[0] === "tables") {
+							const sessionId = url.searchParams.get("sessionId") ?? "";
+							if (sessionId.length === 0) throw new Error("sessionId 不能为空");
+							const connection = requireConnection(sessionId);
+							const schema = connection.type === "sqlite" ? void 0 : requireIdentifier(url.searchParams.get("schema"), "schema");
+							const stdout = await runMetadata(connection, "tables", schema);
+							writeJson(200, {
+								ok: true,
+								tables: parseListing(connection.type, stdout).slice(0, introspectMaxTables)
+							});
+							return;
+						}
+						if (req.method === "GET" && segments.length === 1 && segments[0] === "describe") {
+							const sessionId = url.searchParams.get("sessionId") ?? "";
+							if (sessionId.length === 0) throw new Error("sessionId 不能为空");
+							const connection = requireConnection(sessionId);
+							const schema = connection.type === "sqlite" ? void 0 : requireIdentifier(url.searchParams.get("schema"), "schema");
+							const table = requireIdentifier(url.searchParams.get("table"), "table");
+							const stdout = await runMetadata(connection, "describe", schema, table);
+							writeJson(200, {
+								ok: true,
+								columns: parseColumns(connection.type, stdout)
+							});
+							return;
+						}
+						if (req.method === "POST" && segments.length === 1 && segments[0] === "query") {
+							const body = await readJson(req);
+							const sessionId = body.sessionId;
+							if (typeof sessionId !== "string" || sessionId.length === 0) throw new Error("sessionId 必须是非空字符串");
+							const sql = body.sql;
+							if (typeof sql !== "string" || sql.trim().length === 0) throw new Error("sql 必须是非空字符串");
+							if (sql.length > config.maxQueryChars) throw new Error(`sql 超过长度上限（${config.maxQueryChars} 字符）`);
+							const connection = requireConnection(sessionId);
+							writeJson(200, {
+								ok: true,
+								result: await runClientQuery(scope, connection, sql, queryOptions, new AbortController().signal)
+							});
+							return;
+						}
+						writeJson(404, { error: "unknown data-agent route" });
+					} catch (error) {
+						writeJson(400, { error: error instanceof Error ? error.message : String(error) });
+					}
+				}
+			});
+			return () => {
+				dispose();
+			};
+		}, "data-agent-routes: routes");
+	});
+}
+//#endregion
+export { Config, DATA_AGENT_PATH, apply, inject, name, validateConnectBody };

package/lib/tool.js

@@ -0,0 +1,107 @@
+import { i as DEFAULT_MAX_RESULT_CHARS, l as clientsSchema, o as DEFAULT_QUERY_TIMEOUT_MS } from "./defaults-D__D30ED.js";
+import { t as runClientQuery } from "./query-DAjhNTo8.js";
+import z from "schemastery";
+import { defineTool } from "@deepseek-ai/dsh-tools";
+//#region src/tool.ts
+/** Cordis plugin name (diagnostics only). */
+const name = "data-agent-tool";
+/** Services required before the tool can register. */
+const inject = [
+	"tools",
+	"subprocess",
+	"dataAgentConnections"
+];
+/** Loader schema with deployment defaults (no library defaults). */
+const Config = z.object({
+	queryTimeoutMs: z.number().step(1).min(1e3).default(DEFAULT_QUERY_TIMEOUT_MS),
+	maxResultChars: z.number().step(1).min(1024).default(DEFAULT_MAX_RESULT_CHARS),
+	maxRows: z.number().step(1).min(1).default(100),
+	clients: clientsSchema
+});
+/** One-line sqlcmd label for the terminal card (newlines collapsed). */
+function oneLine(sql) {
+	const line = sql.replace(/\s+/g, " ").trim();
+	return line.length > 80 ? `${line.slice(0, 77)}...` : line;
+}
+/** Format the canonical result as a monospace text block. */
+function formatResult(value) {
+	const parts = [];
+	if (value.stdout.length > 0) parts.push(value.stdout);
+	if (value.stderr.length > 0) parts.push(`[stderr]\n${value.stderr}`);
+	if (value.truncated) parts.push("… 输出超过上限，已截断（可缩小查询或增加 maxResultChars）");
+	if (value.exitCode !== 0) parts.push(`[exit code: ${value.exitCode ?? "signal"}]`);
+	return parts.join("\n");
+}
+/**
+* Mount the sqlcmd tool: register it into the current agent's tool registry.
+* @param ctx - the preset-scoped agent context.
+* @param config - validated loader configuration.
+*/
+function apply(ctx, config) {
+	const resolved = {
+		queryTimeoutMs: config.queryTimeoutMs,
+		maxResultChars: config.maxResultChars,
+		maxRows: config.maxRows,
+		clients: config.clients
+	};
+	ctx.tools.register(defineTool({
+		name: "sqlcmd",
+		description: `在已连接的数据库上执行 SQL 或客户端命令（如 SHOW TABLES、DESCRIBE users、SELECT * FROM orders LIMIT ${resolved.maxRows}）。需要先在「数据库」标签页连接数据库；SQL 经 stdin 传给客户端（mysql/psql/sqlite3），无 shell 层。结果包含 exitCode 与 stdout/stderr 文本。`,
+		parameters: { sql: {
+			type: "string",
+			required: true,
+			description: "要执行的 SQL 文本（或客户端命令），如 \"SHOW TABLES;\"、\"DESCRIBE users;\"、\"SELECT * FROM orders LIMIT 5;\""
+		} },
+		output: {
+			schema: {
+				type: "object",
+				properties: {
+					exitCode: {
+						oneOf: [{ type: "integer" }, { type: "null" }],
+						required: true
+					},
+					stdout: {
+						type: "string",
+						required: true
+					},
+					stderr: {
+						type: "string",
+						required: true
+					},
+					truncated: {
+						type: "boolean",
+						required: true
+					}
+				},
+				additionalProperties: false
+			},
+			render: (_args, value) => [{
+				type: "text",
+				text: formatResult(value)
+			}]
+		},
+		presentCall: (args) => ({
+			card: "terminal",
+			title: `sqlcmd ${oneLine(args.sql)}`,
+			description: "在数据库客户端执行 SQL"
+		}),
+		presentResult: (args, result) => ({
+			card: "terminal",
+			title: `sqlcmd ${oneLine(args.sql)}`,
+			content: result.content
+		}),
+		async execute(args, exec) {
+			const sessionId = exec.agent?.id;
+			if (sessionId === void 0) throw new Error("sqlcmd: 缺少会话上下文（agent loop 未注入）");
+			const connection = ctx.dataAgentConnections.getWithSecret(sessionId);
+			if (connection === void 0) throw new Error("请先在「数据库」标签页连接数据库，再使用 sqlcmd（未找到当前会话的连接）");
+			return runClientQuery(ctx, connection, args.sql, {
+				clients: resolved.clients,
+				timeoutMs: resolved.queryTimeoutMs,
+				maxResultChars: resolved.maxResultChars
+			}, exec.signal);
+		}
+	}));
+}
+//#endregion
+export { Config, apply, inject, name };

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

@@ -0,0 +1,22 @@
+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';
+/** The sessions-list slice the workbench needs (structural; avoids a runtime import). */
+export interface SessionListLike {
+    byId: Record<string, {
+        agentPreset?: string;
+    }>;
+}
+/** Registration-side business face: the sessions-list observable becomes `useSessions`. */
+export interface DataAgentWorkbenchInjected {
+    hooks: {
+        sessions: {
+            getSnapshot(): SessionListLike;
+            subscribe(fn: () => void): () => void;
+        };
+    };
+}
+/** The workbench's full component props: the dock seat + the locale seat + the injected sessions hook. */
+export type DataAgentWorkbenchProps = PropsRuntime<'conversation.input.dock'> & PropsLocale<'data-agent'> & InjectFace<DataAgentWorkbenchInjected>;
+/** The database workbench body. */
+export declare function DataAgentWorkbench({ sessionId, useSessions, t }: DataAgentWorkbenchProps): import("react").JSX.Element | null;

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

@@ -0,0 +1,27 @@
+/**
+ * Data Agent browser half, plugin entry: registers the database workbench
+ * into the composer input dock (the strip ABOVE the input bar) for
+ * data-agent sessions, and the `data-agent` dictionaries. The old
+ * conversation-view tab is gone — the workbench lives inside the session.
+ * Connection state lives in the server-side connection store, so layout and
+ * session switches never lose it — the view only mirrors what
+ * `/plugins/data-agent/status` reports.
+ * @module @yejiming/dsh-data-agent/client
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import { type DataAgentKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** The database workbench copy. */
+        'data-agent': DataAgentKey;
+    }
+}
+/** Required services: the locale service, the slot registry, and the sessions list. */
+export declare const inject: string[];
+/**
+ * Client plugin body: register the data-agent dictionaries and the database
+ * workbench into the composer input dock. The registration rides the slot
+ * service's effect wrapper, so plugin unload removes it.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;

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

@@ -0,0 +1,95 @@
+/** `data-agent` namespace dictionaries for the database workbench. */
+/** Dictionary namespace owned by this plugin. */
+export declare const NS = "data-agent";
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'form.title': string;
+    'form.type': string;
+    'type.mysql': string;
+    'type.postgres': string;
+    'type.sqlite': string;
+    'type.oracle': string;
+    'type.hive': string;
+    'type.impala': string;
+    'form.host': string;
+    'form.port': string;
+    'form.user': string;
+    'form.password': string;
+    'form.database': string;
+    'form.database.oracle': string;
+    'form.database.hive': string;
+    'form.database.impala': string;
+    'form.database.sqlite': string;
+    'form.database.sqlite.placeholder': string;
+    'action.connect': string;
+    'action.disconnect': string;
+    'state.connected': string;
+    'state.disconnected': string;
+    'state.checking': string;
+    'state.reconnecting': string;
+    'wb.schemas': string;
+    'wb.tables': string;
+    'wb.columns': string;
+    'wb.sql': string;
+    'wb.sql.placeholder': string;
+    'wb.sql.run': string;
+    'wb.sql.running': string;
+    'wb.sql.shortcut': string;
+    'wb.sql.empty': string;
+    'wb.loading': string;
+    'wb.empty': string;
+    'wb.modal.title': string;
+    'wb.hint.click': string;
+    'action.config': string;
+    'action.browse': string;
+    'action.close': string;
+    'action.collapse': string;
+    'error.title': string;
+};
+/** The data-agent namespace key union. */
+export type DataAgentKey = keyof typeof zh;
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: {
+    'form.title': string;
+    'form.type': string;
+    'type.mysql': string;
+    'type.postgres': string;
+    'type.sqlite': string;
+    'type.oracle': string;
+    'type.hive': string;
+    'type.impala': string;
+    'form.host': string;
+    'form.port': string;
+    'form.user': string;
+    'form.password': string;
+    'form.database': string;
+    'form.database.oracle': string;
+    'form.database.hive': string;
+    'form.database.impala': string;
+    'form.database.sqlite': string;
+    'form.database.sqlite.placeholder': string;
+    'action.connect': string;
+    'action.disconnect': string;
+    'state.connected': string;
+    'state.disconnected': string;
+    'state.checking': string;
+    'state.reconnecting': string;
+    'wb.schemas': string;
+    'wb.tables': string;
+    'wb.columns': string;
+    'wb.sql': string;
+    'wb.sql.placeholder': string;
+    'wb.sql.run': string;
+    'wb.sql.running': string;
+    'wb.sql.shortcut': string;
+    'wb.sql.empty': string;
+    'wb.loading': string;
+    'wb.empty': string;
+    'wb.modal.title': string;
+    'wb.hint.click': string;
+    'action.config': string;
+    'action.browse': string;
+    'action.close': string;
+    'action.collapse': string;
+    'error.title': string;
+};

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

@@ -0,0 +1,37 @@
+/**
+ * Connection-config persistence for the database workbench. The most recent
+ * successful connection (type/host/port/user/database/password) is kept in
+ * localStorage under one key so remounts and restarts can restore the form
+ * and auto-reconnect (the server-side connection store stays in-memory).
+ *
+ * Security note: the password is persisted in PLAIN TEXT by explicit user
+ * decision (local single-user scenario) — see README 安全说明. The storage
+ * 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';
+/** localStorage key holding the most recent connection configuration. */
+export declare const CONNECTION_STORAGE_KEY = "dsh-data-agent.connection.v1";
+/** The persisted connection configuration (password included). */
+export interface SavedConnection {
+    type: DatabaseType;
+    host?: string;
+    port?: number;
+    user?: string;
+    database: string;
+    password?: string;
+    /** Diagnostic timestamp of the save. */
+    savedAt: string;
+}
+/** Runtime storage face (injectable for tests). */
+export interface StorageLike {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+/** Save one connection configuration (best-effort; storage failures degrade silently). */
+export declare function saveConnection(connection: SavedConnection, storage?: StorageLike | undefined): void;
+/** Load the saved connection configuration; null when absent or malformed. */
+export declare function loadConnection(storage?: StorageLike | undefined): SavedConnection | null;
+/** Remove the saved connection configuration. */
+export declare function clearConnection(storage?: StorageLike | undefined): void;