@mcpolyglot/connector-sql 0.1.0

package/dist/connector.js

@@ -0,0 +1,113 @@
+import { z } from 'zod';
+import { McpolyglotError } from '@mcpolyglot/core';
+export class SqlConnector {
+    id;
+    kind = 'sql';
+    dialect;
+    logger;
+    cachedTables;
+    constructor(opts) {
+        this.id = opts.id;
+        this.dialect = opts.dialect;
+    }
+    async init(ctx) {
+        this.logger = ctx.logger;
+        await this.dialect.connect();
+        this.logger.info('connector.sql.connected', { id: this.id, dialect: this.dialect.kind });
+    }
+    async close() {
+        await this.dialect.close();
+    }
+    async health() {
+        return this.dialect.ping();
+    }
+    async introspect() {
+        const tables = await this.dialect.listTables();
+        this.cachedTables = tables;
+        return { kind: 'sql', tables };
+    }
+    listPrimitiveTools() {
+        const id = this.id;
+        return [
+            {
+                name: `${id}.list_tables`,
+                description: `List all tables and their columns in the ${id} database.`,
+                inputSchema: z.object({}).strict(),
+                scopes: ['schema:read'],
+                readOnly: true,
+                handler: async () => {
+                    const tables = await this.cachedOrFetchTables();
+                    return {
+                        content: [{ type: 'json', data: tables }],
+                        metadata: { rows: tables.length },
+                    };
+                },
+            },
+            {
+                name: `${id}.describe_table`,
+                description: `Describe one table in the ${id} database, including columns, types, and primary key.`,
+                inputSchema: z
+                    .object({
+                    name: z
+                        .string()
+                        .min(1)
+                        .describe('Table name. Use schema-qualified form if needed (e.g. "public.users").'),
+                })
+                    .strict(),
+                scopes: ['schema:read'],
+                readOnly: true,
+                handler: async ({ name }) => {
+                    const tables = await this.cachedOrFetchTables();
+                    const found = tables.find((t) => qualifiedName(t).toLowerCase() === name.toLowerCase() ||
+                        t.name.toLowerCase() === name.toLowerCase());
+                    if (!found) {
+                        throw new McpolyglotError('not_found', `Table "${name}" not found in ${id}`);
+                    }
+                    return { content: [{ type: 'json', data: found }] };
+                },
+            },
+            {
+                name: `${id}.query`,
+                description: `Run a read-only SQL query against the ${id} database. Use parameterized form ($1, $2, ...). Writes are rejected.`,
+                inputSchema: z
+                    .object({
+                    sql: z
+                        .string()
+                        .min(1)
+                        .describe('SQL query string. Read-only — INSERT/UPDATE/DELETE/DDL will be rejected.'),
+                    params: z.array(z.union([z.string(), z.number(), z.boolean(), z.null()])).optional(),
+                    limit: z.number().int().positive().max(1000).optional(),
+                })
+                    .strict(),
+                scopes: ['tables:read', 'query:raw'],
+                readOnly: true,
+                handler: async ({ sql, params, limit }, ctx) => {
+                    const rowCap = Math.min(limit ?? ctx.limits.rowCap, ctx.limits.rowCap);
+                    const result = await this.dialect.runReadOnly(sql, params ?? [], {
+                        rowCap,
+                        timeoutMs: ctx.limits.timeoutMs,
+                        signal: ctx.signal,
+                    });
+                    return {
+                        content: [{ type: 'json', data: result }],
+                        metadata: { rows: result.rowCount, truncated: result.truncated },
+                    };
+                },
+            },
+        ];
+    }
+    generatePerEntityTools(_cfg) {
+        // Wave 3 — opt-in per-table list/get/count tools generated from cached schema.
+        return [];
+    }
+    async cachedOrFetchTables() {
+        if (!this.cachedTables) {
+            this.cachedTables = await this.dialect.listTables();
+        }
+        return this.cachedTables;
+    }
+}
+function qualifiedName(t) {
+    return t.schema ? `${t.schema}.${t.name}` : t.name;
+}
+//# sourceMappingURL=connector.js.map

