prova-agent-kit 0.1.0 → 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/adapter.js

@@ -1,5 +1,8 @@
+"use strict";
 // Puente entre el `ProvaClient` real (prova-agent-sdk) y la interfaz
 // `ProvaAttester` que usa el adapter. Tipado estructural → no importamos el SDK.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.attesterFromProvaClient = attesterFromProvaClient;
 /**
  * Construye un `ProvaAttester` a partir de un `ProvaClient` real, la función
  * estática `ProvaClient.hashAction` y la keypair operadora de Prova.
@@ -7,7 +10,7 @@
  * @example
  * const attester = attesterFromProvaClient(prova, ProvaClient.hashAction, operatorKeypair);
  */
-export function attesterFromProvaClient(client, hashAction, operatorKeypair) {
+function attesterFromProvaClient(client, hashAction, operatorKeypair) {
     return {
         hashAction,
         attest: (item) => client.attest({

package/dist/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,iFAAiF;AAiBjF;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAuB,EACvB,UAAoD,EACpD,eAAwB;IAExB,OAAO;QACL,UAAU;QACV,MAAM,EAAE,CAAC,IAAqB,EAAE,EAAE,CAChC,MAAM,CAAC,MAAM,CAAC;YACZ,eAAe;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;QACJ,WAAW,EAAE,CAAC,KAAwB,EAAE,EAAE,CACxC,MAAM,CAAC,WAAW,CAAC,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;KAC/D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":";AAAA,qEAAqE;AACrE,iFAAiF;;AAwBjF,0DAgBC;AAvBD;;;;;;GAMG;AACH,SAAgB,uBAAuB,CACrC,MAAuB,EACvB,UAAoD,EACpD,eAAwB;IAExB,OAAO;QACL,UAAU;QACV,MAAM,EAAE,CAAC,IAAqB,EAAE,EAAE,CAChC,MAAM,CAAC,MAAM,CAAC;YACZ,eAAe;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;QACJ,WAAW,EAAE,CAAC,KAAwB,EAAE,EAAE,CACxC,MAAM,CAAC,WAAW,CAAC,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;KAC/D,CAAC;AACJ,CAAC"}

package/dist/attach.js

@@ -1,15 +1,18 @@
+"use strict";
 // Enfoque B: envuelve los handlers de las acciones del agente para atestar cada
 // ejecución en Prova. Es el mecanismo principal de captura (semántica rica:
 // nombre + input + output). Llamar DESPUÉS de registrar todos los plugins.
-import { buildPayload, mapActionType } from './payload';
-import { createBatcher } from './batcher';
-import { warn } from './runtime';
-export function attachProva(agent, options) {
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.attachProva = attachProva;
+const payload_1 = require("./payload");
+const batcher_1 = require("./batcher");
+const runtime_1 = require("./runtime");
+function attachProva(agent, options) {
     const { attester } = options;
     const should = options.rules ?? (() => true);
     const onError = options.onError ??
-        ((error, context) => warn(`[Prova] attest failed for "${context.action}":`, error));
-    const batcher = createBatcher(attester, options.batch, (error) => onError(error, { action: 'batch' }));
+        ((error, context) => (0, runtime_1.warn)(`[Prova] attest failed for "${context.action}":`, error));
+    const batcher = (0, batcher_1.createBatcher)(attester, options.batch, (error) => onError(error, { action: 'batch' }));
     agent.actions = agent.actions.map((action) => {
         if (!should(action.name))
             return action;
@@ -30,8 +33,8 @@ export function attachProva(agent, options) {
     };
 }
 async function captureAction(attester, batcher, name, input, result) {
-    const payload = buildPayload(name, input, result);
+    const payload = (0, payload_1.buildPayload)(name, input, result);
     const actionHash = await attester.hashAction(JSON.stringify(payload));
-    batcher.add({ actionHash, actionType: mapActionType(name, result) });
+    batcher.add({ actionHash, actionType: (0, payload_1.mapActionType)(name, result) });
 }
 //# sourceMappingURL=attach.js.map

package/dist/attach.js.map

@@ -1 +1 @@
-{"version":3,"file":"attach.js","sourceRoot":"","sources":["../src/attach.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,4EAA4E;AAC5E,2EAA2E;AAG3E,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,aAAa,EAAgB,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjC,MAAM,UAAU,WAAW,CAAC,KAAgB,EAAE,OAA2B;IACvE,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,OAAO,GACX,OAAO,CAAC,OAAO;QACf,CAAC,CAAC,KAAc,EAAE,OAA2B,EAAE,EAAE,CAC/C,IAAI,CAAC,8BAA8B,OAAO,CAAC,MAAM,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAEnE,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAC/D,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CACpC,CAAC;IAEF,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAkB,EAAc,EAAE;QACnE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,OAAO,MAAM,CAAC;QACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC;QAChC,OAAO;YACL,GAAG,MAAM;YACT,OAAO,EAAE,KAAK,EAAE,CAAU,EAAE,KAA8B,EAAE,EAAE;gBAC5D,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;gBACxC,qEAAqE;gBACrE,KAAK,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAChF,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CACxC,CAAC;gBACF,OAAO,MAAM,CAAC;YAChB,CAAC;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE;QAC5B,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE;KAC3B,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,QAAuB,EACvB,OAAgB,EAChB,IAAY,EACZ,KAA8B,EAC9B,MAA+B;IAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;AACvE,CAAC"}
+{"version":3,"file":"attach.js","sourceRoot":"","sources":["../src/attach.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,4EAA4E;AAC5E,2EAA2E;;AAc3E,kCAgCC;AA3CD,uCAAwD;AACxD,uCAAwD;AACxD,uCAAiC;AASjC,SAAgB,WAAW,CAAC,KAAgB,EAAE,OAA2B;IACvE,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,OAAO,GACX,OAAO,CAAC,OAAO;QACf,CAAC,CAAC,KAAc,EAAE,OAA2B,EAAE,EAAE,CAC/C,IAAA,cAAI,EAAC,8BAA8B,OAAO,CAAC,MAAM,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAEnE,MAAM,OAAO,GAAG,IAAA,uBAAa,EAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAC/D,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CACpC,CAAC;IAEF,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAkB,EAAc,EAAE;QACnE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,OAAO,MAAM,CAAC;QACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC;QAChC,OAAO;YACL,GAAG,MAAM;YACT,OAAO,EAAE,KAAK,EAAE,CAAU,EAAE,KAA8B,EAAE,EAAE;gBAC5D,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;gBACxC,qEAAqE;gBACrE,KAAK,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAChF,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CACxC,CAAC;gBACF,OAAO,MAAM,CAAC;YAChB,CAAC;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE;QAC5B,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE;KAC3B,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,QAAuB,EACvB,OAAgB,EAChB,IAAY,EACZ,KAA8B,EAC9B,MAA+B;IAE/B,MAAM,OAAO,GAAG,IAAA,sBAAY,EAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,IAAA,uBAAa,EAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;AACvE,CAAC"}

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,16 +1,28 @@
-// 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.
-import { clearIntervalSafe, setIntervalSafe, warn } from './runtime';
+"use strict";
+// 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;
-export function createBatcher(attester, options = {}, onError = (error) => warn('[Prova] batch error:', error)) {
+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;
@@ -27,24 +39,29 @@ export function createBatcher(attester, options = {}, onError = (error) => warn(
             onError(error);
         }
     }
-    function ensureTimer() {
-        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() {
+        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) {
-                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;AAG3B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,IAAI,EAAgB,MAAM,WAAW,CAAC;AAWnF,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,mBAAmB,GAAG,MAAM,CAAC;AACnC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B,MAAM,UAAU,aAAa,CAC3B,QAAuB,EACvB,UAAwB,EAAE,EAC1B,UAAoC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,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,eAAe,CAAC,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,iBAAiB,CAAC,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/index.js

@@ -1,7 +1,17 @@
+"use strict";
 // API pública del adapter Prova ↔ Solana Agent Kit.
-export { attachProva } from './attach';
-export { ProvaWallet } from './wallet';
-export { attesterFromProvaClient } from './adapter';
-export { createBatcher } from './batcher';
-export { buildPayload, mapActionType, extractSignature } from './payload';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractSignature = exports.mapActionType = exports.buildPayload = exports.createBatcher = exports.attesterFromProvaClient = exports.ProvaWallet = exports.attachProva = void 0;
+var attach_1 = require("./attach");
+Object.defineProperty(exports, "attachProva", { enumerable: true, get: function () { return attach_1.attachProva; } });
+var wallet_1 = require("./wallet");
+Object.defineProperty(exports, "ProvaWallet", { enumerable: true, get: function () { return wallet_1.ProvaWallet; } });
+var adapter_1 = require("./adapter");
+Object.defineProperty(exports, "attesterFromProvaClient", { enumerable: true, get: function () { return adapter_1.attesterFromProvaClient; } });
+var batcher_1 = require("./batcher");
+Object.defineProperty(exports, "createBatcher", { enumerable: true, get: function () { return batcher_1.createBatcher; } });
+var payload_1 = require("./payload");
+Object.defineProperty(exports, "buildPayload", { enumerable: true, get: function () { return payload_1.buildPayload; } });
+Object.defineProperty(exports, "mapActionType", { enumerable: true, get: function () { return payload_1.mapActionType; } });
+Object.defineProperty(exports, "extractSignature", { enumerable: true, get: function () { return payload_1.extractSignature; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oDAAoD;AAEpD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGvC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,oDAAoD;;;AAEpD,mCAAuC;AAA9B,qGAAA,WAAW,OAAA;AAGpB,mCAAuC;AAA9B,qGAAA,WAAW,OAAA;AAGpB,qCAAoD;AAA3C,kHAAA,uBAAuB,OAAA;AAGhC,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AAGtB,qCAA0E;AAAjE,uGAAA,YAAY,OAAA;AAAE,wGAAA,aAAa,OAAA;AAAE,2GAAA,gBAAgB,OAAA"}

package/dist/payload.js

@@ -1,9 +1,14 @@
+"use strict";
 // Funciones puras: derivan el payload y el tipo de atestación a partir de la
 // acción de SAK y su resultado. Sin efectos secundarios → fáciles de testear.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractSignature = extractSignature;
+exports.mapActionType = mapActionType;
+exports.buildPayload = buildPayload;
 const SIGNATURE_KEYS = ['signature', 'txSignature', 'txid', 'tx'];
 const DECISION_PATTERN = /decision|choose|select|rebalance|hold|exit|approve|reject/i;
 /** Extrae la firma on-chain del result de una acción, si está presente. */
-export function extractSignature(result) {
+function extractSignature(result) {
     for (const key of SIGNATURE_KEYS) {
         const value = result[key];
         if (typeof value === 'string' && value.length > 0)
@@ -12,7 +17,7 @@ export function extractSignature(result) {
     return undefined;
 }
 /** Mapea el nombre de una acción de SAK al `ActionType` de Prova. */
-export function mapActionType(actionName, result) {
+function mapActionType(actionName, result) {
     if (extractSignature(result))
         return 'Transaction';
     if (DECISION_PATTERN.test(actionName))
@@ -20,7 +25,7 @@ export function mapActionType(actionName, result) {
     return 'ToolCall';
 }
 /** Construye el objeto que se serializa y hashea para producir el action_hash. */
-export function buildPayload(actionName, input, result) {
+function buildPayload(actionName, input, result) {
     const signature = extractSignature(result);
     if (signature) {
         return { kind: 'transaction', action: actionName, signature, input };

package/dist/payload.js.map

@@ -1 +1 @@
-{"version":3,"file":"payload.js","sourceRoot":"","sources":["../src/payload.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,8EAA8E;AAI9E,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,CAAU,CAAC;AAC3E,MAAM,gBAAgB,GAAG,4DAA4D,CAAC;AAEtF,2EAA2E;AAC3E,MAAM,UAAU,gBAAgB,CAAC,MAAoB;IACnD,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IAClE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,aAAa,CAAC,UAAkB,EAAE,MAAoB;IACpE,IAAI,gBAAgB,CAAC,MAAM,CAAC;QAAE,OAAO,aAAa,CAAC;IACnD,IAAI,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IACzD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,YAAY,CAC1B,UAAkB,EAClB,KAA8B,EAC9B,MAAoB;IAEpB,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACvE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACjE,CAAC"}
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../src/payload.ts"],"names":[],"mappings":";AAAA,6EAA6E;AAC7E,8EAA8E;;AAQ9E,4CAMC;AAGD,sCAIC;AAGD,oCAUC;AA9BD,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,CAAU,CAAC;AAC3E,MAAM,gBAAgB,GAAG,4DAA4D,CAAC;AAEtF,2EAA2E;AAC3E,SAAgB,gBAAgB,CAAC,MAAoB;IACnD,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IAClE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,qEAAqE;AACrE,SAAgB,aAAa,CAAC,UAAkB,EAAE,MAAoB;IACpE,IAAI,gBAAgB,CAAC,MAAM,CAAC;QAAE,OAAO,aAAa,CAAC;IACnD,IAAI,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IACzD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,kFAAkF;AAClF,SAAgB,YAAY,CAC1B,UAAkB,EAClB,KAA8B,EAC9B,MAAoB;IAEpB,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACvE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACjE,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

@@ -1,19 +1,24 @@
+"use strict";
 // Acceso tipado a globales de runtime (timers, console) sin depender de
 // @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.setTimeoutSafe = setTimeoutSafe;
+exports.clearTimeoutSafe = clearTimeoutSafe;
+exports.warn = warn;
 const runtime = globalThis;
-/** setInterval que no bloquea la salida del proceso (unref en Node si existe). */
-export 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;
 }
-export function clearIntervalSafe(id) {
-    runtime.clearInterval(id);
+function clearTimeoutSafe(id) {
+    runtime.clearTimeout(id);
 }
-export function warn(...args) {
+function warn(...args) {
     runtime.console.warn(...args);
 }
 //# sourceMappingURL=runtime.js.map

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;AAW9E,MAAM,OAAO,GAAG,UAAuC,CAAC;AAExD,kFAAkF;AAClF,MAAM,UAAU,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,MAAM,UAAU,iBAAiB,CAAC,EAAW;IAC3C,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,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/dist/types.js

@@ -1,6 +1,7 @@
+"use strict";
 // Tipos del adapter. Reflejamos estructuralmente la API pública de Solana Agent
 // Kit v2 (BaseWallet, Action, SolanaAgentKit) para NO importar el paquete y
 // mantener el adapter como peerDependency ligera. La compatibilidad se apoya en
 // el tipado estructural de TypeScript.
-export {};
+Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,4EAA4E;AAC5E,gFAAgF;AAChF,uCAAuC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,4EAA4E;AAC5E,gFAAgF;AAChF,uCAAuC"}

package/dist/wallet.js

@@ -1,15 +1,18 @@
+"use strict";
 // Enfoque A: decorador de BaseWallet (SAK v2). Captura la firma on-chain real
 // de cada transacción firmada/enviada, sin importar qué plugin la produjo. Es
 // el "cinturón de seguridad" que complementa a `attachProva`.
-import { createBatcher } from './batcher';
-export class ProvaWallet {
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProvaWallet = void 0;
+const batcher_1 = require("./batcher");
+class ProvaWallet {
     inner;
     attester;
     batcher;
     constructor(inner, options) {
         this.inner = inner;
         this.attester = options.attester;
-        this.batcher = createBatcher(options.attester, options.batch, options.onError);
+        this.batcher = (0, batcher_1.createBatcher)(options.attester, options.batch, options.onError);
     }
     get publicKey() {
         return this.inner.publicKey;
@@ -43,4 +46,5 @@ export class ProvaWallet {
         this.batcher.add({ actionHash, actionType: 'Transaction' });
     }
 }
+exports.ProvaWallet = ProvaWallet;
 //# sourceMappingURL=wallet.js.map

package/dist/wallet.js.map

@@ -1 +1 @@
-{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../src/wallet.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8EAA8E;AAC9E,8DAA8D;AAG9D,OAAO,EAAE,aAAa,EAAgB,MAAM,WAAW,CAAC;AAQxD,MAAM,OAAO,WAAW;IACL,KAAK,CAAa;IAClB,QAAQ,CAAgB;IACxB,OAAO,CAAU;IAElC,YAAY,KAAiB,EAAE,OAA2B;QACxD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACjF,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;IAC9B,CAAC;IAED,eAAe,CAAI,WAAc;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;IACjD,CAAC;IAED,mBAAmB,CAAI,YAAiB;QACtC,OAAO,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;IACtD,CAAC;IAED,WAAW,CAAC,OAAmB;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,sBAAsB,CAAI,WAAc,EAAE,OAAiB;QAC/D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC7E,sDAAsD;QACtD,KAAK,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC7D,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,sDAAsD;IACtD,KAAK;QACH,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED,gDAAgD;IAChD,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,SAAiB;QAC9C,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QACrE,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3E,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC,CAAC;IAC9D,CAAC;CACF"}
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../src/wallet.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,8EAA8E;AAC9E,8DAA8D;;;AAG9D,uCAAwD;AAQxD,MAAa,WAAW;IACL,KAAK,CAAa;IAClB,QAAQ,CAAgB;IACxB,OAAO,CAAU;IAElC,YAAY,KAAiB,EAAE,OAA2B;QACxD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,IAAA,uBAAa,EAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACjF,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;IAC9B,CAAC;IAED,eAAe,CAAI,WAAc;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;IACjD,CAAC;IAED,mBAAmB,CAAI,YAAiB;QACtC,OAAO,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;IACtD,CAAC;IAED,WAAW,CAAC,OAAmB;QAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,sBAAsB,CAAI,WAAc,EAAE,OAAiB;QAC/D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC7E,sDAAsD;QACtD,KAAK,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC7D,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,sDAAsD;IACtD,KAAK;QACH,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED,gDAAgD;IAChD,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,SAAiB;QAC9C,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QACrE,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3E,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC,CAAC;IAC9D,CAAC;CACF;AAjDD,kCAiDC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prova-agent-kit",
-  "version": "0.1.0",
+  "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`. */