db-mcp 1.1.1 → 3.0.0

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,WAAW,EACX,YAAY,EACZ,cAAc,GACf,MAAM,wBAAwB,CAAC;AAGhC,YAAY,EAEV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,UAAU,EACV,SAAS,EACT,cAAc,EAGd,aAAa,EACb,eAAe,EAGf,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EAGd,SAAS,EACT,cAAc,EACd,gBAAgB,EAGhB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,UAAU,EACV,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE,OAAO,EACL,WAAW,EACX,WAAW,EACX,eAAe,EACf,eAAe,EACf,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,5 +1,4 @@
-export { DEFAULT_CONFIG, DbMcpServer, createServer } from './chunk-RHVEZ42P.js';
-export { DatabaseAdapter } from './chunk-Z2GFQU3G.js';
-export { NAME, VERSION } from './chunk-FW7UCRLN.js';
-export { AuthenticationError, AuthorizationError, ConnectionError, QueryError, ValidationError } from './chunk-4IA3DB5C.js';
-export { ALL_TOOL_GROUPS, DbMcpError, META_GROUPS, TOOL_GROUPS, filterTools, getFilterSummary, getToolFilterFromEnv, isToolEnabled, parseToolFilter } from './chunk-AOUL5SHS.js';
+export { DEFAULT_CONFIG, DbMcpServer, createServer } from './chunk-THATOQRT.js';
+export { DatabaseAdapter } from './chunk-W5WQVNVX.js';
+export { NAME, VERSION } from './chunk-E5IESRTK.js';
+export { ALL_TOOL_GROUPS, AuthenticationError, AuthorizationError, ConnectionError, DbMcpError, META_GROUPS, QueryError, TOOL_GROUPS, ValidationError, filterTools, getFilterSummary, getToolFilterFromEnv, isToolEnabled, parseToolFilter } from './chunk-L552U3QS.js';

package/dist/server/mcp-server.d.ts

@@ -0,0 +1,66 @@
+/**
+ * db-mcp - Main MCP Server
+ *
+ * SQLite MCP server with OAuth 2.1 authentication,
+ * HTTP/SSE transport, and dynamic tool filtering.
+ */
+import type { McpServerConfig, DatabaseConfig } from "../types/index.js";
+import type { DatabaseAdapter } from "../adapters/database-adapter.js";
+/**
+ * Main db-mcp server class
+ *
+ * Manages database adapters, tool registration, and MCP protocol handling.
+ */
+export declare class DbMcpServer {
+    private server;
+    private adapters;
+    private toolFilter;
+    private config;
+    private auditLogger;
+    private backupManager;
+    private auditInterceptor;
+    private auditInitPromise;
+    constructor(config: McpServerConfig);
+    /**
+     * Register a database adapter
+     */
+    registerAdapter(adapter: DatabaseAdapter, config: DatabaseConfig): Promise<void>;
+    /**
+     * Get an adapter by ID
+     */
+    getAdapter(adapterId: string): DatabaseAdapter | undefined;
+    /**
+     * Get all registered adapters
+     */
+    getAdapters(): Map<string, DatabaseAdapter>;
+    /**
+     * Start the server with the configured transport
+     */
+    start(): Promise<void>;
+    /**
+     * Start server with stdio transport
+     */
+    private startStdio;
+    /**
+     * Start server with HTTP transport (Streamable HTTP with SSE support)
+     */
+    private startHttp;
+    /**
+     * Gracefully shut down the server
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Initialize the audit subsystem: logger, interceptor, backup manager,
+     * sqlite://audit resource, and audit backup tools.
+     */
+    private initializeAudit;
+}
+/**
+ * Create and configure a db-mcp server instance
+ */
+export declare function createServer(config: McpServerConfig): DbMcpServer;
+/**
+ * Default server configuration
+ */
+export declare const DEFAULT_CONFIG: Partial<McpServerConfig>;
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/server/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/server/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EAEf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAyEvE;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,gBAAgB,CAA8B;gBAE1C,MAAM,EAAE,eAAe;IAkFnC;;OAEG;IACG,eAAe,CACnB,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC;IAqDhB;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI1D;;OAEG;IACH,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC;IAI3C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B;;OAEG;YACW,UAAU;IAiBxB;;OAEG;YACW,SAAS;IAsDvB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAiC/B;;;OAGG;YACW,eAAe;CAmC9B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,WAAW,CAEjE;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,OAAO,CAAC,eAAe,CAKnD,CAAC"}

package/dist/server/registration/audit-tools.d.ts