package/dist/connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.js","sourceRoot":"","sources":["../src/connector.ts"],"names":[],"mappings":"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"}

package/dist/dialect.d.ts

@@ -0,0 +1,25 @@
+import type { TableSchema } from '@mcpolyglot/core';
+export interface SqlQueryResult {
+    columns: string[];
+    rows: Record<string, unknown>[];
+    rowCount: number;
+    truncated: boolean;
+}
+export interface SqlDialect {
+    readonly kind: 'postgres' | 'mysql' | 'mariadb' | 'sqlite';
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    ping(): Promise<{
+        ok: boolean;
+        latencyMs: number;
+        details?: string;
+    }>;
+    listTables(): Promise<TableSchema[]>;
+    /** Run a read-only query with timeout + row cap. Implementations MUST refuse writes. */
+    runReadOnly(sql: string, params: ReadonlyArray<unknown>, opts: {
+        rowCap: number;
+        timeoutMs: number;
+        signal?: AbortSignal;
+    }): Promise<SqlQueryResult>;
+}
+//# sourceMappingURL=dialect.d.ts.map

package/dist/dialect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialect.d.ts","sourceRoot":"","sources":["../src/dialect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC3D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtE,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACrC,wFAAwF;IACxF,WAAW,CACT,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAC9B,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAChE,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5B"}

package/dist/dialect.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dialect.js.map

package/dist/dialect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialect.js","sourceRoot":"","sources":["../src/dialect.ts"],"names":[],"mappings":""}

package/dist/dialects/mysql.d.ts

@@ -0,0 +1,32 @@
+import type { TableSchema } from '@mcpolyglot/core';
+import type { SqlDialect, SqlQueryResult } from '../dialect.js';
+export declare class MysqlDialect implements SqlDialect {
+    private readonly connectionString;
+    readonly kind: "mysql";
+    private pool?;
+    private readonly parser;
+    constructor(connectionString: string);
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    ping(): Promise<{
+        ok: boolean;
+        latencyMs: number;
+        details?: string;
+    }>;
+    listTables(): Promise<TableSchema[]>;
+    runReadOnly(sql: string, params: ReadonlyArray<unknown>, opts: {
+        rowCap: number;
+        timeoutMs: number;
+        signal?: AbortSignal;
+    }): Promise<SqlQueryResult>;
+    /**
+     * MySQL `SET TRANSACTION READ ONLY` is partially honored; some functions
+     * (e.g., `SLEEP`, write-time UDFs) bypass it. We pre-screen with a parser
+     * that rejects any non-read top-level statement.
+     */
+    private assertReadOnlyOrThrow;
+    /** Inject `MAX_EXECUTION_TIME` hint on SELECTs so the server cancels long queries. */
+    private injectMaxExecutionTime;
+    private requirePool;
+}
+//# sourceMappingURL=mysql.d.ts.map

package/dist/dialects/mysql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql.d.ts","sourceRoot":"","sources":["../../src/dialects/mysql.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAElE,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAQhE,qBAAa,YAAa,YAAW,UAAU;IAKjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAJ7C,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IACjC,OAAO,CAAC,IAAI,CAAC,CAAY;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAEV,gBAAgB,EAAE,MAAM;IAE/C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAexB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,IAAI,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAerE,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAqCpC,WAAW,CACf,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAC9B,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAChE,OAAO,CAAC,cAAc,CAAC;IA4B1B;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAsB7B,sFAAsF;IACtF,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,WAAW;CAKpB"}

package/dist/dialects/mysql.js

