sql-ai-harness 0.0.0-stage → 0.1.0

package/dist/core/tools/index.js

@@ -0,0 +1,8 @@
+export { listTables } from './list-tables.js';
+export { describeTable } from './describe-table.js';
+export { describeTables } from './describe-tables.js';
+export { getRelationships } from './get-relationships.js';
+export { executeQuery } from './execute-query.js';
+export { explainQuery } from './explain-query.js';
+export { getTool, getTools, executeTool } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/core/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/core/tools/list-tables.d.ts

@@ -0,0 +1,3 @@
+import type { SqlToolResult, ToolContext } from '../types/index.js';
+export declare function listTables(context: ToolContext): Promise<SqlToolResult>;
+//# sourceMappingURL=list-tables.d.ts.map

package/dist/core/tools/list-tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-tables.d.ts","sourceRoot":"","sources":["../../../src/core/tools/list-tables.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEpE,wBAAsB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAgB7E"}

package/dist/core/tools/list-tables.js

@@ -0,0 +1,18 @@
+export async function listTables(context) {
+    try {
+        const tables = context.schemaCache
+            ? await context.schemaCache.listTables(context.database)
+            : await context.database.listTables();
+        return {
+            success: true,
+            data: tables,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Failed to list database tables.',
+        };
+    }
+}
+//# sourceMappingURL=list-tables.js.map

package/dist/core/tools/list-tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-tables.js","sourceRoot":"","sources":["../../../src/core/tools/list-tables.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAoB;IACnD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW;YAChC,CAAC,CAAC,MAAM,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC;YACxD,CAAC,CAAC,MAAM,OAAO,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QAExC,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,MAAM;SACb,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,iCAAiC;SAClF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/core/tools/registry.d.ts

@@ -0,0 +1,11 @@
+import type { SqlToolResult, ToolContext } from '../types/index.js';
+export type ToolName = 'list_tables' | 'describe_table' | 'describe_tables' | 'get_relationships' | 'execute_query' | 'explain_query';
+export interface RegisteredTool {
+    name: ToolName;
+    description: string;
+    execute: (input: unknown, context: ToolContext) => Promise<SqlToolResult>;
+}
+export declare function getTool(name: ToolName): RegisteredTool;
+export declare function getTools(): RegisteredTool[];
+export declare function executeTool(name: ToolName, input: unknown, context: ToolContext): Promise<SqlToolResult>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/tools/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAQpE,MAAM,MAAM,QAAQ,GAChB,aAAa,GACb,gBAAgB,GAChB,iBAAiB,GACjB,mBAAmB,GACnB,eAAe,GACf,eAAe,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;CAC3E;AAmCD,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAEtD;AAED,wBAAgB,QAAQ,IAAI,cAAc,EAAE,CAE3C;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAExB"}

package/dist/core/tools/registry.js

