feat(agents): add onSqlError hook for customizable SQL error logging

Allow users to override onSqlError(query, error) to customize logging
behavior for SQL errors instead of using console.error directly.

Fixes #767

Author: whoiskatrin

packages/agents/src/index.ts

@@ -391,7 +391,7 @@ export class Agent<
       // Execute the SQL query with the provided values
       return [...this.ctx.storage.sql.exec(query, ...values)] as T[];
     } catch (e) {
-      console.error(`failed to execute sql query: ${query}`, e);
+      this.onSqlError(query, e);
       throw this.onError(e);
     }
   }
@@ -871,6 +871,15 @@ export class Agent<
     throw theError;
   }
 
+  /**
+   * Handle SQL execution errors. Override this method to customize logging behavior.
+   * @param query The SQL query that failed
+   * @param error The error that occurred
+   */
+  onSqlError(query: string, error: unknown): void {
+    console.error(`failed to execute sql query: ${query}`, error);
+  }
+
   /**
    * Render content (not implemented in base class)
    */