@yejiming/dsh-data-agent 0.0.12 → 0.1.0

package/lib/types/catalog.d.ts

@@ -0,0 +1,59 @@
+/** Shared Catalog service: scan lifecycle, version projections, search, and review. */
+import { type DataAgentConnections } from './connections.ts';
+import { type CatalogAssetDetail, type CatalogDiffPage, type CatalogRun, type CatalogSearchPage, type CatalogSearchRequest, type CatalogSemanticRevision, type CatalogSource, type CatalogStatusSummary, type MetricDefinition, type SemanticDefinition, type StartCatalogScanInput } from './catalog-types.ts';
+import type { CatalogMeaningGenerator } from './catalog-ai.ts';
+import type { CatalogAdapter } from './catalog-adapters.ts';
+import type { CatalogPersistence } from './catalog-storage.ts';
+export interface CatalogServiceOptions {
+    maxAssetsPerRun: number;
+    maxTextChars: number;
+    pageSize: number;
+    maxPageSize: number;
+    schemaConcurrency: number;
+    assetConcurrency: number;
+    now?: () => Date;
+    randomId?: () => string;
+    adapters?: Readonly<Record<string, CatalogAdapter>>;
+    meaningGenerator?: CatalogMeaningGenerator;
+    logger?: {
+        warn(message: string, ...args: unknown[]): void;
+    };
+}
+export type { CatalogStatusSummary, StartCatalogScanInput } from './catalog-types.ts';
+/** Read-only face injected into model tools and all surface adapters. */
+export interface DataAgentCatalog {
+    listSources(): CatalogSource[];
+    listRuns(sourceId: string, limit?: number): CatalogRun[];
+    resolveSource(sessionId: string, requestedSourceId?: string): Promise<CatalogSource>;
+    status(sourceId: string): CatalogStatusSummary | undefined;
+    search(request: CatalogSearchRequest): Promise<CatalogSearchPage>;
+    getAsset(sourceId: string, assetId: string, cursor?: string, pageSize?: number): CatalogAssetDetail;
+    getSemantic(sourceId: string, semanticId: string, version?: number): CatalogSemanticRevision;
+    getMetric(sourceId: string, metricId: string, version?: number): CatalogSemanticRevision & {
+        definition: MetricDefinition;
+    };
+    diff(sourceId: string, fromRunId?: string, toRunId?: string, cursor?: string, pageSize?: number): CatalogDiffPage;
+}
+/** Mutation face used only by the dsh-tui `/catalog` command and Web routes. */
+export interface DataAgentCatalogScanner {
+    start(input: StartCatalogScanInput): Promise<CatalogRun>;
+    cancel(sourceId: string, runId?: string): Promise<CatalogRun>;
+    interruptActiveRuns(): Promise<void>;
+}
+/** Human review face; never injected into the model-tool plugin. */
+export interface DataAgentCatalogReview {
+    saveCandidate(sourceId: string, definition: SemanticDefinition, semanticId?: string, expectedVersion?: number): Promise<CatalogSemanticRevision>;
+    verify(sourceId: string, semanticId: string, expectedVersion: number, definition: SemanticDefinition): Promise<CatalogSemanticRevision>;
+    retire(sourceId: string, semanticId: string, expectedVersion: number, revisionNote: string): Promise<CatalogSemanticRevision>;
+    dismissMeaning(sourceId: string, semanticId: string, expectedVersion: number): Promise<CatalogSemanticRevision>;
+}
+export interface CatalogServiceBundle {
+    read: DataAgentCatalog;
+    scanner: DataAgentCatalogScanner;
+    review: DataAgentCatalogReview;
+}
+export declare class CatalogVersionConflictError extends Error {
+    readonly current: CatalogSemanticRevision;
+    constructor(current: CatalogSemanticRevision);
+}
+export declare function createCatalogService(connections: DataAgentConnections, persistence: CatalogPersistence, options: CatalogServiceOptions): Promise<CatalogServiceBundle>;

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

