@andrewkimjoseph/celina-sdk 0.2.12 → 0.3.1

package/README.md

@@ -18,6 +18,9 @@ Requires Node.js ≥ 20.
 
 - [Quick start](https://andrewkimjoseph.gitbook.io/celina-sdk/getting-started/quick-start)
 - [wagmi integration](https://andrewkimjoseph.gitbook.io/celina-sdk/guides/wagmi-integration)
+- [Carbon DeFi on Celo](docs/guides/carbon.md) — hybrid Carbon REST + `@bancor/carbon-sdk` (25 operations)
+- [Self Agent ID](docs/guides/self-agent-id.md) — verify, register, and refresh human-backed agents on Celo
+- [Telemetry](docs/guides/telemetry.md) — optional Amplitude read metrics (opt out with `CELINA_ANALYTICS_DISABLED=1`)
 - [API reference](https://andrewkimjoseph.gitbook.io/celina-sdk/api-reference)
 
 Docs source lives in [`docs/`](docs/) in this repository.

package/build/abis/self-registry.d.ts

@@ -0,0 +1,194 @@
+export declare const selfRegistryAbi: readonly [{
+    readonly name: "isVerifiedAgent";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agentPubKey";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+}, {
+    readonly name: "getAgentId";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agentPubKey";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "hasHumanProof";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+}, {
+    readonly name: "getHumanNullifier";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "getAgentCountForHuman";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "nullifier";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "getProofProvider";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "selfProofProvider";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "getAgentCredentials";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "issuingState";
+            readonly type: "string";
+        }, {
+            readonly name: "name";
+            readonly type: "string[]";
+        }, {
+            readonly name: "idNumber";
+            readonly type: "string";
+        }, {
+            readonly name: "nationality";
+            readonly type: "string";
+        }, {
+            readonly name: "dateOfBirth";
+            readonly type: "string";
+        }, {
+            readonly name: "gender";
+            readonly type: "string";
+        }, {
+            readonly name: "expiryDate";
+            readonly type: "string";
+        }, {
+            readonly name: "olderThan";
+            readonly type: "uint256";
+        }, {
+            readonly name: "ofac";
+            readonly type: "bool[3]";
+        }];
+    }];
+}, {
+    readonly name: "agentRegisteredAt";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "proofExpiresAt";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly name: "isProofFresh";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+}, {
+    readonly name: "getAgentsForNullifier";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "nullifier";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256[]";
+    }];
+}, {
+    readonly name: "ownerOf";
+    readonly type: "function";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "tokenId";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+}, {
+    readonly name: "updateAgentMetadata";
+    readonly type: "function";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "agentId";
+        readonly type: "uint256";
+    }, {
+        readonly name: "metadata";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [];
+}];

package/build/abis/self-registry.js

@@ -0,0 +1,120 @@
+export const selfRegistryAbi = [
+    {
+        name: "isVerifiedAgent",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "agentPubKey", type: "bytes32" }],
+        outputs: [{ name: "", type: "bool" }],
+    },
+    {
+        name: "getAgentId",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "agentPubKey", type: "bytes32" }],
+        outputs: [{ name: "", type: "uint256" }],
+    },
+    {
+        name: "hasHumanProof",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "agentId", type: "uint256" }],
+        outputs: [{ name: "", type: "bool" }],
+    },
+    {
+        name: "getHumanNullifier",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "agentId", type: "uint256" }],
+        outputs: [{ name: "", type: "uint256" }],
+    },
+    {
+        name: "getAgentCountForHuman",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "nullifier", type: "uint256" }],
+        outputs: [{ name: "", type: "uint256" }],
+    },
+    {
+        name: "getProofProvider",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "agentId", type: "uint256" }],
+        outputs: [{ name: "", type: "address" }],
+    },
+    {
+        name: "selfProofProvider",
+        type: "function",
+        stateMutability: "view",
+        inputs: [],
+        outputs: [{ name: "", type: "address" }],
+    },
+    {
+        name: "getAgentCredentials",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "agentId", type: "uint256" }],
+        outputs: [
+            {
+                name: "",
+                type: "tuple",
+                components: [
+                    { name: "issuingState", type: "string" },
+                    { name: "name", type: "string[]" },
+                    { name: "idNumber", type: "string" },
+                    { name: "nationality", type: "string" },
+                    { name: "dateOfBirth", type: "string" },
+                    { name: "gender", type: "string" },
+                    { name: "expiryDate", type: "string" },
+                    { name: "olderThan", type: "uint256" },
+                    { name: "ofac", type: "bool[3]" },
+                ],
+            },
+        ],
+    },
+    {
+        name: "agentRegisteredAt",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "agentId", type: "uint256" }],
+        outputs: [{ name: "", type: "uint256" }],
+    },
+    {
+        name: "proofExpiresAt",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "agentId", type: "uint256" }],
+        outputs: [{ name: "", type: "uint256" }],
+    },
+    {
+        name: "isProofFresh",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "agentId", type: "uint256" }],
+        outputs: [{ name: "", type: "bool" }],
+    },
+    {
+        name: "getAgentsForNullifier",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "nullifier", type: "uint256" }],
+        outputs: [{ name: "", type: "uint256[]" }],
+    },
+    {
+        name: "ownerOf",
+        type: "function",
+        stateMutability: "view",
+        inputs: [{ name: "tokenId", type: "uint256" }],
+        outputs: [{ name: "", type: "address" }],
+    },
+    {
+        name: "updateAgentMetadata",
+        type: "function",
+        stateMutability: "nonpayable",
+        inputs: [
+            { name: "agentId", type: "uint256" },
+            { name: "metadata", type: "string" },
+        ],
+        outputs: [],
+    },
+];
+//# sourceMappingURL=self-registry.js.map

