@oobe-protocol-labs/synapse-client-sdk 1.2.2 → 2.0.0

package/dist/esm/ai/gateway/monetize.js

@@ -0,0 +1,277 @@
+/**
+ * @module ai/gateway/monetize
+ * @description DeFi Tool Monetization Bridge — connects protocol tools
+ * (Jupiter, Raydium, Metaplex, etc.) to the AgentGateway commerce layer.
+ *
+ * Every protocol tool becomes a metered, attested, x402-payable service:
+ * - Budget tracking per session
+ * - Rate limiting (sliding window)
+ * - Proof-of-Computation attestation
+ * - Auto-publish to ToolMarketplace
+ * - x402 payment integration
+ *
+ * @example
+ * ```ts
+ * import { createAgentGateway, createJupiterTools, createMonetizedTools } from '@oobe-protocol-labs/synapse-client-sdk/ai';
+ *
+ * const gateway = createAgentGateway(client, config);
+ * const jupiter = createJupiterTools({ apiKey: '...' });
+ * const session = gateway.openSession(intent);
+ *
+ * // Wrap all Jupiter tools with metering + attestation
+ * const monetized = await createMonetizedTools(gateway, session.id, jupiter);
+ * agent.tools.push(...monetized.tools);
+ *
+ * // Multi-protocol monetization
+ * const all = await createMultiProtocolMonetizedTools(gateway, session.id, {
+ *   jupiter: createJupiterTools(),
+ *   raydium: createRaydiumTools(),
+ * });
+ * agent.tools.push(...all.allTools);
+ * ```
+ *
+ * @since 1.3.0
+ */
+/* ═══════════════════════════════════════════════════════════════
+ *  Error
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * @description Error class for monetization-related failures.
+ * @since 1.3.0
+ */
+export class MonetizeError extends Error {
+    code;
+    /**
+     * @param {string} message - Human-readable error message
+     * @param {string} [code='MONETIZE_ERROR'] - Machine-readable error code
+     */
+    constructor(message, code = 'MONETIZE_ERROR') {
+        super(message);
+        this.code = code;
+        this.name = 'MonetizeError';
+    }
+}
+/* ═══════════════════════════════════════════════════════════════
+ *  createMonetizedTools()
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * @description Wrap every tool in a {@link ProtocolToolkit} with session
+ * metering, attestation, and optional marketplace listing.
+ *
+ * The returned tools are drop-in replacements for the originals: same
+ * name pattern, same Zod schema, same JSON output — plus an
+ * `_monetization` envelope that includes attestation, cost, and latency.
+ *
+ * @param {MonetizableGateway} gateway  - Gateway providing session + validator
+ * @param {string}             sessionId - Active session to charge against
+ * @param {ProtocolToolkit}    toolkit   - Original protocol toolkit to wrap
+ * @param {MonetizeConfig}     [config]  - Optional monetization settings
+ * @returns {Promise<MonetizedToolkit>} Monetized toolkit ready for agent use
+ *
+ * @throws {MonetizeError} If the session does not exist
+ *
+ * @example
+ * ```ts
+ * const monetized = await createMonetizedTools(gateway, session.id, jupiterTools);
+ * const result = await monetized.toolMap.getQuote.invoke({ inputMint: 'So11...', outputMint: 'EPjF...' });
+ * console.log(monetized.metrics); // { totalCalls: 1, totalRevenue: 1000n, ... }
+ * ```
+ *
+ * @since 1.3.0
+ */
+export async function createMonetizedTools(gateway, sessionId, toolkit, config = {}) {
+    const session = gateway.getSession(sessionId);
+    if (!session) {
+        throw new MonetizeError(`Session '${sessionId}' not found`, 'SESSION_NOT_FOUND');
+    }
+    /* ── Lazy-import LangChain to keep gateway usable without it ── */
+    const { tool: lcTool } = await import('@langchain/core/tools');
+    const { autoPublish = true, descriptionPrefix = '[Monetized]', includeAttestation, prefix = 'monetized_', region, commitments = ['confirmed'], tiers, } = config;
+    /* ── Mutable metrics ── */
+    const metrics = {
+        totalCalls: 0,
+        totalRevenue: 0n,
+        callsByMethod: {},
+        revenueByMethod: {},
+        avgLatencyMs: 0,
+        errors: 0,
+    };
+    let cumulativeLatency = 0;
+    let _disposed = false;
+    /* ── Build wrapped tools ── */
+    const tools = [];
+    const toolMap = {};
+    for (const method of toolkit.methods) {
+        const originalTool = toolkit.toolMap[method.name];
+        if (!originalTool)
+            continue;
+        const toolName = `${prefix}${toolkit.protocol}_${method.name}`;
+        const wrappedTool = lcTool(async (input) => {
+            if (_disposed) {
+                throw new MonetizeError('Toolkit has been disposed', 'DISPOSED');
+            }
+            const currentSession = gateway.getSession(sessionId);
+            if (!currentSession) {
+                throw new MonetizeError(`Session '${sessionId}' is no longer active`, 'SESSION_EXPIRED');
+            }
+            /* 1 ── Pre-call: budget + rate limit ── */
+            const cost = currentSession.preCall(method.name);
+            const start = performance.now();
+            try {
+                /* 2 ── Execute original tool ── */
+                const rawResult = await originalTool.invoke(input);
+                const latencyMs = Math.round(performance.now() - start);
+                /* 3 ── Parse result for attestation hashing ── */
+                let parsed;
+                try {
+                    parsed = JSON.parse(rawResult);
+                }
+                catch {
+                    parsed = rawResult;
+                }
+                /* 4 ── Attestation ── */
+                const snap = currentSession.snapshot();
+                const shouldAttest = includeAttestation ?? snap.tier.includesAttestation;
+                const attested = await gateway.validator.wrapResult(parsed, sessionId, `${toolkit.protocol}:${method.name}`, input, 0, // slot — protocol calls are off-chain
+                latencyMs, snap.callsMade + 1, shouldAttest);
+                /* 5 ── Post-call: deduct budget ── */
+                currentSession.postCall(method.name, cost);
+                /* 6 ── Update metrics ── */
+                metrics.totalCalls++;
+                metrics.totalRevenue += cost;
+                metrics.callsByMethod[method.name] = (metrics.callsByMethod[method.name] ?? 0) + 1;
+                metrics.revenueByMethod[method.name] = (metrics.revenueByMethod[method.name] ?? 0n) + cost;
+                cumulativeLatency += latencyMs;
+                metrics.avgLatencyMs = Math.round(cumulativeLatency / metrics.totalCalls);
+                /* 7 ── Return enriched result ── */
+                return JSON.stringify({
+                    data: parsed,
+                    attestation: attested.attestation ?? null,
+                    latencyMs,
+                    callIndex: attested.callIndex,
+                    metered: true,
+                    protocol: toolkit.protocol,
+                    method: method.name,
+                    cost: cost.toString(),
+                }, null, 2);
+            }
+            catch (err) {
+                metrics.errors++;
+                throw err;
+            }
+        }, {
+            name: toolName,
+            description: `${descriptionPrefix} ${method.description ?? method.name} — metered + attested via Synapse Gateway`,
+            schema: method.input,
+        });
+        tools.push(wrappedTool);
+        toolMap[method.name] = wrappedTool; // unprefixed
+        toolMap[toolName] = wrappedTool; // prefixed
+    }
+    /* ── Auto-publish to marketplace ── */
+    if (autoPublish) {
+        const snap = session.snapshot();
+        const publishTiers = tiers ?? [snap.tier];
+        for (const method of toolkit.methods) {
+            const listing = {
+                method: `${toolkit.protocol}:${method.name}`,
+                description: method.description ?? method.name,
+                seller: gateway.identity,
+                tiers: publishTiers,
+                avgLatencyMs: 0,
+                uptimePercent: 100,
+                totalServed: 0,
+                reputationScore: 500,
+                attestationAvailable: true,
+                region,
+                commitments,
+                listedAt: Date.now(),
+                updatedAt: Date.now(),
+            };
+            gateway.marketplace.listTool(listing);
+        }
+    }
+    return {
+        protocol: toolkit.protocol,
+        tools,
+        toolMap,
+        original: toolkit,
+        sessionId,
+        metrics,
+        get disposed() { return _disposed; },
+        dispose() {
+            _disposed = true;
+        },
+    };
+}
+/* ═══════════════════════════════════════════════════════════════
+ *  createMultiProtocolMonetizedTools()
+ * ═══════════════════════════════════════════════════════════════ */
+/**
+ * @description Monetize multiple protocol toolkits in a single call.
+ * Returns per-protocol toolkits plus a flat `allTools` array.
+ *
+ * @param {MonetizableGateway} gateway   - Gateway instance
+ * @param {string}             sessionId - Active session
+ * @param {Record<string, ProtocolToolkit>} toolkits - Map of protocol name → toolkit
+ * @param {MonetizeConfig}     [config]  - Shared config applied to all toolkits
+ * @returns {Promise<MultiMonetizedResult>} All monetized toolkits + aggregated helpers
+ *
+ * @example
+ * ```ts
+ * const result = await createMultiProtocolMonetizedTools(gateway, sid, {
+ *   jupiter: jupiterToolkit,
+ *   raydium: raydiumToolkit,
+ *   metaplex: metaplexToolkit,
+ * });
+ * agent.tools.push(...result.allTools); // 48+ monetized tools
+ * console.log(result.aggregateMetrics());
+ * ```
+ *
+ * @since 1.3.0
+ */
+export async function createMultiProtocolMonetizedTools(gateway, sessionId, toolkits, config = {}) {
+    const entries = Object.entries(toolkits);
+    const monetized = await Promise.all(entries.map(([, tk]) => createMonetizedTools(gateway, sessionId, tk, config)));
+    const result = {};
+    const allTools = [];
+    for (let i = 0; i < entries.length; i++) {
+        const [name] = entries[i];
+        result[name] = monetized[i];
+        allTools.push(...monetized[i].tools);
+    }
+    return {
+        toolkits: result,
+        allTools,
+        aggregateMetrics() {
+            const agg = {
+                totalCalls: 0,
+                totalRevenue: 0n,
+                callsByMethod: {},
+                revenueByMethod: {},
+                avgLatencyMs: 0,
+                errors: 0,
+            };
+            let totalLatency = 0;
+            for (const tk of monetized) {
+                agg.totalCalls += tk.metrics.totalCalls;
+                agg.totalRevenue += tk.metrics.totalRevenue;
+                agg.errors += tk.metrics.errors;
+                totalLatency += tk.metrics.avgLatencyMs * tk.metrics.totalCalls;
+                for (const [k, v] of Object.entries(tk.metrics.callsByMethod)) {
+                    agg.callsByMethod[`${tk.protocol}:${k}`] = (agg.callsByMethod[`${tk.protocol}:${k}`] ?? 0) + v;
+                }
+                for (const [k, v] of Object.entries(tk.metrics.revenueByMethod)) {
+                    agg.revenueByMethod[`${tk.protocol}:${k}`] = (agg.revenueByMethod[`${tk.protocol}:${k}`] ?? 0n) + v;
+                }
+            }
+            agg.avgLatencyMs = agg.totalCalls > 0 ? Math.round(totalLatency / agg.totalCalls) : 0;
+            return agg;
+        },
+        disposeAll() {
+            for (const tk of monetized)
+                tk.dispose();
+        },
+    };
+}
+//# sourceMappingURL=monetize.js.map

