@agentforge/tools 0.16.38 → 0.16.40

package/dist/index.d.cts

@@ -4984,20 +4984,8 @@ interface ReconnectionConfig {
     maxDelayMs: number;
 }
 
-/**
- * Connection manager for relational databases using Drizzle ORM
- * @module connection/connection-manager
- */
-
-/**
- * Connection lifecycle events
- */
 type ConnectionEvent = 'connected' | 'disconnected' | 'error' | 'reconnecting';
 
-/**
- * Connection manager that handles database connections for PostgreSQL, MySQL, and SQLite
- * using Drizzle ORM with lifecycle management and automatic reconnection
- */
 declare class ConnectionManager extends EventEmitter implements DatabaseConnection {
     private vendor;
     private db;
@@ -5009,139 +4997,26 @@ declare class ConnectionManager extends EventEmitter implements DatabaseConnecti
     private reconnectionTimer;
     private connectPromise;
     private connectionGeneration;
-    /**
-     * Create a new ConnectionManager instance
-     * @param config - Connection configuration
-     * @param reconnectionConfig - Optional reconnection configuration
-     */
     constructor(config: ConnectionConfig, reconnectionConfig?: Partial<ReconnectionConfig>);
-    /**
-     * Connect to the database
-     * Initializes the connection and sets up automatic reconnection if configured
-     * @throws {Error} If connection fails or configuration is invalid
-     */
     connect(): Promise<void>;
-    /**
-     * Disconnect from the database
-     * Closes the connection and cancels any pending reconnection attempts
-     *
-     * Note: Event listeners are NOT removed by this method. If you need to dispose
-     * of the ConnectionManager instance entirely, call dispose() instead.
-     */
     disconnect(): Promise<void>;
-    /**
-     * Dispose of the ConnectionManager instance
-     * Disconnects and removes all event listeners
-     * Call this when you're done with the ConnectionManager and won't reuse it
-     */
     dispose(): Promise<void>;
-    /**
-     * Check if the connection is currently connected
-     * @returns true if connected, false otherwise
-     */
     isConnected(): boolean;
-    /**
-     * Get the current connection state
-     * @returns Current connection state
-     */
     getState(): ConnectionState;
-    /**
-     * Get the configured database vendor.
-     */
     getVendor(): DatabaseVendor;
-    /**
-     * Initialize the database connection
-     *
-     * This method is public to maintain compatibility with the DatabaseConnection interface
-     * and existing code (e.g., relational-query.ts). For new code, prefer using connect()
-     * which provides lifecycle management and automatic reconnection.
-     *
-     * @throws {Error} If connection fails or configuration is invalid
-     */
     initialize(): Promise<void>;
-    /**
-     * Set the connection state and log the change
-     * @param newState - New connection state
-     * @private
-     */
     private setState;
-    /**
-     * Schedule a reconnection attempt with exponential backoff
-     * @private
-     */
     private scheduleReconnection;
-    /**
-     * Determine whether an error thrown by drizzle-orm's better-sqlite3 adapter
-     * `.all()` indicates the statement does not return data (i.e. it is DML/DDL,
-     * not a SELECT).
-     *
-     * The adapter may surface this as either a native `SqliteError` or a
-     * `TypeError` depending on the drizzle-orm / better-sqlite3 version, so we
-     * accept both types while still requiring the distinctive message substring
-     * to avoid false positives from unrelated errors.
-     */
-    private isSqliteNonQueryError;
-    /**
-     * Execute a SQL query
-     *
-     * Executes a parameterized SQL query using Drizzle's SQL template objects.
-     * This method provides safe parameter binding to prevent SQL injection.
-     *
-     * @param query - Drizzle SQL template object with parameter binding
-     * @returns Query result
-     *
-     * @example
-     * ```typescript
-     * import { sql } from 'drizzle-orm';
-     *
-     * const result = await manager.execute(
-     *   sql`SELECT * FROM users WHERE id = ${userId}`
-     * );
-     * ```
-     */
+    private createRuntimeAdapter;
     execute(query: SQL): Promise<unknown>;
-    /**
-     * Execute a callback with a single dedicated database connection/session.
-     *
-     * This is required for multi-statement transactions so all statements run on
-     * the same underlying connection.
-     */
     executeInConnection<T>(callback: (execute: (query: SQL) => Promise<unknown>) => Promise<T>): Promise<T>;
-    /**
-     * Get connection pool metrics
-     *
-     * Returns information about the current state of the connection pool.
-     * For SQLite, returns basic connection status since it uses a single connection.
-     *
-     * @returns Pool metrics including total, active, idle, and waiting connections
-     */
     getPoolMetrics(): {
         totalCount: number;
         activeCount: number;
         idleCount: number;
         waitingCount: number;
     };
-    /**
-     * Close the database connection
-     *
-     * This method is public to maintain compatibility with the DatabaseConnection interface
-     * and existing code (e.g., relational-query.ts). For new code, prefer using disconnect()
-     * for connection lifecycle management. Note that disconnect() does NOT clean up event
-     * listeners; call dispose() if you need full cleanup including listener removal.
-     *
-     * Note: This method coordinates with in-flight connect()/initialize() operations
-     * and cancels pending reconnection timers to prevent unexpected reconnections.
-     */
     close(): Promise<void>;
-    /**
-     * Clean up resources when a connection is cancelled during initialization
-     * This prevents connection leaks when disconnect() is called while initialize() is in-flight
-     */
-    private cleanupCancelledConnection;
-    /**
-     * Check if the connection is healthy
-     * @returns true if connection is healthy, false otherwise
-     */
     isHealthy(): Promise<boolean>;
 }
 
