@lumifai/harness-tool-pack-postgres 0.0.1 → 0.1.0

package/dist/postgres-write.js

@@ -0,0 +1,391 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_POSTGRES_PARAMETERS = exports.DEFAULT_POSTGRES_WRITE_MAX_ROWS = void 0;
+exports.resolvePostgresWriteSkillPath = resolvePostgresWriteSkillPath;
+exports.createPostgresWriteTools = createPostgresWriteTools;
+exports.validatePostgresWriteOptions = validatePostgresWriteOptions;
+exports.assertWorkspaceRelativePath = assertWorkspaceRelativePath;
+exports.valuePlaceholder = valuePlaceholder;
+exports.insertRows = insertRows;
+exports.updateRow = updateRow;
+const tools_1 = require("@mastra/core/tools");
+const path_1 = __importDefault(require("path"));
+const zod_1 = require("zod");
+const pg_client_1 = require("./pg-client");
+exports.DEFAULT_POSTGRES_WRITE_MAX_ROWS = 500;
+exports.MAX_POSTGRES_PARAMETERS = 65_535;
+/** A safe SQL identifier — used to validate schema/table/column names we must inline (pg cannot parameterize identifiers). */
+const IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const workspaceFilePathSchema = zod_1.z
+    .string()
+    .min(1)
+    .describe('Workspace-relative path to a JSON file, e.g. campaigns/123/brief.json');
+const identifierSchema = (label) => zod_1.z
+    .string()
+    .min(1)
+    .regex(IDENTIFIER, `${label} must be a valid SQL identifier ([A-Za-z_][A-Za-z0-9_]*)`);
+const tableTargetSchema = zod_1.z.object({
+    schema: identifierSchema('schema').default('public'),
+    table: identifierSchema('table'),
+});
+const whereValueSchema = zod_1.z.union([zod_1.z.string().min(1), zod_1.z.number(), zod_1.z.boolean()]);
+function resolvePostgresWriteSkillPath() {
+    const packageRoot = path_1.default.dirname(require.resolve('@lumifai/harness-tool-pack-postgres/package.json'));
+    return path_1.default.join(packageRoot, 'skills', 'postgres-write');
+}
+function createPostgresWriteTools(options) {
+    const maxRows = options.maxRows ?? exports.DEFAULT_POSTGRES_WRITE_MAX_ROWS;
+    const postgresInsertFromFile = (0, tools_1.createTool)({
+        id: 'postgres_insert_from_file',
+        description: 'Deterministically read a JSON file from the workspace and insert its rows into a PostgreSQL table. ' +
+            'The file must contain a JSON object or an array of objects with identical keys per row. ' +
+            'Object/array values are stored as JSON (suitable for json/jsonb columns). ' +
+            'Use conflictColumns + onConflict for idempotent saves (ignore or upsert). ' +
+            'Does NOT run arbitrary SQL.',
+        inputSchema: zod_1.z.object({
+            path: workspaceFilePathSchema,
+            ...tableTargetSchema.shape,
+            conflictColumns: zod_1.z
+                .array(identifierSchema('conflictColumns'))
+                .optional()
+                .describe('Columns forming a unique/PK constraint. Required when onConflict is set.'),
+            onConflict: zod_1.z
+                .enum(['ignore', 'update'])
+                .optional()
+                .describe('When conflictColumns are set: ignore = DO NOTHING; update = DO UPDATE SET non-key columns from EXCLUDED.'),
+        }),
+        execute: async (inputData, context) => {
+            const target = tableTargetKey(inputData.schema, inputData.table);
+            assertAllowedTable(options, inputData.schema, inputData.table);
+            const rows = await readJsonRows(context, inputData.path);
+            assertNonEmptyInsertRows(rows, inputData.path);
+            assertMaxRows(rows.length, maxRows);
+            const columns = unionColumns(rows);
+            if (columns.length === 0) {
+                throw new Error('No columns found: each row must be a non-empty JSON object.');
+            }
+            assertUniformRowKeys(rows, inputData.path);
+            assertAllowedColumns(options, target, columns);
+            assertConflictColumns(columns, inputData.conflictColumns);
+            const onConflict = resolveOnConflictMode(inputData.onConflict, inputData.conflictColumns);
+            return (0, pg_client_1.withPostgresClient)(options, context, async (client) => {
+                return (0, pg_client_1.withPostgresTransaction)(client, options, async () => {
+                    const affected = await insertRows(client, inputData.schema, inputData.table, columns, rows, inputData.conflictColumns, onConflict, jsonColumnSet(options, target));
+                    return {
+                        table: target,
+                        columns,
+                        rowCount: rows.length,
+                        affected,
+                        onConflict,
+                        skipped: onConflict === 'ignore' && inputData.conflictColumns?.length
+                            ? rows.length - affected
+                            : 0,
+                    };
+                });
+            });
+        },
+    });
+    const postgresUpdateFromFile = (0, tools_1.createTool)({
+        id: 'postgres_update_from_file',
+        description: 'Deterministically read column values from a workspace JSON file and update one PostgreSQL row. ' +
+            'The file must be a flat JSON object whose keys are column names and values are the new data. ' +
+            'Lookup is provided via whereColumn + whereValue tool args, or resolveWhereValue at boot. ' +
+            'Does NOT run arbitrary SQL.',
+        inputSchema: zod_1.z.object({
+            path: workspaceFilePathSchema.describe('Workspace-relative path to a JSON file containing only the column values to update.'),
+            ...tableTargetSchema.shape,
+            whereColumn: identifierSchema('whereColumn')
+                .default('id')
+                .describe('Column used to find the row (e.g. id, campaign_id). Defaults to id.'),
+            whereValue: whereValueSchema
+                .optional()
+                .describe('Value to match in whereColumn. Omit when resolveWhereValue is configured at boot.'),
+        }),
+        execute: async (inputData, context) => {
+            const target = tableTargetKey(inputData.schema, inputData.table);
+            assertAllowedTable(options, inputData.schema, inputData.table);
+            const whereValue = await resolveUpdateWhereValue(options, context, inputData.whereValue);
+            const set = await readUpdateColumnsFromFile(context, inputData.path, inputData.whereColumn);
+            const columns = Object.keys(set);
+            assertAllowedColumns(options, target, columns);
+            return (0, pg_client_1.withPostgresClient)(options, context, async (client) => {
+                return (0, pg_client_1.withPostgresTransaction)(client, options, async () => {
+                    const rowCount = await updateRow(client, inputData.schema, inputData.table, inputData.whereColumn, whereValue, columns, set, jsonColumnSet(options, target));
+                    assertExactlyOneRowUpdated(rowCount, inputData.whereColumn, whereValue);
+                    return {
+                        table: target,
+                        whereColumn: inputData.whereColumn,
+                        whereValue,
+                        columns,
+                        updated: true,
+                        rowCount,
+                    };
+                });
+            });
+        },
+    });
+    return {
+        postgres_insert_from_file: postgresInsertFromFile,
+        postgres_update_from_file: postgresUpdateFromFile,
+    };
+}
+function validatePostgresWriteOptions(options) {
+    if (!options.allowedTables?.length) {
+        throw new Error('Postgres file-write tools require allowedTables with at least one schema.table entry.');
+    }
+    const allowedTableSet = new Set(options.allowedTables);
+    for (const key of Object.keys(options.allowedColumns ?? {})) {
+        if (!allowedTableSet.has(key)) {
+            throw new Error(`allowedColumns key "${key}" is not listed in allowedTables.`);
+        }
+    }
+    for (const key of Object.keys(options.jsonColumns ?? {})) {
+        if (!allowedTableSet.has(key)) {
+            throw new Error(`jsonColumns key "${key}" is not listed in allowedTables.`);
+        }
+    }
+    for (const target of options.allowedTables) {
+        const columns = options.allowedColumns?.[target];
+        if (!columns?.length) {
+            throw new Error(`allowedColumns must list at least one writable column for ${target}.`);
+        }
+        for (const column of columns) {
+            assertIdentifier(column, `allowedColumns column for ${target}`);
+        }
+    }
+}
+function tableTargetKey(schema, table) {
+    return `${schema}.${table}`;
+}
+function jsonColumnSet(options, target) {
+    return new Set(options.jsonColumns?.[target] ?? []);
+}
+function assertAllowedTable(options, schema, table) {
+    if (!options.allowedTables.length) {
+        throw new Error('Postgres write tools require allowedTables to be configured with at least one schema.table target.');
+    }
+    const target = tableTargetKey(schema, table);
+    if (!options.allowedTables.includes(target)) {
+        throw new Error(`Writing to ${target} is not allowed. Allowed targets: ${options.allowedTables.join(', ')}`);
+    }
+}
+function assertAllowedColumns(options, target, columns) {
+    const allowed = options.allowedColumns?.[target];
+    if (!allowed?.length) {
+        throw new Error(`No writable columns are configured for ${target}.`);
+    }
+    const allowedSet = new Set(allowed);
+    for (const column of columns) {
+        if (!allowedSet.has(column)) {
+            throw new Error(`Column "${column}" is not allowed on ${target}. Allowed columns: ${allowed.join(', ')}`);
+        }
+    }
+}
+function assertConflictColumns(columns, conflictColumns) {
+    if (!conflictColumns?.length) {
+        return;
+    }
+    const columnSet = new Set(columns);
+    for (const column of conflictColumns) {
+        if (!columnSet.has(column)) {
+            throw new Error(`conflictColumns includes "${column}" which is not present in the inserted data columns: ${columns.join(', ')}`);
+        }
+    }
+}
+function resolveOnConflictMode(onConflict, conflictColumns) {
+    if (!onConflict) {
+        return conflictColumns?.length ? 'ignore' : undefined;
+    }
+    if (!conflictColumns?.length) {
+        throw new Error('onConflict requires conflictColumns to be set.');
+    }
+    return onConflict;
+}
+function assertMaxRows(rowCount, maxRows) {
+    if (rowCount > maxRows) {
+        throw new Error(`Insert file contains ${rowCount} rows which exceeds the configured maxRows limit of ${maxRows}.`);
+    }
+}
+function assertNonEmptyInsertRows(rows, path) {
+    if (rows.length === 0) {
+        throw new Error(`Insert file at ${path} must contain at least one JSON object.`);
+    }
+}
+function assertUniformRowKeys(rows, path) {
+    const expectedKeys = Object.keys(rows[0] ?? {})
+        .sort()
+        .join(',');
+    for (let index = 1; index < rows.length; index++) {
+        const keys = Object.keys(rows[index] ?? {})
+            .sort()
+            .join(',');
+        if (keys !== expectedKeys) {
+            throw new Error(`Insert file at ${path}: row ${index} has columns [${keys}] but row 0 has [${expectedKeys}]. All rows must share the same keys.`);
+        }
+    }
+}
+function assertExactlyOneRowUpdated(rowCount, whereColumn, whereValue) {
+    if (rowCount === 0) {
+        throw new Error(`No row found where ${whereColumn} = ${JSON.stringify(whereValue)}.`);
+    }
+    if (rowCount > 1) {
+        throw new Error(`Expected exactly one row to update where ${whereColumn} = ${JSON.stringify(whereValue)}, but matched ${rowCount}.`);
+    }
+}
+async function resolveUpdateWhereValue(options, context, whereValue) {
+    if (whereValue !== undefined) {
+        return whereValue;
+    }
+    if (options.resolveWhereValue) {
+        const resolved = await options.resolveWhereValue(context);
+        if (resolved !== undefined) {
+            return resolved;
+        }
+    }
+    throw new Error('postgres_update_from_file requires whereValue in tool args or resolveWhereValue at pack boot.');
+}
+async function readJsonRows(context, path) {
+    const parsed = await readWorkspaceJson(context, path);
+    if (Array.isArray(parsed) && parsed.length === 0) {
+        throw new Error(`Insert file at ${path} must contain at least one JSON object.`);
+    }
+    const rows = Array.isArray(parsed) ? parsed : [parsed];
+    return rows.map((row, index) => {
+        if (!row || typeof row !== 'object' || Array.isArray(row)) {
+            throw new Error(`Row ${index} at ${path} is not a JSON object.`);
+        }
+        return row;
+    });
+}
+async function readUpdateColumnsFromFile(context, path, whereColumn) {
+    const parsed = await readWorkspaceJson(context, path);
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error(`Update file at ${path} must be a JSON object of column values.`);
+    }
+    const set = parsed;
+    const columns = Object.keys(set);
+    if (columns.length === 0) {
+        throw new Error(`Update file at ${path} must contain at least one column to update.`);
+    }
+    for (const column of columns) {
+        assertIdentifier(column, 'column');
+        if (column === whereColumn) {
+            throw new Error(`Update file at ${path}: cannot update lookup column "${whereColumn}". ` +
+                'Pass whereColumn/whereValue as tool args instead.');
+        }
+    }
+    return set;
+}
+async function readWorkspaceJson(context, path) {
+    const workspace = context.workspace;
+    if (!workspace?.filesystem?.readFile) {
+        throw new Error(`Postgres write tools require a workspace filesystem to read ${path}`);
+    }
+    assertWorkspaceRelativePath(path);
+    const fileContent = await workspace.filesystem.readFile(path, { encoding: 'utf8' });
+    const content = typeof fileContent === 'string' ? fileContent : fileContent.toString('utf8');
+    try {
+        return JSON.parse(content);
+    }
+    catch (error) {
+        throw new Error(`Failed to parse JSON at ${path}`, { cause: error });
+    }
+}
+function assertWorkspaceRelativePath(filePath) {
+    const normalized = filePath.replaceAll('\\', '/');
+    const segments = normalized.split('/');
+    if (normalized.startsWith('/') ||
+        /^[A-Za-z]:\//.test(normalized) ||
+        normalized.startsWith('//') ||
+        normalized.includes('\0') ||
+        segments.includes('..')) {
+        throw new Error(`Workspace path must remain within the workspace: ${filePath}`);
+    }
+}
+function assertIdentifier(value, label) {
+    if (!IDENTIFIER.test(value)) {
+        throw new Error(`${label} "${value}" is not a valid SQL identifier.`);
+    }
+}
+function unionColumns(rows) {
+    const columns = new Set();
+    for (const row of rows) {
+        for (const key of Object.keys(row)) {
+            assertIdentifier(key, 'column');
+            columns.add(key);
+        }
+    }
+    return [...columns];
+}
+function valuePlaceholder(column, placeholderIndex, jsonColumns) {
+    const placeholder = `$${placeholderIndex}`;
+    return jsonColumns.has(column) ? `${placeholder}::jsonb` : placeholder;
+}
+async function insertRows(client, schema, table, columns, rows, conflictColumns, onConflict, jsonColumns) {
+    const quotedTable = `"${schema}"."${table}"`;
+    const quotedColumns = columns.map((column) => `"${column}"`).join(', ');
+    if (columns.length === 0)
+        return 0;
+    if (columns.length > exports.MAX_POSTGRES_PARAMETERS) {
+        throw new Error(`Insert has ${columns.length} columns, exceeding PostgreSQL's ${exports.MAX_POSTGRES_PARAMETERS} parameter limit per row.`);
+    }
+    const rowsPerBatch = Math.floor(exports.MAX_POSTGRES_PARAMETERS / columns.length);
+    let affected = 0;
+    for (let start = 0; start < rows.length; start += rowsPerBatch) {
+        const batch = rows.slice(start, start + rowsPerBatch);
+        const values = [];
+        const tuples = [];
+        let placeholder = 1;
+        for (const row of batch) {
+            const rowPlaceholders = columns.map((column) => {
+                values.push(toDbValue(row[column]));
+                return valuePlaceholder(column, placeholder++, jsonColumns);
+            });
+            tuples.push(`(${rowPlaceholders.join(', ')})`);
+        }
+        let sql = `INSERT INTO ${quotedTable} (${quotedColumns}) VALUES ${tuples.join(', ')}`;
+        if (conflictColumns?.length && onConflict) {
+            const conflictTarget = conflictColumns.map((column) => `"${column}"`).join(', ');
+            if (onConflict === 'ignore') {
+                sql += ` ON CONFLICT (${conflictTarget}) DO NOTHING`;
+            }
+            else {
+                const conflictSet = new Set(conflictColumns);
+                const updateColumns = columns.filter((column) => !conflictSet.has(column));
+                if (updateColumns.length === 0) {
+                    throw new Error('onConflict "update" requires at least one non-conflict column in the insert data.');
+                }
+                const setClause = updateColumns
+                    .map((column) => `"${column}" = EXCLUDED."${column}"`)
+                    .join(', ');
+                sql += ` ON CONFLICT (${conflictTarget}) DO UPDATE SET ${setClause}`;
+            }
+        }
+        const result = await client.query(sql, values);
+        affected += result.rowCount ?? 0;
+    }
+    return affected;
+}
+async function updateRow(client, schema, table, whereColumn, whereValue, columns, set, jsonColumns) {
+    const quotedTable = `"${schema}"."${table}"`;
+    const setClause = columns
+        .map((column, index) => `"${column}" = ${valuePlaceholder(column, index + 1, jsonColumns)}`)
+        .join(', ');
+    const wherePlaceholder = columns.length + 1;
+    const sql = `UPDATE ${quotedTable} SET ${setClause} WHERE "${whereColumn}" = $${wherePlaceholder}`;
+    const values = [...columns.map((column) => toDbValue(set[column])), toDbValue(whereValue)];
+    const result = await client.query(sql, values);
+    return result.rowCount ?? 0;
+}
+/** Primitives pass through; objects/arrays are JSON-encoded for json/jsonb columns. */
+function toDbValue(value) {
+    if (value === null || value === undefined)
+        return null;
+    if (typeof value === 'object')
+        return JSON.stringify(value);
+    return value;
+}
+//# sourceMappingURL=postgres-write.js.map