@@ -0,0 +1,146 @@
+import sqlParser from 'node-sql-parser';
+import { McpolyglotError } from '@mcpolyglot/core';
+const { Parser } = sqlParser;
+const READ_OPS = new Set(['select', 'show', 'describe', 'desc', 'explain', 'with']);
+export class MysqlDialect {
+    connectionString;
+    kind = 'mysql';
+    pool;
+    parser = new Parser();
+    constructor(connectionString) {
+        this.connectionString = connectionString;
+    }
+    async connect() {
+        const mysql = await loadMysql();
+        this.pool = mysql.createPool({
+            uri: this.connectionString,
+            connectionLimit: 4,
+            enableKeepAlive: true,
+        });
+        const c = await this.pool.getConnection();
+        try {
+            await c.query('SELECT 1');
+        }
+        finally {
+            c.release();
+        }
+    }
+    async close() {
+        await this.pool?.end();
+        this.pool = undefined;
+    }
+    async ping() {
+        const t0 = Date.now();
+        try {
+            const c = await this.requirePool().getConnection();
+            try {
+                await c.query('SELECT 1');
+                return { ok: true, latencyMs: Date.now() - t0 };
+            }
+            finally {
+                c.release();
+            }
+        }
+        catch (err) {
+            return { ok: false, latencyMs: Date.now() - t0, details: err.message };
+        }
+    }
+    async listTables() {
+        const c = await this.requirePool().getConnection();
+        try {
+            const [rows] = (await c.query(`SELECT TABLE_SCHEMA AS \`schema\`, TABLE_NAME AS \`name\`
+         FROM information_schema.tables
+         WHERE TABLE_SCHEMA NOT IN ('mysql','information_schema','performance_schema','sys')
+         ORDER BY TABLE_SCHEMA, TABLE_NAME`));
+            const tables = [];
+            for (const row of rows) {
+                const [colRows] = (await c.query(`SELECT COLUMN_NAME AS \`name\`, COLUMN_TYPE AS \`type\`,
+                  IS_NULLABLE AS \`isNullable\`, COLUMN_KEY AS \`columnKey\`
+           FROM information_schema.columns
+           WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ?
+           ORDER BY ORDINAL_POSITION`, [row.schema, row.name]));
+                const columns = colRows.map((cr) => ({
+                    name: cr.name,
+                    type: cr.type,
+                    nullable: cr.isNullable === 'YES',
+                    primaryKey: cr.columnKey === 'PRI',
+                }));
+                tables.push({ schema: row.schema, name: row.name, columns });
+            }
+            return tables;
+        }
+        finally {
+            c.release();
+        }
+    }
+    async runReadOnly(sql, params, opts) {
+        // 1. AST gate: parse with mysql grammar; refuse anything that isn't a read.
+        this.assertReadOnlyOrThrow(sql);
+        const c = await this.requirePool().getConnection();
+        try {
+            // 2. Session read-only.
+            await c.query('SET SESSION TRANSACTION READ ONLY');
+            await c.query('START TRANSACTION');
+            try {
+                const [rows, fields] = (await c.query({
+                    sql: this.injectMaxExecutionTime(sql, opts.timeoutMs),
+                    values: params,
+                    rowsAsArray: false,
+                }));
+                const columns = fields?.map((f) => f.name) ?? (rows[0] ? Object.keys(rows[0]) : []);
+                const truncated = rows.length > opts.rowCap;
+                const sliced = truncated ? rows.slice(0, opts.rowCap) : rows;
+                return { columns, rows: sliced, rowCount: sliced.length, truncated };
+            }
+            finally {
+                await c.query('ROLLBACK').catch(() => { });
+            }
+        }
+        finally {
+            c.release();
+        }
+    }
+    /**
+     * MySQL `SET TRANSACTION READ ONLY` is partially honored; some functions
+     * (e.g., `SLEEP`, write-time UDFs) bypass it. We pre-screen with a parser
+     * that rejects any non-read top-level statement.
+     */
+    assertReadOnlyOrThrow(sql) {
+        let asts;
+        try {
+            asts = this.parser.astify(sql, { database: 'mysql' });
+        }
+        catch (err) {
+            throw new McpolyglotError('forbidden.read_only', `Could not parse SQL: ${err.message}`);
+        }
+        const list = Array.isArray(asts) ? asts : [asts];
+        for (const node of list) {
+            const type = (node?.type ?? '').toLowerCase();
+            if (!READ_OPS.has(type)) {
+                throw new McpolyglotError('forbidden.read_only', `Statement is not read-only (got "${type || 'unknown'}")`);
+            }
+        }
+    }
+    /** Inject `MAX_EXECUTION_TIME` hint on SELECTs so the server cancels long queries. */
+    injectMaxExecutionTime(sql, timeoutMs) {
+        const trimmed = sql.replace(/^\s+/, '');
+        if (/^select\s/i.test(trimmed) && !/MAX_EXECUTION_TIME/i.test(trimmed)) {
+            return trimmed.replace(/^select\s/i, `SELECT /*+ MAX_EXECUTION_TIME(${timeoutMs}) */ `);
+        }
+        return sql;
+    }
+    requirePool() {
+        if (!this.pool)
+            throw new McpolyglotError('connector.not_initialized', 'MysqlDialect not connected');
+        return this.pool;
+    }
+}
+async function loadMysql() {
+    try {
+        return await import('mysql2/promise');
+    }
+    catch {
+        throw new McpolyglotError('connector.missing_dep', 'The "mysql2" package is required for the mysql dialect. Install it with: pnpm add mysql2');
+    }
+}
+//# sourceMappingURL=mysql.js.map

