keyring-agent-core 0.1.0

package/dist/services/swap/affiliate.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProviderByChain = getProviderByChain;
+exports.getAffiliateFee = getAffiliateFee;
+const AFFILIATE_SETTING_URL = 'https://exchange-api.keyring.app/admin/setting?configs=others';
+const PROVIDER_MAP_URL_PROD = 'https://api.coinpool.app/config/bridgeProviderByChain';
+const PROVIDER_MAP_URL_DEV = 'https://coinpool-api-op.bacoor-test001.xyz/config/bridgeProviderByChain';
+function memoize(loader) {
+    let cached = null;
+    let pending = null;
+    return async () => {
+        if (cached)
+            return cached;
+        if (pending)
+            return pending;
+        pending = (async () => {
+            try {
+                const result = await loader();
+                cached = result;
+                return cached;
+            }
+            catch {
+                return null;
+            }
+            finally {
+                pending = null;
+            }
+        })();
+        return pending;
+    };
+}
+async function fetchJson(url) {
+    const res = await fetch(url, {
+        method: 'GET',
+        headers: { Accept: 'application/json' },
+    });
+    return (await res.json());
+}
+const fetchAffiliateOthers = memoize(async () => {
+    const json = await fetchJson(AFFILIATE_SETTING_URL);
+    return json?.others ?? null;
+});
+const providerMapCache = {
+    prod: null,
+    dev: null,
+};
+const providerMapPending = { prod: null, dev: null };
+async function fetchProviderMap(isProduction) {
+    const key = isProduction ? 'prod' : 'dev';
+    if (providerMapCache[key])
+        return providerMapCache[key];
+    if (providerMapPending[key])
+        return providerMapPending[key];
+    const url = isProduction ? PROVIDER_MAP_URL_PROD : PROVIDER_MAP_URL_DEV;
+    providerMapPending[key] = (async () => {
+        try {
+            const json = await fetchJson(url);
+            providerMapCache[key] = json?.data ?? null;
+            return providerMapCache[key];
+        }
+        catch {
+            return null;
+        }
+        finally {
+            providerMapPending[key] = null;
+        }
+    })();
+    return providerMapPending[key];
+}
+function parseRecipientMap(raw) {
+    if (!raw)
+        return null;
+    try {
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === 'object' ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function toPercent(value) {
+    if (value === undefined || value === null)
+        return 0;
+    const n = typeof value === 'number' ? value : Number(value);
+    return Number.isFinite(n) ? n : 0;
+}
+function isProviderName(value) {
+    return value === 'debridge' || value === 'relay';
+}
+/**
+ * Returns the active provider for `chainId` from the coinpool config API, or
+ * `null` when the API is unreachable or the chain has no mapping (caller should
+ * fall back to a default).
+ */
+async function getProviderByChain(chainId, isProduction) {
+    const map = await fetchProviderMap(isProduction);
+    const candidate = map?.[String(chainId)];
+    return isProviderName(candidate) ? candidate : null;
+}
+/**
+ * Returns the affiliate fee tuple for the given provider+chain, or `null` when
+ * no fee should be attached (missing recipient or percent <= 0).
+ */
+async function getAffiliateFee(provider, chainId) {
+    const others = await fetchAffiliateOthers();
+    if (!others)
+        return null;
+    let recipient;
+    let percent;
+    if (provider === 'debridge') {
+        const map = parseRecipientMap(others.affiliateRecipient);
+        recipient = map?.[String(chainId)];
+        percent = toPercent(others.AFFILIATE_FEE_PERENT);
+    }
+    else if (provider === 'relay') {
+        recipient = others.RELAY_AFFILIATE_FEE_RECIPIENT;
+        percent = toPercent(others.RELAY_AFFILIATE_FEE_PERCENT);
+    }
+    else {
+        return null;
+    }
+    if (!recipient || percent <= 0)
+        return null;
+    return { affiliateFeeRecipient: recipient, affiliateFeePercent: percent };
+}
+//# sourceMappingURL=affiliate.js.map

package/dist/services/swap/affiliate.js.map

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

package/dist/services/swap/config.d.ts

@@ -0,0 +1,9 @@
+import type { ExchangeProviderConfig, ProviderName } from './types';
+/**
+ * Per-provider client config. The active provider for a given chain is decided
+ * at runtime by the exchange settings API (`bridgeProviderByChain`); this map
+ * only holds connection-level config (base URLs, tokens) for each provider.
+ */
+export declare const SWAP_PROVIDER_CONFIG: ExchangeProviderConfig;
+export declare const DEFAULT_PROVIDER: ProviderName;
+//# sourceMappingURL=config.d.ts.map

package/dist/services/swap/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/services/swap/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEpE;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,sBAQlC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,YAAyB,CAAC"}

package/dist/services/swap/config.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PROVIDER = exports.SWAP_PROVIDER_CONFIG = void 0;
+/**
+ * Per-provider client config. The active provider for a given chain is decided
+ * at runtime by the exchange settings API (`bridgeProviderByChain`); this map
+ * only holds connection-level config (base URLs, tokens) for each provider.
+ */
+exports.SWAP_PROVIDER_CONFIG = {
+    debridge: {
+        apiBaseUrl: 'https://dln.debridge.finance/v1.0',
+        accessToken: 'd6c45897b8f6',
+    },
+    relay: {
+        apiBaseUrl: 'https://api.relay.link',
+    },
+};
+exports.DEFAULT_PROVIDER = 'debridge';
+//# sourceMappingURL=config.js.map

package/dist/services/swap/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/services/swap/config.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACU,QAAA,oBAAoB,GAA2B;IAC1D,QAAQ,EAAE;QACR,UAAU,EAAE,mCAAmC;QAC/C,WAAW,EAAE,cAAc;KAC5B;IACD,KAAK,EAAE;QACL,UAAU,EAAE,wBAAwB;KACrC;CACF,CAAC;AAEW,QAAA,gBAAgB,GAAiB,UAAU,CAAC"}

package/dist/services/swap/index.d.ts

@@ -0,0 +1,10 @@
+export { BaseSwapService } from './BaseSwapService';
+export { DebridgeAdapter } from './DebridgeAdapter';
+export { RelayAdapter } from './RelayAdapter';
+export { SwapServiceFactory, swapServiceFactory } from './SwapServiceFactory';
+export { SWAP_PROVIDER_CONFIG, DEFAULT_PROVIDER } from './config';
+export { getAffiliateFee, getProviderByChain } from './affiliate';
+export type { AffiliateFee } from './affiliate';
+export { getGatewayAddress, getPositionManagerAddress } from './addresses';
+export type { CheckApprovalParams, CheckApprovalResult, ExchangeProviderConfig, ExecuteSwapParams, ExecuteSwapResult, ProviderName, SwapQuoteParams, SwapQuoteResult, SwapServiceConfig, SwapTxData, TrackStatus, TrackTransactionParams, TrackTransactionResult, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/swap/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/swap/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAClE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAC3E,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,SAAS,CAAC"}

package/dist/services/swap/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPositionManagerAddress = exports.getGatewayAddress = exports.getProviderByChain = exports.getAffiliateFee = exports.DEFAULT_PROVIDER = exports.SWAP_PROVIDER_CONFIG = exports.swapServiceFactory = exports.SwapServiceFactory = exports.RelayAdapter = exports.DebridgeAdapter = exports.BaseSwapService = void 0;
+var BaseSwapService_1 = require("./BaseSwapService");
+Object.defineProperty(exports, "BaseSwapService", { enumerable: true, get: function () { return BaseSwapService_1.BaseSwapService; } });
+var DebridgeAdapter_1 = require("./DebridgeAdapter");
+Object.defineProperty(exports, "DebridgeAdapter", { enumerable: true, get: function () { return DebridgeAdapter_1.DebridgeAdapter; } });
+var RelayAdapter_1 = require("./RelayAdapter");
+Object.defineProperty(exports, "RelayAdapter", { enumerable: true, get: function () { return RelayAdapter_1.RelayAdapter; } });
+var SwapServiceFactory_1 = require("./SwapServiceFactory");
+Object.defineProperty(exports, "SwapServiceFactory", { enumerable: true, get: function () { return SwapServiceFactory_1.SwapServiceFactory; } });
+Object.defineProperty(exports, "swapServiceFactory", { enumerable: true, get: function () { return SwapServiceFactory_1.swapServiceFactory; } });
+var config_1 = require("./config");
+Object.defineProperty(exports, "SWAP_PROVIDER_CONFIG", { enumerable: true, get: function () { return config_1.SWAP_PROVIDER_CONFIG; } });
+Object.defineProperty(exports, "DEFAULT_PROVIDER", { enumerable: true, get: function () { return config_1.DEFAULT_PROVIDER; } });
+var affiliate_1 = require("./affiliate");
+Object.defineProperty(exports, "getAffiliateFee", { enumerable: true, get: function () { return affiliate_1.getAffiliateFee; } });
+Object.defineProperty(exports, "getProviderByChain", { enumerable: true, get: function () { return affiliate_1.getProviderByChain; } });
+var addresses_1 = require("./addresses");
+Object.defineProperty(exports, "getGatewayAddress", { enumerable: true, get: function () { return addresses_1.getGatewayAddress; } });
+Object.defineProperty(exports, "getPositionManagerAddress", { enumerable: true, get: function () { return addresses_1.getPositionManagerAddress; } });
+//# sourceMappingURL=index.js.map

package/dist/services/swap/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/swap/index.ts"],"names":[],"mappings":";;;AAAA,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,2DAA8E;AAArE,wHAAA,kBAAkB,OAAA;AAAE,wHAAA,kBAAkB,OAAA;AAC/C,mCAAkE;AAAzD,8GAAA,oBAAoB,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAC/C,yCAAkE;AAAzD,4GAAA,eAAe,OAAA;AAAE,+GAAA,kBAAkB,OAAA;AAE5C,yCAA2E;AAAlE,8GAAA,iBAAiB,OAAA;AAAE,sHAAA,yBAAyB,OAAA"}

package/dist/services/swap/types.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Shared types for swap/bridge service providers.
+ */
+export type ProviderName = 'debridge' | 'relay';
+export interface SwapQuoteParams {
+    srcChainId: number | string;
+    srcTokenAddress: string;
+    srcTokenAmount: string;
+    dstChainId: number | string;
+    dstTokenAddress: string;
+    recipientAddress: string;
+    senderAddress: string;
+    /**
+     * Slippage tolerance. Either a percent (e.g. 0.5 for 0.5%) or the literal
+     * 'auto' — adapters decide what 'auto' means (deBridge forwards it; Relay
+     * falls back to its server-side default).
+     */
+    slippage?: number | 'auto';
+    isCrossChain?: boolean;
+    isHasAffiliate?: boolean;
+}
+export interface SwapTxData {
+    from?: string;
+    to?: string;
+    data?: string | {
+        instructions: unknown[];
+        addressLookupTableAddresses?: string[];
+    };
+    value?: string;
+    chainId?: number | string;
+    maxFeePerGas?: string;
+    maxPriorityFeePerGas?: string;
+}
+export interface SwapQuoteResult {
+    success: boolean;
+    provider?: ProviderName;
+    tx?: SwapTxData | null;
+    estimation?: Record<string, unknown>;
+    isCrossChain?: boolean;
+    srcChainId?: number | string;
+    dstChainId?: number | string;
+    error?: unknown;
+    errorMessage?: string;
+    /** Provider-specific raw payload — consumers can read additional fields here. */
+    raw?: Record<string, unknown>;
+}
+export interface CheckApprovalParams {
+    chain?: string;
+    userAddress: string;
+    tokenAddress: string;
+    amount: string;
+    tokenDecimals: number;
+    quoteData: SwapQuoteResult;
+}
+export interface CheckApprovalResult {
+    isNeeded: boolean;
+    integrated?: boolean;
+    contractAddress?: string;
+    approvalData?: unknown;
+    message?: string;
+    error?: string;
+}
+export interface ExecuteSwapParams {
+    quoteData: SwapQuoteResult;
+}
+export interface ExecuteSwapResult {
+    success: boolean;
+    provider?: ProviderName;
+    txData?: SwapTxData;
+    steps?: unknown[];
+    estimation?: Record<string, unknown>;
+    error?: string;
+}
+export interface TrackTransactionParams {
+    requestIdOrTxHash: string;
+}
+export type TrackStatus = 'PENDING' | 'COMPLETED' | 'FAILED' | 'ERROR';
+export interface TrackTransactionResult {
+    success: boolean;
+    status: TrackStatus;
+    error?: string;
+}
+export interface SwapServiceConfig {
+    apiBaseUrl?: string;
+    apiKey?: string;
+    accessToken?: string;
+}
+export type ExchangeProviderConfig = Record<ProviderName, SwapServiceConfig>;
+//# sourceMappingURL=types.d.ts.map

package/dist/services/swap/types.d.ts.map

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

package/dist/services/swap/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Shared types for swap/bridge service providers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/services/swap/types.js.map

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

package/dist/tools/BaseTool.d.ts

@@ -0,0 +1,15 @@
+import type { Tool, ToolParameter, ToolResult, UserContext } from '../types';
+/**
+ * Convenience base class for building tools.
+ * Consumers extend this and implement `run()`.
+ */
+export declare abstract class BaseTool implements Tool {
+    abstract name: string;
+    abstract description: string;
+    abstract parameters: ToolParameter[];
+    category?: string;
+    /** Implement the actual tool logic here. */
+    protected abstract run(args: Record<string, unknown>, userContext?: UserContext): Promise<unknown>;
+    execute(args: Record<string, unknown>, userContext?: UserContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=BaseTool.d.ts.map

package/dist/tools/BaseTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseTool.d.ts","sourceRoot":"","sources":["../../src/tools/BaseTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE7E;;;GAGG;AACH,8BAAsB,QAAS,YAAW,IAAI;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,aAAa,EAAE,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,4CAA4C;IAC5C,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAE5F,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAsB7F"}

package/dist/tools/BaseTool.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseTool = void 0;
+/**
+ * Convenience base class for building tools.
+ * Consumers extend this and implement `run()`.
+ */
+class BaseTool {
+    category;
+    async execute(args, userContext) {
+        const callId = `call_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+        const start = Date.now();
+        try {
+            const data = await this.run(args, userContext);
+            return {
+                toolName: this.name,
+                callId,
+                success: true,
+                data,
+                duration: Date.now() - start,
+            };
+        }
+        catch (err) {
+            return {
+                toolName: this.name,
+                callId,
+                success: false,
+                error: err instanceof Error ? err.message : String(err),
+                duration: Date.now() - start,
+            };
+        }
+    }
+}
+exports.BaseTool = BaseTool;
+//# sourceMappingURL=BaseTool.js.map

package/dist/tools/BaseTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseTool.js","sourceRoot":"","sources":["../../src/tools/BaseTool.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,MAAsB,QAAQ;IAI5B,QAAQ,CAAU;IAKlB,KAAK,CAAC,OAAO,CAAC,IAA6B,EAAE,WAAyB;QACpE,MAAM,MAAM,GAAG,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC9E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YAC/C,OAAO;gBACL,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,MAAM;gBACN,OAAO,EAAE,IAAI;gBACb,IAAI;gBACJ,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC7B,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,MAAM;gBACN,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;gBACvD,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC7B,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AA/BD,4BA+BC"}

package/dist/tools/ToolRegistry.d.ts

@@ -0,0 +1,27 @@
+import type { Tool, ToolDefinition, ToolResult, UserContext } from '../types';
+/**
+ * Registry that holds all available tools.
+ * Consumer registers tools here; the Router and Subagents query the registry.
+ */
+export declare class ToolRegistry {
+    private tools;
+    /** Register a tool. Throws if a tool with the same name already exists. */
+    register(tool: Tool): void;
+    /** Unregister a tool by name. */
+    unregister(name: string): boolean;
+    /** Get a tool by name. */
+    get(name: string): Tool | undefined;
+    /** Check if a tool exists. */
+    has(name: string): boolean;
+    /** Return definitions of all registered tools (used for LLM function calling). */
+    getDefinitions(): ToolDefinition[];
+    /** Return definitions filtered by category. */
+    getDefinitionsByCategory(category: string): ToolDefinition[];
+    /** Execute a tool by name. Returns an error ToolResult if the tool is not found. */
+    execute(name: string, args: Record<string, unknown>, userContext?: UserContext): Promise<ToolResult>;
+    /** Number of registered tools. */
+    get size(): number;
+    /** List all registered tool names. */
+    listNames(): string[];
+}
+//# sourceMappingURL=ToolRegistry.d.ts.map

package/dist/tools/ToolRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRegistry.d.ts","sourceRoot":"","sources":["../../src/tools/ToolRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE9E;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA2B;IAExC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAO1B,iCAAiC;IACjC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,0BAA0B;IAC1B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInC,8BAA8B;IAC9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,kFAAkF;IAClF,cAAc,IAAI,cAAc,EAAE;IAUlC,+CAA+C;IAC/C,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE;IAI5D,oFAAoF;IAC9E,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IA2B1G,kCAAkC;IAClC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,sCAAsC;IACtC,SAAS,IAAI,MAAM,EAAE;CAGtB"}

package/dist/tools/ToolRegistry.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolRegistry = void 0;
+/**
+ * Registry that holds all available tools.
+ * Consumer registers tools here; the Router and Subagents query the registry.
+ */
+class ToolRegistry {
+    tools = new Map();
+    /** Register a tool. Throws if a tool with the same name already exists. */
+    register(tool) {
+        if (this.tools.has(tool.name)) {
+            throw new Error(`Tool "${tool.name}" is already registered`);
+        }
+        this.tools.set(tool.name, tool);
+    }
+    /** Unregister a tool by name. */
+    unregister(name) {
+        return this.tools.delete(name);
+    }
+    /** Get a tool by name. */
+    get(name) {
+        return this.tools.get(name);
+    }
+    /** Check if a tool exists. */
+    has(name) {
+        return this.tools.has(name);
+    }
+    /** Return definitions of all registered tools (used for LLM function calling). */
+    getDefinitions() {
+        return Array.from(this.tools.values()).map((t) => ({
+            name: t.name,
+            description: t.description,
+            parameters: t.parameters,
+            category: t.category,
+            kind: t.kind,
+        }));
+    }
+    /** Return definitions filtered by category. */
+    getDefinitionsByCategory(category) {
+        return this.getDefinitions().filter((d) => d.category === category);
+    }
+    /** Execute a tool by name. Returns an error ToolResult if the tool is not found. */
+    async execute(name, args, userContext) {
+        const tool = this.tools.get(name);
+        if (!tool) {
+            return {
+                toolName: name,
+                callId: `err_${Date.now()}`,
+                success: false,
+                error: `Tool "${name}" not found in registry`,
+                duration: 0,
+            };
+        }
+        const start = Date.now();
+        try {
+            const result = await tool.execute(args, userContext);
+            return { ...result, duration: Date.now() - start };
+        }
+        catch (err) {
+            return {
+                toolName: name,
+                callId: `err_${Date.now()}`,
+                success: false,
+                error: err instanceof Error ? err.message : String(err),
+                duration: Date.now() - start,
+            };
+        }
+    }
+    /** Number of registered tools. */
+    get size() {
+        return this.tools.size;
+    }
+    /** List all registered tool names. */
+    listNames() {
+        return Array.from(this.tools.keys());
+    }
+}
+exports.ToolRegistry = ToolRegistry;
+//# sourceMappingURL=ToolRegistry.js.map

package/dist/tools/ToolRegistry.js.map

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

package/dist/tools/builtin/ai/MoralisCortexTool.d.ts

@@ -0,0 +1,33 @@
+import { BaseTool } from '../../BaseTool';
+import type { ToolParameter, UserContext } from '../../../types';
+import { type MoralisServiceConfig } from '../../../services/MoralisService';
+export type MoralisCortexToolConfig = MoralisServiceConfig;
+/**
+ * Tool: moralis-cortex-ai
+ *
+ * AI fallback tool that uses Moralis Cortex AI for blockchain questions
+ * that the direct API tools cannot answer. Examples: market analysis,
+ * trend predictions, complex DeFi explanations, cross-chain comparisons,
+ * protocol-specific questions, etc.
+ *
+ * This should only be used when the dedicated data tools (get-wallet-token-balances,
+ * get-token-info, get-wallet-nfts, get-nft-contract-info) cannot fulfill the request.
+ */
+export declare class MoralisCortexTool extends BaseTool {
+    name: string;
+    description: string;
+    category: string;
+    parameters: ToolParameter[];
+    private service;
+    constructor(config?: MoralisCortexToolConfig);
+    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
+        error: string;
+        source?: undefined;
+        answer?: undefined;
+    } | {
+        source: string;
+        answer: string;
+        error?: undefined;
+    }>;
+}
+//# sourceMappingURL=MoralisCortexTool.d.ts.map

package/dist/tools/builtin/ai/MoralisCortexTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MoralisCortexTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/ai/MoralisCortexTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAkB,KAAK,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAE7F,MAAM,MAAM,uBAAuB,GAAG,oBAAoB,CAAC;AAE3D;;;;;;;;;;GAUG;AACH,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C,IAAI,SAAuB;IAC3B,WAAW,SAgB+D;IAC1E,QAAQ,SAAmB;IAC3B,UAAU,EAAE,aAAa,EAAE,CASzB;IAEF,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,CAAC,EAAE,uBAAuB;cAK5B,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;;;;;;;;;CA8B7E"}

package/dist/tools/builtin/ai/MoralisCortexTool.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MoralisCortexTool = void 0;
+const BaseTool_1 = require("../../BaseTool");
+const MoralisService_1 = require("../../../services/MoralisService");
+/**
+ * Tool: moralis-cortex-ai
+ *
+ * AI fallback tool that uses Moralis Cortex AI for blockchain questions
+ * that the direct API tools cannot answer. Examples: market analysis,
+ * trend predictions, complex DeFi explanations, cross-chain comparisons,
+ * protocol-specific questions, etc.
+ *
+ * This should only be used when the dedicated data tools (get-wallet-token-balances,
+ * get-token-info, get-wallet-nfts, get-nft-contract-info) cannot fulfill the request.
+ */
+class MoralisCortexTool extends BaseTool_1.BaseTool {
+    name = 'moralis-cortex-ai';
+    description = 'Ask Moralis Cortex AI for EVM blockchain/crypto insights that no dedicated tool can answer. ' +
+        'Use this ONLY as a last-resort fallback for EVM chains when all other tools are insufficient. ' +
+        'Good for: market analysis, DeFi protocol explanations, cross-chain comparisons, ' +
+        'trend analysis, gas fee insights, complex on-chain analytics, and general crypto questions ' +
+        'that require AI reasoning over EVM blockchain data. ' +
+        'Do NOT use this for: ' +
+        'token balances → get-wallet-token-balances; ' +
+        'token prices/info → get-token-info; ' +
+        'NFTs → get-wallet-nfts or get-nft-contract-info; ' +
+        'transaction details → get-transaction-by-hash; ' +
+        'wallet history → get-wallet-history; ' +
+        'token transfers → get-wallet-token-transfers; ' +
+        'NFT transfers → get-wallet-nft-transfers; ' +
+        'token holders → get-token-holders; ' +
+        'wallet PnL → get-wallet-pnl or get-wallet-pnl-summary; ' +
+        'ANY Solana question or Solana address → use solana-cortex-ai instead.';
+    category = 'blockchain-ai';
+    parameters = [
+        {
+            name: 'prompt',
+            type: 'string',
+            description: 'A clear, specific question about blockchain/crypto for the AI to answer. ' +
+                'Should be a well-formed English query with relevant context.',
+            required: true,
+        },
+    ];
+    service;
+    constructor(config) {
+        super();
+        this.service = new MoralisService_1.MoralisService(config);
+    }
+    async run(args, userContext) {
+        const prompt = args.prompt;
+        if (!prompt) {
+            return { error: 'Missing required parameter: prompt' };
+        }
+        // Enrich prompt with explicit, clearly-labelled user context so Cortex
+        // does not confuse the connected wallet / chain with the question itself.
+        const contextLines = [];
+        if (userContext?.walletAddress) {
+            contextLines.push(`- Connected wallet address: ${userContext.walletAddress}`);
+        }
+        if (userContext?.chain) {
+            contextLines.push(`- Current chain: ${userContext.chain}`);
+        }
+        const enrichedPrompt = contextLines.length > 0 ? `[USER CONTEXT]\n${contextLines.join('\n')}\n\n[USER QUESTION]\n${prompt}` : prompt;
+        const result = await this.service.chatWithCortex({ prompt: enrichedPrompt });
+        if (!result.success) {
+            return { error: result.error || 'Cortex AI request failed' };
+        }
+        return {
+            source: 'moralis-cortex-ai',
+            answer: result.data?.text || '',
+        };
+    }
+}
+exports.MoralisCortexTool = MoralisCortexTool;
+//# sourceMappingURL=MoralisCortexTool.js.map

package/dist/tools/builtin/ai/MoralisCortexTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MoralisCortexTool.js","sourceRoot":"","sources":["../../../../src/tools/builtin/ai/MoralisCortexTool.ts"],"names":[],"mappings":";;;AAAA,6CAA0C;AAE1C,qEAA6F;AAI7F;;;;;;;;;;GAUG;AACH,MAAa,iBAAkB,SAAQ,mBAAQ;IAC7C,IAAI,GAAG,mBAAmB,CAAC;IAC3B,WAAW,GACT,8FAA8F;QAC9F,gGAAgG;QAChG,kFAAkF;QAClF,6FAA6F;QAC7F,sDAAsD;QACtD,uBAAuB;QACvB,8CAA8C;QAC9C,sCAAsC;QACtC,mDAAmD;QACnD,iDAAiD;QACjD,uCAAuC;QACvC,gDAAgD;QAChD,4CAA4C;QAC5C,qCAAqC;QACrC,yDAAyD;QACzD,uEAAuE,CAAC;IAC1E,QAAQ,GAAG,eAAe,CAAC;IAC3B,UAAU,GAAoB;QAC5B;YACE,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,2EAA2E;gBAC3E,8DAA8D;YAChE,QAAQ,EAAE,IAAI;SACf;KACF,CAAC;IAEM,OAAO,CAAiB;IAEhC,YAAY,MAAgC;QAC1C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,IAAI,+BAAc,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAES,KAAK,CAAC,GAAG,CAAC,IAA6B,EAAE,WAAyB;QAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAgB,CAAC;QACrC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;QACzD,CAAC;QAED,uEAAuE;QACvE,0EAA0E;QAC1E,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,IAAI,WAAW,EAAE,aAAa,EAAE,CAAC;YAC/B,YAAY,CAAC,IAAI,CAAC,+BAA+B,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC;QAChF,CAAC;QACD,IAAI,WAAW,EAAE,KAAK,EAAE,CAAC;YACvB,YAAY,CAAC,IAAI,CAAC,oBAAoB,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,cAAc,GAClB,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,wBAAwB,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;QAEhH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;QAE7E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,0BAA0B,EAAE,CAAC;QAC/D,CAAC;QAED,OAAO;YACL,MAAM,EAAE,mBAAmB;YAC3B,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE;SAChC,CAAC;IACJ,CAAC;CACF;AApED,8CAoEC"}

package/dist/tools/builtin/ai/SolanaCortexTool.d.ts

@@ -0,0 +1,22 @@
+import { BaseTool } from '../../BaseTool';
+import type { ToolParameter, UserContext } from '../../../types';
+import { type MoralisServiceConfig } from '../../../services/MoralisService';
+export type SolanaCortexToolConfig = MoralisServiceConfig;
+export declare class SolanaCortexTool extends BaseTool {
+    name: string;
+    description: string;
+    category: string;
+    parameters: ToolParameter[];
+    private service;
+    constructor(config?: SolanaCortexToolConfig);
+    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<{
+        error: string;
+        source?: undefined;
+        answer?: undefined;
+    } | {
+        source: string;
+        answer: string;
+        error?: undefined;
+    }>;
+}
+//# sourceMappingURL=SolanaCortexTool.d.ts.map