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

package/dist/esm/ai/gateway/monetize.d.ts

@@ -0,0 +1,222 @@
+/**
+ * @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
+ */
+import type { AgentId, AgentIdentity, PricingTier } from './types';
+import type { AgentSession } from './session';
+import type { ResponseValidator } from './validator';
+import type { ToolMarketplace } from './marketplace';
+import type { ProtocolToolkit, ProtocolTool } from '../tools/protocols/shared';
+/**
+ * @description Error class for monetization-related failures.
+ * @since 1.3.0
+ */
+export declare class MonetizeError extends Error {
+    readonly code: string;
+    /**
+     * @param {string} message - Human-readable error message
+     * @param {string} [code='MONETIZE_ERROR'] - Machine-readable error code
+     */
+    constructor(message: string, code?: string);
+}
+/**
+ * @description Interface satisfied by {@link AgentGateway}. Avoids circular
+ * dependency while giving `createMonetizedTools` full access to the
+ * session, validator, and marketplace subsystems.
+ *
+ * @since 1.3.0
+ */
+export interface MonetizableGateway {
+    /** Seller's unique agent identifier. */
+    readonly agentId: AgentId;
+    /** Seller's full identity (name, wallet, tags). */
+    readonly identity: AgentIdentity;
+    /** Proof-of-Computation engine. */
+    readonly validator: ResponseValidator;
+    /** Decentralized tool marketplace. */
+    readonly marketplace: ToolMarketplace;
+    /** Look up a live session by ID. Returns `undefined` if not found. */
+    getSession(sessionId: string): AgentSession | undefined;
+}
+/**
+ * @description Configuration for {@link createMonetizedTools}.
+ * @since 1.3.0
+ */
+export interface MonetizeConfig {
+    /**
+     * If `true`, each monetized tool is automatically listed on the
+     * gateway's {@link ToolMarketplace}.
+     * @default true
+     */
+    autoPublish?: boolean;
+    /**
+     * Description prefix prepended to every tool description.
+     * @default '[Monetized]'
+     */
+    descriptionPrefix?: string;
+    /**
+     * Force attestation on/off regardless of the session tier.
+     * When `undefined`, inherits the tier's `includesAttestation` flag.
+     */
+    includeAttestation?: boolean;
+    /**
+     * Tool name prefix. Each tool will be named `<prefix><protocol>_<method>`.
+     * @default 'monetized_'
+     */
+    prefix?: string;
+    /**
+     * Region hint added to marketplace listings.
+     * @default undefined
+     */
+    region?: string;
+    /**
+     * Commitment levels advertised in marketplace listings.
+     * @default ['confirmed']
+     */
+    commitments?: ('processed' | 'confirmed' | 'finalized')[];
+    /**
+     * Pricing tiers to advertise when auto-publishing.
+     * When omitted, the session's current tier is used.
+     */
+    tiers?: PricingTier[];
+}
+/**
+ * @description Live monetization counters tracked per-toolkit.
+ * @since 1.3.0
+ */
+export interface MonetizationMetrics {
+    /** Total successful calls across all tools. */
+    totalCalls: number;
+    /** Cumulative revenue (smallest token unit). */
+    totalRevenue: bigint;
+    /** Call count keyed by method name. */
+    callsByMethod: Record<string, number>;
+    /** Revenue keyed by method name. */
+    revenueByMethod: Record<string, bigint>;
+    /** Running average latency (ms). */
+    avgLatencyMs: number;
+    /** Total failed invocations. */
+    errors: number;
+}
+/**
+ * @description Return type of {@link createMonetizedTools}. Extends
+ * the toolkit concept with commerce metadata and lifecycle control.
+ *
+ * @since 1.3.0
+ */
+export interface MonetizedToolkit {
+    /** Protocol identifier (e.g. `'jupiter'`). */
+    protocol: string;
+    /** Monetized LangChain-compatible tools. */
+    tools: ProtocolTool[];
+    /** Keyed tool map (both prefixed and unprefixed keys). */
+    toolMap: Record<string, ProtocolTool>;
+    /** Reference to the unwrapped original toolkit. */
+    original: ProtocolToolkit;
+    /** Session this toolkit is bound to. */
+    sessionId: string;
+    /** Live monetization metrics (updates on every call). */
+    metrics: Readonly<MonetizationMetrics>;
+    /**
+     * Stop metering and reject all future calls.
+     * Idempotent — calling twice is a no-op.
+     */
+    dispose(): void;
+    /** Whether this toolkit has been disposed. */
+    readonly disposed: boolean;
+}
+/**
+ * @description Result of {@link createMultiProtocolMonetizedTools}.
+ * @since 1.3.0
+ */
+export interface MultiMonetizedResult {
+    /** Per-protocol toolkits. */
+    toolkits: Record<string, MonetizedToolkit>;
+    /** Flat array of every monetized tool across all protocols. */
+    allTools: ProtocolTool[];
+    /** Aggregate metrics across all protocols. */
+    aggregateMetrics(): MonetizationMetrics;
+    /** Dispose all toolkits at once. */
+    disposeAll(): void;
+}
+/**
+ * @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 declare function createMonetizedTools(gateway: MonetizableGateway, sessionId: string, toolkit: ProtocolToolkit, config?: MonetizeConfig): Promise<MonetizedToolkit>;
+/**
+ * @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 declare function createMultiProtocolMonetizedTools(gateway: MonetizableGateway, sessionId: string, toolkits: Record<string, ProtocolToolkit>, config?: MonetizeConfig): Promise<MultiMonetizedResult>;
+//# sourceMappingURL=monetize.d.ts.map

package/dist/esm/ai/gateway/monetize.d.ts.map

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

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":"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"}