@andrewkimjoseph/celina-sdk 0.15.1 → 0.15.2

package/build/src/tools/schemas/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../../src/tools/schemas/common.ts"],"names":[],"mappings":"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"}

package/build/src/tools/schemas/wallet-params.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+export type RequireWalletParamsOptions = {
+    /** Quote tools stay wallet-free; do not promote optional `from`. */
+    toolName?: string;
+    /** Hosted MCP: wallet optional when any of these fields is provided instead. */
+    walletAlternatives?: readonly string[];
+};
+/** Require explicit wallet params when no MCP server signer is configured (hosted MCP). */
+export declare function requireWalletParamsInInputSchema(schema: z.ZodTypeAny, options?: RequireWalletParamsOptions): z.ZodTypeAny;

package/build/src/tools/schemas/wallet-params.js

@@ -0,0 +1,52 @@
+import { z } from "zod";
+import { requiredWalletAddressSchema, WALLET_PARAM_KEYS, } from "./common.js";
+function hasNonEmptyField(data, key) {
+    const value = data[key];
+    return value !== undefined && value !== null && value !== "";
+}
+/** Require explicit wallet params when no MCP server signer is configured (hosted MCP). */
+export function requireWalletParamsInInputSchema(schema, options = {}) {
+    if (!(schema instanceof z.ZodObject)) {
+        return schema;
+    }
+    const skipFrom = options.toolName?.endsWith("_quote") ?? false;
+    const walletAlternatives = options.walletAlternatives ?? [];
+    const useWalletOrAlternatives = walletAlternatives.length > 0;
+    const shape = { ...schema.shape };
+    let changed = false;
+    for (const key of WALLET_PARAM_KEYS) {
+        if (skipFrom && key === "from") {
+            continue;
+        }
+        if (!(key in shape)) {
+            continue;
+        }
+        const field = shape[key];
+        if (field instanceof z.ZodOptional) {
+            if (useWalletOrAlternatives) {
+                continue;
+            }
+            shape[key] = requiredWalletAddressSchema;
+            changed = true;
+        }
+    }
+    const passthrough = schema._def.unknownKeys === "passthrough";
+    let result = changed
+        ? passthrough
+            ? z.object(shape).passthrough()
+            : z.object(shape)
+        : schema;
+    if (useWalletOrAlternatives) {
+        const walletKeys = WALLET_PARAM_KEYS.filter((key) => key in shape);
+        result = result.refine((data) => {
+            const record = data;
+            const hasWallet = walletKeys.some((key) => hasNonEmptyField(record, key));
+            const hasAlternative = walletAlternatives.some((key) => hasNonEmptyField(record, key));
+            return hasWallet || hasAlternative;
+        }, {
+            message: `Provide ${[...walletKeys, ...walletAlternatives].join(" or ")}`,
+        });
+    }
+    return result;
+}
+//# sourceMappingURL=wallet-params.js.map

package/build/src/tools/schemas/wallet-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-params.js","sourceRoot":"","sources":["../../../../src/tools/schemas/wallet-params.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,aAAa,CAAC;AASrB,SAAS,gBAAgB,CAAC,IAA6B,EAAE,GAAW;IAClE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;AAC/D,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,gCAAgC,CAC9C,MAAoB,EACpB,UAAsC,EAAE;IAExC,IAAI,CAAC,CAAC,MAAM,YAAY,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;QACrC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC;IAC/D,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,IAAI,EAAE,CAAC;IAC5D,MAAM,uBAAuB,GAAG,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;IAClC,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACpC,IAAI,QAAQ,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YAC/B,SAAS;QACX,CAAC;QACD,IAAI,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,EAAE,CAAC;YACpB,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,KAAK,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;YACnC,IAAI,uBAAuB,EAAE,CAAC;gBAC5B,SAAS;YACX,CAAC;YACD,KAAK,CAAC,GAAG,CAAC,GAAG,2BAA2B,CAAC;YACzC,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,KAAK,aAAa,CAAC;IAC9D,IAAI,MAAM,GAAiB,OAAO;QAChC,CAAC,CAAC,WAAW;YACX,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE;YAC/B,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QACnB,CAAC,CAAC,MAAM,CAAC;IAEX,IAAI,uBAAuB,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;QACnE,MAAM,GAAG,MAAM,CAAC,MAAM,CACpB,CAAC,IAAI,EAAE,EAAE;YACP,MAAM,MAAM,GAAG,IAA+B,CAAC;YAC/C,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;YAC1E,MAAM,cAAc,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CACrD,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,CAC9B,CAAC;YACF,OAAO,SAAS,IAAI,cAAc,CAAC;QACrC,CAAC,EACD;YACE,OAAO,EAAE,WAAW,CAAC,GAAG,UAAU,EAAE,GAAG,kBAAkB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;SAC1E,CACF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/build/src/tools/swap-routing.d.ts

