@andrewkimjoseph/celina-sdk 0.4.12 → 0.5.1

package/build/tools/domains/gooddollar.js

@@ -0,0 +1,73 @@
+import { z } from "zod";
+import { optionalWalletAddressSchema } from "../schemas/common.js";
+import { resolveWalletFromRuntime } from "../utils/wallet.js";
+const readOnly = {
+    readOnlyHint: true,
+    idempotentHint: true,
+};
+export const gooddollarToolDefinitions = [
+    {
+        name: "get_gooddollar_whitelisting_info",
+        description: "Check GoodDollar IdentityV4 whitelist status for a wallet.",
+        inputSchema: z.object({
+            address: optionalWalletAddressSchema,
+        }),
+        families: ["read"],
+        mcp: { title: "Get GoodDollar Whitelisting Info", annotations: readOnly },
+        handler: async (runtime, input) => {
+            const target = resolveWalletFromRuntime(runtime, {
+                address: input.address,
+            });
+            return runtime.celina.gooddollar.getWhitelistingInfo(target);
+        },
+    },
+    {
+        name: "get_gooddollar_ubi_entitlement",
+        description: "Daily GoodDollar UBI claim eligibility: whitelist root, claimable G$, already claimed.",
+        inputSchema: z.object({
+            address: optionalWalletAddressSchema,
+        }),
+        families: ["read"],
+        mcp: { title: "Get GoodDollar UBI Entitlement", annotations: readOnly },
+        handler: async (runtime, input) => {
+            const target = resolveWalletFromRuntime(runtime, {
+                address: input.address,
+            });
+            return runtime.celina.gooddollar.getUbiClaimEligibility(target);
+        },
+    },
+    {
+        name: "claim_daily_gooddollar_ubi",
+        description: "Claim today's GoodDollar UBI for the MCP server wallet. Requires CELO_PRIVATE_KEY.",
+        inputSchema: z.object({}),
+        families: ["execute"],
+        surfaces: ["mcp"],
+        mcp: {
+            title: "Claim Daily GoodDollar UBI",
+            annotations: { destructiveHint: true, openWorldHint: true },
+        },
+        handler: async (runtime) => {
+            const write = runtime.executors?.gooddollarWrite;
+            if (!write) {
+                throw new Error("GoodDollar write executor not configured.");
+            }
+            return write.claimDailyUbi();
+        },
+    },
+    {
+        name: "prepare_claim_daily_gooddollar_ubi",
+        description: "Prepare unsigned GoodDollar daily UBI claim. User must sign in wallet.",
+        inputSchema: z.object({
+            from: optionalWalletAddressSchema,
+        }),
+        families: ["prepare"],
+        surfaces: ["celeste"],
+        handler: async (runtime, input) => {
+            const sender = resolveWalletFromRuntime(runtime, {
+                from: input.from,
+            });
+            return runtime.celina.gooddollar.prepareClaimUbi(sender);
+        },
+    },
+];
+//# sourceMappingURL=gooddollar.js.map

package/build/tools/domains/gooddollar.js.map

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

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

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

package/build/tools/domains/governance.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+import { paginationFields } from "../schemas/common.js";
+export const governanceToolDefinitions = [
+    {
+        name: "get_governance_proposals",
+        description: "Returns Celo governance proposals with pagination. Set include_metadata=false for faster responses.",
+        inputSchema: z.object({
+            include_inactive: z.boolean().optional(),
+            include_metadata: z.boolean().optional(),
+            ...paginationFields,
+            page_size: z.number().int().min(1).max(20).optional(),
+        }),
+        families: ["read"],
+        mcp: {
+            title: "Get Governance Proposals",
+            annotations: { readOnlyHint: true, idempotentHint: true },
+        },
+        handler: async (runtime, input) => runtime.celina.governance.getGovernanceProposals({
+            includeInactive: input.include_inactive,
+            includeMetadata: input.include_metadata,
+            page: input.page,
+            pageSize: input.page_size,
+            offset: input.offset,
+            limit: input.limit,
+        }),
+    },
+    {
+        name: "get_proposal_details",
+        description: "Returns detailed information about a Celo governance proposal.",
+        inputSchema: z.object({
+            proposal_id: z.number().int().min(0),
+        }),
+        families: ["read"],
+        mcp: {
+            title: "Get Proposal Details",
+            annotations: { readOnlyHint: true, idempotentHint: true },
+        },
+        handler: async (runtime, input) => runtime.celina.governance.getProposalDetails(input.proposal_id),
+    },
+];
+//# sourceMappingURL=governance.js.map