@@ -0,0 +1,15 @@
+import type { DataAgentKey } from './locales.ts';
+type T = (key: DataAgentKey, values?: Record<string, string | number>) => string;
+interface CatalogPanelProps {
+    id: string;
+    labelledBy: string;
+    active: boolean;
+    sessionId: string;
+    connected: boolean;
+    connectionProfileId?: string;
+    stateKey: object;
+    t: T;
+    onAvailabilityChange(available: boolean): void;
+}
+export declare function CatalogPanel(props: CatalogPanelProps): import("react").JSX.Element;
+export {};

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/catalog-client.d.ts

@@ -0,0 +1,57 @@
+/** Browser-only Catalog route client and wire contracts. */
+import type { CatalogAssetDetail, CatalogDiffPage, CatalogRun, CatalogScope, CatalogSearchItem, CatalogSearchPage, CatalogSemanticRevision, CatalogSource, SemanticDefinition } from '../catalog-types.ts';
+export interface CatalogStatusWire {
+    source: CatalogSource;
+    activeRun?: CatalogRun;
+    latestRun?: CatalogRun;
+    latestSuccessfulRun?: CatalogRun;
+    counts: {
+        assets: number;
+        fields: number;
+        needsReview: number;
+    };
+}
+export type { CatalogAssetDetail, CatalogDiffPage, CatalogRun, CatalogScope, CatalogSearchItem, CatalogSearchPage, CatalogSemanticRevision, CatalogSource, SemanticDefinition, };
+export declare function listCatalogSources(signal?: AbortSignal): Promise<CatalogSource[]>;
+export declare function getCatalogStatus(sourceId: string, signal?: AbortSignal): Promise<CatalogStatusWire | null>;
+export declare function listCatalogRuns(sourceId: string, signal?: AbortSignal): Promise<CatalogRun[]>;
+export declare function searchCatalog(input: {
+    sourceId: string;
+    query: string;
+    schema?: string;
+    assetKinds?: string[];
+    semanticKinds?: string[];
+    assetStatuses?: string[];
+    semanticStatuses?: string[];
+    includeInferred?: boolean;
+    cursor?: string;
+    pageSize?: number;
+}, signal?: AbortSignal): Promise<CatalogSearchPage>;
+export declare function getCatalogAsset(sourceId: string, assetId: string, cursor?: string, signal?: AbortSignal): Promise<CatalogAssetDetail>;
+export declare function getCatalogSemantic(sourceId: string, semanticId: string, version?: number, signal?: AbortSignal): Promise<CatalogSemanticRevision>;
+export declare function startCatalogScan(sessionId: string, scope: CatalogScope): Promise<CatalogRun>;
+export declare function cancelCatalogScan(sourceId: string, runId?: string): Promise<CatalogRun>;
+export declare function getCatalogDiff(sourceId: string, from?: string, to?: string, cursor?: string): Promise<CatalogDiffPage>;
+export declare function saveCatalogCandidate(input: {
+    sourceId: string;
+    semanticId?: string;
+    expectedVersion?: number;
+    definition: SemanticDefinition;
+}): Promise<CatalogSemanticRevision>;
+export declare function verifyCatalogSemantic(input: {
+    sourceId: string;
+    semanticId: string;
+    expectedVersion: number;
+    definition: SemanticDefinition;
+}): Promise<CatalogSemanticRevision>;
+export declare function retireCatalogSemantic(input: {
+    sourceId: string;
+    semanticId: string;
+    expectedVersion: number;
+    revisionNote: string;
+}): Promise<CatalogSemanticRevision>;
+export declare function dismissCatalogMeaning(input: {
+    sourceId: string;
+    semanticId: string;
+    expectedVersion: number;
+}): Promise<CatalogSemanticRevision>;

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,16 +62,156 @@ 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;
     'wb.hint.click': string;
     'action.config': string;
     'action.browse': string;