package/dist/esm/ai/gateway/monetize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monetize.js","sourceRoot":"","sources":["../../../../src/ai/gateway/monetize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAeH;;qEAEqE;AAErE;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAKO;IAJ7C;;;OAGG;IACH,YAAY,OAAe,EAAkB,OAAO,gBAAgB;QAClE,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,SAAI,GAAJ,IAAI,CAAmB;QAElE,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAmID;;qEAEqE;AAErE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAA2B,EAC3B,SAAiB,EACjB,OAAwB,EACxB,SAAyB,EAAE;IAE3B,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,aAAa,CAAC,YAAY,SAAS,aAAa,EAAE,mBAAmB,CAAC,CAAC;IACnF,CAAC;IAED,mEAAmE;IACnE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;IAE/D,MAAM,EACJ,WAAW,GAAG,IAAI,EAClB,iBAAiB,GAAG,aAAa,EACjC,kBAAkB,EAClB,MAAM,GAAG,YAAY,EACrB,MAAM,EACN,WAAW,GAAG,CAAC,WAAW,CAAC,EAC3B,KAAK,GACN,GAAG,MAAM,CAAC;IAEX,2BAA2B;IAC3B,MAAM,OAAO,GAAwB;QACnC,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,EAAE;QAChB,aAAa,EAAE,EAAE;QACjB,eAAe,EAAE,EAAE;QACnB,YAAY,EAAE,CAAC;QACf,MAAM,EAAE,CAAC;KACV,CAAC;IACF,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,+BAA+B;IAC/B,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,MAAM,OAAO,GAAiC,EAAE,CAAC;IAEjD,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACrC,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,YAAY;YAAE,SAAS;QAE5B,MAAM,QAAQ,GAAG,GAAG,MAAM,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAE/D,MAAM,WAAW,GAAG,MAAM,CACxB,KAAK,EAAE,KAAc,EAAE,EAAE;YACvB,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,IAAI,aAAa,CAAC,2BAA2B,EAAE,UAAU,CAAC,CAAC;YACnE,CAAC;YAED,MAAM,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YACrD,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,MAAM,IAAI,aAAa,CAAC,YAAY,SAAS,uBAAuB,EAAE,iBAAiB,CAAC,CAAC;YAC3F,CAAC;YAED,2CAA2C;YAC3C,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAEjD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,mCAAmC;gBACnC,MAAM,SAAS,GAAY,MAAM,YAAY,CAAC,MAAM,CAAC,KAAgC,CAAC,CAAC;gBACvF,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;gBAExD,kDAAkD;gBAClD,IAAI,MAAe,CAAC;gBACpB,IAAI,CAAC;oBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAmB,CAAC,CAAC;gBAC3C,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,GAAG,SAAS,CAAC;gBACrB,CAAC;gBAED,yBAAyB;gBACzB,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC;gBACvC,MAAM,YAAY,GAAG,kBAAkB,IAAI,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC;gBAEzE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,UAAU,CACjD,MAAM,EACN,SAAS,EACT,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,EACpC,KAAgC,EAChC,CAAC,EAAE,sCAAsC;gBACzC,SAAS,EACT,IAAI,CAAC,SAAS,GAAG,CAAC,EAClB,YAAY,CACb,CAAC;gBAEF,sCAAsC;gBACtC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAE3C,4BAA4B;gBAC5B,OAAO,CAAC,UAAU,EAAE,CAAC;gBACrB,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC;gBAC7B,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;gBACnF,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;gBAC3F,iBAAiB,IAAI,SAAS,CAAC;gBAC/B,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;gBAE1E,oCAAoC;gBACpC,OAAO,IAAI,CAAC,SAAS,CAAC;oBACpB,IAAI,EAAE,MAAM;oBACZ,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,IAAI;oBACzC,SAAS;oBACT,SAAS,EAAE,QAAQ,CAAC,SAAS;oBAC7B,OAAO,EAAE,IAAI;oBACb,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,MAAM,EAAE,MAAM,CAAC,IAAI;oBACnB,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE;iBACtB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACd,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,MAAM,EAAE,CAAC;gBACjB,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC,EACD;YACE,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,GAAG,iBAAiB,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,2CAA2C;YACjH,MAAM,EAAE,MAAM,CAAC,KAAqC;SACrD,CACF,CAAC;QAEF,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAG,aAAa;QACnD,OAAO,CAAC,QAAQ,CAAC,GAAG,WAAW,CAAC,CAAO,WAAW;IACpD,CAAC;IAED,uCAAuC;IACvC,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,YAAY,GAAG,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE1C,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACrC,MAAM,OAAO,GAAgB;gBAC3B,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE;gBAC5C,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI;gBAC9C,MAAM,EAAE,OAAO,CAAC,QAAQ;gBACxB,KAAK,EAAE,YAAY;gBACnB,YAAY,EAAE,CAAC;gBACf,aAAa,EAAE,GAAG;gBAClB,WAAW,EAAE,CAAC;gBACd,eAAe,EAAE,GAAG;gBACpB,oBAAoB,EAAE,IAAI;gBAC1B,MAAM;gBACN,WAAW;gBACX,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;gBACpB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC;YACF,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK;QACL,OAAO;QACP,QAAQ,EAAE,OAAO;QACjB,SAAS;QACT,OAAO;QACP,IAAI,QAAQ,KAAK,OAAO,SAAS,CAAC,CAAC,CAAC;QACpC,OAAO;YACL,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;qEAEqE;AAErE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,OAA2B,EAC3B,SAAiB,EACjB,QAAyC,EACzC,SAAyB,EAAE;IAE3B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAC9E,CAAC;IAEF,MAAM,MAAM,GAAqC,EAAE,CAAC;IACpD,MAAM,QAAQ,GAAmB,EAAE,CAAC;IAEpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,MAAM;QAChB,QAAQ;QACR,gBAAgB;YACd,MAAM,GAAG,GAAwB;gBAC/B,UAAU,EAAE,CAAC;gBACb,YAAY,EAAE,EAAE;gBAChB,aAAa,EAAE,EAAE;gBACjB,eAAe,EAAE,EAAE;gBACnB,YAAY,EAAE,CAAC;gBACf,MAAM,EAAE,CAAC;aACV,CAAC;YACF,IAAI,YAAY,GAAG,CAAC,CAAC;YACrB,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;gBAC3B,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC;gBACxC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC;gBAC5C,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;gBAChC,YAAY,IAAI,EAAE,CAAC,OAAO,CAAC,YAAY,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC;gBAChE,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;oBAC9D,GAAG,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;gBACjG,CAAC;gBACD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;oBAChE,GAAG,CAAC,eAAe,CAAC,GAAG,EAAE,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,EAAE,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;gBACtG,CAAC;YACH,CAAC;YACD,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtF,OAAO,GAAG,CAAC;QACb,CAAC;QACD,UAAU;YACR,KAAK,MAAM,EAAE,IAAI,SAAS;gBAAE,EAAE,CAAC,OAAO,EAAE,CAAC;QAC3C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/esm/ai/index.d.ts