package/dist/dialects/mysql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql.js","sourceRoot":"","sources":["../../src/dialects/mysql.ts"],"names":[],"mappings":"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"}

package/dist/dialects/postgres.d.ts

@@ -0,0 +1,23 @@
+import type { TableSchema } from '@mcpolyglot/core';
+import type { SqlDialect, SqlQueryResult } from '../dialect.js';
+export declare class PostgresDialect implements SqlDialect {
+    private readonly connectionString;
+    readonly kind: "postgres";
+    private pool?;
+    constructor(connectionString: string);
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    ping(): Promise<{
+        ok: boolean;
+        latencyMs: number;
+        details?: string;
+    }>;
+    listTables(): Promise<TableSchema[]>;
+    runReadOnly(sql: string, params: ReadonlyArray<unknown>, opts: {
+        rowCap: number;
+        timeoutMs: number;
+        signal?: AbortSignal;
+    }): Promise<SqlQueryResult>;
+    private requirePool;
+}
+//# sourceMappingURL=postgres.d.ts.map

package/dist/dialects/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../src/dialects/postgres.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEhE,qBAAa,eAAgB,YAAW,UAAU;IAIpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAH7C,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IACpC,OAAO,CAAC,IAAI,CAAC,CAAoB;gBAEJ,gBAAgB,EAAE,MAAM;IAE/C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,IAAI,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAerE,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IA0CpC,WAAW,CACf,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAC9B,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAChE,OAAO,CAAC,cAAc,CAAC;IAiC1B,OAAO,CAAC,WAAW;CAKpB"}

package/dist/dialects/postgres.js

