@querypanel/node-sdk 1.0.25 → 1.0.27

package/README.md

@@ -90,6 +90,29 @@ Every request is signed with `RS256` using the private key you pass to the const
 - Schema ingestion failures are logged to `console.warn` during auto-sync, but you can call `syncSchema(..., { force: true })` to surface them directly.
 - `ask()` raises immediately for guardrail/moderation errors because `/query` responds with 4xx/5xx.
 
+### Automatic SQL repair and retry
+
+When SQL execution fails (e.g., invalid column name, syntax error), the SDK can automatically retry with a repaired query:
+
+```ts
+const response = await qp.ask("Show revenue by country", {
+  tenantId: "tenant_123",
+  maxRetry: 3,  // Automatically retry up to 3 times on execution error
+});
+
+console.log(`Query succeeded after ${response.attempts} attempt(s)`);
+console.table(response.rows);
+```
+
+The SDK will:
+1. Execute the generated SQL
+2. If execution fails, send the error back to the server with the failed SQL
+3. Get a repaired SQL query from the server
+4. Execute the repaired query
+5. Repeat up to `maxRetry` times
+
+Without `maxRetry`, execution errors throw immediately (default behavior).
+
 ## Need more?
 
 Open an issue or extend `node-sdk/src/index.ts`—every route lives in one file. Pull requests are welcome for additional adapters, richer param coercion, or convenience helpers around charts/annotations.