package/build/tools/domains/governance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.js","sourceRoot":"","sources":["../../../src/tools/domains/governance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxD,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD;QACE,IAAI,EAAE,0BAA0B;QAChC,WAAW,EACT,qGAAqG;QACvG,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YACxC,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YACxC,GAAG,gBAAgB;YACnB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;SACtD,CAAC;QACF,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,GAAG,EAAE;YACH,KAAK,EAAE,0BAA0B;YACjC,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE;SAC1D;QACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAChC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,sBAAsB,CAAC;YAC/C,eAAe,EAAE,KAAK,CAAC,gBAAuC;YAC9D,eAAe,EAAE,KAAK,CAAC,gBAAuC;YAC9D,IAAI,EAAE,KAAK,CAAC,IAA0B;YACtC,QAAQ,EAAE,KAAK,CAAC,SAA+B;YAC/C,MAAM,EAAE,KAAK,CAAC,MAA4B;YAC1C,KAAK,EAAE,KAAK,CAAC,KAA2B;SACzC,CAAC;KACL;IACD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,gEAAgE;QAClE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;SACrC,CAAC;QACF,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,GAAG,EAAE;YACH,KAAK,EAAE,sBAAsB;YAC7B,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE;SAC1D;QACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAChC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,KAAK,CAAC,WAAqB,CAAC;KAC5E;CACF,CAAC"}

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

@@ -0,0 +1 @@
+export declare const allDomainToolDefinitions: import("../types.js").ToolDefinition[];

package/build/tools/domains/index.js

@@ -0,0 +1,33 @@
+import { aaveToolDefinitions } from "./aave.js";
+import { blockchainToolDefinitions } from "./blockchain.js";
+import { carbonToolDefinitions } from "./carbon.js";
+import { celesteToolDefinitions } from "./celeste.js";
+import { contractToolDefinitions } from "./contract.js";
+import { ensToolDefinitions } from "./ens.js";
+import { gooddollarToolDefinitions } from "./gooddollar.js";
+import { governanceToolDefinitions } from "./governance.js";
+import { mentoFxToolDefinitions } from "./mento-fx.js";
+import { nftToolDefinitions } from "./nft.js";
+import { selfToolDefinitions } from "./self.js";
+import { stakingToolDefinitions } from "./staking.js";
+import { tokenToolDefinitions } from "./token.js";
+import { transactionToolDefinitions } from "./transaction.js";
+import { uniswapToolDefinitions } from "./uniswap.js";
+export const allDomainToolDefinitions = [
+    ...blockchainToolDefinitions,
+    ...tokenToolDefinitions,
+    ...transactionToolDefinitions,
+    ...mentoFxToolDefinitions,
+    ...uniswapToolDefinitions,
+    ...aaveToolDefinitions,
+    ...ensToolDefinitions,
+    ...gooddollarToolDefinitions,
+    ...governanceToolDefinitions,
+    ...stakingToolDefinitions,
+    ...nftToolDefinitions,
+    ...contractToolDefinitions,
+    ...selfToolDefinitions,
+    ...carbonToolDefinitions,
+    ...celesteToolDefinitions,
+];
+//# sourceMappingURL=index.js.map

package/build/tools/domains/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/domains/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,GAAG,yBAAyB;IAC5B,GAAG,oBAAoB;IACvB,GAAG,0BAA0B;IAC7B,GAAG,sBAAsB;IACzB,GAAG,sBAAsB;IACzB,GAAG,mBAAmB;IACtB,GAAG,kBAAkB;IACrB,GAAG,yBAAyB;IAC5B,GAAG,yBAAyB;IAC5B,GAAG,sBAAsB;IACzB,GAAG,kBAAkB;IACrB,GAAG,uBAAuB;IAC1B,GAAG,mBAAmB;IACtB,GAAG,qBAAqB;IACxB,GAAG,sBAAsB;CAC1B,CAAC"}

package/build/tools/domains/mento-fx.d.ts

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

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