@@ -0,0 +1,25 @@
+import type { CelinaClient } from "../index.js";
+export type SwapProtocol = "mento_fx" | "uniswap_v4" | "gooddollar_reserve";
+export interface SwapQuoteResult {
+    protocol: SwapProtocol;
+    tokenIn: string;
+    tokenOut: string;
+    amountIn: string;
+    expectedOut: string;
+    routeHops: number;
+    network: "mainnet";
+    alternatives?: Array<{
+        protocol: SwapProtocol;
+        expectedOut: string;
+        error?: string;
+    }>;
+}
+export interface SwapPrepareParams {
+    recipient?: `0x${string}`;
+    slippageTolerance?: number;
+    deadlineMinutes?: number;
+    amountSide?: "in" | "out";
+}
+/** Quote a swap across Mento FX, GoodDollar reserve, and Uniswap v4; returns the best route. */
+export declare function getSwapQuoteWithFallback(celina: CelinaClient, tokenIn: string, tokenOut: string, amount: string, from?: `0x${string}`): Promise<SwapQuoteResult>;
+export declare function prepareSwapWithFallback(celina: CelinaClient, from: `0x${string}`, tokenIn: string, tokenOut: string, amount: string, params?: SwapPrepareParams, protocol?: SwapProtocol): Promise<import("../index.js").SerializedPreparedFlow>;

package/build/src/tools/swap-routing.js