@@ -0,0 +1,13 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { DatabaseAdapter } from "../../adapters/database-adapter.js";
+import type { BackupManager } from "../../audit/backup-manager.js";
+import type { AuditLogger } from "../../audit/logger.js";
+/**
+ * Register the sqlite://audit resource for agent access to audit log.
+ */
+export declare function registerAuditResource(server: McpServer, auditLogger: AuditLogger | null, backupManager: BackupManager | null): void;
+/**
+ * Register audit backup tools for snapshot management.
+ */
+export declare function registerAuditBackupTools(server: McpServer, backupManager: BackupManager | null, adaptersMap: Map<string, DatabaseAdapter>): void;
+//# sourceMappingURL=audit-tools.d.ts.map

package/dist/server/registration/audit-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-tools.d.ts","sourceRoot":"","sources":["../../../src/server/registration/audit-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAsDzD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,WAAW,GAAG,IAAI,EAC/B,aAAa,EAAE,aAAa,GAAG,IAAI,GAClC,IAAI,CAsCN;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,aAAa,EAAE,aAAa,GAAG,IAAI,EACnC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,GACxC,IAAI,CAunBN"}

package/dist/server/registration/built-in-tools.d.ts

@@ -0,0 +1,8 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { DatabaseAdapter } from "../../adapters/database-adapter.js";
+import type { McpServerConfig, ToolFilterConfig } from "../../types/index.js";
+/**
+ * Register built-in server tools (health, info, etc.)
+ */
+export declare function registerBuiltInTools(server: McpServer, adaptersMap: Map<string, DatabaseAdapter>, config: McpServerConfig, toolFilter: ToolFilterConfig): void;
+//# sourceMappingURL=built-in-tools.d.ts.map

package/dist/server/registration/built-in-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in-tools.d.ts","sourceRoot":"","sources":["../../../src/server/registration/built-in-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAU9E;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,EACzC,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,gBAAgB,GAC3B,IAAI,CAyIN"}

package/dist/server/registration/help-resources.d.ts

@@ -0,0 +1,7 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ToolFilterConfig } from "../../types/index.js";
+/**
+ * Register sqlite://help resources for on-demand reference documentation.
+ */
+export declare function registerHelpResources(server: McpServer, toolFilter: ToolFilterConfig): void;
+//# sourceMappingURL=help-resources.d.ts.map

package/dist/server/registration/help-resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-resources.d.ts","sourceRoot":"","sources":["../../../src/server/registration/help-resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAa,MAAM,sBAAsB,CAAC;AAKxE;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,gBAAgB,GAC3B,IAAI,CAiFN"}

package/dist/server/registration/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./built-in-tools.js";
+export * from "./help-resources.js";
+export * from "./audit-tools.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/registration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/registration/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC"}

package/dist/{sqlite-26V3Y4MK.js → sqlite-6C3AJI4I.js}

@@ -1,9 +1,8 @@
-import { getCoreTools, getJsonHelperTools, getJsonOperationTools, getTextTools, getStatsTools, getVirtualTools, getVectorTools, getGeoTools, getAdminTools, getIntrospectionTools, getMigrationTools, getCodeModeTools, isDDL, getResourceDefinitions, getPromptDefinitions, applyCommonPragmas, autoEnableWal, detectAndSetJsonbSupport, SchemaManager, normalizeSqliteParams } from './chunk-TVIZ3XJH.js';
-export { getCoreTools } from './chunk-TVIZ3XJH.js';
-import { DatabaseAdapter } from './chunk-Z2GFQU3G.js';
-import { getToolGroupIcon, VERSION } from './chunk-FW7UCRLN.js';
-import { ConnectionError, ConfigurationError, QueryError } from './chunk-4IA3DB5C.js';
-import { createModuleLogger, ERROR_CODES, DbMcpError } from './chunk-AOUL5SHS.js';
+import { getCoreTools, getJsonHelperTools, getJsonOperationTools, getTextTools, getStatsTools, getVirtualTools, getVectorTools, getGeoTools, getAdminTools, getIntrospectionTools, getMigrationTools, getCodeModeTools, executeRead, executeWrite, isDDL, executeGeneral, getResourceDefinitions, getPromptDefinitions, applyCommonPragmas, autoEnableWal, detectAndSetJsonbSupport, SchemaManager } from './chunk-FR65YPAH.js';
+export { getCoreTools } from './chunk-FR65YPAH.js';
+import { DatabaseAdapter } from './chunk-W5WQVNVX.js';
+import { getToolGroupIcon, VERSION } from './chunk-E5IESRTK.js';
+import { createModuleLogger, ConnectionError, ConfigurationError, ERROR_CODES, DbMcpError } from './chunk-L552U3QS.js';
 import initSqlJs from 'sql.js';
 
 // src/adapters/sqlite/tools/index.ts