@@ -0,0 +1,72 @@
+import { mentoFxQuoteSchema, mentoFxWalletSchema, } from "../schemas/common.js";
+import { normalizeRegistryTokenInput } from "../utils/normalize-token.js";
+import { resolveWalletFromRuntime } from "../utils/wallet.js";
+function mapMentoWalletOptions(input) {
+    return {
+        recipient: input.recipient,
+        slippageTolerance: input.slippage_tolerance,
+        deadlineMinutes: input.deadline_minutes,
+    };
+}
+export const mentoFxToolDefinitions = [
+    {
+        name: "get_mento_fx_quote",
+        description: "Mento FX oracle quote for a token pair on mainnet. Read-only.",
+        inputSchema: mentoFxQuoteSchema,
+        families: ["read"],
+        mcp: { title: "Get Mento FX Quote", annotations: { readOnlyHint: true } },
+        handler: async (runtime, input) => {
+            const from = input.from
+                ? resolveWalletFromRuntime(runtime, { from: input.from })
+                : undefined;
+            return runtime.celina.mentoFx.getFxQuote(normalizeRegistryTokenInput(input.token_in), normalizeRegistryTokenInput(input.token_out), input.amount, from);
+        },
+    },
+    {
+        name: "estimate_mento_fx",
+        description: "Estimate gas for a Mento FX conversion including approval if needed.",
+        inputSchema: mentoFxWalletSchema,
+        families: ["read"],
+        mcp: { title: "Estimate Mento FX", annotations: { readOnlyHint: true } },
+        handler: async (runtime, input) => {
+            const sender = resolveWalletFromRuntime(runtime, {
+                from: input.from,
+            });
+            if (runtime.executors?.mentoFx) {
+                return runtime.executors.mentoFx.estimate(normalizeRegistryTokenInput(input.token_in), normalizeRegistryTokenInput(input.token_out), input.amount, { ...mapMentoWalletOptions(input), recipient: input.recipient ?? sender });
+            }
+            return runtime.celina.mentoFx.estimateFx(sender, normalizeRegistryTokenInput(input.token_in), normalizeRegistryTokenInput(input.token_out), input.amount, mapMentoWalletOptions(input));
+        },
+    },
+    {
+        name: "execute_mento_fx",
+        description: "Execute a Mento FX conversion on mainnet. Requires CELO_PRIVATE_KEY.",
+        inputSchema: mentoFxWalletSchema,
+        families: ["execute"],
+        surfaces: ["mcp"],
+        mcp: {
+            title: "Execute Mento FX",
+            annotations: { destructiveHint: true, openWorldHint: true },
+        },
+        handler: async (runtime, input) => {
+            const fx = runtime.executors?.mentoFx;
+            if (!fx)
+                throw new Error("Mento FX executor not configured.");
+            return fx.execute(normalizeRegistryTokenInput(input.token_in), normalizeRegistryTokenInput(input.token_out), input.amount, mapMentoWalletOptions(input));
+        },
+    },
+    {
+        name: "prepare_mento_fx",
+        description: "Prepare Mento FX swap only. For general swaps after get_swap_quote, use prepare_swap.",
+        inputSchema: mentoFxWalletSchema,
+        families: ["prepare"],
+        surfaces: ["celeste"],
+        handler: async (runtime, input) => {
+            const sender = resolveWalletFromRuntime(runtime, {
+                from: input.from,
+            });
+            return runtime.celina.mentoFx.prepareFx(sender, normalizeRegistryTokenInput(input.token_in), normalizeRegistryTokenInput(input.token_out), input.amount, mapMentoWalletOptions(input));
+        },
+    },
+];
+//# sourceMappingURL=mento-fx.js.map

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

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

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

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