@@ -0,0 +1,174 @@
+import { isGoodDollarUsdReservePair } from "../config/gooddollar.js";
+function parseExpectedOut(value) {
+    const n = Number(value.replace(/,/g, ""));
+    return Number.isFinite(n) ? n : 0;
+}
+function isMentoMarketClosedError(message) {
+    return /mento fx market is currently closed/i.test(message);
+}
+function isMentoRouteError(message) {
+    return /no mento fx route/i.test(message);
+}
+function isUniswapRouteError(message) {
+    return /no uniswap v4 route|insufficient liquidity in uniswap v4/i.test(message);
+}
+function isGoodDollarReserveRouteError(message) {
+    return /no gooddollar reserve route/i.test(message);
+}
+function isInsufficientBalanceError(message) {
+    return /insufficient .+ balance/i.test(message);
+}
+function rejectionMessage(reason) {
+    return reason instanceof Error ? reason.message : String(reason);
+}
+function filterAlternatives(best, others) {
+    if (best.protocol !== "gooddollar_reserve") {
+        return others;
+    }
+    const bestOut = parseExpectedOut(best.expectedOut);
+    if (bestOut <= 0) {
+        return others;
+    }
+    return others.filter((alt) => {
+        if (alt.protocol !== "uniswap_v4" || alt.error) {
+            return true;
+        }
+        const altOut = parseExpectedOut(alt.expectedOut);
+        return altOut >= bestOut * 0.95;
+    });
+}
+async function tryMentoQuote(celina, tokenIn, tokenOut, amount, from) {
+    const quote = await celina.mentoFx.getFxQuote(tokenIn, tokenOut, amount, from);
+    return {
+        protocol: "mento_fx",
+        tokenIn: quote.tokenIn,
+        tokenOut: quote.tokenOut,
+        amountIn: quote.amountIn,
+        expectedOut: quote.expectedOut,
+        routeHops: quote.routeHops,
+        network: quote.network,
+    };
+}
+async function tryUniswapQuote(celina, tokenIn, tokenOut, amount, from) {
+    const quote = await celina.uniswap.getSwapQuote(tokenIn, tokenOut, amount, from);
+    return {
+        protocol: "uniswap_v4",
+        tokenIn: quote.tokenIn,
+        tokenOut: quote.tokenOut,
+        amountIn: quote.amountIn,
+        expectedOut: quote.expectedOut,
+        routeHops: quote.routeHops,
+        network: quote.network,
+    };
+}
+async function tryGoodDollarReserveQuote(celina, tokenIn, tokenOut, amount, from) {
+    const quote = await celina.gooddollar.getReserveQuote(tokenIn, tokenOut, amount, { from });
+    return {
+        protocol: "gooddollar_reserve",
+        tokenIn: quote.tokenIn,
+        tokenOut: quote.tokenOut,
+        amountIn: quote.amountIn,
+        expectedOut: quote.expectedOut,
+        routeHops: quote.routeHops,
+        network: quote.network,
+    };
+}
+/** Quote a swap across Mento FX, GoodDollar reserve, and Uniswap v4; returns the best route. */
+export async function getSwapQuoteWithFallback(celina, tokenIn, tokenOut, amount, from) {
+    const reserveEligible = isGoodDollarUsdReservePair(tokenIn, tokenOut);
+    const quoteTasks = [
+        tryMentoQuote(celina, tokenIn, tokenOut, amount, from),
+        tryUniswapQuote(celina, tokenIn, tokenOut, amount, from),
+    ];
+    if (reserveEligible) {
+        quoteTasks.push(tryGoodDollarReserveQuote(celina, tokenIn, tokenOut, amount, from));
+    }
+    const results = await Promise.allSettled(quoteTasks);
+    const mentoResult = results[0];
+    const uniswapResult = results[1];
+    const reserveResult = reserveEligible ? results[2] : undefined;
+    const successes = [];
+    const alternatives = [];
+    if (mentoResult.status === "fulfilled") {
+        successes.push(mentoResult.value);
+    }
+    else {
+        const message = rejectionMessage(mentoResult.reason);
+        if (!isMentoRouteError(message)) {
+            alternatives.push({ protocol: "mento_fx", expectedOut: "0", error: message });
+        }
+    }
+    if (uniswapResult.status === "fulfilled") {
+        successes.push(uniswapResult.value);
+    }
+    else {
+        const message = rejectionMessage(uniswapResult.reason);
+        if (!isUniswapRouteError(message)) {
+            alternatives.push({ protocol: "uniswap_v4", expectedOut: "0", error: message });
+        }
+    }
+    if (reserveResult) {
+        if (reserveResult.status === "fulfilled") {
+            successes.push(reserveResult.value);
+        }
+        else {
+            const message = rejectionMessage(reserveResult.reason);
+            if (!isGoodDollarReserveRouteError(message)) {
+                alternatives.push({
+                    protocol: "gooddollar_reserve",
+                    expectedOut: "0",
+                    error: message,
+                });
+            }
+        }
+    }
+    if (successes.length === 0) {
+        const failures = results
+            .filter((result) => result.status === "rejected")
+            .map((result) => rejectionMessage(result.reason));
+        const balanceError = failures.find(isInsufficientBalanceError);
+        if (balanceError) {
+            throw new Error(balanceError);
+        }
+        const marketClosedError = failures.find(isMentoMarketClosedError);
+        if (marketClosedError) {
+            throw new Error(marketClosedError);
+        }
+        throw new Error(`No swap route for ${tokenIn} → ${tokenOut} via Mento FX, GoodDollar reserve, or Uniswap v4.`);
+    }
+    successes.sort((a, b) => parseExpectedOut(b.expectedOut) - parseExpectedOut(a.expectedOut));
+    const best = successes[0];
+    const otherProtocols = filterAlternatives(best, successes.slice(1).map((q) => ({
+        protocol: q.protocol,
+        expectedOut: q.expectedOut,
+    })));
+    return {
+        ...best,
+        alternatives: otherProtocols.length > 0 ? otherProtocols : alternatives,
+    };
+}
+export async function prepareSwapWithFallback(celina, from, tokenIn, tokenOut, amount, params, protocol) {
+    const chosen = protocol ??
+        (await getSwapQuoteWithFallback(celina, tokenIn, tokenOut, amount, from))
+            .protocol;
+    if (chosen === "mento_fx") {
+        return celina.mentoFx.prepareFx(from, tokenIn, tokenOut, amount, {
+            recipient: params?.recipient,
+            slippageTolerance: params?.slippageTolerance,
+            deadlineMinutes: params?.deadlineMinutes,
+        });
+    }
+    if (chosen === "gooddollar_reserve") {
+        return celina.gooddollar.prepareReserveSwap(from, tokenIn, tokenOut, amount, {
+            recipient: params?.recipient,
+            slippageTolerance: params?.slippageTolerance,
+            amountSide: params?.amountSide,
+        });
+    }
+    return celina.uniswap.prepareSwap(from, tokenIn, tokenOut, amount, {
+        recipient: params?.recipient,
+        slippageTolerance: params?.slippageTolerance,
+        deadlineMinutes: params?.deadlineMinutes,
+    });
+}
+//# sourceMappingURL=swap-routing.js.map

