@andrewkimjoseph/celina-sdk 0.5.1 → 0.6.0

package/README.md

@@ -28,11 +28,16 @@ npm i @andrewkimjoseph/celina-sdk
 
 Requires Node.js ≥ 20.
 
+### LLM tool catalog (v0.5+)
+
+For MCP servers and chat APIs (Vercel AI SDK, etc.), import shared tool definitions from `@andrewkimjoseph/celina-sdk/tools` instead of redefining schemas. See [LLM tool catalog](docs/guides/tool-catalog.md) — includes the recommended **`dynamicTool`** pattern so TypeScript does not OOM on large tool sets.
+
 ## Documentation
 
 **Full docs:** [celina-sdk on GitBook](https://andrewkimjoseph.gitbook.io/celina-sdk)
 
 - [Quick start](https://andrewkimjoseph.gitbook.io/celina-sdk/getting-started/quick-start)
+- [LLM tool catalog](docs/guides/tool-catalog.md) — `@andrewkimjoseph/celina-sdk/tools` for MCP and AI SDK hosts
 - [Architecture](docs/concepts/architecture.md) — client composition and stack
 - [Prepared flows](docs/concepts/prepared-flows.md) — `SerializedPreparedFlow`, CELINA calldata tag
 - [wagmi integration](https://andrewkimjoseph.gitbook.io/celina-sdk/guides/wagmi-integration)

package/build/tools/catalog.d.ts

@@ -2,7 +2,7 @@ import type { FilterToolsOptions, ToolDefinition, ToolFamily } from "./types.js"
 export declare const ALL_TOOL_DEFINITIONS: ToolDefinition[];
 export declare function getToolNames(options?: FilterToolsOptions): string[];
 export declare function getMcpToolNames(options?: Omit<FilterToolsOptions, "surface">): string[];
-export declare function getCelesteToolNames(options?: Omit<FilterToolsOptions, "surface">): string[];
+export declare function getBrowserToolNames(options?: Omit<FilterToolsOptions, "surface">): string[];
 export declare function getToolsByFamily(family: ToolFamily): ToolDefinition[];
 export declare function getToolDefinition(name: string): ToolDefinition | undefined;
 export declare function assertSnakeCaseInputKeys(definition: ToolDefinition): void;

package/build/tools/catalog.js

@@ -7,8 +7,8 @@ export function getToolNames(options = {}) {
 export function getMcpToolNames(options = {}) {
     return getToolNames({ ...options, surface: "mcp" });
 }
-export function getCelesteToolNames(options = {}) {
-    return getToolNames({ ...options, surface: "celeste" });
+export function getBrowserToolNames(options = {}) {
+    return getToolNames({ ...options, surface: "browser" });
 }
 export function getToolsByFamily(family) {
     return filterToolDefinitions(ALL_TOOL_DEFINITIONS, { families: [family] });

package/build/tools/domains/aave.js

@@ -57,7 +57,7 @@ export const aaveToolDefinitions = [
             from: optionalWalletAddressSchema,
         }),
         families: ["prepare"],
-        surfaces: ["celeste"],
+        surfaces: ["browser"],
         handler: async (runtime, input) => {
             const sender = resolveWalletFromRuntime(runtime, {
                 from: input.from,
@@ -76,7 +76,7 @@ export const aaveToolDefinitions = [
             from: optionalWalletAddressSchema,
         }),
         families: ["prepare"],
-        surfaces: ["celeste"],
+        surfaces: ["browser"],
         handler: async (runtime, input) => {
             const sender = resolveWalletFromRuntime(runtime, {
                 from: input.from,

package/build/tools/domains/browser.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDefinition } from "../types.js";
+export declare const browserToolDefinitions: ToolDefinition[];

package/build/tools/domains/{celeste.js → browser.js}

@@ -3,7 +3,7 @@ import { getSwapQuoteWithFallback, prepareSwapWithFallback, } from "../swap-rout
 import { uniswapWalletSchema } from "../schemas/common.js";
 import { normalizeRegistryTokenInput } from "../utils/normalize-token.js";
 import { resolveWalletFromRuntime } from "../utils/wallet.js";
-export const celesteToolDefinitions = [
+export const browserToolDefinitions = [
     {
         name: "get_swap_quote",
         description: "Best swap quote on Celo — tries Mento FX and Uniswap v4 in parallel.",
@@ -13,7 +13,7 @@ export const celesteToolDefinitions = [
             amount: z.string(),
         }),
         families: ["read"],
-        surfaces: ["celeste"],
+        surfaces: ["browser"],
         handler: async (runtime, input) => {
             const from = resolveWalletFromRuntime(runtime, {});
             return getSwapQuoteWithFallback(runtime.celina, normalizeRegistryTokenInput(input.token_in), normalizeRegistryTokenInput(input.token_out), input.amount, from);
@@ -26,7 +26,7 @@ export const celesteToolDefinitions = [
             protocol: z.enum(["mento_fx", "uniswap_v4"]).optional(),
         }),
         families: ["prepare"],
-        surfaces: ["celeste"],
+        surfaces: ["browser"],
         handler: async (runtime, input) => {
             const sender = resolveWalletFromRuntime(runtime, {
                 from: input.from,
@@ -39,4 +39,4 @@ export const celesteToolDefinitions = [
         },
     },
 ];
-//# sourceMappingURL=celeste.js.map
+//# sourceMappingURL=browser.js.map

package/build/tools/domains/{celeste.js.map → browser.js.map}

@@ -1 +1 @@
-{"version":3,"file":"celeste.js","sourceRoot":"","sources":["../../../src/tools/domains/celeste.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GAExB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,MAAM,CAAC,MAAM,sBAAsB,GAAqB;IACtD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,sEAAsE;QACxE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;YACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;SACnB,CAAC;QACF,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAChC,MAAM,IAAI,GAAG,wBAAwB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACnD,OAAO,wBAAwB,CAC7B,OAAO,CAAC,MAAM,EACd,2BAA2B,CAAC,KAAK,CAAC,QAAkB,CAAC,EACrD,2BAA2B,CAAC,KAAK,CAAC,SAAmB,CAAC,EACtD,KAAK,CAAC,MAAgB,EACtB,IAAI,CACL,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,sEAAsE;QACxE,WAAW,EAAE,mBAAmB,CAAC,MAAM,CAAC;YACtC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE;SACxD,CAAC;QACF,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAChC,MAAM,MAAM,GAAG,wBAAwB,CAAC,OAAO,EAAE;gBAC/C,IAAI,EAAE,KAAK,CAAC,IAA0B;aACvC,CAAC,CAAC;YACH,OAAO,uBAAuB,CAC5B,OAAO,CAAC,MAAM,EACd,MAAM,EACN,2BAA2B,CAAC,KAAK,CAAC,QAAkB,CAAC,EACrD,2BAA2B,CAAC,KAAK,CAAC,SAAmB,CAAC,EACtD,KAAK,CAAC,MAAgB,EACtB;gBACE,SAAS,EAAE,KAAK,CAAC,SAAsC;gBACvD,iBAAiB,EAAE,KAAK,CAAC,kBAAwC;gBACjE,eAAe,EAAE,KAAK,CAAC,gBAAsC;aAC9D,EACD,KAAK,CAAC,QAAoC,CAC3C,CAAC;QACJ,CAAC;KACF;CACF,CAAC"}
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../../src/tools/domains/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GAExB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,MAAM,CAAC,MAAM,sBAAsB,GAAqB;IACtD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,sEAAsE;QACxE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;YACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;SACnB,CAAC;QACF,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAChC,MAAM,IAAI,GAAG,wBAAwB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACnD,OAAO,wBAAwB,CAC7B,OAAO,CAAC,MAAM,EACd,2BAA2B,CAAC,KAAK,CAAC,QAAkB,CAAC,EACrD,2BAA2B,CAAC,KAAK,CAAC,SAAmB,CAAC,EACtD,KAAK,CAAC,MAAgB,EACtB,IAAI,CACL,CAAC;QACJ,CAAC;KACF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,sEAAsE;QACxE,WAAW,EAAE,mBAAmB,CAAC,MAAM,CAAC;YACtC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE;SACxD,CAAC;QACF,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAChC,MAAM,MAAM,GAAG,wBAAwB,CAAC,OAAO,EAAE;gBAC/C,IAAI,EAAE,KAAK,CAAC,IAA0B;aACvC,CAAC,CAAC;YACH,OAAO,uBAAuB,CAC5B,OAAO,CAAC,MAAM,EACd,MAAM,EACN,2BAA2B,CAAC,KAAK,CAAC,QAAkB,CAAC,EACrD,2BAA2B,CAAC,KAAK,CAAC,SAAmB,CAAC,EACtD,KAAK,CAAC,MAAgB,EACtB;gBACE,SAAS,EAAE,KAAK,CAAC,SAAsC;gBACvD,iBAAiB,EAAE,KAAK,CAAC,kBAAwC;gBACjE,eAAe,EAAE,KAAK,CAAC,gBAAsC;aAC9D,EACD,KAAK,CAAC,QAAoC,CAC3C,CAAC;QACJ,CAAC;KACF;CACF,CAAC"}

package/build/tools/domains/gooddollar.js

@@ -61,7 +61,7 @@ export const gooddollarToolDefinitions = [
             from: optionalWalletAddressSchema,
         }),
         families: ["prepare"],
-        surfaces: ["celeste"],
+        surfaces: ["browser"],
         handler: async (runtime, input) => {
             const sender = resolveWalletFromRuntime(runtime, {
                 from: input.from,

package/build/tools/domains/index.js

@@ -1,7 +1,7 @@
 import { aaveToolDefinitions } from "./aave.js";
 import { blockchainToolDefinitions } from "./blockchain.js";
 import { carbonToolDefinitions } from "./carbon.js";
-import { celesteToolDefinitions } from "./celeste.js";
+import { browserToolDefinitions } from "./browser.js";
 import { contractToolDefinitions } from "./contract.js";
 import { ensToolDefinitions } from "./ens.js";
 import { gooddollarToolDefinitions } from "./gooddollar.js";
@@ -28,6 +28,6 @@ export const allDomainToolDefinitions = [
     ...contractToolDefinitions,
     ...selfToolDefinitions,
     ...carbonToolDefinitions,
-    ...celesteToolDefinitions,
+    ...browserToolDefinitions,
 ];
 //# sourceMappingURL=index.js.map

package/build/tools/domains/mento-fx.js

@@ -60,7 +60,7 @@ export const mentoFxToolDefinitions = [
         description: "Prepare Mento FX swap only. For general swaps after get_swap_quote, use prepare_swap.",
         inputSchema: mentoFxWalletSchema,
         families: ["prepare"],
-        surfaces: ["celeste"],
+        surfaces: ["browser"],
         handler: async (runtime, input) => {
             const sender = resolveWalletFromRuntime(runtime, {
                 from: input.from,

package/build/tools/domains/transaction.js

@@ -66,7 +66,7 @@ export const transactionToolDefinitions = [
             from: optionalWalletAddressSchema,
         }),
         families: ["prepare"],
-        surfaces: ["celeste"],
+        surfaces: ["browser"],
         handler: async (runtime, input) => {
             const sender = resolveWalletFromRuntime(runtime, {
                 from: input.from,

package/build/tools/domains/uniswap.js

@@ -60,7 +60,7 @@ export const uniswapToolDefinitions = [
         description: "Prepare Uniswap v4 swap only. Prefer prepare_swap after get_swap_quote for automatic routing.",
         inputSchema: uniswapWalletSchema,
         families: ["prepare"],
-        surfaces: ["celeste"],
+        surfaces: ["browser"],
         handler: async (runtime, input) => {
             const sender = resolveWalletFromRuntime(runtime, {
                 from: input.from,

package/build/tools/filter.js

@@ -3,7 +3,7 @@ const CARBON_EXECUTE_PREFIX = "execute_carbon_";
 export function filterToolDefinitions(definitions, options = {}) {
     return definitions.filter((def) => {
         if (options.surface) {
-            const surfaces = def.surfaces ?? ["mcp", "celeste"];
+            const surfaces = def.surfaces ?? ["mcp", "browser"];
             if (!surfaces.includes(options.surface)) {
                 return false;
             }

package/build/tools/index.d.ts

@@ -1,4 +1,4 @@
-export { ALL_TOOL_DEFINITIONS, getToolNames, getMcpToolNames, getCelesteToolNames, getToolsByFamily, getToolDefinition, validateToolCatalogSnakeCase, } from "./catalog.js";
+export { ALL_TOOL_DEFINITIONS, getToolNames, getMcpToolNames, getBrowserToolNames, getToolsByFamily, getToolDefinition, validateToolCatalogSnakeCase, } from "./catalog.js";
 export { filterToolDefinitions } from "./filter.js";
 export { getSwapQuoteWithFallback, prepareSwapWithFallback, type SwapProtocol, type SwapQuoteResult, type SwapPrepareParams, } from "./swap-routing.js";
 export * from "./schemas/common.js";

package/build/tools/index.js

@@ -1,4 +1,4 @@
-export { ALL_TOOL_DEFINITIONS, getToolNames, getMcpToolNames, getCelesteToolNames, getToolsByFamily, getToolDefinition, validateToolCatalogSnakeCase, } from "./catalog.js";
+export { ALL_TOOL_DEFINITIONS, getToolNames, getMcpToolNames, getBrowserToolNames, getToolsByFamily, getToolDefinition, validateToolCatalogSnakeCase, } from "./catalog.js";
 export { filterToolDefinitions } from "./filter.js";
 export { getSwapQuoteWithFallback, prepareSwapWithFallback, } from "./swap-routing.js";
 export * from "./schemas/common.js";

package/build/tools/types.d.ts

@@ -1,7 +1,7 @@
 import type { z } from "zod";
 import type { CelinaClient } from "../index.js";
 import type { CarbonWriteBody } from "../services/carbon.service.js";
-export type ToolSurface = "mcp" | "celeste";
+export type ToolSurface = "mcp" | "browser";
 export type ToolFamily = "read" | "prepare" | "execute";
 export type WalletInput = {
     address?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andrewkimjoseph/celina-sdk",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Celina SDK — Celo mainnet reads and unsigned transaction preparation for frontend apps.",
   "type": "module",
   "sideEffects": false,

package/tests/testing-entry.ts

@@ -12,7 +12,7 @@ export {
 export {
   ALL_TOOL_DEFINITIONS,
   getMcpToolNames,
-  getCelesteToolNames,
+  getBrowserToolNames,
 } from "../src/tools/catalog.js";
 export { getMainnetFixtures, type MainnetFixtures } from "./fixtures/mainnet.js";
 export {

package/build/tools/domains/celeste.d.ts

@@ -1,2 +0,0 @@
-import type { ToolDefinition } from "../types.js";
-export declare const celesteToolDefinitions: ToolDefinition[];