@@ -16,7 +16,12 @@
  */
 export { createExecutableSolanaTools, agentRpcMethods, solanaToolNames, type AgentRpcMethod, type SolanaTool, type SolanaToolMap, type SolanaToolkit, type CreateSolanaToolsOpts, } from './tools';
 export { createJupiterTools, createRaydiumTools, createMetaplexTools, createJupiterOnchainTools, createRaydiumOnchainTools, createSolanaProgramsTools, createProtocolTools, jupiterMethods, jupiterMethodNames, raydiumMethods, raydiumMethodNames, metaplexMethods, metaplexMethodNames, jupiterOnchainMethods, jupiterOnchainMethodNames, raydiumOnchainMethods, raydiumOnchainMethodNames, solanaProgramsMethods, solanaProgramsMethodNames, ProtocolHttpClient, ProtocolApiError, buildProtocolTools, createMethodRegistry, JUPITER_API_URL, RAYDIUM_API_URL, JUPITER_PROGRAM_IDS, RAYDIUM_PROGRAM_IDS, type ProtocolMethod, type ProtocolToolkit, type ProtocolTool, type ProtocolClientConfig, type CreateProtocolToolsOpts, type JupiterToolsConfig, type RaydiumToolsConfig, type MetaplexToolsConfig, type JupiterOnchainToolsConfig, type RaydiumOnchainToolsConfig, type SolanaProgramsToolsConfig, type CreateProtocolToolsConfig, type AllProtocolToolkits, } from './tools';
