@gizmodata/gizmosql-mcp 0.1.0

package/dist/connection.d.ts

@@ -0,0 +1,120 @@
+import { FlightSQLClient, type SqlParameters } from "@gizmodata/gizmosql-client";
+import { Table } from "apache-arrow";
+export type AuthMethod = "password" | "token" | "none";
+export interface McpConfig {
+    host: string;
+    port: number;
+    username?: string;
+    password?: string;
+    token?: string;
+    plaintext: boolean;
+    tlsSkipVerify: boolean;
+    oauthPort: number;
+    allowWrites: boolean;
+    maxRows: number;
+    maxCellChars: number;
+    queryTimeoutSeconds: number;
+    /** Bearer token required on every Streamable HTTP request (http transport only). */
+    mcpBearerToken?: string;
+    /** Enables the optional `login_sso` tool (OAuth/SSO browser flow). */
+    enableSso: boolean;
+}
+export declare const DEFAULTS: {
+    readonly port: 31337;
+    readonly oauthPort: 31339;
+    readonly maxRows: 500;
+    readonly maxCellChars: 200;
+    readonly queryTimeoutSeconds: 60;
+};
+export declare class ConfigError extends Error {
+    constructor(message: string);
+}
+export declare function parseBoolean(name: string, raw: string | undefined, fallback: boolean): boolean;
+export declare function parseInteger(name: string, raw: string | undefined, fallback: number, { min, max }: {
+    min: number;
+    max?: number;
+}): number;
+/** Builds the effective configuration from environment variables. */
+export declare function parseConfig(env?: NodeJS.ProcessEnv): McpConfig;
+export declare function authMethod(config: Pick<McpConfig, "username" | "password" | "token">): AuthMethod;
+/** Connection URI with the password/token never included. */
+export declare function redactedUri(config: McpConfig, overrideUser?: string): string;
+/** Replaces every configured secret in `text` with `***`. */
+export declare function redactSecrets(text: string, secrets: Array<string | undefined>): string;
+export declare class QueryTimeoutError extends Error {
+    constructor(seconds: number);
+}
+/** A capped result: up to `maxRows + 1` rows so callers can detect truncation. */
+export interface CappedResult {
+    table: Table;
+    /** True when more rows existed beyond `maxRows` (the extra row is not in `table`). */
+    truncated: boolean;
+}
+/** Heuristic: does this error indicate the underlying connection is unusable? */
+export declare function isConnectionError(err: unknown): boolean;
+export interface SessionOverrides {
+    /** Replaces the configured credentials (used by the SSO flow; kept in memory only). */
+    username?: string;
+    password?: string;
+}
+export interface RunOptions {
+    /** Overrides the configured timeout for this operation (seconds; 0 = none). */
+    timeoutSeconds?: number;
+}
+/**
+ * One FlightSQLClient per process, opened lazily, serialized so a single
+ * statement is in flight at a time, reconnected once on connection loss.
+ * Timeouts are enforced server-side (`SET gizmosql.query_timeout`) with a
+ * client-side deadline as backstop that cancels the statement through the
+ * client's AbortSignal support; only if that fails to settle the call is
+ * the connection dropped and reopened.
+ */
+export declare class GizmoConnection {
+    readonly config: McpConfig;
+    private readonly log;
+    private client;
+    private connecting;
+    private queue;
+    private overrides;
+    private warnings;
+    /** Wall-clock at which the current client was opened (for server_info). */
+    connectedAt: Date | null;
+    constructor(config: McpConfig, log?: (message: string) => void);
+    /** Secrets to redact from any message that might reach a client. */
+    secrets(): Array<string | undefined>;
+    redact(text: string): string;
+    /** Effective auth method, taking SSO overrides into account. */
+    effectiveAuth(): {
+        method: AuthMethod;
+        user?: string;
+    };
+    /** Session-setup warnings (e.g. server too old for SET gizmosql.query_timeout). */
+    sessionWarnings(): string[];
+    /** Swaps in new credentials (SSO) and drops the current connection. */
+    useCredentials(overrides: SessionOverrides): Promise<void>;
+    private clientConfig;
+    /** Opens a fresh client and applies session settings. */
+    private open;
+    /** Returns the shared client, opening it on first use. */
+    get(): Promise<FlightSQLClient>;
+    /** Closes the current client (cancelling any in-flight statement server-side). */
+    reset(): Promise<void>;
+    close(): Promise<void>;
+    /**
+     * Runs `fn` against the shared client with: serialization, one retry
+     * after a connection-level failure, and a client-side deadline that
+     * aborts the statement via `signal` (falling back to dropping the
+     * connection if the abort does not settle the call).
+     */
+    run<T>(fn: (client: FlightSQLClient, signal: AbortSignal | undefined) => Promise<T>, options?: RunOptions): Promise<T>;
+    private withDeadline;
+    /** Convenience: execute a query returning an Arrow table. */
+    query(sql: string, params?: SqlParameters, options?: RunOptions): Promise<Table>;
+    /**
+     * Executes a query and reads at most `maxRows + 1` rows from the result
+     * stream, then releases the stream so no further batches are transferred.
+     */
+    queryCapped(sql: string, params: SqlParameters | undefined, maxRows: number, options?: RunOptions): Promise<CappedResult>;
+    /** Convenience: execute a statement returning the affected-row count. */
+    update(sql: string, params?: SqlParameters, options?: RunOptions): Promise<number>;
+}