+    'action.catalog': string;
+    'catalog.source': string;
+    'catalog.source.current': string;
+    'catalog.empty': string;
+    'catalog.search': string;
+    'catalog.schema': string;
+    'catalog.schema.filter': string;
+    'catalog.table': string;
+    'catalog.validation.schema': string;
+    'catalog.validation.table': string;
+    'catalog.filter.all': string;
+    'catalog.filter.tables': string;
+    'catalog.filter.review': string;
+    'catalog.filter.assetStatus': string;
+    'catalog.filter.semanticStatus': string;
+    'catalog.scan': string;
+    'catalog.scan.all': string;
+    'catalog.scan.schema': string;
+    'catalog.scan.table': string;
+    'catalog.scan.confirm': string;
+    'catalog.section.scan': string;
+    'catalog.section.diff': string;
+    'catalog.cancel': string;
+    'catalog.diff': string;
+    'catalog.diff.from': string;
+    'catalog.diff.to': string;
+    'catalog.refresh': string;
+    'catalog.loadMore': string;
+    'catalog.status.never': string;
+    'catalog.status.latest': string;
+    'catalog.status.full': string;
+    'catalog.status.partial': string;
+    'catalog.status.failureReason': string;
+    'catalog.count.assets': string;
+    'catalog.count.fields': string;
+    'catalog.count.review': string;
+    'catalog.progress': string;
+    'catalog.enrichment.label': string;
+    'catalog.enrichment.progress': string;
+    'catalog.enrichment.queued': string;
+    'catalog.enrichment.running': string;
+    'catalog.enrichment.succeeded': string;
+    'catalog.enrichment.partial': string;
+    'catalog.enrichment.failed': string;
+    'catalog.enrichment.cancelled': string;
+    'catalog.detail.technical': string;
+    'catalog.detail.business': string;
+    'catalog.detail.history': string;
+    'catalog.detail.relations': string;
+    'catalog.detail.provenance': string;
+    'catalog.detail.run': string;
+    'catalog.detail.name': string;
+    'catalog.detail.type': string;
+    'catalog.detail.nullable': string;
+    'catalog.detail.parentTable': string;
+    'catalog.detail.select': string;
+    'catalog.detail.summary': string;
+    'catalog.detail.fields': string;
+    'catalog.detail.relationCount': string;
+    'catalog.detail.definitionCount': string;
+    'catalog.detail.scanFacts': string;
+    'catalog.detail.yes': string;
+    'catalog.detail.no': string;
+    'catalog.detail.business.empty.title': string;
+    'catalog.detail.business.empty.body': string;
+    'catalog.meaning.table': string;
+    'catalog.meaning.fields': string;
+    'catalog.meaning.ai': string;
+    'catalog.meaning.missing': string;
+    'catalog.meaning.confirm': string;
+    'catalog.meaning.delete': string;
+    'catalog.metric.new': string;
+    'catalog.term.new': string;
+    'catalog.term.name': string;
+    'catalog.metric.name': string;
+    'catalog.semantic.aliases': string;
+    'catalog.semantic.sources': string;
+    'catalog.semantic.validFrom': string;
+    'catalog.semantic.validTo': string;
+    'catalog.metric.description': string;
+    'catalog.metric.formula': string;
+    'catalog.metric.grain': string;
+    'catalog.metric.timeField': string;
+    'catalog.metric.filters': string;
+    'catalog.metric.exclusions': string;
+    'catalog.metric.owner': string;
+    'catalog.metric.note': string;
+    'catalog.metric.save': string;
+    'catalog.metric.verify': string;
+    'catalog.metric.retire': string;
+    'catalog.kind.schema': string;
+    'catalog.kind.table': string;
+    'catalog.kind.view': string;
+    'catalog.kind.column': string;
+    'catalog.kind.primary_key': string;
+    'catalog.kind.foreign_key': string;
+    'catalog.kind.index': string;
+    'catalog.kind.meaning': string;
+    'catalog.kind.term': string;
+    'catalog.kind.metric': string;
+    'catalog.warning.untrusted': string;
+    'catalog.scan.reconnect': string;
+    'catalog.state.observed': string;
+    'catalog.state.inferred': string;
+    'catalog.state.verified': string;
+    'catalog.state.needs_review': string;
+    'catalog.state.retired': string;
+    'catalog.state.missing': string;
+    'catalog.state.unavailable': string;
+    'catalog.state.added': string;
+    'catalog.state.changed': string;
+    'catalog.state.restored': string;
+    'catalog.state.queued': string;
+    'catalog.state.running': string;
+    'catalog.state.applying': string;
+    'catalog.state.succeeded': string;
+    'catalog.state.failed': string;
+    'catalog.state.cancelled': string;
+    'catalog.state.interrupted': string;
+    'catalog.state.supported': string;
+    'catalog.state.unsupported': string;
     'action.close': string;
     'error.title': string;
     'analysis.running': string;