-export { AgentGateway, createAgentGateway, AgentSession, SessionError, BudgetExhaustedError, RateLimitExceededError, SessionExpiredError, CallLimitExceededError, PricingEngine, DEFAULT_TIERS, ResponseValidator, ToolMarketplace, AgentRegistry, MemoryAdapter, type PersistenceAdapter, type AgentRegistryConfig, GatewayError, SessionNotFoundError, MaxSessionsError, IntentVerificationError, type AgentId, type AgentIdentity, type AgentCredential, type PaymentToken, type PricingTier, type PaymentIntent, type PaymentReceipt, type SessionState, type SessionStatus, type ResponseAttestation, type AttestedResult, type ToolListing, type ToolBundle, type GatewayEventType, type GatewayEvent, type GatewayEventHandler, type GatewayConfig, type DynamicPricingConfig, type MarketplaceQuery, type MarketplaceStats, createAgentId, type RetryConfig, type SnapshotDepth, type GatewaySnapshot, type X402PipelineStep, X402Paywall, X402Client, FacilitatorClient, createFacilitator, createX402Client, encodePaymentHeader, decodePaymentHeader, defaultRequirementsSelector, SOLANA_MAINNET, SOLANA_DEVNET, USDC_MAINNET, USDC_DEVNET, X402_HEADER_PAYMENT_REQUIRED, X402_HEADER_PAYMENT_SIGNATURE, X402_HEADER_PAYMENT_RESPONSE, X402_STATUS_CODE, X402_VERSION, FacilitatorError, VerifyError, SettleError, X402ClientError, NoAcceptablePaymentError, PaymentSigningError, PaymentRetryError, FacilitatorDiscovery, type FacilitatorHealthResult, type FindBestOptions, type X402Network, type X402ResourceInfo, type X402PaymentRequirements, type X402PaymentRequired, type X402PaymentPayload, type ExactSvmPayload, type X402VerifyResponse, type X402SettleResponse, type X402SettlementResponse, type X402CreateAuthHeaders, type X402FacilitatorConfig, type X402SupportedKind, type X402SupportedResponse, type X402RouteConfig, type X402Config, type X402PayloadSigner, type X402RequirementsSelector, type X402BudgetCheck, type X402ClientConfig, type X402PaymentOutcome, type PaywallResult, type SettleResult, } from './gateway';
-export { MemoryStore, RedisPersistence, PostgresPersistence, PersistenceError, serialize as serializeForStore, deserialize as deserializeFromStore, buildKey as buildStoreKey, buildSchema as buildPostgresSchema, SCHEMA_VERSION as PERSISTENCE_SCHEMA_VERSION, type PersistenceStore, type RedisLike, type PgLike, type SessionRecord, type ReceiptRecord, type MetricPoint, type SetOptions, type ListOptions, type MetricQueryOpts, type StoreConfig, type RedisStoreConfig, type PostgresStoreConfig, type MemoryStoreConfig, } from './persistence';
+export { AgentGateway, createAgentGateway, AgentSession, SessionError, BudgetExhaustedError, RateLimitExceededError, SessionExpiredError, CallLimitExceededError, PricingEngine, DEFAULT_TIERS, ResponseValidator, ToolMarketplace, AgentRegistry, MemoryAdapter, type PersistenceAdapter, type AgentRegistryConfig, MonetizeError, createMonetizedTools, createMultiProtocolMonetizedTools, type MonetizableGateway, type MonetizeConfig, type MonetizationMetrics, type MonetizedToolkit, type MultiMonetizedResult, GatewayError, SessionNotFoundError, MaxSessionsError, IntentVerificationError, type AgentId, type AgentIdentity, type AgentCredential, type PaymentToken, type PricingTier, type PaymentIntent, type PaymentReceipt, type SessionState, type SessionStatus, type ResponseAttestation, type AttestedResult, type ToolListing, type ToolBundle, type GatewayEventType, type GatewayEvent, type GatewayEventHandler, type GatewayConfig, type DynamicPricingConfig, type MarketplaceQuery, type MarketplaceStats, createAgentId, type RetryConfig, type SnapshotDepth, type GatewaySnapshot, type X402PipelineStep, X402Paywall, X402Client, FacilitatorClient, createFacilitator, createX402Client, encodePaymentHeader, decodePaymentHeader, defaultRequirementsSelector, SOLANA_MAINNET, SOLANA_DEVNET, USDC_MAINNET, USDC_DEVNET, X402_HEADER_PAYMENT_REQUIRED, X402_HEADER_PAYMENT_SIGNATURE, X402_HEADER_PAYMENT_RESPONSE, X402_STATUS_CODE, X402_VERSION, FacilitatorError, VerifyError, SettleError, X402ClientError, NoAcceptablePaymentError, PaymentSigningError, PaymentRetryError, FacilitatorDiscovery, type FacilitatorHealthResult, type FindBestOptions, type X402Network, type X402ResourceInfo, type X402PaymentRequirements, type X402PaymentRequired, type X402PaymentPayload, type ExactSvmPayload, type X402VerifyResponse, type X402SettleResponse, type X402SettlementResponse, type X402CreateAuthHeaders, type X402FacilitatorConfig, type X402SupportedKind, type X402SupportedResponse, type X402RouteConfig, type X402Config, type X402PayloadSigner, type X402RequirementsSelector, type X402BudgetCheck, type X402ClientConfig, type X402PaymentOutcome, type PaywallResult, type SettleResult, } from './gateway';
+export { MemoryStore, RedisPersistence, PostgresPersistence, PersistenceError, serialize as serializeForStore, deserialize as deserializeFromStore, buildKey as buildStoreKey, parseKey as parseStoreKey, extractAgentId as extractStoreAgentId, buildSchema as buildPostgresSchema, buildKvCleanupSql as buildPostgresCleanupSql, SCHEMA_VERSION as PERSISTENCE_SCHEMA_VERSION, type PersistenceStore, type RedisLike, type PgLike, type SessionRecord, type ReceiptRecord, type MetricPoint, type SetOptions, type ListOptions, type MetricQueryOpts, type StoreConfig, type RedisStoreConfig, type PostgresStoreConfig, type MemoryStoreConfig, } from './persistence';
 export { getJupiterTools, getRaydiumTools, } from './lazy';