package/dist/connection.js

@@ -0,0 +1,349 @@
+// Configuration parsing, credential redaction, and the single lazily
+// opened FlightSQLClient shared by the whole server process.
+import { FlightSQLClient, QueryCancelledError } from "@gizmodata/gizmosql-client";
+import { Table } from "apache-arrow";
+export const DEFAULTS = {
+    port: 31337,
+    oauthPort: 31339,
+    maxRows: 500,
+    maxCellChars: 200,
+    queryTimeoutSeconds: 60,
+};
+export class ConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ConfigError";
+    }
+}
+const TRUE_VALUES = new Set(["1", "true", "yes", "on"]);
+const FALSE_VALUES = new Set(["0", "false", "no", "off", ""]);
+export function parseBoolean(name, raw, fallback) {
+    if (raw === undefined)
+        return fallback;
+    const v = raw.trim().toLowerCase();
+    if (TRUE_VALUES.has(v))
+        return true;
+    if (FALSE_VALUES.has(v))
+        return false;
+    throw new ConfigError(`${name} must be true/false (got "${raw}").`);
+}
+export function parseInteger(name, raw, fallback, { min, max }) {
+    if (raw === undefined || raw.trim() === "")
+        return fallback;
+    const n = Number(raw.trim());
+    if (!Number.isInteger(n) || n < min || (max !== undefined && n > max)) {
+        const range = max === undefined ? `>= ${min}` : `between ${min} and ${max}`;
+        throw new ConfigError(`${name} must be an integer ${range} (got "${raw}").`);
+    }
+    return n;
+}
+function nonEmpty(raw) {
+    if (raw === undefined)
+        return undefined;
+    const v = raw.trim();
+    return v === "" ? undefined : v;
+}
+/** Builds the effective configuration from environment variables. */
+export function parseConfig(env = process.env) {
+    const host = nonEmpty(env.GIZMOSQL_HOST);
+    if (!host) {
+        throw new ConfigError("GIZMOSQL_HOST is required (hostname or IP of the GizmoSQL server).");
+    }
+    const username = nonEmpty(env.GIZMOSQL_USERNAME);
+    const password = env.GIZMOSQL_PASSWORD !== undefined ? env.GIZMOSQL_PASSWORD : undefined;
+    const token = nonEmpty(env.GIZMOSQL_TOKEN);
+    const enableSso = parseBoolean("GIZMOSQL_ENABLE_SSO", env.GIZMOSQL_ENABLE_SSO, false);
+    const hasPassword = username !== undefined || (password !== undefined && password !== "");
+    const hasToken = token !== undefined;
+    if (hasPassword && hasToken) {
+        throw new ConfigError("Set either GIZMOSQL_USERNAME/GIZMOSQL_PASSWORD or GIZMOSQL_TOKEN, not both.");
+    }
+    if (hasPassword && (username === undefined || password === undefined)) {
+        throw new ConfigError("GIZMOSQL_USERNAME and GIZMOSQL_PASSWORD must be set together.");
+    }
+    if (!hasPassword && !hasToken && !enableSso) {
+        throw new ConfigError("No credentials configured: set GIZMOSQL_USERNAME + GIZMOSQL_PASSWORD, or GIZMOSQL_TOKEN " +
+            "(or GIZMOSQL_ENABLE_SSO=true to sign in with the login_sso tool).");
+    }
+    return {
+        host,
+        port: parseInteger("GIZMOSQL_PORT", env.GIZMOSQL_PORT, DEFAULTS.port, { min: 1, max: 65535 }),
+        username: hasPassword ? username : undefined,
+        password: hasPassword ? password : undefined,
+        token: hasToken ? token : undefined,
+        plaintext: parseBoolean("GIZMOSQL_PLAINTEXT", env.GIZMOSQL_PLAINTEXT, false),
+        tlsSkipVerify: parseBoolean("GIZMOSQL_TLS_SKIP_VERIFY", env.GIZMOSQL_TLS_SKIP_VERIFY, false),
+        oauthPort: parseInteger("GIZMOSQL_OAUTH_PORT", env.GIZMOSQL_OAUTH_PORT, DEFAULTS.oauthPort, {
+            min: 1,
+            max: 65535,
+        }),
+        allowWrites: parseBoolean("GIZMOSQL_ALLOW_WRITES", env.GIZMOSQL_ALLOW_WRITES, false),
+        maxRows: parseInteger("GIZMOSQL_MAX_ROWS", env.GIZMOSQL_MAX_ROWS, DEFAULTS.maxRows, {
+            min: 1,
+            max: 100000,
+        }),
+        maxCellChars: parseInteger("GIZMOSQL_MAX_CELL_CHARS", env.GIZMOSQL_MAX_CELL_CHARS, DEFAULTS.maxCellChars, { min: 1, max: 100000 }),
+        queryTimeoutSeconds: parseInteger("GIZMOSQL_QUERY_TIMEOUT_SECONDS", env.GIZMOSQL_QUERY_TIMEOUT_SECONDS, DEFAULTS.queryTimeoutSeconds, { min: 0, max: 86400 }),
+        mcpBearerToken: nonEmpty(env.GIZMOSQL_MCP_BEARER_TOKEN),
+        enableSso,
+    };
+}
+export function authMethod(config) {
+    if (config.token)
+        return "token";
+    if (config.username !== undefined)
+        return "password";
+    return "none";
+}
+/** Connection URI with the password/token never included. */
+export function redactedUri(config, overrideUser) {
+    const user = overrideUser ?? (authMethod(config) === "token" ? "token" : config.username);
+    const cred = user ? `${encodeURIComponent(user)}:***@` : "";
+    const transport = config.plaintext ? "?transport=tcp" : "";
+    return `gizmosql://${cred}${config.host}:${config.port}${transport}`;
+}
+/** Replaces every configured secret in `text` with `***`. */
+export function redactSecrets(text, secrets) {
+    let out = text;
+    for (const s of secrets) {
+        if (!s || s.length === 0)
+            continue;
+        out = out.split(s).join("***");
+        const encoded = encodeURIComponent(s);
+        if (encoded !== s)
+            out = out.split(encoded).join("***");
+    }
+    return out;
+}
+export class QueryTimeoutError extends Error {
+    constructor(seconds) {
+        super(`Query exceeded the ${seconds}s timeout (GIZMOSQL_QUERY_TIMEOUT_SECONDS) and was cancelled.`);
+        this.name = "QueryTimeoutError";
+    }
+}
+/** Grace added to the server-side timeout before the client-side abort fires. */
+const CLIENT_DEADLINE_GRACE_MS = 5000;
+/** If an abort does not settle the call (e.g. a DoPut update), drop the connection after this. */
+const HARD_RESET_GRACE_MS = 15000;
+const CONNECTION_LOST = /unavailable|connection (?:refused|reset|closed|lost)|transport is closing|broken pipe|\bEOF\b|not connected|failed to connect|socket hang up|ECONNRESET|ECONNREFUSED|EPIPE|canceled|deadline exceeded|no connection/i;
+/** Heuristic: does this error indicate the underlying connection is unusable? */
+export function isConnectionError(err) {
+    const name = err?.name ?? "";
+    if (name === "ConnectionError" || name === "AuthenticationError")
+        return name === "ConnectionError";
+    const message = err instanceof Error ? err.message : String(err);
+    return CONNECTION_LOST.test(message);
+}
+/**
+ * One FlightSQLClient per process, opened lazily, serialized so a single
+ * statement is in flight at a time, reconnected once on connection loss.
+ * Timeouts are enforced server-side (`SET gizmosql.query_timeout`) with a
+ * client-side deadline as backstop that cancels the statement through the
+ * client's AbortSignal support; only if that fails to settle the call is
+ * the connection dropped and reopened.
+ */
+export class GizmoConnection {
+    config;
+    log;
+    client = null;
+    connecting = null;
+    queue = Promise.resolve();
+    overrides = {};
+    warnings = [];
+    /** Wall-clock at which the current client was opened (for server_info). */
+    connectedAt = null;
+    constructor(config, log = (m) => console.error(m)) {
+        this.config = config;
+        this.log = log;
+    }
+    /** Secrets to redact from any message that might reach a client. */
+    secrets() {
+        return [this.config.password, this.config.token, this.overrides.password, this.config.mcpBearerToken];
+    }
+    redact(text) {
+        return redactSecrets(text, this.secrets());
+    }
+    /** Effective auth method, taking SSO overrides into account. */
+    effectiveAuth() {
+        if (this.overrides.username !== undefined) {
+            return { method: "password", user: this.overrides.username };
+        }
+        const method = authMethod(this.config);
+        return { method, user: method === "password" ? this.config.username : undefined };
+    }
+    /** Session-setup warnings (e.g. server too old for SET gizmosql.query_timeout). */
+    sessionWarnings() {
+        return [...this.warnings];
+    }
+    /** Swaps in new credentials (SSO) and drops the current connection. */
+    async useCredentials(overrides) {
+        this.overrides = overrides;
+        await this.reset();
+    }
+    clientConfig() {
+        const base = {
+            host: this.config.host,
+            port: this.config.port,
+            plaintext: this.config.plaintext,
+            tlsSkipVerify: this.config.tlsSkipVerify,
+            oauthPort: this.config.oauthPort,
+        };
+        if (this.overrides.username !== undefined) {
+            return { ...base, username: this.overrides.username, password: this.overrides.password ?? "" };
+        }
+        if (this.config.token)
+            return { ...base, token: this.config.token };
+        if (this.config.username !== undefined) {
+            return { ...base, username: this.config.username, password: this.config.password ?? "" };
+        }
+        return base;
+    }
+    /** Opens a fresh client and applies session settings. */
+    async open() {
+        const client = new FlightSQLClient(this.clientConfig());
+        await client.connect();
+        this.warnings = [];
+        if (this.config.queryTimeoutSeconds > 0) {
+            try {
+                await client.executeUpdate(`SET gizmosql.query_timeout = ${this.config.queryTimeoutSeconds}`);
+            }
+            catch (err) {
+                const msg = this.redact(err instanceof Error ? err.message : String(err));
+                this.warnings.push(`Server-side query timeout could not be set (server may predate SET gizmosql.query_timeout); ` +
+                    `falling back to the client-side deadline only. ${msg}`);
+                this.log(`[gizmosql-mcp] warning: ${this.warnings[this.warnings.length - 1]}`);
+            }
+        }
+        this.connectedAt = new Date();
+        return client;
+    }
+    /** Returns the shared client, opening it on first use. */
+    async get() {
+        if (this.client)
+            return this.client;
+        if (!this.connecting) {
+            this.connecting = this.open()
+                .then((c) => {
+                this.client = c;
+                return c;
+            })
+                .finally(() => {
+                this.connecting = null;
+            });
+        }
+        return this.connecting;
+    }
+    /** Closes the current client (cancelling any in-flight statement server-side). */
+    async reset() {
+        const client = this.client;
+        this.client = null;
+        this.connectedAt = null;
+        if (client) {
+            try {
+                await client.close();
+            }
+            catch {
+                // already gone
+            }
+        }
+    }
+    async close() {
+        await this.reset();
+    }
+    /**
+     * Runs `fn` against the shared client with: serialization, one retry
+     * after a connection-level failure, and a client-side deadline that
+     * aborts the statement via `signal` (falling back to dropping the
+     * connection if the abort does not settle the call).
+     */
+    async run(fn, options = {}) {
+        const task = async () => {
+            let attempt = 0;
+            for (;;) {
+                attempt++;
+                const client = await this.get();
+                try {
+                    return await this.withDeadline((signal) => fn(client, signal), options.timeoutSeconds);
+                }
+                catch (err) {
+                    if (err instanceof QueryTimeoutError) {
+                        throw err;
+                    }
+                    if (attempt < 2 && isConnectionError(err)) {
+                        this.log(`[gizmosql-mcp] connection error, reconnecting: ${this.redact(err instanceof Error ? err.message : String(err))}`);
+                        await this.reset();
+                        continue;
+                    }
+                    throw err;
+                }
+            }
+        };
+        const result = this.queue.then(task, task);
+        this.queue = result.catch(() => undefined);
+        return result;
+    }
+    async withDeadline(fn, timeoutSeconds) {
+        const seconds = timeoutSeconds ?? this.config.queryTimeoutSeconds;
+        if (!seconds || seconds <= 0)
+            return fn(undefined);
+        // The server enforces `gizmosql.query_timeout` at `seconds`; the
+        // client-side abort is a backstop a few seconds later.
+        const controller = new AbortController();
+        const timeoutError = new QueryTimeoutError(seconds);
+        let abortTimer;
+        let resetTimer;
+        const hardReset = new Promise((_, reject) => {
+            abortTimer = setTimeout(() => {
+                controller.abort(timeoutError);
+                // If the abort cannot interrupt the call (e.g. a DoPut update),
+                // drop the connection so the server sees the client go away.
+                resetTimer = setTimeout(() => {
+                    void this.reset().finally(() => reject(timeoutError));
+                }, HARD_RESET_GRACE_MS);
+            }, seconds * 1000 + CLIENT_DEADLINE_GRACE_MS);
+        });
+        try {
+            return await Promise.race([fn(controller.signal), hardReset]);
+        }
+        catch (err) {
+            if (controller.signal.aborted && (err instanceof QueryCancelledError || err === timeoutError)) {
+                throw timeoutError;
+            }
+            throw err;
+        }
+        finally {
+            if (abortTimer)
+                clearTimeout(abortTimer);
+            if (resetTimer)
+                clearTimeout(resetTimer);
+        }
+    }
+    /** Convenience: execute a query returning an Arrow table. */
+    query(sql, params, options) {
+        return this.run((c, signal) => c.execute(sql, params, { signal }), options);
+    }
+    /**
+     * Executes a query and reads at most `maxRows + 1` rows from the result
+     * stream, then releases the stream so no further batches are transferred.
+     */
+    queryCapped(sql, params, maxRows, options) {
+        return this.run(async (c, signal) => {
+            const stream = await c.executeStream(sql, params, { signal });
+            const batches = [];
+            let rows = 0;
+            for await (const batch of stream) {
+                batches.push(batch);
+                rows += batch.numRows;
+                if (rows > maxRows)
+                    break; // releases the stream
+            }
+            const table = new Table(stream.schema, batches);
+            return { table: rows > maxRows ? table.slice(0, maxRows) : table, truncated: rows > maxRows };
+        }, options);
+    }
+    /** Convenience: execute a statement returning the affected-row count. */
+    update(sql, params, options) {
+        return this.run((c, signal) => c.executeUpdate(sql, params, { signal }), options);
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

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

package/dist/format.d.ts

@@ -0,0 +1,56 @@
+import { DataType, type Field, type Table } from "apache-arrow";
+export interface FormatOptions {
+    /** Maximum number of rows to render. */
+    maxRows: number;
+    /** Maximum characters per cell before truncation with `…`. */
+    maxCellChars: number;
+}
+export interface ColumnInfo {
+    name: string;
+    /** Arrow type rendered as a string, e.g. `Int64`, `Utf8`, `Decimal[10e+2]`. */
+    type: string;
+}
+export interface FormattedResult {
+    columns: ColumnInfo[];
+    /** JSON-safe row values (bigint -> number/string, dates -> ISO, binary -> base64). */
+    rows: unknown[][];
+    /** Rows actually rendered (<= maxRows). */
+    rowCount: number;
+    /** True when the source table held more rows than `rowCount`. */
+    truncated: boolean;
+    /** Markdown table of the rendered rows. */
+    markdown: string;
+}
+/**
+ * Truncates `text` to `maxChars` Unicode code points (never splitting a
+ * surrogate pair), appending `…` when anything was removed.
+ */
+export declare function truncateText(text: string, maxChars: number): string;
+/** Escapes a cell for use inside a Markdown table row. */
+export declare function escapeMarkdownCell(text: string): string;
+/** Renders a Markdown table. Cells must already be escaped/truncated strings. */
+export declare function toMarkdownTable(headers: string[], rows: string[][]): string;
+/** Formats an unscaled decimal (as a decimal-digit string) with `scale` digits. */
+export declare function formatDecimal(unscaled: string, scale: number): string;
+/**
+ * Converts one Arrow cell to a JSON-safe value using the column type for
+ * temporal / decimal / binary rendering.
+ */
+export declare function cellToJson(value: unknown, type: DataType): unknown;
+/** Renders a JSON-safe cell value as display text (no truncation). */
+export declare function cellToText(json: unknown): string;
+/** Human-readable Arrow type name for a field. */
+export declare function fieldTypeName(field: Field): string;
+/**
+ * Renders up to `maxRows` rows of an Arrow table as Markdown and JSON.
+ * Reads column vectors row-by-row and stops at the cap — it never
+ * materializes the whole table into JS objects.
+ */
+export declare function formatTable(table: Table, options: FormatOptions): FormattedResult;
+/** Footer line appended to query results. */
+export declare function resultFooter(input: {
+    rowCount: number;
+    truncated: boolean;
+    maxRows: number;
+    elapsedMs: number;
+}): string;