@@ -0,0 +1,48 @@
+import { describeTable } from './describe-table.js';
+import { describeTables } from './describe-tables.js';
+import { executeQuery } from './execute-query.js';
+import { explainQuery } from './explain-query.js';
+import { getRelationships } from './get-relationships.js';
+import { listTables } from './list-tables.js';
+const tools = {
+    list_tables: {
+        name: 'list_tables',
+        description: 'List the tables available in the connected database.',
+        execute: (_input, context) => listTables(context),
+    },
+    describe_table: {
+        name: 'describe_table',
+        description: 'Inspect the columns and basic schema information for a database table.',
+        execute: (input, context) => describeTable(input, context),
+    },
+    describe_tables: {
+        name: 'describe_tables',
+        description: 'Inspect columns and basic schema information for multiple database tables at once. Use this when several tables are relevant.',
+        execute: (input, context) => describeTables(input, context),
+    },
+    get_relationships: {
+        name: 'get_relationships',
+        description: 'List foreign-key relationships in the connected database, optionally for one table.',
+        execute: (input, context) => getRelationships((input ?? {}), context),
+    },
+    execute_query: {
+        name: 'execute_query',
+        description: 'Execute a validated read-only SQL query against the connected database.',
+        execute: (input, context) => executeQuery(input, context),
+    },
+    explain_query: {
+        name: 'explain_query',
+        description: 'Return the database execution plan for a validated SELECT or WITH query.',
+        execute: (input, context) => explainQuery(input, context),
+    },
+};
+export function getTool(name) {
+    return tools[name];
+}
+export function getTools() {
+    return Object.values(tools);
+}
+export async function executeTool(name, input, context) {
+    return getTool(name).execute(input, context);
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/core/tools/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAA2B,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAA4B,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,YAAY,EAA0B,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAA0B,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAA8B,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAgB9C,MAAM,KAAK,GAAqC;IAC9C,WAAW,EAAE;QACX,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,sDAAsD;QACnE,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;KAClD;IACD,cAAc,EAAE;QACd,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,wEAAwE;QACrF,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,KAA2B,EAAE,OAAO,CAAC;KACjF;IACD,eAAe,EAAE;QACf,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,+HAA+H;QAC5I,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,KAA4B,EAAE,OAAO,CAAC;KACnF;IACD,iBAAiB,EAAE;QACjB,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,qFAAqF;QAClG,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,KAAK,IAAI,EAAE,CAA0B,EAAE,OAAO,CAAC;KAC/F;IACD,aAAa,EAAE;QACb,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,yEAAyE;QACtF,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,KAA0B,EAAE,OAAO,CAAC;KAC/E;IACD,aAAa,EAAE;QACb,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,0EAA0E;QACvF,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,KAA0B,EAAE,OAAO,CAAC;KAC/E;CACF,CAAC;AAEF,MAAM,UAAU,OAAO,CAAC,IAAc;IACpC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAc,EACd,KAAc,EACd,OAAoB;IAEpB,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC"}

package/dist/core/types/index.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Shared domain types. These types deliberately do not depend on a provider,
+ * database driver, CLI framework, or HTTP framework.
+ */
+export type SqlDialect = 'mysql' | 'postgres' | 'sqlite';
+export interface ModelRequest {
+    system?: string;
+    prompt: string;
+    tools?: unknown;
+    temperature?: number;
+    maxSteps?: number;
+}
+export interface ModelResponse {
+    text: string;
+    raw?: unknown;
+    steps?: number;
+    toolCalls?: number;
+}
+export interface ModelProvider {
+    readonly name: string;
+    generate(request: ModelRequest): Promise<ModelResponse>;
+}
+export interface TableInfo {
+    name: string;
+    schema?: string;
+}
+export interface ColumnInfo {
+    name: string;
+    dataType: string;
+    nullable: boolean;
+    defaultValue?: unknown;
+    isPrimaryKey: boolean;
+    isAutoIncrement: boolean;
+}
+export interface TableSchema {
+    table: TableInfo;
+    columns: ColumnInfo[];
+}
+export interface RelationshipInfo {
+    table: string;
+    column: string;
+    referencedTable: string;
+    referencedColumn: string;
+    constraintName?: string;
+}
+export interface QueryResult {
+    rows: Record<string, unknown>[];
+    rowCount: number;
+    executionTimeMs: number;
+}
+export interface QueryPlan {
+    sql: string;
+    plan: unknown;
+}
+export interface DatabaseAdapter {
+    readonly dialect: SqlDialect;
+    listTables(): Promise<TableInfo[]>;
+    describeTable(table: string): Promise<TableSchema>;
+    getRelationships(table?: string): Promise<RelationshipInfo[]>;
+    executeQuery(sql: string, options?: QueryExecutionOptions): Promise<QueryResult>;
+    explainQuery(sql: string): Promise<QueryPlan>;
+    close?(): Promise<void>;
+}
+export interface QueryExecutionOptions {
+    maxRows?: number;
+    timeoutMs?: number;
+    maxResultBytes?: number;
+}
+export interface SqlSafetyPolicy {
+    readOnly: boolean;
+    maxRows: number;
+    queryTimeoutMs: number;
+    maxResultBytes: number;
+}
+export interface ToolContext {
+    database: DatabaseAdapter;
+    safety: SqlSafetyPolicy;
+    schemaCache?: import('../../schema/cache.js').SchemaCache;
+}
+export interface DatabaseContext {
+    content?: string;
+    source?: string;
+}
+export interface SqlToolResult {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+    /**
+       * True when the database adapter was actually called.
+       * False when SQL was rejected before database execution.
+       */
+    executionAttempted?: boolean;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/core/types/index.d.ts.map

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

package/dist/core/types/index.js

@@ -0,0 +1,6 @@
+/**
+ * Shared domain types. These types deliberately do not depend on a provider,
+ * database driver, CLI framework, or HTTP framework.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/core/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/database/adapter.d.ts

@@ -0,0 +1,3 @@
+import type { DatabaseAdapter } from '../core/types/index.js';
+export type { DatabaseAdapter };
+//# sourceMappingURL=adapter.d.ts.map

package/dist/database/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/database/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,YAAY,EAAE,eAAe,EAAE,CAAC"}

package/dist/database/adapter.js

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

package/dist/database/adapter.js.map

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

package/dist/database/index.d.ts

@@ -0,0 +1,4 @@
+export type { DatabaseAdapter } from './adapter.js';
+export { MySqlAdapter } from './mysql/adapter.js';
+export type { MySqlAdapterConfig } from './mysql/adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/database/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/database/index.js

@@ -0,0 +1,2 @@
+export { MySqlAdapter } from './mysql/adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/database/mysql/adapter.d.ts

@@ -0,0 +1,21 @@
+import type { DatabaseAdapter, QueryExecutionOptions, QueryPlan, QueryResult, RelationshipInfo, TableInfo, TableSchema } from '../../core/types/index.js';
+export interface MySqlAdapterConfig {
+    host: string;
+    port: number;
+    database: string;
+    user: string;
+    password: string;
+    connectionLimit?: number;
+}
+export declare class MySqlAdapter implements DatabaseAdapter {
+    readonly dialect: 'mysql';
+    private readonly pool;
+    constructor(config: MySqlAdapterConfig);
+    listTables(): Promise<TableInfo[]>;
+    describeTable(table: string): Promise<TableSchema>;
+    getRelationships(table?: string): Promise<RelationshipInfo[]>;
+    executeQuery(sql: string, options?: QueryExecutionOptions): Promise<QueryResult>;
+    explainQuery(sql: string): Promise<QueryPlan>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/database/mysql/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/database/mysql/adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,eAAe,EACf,qBAAqB,EACrB,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,WAAW,EACZ,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,YAAa,YAAW,eAAe;IAClD,QAAQ,CAAC,OAAO,EAAG,OAAO,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAO;IAE5B,YAAY,MAAM,EAAE,kBAAkB,EAcrC;IAEK,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAYvC;IAEK,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAmCvD;IAEK,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAmClE;IAEK,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,WAAW,CAAC,CA4CzF;IAEK,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAUlD;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;CACF"}

package/dist/database/mysql/adapter.js

@@ -0,0 +1,140 @@
+import mysql from 'mysql2/promise';
+export class MySqlAdapter {
+    dialect = 'mysql';
+    pool;
+    constructor(config) {
+        const options = {
+            host: config.host,
+            port: config.port,
+            database: config.database,
+            user: config.user,
+            password: config.password,
+            connectionLimit: config.connectionLimit ?? 5,
+            waitForConnections: true,
+            enableKeepAlive: true,
+            dateStrings: true,
+        };
+        this.pool = mysql.createPool(options);
+    }
+    async listTables() {
+        const [rows] = await this.pool.query(`
+      SELECT TABLE_NAME AS table_name
+      FROM information_schema.TABLES
+      WHERE TABLE_SCHEMA = DATABASE()
+        AND TABLE_TYPE = 'BASE TABLE'
+      ORDER BY TABLE_NAME ASC
+      `);
+        return rows.map((row) => ({ name: String(row.table_name) }));
+    }
+    async describeTable(table) {
+        const [rows] = await this.pool.execute(`
+      SELECT
+        COLUMN_NAME AS column_name,
+        DATA_TYPE AS data_type,
+        IS_NULLABLE AS is_nullable,
+        COLUMN_DEFAULT AS column_default,
+        COLUMN_KEY AS column_key,
+        EXTRA AS extra
+      FROM information_schema.COLUMNS
+      WHERE TABLE_SCHEMA = DATABASE()
+        AND TABLE_NAME = ?
+      ORDER BY ORDINAL_POSITION ASC
+      `, [table]);
+        if (rows.length === 0) {
+            throw new Error(`Table "${table}" was not found in the current database.`);
+        }
+        const columns = rows.map((row) => ({
+            name: String(row.column_name),
+            dataType: String(row.data_type),
+            nullable: row.is_nullable === 'YES',
+            defaultValue: row.column_default,
+            isPrimaryKey: row.column_key === 'PRI',
+            isAutoIncrement: String(row.extra ?? '').toLowerCase().includes('auto_increment'),
+        }));
+        return {
+            table: { name: table },
+            columns,
+        };
+    }
+    async getRelationships(table) {
+        const conditions = [
+            'TABLE_SCHEMA = DATABASE()',
+            'REFERENCED_TABLE_SCHEMA = DATABASE()',
+        ];
+        const params = [];
+        if (table) {
+            conditions.push('TABLE_NAME = ?');
+            params.push(table);
+        }
+        const [rows] = await this.pool.execute(`
+      SELECT
+        TABLE_NAME AS table_name,
+        COLUMN_NAME AS column_name,
+        REFERENCED_TABLE_NAME AS referenced_table,
+        REFERENCED_COLUMN_NAME AS referenced_column,
+        CONSTRAINT_NAME AS constraint_name
+      FROM information_schema.KEY_COLUMN_USAGE
+      WHERE ${conditions.join(' AND ')}
+        AND REFERENCED_TABLE_NAME IS NOT NULL
+      ORDER BY TABLE_NAME ASC, COLUMN_NAME ASC
+      `, params);
+        return rows.map((row) => ({
+            table: String(row.table_name),
+            column: String(row.column_name),
+            referencedTable: String(row.referenced_table),
+            referencedColumn: String(row.referenced_column),
+            constraintName: String(row.constraint_name),
+        }));
+    }
+    async executeQuery(sql, options = {}) {
+        const maxRows = options.maxRows ?? 500;
+        const timeoutMs = options.timeoutMs ?? 10_000;
+        const maxResultBytes = options.maxResultBytes ?? 1_048_576;
+        const startedAt = performance.now();
+        // mysql2 supports a client-side timeout for text queries.
+        const [rawRows] = await this.pool.query({
+            sql,
+            timeout: timeoutMs,
+        });
+        const rows = Array.isArray(rawRows)
+            ? rawRows.slice(0, maxRows).map((row) => ({ ...row }))
+            : [];
+        const serialized = JSON.stringify(rows);
+        if (Buffer.byteLength(serialized, 'utf8') > maxResultBytes) {
+            const limitedRows = [];
+            let size = 2;
+            for (const row of rows) {
+                const rowJson = JSON.stringify(row);
+                const rowSize = Buffer.byteLength(rowJson, 'utf8') + (limitedRows.length > 0 ? 1 : 0);
+                if (size + rowSize > maxResultBytes)
+                    break;
+                limitedRows.push(row);
+                size += rowSize;
+            }
+            return {
+                rows: limitedRows,
+                rowCount: limitedRows.length,
+                executionTimeMs: Math.round(performance.now() - startedAt),
+            };
+        }
+        return {
+            rows,
+            rowCount: rows.length,
+            executionTimeMs: Math.round(performance.now() - startedAt),
+        };
+    }
+    async explainQuery(sql) {
+        const [rows] = await this.pool.query({
+            sql: `EXPLAIN ${sql}`,
+            timeout: 10_000,
+        });
+        return {
+            sql,
+            plan: rows,
+        };
+    }
+    async close() {
+        await this.pool.end();
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/database/mysql/adapter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Public SDK entry point for SQL AI Harness.
+ *
+ * Keep this file as the supported import surface. Consumers should not need to
+ * import implementation files from internal src/ paths.
+ */
+export { Agent } from './core/agent/index.js';
+export type { AgentOptions, AgentResult, ResponseMode, } from './core/agent/agent.js';
+export type { AgentObserver, AgentToolEvent, } from './core/agent/observability.js';
+export type { AiProvider } from './ai/provider.js';
+export { SdkAiProvider } from './ai/sdk-provider.js';
+export { createAiProvider } from './ai/factory.js';
+export { loadConfig } from './config/config.js';
+export type { AppConfig, AiProviderName } from './config/config.js';
+export { MySqlAdapter } from './database/index.js';
+export type { MySqlAdapterConfig, DatabaseAdapter } from './database/index.js';
+export type { ColumnInfo, DatabaseContext, ModelProvider, ModelRequest, ModelResponse, QueryExecutionOptions, QueryPlan, QueryResult, RelationshipInfo, SqlDialect, SqlSafetyPolicy, SqlToolResult, TableInfo, TableSchema, ToolContext, } from './core/types/index.js';
+export { SchemaCache } from './schema/cache.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,YAAY,EACV,YAAY,EACZ,WAAW,EACX,YAAY,GACb,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,aAAa,EACb,cAAc,GACf,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE/E,YAAY,EACV,UAAU,EACV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,aAAa,EACb,SAAS,EACT,WAAW,EACX,WAAW,GACZ,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/**
+ * Public SDK entry point for SQL AI Harness.
+ *
+ * Keep this file as the supported import surface. Consumers should not need to
+ * import implementation files from internal src/ paths.
+ */
+export { Agent } from './core/agent/index.js';
+export { SdkAiProvider } from './ai/sdk-provider.js';
+export { createAiProvider } from './ai/factory.js';
+export { loadConfig } from './config/config.js';
+export { MySqlAdapter } from './database/index.js';
+export { SchemaCache } from './schema/cache.js';
+//# 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;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAY9C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAqBnD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/safety/limits.d.ts

@@ -0,0 +1,7 @@
+import type { SqlSafetyPolicy } from '../core/types/index.js';
+/**
+ * Adds a conservative LIMIT to simple SELECT/WITH queries that do not already
+ * have one. Actual row limits should still be enforced by the database adapter.
+ */
+export declare function applyRowLimit(sql: string, policy: SqlSafetyPolicy): string;
+//# sourceMappingURL=limits.d.ts.map

package/dist/safety/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../src/safety/limits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,CAY1E"}

package/dist/safety/limits.js

@@ -0,0 +1,15 @@
+/**
+ * Adds a conservative LIMIT to simple SELECT/WITH queries that do not already
+ * have one. Actual row limits should still be enforced by the database adapter.
+ */
+export function applyRowLimit(sql, policy) {
+    const normalized = sql.trim().replace(/;\s*$/, '');
+    if (/\bLIMIT\s+\d+/i.test(normalized)) {
+        return normalized;
+    }
+    if (/^(SELECT|WITH)\b/i.test(normalized)) {
+        return `${normalized} LIMIT ${policy.maxRows}`;
+    }
+    return normalized;
+}
+//# sourceMappingURL=limits.js.map

package/dist/safety/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../src/safety/limits.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,MAAuB;IAChE,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAEnD,IAAI,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACtC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,IAAI,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACzC,OAAO,GAAG,UAAU,UAAU,MAAM,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/safety/policy.d.ts

@@ -0,0 +1,8 @@
+import type { SqlSafetyPolicy } from '../core/types/index.js';
+import { type SqlValidationResult } from './sql-validator.js';
+export declare function validateQuery(sql: string, policy: SqlSafetyPolicy): SqlValidationResult;
+export declare function getQueryExecutionOptions(policy: SqlSafetyPolicy): {
+    maxRows: number;
+    timeoutMs: number;
+};
+//# sourceMappingURL=policy.d.ts.map

package/dist/safety/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/safety/policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAe,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE3E,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,mBAAmB,CAEvF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,eAAe;IAE5D,OAAO;IACP,SAAS;EAEZ"}

package/dist/safety/policy.js

@@ -0,0 +1,11 @@
+import { validateSql } from './sql-validator.js';
+export function validateQuery(sql, policy) {
+    return validateSql(sql, policy);
+}
+export function getQueryExecutionOptions(policy) {
+    return {
+        maxRows: policy.maxRows,
+        timeoutMs: policy.queryTimeoutMs,
+    };
+}
+//# sourceMappingURL=policy.js.map

package/dist/safety/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/safety/policy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAA4B,MAAM,oBAAoB,CAAC;AAE3E,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,MAAuB;IAChE,OAAO,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAuB;IAC9D,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,cAAc;KACjC,CAAC;AACJ,CAAC"}

package/dist/safety/sql-validator.d.ts

@@ -0,0 +1,15 @@
+import type { SqlSafetyPolicy } from '../core/types/index.js';
+export interface SqlValidationResult {
+    valid: boolean;
+    sql?: string;
+    reason?: string;
+}
+/**
+ * First-stage SQL safety boundary.
+ *
+ * This intentionally rejects anything that is not clearly read-oriented.
+ * It is not intended to be a complete SQL parser; the database account should
+ * also be configured with read-only privileges.
+ */
+export declare function validateSql(sql: string, policy: SqlSafetyPolicy): SqlValidationResult;
+//# sourceMappingURL=sql-validator.d.ts.map

package/dist/safety/sql-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-validator.d.ts","sourceRoot":"","sources":["../../src/safety/sql-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAM9D,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,mBAAmB,CAyBrF"}

package/dist/safety/sql-validator.js

@@ -0,0 +1,31 @@
+const BLOCKED_KEYWORDS = /\b(INSERT|UPDATE|DELETE|DROP|ALTER|TRUNCATE|CREATE|REPLACE|MERGE|GRANT|REVOKE|CALL|SET|USE|LOAD|HANDLER|LOCK|UNLOCK)\b/i;
+const MULTI_STATEMENT = /;\s*\S/;
+const LEADING_COMMENT = /^(?:\s*(?:--[^\n]*(?:\n|$)|#[^\n]*(?:\n|$)|\/\*[\s\S]*?\*\/))*\s*/;
+/**
+ * First-stage SQL safety boundary.
+ *
+ * This intentionally rejects anything that is not clearly read-oriented.
+ * It is not intended to be a complete SQL parser; the database account should
+ * also be configured with read-only privileges.
+ */
+export function validateSql(sql, policy) {
+    const normalized = sql.trim();
+    if (!normalized) {
+        return { valid: false, reason: 'SQL query is empty.' };
+    }
+    const withoutLeadingComments = normalized.replace(LEADING_COMMENT, '');
+    if (!/^(SELECT|WITH|EXPLAIN|SHOW|DESCRIBE|DESC)\b/i.test(withoutLeadingComments)) {
+        return { valid: false, reason: 'Only read-oriented SQL statements are allowed.' };
+    }
+    if (policy.readOnly && BLOCKED_KEYWORDS.test(withoutLeadingComments)) {
+        return { valid: false, reason: 'The query contains a blocked SQL operation.' };
+    }
+    if (MULTI_STATEMENT.test(normalized)) {
+        return { valid: false, reason: 'Multiple SQL statements are not allowed.' };
+    }
+    return {
+        valid: true,
+        sql: normalized.replace(/;\s*$/, ''),
+    };
+}
+//# sourceMappingURL=sql-validator.js.map

package/dist/safety/sql-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-validator.js","sourceRoot":"","sources":["../../src/safety/sql-validator.ts"],"names":[],"mappings":"AAEA,MAAM,gBAAgB,GAAG,yHAAyH,CAAC;AACnJ,MAAM,eAAe,GAAG,QAAQ,CAAC;AACjC,MAAM,eAAe,GAAG,mEAAmE,CAAC;AAQ5F;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,MAAuB;IAC9D,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAE9B,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;IACzD,CAAC;IAED,MAAM,sBAAsB,GAAG,UAAU,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAEvE,IAAI,CAAC,8CAA8C,CAAC,IAAI,CAAC,sBAAsB,CAAC,EAAE,CAAC;QACjF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,gDAAgD,EAAE,CAAC;IACpF,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,IAAI,gBAAgB,CAAC,IAAI,CAAC,sBAAsB,CAAC,EAAE,CAAC;QACrE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,6CAA6C,EAAE,CAAC;IACjF,CAAC;IAED,IAAI,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,0CAA0C,EAAE,CAAC;IAC9E,CAAC;IAED,OAAO;QACL,KAAK,EAAE,IAAI;QACX,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;KACrC,CAAC;AACJ,CAAC"}

package/dist/schema/cache.d.ts

@@ -0,0 +1,24 @@
+import type { DatabaseAdapter, TableInfo, TableSchema, RelationshipInfo } from '../core/types/index.js';
+export interface SchemaCacheOptions {
+    ttlMs?: number;
+}
+/**
+ * Process-local cache for database metadata. It never caches query results.
+ * A short TTL keeps repeated agent schema discovery from repeatedly hitting
+ * information_schema while allowing schema changes to become visible.
+ */
+export declare class SchemaCache {
+    private readonly ttlMs;
+    private tables?;
+    private relationships?;
+    private readonly tableSchemas;
+    constructor(options?: SchemaCacheOptions);
+    listTables(database: DatabaseAdapter): Promise<TableInfo[]>;
+    describeTable(database: DatabaseAdapter, table: string): Promise<TableSchema>;
+    describeTables(database: DatabaseAdapter, tables: string[]): Promise<TableSchema[]>;
+    getRelationships(database: DatabaseAdapter): Promise<RelationshipInfo[]>;
+    clear(): void;
+    private entry;
+    private get;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/schema/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/schema/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAExG,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAOD;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,MAAM,CAAC,CAA0B;IACzC,OAAO,CAAC,aAAa,CAAC,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA8C;IAE3E,YAAY,OAAO,GAAE,kBAAuB,EAE3C;IAEK,UAAU,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAOhE;IAEK,aAAa,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAQlF;IAEK,cAAc,CAAC,QAAQ,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAExF;IAEK,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAO7E;IAED,KAAK,IAAI,IAAI,CAIZ;IAED,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,GAAG;CAIZ"}