package/build/src/tools/swap-routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swap-routing.js","sourceRoot":"","sources":["../../../src/tools/swap-routing.ts"],"names":[],"mappings":"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"}

package/build/src/tools/types.d.ts

@@ -0,0 +1,124 @@
+import type { z } from "zod";
+import type { CelinaClient } from "../index.js";
+export type ToolSurface = "mcp" | "browser";
+export type ToolFamily = "read" | "prepare" | "execute";
+export type ToolEnvRequirement = "CELO_PRIVATE_KEY" | "SELF_AGENT_PRIVATE_KEY" | "SELF_SESSION";
+export type WalletInput = {
+    address?: string;
+    wallet_address?: string;
+    from?: string;
+};
+export type McpToolAnnotations = {
+    readOnlyHint?: boolean;
+    idempotentHint?: boolean;
+    destructiveHint?: boolean;
+    openWorldHint?: boolean;
+};
+export type McpToolMeta = {
+    title?: string;
+    annotations?: McpToolAnnotations;
+    /** MCP adapter uses okSelfSession for QR registration flows. */
+    responseKind?: "default" | "self_session";
+};
+export type ToolRuntimeHooks = {
+    beforePrepareSend?: (params: {
+        sender: `0x${string}`;
+        token: string;
+        amount: string;
+    }) => Promise<void>;
+};
+export type TransactionExecutors = {
+    estimateSend: (to: `0x${string}`, token: string, amount: string) => Promise<unknown>;
+    sendToken: (to: `0x${string}`, token: string, amount: string) => Promise<unknown>;
+};
+export type MentoFxExecutors = {
+    estimate: (tokenIn: string, tokenOut: string, amount: string, options?: {
+        recipient?: `0x${string}`;
+        slippageTolerance?: number;
+        deadlineMinutes?: number;
+    }) => Promise<unknown>;
+    execute: (tokenIn: string, tokenOut: string, amount: string, options?: {
+        recipient?: `0x${string}`;
+        slippageTolerance?: number;
+        deadlineMinutes?: number;
+    }) => Promise<unknown>;
+};
+export type UniswapExecutors = {
+    estimate: (tokenIn: string, tokenOut: string, amount: string, options?: {
+        recipient?: `0x${string}`;
+        slippageTolerance?: number;
+        deadlineMinutes?: number;
+    }) => Promise<unknown>;
+    execute: (tokenIn: string, tokenOut: string, amount: string, options?: {
+        recipient?: `0x${string}`;
+        slippageTolerance?: number;
+        deadlineMinutes?: number;
+    }) => Promise<unknown>;
+};
+export type AaveExecutors = {
+    supply: (token: string, amount: string) => Promise<unknown>;
+    withdraw: (token: string, amount?: string, withdrawMax?: boolean) => Promise<unknown>;
+};
+export type GoodDollarWriteExecutors = {
+    claimDailyUbi: () => Promise<unknown>;
+    estimateReserveSwap: (tokenIn: string, tokenOut: string, amount: string, options?: {
+        recipient?: `0x${string}`;
+        slippageTolerance?: number;
+    }) => Promise<unknown>;
+    executeReserveSwap: (tokenIn: string, tokenOut: string, amount: string, options?: {
+        recipient?: `0x${string}`;
+        slippageTolerance?: number;
+    }) => Promise<unknown>;
+};
+export type SelfExecutors = {
+    verifyAgent: (args: Record<string, unknown>) => Promise<unknown>;
+    lookupAgent: (agentId: number) => Promise<unknown>;
+    verifyRequest: (args: Record<string, unknown>) => Promise<unknown>;
+    registerAgent: (args: Record<string, unknown>) => Promise<unknown>;
+    checkRegistration: (sessionId: string) => Promise<unknown>;
+    getIdentity: () => Promise<unknown>;
+    refreshProof: (args: Record<string, unknown>) => Promise<unknown>;
+    deregisterAgent: () => Promise<unknown>;
+    signRequest: (args: Record<string, unknown>) => Promise<unknown>;
+    authenticatedFetch: (args: Record<string, unknown>) => Promise<unknown>;
+};
+export type ToolRuntimeExecutors = {
+    transaction?: TransactionExecutors;
+    mentoFx?: MentoFxExecutors;
+    uniswap?: UniswapExecutors;
+    aave?: AaveExecutors;
+    gooddollarWrite?: GoodDollarWriteExecutors;
+    self?: SelfExecutors;
+};
+export interface ToolRuntime {
+    celina: CelinaClient;
+    resolveWallet: (input?: WalletInput) => `0x${string}`;
+    hooks?: ToolRuntimeHooks;
+    executors?: ToolRuntimeExecutors;
+    /** MCP session wallet metadata for get_wallet_address. */
+    mcpWallet?: {
+        address: `0x${string}`;
+        hasWallet: boolean;
+    };
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: z.ZodTypeAny;
+    families: ToolFamily[];
+    surfaces?: ToolSurface[];
+    requiresEnv?: ToolEnvRequirement[];
+    mcp?: McpToolMeta;
+    handler: (runtime: ToolRuntime, input: Record<string, unknown>) => Promise<unknown>;
+}
+export type FilterToolsOptions = {
+    surface?: ToolSurface;
+    families?: ToolFamily[];
+    names?: string[];
+    /** When false, omit tools that require CELO_PRIVATE_KEY or SELF_AGENT_PRIVATE_KEY. Default true. */
+    serverKeyToolsEnabled?: boolean;
+    /** When false, omit Self registration session tools. Default true. */
+    selfSessionToolsEnabled?: boolean;
+    /** When false, omit estimate_* gas simulation tools. Default true. */
+    estimateToolsEnabled?: boolean;
+};