@@ -101,6 +246,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 +264,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,16 +295,156 @@ 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;
     'wb.hint.click': string;
     'action.config': string;
     'action.browse': string;
+    'action.catalog': string;
+    'catalog.source': string;
+    'catalog.source.current': string;
+    'catalog.empty': string;
+    'catalog.search': string;
+    'catalog.schema': string;
+    'catalog.schema.filter': string;
+    'catalog.table': string;
+    'catalog.validation.schema': string;
+    'catalog.validation.table': string;
+    'catalog.filter.all': string;
+    'catalog.filter.tables': string;
+    'catalog.filter.review': string;
+    'catalog.filter.assetStatus': string;
+    'catalog.filter.semanticStatus': string;
+    'catalog.scan': string;
+    'catalog.scan.all': string;
+    'catalog.scan.schema': string;
+    'catalog.scan.table': string;
+    'catalog.scan.confirm': string;
+    'catalog.section.scan': string;
+    'catalog.section.diff': string;
+    'catalog.cancel': string;
+    'catalog.diff': string;
+    'catalog.diff.from': string;
+    'catalog.diff.to': string;
+    'catalog.refresh': string;
+    'catalog.loadMore': string;
+    'catalog.status.never': string;
+    'catalog.status.latest': string;
+    'catalog.status.full': string;
+    'catalog.status.partial': string;
+    'catalog.status.failureReason': string;
+    'catalog.count.assets': string;
+    'catalog.count.fields': string;
+    'catalog.count.review': string;
+    'catalog.progress': string;
+    'catalog.enrichment.label': string;
+    'catalog.enrichment.progress': string;
+    'catalog.enrichment.queued': string;
+    'catalog.enrichment.running': string;
+    'catalog.enrichment.succeeded': string;
+    'catalog.enrichment.partial': string;
+    'catalog.enrichment.failed': string;
+    'catalog.enrichment.cancelled': string;
+    'catalog.detail.technical': string;
+    'catalog.detail.business': string;
+    'catalog.detail.history': string;
+    'catalog.detail.relations': string;
+    'catalog.detail.provenance': string;
+    'catalog.detail.run': string;
+    'catalog.detail.name': string;
+    'catalog.detail.type': string;
+    'catalog.detail.nullable': string;
+    'catalog.detail.parentTable': string;
+    'catalog.detail.select': string;
+    'catalog.detail.summary': string;
+    'catalog.detail.fields': string;
+    'catalog.detail.relationCount': string;
+    'catalog.detail.definitionCount': string;
+    'catalog.detail.scanFacts': string;
+    'catalog.detail.yes': string;
+    'catalog.detail.no': string;
+    'catalog.detail.business.empty.title': string;
+    'catalog.detail.business.empty.body': string;
+    'catalog.meaning.table': string;
+    'catalog.meaning.fields': string;
+    'catalog.meaning.ai': string;
+    'catalog.meaning.missing': string;
+    'catalog.meaning.confirm': string;
+    'catalog.meaning.delete': string;
+    'catalog.metric.new': string;
+    'catalog.term.new': string;
+    'catalog.term.name': string;
+    'catalog.metric.name': string;
+    'catalog.semantic.aliases': string;
+    'catalog.semantic.sources': string;
+    'catalog.semantic.validFrom': string;
+    'catalog.semantic.validTo': string;
+    'catalog.metric.description': string;
+    'catalog.metric.formula': string;
+    'catalog.metric.grain': string;
+    'catalog.metric.timeField': string;
+    'catalog.metric.filters': string;
+    'catalog.metric.exclusions': string;
+    'catalog.metric.owner': string;
+    'catalog.metric.note': string;
+    'catalog.metric.save': string;
+    'catalog.metric.verify': string;
+    'catalog.metric.retire': string;
+    'catalog.kind.schema': string;
+    'catalog.kind.table': string;
+    'catalog.kind.view': string;
+    'catalog.kind.column': string;
+    'catalog.kind.primary_key': string;
+    'catalog.kind.foreign_key': string;
+    'catalog.kind.index': string;
+    'catalog.kind.meaning': string;
+    'catalog.kind.term': string;
+    'catalog.kind.metric': string;
+    'catalog.warning.untrusted': string;
+    'catalog.scan.reconnect': string;
+    'catalog.state.observed': string;
+    'catalog.state.inferred': string;
+    'catalog.state.verified': string;
+    'catalog.state.needs_review': string;
+    'catalog.state.retired': string;
+    'catalog.state.missing': string;
+    'catalog.state.unavailable': string;
+    'catalog.state.added': string;
+    'catalog.state.changed': string;
+    'catalog.state.restored': string;
+    'catalog.state.queued': string;
+    'catalog.state.running': string;
+    'catalog.state.applying': string;
+    'catalog.state.succeeded': string;
+    'catalog.state.failed': string;
+    'catalog.state.cancelled': string;
+    'catalog.state.interrupted': string;
+    'catalog.state.supported': string;
+    'catalog.state.unsupported': string;
     'action.close': string;
     'error.title': string;
     'analysis.running': 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;

