prova-agent-kit 0.1.1 → 0.1.2

package/README.md

@@ -50,17 +50,19 @@ const agent = new SolanaAgentKit(new ProvaWallet(realWallet, { attester }), RPC_
 ```
 
 ### No bloquea al agente
-Las atestaciones son **fire-and-forget con batching**: un fallo de Prova nunca rompe ni frena una acción del agente. Los items se acumulan y se envían con `batchAttest` (hasta 100/tx) cada `maxSize` items o `flushIntervalMs` ms.
+Las atestaciones son **fire-and-forget con batching por debounce**: un fallo de Prova nunca rompe ni frena una acción del agente. Una ráfaga de tool calls (multi-tool-calling) se agrupa y se envía en **UNA sola tx** (`batchAttest`, hasta 100) apenas la ráfaga se detiene (`flushDelayMs`), o al llegar a `maxSize`.
 
 ```typescript
 attachProva(agent, {
   attester,
   rules: (name) => name !== 'fetchPrice',      // qué acciones atestar (default: todas)
-  batch: { maxSize: 25, flushIntervalMs: 10_000 },
+  batch: { maxSize: 25, flushDelayMs: 1000 },   // agrupa la ráfaga y envía ~1s tras la última acción
   onError: (err, ctx) => logger.warn(ctx.action, err),
 });
 ```
 
+> **Importante:** llama a `handle.stop()` cuando el agente termine su turno para garantizar el flush final de lo pendiente.
+
 ## Modelo de claves
 Prova atesta con **su propio par operador/agente de Devnet**, independiente del wallet de trading del agente. Ventajas: no necesita la private key de trading, funciona con wallets Privy/Turnkey, y el operador Prova es la identidad que avala al agente. Registra el agente una vez con `prova.registerAgent({ operatorKeypair })`.
 

package/dist/batcher.d.ts

@@ -1,10 +1,10 @@
 import type { AttestationItem, BatchOptions, ProvaAttester } from './types';
 export interface Batcher {
-    /** Encola una atestación; dispara flush si se alcanza maxSize. */
+    /** Encola una atestación; programa el flush (o lo dispara si se alcanza maxSize). */
     add(item: AttestationItem): void;
     /** Envía inmediatamente lo pendiente. */
     flush(): Promise<void>;
-    /** Detiene el timer y hace un último flush. */
+    /** Cancela el timer y hace un último flush (llamar al cerrar el agente). */
     stop(): Promise<void>;
 }
 export declare function createBatcher(attester: ProvaAttester, options?: BatchOptions, onError?: (error: unknown) => void): Batcher;

package/dist/batcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"batcher.d.ts","sourceRoot":"","sources":["../src/batcher.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG5E,MAAM,WAAW,OAAO;IACtB,kEAAkE;IAClE,GAAG,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC,yCAAyC;IACzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,+CAA+C;IAC/C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAMD,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE,YAAiB,EAC1B,OAAO,GAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAqD,GACjF,OAAO,CA2CT"}
+{"version":3,"file":"batcher.d.ts","sourceRoot":"","sources":["../src/batcher.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG5E,MAAM,WAAW,OAAO;IACtB,qFAAqF;IACrF,GAAG,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC,yCAAyC;IACzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,4EAA4E;IAC5E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAMD,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE,YAAiB,EAC1B,OAAO,GAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAqD,GACjF,OAAO,CAwDT"}

package/dist/batcher.js

@@ -1,19 +1,28 @@
 "use strict";
-// Buffer de atestaciones: acumula items y los envía en lote (batchAttest) cada
-// N items o cada T ms, lo que ocurra primero. Aísla la latencia/coste de Solana
-// del hot-path del agente.
+// Buffer de atestaciones con flush por DEBOUNCE: agrupa una ráfaga de acciones
+// (multi-tool-calling) y las envía en UNA sola tx (batchAttest, hasta 100) apenas
+// la ráfaga se detiene. Esto arregla el bug de "N tool calls seguidos → 0 guardadas":
+// antes el flush solo ocurría a los 25 items o cada 10s, así que una ráfaga corta
+// que terminaba antes quedaba sin enviar.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createBatcher = createBatcher;
 const runtime_1 = require("./runtime");
 const DEFAULT_MAX_SIZE = 25;
-const DEFAULT_INTERVAL_MS = 10_000;
+const DEFAULT_FLUSH_DELAY_MS = 1000;
 const HARD_BATCH_LIMIT = 100;
 function createBatcher(attester, options = {}, onError = (error) => (0, runtime_1.warn)('[Prova] batch error:', error)) {
     const maxSize = Math.min(Math.max(options.maxSize ?? DEFAULT_MAX_SIZE, 1), HARD_BATCH_LIMIT);
-    const intervalMs = options.flushIntervalMs ?? DEFAULT_INTERVAL_MS;
+    const flushDelayMs = options.flushDelayMs ?? DEFAULT_FLUSH_DELAY_MS;
     let buffer = [];
     let timer;
+    function clearTimer() {
+        if (timer !== undefined) {
+            (0, runtime_1.clearTimeoutSafe)(timer);
+            timer = undefined;
+        }
+    }
     async function flush() {
+        clearTimer();
         if (buffer.length === 0)
             return;
         const batch = buffer;
@@ -30,24 +39,29 @@ function createBatcher(attester, options = {}, onError = (error) => (0, runtime_
             onError(error);
         }
     }
-    function ensureTimer() {
-        if (intervalMs > 0 && timer === undefined) {
-            timer = (0, runtime_1.setIntervalSafe)(() => void flush(), intervalMs);
+    // Debounce: cada acción reinicia el timer, de modo que el flush ocurre
+    // `flushDelayMs` ms DESPUÉS de la última acción de la ráfaga → todo en 1 tx.
+    function scheduleFlush() {
+        clearTimer();
+        if (flushDelayMs <= 0) {
+            void flush();
+            return;
         }
+        timer = (0, runtime_1.setTimeoutSafe)(() => void flush(), flushDelayMs);
     }
     return {
         add(item) {
             buffer.push(item);
-            ensureTimer();
-            if (buffer.length >= maxSize)
-                void flush();
+            if (buffer.length >= maxSize) {
+                void flush(); // llegó al tope → envía ya
+            }
+            else {
+                scheduleFlush(); // si no, agrupa la ráfaga y envía al detenerse
+            }
         },
         flush,
         async stop() {
-            if (timer !== undefined) {
-                (0, runtime_1.clearIntervalSafe)(timer);
-                timer = undefined;
-            }
+            clearTimer();
             await flush();
         },
     };

package/dist/batcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"batcher.js","sourceRoot":"","sources":["../src/batcher.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,gFAAgF;AAChF,2BAA2B;;AAkB3B,sCA+CC;AA9DD,uCAAmF;AAWnF,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,mBAAmB,GAAG,MAAM,CAAC;AACnC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B,SAAgB,aAAa,CAC3B,QAAuB,EACvB,UAAwB,EAAE,EAC1B,UAAoC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,cAAI,EAAC,sBAAsB,EAAE,KAAK,CAAC;IAElF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,gBAAgB,EAAE,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;IAC7F,MAAM,UAAU,GAAG,OAAO,CAAC,eAAe,IAAI,mBAAmB,CAAC;IAElE,IAAI,MAAM,GAAsB,EAAE,CAAC;IACnC,IAAI,KAA0B,CAAC;IAE/B,KAAK,UAAU,KAAK;QAClB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAChC,MAAM,KAAK,GAAG,MAAM,CAAC;QACrB,MAAM,GAAG,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,SAAS,WAAW;QAClB,IAAI,UAAU,GAAG,CAAC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC1C,KAAK,GAAG,IAAA,yBAAe,EAAC,GAAG,EAAE,CAAC,KAAK,KAAK,EAAE,EAAE,UAAU,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,OAAO;QACL,GAAG,CAAC,IAAqB;YACvB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClB,WAAW,EAAE,CAAC;YACd,IAAI,MAAM,CAAC,MAAM,IAAI,OAAO;gBAAE,KAAK,KAAK,EAAE,CAAC;QAC7C,CAAC;QACD,KAAK;QACL,KAAK,CAAC,IAAI;YACR,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,IAAA,2BAAiB,EAAC,KAAK,CAAC,CAAC;gBACzB,KAAK,GAAG,SAAS,CAAC;YACpB,CAAC;YACD,MAAM,KAAK,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"batcher.js","sourceRoot":"","sources":["../src/batcher.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,kFAAkF;AAClF,sFAAsF;AACtF,kFAAkF;AAClF,0CAA0C;;AAkB1C,sCA4DC;AA3ED,uCAAiF;AAWjF,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,sBAAsB,GAAG,IAAI,CAAC;AACpC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B,SAAgB,aAAa,CAC3B,QAAuB,EACvB,UAAwB,EAAE,EAC1B,UAAoC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,cAAI,EAAC,sBAAsB,EAAE,KAAK,CAAC;IAElF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,gBAAgB,EAAE,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;IAC7F,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,sBAAsB,CAAC;IAEpE,IAAI,MAAM,GAAsB,EAAE,CAAC;IACnC,IAAI,KAA0B,CAAC;IAE/B,SAAS,UAAU;QACjB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAA,0BAAgB,EAAC,KAAK,CAAC,CAAC;YACxB,KAAK,GAAG,SAAS,CAAC;QACpB,CAAC;IACH,CAAC;IAED,KAAK,UAAU,KAAK;QAClB,UAAU,EAAE,CAAC;QACb,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAChC,MAAM,KAAK,GAAG,MAAM,CAAC;QACrB,MAAM,GAAG,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,6EAA6E;IAC7E,SAAS,aAAa;QACpB,UAAU,EAAE,CAAC;QACb,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;YACtB,KAAK,KAAK,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QACD,KAAK,GAAG,IAAA,wBAAc,EAAC,GAAG,EAAE,CAAC,KAAK,KAAK,EAAE,EAAE,YAAY,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO;QACL,GAAG,CAAC,IAAqB;YACvB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClB,IAAI,MAAM,CAAC,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,KAAK,KAAK,EAAE,CAAC,CAAC,2BAA2B;YAC3C,CAAC;iBAAM,CAAC;gBACN,aAAa,EAAE,CAAC,CAAC,+CAA+C;YAClE,CAAC;QACH,CAAC;QACD,KAAK;QACL,KAAK,CAAC,IAAI;YACR,UAAU,EAAE,CAAC;YACb,MAAM,KAAK,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/runtime.d.ts

@@ -2,8 +2,8 @@
 export type TimerId = number | {
     readonly __timer?: unique symbol;
 };
-/** setInterval que no bloquea la salida del proceso (unref en Node si existe). */
-export declare function setIntervalSafe(handler: () => void, ms: number): TimerId;
-export declare function clearIntervalSafe(id: TimerId): void;
+/** setTimeout que no bloquea la salida del proceso (unref en Node si existe). */
+export declare function setTimeoutSafe(handler: () => void, ms: number): TimerId;
+export declare function clearTimeoutSafe(id: TimerId): void;
 export declare function warn(...args: unknown[]): void;
 //# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAIA,6EAA6E;AAC7E,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,MAAM,CAAA;CAAE,CAAC;AAUpE,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAKxE;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAEnD;AAED,wBAAgB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAE7C"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAIA,6EAA6E;AAC7E,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,MAAM,CAAA;CAAE,CAAC;AAUpE,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAKvE;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAElD;AAED,wBAAgB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAE7C"}

package/dist/runtime.js

@@ -3,20 +3,20 @@
 // @types/node ni de los tipos del DOM. En ejecución real los provee Node o el
 // navegador; aquí los declaramos mínimamente para mantener el adapter ligero.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setIntervalSafe = setIntervalSafe;
-exports.clearIntervalSafe = clearIntervalSafe;
+exports.setTimeoutSafe = setTimeoutSafe;
+exports.clearTimeoutSafe = clearTimeoutSafe;
 exports.warn = warn;
 const runtime = globalThis;
-/** setInterval que no bloquea la salida del proceso (unref en Node si existe). */
-function setIntervalSafe(handler, ms) {
-    const id = runtime.setInterval(handler, ms);
+/** setTimeout que no bloquea la salida del proceso (unref en Node si existe). */
+function setTimeoutSafe(handler, ms) {
+    const id = runtime.setTimeout(handler, ms);
     const maybe = id;
     if (typeof maybe.unref === 'function')
         maybe.unref();
     return id;
 }
-function clearIntervalSafe(id) {
-    runtime.clearInterval(id);
+function clearTimeoutSafe(id) {
+    runtime.clearTimeout(id);
 }
 function warn(...args) {
     runtime.console.warn(...args);

package/dist/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":";AAAA,wEAAwE;AACxE,8EAA8E;AAC9E,8EAA8E;;AAc9E,0CAKC;AAED,8CAEC;AAED,oBAEC;AAhBD,MAAM,OAAO,GAAG,UAAuC,CAAC;AAExD,kFAAkF;AAClF,SAAgB,eAAe,CAAC,OAAmB,EAAE,EAAU;IAC7D,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,EAAuC,CAAC;IACtD,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU;QAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IACrD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAgB,iBAAiB,CAAC,EAAW;IAC3C,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;AAC5B,CAAC;AAED,SAAgB,IAAI,CAAC,GAAG,IAAe;IACrC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;AAChC,CAAC"}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":";AAAA,wEAAwE;AACxE,8EAA8E;AAC9E,8EAA8E;;AAc9E,wCAKC;AAED,4CAEC;AAED,oBAEC;AAhBD,MAAM,OAAO,GAAG,UAAuC,CAAC;AAExD,iFAAiF;AACjF,SAAgB,cAAc,CAAC,OAAmB,EAAE,EAAU;IAC5D,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,EAAuC,CAAC;IACtD,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU;QAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IACrD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAgB,gBAAgB,CAAC,EAAW;IAC1C,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED,SAAgB,IAAI,CAAC,GAAG,IAAe;IACrC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;AAChC,CAAC"}

package/dist/types.d.ts

@@ -45,10 +45,14 @@ export interface ProvaAttester {
 }
 /** Configuración del batching de atestaciones. */
 export interface BatchOptions {
-    /** Nº máximo de atestaciones por transacción (1–100). Default 25. */
+    /** Nº máximo de atestaciones por transacción (1–100). Al alcanzarlo, flush inmediato. Default 25. */
     maxSize?: number;
-    /** Flush automático cada N ms. Default 10000. 0 = sin flush por tiempo. */
-    flushIntervalMs?: number;
+    /**
+     * Debounce: hace flush este nº de ms tras la ÚLTIMA acción. Así una ráfaga de
+     * tool calls (multi-tool-calling) se agrupa en UNA sola tx on-chain apenas
+     * termina la ráfaga. Default 1000. 0 = flush inmediato en cada acción (sin batch).
+     */
+    flushDelayMs?: number;
 }
 /** Opciones de `attachProva`. */
 export interface AttachProvaOptions {

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAKA,yDAAyD;AACzD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnD,wEAAwE;AACxE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACnF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wEAAwE;AACxE,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,IAAI,MAAM,CAAA;KAAE,CAAC;IAC3C,eAAe,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/C,mBAAmB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACxD,sBAAsB,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7F,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACvD;AAED,6EAA6E;AAC7E,MAAM,MAAM,eAAe,GACvB,aAAa,GACb,UAAU,GACV,iBAAiB,GACjB,UAAU,GACV,gBAAgB,GAChB,aAAa,GACb,QAAQ,CAAC;AAEb,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,eAAe,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,WAAW,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzE;AAED,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,iCAAiC;AACjC,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,QAAQ,EAAE,aAAa,CAAC;IACxB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IACxC,iCAAiC;IACjC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACjE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAKA,yDAAyD;AACzD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnD,wEAAwE;AACxE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACnF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wEAAwE;AACxE,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,IAAI,MAAM,CAAA;KAAE,CAAC;IAC3C,eAAe,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/C,mBAAmB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACxD,sBAAsB,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7F,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACvD;AAED,6EAA6E;AAC7E,MAAM,MAAM,eAAe,GACvB,aAAa,GACb,UAAU,GACV,iBAAiB,GACjB,UAAU,GACV,gBAAgB,GAChB,aAAa,GACb,QAAQ,CAAC;AAEb,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,eAAe,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,WAAW,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzE;AAED,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC3B,qGAAqG;IACrG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,iCAAiC;AACjC,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,QAAQ,EAAE,aAAa,CAAC;IACxB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IACxC,iCAAiC;IACjC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACjE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prova-agent-kit",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "license": "Apache-2.0",
   "author": "Prova Labs",
   "description": "Prova adapter for Solana Agent Kit — emit verifiable on-chain receipts for every action a SAK agent executes",

package/src/attach.test.ts

@@ -29,7 +29,7 @@ describe('attachProva', () => {
 
     const handle = attachProva(agent, {
       attester,
-      batch: { maxSize: 1, flushIntervalMs: 0 },
+      batch: { maxSize: 1, flushDelayMs: 0 },
     });
 
     const result = await agent.actions[0]!.handler(agent, { amount: 10 });
@@ -72,7 +72,7 @@ describe('attachProva', () => {
     const handle = attachProva(agent, {
       attester,
       rules: (name) => name === 'trade',
-      batch: { maxSize: 1, flushIntervalMs: 0 },
+      batch: { maxSize: 1, flushDelayMs: 0 },
     });
 
     await agent.actions[0]!.handler(agent, {});

package/src/batcher.test.ts

@@ -0,0 +1,70 @@
+import { describe, expect, it } from 'vitest';
+import { createBatcher } from './batcher';
+import type { AttestationItem, ProvaAttester } from './types';
+
+function recordingAttester() {
+  const attests: AttestationItem[] = [];
+  const batches: AttestationItem[][] = [];
+  const attester: ProvaAttester = {
+    hashAction: async () => new Uint8Array(32),
+    attest: async (item) => {
+      attests.push(item);
+      return { txSignature: 'tx' };
+    },
+    batchAttest: async (items) => {
+      batches.push(items);
+      return { txSignature: 'tx' };
+    },
+  };
+  return { attester, attests, batches };
+}
+
+const item = (): AttestationItem => ({ actionHash: new Uint8Array(32), actionType: 'ToolCall' });
+const wait = (ms: number) => new Promise((r) => setTimeout(r, ms));
+
+describe('createBatcher — multi-tool-calling (bug del mentor)', () => {
+  it('agrupa una RÁFAGA de 11 acciones en UNA sola batchAttest', async () => {
+    const { attester, attests, batches } = recordingAttester();
+    const batcher = createBatcher(attester, { maxSize: 25, flushDelayMs: 20 });
+
+    for (let i = 0; i < 11; i++) batcher.add(item());
+
+    await wait(50); // pasa el debounce
+    expect(batches).toHaveLength(1); // UNA sola tx
+    expect(batches[0]).toHaveLength(11); // con las 11 dentro
+    expect(attests).toHaveLength(0); // ninguna suelta
+  });
+
+  it('no pierde nada si el agente cierra antes del debounce (stop hace flush)', async () => {
+    const { attester, batches } = recordingAttester();
+    const batcher = createBatcher(attester, { maxSize: 25, flushDelayMs: 5000 });
+
+    for (let i = 0; i < 11; i++) batcher.add(item());
+    await batcher.stop(); // cierre inmediato
+
+    expect(batches).toHaveLength(1);
+    expect(batches[0]).toHaveLength(11);
+  });
+
+  it('hace flush inmediato al alcanzar maxSize', async () => {
+    const { attester, batches } = recordingAttester();
+    const batcher = createBatcher(attester, { maxSize: 5, flushDelayMs: 5000 });
+
+    for (let i = 0; i < 5; i++) batcher.add(item());
+    await wait(0);
+
+    expect(batches).toHaveLength(1);
+    expect(batches[0]).toHaveLength(5);
+  });
+
+  it('una sola acción usa attest (no batchAttest)', async () => {
+    const { attester, attests, batches } = recordingAttester();
+    const batcher = createBatcher(attester, { flushDelayMs: 10 });
+
+    batcher.add(item());
+    await wait(30);
+
+    expect(attests).toHaveLength(1);
+    expect(batches).toHaveLength(0);
+  });
+});

package/src/batcher.ts

@@ -1,21 +1,23 @@
-// Buffer de atestaciones: acumula items y los envía en lote (batchAttest) cada
-// N items o cada T ms, lo que ocurra primero. Aísla la latencia/coste de Solana
-// del hot-path del agente.
+// Buffer de atestaciones con flush por DEBOUNCE: agrupa una ráfaga de acciones
+// (multi-tool-calling) y las envía en UNA sola tx (batchAttest, hasta 100) apenas
+// la ráfaga se detiene. Esto arregla el bug de "N tool calls seguidos → 0 guardadas":
+// antes el flush solo ocurría a los 25 items o cada 10s, así que una ráfaga corta
+// que terminaba antes quedaba sin enviar.
 
 import type { AttestationItem, BatchOptions, ProvaAttester } from './types';
-import { clearIntervalSafe, setIntervalSafe, warn, type TimerId } from './runtime';
+import { clearTimeoutSafe, setTimeoutSafe, warn, type TimerId } from './runtime';
 
 export interface Batcher {
-  /** Encola una atestación; dispara flush si se alcanza maxSize. */
+  /** Encola una atestación; programa el flush (o lo dispara si se alcanza maxSize). */
   add(item: AttestationItem): void;
   /** Envía inmediatamente lo pendiente. */
   flush(): Promise<void>;
-  /** Detiene el timer y hace un último flush. */
+  /** Cancela el timer y hace un último flush (llamar al cerrar el agente). */
   stop(): Promise<void>;
 }
 
 const DEFAULT_MAX_SIZE = 25;
-const DEFAULT_INTERVAL_MS = 10_000;
+const DEFAULT_FLUSH_DELAY_MS = 1000;
 const HARD_BATCH_LIMIT = 100;
 
 export function createBatcher(
@@ -24,12 +26,20 @@ export function createBatcher(
   onError: (error: unknown) => void = (error) => warn('[Prova] batch error:', error),
 ): Batcher {
   const maxSize = Math.min(Math.max(options.maxSize ?? DEFAULT_MAX_SIZE, 1), HARD_BATCH_LIMIT);
-  const intervalMs = options.flushIntervalMs ?? DEFAULT_INTERVAL_MS;
+  const flushDelayMs = options.flushDelayMs ?? DEFAULT_FLUSH_DELAY_MS;
 
   let buffer: AttestationItem[] = [];
   let timer: TimerId | undefined;
 
+  function clearTimer(): void {
+    if (timer !== undefined) {
+      clearTimeoutSafe(timer);
+      timer = undefined;
+    }
+  }
+
   async function flush(): Promise<void> {
+    clearTimer();
     if (buffer.length === 0) return;
     const batch = buffer;
     buffer = [];
@@ -44,24 +54,29 @@ export function createBatcher(
     }
   }
 
-  function ensureTimer(): void {
-    if (intervalMs > 0 && timer === undefined) {
-      timer = setIntervalSafe(() => void flush(), intervalMs);
+  // Debounce: cada acción reinicia el timer, de modo que el flush ocurre
+  // `flushDelayMs` ms DESPUÉS de la última acción de la ráfaga → todo en 1 tx.
+  function scheduleFlush(): void {
+    clearTimer();
+    if (flushDelayMs <= 0) {
+      void flush();
+      return;
     }
+    timer = setTimeoutSafe(() => void flush(), flushDelayMs);
   }
 
   return {
     add(item: AttestationItem): void {
       buffer.push(item);
-      ensureTimer();
-      if (buffer.length >= maxSize) void flush();
+      if (buffer.length >= maxSize) {
+        void flush(); // llegó al tope → envía ya
+      } else {
+        scheduleFlush(); // si no, agrupa la ráfaga y envía al detenerse
+      }
     },
     flush,
     async stop(): Promise<void> {
-      if (timer !== undefined) {
-        clearIntervalSafe(timer);
-        timer = undefined;
-      }
+      clearTimer();
       await flush();
     },
   };

package/src/runtime.ts

@@ -6,23 +6,23 @@
 export type TimerId = number | { readonly __timer?: unique symbol };
 
 interface RuntimeGlobals {
-  setInterval(handler: () => void, ms: number): TimerId;
-  clearInterval(id: TimerId): void;
+  setTimeout(handler: () => void, ms: number): TimerId;
+  clearTimeout(id: TimerId): void;
   console: { warn(...args: unknown[]): void };
 }
 
 const runtime = globalThis as unknown as RuntimeGlobals;
 
-/** setInterval que no bloquea la salida del proceso (unref en Node si existe). */
-export function setIntervalSafe(handler: () => void, ms: number): TimerId {
-  const id = runtime.setInterval(handler, ms);
+/** setTimeout que no bloquea la salida del proceso (unref en Node si existe). */
+export function setTimeoutSafe(handler: () => void, ms: number): TimerId {
+  const id = runtime.setTimeout(handler, ms);
   const maybe = id as unknown as { unref?: () => void };
   if (typeof maybe.unref === 'function') maybe.unref();
   return id;
 }
 
-export function clearIntervalSafe(id: TimerId): void {
-  runtime.clearInterval(id);
+export function clearTimeoutSafe(id: TimerId): void {
+  runtime.clearTimeout(id);
 }
 
 export function warn(...args: unknown[]): void {

package/src/types.ts

@@ -56,10 +56,14 @@ export interface ProvaAttester {
 
 /** Configuración del batching de atestaciones. */
 export interface BatchOptions {
-  /** Nº máximo de atestaciones por transacción (1–100). Default 25. */
+  /** Nº máximo de atestaciones por transacción (1–100). Al alcanzarlo, flush inmediato. Default 25. */
   maxSize?: number;
-  /** Flush automático cada N ms. Default 10000. 0 = sin flush por tiempo. */
-  flushIntervalMs?: number;
+  /**
+   * Debounce: hace flush este nº de ms tras la ÚLTIMA acción. Así una ráfaga de
+   * tool calls (multi-tool-calling) se agrupa en UNA sola tx on-chain apenas
+   * termina la ráfaga. Default 1000. 0 = flush inmediato en cada acción (sin batch).
+   */
+  flushDelayMs?: number;
 }
 
 /** Opciones de `attachProva`. */