+export { SAP_DEFAULT_PROGRAM_ID, SAP_SEED_PREFIX, SAP_ACCOUNT_DISCRIMINATOR, SAP_INSTRUCTION_DISCRIMINATORS, pdaToIdentity, pricingToTier, type SAPConfig, type AgentCapability, type AgentPricingOnChain, type AgentReputationOnChain, type AgentPDAAccount, type RegisterAgentParams, type UpdateAgentParams, type UpdateReputationParams, type AgentDiscoveryFilter, type DiscoveryResult, type SAPAggregateMetrics, type SAPInstruction, type SAPAccountMeta, deriveAgentPDA, deserializeAgentAccount, serializeRegisterData, serializeUpdateData, base58Decode, base58Encode, isOnCurve, BorshReader, BorshWriter, type DerivedPDA, SAPInstructionBuilder, SAPProgramError, SAPDiscovery, SAPDiscoveryError, OnChainPersistenceAdapter, } from './sap';
+export { IntentError, CyclicDependencyError, UnresolvedReferenceError, BudgetExceededError as IntentBudgetExceededError, IntentParser, IntentPlanner, IntentExecutor, type IntentProtocol, type StepReference, type IntentStep, type Intent, type IntentOptions, type PlannedStep, type IntentPlan, type StepStatus, type StepResult, type IntentResultStatus, type IntentResult, type IntentConfig, type ValidationResult, type ParserConfig, type PlannerConfig, } from './intents';
+export { ActionServer, ActionServerError, BlinkGenerator, createBlinkFromAction, DEFAULT_RESOLVER_URL, ACTION_SCHEME, type ActionType, type ActionParameter, type LinkedAction, type ActionGetResponse, type ActionPostRequest, type ActionPostResponse, type ActionsJson, type ActionsJsonRule, type ActionHandler, type ActionContext, type ActionDefinition, type ActionServerConfig, type BlinkConfig, type BlinkMetadata, } from './actions';
+export { SynapseAgentKit, TokenPlugin, NFTPlugin, DeFiPlugin, MiscPlugin, BlinksPlugin, type SynapsePlugin, type PluginMeta, type PluginProtocol, type PluginContext, type PluginExecutor, type PluginInstallResult, type InstalledPlugin, type AgentKitConfig, type McpToolDescriptor, type McpResourceDescriptor, } from './plugins';
+export { SynapseMcpServer, McpServerError, McpClientBridge, MCP_PROTOCOL_VERSION, MCP_JSONRPC_VERSION, type JsonRpcRequest, type JsonRpcResponse, type JsonRpcNotification, type McpToolDefinition, type McpToolCallParams, type McpToolCallResult, type McpResourceDefinition, type McpResourceTemplate, type McpPromptDefinition, type McpPromptMessage, type McpServerInfo, type McpCapabilities, type McpTransport, type McpServerConfig, type McpExternalServerConfig, type McpConnectionStatus, } from './mcp';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/ai/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/ai/index.js