@@ -5230,11 +5105,6 @@ interface QueryExecutionContext {
  */
 declare function executeQuery(manager: ConnectionManager, input: QueryInput, context?: QueryExecutionContext): Promise<QueryExecutionResult>;
 
-/**
- * Query builder helpers for relational CRUD operations.
- * @module query/query-builder
- */
-
 /**
  * Supported scalar values for INSERT payloads.
  */
@@ -5277,10 +5147,6 @@ interface BuiltInsertQuery {
     idColumn: string;
     supportsReturning: boolean;
 }
-/**
- * Build a safe parameterized INSERT query from structured input.
- */
-declare function buildInsertQuery(input: InsertQueryInput): BuiltInsertQuery;
 /**
  * Supported scalar values for UPDATE payloads.
  */
@@ -5290,17 +5156,19 @@ type UpdateValue = InsertValue;
  */
 type UpdateData = Record<string, UpdateValue>;
 /**
- * WHERE operator types for UPDATE conditions.
+ * WHERE operator types shared by UPDATE/DELETE/SELECT conditions.
  */
 type UpdateWhereOperator = 'eq' | 'ne' | 'gt' | 'lt' | 'gte' | 'lte' | 'like' | 'in' | 'notIn' | 'isNull' | 'isNotNull';
-/**
- * WHERE condition for UPDATE queries.
- */
-interface UpdateWhereCondition {
+type WhereConditionValue = string | number | boolean | null | Array<string | number>;
+interface BaseWhereCondition {
     column: string;
     operator: UpdateWhereOperator;
-    value?: string | number | boolean | null | Array<string | number>;
+    value?: WhereConditionValue;
 }
+/**
+ * WHERE condition for UPDATE queries.
+ */
+type UpdateWhereCondition = BaseWhereCondition;
 /**
  * Optional optimistic lock condition appended to WHERE.
  */
@@ -5330,11 +5198,7 @@ interface BuiltUpdateQuery {
 /**
  * WHERE condition for DELETE queries.
  */
-interface DeleteWhereCondition {
-    column: string;
-    operator: UpdateWhereOperator;
-    value?: string | number | boolean | null | Array<string | number>;
-}
+type DeleteWhereCondition = BaseWhereCondition;
 /**
  * Soft-delete configuration.
  */
@@ -5361,14 +5225,6 @@ interface BuiltDeleteQuery {
     usesSoftDelete: boolean;
     softDeleteColumn?: string;
 }
-/**
- * Build a safe parameterized UPDATE query from structured input.
- */
-declare function buildUpdateQuery(input: UpdateQueryInput): BuiltUpdateQuery;
-/**
- * Build a safe parameterized DELETE query from structured input.
- */
-declare function buildDeleteQuery(input: DeleteQueryInput): BuiltDeleteQuery;
 /**
  * ORDER BY direction for SELECT queries.
  */
@@ -5383,11 +5239,7 @@ interface SelectOrderBy {
 /**
  * WHERE condition for SELECT queries.
  */
-interface SelectWhereCondition {
-    column: string;
-    operator: UpdateWhereOperator;
-    value?: string | number | boolean | null | Array<string | number>;
-}
+type SelectWhereCondition = BaseWhereCondition;
 /**
  * Builder input for SELECT queries.
  */
@@ -5400,9 +5252,12 @@ interface SelectQueryInput {
     offset?: number;
     vendor: DatabaseVendor;
 }
-/**
- * Build a safe parameterized SELECT query from structured input.
- */
+
+declare function buildInsertQuery(input: InsertQueryInput): BuiltInsertQuery;
+
+declare function buildUpdateQuery(input: UpdateQueryInput): BuiltUpdateQuery;
+declare function buildDeleteQuery(input: DeleteQueryInput): BuiltDeleteQuery;
+
 declare function buildSelectQuery(input: SelectQueryInput): SQL;
 
 /**

package/dist/index.d.ts

@@ -4984,20 +4984,8 @@ interface ReconnectionConfig {
     maxDelayMs: number;
 }
 
-/**
- * Connection manager for relational databases using Drizzle ORM
- * @module connection/connection-manager
- */
-
-/**
- * Connection lifecycle events
- */
 type ConnectionEvent = 'connected' | 'disconnected' | 'error' | 'reconnecting';
 
-/**
- * Connection manager that handles database connections for PostgreSQL, MySQL, and SQLite
- * using Drizzle ORM with lifecycle management and automatic reconnection
- */
 declare class ConnectionManager extends EventEmitter implements DatabaseConnection {
     private vendor;
     private db;
@@ -5009,139 +4997,26 @@ declare class ConnectionManager extends EventEmitter implements DatabaseConnecti
     private reconnectionTimer;
     private connectPromise;
     private connectionGeneration;
-    /**
-     * Create a new ConnectionManager instance
-     * @param config - Connection configuration
-     * @param reconnectionConfig - Optional reconnection configuration
-     */
     constructor(config: ConnectionConfig, reconnectionConfig?: Partial<ReconnectionConfig>);
-    /**
-     * Connect to the database
-     * Initializes the connection and sets up automatic reconnection if configured
-     * @throws {Error} If connection fails or configuration is invalid
-     */
     connect(): Promise<void>;
-    /**
-     * Disconnect from the database
-     * Closes the connection and cancels any pending reconnection attempts
-     *
-     * Note: Event listeners are NOT removed by this method. If you need to dispose
-     * of the ConnectionManager instance entirely, call dispose() instead.
-     */
     disconnect(): Promise<void>;
-    /**
-     * Dispose of the ConnectionManager instance
-     * Disconnects and removes all event listeners
-     * Call this when you're done with the ConnectionManager and won't reuse it
-     */
     dispose(): Promise<void>;
-    /**
-     * Check if the connection is currently connected
-     * @returns true if connected, false otherwise
-     */
     isConnected(): boolean;
-    /**
-     * Get the current connection state
-     * @returns Current connection state
-     */
     getState(): ConnectionState;
-    /**
-     * Get the configured database vendor.
-     */
     getVendor(): DatabaseVendor;
-    /**
-     * Initialize the database connection
-     *
-     * This method is public to maintain compatibility with the DatabaseConnection interface
-     * and existing code (e.g., relational-query.ts). For new code, prefer using connect()
-     * which provides lifecycle management and automatic reconnection.
-     *
-     * @throws {Error} If connection fails or configuration is invalid
-     */
     initialize(): Promise<void>;
-    /**
-     * Set the connection state and log the change
-     * @param newState - New connection state
-     * @private
-     */
     private setState;
-    /**
-     * Schedule a reconnection attempt with exponential backoff
-     * @private
-     */
     private scheduleReconnection;
-    /**
-     * Determine whether an error thrown by drizzle-orm's better-sqlite3 adapter
-     * `.all()` indicates the statement does not return data (i.e. it is DML/DDL,
-     * not a SELECT).
-     *
-     * The adapter may surface this as either a native `SqliteError` or a
-     * `TypeError` depending on the drizzle-orm / better-sqlite3 version, so we
-     * accept both types while still requiring the distinctive message substring
-     * to avoid false positives from unrelated errors.
-     */
-    private isSqliteNonQueryError;
-    /**
-     * Execute a SQL query
-     *
-     * Executes a parameterized SQL query using Drizzle's SQL template objects.
-     * This method provides safe parameter binding to prevent SQL injection.
-     *
-     * @param query - Drizzle SQL template object with parameter binding
-     * @returns Query result
-     *
-     * @example
-     * ```typescript
-     * import { sql } from 'drizzle-orm';
-     *
-     * const result = await manager.execute(
-     *   sql`SELECT * FROM users WHERE id = ${userId}`
-     * );
-     * ```
-     */
+    private createRuntimeAdapter;
     execute(query: SQL): Promise<unknown>;
-    /**
-     * Execute a callback with a single dedicated database connection/session.
-     *
-     * This is required for multi-statement transactions so all statements run on
-     * the same underlying connection.
-     */
     executeInConnection<T>(callback: (execute: (query: SQL) => Promise<unknown>) => Promise<T>): Promise<T>;
-    /**
-     * Get connection pool metrics
-     *
-     * Returns information about the current state of the connection pool.
-     * For SQLite, returns basic connection status since it uses a single connection.
-     *
-     * @returns Pool metrics including total, active, idle, and waiting connections
-     */
     getPoolMetrics(): {
         totalCount: number;
         activeCount: number;
         idleCount: number;
         waitingCount: number;
     };
-    /**
-     * Close the database connection
-     *
-     * This method is public to maintain compatibility with the DatabaseConnection interface
-     * and existing code (e.g., relational-query.ts). For new code, prefer using disconnect()
-     * for connection lifecycle management. Note that disconnect() does NOT clean up event
-     * listeners; call dispose() if you need full cleanup including listener removal.
-     *
-     * Note: This method coordinates with in-flight connect()/initialize() operations
-     * and cancels pending reconnection timers to prevent unexpected reconnections.
-     */
     close(): Promise<void>;
-    /**
-     * Clean up resources when a connection is cancelled during initialization
-     * This prevents connection leaks when disconnect() is called while initialize() is in-flight
-     */
-    private cleanupCancelledConnection;
-    /**
-     * Check if the connection is healthy
-     * @returns true if connection is healthy, false otherwise
-     */
     isHealthy(): Promise<boolean>;
 }
 
@@ -5230,11 +5105,6 @@ interface QueryExecutionContext {
  */
 declare function executeQuery(manager: ConnectionManager, input: QueryInput, context?: QueryExecutionContext): Promise<QueryExecutionResult>;
 
-/**
- * Query builder helpers for relational CRUD operations.
- * @module query/query-builder
- */
-
 /**
  * Supported scalar values for INSERT payloads.
  */
@@ -5277,10 +5147,6 @@ interface BuiltInsertQuery {
     idColumn: string;
     supportsReturning: boolean;
 }
-/**
- * Build a safe parameterized INSERT query from structured input.
- */
-declare function buildInsertQuery(input: InsertQueryInput): BuiltInsertQuery;
 /**
  * Supported scalar values for UPDATE payloads.
  */
@@ -5290,17 +5156,19 @@ type UpdateValue = InsertValue;
  */
 type UpdateData = Record<string, UpdateValue>;
 /**
- * WHERE operator types for UPDATE conditions.
+ * WHERE operator types shared by UPDATE/DELETE/SELECT conditions.
  */
 type UpdateWhereOperator = 'eq' | 'ne' | 'gt' | 'lt' | 'gte' | 'lte' | 'like' | 'in' | 'notIn' | 'isNull' | 'isNotNull';
-/**
- * WHERE condition for UPDATE queries.
- */
-interface UpdateWhereCondition {
+type WhereConditionValue = string | number | boolean | null | Array<string | number>;
+interface BaseWhereCondition {
     column: string;
     operator: UpdateWhereOperator;
-    value?: string | number | boolean | null | Array<string | number>;
+    value?: WhereConditionValue;
 }
+/**
+ * WHERE condition for UPDATE queries.
+ */
+type UpdateWhereCondition = BaseWhereCondition;
 /**
  * Optional optimistic lock condition appended to WHERE.
  */
@@ -5330,11 +5198,7 @@ interface BuiltUpdateQuery {
 /**
  * WHERE condition for DELETE queries.
  */
-interface DeleteWhereCondition {
-    column: string;
-    operator: UpdateWhereOperator;
-    value?: string | number | boolean | null | Array<string | number>;
-}
+type DeleteWhereCondition = BaseWhereCondition;
 /**
  * Soft-delete configuration.
  */
@@ -5361,14 +5225,6 @@ interface BuiltDeleteQuery {
     usesSoftDelete: boolean;
     softDeleteColumn?: string;
 }
-/**
- * Build a safe parameterized UPDATE query from structured input.
- */
-declare function buildUpdateQuery(input: UpdateQueryInput): BuiltUpdateQuery;
-/**
- * Build a safe parameterized DELETE query from structured input.
- */
-declare function buildDeleteQuery(input: DeleteQueryInput): BuiltDeleteQuery;
 /**
  * ORDER BY direction for SELECT queries.
  */
@@ -5383,11 +5239,7 @@ interface SelectOrderBy {
 /**
  * WHERE condition for SELECT queries.
  */
-interface SelectWhereCondition {
-    column: string;
-    operator: UpdateWhereOperator;
-    value?: string | number | boolean | null | Array<string | number>;
-}
+type SelectWhereCondition = BaseWhereCondition;
 /**
  * Builder input for SELECT queries.
  */
@@ -5400,9 +5252,12 @@ interface SelectQueryInput {
     offset?: number;
     vendor: DatabaseVendor;
 }
-/**
- * Build a safe parameterized SELECT query from structured input.
- */
+
+declare function buildInsertQuery(input: InsertQueryInput): BuiltInsertQuery;
+
+declare function buildUpdateQuery(input: UpdateQueryInput): BuiltUpdateQuery;
+declare function buildDeleteQuery(input: DeleteQueryInput): BuiltDeleteQuery;
+
 declare function buildSelectQuery(input: SelectQueryInput): SQL;
 
 /**