@gizmodata/gizmosql-mcp 0.1.0

package/dist/format.js

@@ -0,0 +1,240 @@
+// Arrow -> Markdown / JSON rendering with cell truncation and row caps.
+import { DataType, } from "apache-arrow";
+const ELLIPSIS = "…";
+/**
+ * Truncates `text` to `maxChars` Unicode code points (never splitting a
+ * surrogate pair), appending `…` when anything was removed.
+ */
+export function truncateText(text, maxChars) {
+    if (maxChars <= 0)
+        return text.length === 0 ? "" : ELLIPSIS;
+    const points = Array.from(text);
+    if (points.length <= maxChars)
+        return text;
+    return points.slice(0, maxChars).join("") + ELLIPSIS;
+}
+/** Escapes a cell for use inside a Markdown table row. */
+export function escapeMarkdownCell(text) {
+    return text.replace(/\\/g, "\\\\").replace(/\|/g, "\\|").replace(/\r?\n/g, "\\n");
+}
+/** Renders a Markdown table. Cells must already be escaped/truncated strings. */
+export function toMarkdownTable(headers, rows) {
+    const head = `| ${headers.map(escapeMarkdownCell).join(" | ")} |`;
+    const sep = `| ${headers.map(() => "---").join(" | ")} |`;
+    const body = rows.map((r) => `| ${r.join(" | ")} |`);
+    return [head, sep, ...body].join("\n");
+}
+const BIGINT_SAFE = (v) => v >= BigInt(Number.MIN_SAFE_INTEGER) && v <= BigInt(Number.MAX_SAFE_INTEGER)
+    ? Number(v)
+    : v.toString();
+function pad(n, width = 2) {
+    return String(n).padStart(width, "0");
+}
+function isoDate(ms) {
+    const d = new Date(ms);
+    return `${d.getUTCFullYear()}-${pad(d.getUTCMonth() + 1)}-${pad(d.getUTCDate())}`;
+}
+function isoTimestamp(ms, withZone) {
+    const d = new Date(ms);
+    if (Number.isNaN(d.getTime()))
+        return String(ms);
+    const base = `${d.getUTCFullYear()}-${pad(d.getUTCMonth() + 1)}-${pad(d.getUTCDate())}` +
+        `T${pad(d.getUTCHours())}:${pad(d.getUTCMinutes())}:${pad(d.getUTCSeconds())}`;
+    const millis = d.getUTCMilliseconds();
+    const frac = millis ? `.${pad(millis, 3)}` : "";
+    return `${base}${frac}${withZone ? "Z" : ""}`;
+}
+/** Renders a Time value given the Arrow time unit (0=s,1=ms,2=us,3=ns). */
+function isoTime(value, unit) {
+    const perSecond = [1n, 1000n, 1000000n, 1000000000n][unit] ?? 1n;
+    const v = typeof value === "bigint" ? value : BigInt(Math.trunc(value));
+    const totalSeconds = v / perSecond;
+    const fraction = v % perSecond;
+    const h = totalSeconds / 3600n;
+    const m = (totalSeconds % 3600n) / 60n;
+    const s = totalSeconds % 60n;
+    let out = `${pad(Number(h))}:${pad(Number(m))}:${pad(Number(s))}`;
+    if (fraction !== 0n) {
+        const digits = [0, 3, 6, 9][unit] ?? 0;
+        out += `.${fraction.toString().padStart(digits, "0").replace(/0+$/, "")}`;
+    }
+    return out;
+}
+/** Formats an unscaled decimal (as a decimal-digit string) with `scale` digits. */
+export function formatDecimal(unscaled, scale) {
+    let digits = unscaled;
+    let sign = "";
+    if (digits.startsWith("-")) {
+        sign = "-";
+        digits = digits.slice(1);
+    }
+    if (scale <= 0)
+        return sign + digits;
+    digits = digits.padStart(scale + 1, "0");
+    const intPart = digits.slice(0, digits.length - scale);
+    const fracPart = digits.slice(digits.length - scale);
+    return `${sign}${intPart}.${fracPart}`;
+}
+/** Converts an Arrow decimal cell value (BigNum / bigint / number) to its unscaled digit string. */
+function decimalUnscaled(value) {
+    if (typeof value === "bigint")
+        return value.toString();
+    if (typeof value === "number")
+        return BigInt(Math.trunc(value)).toString();
+    const asObj = value;
+    // apache-arrow BN objects stringify to their (signed) integer value.
+    if (asObj && typeof asObj.toString === "function") {
+        const s = asObj.toString();
+        if (/^-?\d+$/.test(s))
+            return s;
+    }
+    return String(value);
+}
+function bytesToBase64(bytes) {
+    return Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength).toString("base64");
+}
+function jsonReplacer(_key, v) {
+    if (typeof v === "bigint")
+        return BIGINT_SAFE(v);
+    if (v instanceof Uint8Array)
+        return bytesToBase64(v);
+    return v;
+}
+/** Recursively converts nested Arrow values (Vector / StructRow / MapRow) to plain JSON. */
+function nestedToJson(value) {
+    if (value === null || value === undefined)
+        return null;
+    if (typeof value === "bigint")
+        return BIGINT_SAFE(value);
+    if (value instanceof Uint8Array)
+        return bytesToBase64(value);
+    if (value instanceof Date)
+        return value.toISOString();
+    if (typeof value !== "object")
+        return value;
+    const obj = value;
+    if (typeof obj.toJSON === "function") {
+        return nestedToJson(obj.toJSON());
+    }
+    if (Array.isArray(value))
+        return value.map(nestedToJson);
+    if (typeof obj.toArray === "function") {
+        return Array.from(obj.toArray(), nestedToJson);
+    }
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+        out[k] = nestedToJson(v);
+    }
+    return out;
+}
+/**
+ * Converts one Arrow cell to a JSON-safe value using the column type for
+ * temporal / decimal / binary rendering.
+ */
+export function cellToJson(value, type) {
+    if (value === null || value === undefined)
+        return null;
+    if (DataType.isDecimal(type)) {
+        return formatDecimal(decimalUnscaled(value), type.scale);
+    }
+    if (DataType.isDate(type)) {
+        const ms = typeof value === "bigint" ? Number(value) : value;
+        return isoDate(ms);
+    }
+    if (DataType.isTimestamp(type)) {
+        const ms = typeof value === "bigint" ? Number(value) : value;
+        return isoTimestamp(ms, Boolean(type.timezone));
+    }
+    if (DataType.isTime(type)) {
+        return isoTime(value, type.unit);
+    }
+    if (DataType.isInterval(type) || DataType.isDuration(type)) {
+        return intervalToString(value);
+    }
+    if (DataType.isBinary(type) || DataType.isLargeBinary(type) || DataType.isFixedSizeBinary(type)) {
+        return bytesToBase64(value);
+    }
+    if (typeof value === "bigint")
+        return BIGINT_SAFE(value);
+    if (typeof value === "number" || typeof value === "string" || typeof value === "boolean") {
+        return value;
+    }
+    return nestedToJson(value);
+}
+function intervalToString(value) {
+    // MONTH_DAY_NANO intervals arrive as Int32Array [months, days, nanosLo, nanosHi];
+    // DAY_TIME as [days, millis]; YEAR_MONTH as a number of months.
+    if (value instanceof Int32Array || Array.isArray(value)) {
+        const arr = Array.from(value);
+        if (arr.length === 4) {
+            const nanos = BigInt.asUintN(32, BigInt(arr[2])) + (BigInt(arr[3]) << 32n);
+            const seconds = Number(nanos) / 1e9;
+            return `${arr[0]} months ${arr[1]} days ${seconds} seconds`;
+        }
+        if (arr.length === 2) {
+            return `${arr[0]} days ${arr[1] / 1000} seconds`;
+        }
+    }
+    if (typeof value === "number")
+        return `${value} months`;
+    if (typeof value === "bigint")
+        return value.toString();
+    return nestedToJson(value) === null ? "NULL" : JSON.stringify(nestedToJson(value), jsonReplacer);
+}
+/** Renders a JSON-safe cell value as display text (no truncation). */
+export function cellToText(json) {
+    if (json === null || json === undefined)
+        return "NULL";
+    if (typeof json === "string")
+        return json;
+    if (typeof json === "number" || typeof json === "boolean" || typeof json === "bigint") {
+        return String(json);
+    }
+    return JSON.stringify(json, jsonReplacer);
+}
+/** Human-readable Arrow type name for a field. */
+export function fieldTypeName(field) {
+    return String(field.type);
+}
+/**
+ * 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 function formatTable(table, options) {
+    const fields = table.schema.fields;
+    const columns = fields.map((f) => ({ name: f.name, type: fieldTypeName(f) }));
+    const total = table.numRows;
+    const limit = Math.max(0, Math.min(options.maxRows, total));
+    const vectors = fields.map((_, i) => table.getChildAt(i));
+    const rows = [];
+    const textRows = [];
+    for (let r = 0; r < limit; r++) {
+        const jsonRow = [];
+        const textRow = [];
+        for (let c = 0; c < fields.length; c++) {
+            const raw = vectors[c]?.get(r);
+            const json = cellToJson(raw, fields[c].type);
+            jsonRow.push(json);
+            textRow.push(escapeMarkdownCell(truncateText(cellToText(json), options.maxCellChars)));
+        }
+        rows.push(jsonRow);
+        textRows.push(textRow);
+    }
+    return {
+        columns,
+        rows,
+        rowCount: rows.length,
+        truncated: total > limit,
+        markdown: toMarkdownTable(columns.map((c) => c.name), textRows),
+    };
+}
+/** Footer line appended to query results. */
+export function resultFooter(input) {
+    const rows = `${input.rowCount} row${input.rowCount === 1 ? "" : "s"} returned`;
+    const trunc = input.truncated
+        ? ` (truncated: more rows exist beyond max_rows=${input.maxRows})`
+        : "";
+    return `${rows}${trunc} · ${input.elapsedMs} ms`;
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

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

package/dist/params.d.ts

@@ -0,0 +1,59 @@
+import type { SqlParameterValue } from "@gizmodata/gizmosql-client";
+import { z } from "zod";
+export declare const TYPED_PARAM_TYPES: readonly ["string", "number", "bigint", "boolean", "date", "timestamp", "binary", "null"];
+export type TypedParamType = (typeof TYPED_PARAM_TYPES)[number];
+export declare const typedParamSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        string: "string";
+        number: "number";
+        bigint: "bigint";
+        boolean: "boolean";
+        binary: "binary";
+        date: "date";
+        timestamp: "timestamp";
+        null: "null";
+    }>;
+    value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
+}, z.core.$strict>;
+export declare const paramValueSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodObject<{
+    type: z.ZodEnum<{
+        string: "string";
+        number: "number";
+        bigint: "bigint";
+        boolean: "boolean";
+        binary: "binary";
+        date: "date";
+        timestamp: "timestamp";
+        null: "null";
+    }>;
+    value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
+}, z.core.$strict>]>;
+export declare const paramsSchema: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodObject<{
+    type: z.ZodEnum<{
+        string: "string";
+        number: "number";
+        bigint: "bigint";
+        boolean: "boolean";
+        binary: "binary";
+        date: "date";
+        timestamp: "timestamp";
+        null: "null";
+    }>;
+    value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>;
+}, z.core.$strict>]>>;
+export type JsonParamValue = z.infer<typeof paramValueSchema>;
+export declare class ParameterError extends Error {
+    constructor(message: string);
+}
+/** Parses an ISO-8601 date or timestamp string into a Date (UTC when no zone given). */
+export declare function parseIsoDateTime(text: string): Date | undefined;
+/** Converts one JSON parameter value into a bindable client value. */
+export declare function convertParam(index: number, value: JsonParamValue): SqlParameterValue;
+/**
+ * Converts the JSON `params` array from a tool call into the positional
+ * values bound by the client. Returns `undefined` when there is nothing
+ * to bind.
+ */
+export declare function convertParams(params: JsonParamValue[] | undefined): SqlParameterValue[] | undefined;
+/** Documentation for the `params` argument, shared by run_query / execute_statement. */
+export declare const PARAMS_DESCRIPTION: string;