package/build/src/tools/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/src/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/types.ts"],"names":[],"mappings":""}

package/build/src/tools/utils/normalize-token.d.ts

@@ -0,0 +1,2 @@
+/** Normalize common LLM token shorthands before registry lookup. */
+export declare function normalizeRegistryTokenInput(token: string): string;

package/build/src/tools/utils/normalize-token.js

@@ -0,0 +1,12 @@
+const REGISTRY_ALIASES = {
+    GD: "GoodDollar",
+    "G$": "GoodDollar",
+    GOODDOLLAR: "GoodDollar",
+};
+/** Normalize common LLM token shorthands before registry lookup. */
+export function normalizeRegistryTokenInput(token) {
+    const trimmed = token.trim();
+    const upper = trimmed.toUpperCase();
+    return REGISTRY_ALIASES[upper] ?? REGISTRY_ALIASES[trimmed] ?? trimmed;
+}
+//# sourceMappingURL=normalize-token.js.map

package/build/src/tools/utils/normalize-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-token.js","sourceRoot":"","sources":["../../../../src/tools/utils/normalize-token.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAA2B;IAC/C,EAAE,EAAE,YAAY;IAChB,IAAI,EAAE,YAAY;IAClB,UAAU,EAAE,YAAY;CACzB,CAAC;AAEF,oEAAoE;AACpE,MAAM,UAAU,2BAA2B,CAAC,KAAa;IACvD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO,gBAAgB,CAAC,KAAK,CAAC,IAAI,gBAAgB,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC;AACzE,CAAC"}

