@lumifai/harness-tool-pack-postgres 0.0.1

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AA4CA,kDAEC;AAlCD,MAAa,iBAAkB,SAAQ,KAAK;IACjC,IAAI,CAAwB;IAC5B,IAAI,CAAU;IACd,IAAI,CAAU;IAEvB,YACE,IAA2B,EAC3B,OAAe,EACf,OAA2D;QAE3D,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,CAAC;IAC5B,CAAC;IAED,MAAM;QAMJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,CAAC;IACJ,CAAC;CACF;AA9BD,8CA8BC;AAED,SAAgB,mBAAmB,CAAC,KAAc;IAChD,OAAO,KAAK,YAAY,iBAAiB,CAAC;AAC5C,CAAC"}

package/dist/identifiers.d.ts

@@ -0,0 +1 @@
+export declare function assertIdentifier(value: string, path: string): string;

package/dist/identifiers.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertIdentifier = assertIdentifier;
+const errors_1 = require("./errors");
+const IDENTIFIER_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+function assertIdentifier(value, path) {
+    if (value.length === 0 || value.length > 63) {
+        throw new errors_1.PostgresToolError('INVALID_INPUT', `Invalid identifier at ${path}.`, {
+            path,
+            hint: 'Identifiers must be 1-63 characters.',
+        });
+    }
+    if (!IDENTIFIER_PATTERN.test(value)) {
+        throw new errors_1.PostgresToolError('INVALID_INPUT', `Invalid identifier "${value}" at ${path}.`, {
+            path,
+            hint: 'Use unquoted SQL identifiers matching /^[a-zA-Z_][a-zA-Z0-9_]*$/.',
+        });
+    }
+    return value;
+}
+//# sourceMappingURL=identifiers.js.map

package/dist/identifiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifiers.js","sourceRoot":"","sources":["../src/identifiers.ts"],"names":[],"mappings":";;AAIA,4CAgBC;AApBD,qCAA6C;AAE7C,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;AAEtD,SAAgB,gBAAgB,CAAC,KAAa,EAAE,IAAY;IAC1D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,0BAAiB,CAAC,eAAe,EAAE,yBAAyB,IAAI,GAAG,EAAE;YAC7E,IAAI;YACJ,IAAI,EAAE,sCAAsC;SAC7C,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,0BAAiB,CAAC,eAAe,EAAE,uBAAuB,KAAK,QAAQ,IAAI,GAAG,EAAE;YACxF,IAAI;YACJ,IAAI,EAAE,mEAAmE;SAC1E,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { DEFAULT_POSTGRES_QUERY_LIMIT, MAX_POSTGRES_QUERY_LIMIT, DEFAULT_MAX_INSERT_ROWS, MAX_INSERT_ROWS, createPostgresTools, createPostgresToolPack, resolvePostgresSkillPath, queryPlanSchema, previewInputSchema, schemaDetailsInputSchema, insertInputSchema, insertResultSchema, } from './postgres';
+export type { PostgresToolsOptions } from './postgres';
+export type { QueryPlan, QueryResult } from './query-language';
+export type { InsertInput, InsertResult } from './insert-language';
+export { QUERY_PLAN_VERSION } from './constants';
+export { PostgresToolError, isPostgresToolError } from './errors';
+export type { PostgresToolErrorCode } from './errors';