package/build/abis/self-registry.js.map

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

package/build/analytics/amplitude.d.ts

@@ -0,0 +1,5 @@
+import type { SdkConfig } from "../config/sdk-config.js";
+/** Test-only hook to assert telemetry without calling Amplitude. */
+export declare function setTrackFnForTests(fn: ((eventName: string, config: SdkConfig) => void) | null): void;
+/** Fire-and-forget MCP tool name event; never throws to callers. */
+export declare function trackMcpTool(eventName: string, config: SdkConfig): void;

package/build/analytics/amplitude.js

@@ -0,0 +1,56 @@
+import { isAnalyticsEnabled, resolveAmplitudeApiKey, resolveDeviceId, } from "./config.js";
+let initialized = false;
+let testTrackFn = null;
+/** Test-only hook to assert telemetry without calling Amplitude. */
+export function setTrackFnForTests(fn) {
+    testTrackFn = fn;
+    initialized = false;
+}
+async function ensureInit(config) {
+    const apiKey = resolveAmplitudeApiKey(config);
+    if (!apiKey) {
+        return false;
+    }
+    if (initialized) {
+        return true;
+    }
+    try {
+        const amplitude = await import("@amplitude/analytics-node");
+        amplitude.init(apiKey);
+        initialized = true;
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Fire-and-forget MCP tool name event; never throws to callers. */
+export function trackMcpTool(eventName, config) {
+    if (!isAnalyticsEnabled(config)) {
+        return;
+    }
+    if (testTrackFn) {
+        try {
+            testTrackFn(eventName, config);
+        }
+        catch {
+            // ignore test hook failures
+        }
+        return;
+    }
+    void (async () => {
+        try {
+            if (!(await ensureInit(config))) {
+                return;
+            }
+            const amplitude = await import("@amplitude/analytics-node");
+            amplitude.track(eventName, undefined, {
+                device_id: resolveDeviceId(config),
+            });
+        }
+        catch {
+            // telemetry must not break SDK reads
+        }
+    })();
+}
+//# sourceMappingURL=amplitude.js.map

package/build/analytics/amplitude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"amplitude.js","sourceRoot":"","sources":["../../src/analytics/amplitude.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,IAAI,WAAW,GAAG,KAAK,CAAC;AACxB,IAAI,WAAW,GACb,IAAI,CAAC;AAEP,oEAAoE;AACpE,MAAM,UAAU,kBAAkB,CAChC,EAA2D;IAE3D,WAAW,GAAG,EAAE,CAAC;IACjB,WAAW,GAAG,KAAK,CAAC;AACtB,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,MAAiB;IACzC,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QAC5D,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,WAAW,GAAG,IAAI,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,MAAiB;IAC/D,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,OAAO;IACT,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;QAC9B,CAAC;QACD,OAAO;IACT,CAAC;IAED,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,IAAI,CAAC;YACH,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;gBAChC,OAAO;YACT,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;YAC5D,SAAS,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE;gBACpC,SAAS,EAAE,eAAe,CAAC,MAAM,CAAC;aACnC,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;QACvC,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;AACP,CAAC"}

package/build/analytics/config.d.ts

@@ -0,0 +1,7 @@
+import type { SdkConfig } from "../config/sdk-config.js";
+/** Public Amplitude project ingestion key (bundled for default telemetry on Node installs). */
+export declare const DEFAULT_AMPLITUDE_API_KEY = "f36f9a7fdc253ed864072edc627b2a55";
+/** Whether Amplitude read telemetry is active for this process. */
+export declare function isAnalyticsEnabled(config: SdkConfig): boolean;
+export declare function resolveAmplitudeApiKey(config: SdkConfig): string | undefined;
+export declare function resolveDeviceId(config: SdkConfig): string;

package/build/analytics/config.js

@@ -0,0 +1,30 @@
+/** Public Amplitude project ingestion key (bundled for default telemetry on Node installs). */
+export const DEFAULT_AMPLITUDE_API_KEY = "f36f9a7fdc253ed864072edc627b2a55";
+const DEFAULT_DEVICE_ID = "celina-sdk";
+/** Whether Amplitude read telemetry is active for this process. */
+export function isAnalyticsEnabled(config) {
+    if (typeof process === "undefined") {
+        return false;
+    }
+    if (process.env.CELINA_ANALYTICS_DISABLED === "1") {
+        return false;
+    }
+    if (config.analyticsEnabled === false) {
+        return false;
+    }
+    return true;
+}
+export function resolveAmplitudeApiKey(config) {
+    if (!isAnalyticsEnabled(config)) {
+        return undefined;
+    }
+    return (config.amplitudeApiKey ??
+        process.env.AMPLITUDE_API_KEY ??
+        DEFAULT_AMPLITUDE_API_KEY);
+}
+export function resolveDeviceId(config) {
+    return (config.analyticsDeviceId ??
+        process.env.CELINA_ANALYTICS_DEVICE_ID ??
+        DEFAULT_DEVICE_ID);
+}
+//# sourceMappingURL=config.js.map

package/build/analytics/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/analytics/config.ts"],"names":[],"mappings":"AAEA,+FAA+F;AAC/F,MAAM,CAAC,MAAM,yBAAyB,GAAG,kCAAkC,CAAC;AAE5E,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAEvC,mEAAmE;AACnE,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,GAAG,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,MAAM,CAAC,gBAAgB,KAAK,KAAK,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,CACL,MAAM,CAAC,eAAe;QACtB,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAC7B,yBAAyB,CAC1B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,OAAO,CACL,MAAM,CAAC,iBAAiB;QACxB,OAAO,CAAC,GAAG,CAAC,0BAA0B;QACtC,iBAAiB,CAClB,CAAC;AACJ,CAAC"}

package/build/analytics/mcp-tool-events.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generated by scripts/generate-mcp-analytics-map.mjs — do not edit by hand.
+ * Maps SDK method keys (catalog OperationSpec.id) to MCP tool event names.
+ */
+export declare const MCP_TOOL_EVENT_BY_SDK_METHOD: Readonly<Record<string, string>>;

package/build/analytics/mcp-tool-events.js

@@ -0,0 +1,55 @@
+/**
+ * Generated by scripts/generate-mcp-analytics-map.mjs — do not edit by hand.
+ * Maps SDK method keys (catalog OperationSpec.id) to MCP tool event names.
+ */
+export const MCP_TOOL_EVENT_BY_SDK_METHOD = {
+    "account.getAccount": "get_account",
+    "blockchain.getBlock": "get_block",
+    "blockchain.getLatestBlocks": "get_latest_blocks",
+    "blockchain.getNetworkStatus": "get_network_status",
+    "blockchain.getTransaction": "get_transaction",
+    "carbon.explorePair": "explore_carbon_pair",
+    "carbon.findOpportunities": "find_carbon_opportunities",
+    "carbon.getActivity": "get_carbon_activity",
+    "carbon.getPriceHistory": "get_carbon_price_history",
+    "carbon.getProtocolStats": "get_carbon_protocol_stats",
+    "carbon.getStrategies": "get_carbon_strategies",
+    "carbon.getStrategy": "get_carbon_strategy",
+    "carbon.getTradeQuote": "get_carbon_trade_quote",
+    "carbon.help": "carbon_help",
+    "carbon.learn": "carbon_learn",
+    "carbon.resolveToken": "resolve_carbon_token",
+    "carbon.simulateStrategy": "simulate_carbon_strategy",
+    "contract.callFunction": "call_contract_function",
+    "contract.estimateGas": "estimate_contract_gas",
+    "ens.resolveEns": "resolve_ens",
+    "gooddollar.getWhitelistingInfo": "get_gooddollar_whitelisting_info",
+    "governance.getGovernanceProposals": "get_governance_proposals",
+    "governance.getProposalDetails": "get_proposal_details",
+    "mentoFx.estimateFx": "estimate_mento_fx",
+    "mentoFx.getFxQuote": "get_mento_fx_quote",
+    "nft.getNftBalance": "get_nft_balance",
+    "nft.getNftInfo": "get_nft_info",
+    "self.authenticatedSelfFetch": "authenticated_self_fetch",
+    "self.checkSelfRegistration": "check_self_registration",
+    "self.getSelfIdentity": "get_self_identity",
+    "self.lookupSelfAgent": "lookup_self_agent",
+    "self.signSelfRequest": "sign_self_request",
+    "self.verifySelfAgent": "verify_self_agent",
+    "self.verifySelfRequest": "verify_self_request",
+    "staking.getActivatableStakes": "get_activatable_stakes",
+    "staking.getStakingBalances": "get_staking_balances",
+    "staking.getTotalStakingInfo": "get_total_staking_info",
+    "staking.getValidatorGroupDetails": "get_validator_group_details",
+    "staking.getValidatorGroups": "get_validator_groups",
+    "token.getBalances": "get_celo_balances",
+    "token.getStablecoinBalances": "get_stablecoin_balances",
+    "token.getTokenBalance": "get_token_balance",
+    "token.getTokenInfo": "get_token_info",
+    "transaction.estimateSend": "estimate_send",
+    "transaction.estimateTransaction": "estimate_transaction",
+    "transaction.getGasFeeData": "get_gas_fee_data",
+    "uniswap.estimateSwap": "estimate_uniswap_swap",
+    "uniswap.getSwapQuote": "get_uniswap_quote",
+};
+//# sourceMappingURL=mcp-tool-events.js.map

package/build/analytics/mcp-tool-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-events.js","sourceRoot":"","sources":["../../src/analytics/mcp-tool-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAqC;IAC5E,oBAAoB,EAAE,aAAa;IACnC,qBAAqB,EAAE,WAAW;IAClC,4BAA4B,EAAE,mBAAmB;IACjD,6BAA6B,EAAE,oBAAoB;IACnD,2BAA2B,EAAE,iBAAiB;IAC9C,oBAAoB,EAAE,qBAAqB;IAC3C,0BAA0B,EAAE,2BAA2B;IACvD,oBAAoB,EAAE,qBAAqB;IAC3C,wBAAwB,EAAE,0BAA0B;IACpD,yBAAyB,EAAE,2BAA2B;IACtD,sBAAsB,EAAE,uBAAuB;IAC/C,oBAAoB,EAAE,qBAAqB;IAC3C,sBAAsB,EAAE,wBAAwB;IAChD,aAAa,EAAE,aAAa;IAC5B,cAAc,EAAE,cAAc;IAC9B,qBAAqB,EAAE,sBAAsB;IAC7C,yBAAyB,EAAE,0BAA0B;IACrD,uBAAuB,EAAE,wBAAwB;IACjD,sBAAsB,EAAE,uBAAuB;IAC/C,gBAAgB,EAAE,aAAa;IAC/B,gCAAgC,EAAE,kCAAkC;IACpE,mCAAmC,EAAE,0BAA0B;IAC/D,+BAA+B,EAAE,sBAAsB;IACvD,oBAAoB,EAAE,mBAAmB;IACzC,oBAAoB,EAAE,oBAAoB;IAC1C,mBAAmB,EAAE,iBAAiB;IACtC,gBAAgB,EAAE,cAAc;IAChC,6BAA6B,EAAE,0BAA0B;IACzD,4BAA4B,EAAE,yBAAyB;IACvD,sBAAsB,EAAE,mBAAmB;IAC3C,sBAAsB,EAAE,mBAAmB;IAC3C,sBAAsB,EAAE,mBAAmB;IAC3C,sBAAsB,EAAE,mBAAmB;IAC3C,wBAAwB,EAAE,qBAAqB;IAC/C,8BAA8B,EAAE,wBAAwB;IACxD,4BAA4B,EAAE,sBAAsB;IACpD,6BAA6B,EAAE,wBAAwB;IACvD,kCAAkC,EAAE,6BAA6B;IACjE,4BAA4B,EAAE,sBAAsB;IACpD,mBAAmB,EAAE,mBAAmB;IACxC,6BAA6B,EAAE,yBAAyB;IACxD,uBAAuB,EAAE,mBAAmB;IAC5C,oBAAoB,EAAE,gBAAgB;IACtC,0BAA0B,EAAE,eAAe;IAC3C,iCAAiC,EAAE,sBAAsB;IACzD,2BAA2B,EAAE,kBAAkB;IAC/C,sBAAsB,EAAE,uBAAuB;IAC/C,sBAAsB,EAAE,mBAAmB;CACnC,CAAC"}

package/build/analytics/wrap-service.d.ts

@@ -0,0 +1,5 @@
+import type { SdkConfig } from "../config/sdk-config.js";
+/**
+ * Wrap a domain service so catalog-mapped async reads emit Amplitude events (MCP tool names).
+ */
+export declare function wrapServiceForAnalytics<T extends object>(serviceKey: string, service: T, config: SdkConfig): T;

package/build/analytics/wrap-service.js

@@ -0,0 +1,36 @@
+import { trackMcpTool } from "./amplitude.js";
+import { isAnalyticsEnabled } from "./config.js";
+import { MCP_TOOL_EVENT_BY_SDK_METHOD } from "./mcp-tool-events.js";
+/**
+ * Wrap a domain service so catalog-mapped async reads emit Amplitude events (MCP tool names).
+ */
+export function wrapServiceForAnalytics(serviceKey, service, config) {
+    if (!isAnalyticsEnabled(config)) {
+        return service;
+    }
+    return new Proxy(service, {
+        get(target, prop, receiver) {
+            const value = Reflect.get(target, prop, receiver);
+            if (typeof prop !== "string" || typeof value !== "function") {
+                return value;
+            }
+            const eventName = MCP_TOOL_EVENT_BY_SDK_METHOD[`${serviceKey}.${prop}`];
+            if (!eventName) {
+                return value.bind(target);
+            }
+            const fn = value;
+            return (...args) => {
+                const result = fn.apply(target, args);
+                if (result !== null && typeof result === "object" && "then" in result) {
+                    return result.then((resolved) => {
+                        trackMcpTool(eventName, config);
+                        return resolved;
+                    });
+                }
+                trackMcpTool(eventName, config);
+                return result;
+            };
+        },
+    });
+}
+//# sourceMappingURL=wrap-service.js.map

package/build/analytics/wrap-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap-service.js","sourceRoot":"","sources":["../../src/analytics/wrap-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAEpE;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,UAAkB,EAClB,OAAU,EACV,MAAiB;IAEjB,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE;QACxB,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;YACxB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YAClD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAC5D,OAAO,KAAK,CAAC;YACf,CAAC;YAED,MAAM,SAAS,GAAG,4BAA4B,CAAC,GAAG,UAAU,IAAI,IAAI,EAAE,CAAC,CAAC;YACxE,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC5B,CAAC;YAED,MAAM,EAAE,GAAG,KAAwC,CAAC;YACpD,OAAO,CAAC,GAAG,IAAe,EAAE,EAAE;gBAC5B,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACtC,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;oBACtE,OAAQ,MAA2B,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;wBACpD,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;wBAChC,OAAO,QAAQ,CAAC;oBAClB,CAAC,CAAC,CAAC;gBACL,CAAC;gBACD,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBAChC,OAAO,MAAM,CAAC;YAChB,CAAC,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/build/clients/carbon-rest.d.ts

@@ -0,0 +1,17 @@
+import type { CarbonRestSuccess } from "../types/carbon.js";
+export declare class CarbonRestError extends Error {
+    readonly toolName: string;
+    readonly statusCode?: number | undefined;
+    constructor(message: string, toolName: string, statusCode?: number | undefined);
+}
+export type CarbonRestBody = Record<string, unknown>;
+export declare class CarbonRestClient {
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    constructor(baseUrl?: string, timeoutMs?: number);
+    private url;
+    /**
+     * POST to Carbon MCP REST. Always injects `chain: celo` unless caller overrides.
+     */
+    postTool<T extends CarbonRestSuccess = CarbonRestSuccess>(toolName: string, body?: CarbonRestBody): Promise<T>;
+}

package/build/clients/carbon-rest.js

@@ -0,0 +1,59 @@
+import { CARBON_CHAIN, DEFAULT_CARBON_REST_BASE_URL } from "../config/carbon.js";
+const DEFAULT_TIMEOUT_MS = 60_000;
+export class CarbonRestError extends Error {
+    toolName;
+    statusCode;
+    constructor(message, toolName, statusCode) {
+        super(message);
+        this.toolName = toolName;
+        this.statusCode = statusCode;
+        this.name = "CarbonRestError";
+    }
+}
+export class CarbonRestClient {
+    baseUrl;
+    timeoutMs;
+    constructor(baseUrl = DEFAULT_CARBON_REST_BASE_URL, timeoutMs = DEFAULT_TIMEOUT_MS) {
+        this.baseUrl = baseUrl;
+        this.timeoutMs = timeoutMs;
+    }
+    url(toolName) {
+        const base = this.baseUrl.replace(/\/$/, "");
+        return `${base}/tools/${toolName}`;
+    }
+    /**
+     * POST to Carbon MCP REST. Always injects `chain: celo` unless caller overrides.
+     */
+    async postTool(toolName, body = {}) {
+        const payload = {
+            chain: CARBON_CHAIN,
+            ...body,
+        };
+        const response = await fetch(this.url(toolName), {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(payload),
+            signal: AbortSignal.timeout(this.timeoutMs),
+        });
+        const text = await response.text();
+        let json;
+        try {
+            json = text ? JSON.parse(text) : {};
+        }
+        catch {
+            throw new CarbonRestError(`Carbon API returned non-JSON (${response.status})`, toolName, response.status);
+        }
+        if (json.error && typeof json.error === "string") {
+            throw new CarbonRestError(json.error, toolName, response.status);
+        }
+        if (json.status === "not_found") {
+            const msg = typeof json.message === "string" ? json.message : "Carbon API not found";
+            throw new CarbonRestError(msg, toolName, response.status);
+        }
+        if (!response.ok) {
+            throw new CarbonRestError(`Carbon API HTTP ${response.status}`, toolName, response.status);
+        }
+        return json;
+    }
+}
+//# sourceMappingURL=carbon-rest.js.map

package/build/clients/carbon-rest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"carbon-rest.js","sourceRoot":"","sources":["../../src/clients/carbon-rest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAGjF,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAG7B;IACA;IAHX,YACE,OAAe,EACN,QAAgB,EAChB,UAAmB;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,aAAQ,GAAR,QAAQ,CAAQ;QAChB,eAAU,GAAV,UAAU,CAAS;QAG5B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAID,MAAM,OAAO,gBAAgB;IAER;IACA;IAFnB,YACmB,UAAkB,4BAA4B,EAC9C,YAAoB,kBAAkB;QADtC,YAAO,GAAP,OAAO,CAAuC;QAC9C,cAAS,GAAT,SAAS,CAA6B;IACtD,CAAC;IAEI,GAAG,CAAC,QAAgB;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC7C,OAAO,GAAG,IAAI,UAAU,QAAQ,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CACZ,QAAgB,EAChB,OAAuB,EAAE;QAEzB,MAAM,OAAO,GAAG;YACd,KAAK,EAAE,YAAY;YACnB,GAAG,IAAI;SACR,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE;YAC/C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC7B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;SAC5C,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,IAA6B,CAAC;QAClC,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAA6B,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,eAAe,CACvB,iCAAiC,QAAQ,CAAC,MAAM,GAAG,EACnD,QAAQ,EACR,QAAQ,CAAC,MAAM,CAChB,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACjD,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAChC,MAAM,GAAG,GACP,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC;YAC3E,MAAM,IAAI,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,eAAe,CACvB,mBAAmB,QAAQ,CAAC,MAAM,EAAE,EACpC,QAAQ,EACR,QAAQ,CAAC,MAAM,CAChB,CAAC;QACJ,CAAC;QAED,OAAO,IAAS,CAAC;IACnB,CAAC;CACF"}