fix: update return values to reflect number of rows inserted in agent_run non table mode function and related tests/documentation

Author: Gioee

API.md

@@ -58,8 +58,8 @@ SELECT agent_run(goal, table_name, max_iterations, system_prompt);
 | `system_prompt` | TEXT | No | NULL | Custom system prompt |
 
 **Returns:**
-- **MODE 1 (text):** TEXT – Agent's final response
-- **MODE 2 (table):** TEXT – Status message (e.g., "Inserted 5 rows into listings")
+- **MODE 1 (text):** TEXT – Agent's final response  
+- **MODE 2 (table):** INTEGER – Number of rows inserted into the table
 
 **MODE 1: Text Response**
 

README.md

@@ -132,7 +132,7 @@ SELECT agent_run(
   'listings',
   8
 );
--- Returns: "Inserted 5 rows into listings"
+-- Returns: 5 (number of rows inserted)
 
 -- Semantic search (works immediately!)
 SELECT title, location, price, v.distance

USAGE.md

@@ -195,7 +195,7 @@ SELECT agent_run(
   'listings',
   8
 );
--- Returns: "Inserted 5 rows into listings"
+-- Returns: 5 (number of rows inserted)
 
 -- 5. Semantic search (works immediately!)
 SELECT title, location, price, v.distance

src/sqlite-agent.c

@@ -1021,10 +1021,7 @@ static void agent_run_func(
   }
 
   free(tools_list);
-
-  char result[256];
-  snprintf(result, sizeof(result), "Inserted %d rows into %s", rows_inserted, table_name);
-  sqlite3_result_text(context, result, -1, SQLITE_TRANSIENT);
+  sqlite3_result_int(context, rows_inserted);
 }
 
 #ifdef _WIN32

test/airbnb.c

@@ -196,8 +196,8 @@ void* worker_thread(void* arg) {
         return NULL;
     }
 
-    const char *result = (const char *)sqlite3_column_text(stmt, 0);
-    printf("\n  * %s\n", result ? result : "Agent completed");
+    int rows_inserted = sqlite3_column_int(stmt, 0);
+    printf("\n  * Inserted %d rows into listings\n", rows_inserted);
     sqlite3_finalize(stmt);
 
     // Get listing count

test/github.c

@@ -217,8 +217,8 @@ int main(void) {
         return 1;
     }
 
-    const char *result = (const char *)sqlite3_column_text(stmt, 0);
-    printf("  * %s\n", result ? result : "Agent completed");
+    int rows_inserted = sqlite3_column_int(stmt, 0);
+    printf("  * Inserted %d rows into team_activity\n", rows_inserted);
     sqlite3_finalize(stmt);
 
     // Get activity count