package/dist/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPostgresToolError = exports.PostgresToolError = exports.QUERY_PLAN_VERSION = exports.insertResultSchema = exports.insertInputSchema = exports.schemaDetailsInputSchema = exports.previewInputSchema = exports.queryPlanSchema = exports.resolvePostgresSkillPath = exports.createPostgresToolPack = exports.createPostgresTools = exports.MAX_INSERT_ROWS = exports.DEFAULT_MAX_INSERT_ROWS = exports.MAX_POSTGRES_QUERY_LIMIT = exports.DEFAULT_POSTGRES_QUERY_LIMIT = void 0;
+var postgres_1 = require("./postgres");
+Object.defineProperty(exports, "DEFAULT_POSTGRES_QUERY_LIMIT", { enumerable: true, get: function () { return postgres_1.DEFAULT_POSTGRES_QUERY_LIMIT; } });
+Object.defineProperty(exports, "MAX_POSTGRES_QUERY_LIMIT", { enumerable: true, get: function () { return postgres_1.MAX_POSTGRES_QUERY_LIMIT; } });
+Object.defineProperty(exports, "DEFAULT_MAX_INSERT_ROWS", { enumerable: true, get: function () { return postgres_1.DEFAULT_MAX_INSERT_ROWS; } });
+Object.defineProperty(exports, "MAX_INSERT_ROWS", { enumerable: true, get: function () { return postgres_1.MAX_INSERT_ROWS; } });
+Object.defineProperty(exports, "createPostgresTools", { enumerable: true, get: function () { return postgres_1.createPostgresTools; } });
+Object.defineProperty(exports, "createPostgresToolPack", { enumerable: true, get: function () { return postgres_1.createPostgresToolPack; } });
+Object.defineProperty(exports, "resolvePostgresSkillPath", { enumerable: true, get: function () { return postgres_1.resolvePostgresSkillPath; } });
+Object.defineProperty(exports, "queryPlanSchema", { enumerable: true, get: function () { return postgres_1.queryPlanSchema; } });
+Object.defineProperty(exports, "previewInputSchema", { enumerable: true, get: function () { return postgres_1.previewInputSchema; } });
+Object.defineProperty(exports, "schemaDetailsInputSchema", { enumerable: true, get: function () { return postgres_1.schemaDetailsInputSchema; } });
+Object.defineProperty(exports, "insertInputSchema", { enumerable: true, get: function () { return postgres_1.insertInputSchema; } });
+Object.defineProperty(exports, "insertResultSchema", { enumerable: true, get: function () { return postgres_1.insertResultSchema; } });
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "QUERY_PLAN_VERSION", { enumerable: true, get: function () { return constants_1.QUERY_PLAN_VERSION; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "PostgresToolError", { enumerable: true, get: function () { return errors_1.PostgresToolError; } });
+Object.defineProperty(exports, "isPostgresToolError", { enumerable: true, get: function () { return errors_1.isPostgresToolError; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uCAaoB;AAZlB,wHAAA,4BAA4B,OAAA;AAC5B,oHAAA,wBAAwB,OAAA;AACxB,mHAAA,uBAAuB,OAAA;AACvB,2GAAA,eAAe,OAAA;AACf,+GAAA,mBAAmB,OAAA;AACnB,kHAAA,sBAAsB,OAAA;AACtB,oHAAA,wBAAwB,OAAA;AACxB,2GAAA,eAAe,OAAA;AACf,8GAAA,kBAAkB,OAAA;AAClB,oHAAA,wBAAwB,OAAA;AACxB,6GAAA,iBAAiB,OAAA;AACjB,8GAAA,kBAAkB,OAAA;AAKpB,yCAAiD;AAAxC,+GAAA,kBAAkB,OAAA;AAC3B,mCAAkE;AAAzD,2GAAA,iBAAiB,OAAA;AAAE,6GAAA,mBAAmB,OAAA"}

package/dist/insert-compiler.d.ts

@@ -0,0 +1,21 @@
+import type { CatalogRelation, PostgresCatalog } from './catalog';
+import type { InsertRow } from './insert-language';
+import type { CompiledQuery } from './query-compiler';
+export type PreparedInsertRow = {
+    index: number;
+    columns: string[];
+    values: Array<string | number | boolean | null>;
+    compiled: CompiledQuery;
+};
+export type PrepareInsertBatchResult = {
+    relation: CatalogRelation;
+    prepared: PreparedInsertRow[];
+    rejected: Array<{
+        index: number;
+        path?: string;
+        code: 'INVALID_INPUT' | 'UNKNOWN_COLUMN' | 'UNKNOWN_RELATION';
+        message: string;
+    }>;
+};
+export declare function prepareInsertBatch(catalog: PostgresCatalog, schema: string, relationName: string, rows: InsertRow[]): PrepareInsertBatchResult;
+export declare function compileInsertRow(schema: string, relation: string, columns: string[], values: Array<string | number | boolean | null>): CompiledQuery;

package/dist/insert-compiler.js

@@ -0,0 +1,126 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareInsertBatch = prepareInsertBatch;
+exports.compileInsertRow = compileInsertRow;
+const pg_sql2_1 = __importDefault(require("pg-sql2"));
+const catalog_1 = require("./catalog");
+const errors_1 = require("./errors");
+const identifiers_1 = require("./identifiers");
+function prepareInsertBatch(catalog, schema, relationName, rows) {
+    const relation = (0, catalog_1.getCatalogRelation)(catalog, schema, relationName);
+    if (!relation) {
+        throw new errors_1.PostgresToolError('UNKNOWN_RELATION', `Unknown relation ${schema}.${relationName}.`, {
+            path: 'relation',
+            hint: 'Use postgres_get_schema_details to inspect tables visible to the connection role.',
+        });
+    }
+    if (relation.kind !== 'table') {
+        throw new errors_1.PostgresToolError('INVALID_INPUT', `Cannot insert into ${schema}.${relationName} because it is a ${relation.kind}.`, {
+            path: 'relation',
+            hint: 'Inserts are only supported against physical tables.',
+        });
+    }
+    const catalogColumns = new Map(relation.columns.map((column) => [column.name, column]));
+    const prepared = [];
+    const rejected = [];
+    for (let index = 0; index < rows.length; index += 1) {
+        const row = rows[index];
+        try {
+            const preparedRow = prepareInsertRow(schema, relationName, catalogColumns, row, index);
+            prepared.push(preparedRow);
+        }
+        catch (error) {
+            if (error instanceof errors_1.PostgresToolError) {
+                const code = error.code === 'UNKNOWN_COLUMN' || error.code === 'INVALID_INPUT'
+                    ? error.code
+                    : 'INVALID_INPUT';
+                rejected.push({
+                    index,
+                    path: error.path,
+                    code,
+                    message: error.message,
+                });
+                continue;
+            }
+            throw error;
+        }
+    }
+    return { relation, prepared, rejected };
+}
+function prepareInsertRow(schema, relationName, catalogColumns, row, index) {
+    const keys = Object.keys(row);
+    if (keys.length === 0) {
+        throw new errors_1.PostgresToolError('INVALID_INPUT', 'Insert row must include at least one column.', {
+            path: `rows[${index}]`,
+        });
+    }
+    const columns = [];
+    const values = [];
+    // Stable catalog ordinal order keeps SQL fingerprints predictable across rows
+    // that share the same column set.
+    const orderedKeys = [...keys].sort((left, right) => {
+        const leftPos = catalogColumns.get(left)?.ordinalPosition ?? Number.MAX_SAFE_INTEGER;
+        const rightPos = catalogColumns.get(right)?.ordinalPosition ?? Number.MAX_SAFE_INTEGER;
+        if (leftPos !== rightPos) {
+            return leftPos - rightPos;
+        }
+        return left.localeCompare(right);
+    });
+    for (const key of orderedKeys) {
+        (0, identifiers_1.assertIdentifier)(key, `rows[${index}].${key}`);
+        if (!catalogColumns.has(key)) {
+            throw new errors_1.PostgresToolError('UNKNOWN_COLUMN', `Unknown column "${key}" for ${schema}.${relationName}.`, {
+                path: `rows[${index}].${key}`,
+                hint: 'Use postgres_get_schema_details to inspect available columns.',
+            });
+        }
+        columns.push(key);
+        values.push(row[key] ?? null);
+    }
+    const compiled = compileInsertRow(schema, relationName, columns, values);
+    return { index, columns, values, compiled };
+}
+function compileInsertRow(schema, relation, columns, values) {
+    if (columns.length === 0) {
+        throw new errors_1.PostgresToolError('INVALID_INPUT', 'Insert requires at least one column.');
+    }
+    if (columns.length !== values.length) {
+        throw new errors_1.PostgresToolError('COMPILATION_ERROR', 'Insert column count does not match value count.');
+    }
+    (0, identifiers_1.assertIdentifier)(schema, 'schema');
+    (0, identifiers_1.assertIdentifier)(relation, 'relation');
+    for (const column of columns) {
+        (0, identifiers_1.assertIdentifier)(column, 'columns');
+    }
+    try {
+        const columnSql = pg_sql2_1.default.join(columns.map((column) => pg_sql2_1.default.identifier(column)), ', ');
+        const valueSql = pg_sql2_1.default.join(values.map((value) => pg_sql2_1.default.value(value)), ', ');
+        const fragment = pg_sql2_1.default.query `INSERT INTO ${pg_sql2_1.default.identifier(schema, relation)} (${columnSql}) VALUES (${valueSql})`;
+        const compiled = pg_sql2_1.default.compile(fragment);
+        const referencedRelations = [`${schema}.${relation}`];
+        return {
+            text: compiled.text,
+            values: compiled.values,
+            fingerprint: hashFingerprint(compiled.text, referencedRelations),
+            referencedRelations,
+        };
+    }
+    catch (error) {
+        if (error instanceof errors_1.PostgresToolError) {
+            throw error;
+        }
+        throw new errors_1.PostgresToolError('COMPILATION_ERROR', error instanceof Error ? error.message : String(error), { cause: error });
+    }
+}
+function hashFingerprint(text, relations) {
+    const input = `${text}::${[...relations].sort().join(',')}`;
+    let hash = 0;
+    for (let index = 0; index < input.length; index += 1) {
+        hash = (hash * 31 + input.charCodeAt(index)) >>> 0;
+    }
+    return hash.toString(16);
+}
+//# sourceMappingURL=insert-compiler.js.map

package/dist/insert-compiler.js.map

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

package/dist/insert-executor.d.ts

@@ -0,0 +1,25 @@
+import type { Client } from 'pg';
+import type { PreparedInsertRow } from './insert-compiler';
+import type { InsertRejection, InsertSourceKind } from './insert-language';
+import { type ExecutionOptions } from './query-executor';
+export type InsertAuditRecord = {
+    relation: string;
+    sourceKind: InsertSourceKind;
+    durationMs: number;
+    sourceCount: number;
+    insertedCount: number;
+    rejectedCount: number;
+};
+export type InsertAuditCallback = (record: InsertAuditRecord) => void;
+export type ExecuteInsertBatchInput = {
+    schema: string;
+    relation: string;
+    sourceKind: InsertSourceKind;
+    sourceCount: number;
+    prepared: PreparedInsertRow[];
+    preflightRejected: InsertRejection[];
+};
+export declare function executeInsertBatch(client: Client, input: ExecuteInsertBatchInput, options?: ExecutionOptions, audit?: InsertAuditCallback): Promise<{
+    inserted_count: number;
+    rejected: InsertRejection[];
+}>;

package/dist/insert-executor.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeInsertBatch = executeInsertBatch;
+const constants_1 = require("./constants");
+const query_executor_1 = require("./query-executor");
+async function executeInsertBatch(client, input, options = {}, audit) {
+    const started = Date.now();
+    const rejected = [...input.preflightRejected];
+    let insertedCount = 0;
+    await beginReadWriteTransaction(client, options);
+    try {
+        await client.query('SET CONSTRAINTS ALL IMMEDIATE');
+        for (const row of input.prepared) {
+            const savepoint = `row_${row.index}`;
+            await client.query(`SAVEPOINT ${savepoint}`);
+            try {
+                await client.query(row.compiled.text, row.compiled.values);
+                await client.query(`RELEASE SAVEPOINT ${savepoint}`);
+                insertedCount += 1;
+            }
+            catch (error) {
+                await client.query(`ROLLBACK TO SAVEPOINT ${savepoint}`).catch(() => undefined);
+                rejected.push(mapRowExecutionError(error, row.index));
+            }
+        }
+        await client.query('COMMIT');
+    }
+    catch (error) {
+        await client.query('ROLLBACK').catch(() => undefined);
+        throw (0, query_executor_1.mapExecutionError)(error);
+    }
+    audit?.({
+        relation: `${input.schema}.${input.relation}`,
+        sourceKind: input.sourceKind,
+        durationMs: Date.now() - started,
+        sourceCount: input.sourceCount,
+        insertedCount,
+        rejectedCount: rejected.length,
+    });
+    return {
+        inserted_count: insertedCount,
+        rejected: rejected.sort((left, right) => left.index - right.index),
+    };
+}
+async function beginReadWriteTransaction(client, options) {
+    const statementTimeout = options.statementTimeoutMs ?? constants_1.DEFAULT_STATEMENT_TIMEOUT_MS;
+    const lockTimeout = options.lockTimeoutMs ?? constants_1.DEFAULT_LOCK_TIMEOUT_MS;
+    // Inserts with many savepoints can outlive the read-path idle default.
+    const idleTimeout = options.idleInTransactionTimeoutMs ?? Math.max(constants_1.DEFAULT_IDLE_IN_TRANSACTION_TIMEOUT_MS, 30_000);
+    await client.query('BEGIN');
+    await client.query(`SET LOCAL statement_timeout = ${statementTimeout}`);
+    await client.query(`SET LOCAL lock_timeout = ${lockTimeout}`);
+    await client.query(`SET LOCAL idle_in_transaction_session_timeout = ${idleTimeout}`);
+    const tempFileLimitKb = Math.min(Math.max(options.tempFileLimitKb ?? constants_1.DEFAULT_TEMP_FILE_LIMIT_KB, 1), constants_1.MAX_TEMP_FILE_LIMIT_KB);
+    await client.query(`SET LOCAL temp_file_limit = '${tempFileLimitKb}kB'`);
+    if (options.searchPath && options.searchPath.length > 0) {
+        const path = options.searchPath.map((entry) => `"${entry.replace(/"/g, '""')}"`).join(', ');
+        await client.query(`SET LOCAL search_path = ${path}`);
+    }
+}
+function mapRowExecutionError(error, index) {
+    const mapped = (0, query_executor_1.mapExecutionError)(error);
+    const pgCode = typeof error === 'object' && error !== null && 'code' in error
+        ? String(error.code ?? '')
+        : '';
+    let code = mapped.code;
+    let message = mapped.message;
+    let path = `rows[${index}]`;
+    if (pgCode === '23505') {
+        code = 'EXECUTION_ERROR';
+        message = `Unique constraint violated for row ${index}.`;
+    }
+    else if (pgCode === '23503') {
+        code = 'EXECUTION_ERROR';
+        message = `Foreign key constraint violated for row ${index}.`;
+    }
+    else if (pgCode === '23502') {
+        code = 'EXECUTION_ERROR';
+        message = `NOT NULL constraint violated for row ${index}.`;
+    }
+    else if (pgCode === '42501') {
+        code = 'POLICY_DENIED';
+        message = `Permission denied inserting row ${index}.`;
+    }
+    else if (mapped.code === 'TIMEOUT') {
+        throw mapped;
+    }
+    const column = typeof error === 'object' && error !== null && 'column' in error
+        ? error.column
+        : undefined;
+    if (typeof column === 'string' && column.length > 0) {
+        path = `rows[${index}].${column}`;
+    }
+    return {
+        index,
+        path,
+        code,
+        message,
+    };
+}
+//# sourceMappingURL=insert-executor.js.map

package/dist/insert-executor.js.map

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

package/dist/insert-language.d.ts

@@ -0,0 +1,56 @@
+import type { ToolExecutionContext } from '@mastra/core/tools';
+import { z } from 'zod';
+import { type PostgresToolErrorCode } from './errors';
+export declare const insertInputSchema: z.ZodObject<{
+    schema: z.ZodString;
+    relation: z.ZodString;
+    source: z.ZodObject<{
+        kind: z.ZodEnum<{
+            json: "json";
+            csv: "csv";
+        }>;
+        columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        rows: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>>;
+        path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type InsertInput = z.infer<typeof insertInputSchema>;
+export type InsertRow = Record<string, string | number | boolean | null>;
+export type InsertSourceKind = 'json' | 'csv';
+export type InsertRejection = {
+    index: number;
+    path?: string;
+    code: PostgresToolErrorCode;
+    message: string;
+};
+export declare const insertResultSchema: z.ZodObject<{
+    schema: z.ZodString;
+    relation: z.ZodString;
+    source_kind: z.ZodEnum<{
+        json: "json";
+        csv: "csv";
+    }>;
+    source_count: z.ZodNumber;
+    inserted_count: z.ZodNumber;
+    rejected_count: z.ZodNumber;
+    rejected: z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        path: z.ZodOptional<z.ZodString>;
+        code: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strip>>;
+    rejection_details_truncated: z.ZodBoolean;
+}, z.core.$strip>;
+export type InsertResult = z.infer<typeof insertResultSchema>;
+export type ResolveInsertRowsOptions = {
+    maxRows?: number;
+    maxCsvBytes?: number;
+};
+export declare function resolveInsertRows(input: InsertInput, context: ToolExecutionContext, options?: ResolveInsertRowsOptions): Promise<{
+    sourceKind: InsertSourceKind;
+    rows: InsertRow[];
+}>;
+export declare function boundRejectionDetails(rejected: InsertRejection[], maxDetails?: number): {
+    rejected: InsertRejection[];
+    rejection_details_truncated: boolean;
+};

package/dist/insert-language.js

@@ -0,0 +1,218 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.insertResultSchema = exports.insertInputSchema = void 0;
+exports.resolveInsertRows = resolveInsertRows;
+exports.boundRejectionDetails = boundRejectionDetails;
+const sync_1 = require("csv-parse/sync");
+const zod_1 = require("zod");
+const constants_1 = require("./constants");
+const errors_1 = require("./errors");
+const workspace_file_1 = require("./workspace-file");
+const identifierSchema = zod_1.z
+    .string()
+    .min(1)
+    .max(63)
+    .regex(/^[a-zA-Z_][a-zA-Z0-9_]*$/);
+const cellValueSchema = zod_1.z.union([
+    zod_1.z.string().max(10_000),
+    zod_1.z.number().finite(),
+    zod_1.z.boolean(),
+    zod_1.z.null(),
+]);
+// Tabular shape (columns + value arrays) instead of keyed row objects:
+// freeform-key objects compile to additionalProperties with a value schema,
+// which OpenAI's strict-mode constraint grammar cannot represent (the request
+// crashes server-side while computing constraint tokens). Arrays of closed
+// unions are fully grammar-representable. Note Mastra promotes any per-tool
+// strict flag to a provider-wide strictJsonSchema, so this schema must stay
+// strict-safe even if the insert tool itself is not marked strict.
+//
+// Flat object instead of a discriminated union: strict tool schemas also
+// reject the oneOf construct unions compile to. Exclusivity between the json
+// and csv fields is enforced by the refinement below (not emitted to JSON
+// schema).
+const insertSourceSchema = zod_1.z
+    .object({
+    kind: zod_1.z
+        .enum(['json', 'csv'])
+        .describe('Row source: inline "json" rows or a workspace "csv" file.'),
+    columns: zod_1.z
+        .array(identifierSchema)
+        .min(1)
+        .optional()
+        .describe('Column names, in the same order as each row. Required when kind is "json"; omit when kind is "csv".'),
+    rows: zod_1.z
+        .array(zod_1.z.array(cellValueSchema).min(1))
+        .min(1)
+        .max(constants_1.MAX_INSERT_ROWS)
+        .optional()
+        .describe('Rows to insert; each row is an array of values aligned with columns. Required when kind is "json"; omit when kind is "csv".'),
+    path: zod_1.z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Absolute workspace path to a CSV file, e.g. /data/rows.csv. Required when kind is "csv"; omit when kind is "json".'),
+})
+    .strict()
+    .superRefine((value, ctx) => {
+    if (value.kind === 'json') {
+        if (!value.columns) {
+            ctx.addIssue({
+                code: 'custom',
+                path: ['columns'],
+                message: 'source.columns is required when kind is "json".',
+            });
+        }
+        if (!value.rows) {
+            ctx.addIssue({
+                code: 'custom',
+                path: ['rows'],
+                message: 'source.rows is required when kind is "json".',
+            });
+        }
+        if (value.path !== undefined) {
+            ctx.addIssue({
+                code: 'custom',
+                path: ['path'],
+                message: 'source.path is not allowed when kind is "json".',
+            });
+        }
+        return;
+    }
+    if (!value.path) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['path'],
+            message: 'source.path is required when kind is "csv".',
+        });
+    }
+    if (value.columns !== undefined) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['columns'],
+            message: 'source.columns is not allowed when kind is "csv".',
+        });
+    }
+    if (value.rows !== undefined) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['rows'],
+            message: 'source.rows is not allowed when kind is "csv".',
+        });
+    }
+});
+exports.insertInputSchema = zod_1.z
+    .object({
+    schema: identifierSchema,
+    relation: identifierSchema,
+    source: insertSourceSchema,
+})
+    .strict();
+exports.insertResultSchema = zod_1.z.object({
+    schema: zod_1.z.string(),
+    relation: zod_1.z.string(),
+    source_kind: zod_1.z.enum(['json', 'csv']),
+    source_count: zod_1.z.number().int().nonnegative(),
+    inserted_count: zod_1.z.number().int().nonnegative(),
+    rejected_count: zod_1.z.number().int().nonnegative(),
+    rejected: zod_1.z.array(zod_1.z.object({
+        index: zod_1.z.number().int().nonnegative(),
+        path: zod_1.z.string().optional(),
+        code: zod_1.z.string(),
+        message: zod_1.z.string(),
+    })),
+    rejection_details_truncated: zod_1.z.boolean(),
+});
+async function resolveInsertRows(input, context, options = {}) {
+    const maxRows = clamp(options.maxRows ?? constants_1.DEFAULT_MAX_INSERT_ROWS, 1, constants_1.MAX_INSERT_ROWS);
+    const maxCsvBytes = clamp(options.maxCsvBytes ?? constants_1.DEFAULT_MAX_INSERT_CSV_BYTES, 1, constants_1.MAX_INSERT_CSV_BYTES);
+    if (input.source.kind === 'json') {
+        const columns = input.source.columns;
+        const jsonRows = input.source.rows;
+        if (!columns || columns.length === 0) {
+            throw new errors_1.PostgresToolError('INVALID_INPUT', 'source.columns is required when kind is "json".', { path: 'source.columns' });
+        }
+        if (!jsonRows || jsonRows.length === 0) {
+            throw new errors_1.PostgresToolError('INVALID_INPUT', 'source.rows is required when kind is "json".', {
+                path: 'source.rows',
+            });
+        }
+        if (jsonRows.length > maxRows) {
+            throw new errors_1.PostgresToolError('COMPLEXITY_EXCEEDED', `JSON source has ${jsonRows.length} rows, exceeding the ${maxRows} row limit.`, { path: 'source.rows' });
+        }
+        const seen = new Set();
+        for (const column of columns) {
+            if (seen.has(column)) {
+                throw new errors_1.PostgresToolError('INVALID_INPUT', `Duplicate column "${column}" in source.columns.`, { path: 'source.columns' });
+            }
+            seen.add(column);
+        }
+        const rows = jsonRows.map((values, index) => {
+            if (values.length !== columns.length) {
+                throw new errors_1.PostgresToolError('INVALID_INPUT', `Row ${index} has ${values.length} values but source.columns has ${columns.length}.`, { path: `source.rows[${index}]` });
+            }
+            const row = {};
+            for (let position = 0; position < columns.length; position += 1) {
+                row[columns[position]] = values[position] ?? null;
+            }
+            return row;
+        });
+        return { sourceKind: 'json', rows };
+    }
+    const csvPath = input.source.path;
+    if (!csvPath) {
+        throw new errors_1.PostgresToolError('INVALID_INPUT', 'source.path is required when kind is "csv".', {
+            path: 'source.path',
+        });
+    }
+    const { content } = await (0, workspace_file_1.readWorkspaceCsvText)(context, csvPath, maxCsvBytes);
+    const rows = parseCsvRows(content, csvPath);
+    if (rows.length === 0) {
+        throw new errors_1.PostgresToolError('INVALID_INPUT', `CSV at ${csvPath} has a header but no data rows.`, { path: 'source.path' });
+    }
+    if (rows.length > maxRows) {
+        throw new errors_1.PostgresToolError('COMPLEXITY_EXCEEDED', `CSV at ${csvPath} has ${rows.length} rows, exceeding the ${maxRows} row limit.`, { path: 'source.path' });
+    }
+    return { sourceKind: 'csv', rows };
+}
+function boundRejectionDetails(rejected, maxDetails = constants_1.DEFAULT_MAX_INSERT_REJECTION_DETAILS) {
+    const limit = clamp(maxDetails, 1, constants_1.MAX_INSERT_REJECTION_DETAILS);
+    return {
+        rejected: rejected.slice(0, limit),
+        rejection_details_truncated: rejected.length > limit,
+    };
+}
+function parseCsvRows(content, path) {
+    let records;
+    try {
+        records = (0, sync_1.parse)(content, {
+            columns: true,
+            skip_empty_lines: true,
+            trim: true,
+            relax_column_count: true,
+        });
+    }
+    catch (error) {
+        throw new errors_1.PostgresToolError('INVALID_INPUT', `File at ${path} is not valid CSV: ${error instanceof Error ? error.message : String(error)}`, { path: 'source.path', cause: error });
+    }
+    if (records.length === 0) {
+        return [];
+    }
+    const headers = Object.keys(records[0] ?? {});
+    if (headers.length === 0) {
+        throw new errors_1.PostgresToolError('INVALID_INPUT', `CSV at ${path} has no header columns.`, {
+            path: 'source.path',
+        });
+    }
+    return records.map((record) => {
+        const row = {};
+        for (const [key, value] of Object.entries(record)) {
+            row[key] = value === '' ? null : value;
+        }
+        return row;
+    });
+}
+function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+//# sourceMappingURL=insert-language.js.map