@@ -0,0 +1,131 @@
+import { McpolyglotError } from '@mcpolyglot/core';
+export class PostgresDialect {
+    connectionString;
+    kind = 'postgres';
+    pool;
+    constructor(connectionString) {
+        this.connectionString = connectionString;
+    }
+    async connect() {
+        const { Pool } = await loadPg();
+        this.pool = new Pool({
+            connectionString: this.connectionString,
+            max: 4,
+            idleTimeoutMillis: 30_000,
+            application_name: 'mcpolyglot',
+        });
+        // probe
+        const c = await this.pool.connect();
+        try {
+            await c.query('SELECT 1');
+        }
+        finally {
+            c.release();
+        }
+    }
+    async close() {
+        await this.pool?.end();
+        this.pool = undefined;
+    }
+    async ping() {
+        const t0 = Date.now();
+        try {
+            const c = await this.requirePool().connect();
+            try {
+                await c.query('SELECT 1');
+                return { ok: true, latencyMs: Date.now() - t0 };
+            }
+            finally {
+                c.release();
+            }
+        }
+        catch (err) {
+            return { ok: false, latencyMs: Date.now() - t0, details: err.message };
+        }
+    }
+    async listTables() {
+        const c = await this.requirePool().connect();
+        try {
+            const sql = `
+        SELECT
+          n.nspname AS schema,
+          c.relname AS table,
+          jsonb_agg(jsonb_build_object(
+            'name', a.attname,
+            'type', format_type(a.atttypid, a.atttypmod),
+            'nullable', NOT a.attnotnull,
+            'primaryKey', COALESCE(pk.is_pk, false)
+          ) ORDER BY a.attnum) AS columns
+        FROM pg_class c
+        JOIN pg_namespace n ON n.oid = c.relnamespace
+        JOIN pg_attribute a ON a.attrelid = c.oid AND a.attnum > 0 AND NOT a.attisdropped
+        LEFT JOIN (
+          SELECT i.indrelid, k.attnum, true AS is_pk
+          FROM pg_index i
+          JOIN pg_attribute k ON k.attrelid = i.indrelid AND k.attnum = ANY(i.indkey)
+          WHERE i.indisprimary
+        ) pk ON pk.indrelid = c.oid AND pk.attnum = a.attnum
+        WHERE c.relkind IN ('r','p','v','m')
+          AND n.nspname NOT IN ('pg_catalog','information_schema')
+        GROUP BY n.nspname, c.relname
+        ORDER BY n.nspname, c.relname;
+      `;
+            const res = await c.query(sql);
+            return res.rows.map((r) => ({
+                schema: r.schema,
+                name: r.table,
+                columns: r.columns,
+            }));
+        }
+        finally {
+            c.release();
+        }
+    }
+    async runReadOnly(sql, params, opts) {
+        const c = await this.requirePool().connect();
+        try {
+            await c.query('BEGIN READ ONLY');
+            await c.query(`SET LOCAL statement_timeout = ${Math.max(1, Math.floor(opts.timeoutMs))}`);
+            const onAbort = () => {
+                // best-effort cancellation
+                c.query('SELECT pg_cancel_backend(pg_backend_pid())').catch(() => { });
+            };
+            opts.signal?.addEventListener('abort', onAbort, { once: true });
+            try {
+                const res = await c.query({ text: sql, values: params, rowMode: 'array' });
+                const fields = res.fields.map((f) => f.name);
+                const rawRows = res.rows;
+                const truncated = rawRows.length > opts.rowCap;
+                const rows = (truncated ? rawRows.slice(0, opts.rowCap) : rawRows).map((row) => {
+                    const obj = {};
+                    fields.forEach((f, i) => {
+                        obj[f] = row[i];
+                    });
+                    return obj;
+                });
+                return { columns: fields, rows, rowCount: rows.length, truncated };
+            }
+            finally {
+                opts.signal?.removeEventListener('abort', onAbort);
+                await c.query('ROLLBACK').catch(() => { });
+            }
+        }
+        finally {
+            c.release();
+        }
+    }
+    requirePool() {
+        if (!this.pool)
+            throw new McpolyglotError('connector.not_initialized', 'PostgresDialect not connected');
+        return this.pool;
+    }
+}
+async function loadPg() {
+    try {
+        return await import('pg');
+    }
+    catch {
+        throw new McpolyglotError('connector.missing_dep', 'The "pg" package is required for the postgres dialect. Install it with: pnpm add pg');
+    }
+}
+//# sourceMappingURL=postgres.js.map

package/dist/dialects/postgres.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.js","sourceRoot":"","sources":["../../src/dialects/postgres.ts"],"names":[],"mappings":"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"}

package/dist/dialects/sqlite.d.ts

@@ -0,0 +1,28 @@
+import type { TableSchema } from '@mcpolyglot/core';
+import type { SqlDialect, SqlQueryResult } from '../dialect.js';
+export declare class SqliteDialect implements SqlDialect {
+    private readonly fileOrUri;
+    readonly kind: "sqlite";
+    private db?;
+    /**
+     * @param fileOrUri Either an absolute path or a `sqlite://` URI.
+     *                  The file is opened **read-only** regardless of caller intent.
+     */
+    constructor(fileOrUri: string);
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    ping(): Promise<{
+        ok: boolean;
+        latencyMs: number;
+        details?: string;
+    }>;
+    listTables(): Promise<TableSchema[]>;
+    runReadOnly(sql: string, params: ReadonlyArray<unknown>, opts: {
+        rowCap: number;
+        timeoutMs: number;
+        signal?: AbortSignal;
+    }): Promise<SqlQueryResult>;
+    private requireDb;
+    private resolvePath;
+}
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/dialects/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/dialects/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,kBAAkB,CAAC;AAElE,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAKhE,qBAAa,aAAc,YAAW,UAAU;IAQlC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAPtC,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,OAAO,CAAC,EAAE,CAAC,CAAwB;IAEnC;;;OAGG;gBAC0B,SAAS,EAAE,MAAM;IAExC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAQxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,IAAI,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAUrE,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAyBpC,WAAW,CACf,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAC9B,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAChE,OAAO,CAAC,cAAc,CAAC;IAsB1B,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,WAAW;CAKpB"}