package/build/tools/domains/nft.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import { addressSchema, optionalWalletAddressSchema, tokenIdSchema, } from "../schemas/common.js";
+import { resolveWalletFromRuntime } from "../utils/wallet.js";
+const readOnly = {
+    readOnlyHint: true,
+    idempotentHint: true,
+};
+export const nftToolDefinitions = [
+    {
+        name: "get_nft_info",
+        description: "NFT token information including metadata for ERC-721 or ERC-1155.",
+        inputSchema: z.object({
+            contract_address: addressSchema,
+            token_id: tokenIdSchema,
+        }),
+        families: ["read"],
+        mcp: { title: "Get NFT Info", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.nft.getNftInfo(input.contract_address, input.token_id),
+    },
+    {
+        name: "get_nft_balance",
+        description: "NFT balance for an address. Token ID required for ERC-1155.",
+        inputSchema: z.object({
+            contract_address: addressSchema,
+            address: optionalWalletAddressSchema,
+            token_id: tokenIdSchema.optional(),
+        }),
+        families: ["read"],
+        mcp: { title: "Get NFT Balance", annotations: readOnly },
+        handler: async (runtime, input) => {
+            const target = resolveWalletFromRuntime(runtime, {
+                address: input.address,
+            });
+            return runtime.celina.nft.getNftBalance(input.contract_address, target, input.token_id);
+        },
+    },
+];
+//# sourceMappingURL=nft.js.map

package/build/tools/domains/nft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nft.js","sourceRoot":"","sources":["../../../src/tools/domains/nft.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,aAAa,EACb,2BAA2B,EAC3B,aAAa,GACd,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,MAAM,QAAQ,GAAG;IACf,YAAY,EAAE,IAAI;IAClB,cAAc,EAAE,IAAI;CACZ,CAAC;AAEX,MAAM,CAAC,MAAM,kBAAkB,GAAqB;IAClD;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,mEAAmE;QACrE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,gBAAgB,EAAE,aAAa;YAC/B,QAAQ,EAAE,aAAa;SACxB,CAAC;QACF,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,GAAG,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE;QACrD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAChC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAC3B,KAAK,CAAC,gBAAiC,EACvC,KAAK,CAAC,QAAkB,CACzB;KACJ;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,6DAA6D;QAC/D,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,gBAAgB,EAAE,aAAa;YAC/B,OAAO,EAAE,2BAA2B;YACpC,QAAQ,EAAE,aAAa,CAAC,QAAQ,EAAE;SACnC,CAAC;QACF,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,GAAG,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,QAAQ,EAAE;QACxD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAChC,MAAM,MAAM,GAAG,wBAAwB,CAAC,OAAO,EAAE;gBAC/C,OAAO,EAAE,KAAK,CAAC,OAA6B;aAC7C,CAAC,CAAC;YACH,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CACrC,KAAK,CAAC,gBAAiC,EACvC,MAAM,EACN,KAAK,CAAC,QAA8B,CACrC,CAAC;QACJ,CAAC;KACF;CACF,CAAC"}

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

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

package/build/tools/domains/self.js

@@ -0,0 +1,194 @@
+import { selfDemoUrl } from "../../config/self.js";
+import { z } from "zod";
+import { addressSchema } from "../schemas/common.js";
+const SELF_DEMO_VERIFY_URL = selfDemoUrl("/api/demo/verify");
+const selfRegistrationModeSchema = z
+    .enum([
+    "linked",
+    "wallet-free",
+    "smartwallet",
+    "self-custody",
+    "ed25519",
+    "ed25519-linked",
+])
+    .optional();
+function requireSelf(runtime) {
+    const self = runtime.executors?.self;
+    if (!self) {
+        throw new Error("Self executor not configured.");
+    }
+    return self;
+}
+export const selfToolDefinitions = [
+    {
+        name: "verify_self_agent",
+        description: "Verify whether an agent address is backed by a real human on Self Agent ID (Celo mainnet).",
+        inputSchema: z.object({
+            agent_address: addressSchema,
+            require_age: z.union([z.literal(0), z.literal(18), z.literal(21)]).optional(),
+            require_ofac: z.boolean().optional(),
+            require_self_provider: z.boolean().optional(),
+        }),
+        families: ["read"],
+        surfaces: ["mcp"],
+        mcp: {
+            title: "Verify Self Agent",
+            annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+        },
+        handler: async (runtime, input) => requireSelf(runtime).verifyAgent({
+            agentAddress: input.agent_address,
+            requireAge: input.require_age,
+            requireOfac: input.require_ofac,
+            requireSelfProvider: input.require_self_provider,
+        }),
+    },
+    {
+        name: "lookup_self_agent",
+        description: "Look up a Self Agent ID by numeric on-chain ID.",
+        inputSchema: z.object({
+            agent_id: z.number().int().positive(),
+        }),
+        families: ["read"],
+        surfaces: ["mcp"],
+        mcp: {
+            title: "Look Up Self Agent",
+            annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+        },
+        handler: async (runtime, input) => requireSelf(runtime).lookupAgent(input.agent_id),
+    },
+    {
+        name: "verify_self_request",
+        description: "Verify incoming HTTP request headers signed by a Self Agent.",
+        inputSchema: z.object({
+            agent_signature: z.string().regex(/^0x[a-fA-F0-9]+$/),
+            agent_timestamp: z.string(),
+            method: z.string(),
+            path: z.string(),
+            body: z.string().optional(),
+            keytype: z.string().optional(),
+            agent_key: z.string().regex(/^0x[a-fA-F0-9]+$/).optional(),
+        }),
+        families: ["read"],
+        surfaces: ["mcp"],
+        mcp: {
+            title: "Verify Self Agent Request",
+            annotations: { readOnlyHint: true, idempotentHint: true },
+        },
+        handler: async (runtime, input) => requireSelf(runtime).verifyRequest(input),
+    },
+    {
+        name: "register_self_agent",
+        description: "Start Self Agent ID registration. Returns qr_code_url and deep_link — present BOTH to the user.",
+        inputSchema: z.object({
+            mode: selfRegistrationModeSchema,
+            minimum_age: z.union([z.literal(0), z.literal(18), z.literal(21)]).optional(),
+            ofac: z.boolean().optional(),
+            human_address: addressSchema.optional(),
+            agent_name: z.string().optional(),
+            agent_description: z.string().optional(),
+        }),
+        families: ["execute"],
+        surfaces: ["mcp"],
+        mcp: {
+            title: "Register Self Agent",
+            annotations: { destructiveHint: true, openWorldHint: true },
+            responseKind: "self_session",
+        },
+        handler: async (runtime, input) => requireSelf(runtime).registerAgent({
+            mode: input.mode,
+            minimumAge: input.minimum_age,
+            ofac: input.ofac,
+            humanAddress: input.human_address,
+            agentName: input.agent_name,
+            agentDescription: input.agent_description,
+        }),
+    },
+    {
+        name: "check_self_registration",
+        description: "Poll a pending Self registration, proof refresh, or deregistration session.",
+        inputSchema: z.object({
+            session_id: z.string(),
+        }),
+        families: ["read"],
+        surfaces: ["mcp"],
+        mcp: {
+            title: "Check Self Registration",
+            annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+        },
+        handler: async (runtime, input) => requireSelf(runtime).checkRegistration(input.session_id),
+    },
+    {
+        name: "get_self_identity",
+        description: "Return the configured Self agent identity. Requires SELF_AGENT_PRIVATE_KEY.",
+        inputSchema: z.object({}),
+        families: ["read"],
+        surfaces: ["mcp"],
+        mcp: {
+            title: "Get Self Agent Identity",
+            annotations: { readOnlyHint: true, idempotentHint: true },
+        },
+        handler: async (runtime) => requireSelf(runtime).getIdentity(),
+    },
+    {
+        name: "refresh_self_proof",
+        description: "Start a human proof refresh after on-chain proof expiry. Returns qr_code_url and deep_link.",
+        inputSchema: z.object({
+            agent_id: z.number().int().positive().optional(),
+        }),
+        families: ["execute"],
+        surfaces: ["mcp"],
+        mcp: {
+            title: "Refresh Self Proof",
+            annotations: { openWorldHint: true },
+            responseKind: "self_session",
+        },
+        handler: async (runtime, input) => requireSelf(runtime).refreshProof({ agentId: input.agent_id }),
+    },
+    {
+        name: "deregister_self_agent",
+        description: "Start irreversible Self agent deregistration. Returns qr_code_url and deep_link.",
+        inputSchema: z.object({}),
+        families: ["execute"],
+        surfaces: ["mcp"],
+        mcp: {
+            title: "Deregister Self Agent",
+            annotations: { destructiveHint: true, openWorldHint: true },
+            responseKind: "self_session",
+        },
+        handler: async (runtime) => requireSelf(runtime).deregisterAgent(),
+    },
+    {
+        name: "sign_self_request",
+        description: `Sign an HTTP request with the configured Self agent. Demo verify: POST ${SELF_DEMO_VERIFY_URL}`,
+        inputSchema: z.object({
+            method: z.enum(["GET", "POST", "PUT", "DELETE"]),
+            url: z.string().url(),
+            body: z.string().optional(),
+        }),
+        families: ["read"],
+        surfaces: ["mcp"],
+        mcp: {
+            title: "Sign Self Agent Request",
+            annotations: { readOnlyHint: true, idempotentHint: true },
+        },
+        handler: async (runtime, input) => requireSelf(runtime).signRequest(input),
+    },
+    {
+        name: "authenticated_self_fetch",
+        description: `HTTP request with Self Agent ID auth headers. Demo: ?network=celo-mainnet — ${SELF_DEMO_VERIFY_URL}`,
+        inputSchema: z.object({
+            method: z.enum(["GET", "POST", "PUT", "DELETE"]),
+            url: z.string().url(),
+            body: z.string().optional(),
+            content_type: z.string().optional(),
+        }),
+        families: ["execute"],
+        surfaces: ["mcp"],
+        mcp: {
+            title: "Authenticated Self Fetch",
+            annotations: { openWorldHint: true },
+        },
+        handler: async (runtime, input) => requireSelf(runtime).authenticatedFetch(input),
+    },
+];
+//# sourceMappingURL=self.js.map

package/build/tools/domains/self.js.map

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

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

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

package/build/tools/domains/staking.js

@@ -0,0 +1,74 @@
+import { z } from "zod";
+import { addressSchema, optionalWalletAddressSchema, paginationFields, } from "../schemas/common.js";
+import { resolveWalletFromRuntime } from "../utils/wallet.js";
+const readOnly = {
+    readOnlyHint: true,
+    idempotentHint: true,
+};
+export const stakingToolDefinitions = [
+    {
+        name: "get_staking_balances",
+        description: "Active and pending staking votes for an address by validator group.",
+        inputSchema: z.object({
+            address: optionalWalletAddressSchema,
+        }),
+        families: ["read"],
+        mcp: { title: "Get Staking Balances", annotations: readOnly },
+        handler: async (runtime, input) => {
+            const target = resolveWalletFromRuntime(runtime, {
+                address: input.address,
+            });
+            return runtime.celina.staking.getStakingBalances(target);
+        },
+    },
+    {
+        name: "get_activatable_stakes",
+        description: "Validator groups where pending stakes can be activated for an address.",
+        inputSchema: z.object({
+            address: optionalWalletAddressSchema,
+        }),
+        families: ["read"],
+        mcp: { title: "Get Activatable Stakes", annotations: readOnly },
+        handler: async (runtime, input) => {
+            const target = resolveWalletFromRuntime(runtime, {
+                address: input.address,
+            });
+            return runtime.celina.staking.getActivatableStakes(target);
+        },
+    },
+    {
+        name: "get_validator_groups",
+        description: "Paginated validator groups with votes, capacity, and member counts.",
+        inputSchema: z.object({
+            ...paginationFields,
+            page_size: z.number().int().min(1).max(50).optional(),
+        }),
+        families: ["read"],
+        mcp: { title: "Get Validator Groups", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.staking.getValidatorGroups({
+            page: input.page,
+            pageSize: input.page_size,
+            offset: input.offset,
+            limit: input.limit,
+        }),
+    },
+    {
+        name: "get_validator_group_details",
+        description: "Detailed information about a validator group including members.",
+        inputSchema: z.object({
+            group_address: addressSchema,
+        }),
+        families: ["read"],
+        mcp: { title: "Get Validator Group Details", annotations: readOnly },
+        handler: async (runtime, input) => runtime.celina.staking.getValidatorGroupDetails(input.group_address),
+    },
+    {
+        name: "get_total_staking_info",
+        description: "Network-wide staking participation metrics.",
+        inputSchema: z.object({}),
+        families: ["read"],
+        mcp: { title: "Get Total Staking Info", annotations: readOnly },
+        handler: async (runtime) => runtime.celina.staking.getTotalStakingInfo(),
+    },
+];
+//# sourceMappingURL=staking.js.map

package/build/tools/domains/staking.js.map

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

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

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