package/lib/types/client-discovery.d.ts

@@ -8,8 +8,7 @@
  * involved, and the exact discovery environment is returned for spawn.
  * @module @yejiming/dsh-data-agent/client-discovery
  */
-import type { ClientConfig } from './clients.ts';
-import type { DatabaseType } from './connections.ts';
+import type { CliDatabaseType, ClientConfig } from './clients.ts';
 /** Host facts are injectable so all supported platforms can be tested on one CI host. */
 export interface ClientDiscoverySystem {
     platform: NodeJS.Platform;
@@ -28,7 +27,7 @@ export interface ClientExecutableResolution {
 }
 /** Input for one database client resolution attempt. */
 export interface ResolveClientExecutableOptions {
-    type: DatabaseType;
+    type: CliDatabaseType;
     command: string;
     config?: ClientConfig;
     env: Readonly<Record<string, string>>;
@@ -37,7 +36,7 @@ export interface ResolveClientExecutableOptions {
     system?: ClientDiscoverySystem;
 }
 /** Build ordered fallback directories without recursively scanning the host. */
-export declare function buildClientSearchDirectories(type: DatabaseType, config: ClientConfig | undefined, signal: AbortSignal, system?: ClientDiscoverySystem): Promise<string[]>;
+export declare function buildClientSearchDirectories(type: CliDatabaseType, config: ClientConfig | undefined, signal: AbortSignal, system?: ClientDiscoverySystem): Promise<string[]>;
 /**
  * Resolve one configured/default client. Current PATH (or an explicit path)
  * always wins. Only a missing bare command activates bounded PATH discovery.

package/lib/types/clients.d.ts

@@ -1,11 +1,12 @@
 /**
  * Pure CLI-client template construction for the supported database types.
  * Everything here is a function of (type, connection, optional overrides) —
- * no process, no I/O — so the injection-safety surface is unit-testable:
+ * no process, no I/O — so the CLI injection-safety surface is unit-testable:
  * argv stays an array (never shell-interpreted), the SQL itself always
  * travels on stdin, and passwords only ever appear in the environment
- * entries (`MYSQL_PWD` / `PGPASSWORD`) or in a stdin connect prefix
- * (Oracle `connect`, Hive `!connect`) — never in argv, logs, or returns.
+ * entries (`MYSQL_PWD` / `PGPASSWORD` / `SQLCMDPASSWORD`) or in a stdin
+ * connect prefix (Oracle `connect`, Hive `!connect`) — never in argv, logs,
+ * or returns. ClickHouse HTTP authentication lives in the shared runner.
  *
  * Metadata (schemas / tables / describe) queries and their per-type output
  * parsers live here too, so the /schemas /tables /describe routes stay thin.
@@ -13,8 +14,8 @@
  */
 import type { DatabaseConnection, DatabaseType } from './connections.ts';
 import z from 'schemastery';
-import { assertSingleStatement, hasTopLevelKeyword, stripTrailingTerminator } from './sql.ts';
-export { assertSingleStatement, hasTopLevelKeyword, stripTrailingTerminator };
+import { assertSingleStatement, assertSqlServerSafeInput, hasTopLevelKeyword, stripTrailingTerminator } from './sql.ts';
+export { assertSingleStatement, assertSqlServerSafeInput, hasTopLevelKeyword, stripTrailingTerminator };
 /**
  * Classify a SQL text as a read or write statement by its FIRST effective
  * token (a conservative read whitelist, not a parser). `with` is read only
@@ -33,6 +34,8 @@ export declare function classifyStatement(sql: string, type: DatabaseType): 'rea
  * unparseable LIMIT is left for the client (structured tools still truncate).
  */
 export declare function enforceReadRowLimit(sql: string, type: DatabaseType, maxRows: number): string;
+/** Rare control separator keeps ordinary tabs/pipes inside sqlcmd values intact. */
+export declare const SQLSERVER_COLUMN_SEPARATOR = "\u001F";
 /**
  * Validate and quote one schema/table identifier for a safe metadata query.
  * Identifiers are restricted to `[A-Za-z0-9_$]+` and then wrapped per type:
@@ -51,6 +54,8 @@ export interface ClientConfig {
     /** Absolute directories searched after the current subprocess PATH. */
     searchPaths?: readonly string[];
 }
+/** Database types backed by a locally resolved CLI executable. */
+export type CliDatabaseType = Exclude<DatabaseType, 'clickhouse'>;
 /** Loader schema for one client override (all fields optional at input). */
 export declare const clientConfigSchema: z<Schemastery.ObjectS<{
     command: z<string, string>;
@@ -61,16 +66,15 @@ export declare const clientConfigSchema: z<Schemastery.ObjectS<{
     args: z<string[], string[]>;
     searchPaths: z<string[], string[]>;
 }>>;
-/** Loader schema for the whole `clients` config object (any type key). */
 export declare const clientsSchema: z<import("cosmokit").Dict<{
     command?: string | null | undefined;
     args?: string[] | null | undefined;
     searchPaths?: string[] | null | undefined;
-} & import("@deepseek-ai/cosmokit").Dict, string>, import("cosmokit").Dict<Schemastery.ObjectT<{
+} & import("@deepseek-ai/cosmokit").Dict, "mysql" | "postgres" | "sqlite" | "oracle" | "hive" | "impala" | "doris" | "sqlserver">, import("cosmokit").Dict<Schemastery.ObjectT<{
     command: z<string, string>;
     args: z<string[], string[]>;
     searchPaths: z<string[], string[]>;
-}>, string>>;
+}>, "mysql" | "postgres" | "sqlite" | "oracle" | "hive" | "impala" | "doris" | "sqlserver">>;
 /**
  * A fully constructed client invocation: argv (command + flags, no SQL),
  * the credential env entries, and the stdin prefix (Oracle/Hive connect
@@ -127,6 +131,8 @@ export interface ColumnInfo {
     type: string;
     nullable?: boolean;
 }
+/** Remove only terminal sqlcmd row-count footer lines, never matching data in the middle. */
+export declare function stripSqlServerRowCountFooter(stdout: string): string;
 /**
  * Parse one type's describe output into columns. Formats:
  * - mysql `--batch`: `Field\tType\tNull\tKey\t...` (skip header);