package/dist/dialects/sqlite.js

@@ -0,0 +1,96 @@
+import { McpolyglotError } from '@mcpolyglot/core';
+export class SqliteDialect {
+    fileOrUri;
+    kind = 'sqlite';
+    db;
+    /**
+     * @param fileOrUri Either an absolute path or a `sqlite://` URI.
+     *                  The file is opened **read-only** regardless of caller intent.
+     */
+    constructor(fileOrUri) {
+        this.fileOrUri = fileOrUri;
+    }
+    async connect() {
+        const Database = await loadSqlite();
+        const path = this.resolvePath();
+        const db = new Database(path, { readonly: true, fileMustExist: true });
+        db.pragma('query_only = ON');
+        this.db = db;
+    }
+    async close() {
+        this.db?.close();
+        this.db = undefined;
+    }
+    async ping() {
+        const t0 = Date.now();
+        try {
+            this.requireDb().prepare('SELECT 1').get();
+            return { ok: true, latencyMs: Date.now() - t0 };
+        }
+        catch (err) {
+            return { ok: false, latencyMs: Date.now() - t0, details: err.message };
+        }
+    }
+    async listTables() {
+        const db = this.requireDb();
+        const tables = db
+            .prepare(`SELECT name FROM sqlite_master WHERE type IN ('table','view') AND name NOT LIKE 'sqlite_%' ORDER BY name`)
+            .all();
+        return tables.map(({ name }) => {
+            const cols = db.prepare(`PRAGMA table_info(${quoteIdent(name)})`).all();
+            const columns = cols.map((c) => ({
+                name: c.name,
+                type: c.type || 'ANY',
+                nullable: c.notnull === 0,
+                primaryKey: c.pk > 0,
+            }));
+            return { name, columns };
+        });
+    }
+    async runReadOnly(sql, params, opts) {
+        const db = this.requireDb();
+        if (opts.signal?.aborted)
+            throw new McpolyglotError('aborted', 'Aborted before execution');
+        // SQLite is synchronous via better-sqlite3 — `query_only` pragma + readonly handle blocks writes.
+        const stmt = db.prepare(sql);
+        if (!stmt.reader) {
+            throw new McpolyglotError('forbidden.read_only', 'Statement is not read-only');
+        }
+        const startedAt = Date.now();
+        const all = stmt.all(...params);
+        if (Date.now() - startedAt > opts.timeoutMs) {
+            throw new McpolyglotError('timeout', `Query exceeded ${opts.timeoutMs}ms`);
+        }
+        const truncated = all.length > opts.rowCap;
+        const rows = truncated ? all.slice(0, opts.rowCap) : all;
+        const columns = rows[0]
+            ? Object.keys(rows[0])
+            : (stmt.columns().map((c) => c.name) ?? []);
+        return { columns, rows, rowCount: rows.length, truncated };
+    }
+    requireDb() {
+        if (!this.db)
+            throw new McpolyglotError('connector.not_initialized', 'SqliteDialect not connected');
+        return this.db;
+    }
+    resolvePath() {
+        const v = this.fileOrUri;
+        if (v.startsWith('sqlite://'))
+            return v.replace(/^sqlite:\/\//, '');
+        return v;
+    }
+}
+function quoteIdent(name) {
+    return '"' + name.replace(/"/g, '""') + '"';
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+async function loadSqlite() {
+    try {
+        const mod = (await import('better-sqlite3'));
+        return mod.default ?? mod;
+    }
+    catch {
+        throw new McpolyglotError('connector.missing_dep', 'The "better-sqlite3" package is required for the sqlite dialect. Install it with: pnpm add better-sqlite3');
+    }
+}
+//# sourceMappingURL=sqlite.js.map