@@ -40,6 +40,8 @@ ResponseValidator,
 ToolMarketplace, 
 // Agent Registry
 AgentRegistry, MemoryAdapter, 
+// Monetization Bridge
+MonetizeError, createMonetizedTools, createMultiProtocolMonetizedTools, 
 // Errors
 GatewayError, SessionNotFoundError, MaxSessionsError, IntentVerificationError, createAgentId, 
 // x402 Protocol
@@ -55,7 +57,45 @@ MemoryStore, RedisPersistence, PostgresPersistence,
 // Error
 PersistenceError, 
 // Helpers
-serialize as serializeForStore, deserialize as deserializeFromStore, buildKey as buildStoreKey, buildSchema as buildPostgresSchema, SCHEMA_VERSION as PERSISTENCE_SCHEMA_VERSION, } from './persistence/index.js';
+serialize as serializeForStore, deserialize as deserializeFromStore, buildKey as buildStoreKey, parseKey as parseStoreKey, extractAgentId as extractStoreAgentId, buildSchema as buildPostgresSchema, buildKvCleanupSql as buildPostgresCleanupSql, SCHEMA_VERSION as PERSISTENCE_SCHEMA_VERSION, } from './persistence/index.js';
 // ── Lazy factories (Next.js / webpack compatibility) ──────────
 export { getJupiterTools, getRaydiumTools, } from './lazy.js';