@@ -35,129 +34,11 @@ function getAllToolDefinitions(adapter) {
 function getToolsByGroup(adapter, group) {
   return getAllToolDefinitions(adapter).filter((tool) => tool.group === group);
 }
-
-// src/adapters/sqlite/query-executor.ts
 var log = createModuleLogger("SQLITE");
-function rowsFromSqlJsResult(result) {
-  const numColumns = result.columns.length;
-  const numRows = result.values.length;
-  const rows = new Array(numRows);
-  const cols = result.columns;
-  for (let i = 0; i < numRows; i++) {
-    const rowObj = {};
-    const rowValues = result.values[i];
-    if (rowValues) {
-      for (let j = 0; j < numColumns; j++) {
-        rowObj[cols[j]] = rowValues[j];
-      }
-    }
-    rows[i] = rowObj;
-  }
-  return rows;
-}
-function executeRead(db, sql, params) {
-  const start = Date.now();
-  try {
-    const normalizedParams = normalizeSqliteParams(params);
-    const results = normalizedParams ? db.exec(sql, normalizedParams) : db.exec(sql);
-    if (results.length === 0) {
-      return Promise.resolve({
-        rows: [],
-        executionTimeMs: Date.now() - start
-      });
-    }
-    const firstResult = results[0];
-    if (!firstResult) {
-      return Promise.resolve({
-        rows: [],
-        executionTimeMs: Date.now() - start
-      });
-    }
-    const columns = firstResult.columns.map((name) => ({
-      name,
-      type: "unknown"
-    }));
-    const rows = rowsFromSqlJsResult(firstResult);
-    return Promise.resolve({
-      rows,
-      columns,
-      executionTimeMs: Date.now() - start
-    });
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    log.error(`Query failed: ${message}`, {
-      code: ERROR_CODES.DB.QUERY_FAILED.full
-    });
-    throw new QueryError(
-      `Query execution failed: ${message}`,
-      "DB_QUERY_FAILED",
-      {
-        sql,
-        cause: error instanceof Error ? error : void 0
-      }
-    );
-  }
+var _sqlJsPromise = null;
+function getSqlJs() {
+  return _sqlJsPromise ??= initSqlJs();
 }
-function executeWrite(db, sql, params) {
-  const start = Date.now();
-  try {
-    const normalizedParams = normalizeSqliteParams(params);
-    if (normalizedParams) {
-      db.run(sql, normalizedParams);
-    } else {
-      db.run(sql);
-    }
-    const changes = db.getRowsModified();
-    return Promise.resolve({
-      rowsAffected: changes,
-      executionTimeMs: Date.now() - start
-    });
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    log.error(`Write query failed: ${message}`, {
-      code: ERROR_CODES.DB.QUERY_FAILED.full
-    });
-    throw new QueryError(`Write query failed: ${message}`, "DB_WRITE_FAILED", {
-      sql,
-      cause: error instanceof Error ? error : void 0
-    });
-  }
-}
-function executeGeneral(db, sql, params) {
-  const start = Date.now();
-  try {
-    const normalizedParams = normalizeSqliteParams(params);
-    const results = normalizedParams ? db.exec(sql, normalizedParams) : db.exec(sql);
-    if (results.length === 0) {
-      return Promise.resolve({
-        rowsAffected: db.getRowsModified(),
-        executionTimeMs: Date.now() - start
-      });
-    }
-    const firstResult = results[0];
-    if (!firstResult) {
-      return Promise.resolve({
-        rowsAffected: db.getRowsModified(),
-        executionTimeMs: Date.now() - start
-      });
-    }
-    const rows = rowsFromSqlJsResult(firstResult);
-    return Promise.resolve({
-      rows,
-      executionTimeMs: Date.now() - start
-    });
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    log.error(`Query failed: ${message}`, {
-      code: ERROR_CODES.DB.QUERY_FAILED.full
-    });
-    throw new QueryError(`Query failed: ${message}`, "DB_QUERY_FAILED", {
-      sql,
-      cause: error instanceof Error ? error : void 0
-    });
-  }
-}
-var log2 = createModuleLogger("SQLITE");
 async function connectSqliteDatabase(adapter, config) {
   if (config.type !== "sqlite") {
     throw new ConfigurationError(
@@ -167,12 +48,12 @@ async function connectSqliteDatabase(adapter, config) {
   }
   const sqliteConfig = config;
   try {
-    const sqlJsInstance = await initSqlJs();
+    const sqlJsInstance = await getSqlJs();
     const filePath = sqliteConfig.filePath ?? sqliteConfig.connectionString ?? ":memory:";
     let db;
     if (filePath === ":memory:") {
       db = new sqlJsInstance.Database();
-      log2.info("Connected to in-memory SQLite database", {
+      log.info("Connected to in-memory SQLite database", {
         code: "SQLITE_CONNECT"
       });
     } else {
@@ -181,18 +62,18 @@ async function connectSqliteDatabase(adapter, config) {
         if (fs.existsSync(filePath)) {
           const buffer = await fs.promises.readFile(filePath);
           db = new sqlJsInstance.Database(buffer);
-          log2.info(`Connected to SQLite database: ${filePath}`, {
+          log.info(`Connected to SQLite database: ${filePath}`, {
             code: "SQLITE_CONNECT"
           });
         } else {
           db = new sqlJsInstance.Database();
-          log2.info(`Created new SQLite database: ${filePath}`, {
+          log.info(`Created new SQLite database: ${filePath}`, {
             code: "SQLITE_CONNECT"
           });
         }
       } catch {
         db = new sqlJsInstance.Database();
-        log2.warning("File access unavailable, using in-memory database", {
+        log.warning("File access unavailable, using in-memory database", {
           code: "SQLITE_FALLBACK"
         });
       }
@@ -207,17 +88,28 @@ async function connectSqliteDatabase(adapter, config) {
       { runPragma: (pragma) => db.run(`PRAGMA ${pragma}`) },
       filePath,
       sqliteConfig.options,
-      log2
+      log
     );
     detectAndSetJsonbSupport(() => {
       const versionResult = db.exec("SELECT sqlite_version()");
       return versionResult[0]?.values[0]?.[0] ?? "0.0.0";
-    }, log2);
+    }, log);
+    if (sqliteConfig.initializationSql && Array.isArray(sqliteConfig.initializationSql)) {
+      for (const sql of sqliteConfig.initializationSql) {
+        db.run(sql);
+      }
+      log.info(
+        `Executed ${sqliteConfig.initializationSql.length} initialization SQL statements`,
+        {
+          code: "SQLITE_INIT_SQL"
+        }
+      );
+    }
     const schemaManager = new SchemaManager(adapter);
     return { db, sqlJsInstance, schemaManager };
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    log2.error(`Failed to connect to SQLite: ${message}`, {
+    log.error(`Failed to connect to SQLite: ${message}`, {
       code: ERROR_CODES.DB.CONNECT_FAILED.full
     });
     throw new ConnectionError(
@@ -235,17 +127,17 @@ async function disconnectSqliteDatabase(db, config) {
       const fs = await import('fs');
       const data = db.export();
       await fs.promises.writeFile(config.filePath, Buffer.from(data));
-      log2.info(`Saved database to: ${config.filePath}`, {
+      log.info(`Saved database to: ${config.filePath}`, {
         code: "SQLITE_DISCONNECT"
       });
     } catch {
-      log2.warning("Could not save database to file", {
+      log.warning("Could not save database to file", {
         code: "SQLITE_SAVE_FAILED"
       });
     }
   }
   db.close();
-  log2.info("Disconnected from SQLite database", {
+  log.info("Disconnected from SQLite database", {
     code: "SQLITE_DISCONNECT"
   });
 }
@@ -293,9 +185,31 @@ async function fallBackDescribeTable(adapter, tableName) {
     `SELECT COUNT(*) as count FROM "${tableName}"`
   );
   const rowCount = countResult.rows?.[0]?.["count"] ?? 0;
+  let strict = false;
+  try {
+    const listResult = await adapter.executeReadQuery(
+      `PRAGMA table_list("${tableName}")`
+    );
+    if (listResult.rows && listResult.rows.length > 0) {
+      strict = listResult.rows[0]?.["strict"] === 1;
+    }
+  } catch {
+    try {
+      const ddlResult = await adapter.executeReadQuery(
+        "SELECT sql FROM sqlite_master WHERE type = 'table' AND name = ?",
+        [tableName]
+      );
+      const ddl = ddlResult.rows?.[0]?.["sql"] ?? "";
+      if (/\)\s*STRICT/i.test(ddl)) {
+        strict = true;
+      }
+    } catch {
+    }
+  }
   return {
     name: tableName,
     type: "table",
+    strict,
     columns,
     rowCount
   };
@@ -355,6 +269,7 @@ var SqliteAdapter = class extends DatabaseAdapter {
   db = null;
   config = null;
   schemaManager = null;
+  cachedToolDefinitions = null;
   /**
    * Connect to a SQLite database
    */
@@ -392,7 +307,7 @@ var SqliteAdapter = class extends DatabaseAdapter {
         latencyMs,
         version,
         details: {
-          filePath: this.config?.filePath ?? this.config?.connectionString ?? ":memory:",
+          filePath: this.config?.filePath ?? this.config?.connectionString ? "<redacted>" : ":memory:",
           walMode: this.config?.options?.walMode ?? false
         }
       });
@@ -414,14 +329,17 @@ var SqliteAdapter = class extends DatabaseAdapter {
   /**
    * Execute a write query
    */
-  async executeWriteQuery(sql, params, skipValidation = false) {
+  async executeWriteQuery(sql, params) {
     this.ensureConnected();
-    if (!skipValidation) {
-      this.validateQuery(sql, false);
-    }
+    this.validateQuery(sql, false);
     const result = await executeWrite(this.ensureDb(), sql, params);
     if (isDDL(sql)) {
-      this.clearSchemaCache();
+      const match = /(?:table|view|index)\s+([a-zA-Z0-9_]+)/i.exec(sql);
+      if (match?.[1] && this.schemaManager) {
+        this.schemaManager.clearTableCache(match[1]);
+      } else {
+        this.clearSchemaCache();
+      }
     }
     return result;
   }
@@ -430,12 +348,27 @@ var SqliteAdapter = class extends DatabaseAdapter {
    */
   async executeQuery(sql, params) {
     this.ensureConnected();
+    this.validateQuery(sql, false);
     const result = await executeGeneral(this.ensureDb(), sql, params);
     if (isDDL(sql)) {
-      this.clearSchemaCache();
+      const match = /(?:table|view|index)\s+([a-zA-Z0-9_]+)/i.exec(sql);
+      if (match?.[1] && this.schemaManager) {
+        this.schemaManager.clearTableCache(match[1]);
+      } else {
+        this.clearSchemaCache();
+      }
     }
     return result;
   }
+  /**
+   * Execute a SQL script containing multiple statements
+   */
+  executeScript(sql) {
+    this.ensureConnected();
+    this.ensureDb().run(sql);
+    this.clearSchemaCache();
+    return Promise.resolve();
+  }
   /**
    * Get full database schema (cached via SchemaManager)
    */
@@ -539,7 +472,42 @@ var SqliteAdapter = class extends DatabaseAdapter {
    * Get all tool definitions
    */
   getToolDefinitions() {
-    return getAllToolDefinitions(this);
+    this.cachedToolDefinitions ??= getAllToolDefinitions(this);
+    return this.cachedToolDefinitions;
+  }
+  /**
+   * Get tools filtered by adapter capabilities
+   * Used by Code Mode to accurately reflect available runtime features
+   */
+  getAvailableToolDefinitions() {
+    const allTools = this.getToolDefinitions();
+    const capabilities = this.getCapabilities();
+    return allTools.filter((tool) => {
+      if (!capabilities.transactions && tool.group === "transactions") {
+        return false;
+      }
+      if (!capabilities.vector && tool.group === "vector") {
+        return false;
+      }
+      if (!capabilities.geospatial) {
+        const spatialiteTools = [
+          "sqlite_geo_load_spatialite",
+          "sqlite_geo_spatial_table",
+          "sqlite_geo_spatial_query",
+          "sqlite_geo_spatial_analysis",
+          "sqlite_geo_spatial_index",
+          "sqlite_geo_transform",
+          "sqlite_geo_import"
+        ];
+        if (spatialiteTools.includes(tool.name)) {
+          return false;
+        }
+      }
+      if (!capabilities.fullTextSearch && tool.name.startsWith("sqlite_fts_")) {
+        return false;
+      }
+      return true;
+    });
   }
   /**
    * Get resource definitions
@@ -589,7 +557,7 @@ var SqliteAdapter = class extends DatabaseAdapter {
    * Execute raw SQL and return results (for tools)
    */
   rawQuery(sql, params) {
-    return this.executeQuery(sql, params);
+    return executeGeneral(this.ensureDb(), sql, params);
   }
 };
 function createSqliteAdapter() {