package/dist/postgres-write.js.map

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

package/dist/postgres.d.ts

@@ -1,17 +1,17 @@
 import type { ToolsInput } from '@mastra/core/agent';
 import { type ToolExecutionContext } from '@mastra/core/tools';
+import { type PostgresCatalog } from './catalog';
 import { type InsertAuditCallback } from './insert-executor';
 import { insertInputSchema, insertResultSchema } from './insert-language';
 import { previewInputSchema, queryPlanSchema, schemaDetailsInputSchema } from './query-language';
+import { type PostgresClientOptions } from './pg-client';
 import { type AuditCallback } from './query-executor';
 export { DEFAULT_POSTGRES_QUERY_LIMIT, MAX_POSTGRES_QUERY_LIMIT, DEFAULT_MAX_INSERT_ROWS, MAX_INSERT_ROWS, } from './constants';
 export type { QueryPlan, QueryResult } from './query-language';
 export type { InsertInput, InsertResult } from './insert-language';
 export { queryPlanSchema, previewInputSchema, schemaDetailsInputSchema, insertInputSchema, insertResultSchema, };
 type MaybePromise<T> = T | Promise<T>;
-export interface PostgresToolsOptions {
-    connectionString?: string;
-    resolveConnectionString?: (context: ToolExecutionContext) => MaybePromise<string>;
+export interface PostgresToolsOptions extends PostgresClientOptions {
     defaultQueryLimit?: number;
     maxQueryLimit?: number;
     defaultPreviewLimit?: number;
@@ -19,9 +19,6 @@ export interface PostgresToolsOptions {
     maxInsertRows?: number;
     maxInsertCsvBytes?: number;
     maxInsertRejectionDetails?: number;
-    statementTimeoutMs?: number;
-    lockTimeoutMs?: number;
-    idleInTransactionTimeoutMs?: number;
     tempFileLimitKb?: number;
     searchPath?: string[];
     maxResultBytes?: number;
@@ -33,7 +30,33 @@ export interface PostgresToolsOptions {
     catalogCacheTtlMs?: number;
     audit?: AuditCallback;
     insertAudit?: InsertAuditCallback;
+    /**
+     * Optional `schema.table` allowlist for postgres_query / postgres_preview_data /
+     * postgres_insert. When set, the loaded catalog is intersected with this list so
+     * deployments can restrict access beyond DB role grants. Independent of
+     * `allowedTables` (file-write tools).
+     */
+    allowedPhysicalTables?: string[];
+    /** Fully-qualified `schema.table` targets for the file-based write tools. */
+    allowedTables?: string[];
+    /** Per-table column allowlist required by the file-based write tools. */
+    allowedColumns?: Record<string, string[]>;
+    /** Per-table JSON/JSONB columns for the file-based write tools. */
+    jsonColumns?: Record<string, string[]>;
+    /** Maximum rows read from one file by the file-based write tools. */
+    maxRows?: number;
+    /** Resolve update lookup values when the tool omits `whereValue`. */
+    resolveWhereValue?: (context: ToolExecutionContext) => MaybePromise<string | number | boolean | undefined>;
 }
 export declare function resolvePostgresSkillPath(): string;
 export declare function createPostgresTools(options: PostgresToolsOptions): ToolsInput;
 export declare function createPostgresToolPack(options: PostgresToolsOptions): import("@lumifai/harness-tool-packs").ToolPack;
+/**
+ * Intersect the catalog with the optional physical-table allowlist.
+ * When `primary` is provided, reject that target with POLICY_DENIED if it is
+ * outside the allowlist (clearer than UNKNOWN_RELATION after filtering).
+ */
+export declare function applyPhysicalTableAllowlist(catalog: PostgresCatalog, allowlist: Set<string> | undefined, primary?: {
+    schema: string;
+    relation: string;
+}): PostgresCatalog;