+// ── Solana Agent Protocol (SAP) ───────────────────────────────
+export { 
+// Types
+SAP_DEFAULT_PROGRAM_ID, SAP_SEED_PREFIX, SAP_ACCOUNT_DISCRIMINATOR, SAP_INSTRUCTION_DISCRIMINATORS, pdaToIdentity, pricingToTier, 
+// PDA derivation & serialization
+deriveAgentPDA, deserializeAgentAccount, serializeRegisterData, serializeUpdateData, base58Decode, base58Encode, isOnCurve, BorshReader, BorshWriter, 
+// Instruction builder
+SAPInstructionBuilder, SAPProgramError, 
+// Discovery
+SAPDiscovery, SAPDiscoveryError, 
+// On-chain adapter
+OnChainPersistenceAdapter, } from './sap/index.js';
+// ── Cross-Protocol Intent Resolver ────────────────────────────
+export { 
+// Errors
+IntentError, CyclicDependencyError, UnresolvedReferenceError, BudgetExceededError as IntentBudgetExceededError, 
+// Classes
+IntentParser, IntentPlanner, IntentExecutor, } from './intents/index.js';
+// ── Solana Actions & Blinks ───────────────────────────────────
+export { 
+// Server
+ActionServer, ActionServerError, 
+// Blinks
+BlinkGenerator, createBlinkFromAction, DEFAULT_RESOLVER_URL, ACTION_SCHEME, } from './actions/index.js';
+// ── Plugin System ─────────────────────────────────────────────
+export { 
+// Registry
+SynapseAgentKit, 
+// Plugins
+TokenPlugin, NFTPlugin, DeFiPlugin, MiscPlugin, BlinksPlugin, } from './plugins/index.js';
+// ── MCP (Model Context Protocol) ──────────────────────────────
+export { 
+// Server (expose tools as MCP)
+SynapseMcpServer, McpServerError, 
+// Client Bridge (connect external MCP servers)
+McpClientBridge, 
+// Constants & Types
+MCP_PROTOCOL_VERSION, MCP_JSONRPC_VERSION, } from './mcp/index.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/ai/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,iEAAiE;AACjE,OAAO,EACL,2BAA2B,EAC3B,eAAe,EACf,eAAe,GAMhB,MAAM,SAAS,CAAC;AAEjB,iEAAiE;AACjE,OAAO;AACL,YAAY;AACZ,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB;AACnB,UAAU;AACV,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB;AACzB,wBAAwB;AACxB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB;AACpB,YAAY;AACZ,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,mBAAmB,GAepB,MAAM,SAAS,CAAC;AAEjB,iEAAiE;AACjE,OAAO;AACL,oBAAoB;AACpB,YAAY,EACZ,kBAAkB;AAElB,UAAU;AACV,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB;AAEtB,UAAU;AACV,aAAa,EACb,aAAa;AAEb,cAAc;AACd,iBAAiB;AAEjB,cAAc;AACd,eAAe;AAEf,iBAAiB;AACjB,aAAa,EACb,aAAa;AAIb,SAAS;AACT,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EAuBvB,aAAa;AAMb,gBAAgB;AAChB,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,2BAA2B,EAC3B,cAAc,EACd,aAAa,EACb,YAAY,EACZ,WAAW,EACX,4BAA4B,EAC5B,6BAA6B,EAC7B,4BAA4B,EAC5B,gBAAgB,EAChB,YAAY;AAEZ,cAAc;AACd,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,eAAe,EACf,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB;AAEjB,iBAAiB;AACjB,oBAAoB,GA2BrB,MAAM,WAAW,CAAC;AAEnB,gEAAgE;AAChE,OAAO;AACL,WAAW;AACX,WAAW,EACX,gBAAgB,EAChB,mBAAmB;AAEnB,QAAQ;AACR,gBAAgB;AAEhB,UAAU;AACV,SAAS,IAAI,iBAAiB,EAC9B,WAAW,IAAI,oBAAoB,EACnC,QAAQ,IAAI,aAAa,EACzB,WAAW,IAAI,mBAAmB,EAClC,cAAc,IAAI,0BAA0B,GAgB7C,MAAM,eAAe,CAAC;AAEvB,iEAAiE;AACjE,OAAO,EACL,eAAe,EACf,eAAe,GAChB,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/ai/intents/executor.d.ts