package/dist/params.js

@@ -0,0 +1,160 @@
+// Conversion of JSON tool arguments into the typed values that
+// @gizmodata/gizmosql-client binds to `?` / `$1` placeholders.
+//
+// Plain JSON values map as: string -> Utf8 (unless it is an ISO-8601
+// date/timestamp, which becomes a Date -> Timestamp), number -> Int32/
+// Int64/Float64, boolean -> Bool, null -> Null. A typed object form
+// `{ "type": "...", "value": ... }` disambiguates the cases JSON cannot
+// express (bigint, binary, a string that merely looks like a date).
+import { z } from "zod";
+export const TYPED_PARAM_TYPES = [
+    "string",
+    "number",
+    "bigint",
+    "boolean",
+    "date",
+    "timestamp",
+    "binary",
+    "null",
+];
+export const typedParamSchema = z
+    .object({
+    type: z.enum(TYPED_PARAM_TYPES),
+    value: z.union([z.string(), z.number(), z.boolean(), z.null()]).optional(),
+})
+    .strict();
+export const paramValueSchema = z.union([
+    z.string(),
+    z.number(),
+    z.boolean(),
+    z.null(),
+    typedParamSchema,
+]);
+export const paramsSchema = z.array(paramValueSchema);
+export class ParameterError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ParameterError";
+    }
+}
+// YYYY-MM-DD
+const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/u;
+// YYYY-MM-DD[T ]HH:MM[:SS[.fraction]][Z|±HH[:MM]]
+const ISO_TIMESTAMP = /^\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}(?::\d{2}(?:\.\d{1,9})?)?(?:Z|[+-]\d{2}(?::?\d{2})?)?$/u;
+/** Parses an ISO-8601 date or timestamp string into a Date (UTC when no zone given). */
+export function parseIsoDateTime(text) {
+    if (ISO_DATE.test(text)) {
+        const d = new Date(`${text}T00:00:00Z`);
+        return Number.isNaN(d.getTime()) ? undefined : d;
+    }
+    if (ISO_TIMESTAMP.test(text)) {
+        let normalized = text.replace(" ", "T");
+        // Treat zone-less timestamps as UTC so the bound value is deterministic.
+        if (!/(?:Z|[+-]\d{2}(?::?\d{2})?)$/u.test(normalized))
+            normalized += "Z";
+        // Trim fractions beyond milliseconds (Date only keeps ms).
+        normalized = normalized.replace(/(\.\d{3})\d+/u, "$1");
+        const d = new Date(normalized);
+        return Number.isNaN(d.getTime()) ? undefined : d;
+    }
+    return undefined;
+}
+function convertTyped(index, type, value) {
+    const where = `parameter ${index + 1} (type "${type}")`;
+    switch (type) {
+        case "null":
+            return null;
+        case "string":
+            if (value === null || value === undefined)
+                return null;
+            return String(value);
+        case "boolean":
+            if (typeof value === "boolean")
+                return value;
+            if (value === "true")
+                return true;
+            if (value === "false")
+                return false;
+            throw new ParameterError(`${where}: expected a boolean value.`);
+        case "number":
+            if (typeof value === "number")
+                return value;
+            if (typeof value === "string" && value.trim() !== "" && Number.isFinite(Number(value))) {
+                return Number(value);
+            }
+            throw new ParameterError(`${where}: expected a numeric value.`);
+        case "bigint": {
+            if (typeof value === "number") {
+                if (!Number.isSafeInteger(value)) {
+                    throw new ParameterError(`${where}: ${value} is not a safe integer; pass the value as a decimal string.`);
+                }
+                return BigInt(value);
+            }
+            if (typeof value === "string" && /^-?\d+$/u.test(value.trim())) {
+                return BigInt(value.trim());
+            }
+            throw new ParameterError(`${where}: expected an integer or a decimal-digit string.`);
+        }
+        case "date":
+        case "timestamp": {
+            if (typeof value === "number")
+                return new Date(value);
+            if (typeof value === "string") {
+                const d = parseIsoDateTime(value) ?? new Date(value);
+                if (Number.isNaN(d.getTime())) {
+                    throw new ParameterError(`${where}: "${value}" is not a valid ISO-8601 date/timestamp.`);
+                }
+                return d;
+            }
+            throw new ParameterError(`${where}: expected an ISO-8601 string or epoch milliseconds.`);
+        }
+        case "binary": {
+            if (typeof value !== "string") {
+                throw new ParameterError(`${where}: expected a base64 string.`);
+            }
+            return new Uint8Array(Buffer.from(value, "base64"));
+        }
+        default:
+            throw new ParameterError(`${where}: unsupported parameter type.`);
+    }
+}
+/** Converts one JSON parameter value into a bindable client value. */
+export function convertParam(index, value) {
+    if (value === null)
+        return null;
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value === "number") {
+        if (Number.isInteger(value) && !Number.isSafeInteger(value)) {
+            throw new ParameterError(`parameter ${index + 1}: ${value} exceeds JavaScript's safe integer range; ` +
+                `pass it as {"type":"bigint","value":"<digits>"}.`);
+        }
+        return value;
+    }
+    if (typeof value === "string") {
+        return parseIsoDateTime(value) ?? value;
+    }
+    if (typeof value === "object" && value !== null && "type" in value) {
+        return convertTyped(index, value.type, value.value);
+    }
+    throw new ParameterError(`parameter ${index + 1}: unsupported value.`);
+}
+/**
+ * Converts the JSON `params` array from a tool call into the positional
+ * values bound by the client. Returns `undefined` when there is nothing
+ * to bind.
+ */
+export function convertParams(params) {
+    if (!params || params.length === 0)
+        return undefined;
+    return params.map((v, i) => convertParam(i, v));
+}
+/** Documentation for the `params` argument, shared by run_query / execute_statement. */
+export const PARAMS_DESCRIPTION = "Optional JSON array of values bound positionally to ? or $1, $2, ... placeholders in the SQL " +
+    "(typed Arrow parameters — never string interpolation). Use placeholders for any literal that " +
+    "comes from user input or data. Accepted values: string, number, boolean, null, and ISO-8601 " +
+    "date/timestamp strings (converted to TIMESTAMP). For explicit types use " +
+    '{"type":"bigint"|"date"|"timestamp"|"binary"|"string"|"number"|"boolean"|"null","value":...} ' +
+    '(binary values are base64). Note: a placeholder whose type the server cannot infer from ' +
+    "context (e.g. SELECT ?) must be cast, e.g. SELECT ?::INTEGER.";
+//# sourceMappingURL=params.js.map

package/dist/params.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,11 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { GizmoConnection, type McpConfig } from "./connection.js";
+export interface ServerContext {
+    connection: GizmoConnection;
+    config: McpConfig;
+    transport: "stdio" | "http";
+}
+/** Converts a thrown error into a redacted, user-facing message. */
+export declare function describeError(err: unknown, connection: GizmoConnection): string;
+/** Builds the McpServer with every tool/resource registered against `ctx`. */
+export declare function createServer(ctx: ServerContext): McpServer;