package/build/src/tools/utils/wallet.d.ts

@@ -0,0 +1,4 @@
+import type { ToolRuntime, WalletInput } from "../types.js";
+export declare function resolveWalletFromRuntime(runtime: ToolRuntime, input?: WalletInput): `0x${string}`;
+/** Use MCP server signer for estimates only when a wallet is configured and no explicit from. */
+export declare function useMcpServerExecutor(runtime: ToolRuntime, explicitFrom?: string): boolean;

package/build/src/tools/utils/wallet.js

@@ -0,0 +1,8 @@
+export function resolveWalletFromRuntime(runtime, input) {
+    return runtime.resolveWallet(input);
+}
+/** Use MCP server signer for estimates only when a wallet is configured and no explicit from. */
+export function useMcpServerExecutor(runtime, explicitFrom) {
+    return Boolean(runtime.mcpWallet?.hasWallet && !explicitFrom);
+}
+//# sourceMappingURL=wallet.js.map

package/build/src/tools/utils/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../../../src/tools/utils/wallet.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,wBAAwB,CACtC,OAAoB,EACpB,KAAmB;IAEnB,OAAO,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,oBAAoB,CAClC,OAAoB,EACpB,YAAqB;IAErB,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,IAAI,CAAC,YAAY,CAAC,CAAC;AAChE,CAAC"}

package/build/src/tools/website-sync.d.ts

@@ -0,0 +1,28 @@
+import type { FilterToolsOptions, ToolDefinition } from "./types.js";
+export type WebsiteToolCategory = "Blockchain" | "Account" | "Token" | "Transaction" | "Mento FX" | "Uniswap" | "Wallet" | "GoodDollar" | "Aave" | "Self" | "Governance" | "Staking" | "NFT" | "Contract" | "AgentKarma";
+export type WebsiteToolKind = "read" | "write";
+export type WebsiteToolAvailability = "hosted" | "stdio" | "both";
+export interface WebsiteToolBaseline {
+    name: string;
+    slug: string;
+    title: string;
+    summary: string;
+    description: string;
+    kind: WebsiteToolKind;
+    category: WebsiteToolCategory;
+    inputs: Array<{
+        name: string;
+        type: string;
+        required?: boolean;
+        description: string;
+    }>;
+}
+export declare const HOSTED_MCP_FILTER: FilterToolsOptions;
+export declare const TOOL_CATEGORY_BY_NAME: Record<string, WebsiteToolCategory>;
+export declare function toWebsiteToolBaseline(definition: ToolDefinition): WebsiteToolBaseline;
+export declare function deriveToolAvailability(definition: ToolDefinition): WebsiteToolAvailability;
+export declare function getHostedMcpToolDefinitions(): ToolDefinition[];
+export declare function getHostedMcpToolNames(): string[];
+export declare function getHostedMcpToolCount(): number;
+export declare function getWebsiteToolBaselines(): WebsiteToolBaseline[];
+export declare function getMcpToolNameSet(): Set<string>;