@@ -0,0 +1,102 @@
+/**
+ * @module ai/intents/executor
+ * @description Cross-Protocol Intent Executor — runs planned intents step-by-step.
+ *
+ * Resolves `$stepId.field` references, invokes protocol tools, tracks
+ * costs, generates attestations, and handles failure/rollback semantics.
+ *
+ * @example
+ * ```ts
+ * import { IntentParser, IntentPlanner, IntentExecutor } from '@oobe-protocol-labs/synapse-client-sdk/ai';
+ *
+ * const parser = new IntentParser();
+ * const planner = new IntentPlanner();
+ * const executor = new IntentExecutor({
+ *   protocolTools: {
+ *     jupiter: jupiterToolkit.toolMap,
+ *     raydium: raydiumToolkit.toolMap,
+ *   },
+ * });
+ *
+ * const { intent } = parser.parse(myIntent);
+ * const plan = planner.plan(intent);
+ * const result = await executor.execute(plan);
+ *
+ * console.log(`Status: ${result.status}`);
+ * console.log(`Total cost: ${result.totalCost}`);
+ * for (const step of result.steps) {
+ *   console.log(`  ${step.stepId}: ${step.status} (${step.latencyMs}ms)`);
+ * }
+ * ```
+ *
+ * @since 1.3.0
+ */
+import type { IntentPlan, IntentResult, IntentConfig, IntentOptions } from './types';
+/**
+ * @description Executes intent plans step-by-step with reference resolution,
+ * budget tracking, attestation, and failure handling.
+ *
+ * Execution modes:
+ * - **Sequential**: Steps are executed in topological order
+ * - **Simulate**: All steps are dry-run (tools are called but results are marked as simulated)
+ * - **Atomic**: On failure, all completed steps are marked as requiring rollback
+ *
+ * @since 1.3.0
+ */
+export declare class IntentExecutor {
+    private readonly config;
+    private readonly defaultTimeout;
+    private readonly maxSteps;
+    /**
+     * @param {IntentConfig} config - Executor configuration with protocol tools
+     */
+    constructor(config: IntentConfig);
+    /**
+     * @description Execute an intent plan step-by-step.
+     *
+     * Steps are executed in topological order. At each step:
+     * 1. Resolve `$ref` params from previous step outputs
+     * 2. Check budget (if `maxBudget` is set)
+     * 3. Invoke the protocol tool
+     * 4. Parse output and record result
+     * 5. Call `onStepComplete` / `onStepError` callbacks
+     *
+     * @param {IntentPlan} plan - Execution plan from {@link IntentPlanner.plan}
+     * @param {IntentOptions} [options] - Execution options (override intent-level options)
+     * @returns {Promise<IntentResult>} Execution result with per-step details
+     *
+     * @example
+     * ```ts
+     * const result = await executor.execute(plan, { simulate: true });
+     * if (result.status === 'completed') {
+     *   console.log('All steps succeeded!');
+     * }
+     * ```
+     *
+     * @since 1.3.0
+     */
+    execute(plan: IntentPlan, options?: IntentOptions): Promise<IntentResult>;
+    /**
+     * @description Simulate an intent plan (dry-run). All tools are called
+     * but results are marked as `simulated`.
+     *
+     * @param {IntentPlan} plan - Execution plan
+     * @param {IntentOptions} [options] - Additional options
+     * @returns {Promise<IntentResult>} Simulated result
+     *
+     * @since 1.3.0
+     */
+    simulate(plan: IntentPlan, options?: IntentOptions): Promise<IntentResult>;
+    /**
+     * @description Execute atomically — if any required step fails, stop immediately.
+     *
+     * @param {IntentPlan} plan - Execution plan
+     * @param {IntentOptions} [options] - Additional options
+     * @returns {Promise<IntentResult>} Execution result
+     *
+     * @since 1.3.0
+     */
+    executeAtomic(plan: IntentPlan, options?: IntentOptions): Promise<IntentResult>;
+    private executeStep;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/esm/ai/intents/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../../src/ai/intents/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EACV,UAAU,EAGV,YAAY,EACZ,YAAY,EACZ,aAAa,EAGd,MAAM,SAAS,CAAC;AA4EjB;;;;;;;;;;GAUG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC;;OAEG;gBACS,MAAM,EAAE,YAAY;IAMhC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IA0H/E;;;;;;;;;OASG;IACG,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAIhF;;;;;;;;OAQG;IACG,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;YAMvE,WAAW;CAqE1B"}