@lit-protocol/vincent-app-sdk 0.0.4-mma

package/dist/src/toolClient/vincentToolClient.d.ts

@@ -0,0 +1,76 @@
+import { ethers } from 'ethers';
+import { z } from 'zod';
+import type { BundledVincentTool, VincentTool } from '@lit-protocol/vincent-tool-sdk';
+import type { ToolPolicyMap } from '@lit-protocol/vincent-tool-sdk/internal';
+import type { VincentToolClient } from './types';
+/** A VincentToolClient provides a type-safe interface for executing tools, for both `precheck()`
+ * and `execute()` functionality.
+ *
+ * ```typescript
+ * import { disconnectVincentToolClients, getVincentToolClient, isToolResponseFailure } from '@lit-protocol/vincent-app-sdk/toolClient';
+ * import { bundledVincentTool as uniswapBundledTool } from '@lit-protocol/vincent-tool-uniswap-swap';
+ * import { delegateeEthersSigner } = from './ethersSigner';
+ * import { ETH_RPC_URL, BASE_RPC_URL } from './rpcConfigs';
+ *
+ * const uniswapToolClient = getVincentToolClient({
+ *     bundledVincentTool: uniswapBundledTool,
+ *     ethersSigner: delegateeEthersSigner,
+ *   });
+ *
+ * // First, call `precheck()` to get a best-estimate result indicating that the tool execution in the LIT action runtime will not fail
+ * const precheckResult = await uniswapSwapToolClient.precheck({
+ *     ethRpcUrl: ETH_RPC_URL,
+ *     rpcUrlForUniswap: BASE_RPC_URL,
+ *     chainIdForUniswap: 8453, // Base
+ *     tokenInAddress: '0x4200000000000000000000000000000000000006', // WETH
+ *     tokenInDecimals: 18,
+ *     tokenInAmount: 0.0000077,
+ *     tokenOutAddress: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', // USDC on Base
+ *     tokenOutDecimals: 8,
+ *   },
+ *   {
+ *     delegatorPkpEthAddress: '0x123456789123456789123456789...',
+ *   });
+ *
+ * const uniswapSwapExecutionResult = await uniswapSwapToolClient.execute({
+ *   ethRpcUrl: ETH_RPC_URL,
+ *   rpcUrlForUniswap: BASE_RPC_URL,
+ *   chainIdForUniswap: 8453,
+ *   tokenInAddress: '0x4200000000000000000000000000000000000006', // WETH
+ *   tokenInDecimals: 18,
+ *   tokenInAmount: 0.0000077,
+ *   tokenOutAddress: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', // USDC on Base
+ *   tokenOutDecimals: 8,
+ * },
+ * {
+ *   delegatorPkpEthAddress: '0x123456789123456789123456789...',
+ * });
+ *
+ * if(isToolResponseFailure(uniswapSwapExecutionResult)) {
+ *   ...handle failure
+ * } else {
+ *  ...handle result
+ * }
+ * ```
+ *
+ * @typeParam IpfsCid {@removeTypeParameterCompletely}
+ * @typeParam ToolParamsSchema {@removeTypeParameterCompletely}
+ * @typeParam PkgNames {@removeTypeParameterCompletely}
+ * @typeParam PolicyMap {@removeTypeParameterCompletely}
+ * @typeParam PoliciesByPackageName {@removeTypeParameterCompletely}
+ * @typeParam ExecuteSuccessSchema {@removeTypeParameterCompletely}
+ * @typeParam ExecuteFailSchema {@removeTypeParameterCompletely}
+ * @typeParam PrecheckSuccessSchema {@removeTypeParameterCompletely}
+ * @typeParam PrecheckFailSchema {@removeTypeParameterCompletely}
+ *
+ * @param params
+ * @param params.ethersSigner  - An ethers signer that has been configured with your delegatee key
+ * @param params.bundledVincentTool  - The bundled vincent tool that you want to interact with
+ *
+ * @category API
+ * */
+export declare function getVincentToolClient<const IpfsCid extends string, ToolParamsSchema extends z.ZodType, PkgNames extends string, PolicyMap extends ToolPolicyMap<any, PkgNames>, PoliciesByPackageName extends PolicyMap['policyByPackageName'], ExecuteSuccessSchema extends z.ZodType = z.ZodUndefined, ExecuteFailSchema extends z.ZodType = z.ZodUndefined, PrecheckSuccessSchema extends z.ZodType = z.ZodUndefined, PrecheckFailSchema extends z.ZodType = z.ZodUndefined>(params: {
+    bundledVincentTool: BundledVincentTool<VincentTool<ToolParamsSchema, PkgNames, PolicyMap, PoliciesByPackageName, ExecuteSuccessSchema, ExecuteFailSchema, PrecheckSuccessSchema, PrecheckFailSchema, any, any>, IpfsCid>;
+    ethersSigner: ethers.Signer;
+}): VincentToolClient<ToolParamsSchema, PoliciesByPackageName, ExecuteSuccessSchema, ExecuteFailSchema, PrecheckSuccessSchema, PrecheckFailSchema>;
+//# sourceMappingURL=vincentToolClient.d.ts.map

package/dist/src/toolClient/vincentToolClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vincentToolClient.d.ts","sourceRoot":"","sources":["../../../src/toolClient/vincentToolClient.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AACtF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAc7E,OAAO,KAAK,EAAqB,iBAAiB,EAAE,MAAM,SAAS,CAAC;AA2BpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAiEK;AACL,wBAAgB,oBAAoB,CAClC,KAAK,CAAC,OAAO,SAAS,MAAM,EAC5B,gBAAgB,SAAS,CAAC,CAAC,OAAO,EAClC,QAAQ,SAAS,MAAM,EACvB,SAAS,SAAS,aAAa,CAAC,GAAG,EAAE,QAAQ,CAAC,EAC9C,qBAAqB,SAAS,SAAS,CAAC,qBAAqB,CAAC,EAC9D,oBAAoB,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EACvD,iBAAiB,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EACpD,qBAAqB,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EACxD,kBAAkB,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,YAAY,EACrD,MAAM,EAAE;IACR,kBAAkB,EAAE,kBAAkB,CACpC,WAAW,CACT,gBAAgB,EAChB,QAAQ,EACR,SAAS,EACT,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,GAAG,EACH,GAAG,CACJ,EACD,OAAO,CACR,CAAC;IACF,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;CAC7B,GAAG,iBAAiB,CACnB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,CACnB,CAmUA"}

package/dist/src/toolClient/vincentToolClient.js

@@ -0,0 +1,285 @@
+"use strict";
+// src/toolClient/vincentToolClient.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVincentToolClient = getVincentToolClient;
+const ethers_1 = require("ethers");
+const zod_1 = require("zod");
+const constants_1 = require("@lit-protocol/constants");
+const internal_1 = require("@lit-protocol/vincent-tool-sdk/internal");
+const getLitNodeClient_1 = require("../internal/LitNodeClient/getLitNodeClient");
+const generateVincentToolSessionSigs_1 = require("./execute/generateVincentToolSessionSigs");
+const resultCreators_1 = require("./execute/resultCreators");
+const resultCreators_2 = require("./precheck/resultCreators");
+const runPolicyPrechecks_1 = require("./precheck/runPolicyPrechecks");
+const typeGuards_1 = require("./typeGuards");
+const YELLOWSTONE_RPC_URL = 'https://yellowstone-rpc.litprotocol.com/';
+const bigintReplacer = (key, value) => {
+    return typeof value === 'bigint' ? value.toString() : value;
+};
+/** A VincentToolClient provides a type-safe interface for executing tools, for both `precheck()`
+ * and `execute()` functionality.
+ *
+ * ```typescript
+ * import { disconnectVincentToolClients, getVincentToolClient, isToolResponseFailure } from '@lit-protocol/vincent-app-sdk/toolClient';
+ * import { bundledVincentTool as uniswapBundledTool } from '@lit-protocol/vincent-tool-uniswap-swap';
+ * import { delegateeEthersSigner } = from './ethersSigner';
+ * import { ETH_RPC_URL, BASE_RPC_URL } from './rpcConfigs';
+ *
+ * const uniswapToolClient = getVincentToolClient({
+ *     bundledVincentTool: uniswapBundledTool,
+ *     ethersSigner: delegateeEthersSigner,
+ *   });
+ *
+ * // First, call `precheck()` to get a best-estimate result indicating that the tool execution in the LIT action runtime will not fail
+ * const precheckResult = await uniswapSwapToolClient.precheck({
+ *     ethRpcUrl: ETH_RPC_URL,
+ *     rpcUrlForUniswap: BASE_RPC_URL,
+ *     chainIdForUniswap: 8453, // Base
+ *     tokenInAddress: '0x4200000000000000000000000000000000000006', // WETH
+ *     tokenInDecimals: 18,
+ *     tokenInAmount: 0.0000077,
+ *     tokenOutAddress: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', // USDC on Base
+ *     tokenOutDecimals: 8,
+ *   },
+ *   {
+ *     delegatorPkpEthAddress: '0x123456789123456789123456789...',
+ *   });
+ *
+ * const uniswapSwapExecutionResult = await uniswapSwapToolClient.execute({
+ *   ethRpcUrl: ETH_RPC_URL,
+ *   rpcUrlForUniswap: BASE_RPC_URL,
+ *   chainIdForUniswap: 8453,
+ *   tokenInAddress: '0x4200000000000000000000000000000000000006', // WETH
+ *   tokenInDecimals: 18,
+ *   tokenInAmount: 0.0000077,
+ *   tokenOutAddress: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', // USDC on Base
+ *   tokenOutDecimals: 8,
+ * },
+ * {
+ *   delegatorPkpEthAddress: '0x123456789123456789123456789...',
+ * });
+ *
+ * if(isToolResponseFailure(uniswapSwapExecutionResult)) {
+ *   ...handle failure
+ * } else {
+ *  ...handle result
+ * }
+ * ```
+ *
+ * @typeParam IpfsCid {@removeTypeParameterCompletely}
+ * @typeParam ToolParamsSchema {@removeTypeParameterCompletely}
+ * @typeParam PkgNames {@removeTypeParameterCompletely}
+ * @typeParam PolicyMap {@removeTypeParameterCompletely}
+ * @typeParam PoliciesByPackageName {@removeTypeParameterCompletely}
+ * @typeParam ExecuteSuccessSchema {@removeTypeParameterCompletely}
+ * @typeParam ExecuteFailSchema {@removeTypeParameterCompletely}
+ * @typeParam PrecheckSuccessSchema {@removeTypeParameterCompletely}
+ * @typeParam PrecheckFailSchema {@removeTypeParameterCompletely}
+ *
+ * @param params
+ * @param params.ethersSigner  - An ethers signer that has been configured with your delegatee key
+ * @param params.bundledVincentTool  - The bundled vincent tool that you want to interact with
+ *
+ * @category API
+ * */
+function getVincentToolClient(params) {
+    var _a, _b;
+    const { bundledVincentTool, ethersSigner } = params;
+    const { ipfsCid, vincentTool, vincentToolApiVersion } = bundledVincentTool;
+    (0, internal_1.assertSupportedToolVersion)(vincentToolApiVersion);
+    const network = constants_1.LIT_NETWORK.Datil;
+    const executeSuccessSchema = ((_a = vincentTool.__schemaTypes.executeSuccessSchema) !== null && _a !== void 0 ? _a : zod_1.z.undefined());
+    const executeFailSchema = ((_b = vincentTool.__schemaTypes.executeFailSchema) !== null && _b !== void 0 ? _b : zod_1.z.undefined());
+    return {
+        async precheck(rawToolParams, { rpcUrl, delegatorPkpEthAddress, }) {
+            console.log('precheck', { rawToolParams, delegatorPkpEthAddress, rpcUrl });
+            const delegateePkpEthAddress = ethers_1.ethers.utils.getAddress(await ethersSigner.getAddress());
+            // This will be populated further during execution; if an error is encountered, it'll include as much data as we can give the caller.
+            const baseContext = {
+                delegation: {
+                    delegateeAddress: delegateePkpEthAddress,
+                    // delegatorPkpInfo: null,
+                },
+                toolIpfsCid: ipfsCid,
+                // appId: undefined,
+                // appVersion: undefined,
+            };
+            const parsedParams = (0, internal_1.validateOrFail)(rawToolParams, vincentTool.toolParamsSchema, 'precheck', 'input');
+            if ((0, typeGuards_1.isToolResponseFailure)(parsedParams)) {
+                return (0, resultCreators_2.createToolPrecheckResponseFailureNoResult)({
+                    ...parsedParams,
+                    context: baseContext,
+                });
+            }
+            const userPkpInfo = await (0, internal_1.getPkpInfo)({
+                litPubkeyRouterAddress: internal_1.LIT_DATIL_PUBKEY_ROUTER_ADDRESS,
+                yellowstoneRpcUrl: rpcUrl !== null && rpcUrl !== void 0 ? rpcUrl : YELLOWSTONE_RPC_URL,
+                pkpEthAddress: delegatorPkpEthAddress,
+            });
+            baseContext.delegation.delegatorPkpInfo = userPkpInfo;
+            console.log('userPkpInfo', userPkpInfo);
+            const { decodedPolicies, appId, appVersion } = await (0, internal_1.getPoliciesAndAppVersion)({
+                delegationRpcUrl: rpcUrl !== null && rpcUrl !== void 0 ? rpcUrl : YELLOWSTONE_RPC_URL,
+                appDelegateeAddress: delegateePkpEthAddress,
+                agentWalletPkpEthAddress: delegatorPkpEthAddress,
+                toolIpfsCid: ipfsCid,
+            });
+            baseContext.appId = appId.toNumber();
+            baseContext.appVersion = appVersion.toNumber();
+            console.log('Fetched policies and app info', { decodedPolicies, appId, appVersion });
+            const baseToolContext = await (0, runPolicyPrechecks_1.runToolPolicyPrechecks)({
+                bundledVincentTool,
+                toolParams: parsedParams,
+                decodedPolicies,
+                context: {
+                    ...baseContext,
+                    rpcUrl,
+                },
+            });
+            if (!vincentTool.precheck) {
+                console.log('No tool precheck defined - returning baseContext policy evaluation results', {
+                    rawToolParams,
+                    delegatorPkpEthAddress,
+                    rpcUrl,
+                });
+                if (!baseToolContext.policiesContext.allow) {
+                    return (0, resultCreators_2.createToolPrecheckResponseFailureNoResult)({
+                        context: baseToolContext,
+                    });
+                }
+                return (0, resultCreators_2.createToolPrecheckResponseSuccessNoResult)({
+                    context: baseToolContext,
+                });
+            }
+            console.log('Executing tool precheck');
+            const precheckResult = await vincentTool.precheck({ toolParams: parsedParams }, baseToolContext);
+            if ((0, typeGuards_1.isToolResponseSchemaValidationFailure)(precheckResult) ||
+                (0, typeGuards_1.isToolResponseRuntimeFailure)(precheckResult)) {
+                console.log('Detected runtime or schema validation error in toolPrecheckResult - returning as-is:', JSON.stringify({
+                    isToolResponseRuntimeFailure: (0, typeGuards_1.isToolResponseRuntimeFailure)(precheckResult),
+                    isToolResponseSchemaValidationFailure: (0, typeGuards_1.isToolResponseSchemaValidationFailure)(precheckResult),
+                    precheckResult,
+                }, bigintReplacer));
+                // Runtime errors and schema validation errors will not have results; return them as-is.
+                return precheckResult;
+            }
+            console.log('precheckResult()', JSON.stringify(precheckResult, bigintReplacer));
+            return {
+                ...precheckResult,
+                context: baseToolContext,
+            };
+        },
+        async execute(rawToolParams, context) {
+            const parsedParams = (0, internal_1.validateOrFail)(rawToolParams, vincentTool.toolParamsSchema, 'execute', 'input');
+            if ((0, typeGuards_1.isToolResponseFailure)(parsedParams)) {
+                return {
+                    ...parsedParams,
+                    context,
+                };
+            }
+            const litNodeClient = await (0, getLitNodeClient_1.getLitNodeClientInstance)({ network });
+            const sessionSigs = await (0, generateVincentToolSessionSigs_1.generateVincentToolSessionSigs)({ ethersSigner, litNodeClient });
+            const result = await litNodeClient.executeJs({
+                ipfsId: ipfsCid,
+                sessionSigs,
+                jsParams: {
+                    toolParams: parsedParams,
+                    context,
+                    vincentToolApiVersion,
+                },
+            });
+            const { success, response } = result;
+            console.log('executeResult - raw result from `litNodeClient.executeJs()', {
+                response,
+                success,
+            });
+            if (success !== true) {
+                return (0, resultCreators_1.createToolExecuteResponseFailureNoResult)({
+                    runtimeError: `Remote tool failed with unknown error: ${JSON.stringify(response, bigintReplacer, 2)}`,
+                });
+            }
+            let parsedResult = response;
+            if (typeof response === 'string') {
+                // lit-node-client returns a string if no signed data, even if the result could be JSON.parse'd :(
+                try {
+                    parsedResult = JSON.parse(response);
+                    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+                }
+                catch (e) {
+                    return (0, resultCreators_1.createToolExecuteResponseFailureNoResult)({
+                        runtimeError: `Remote tool failed with unknown error: ${JSON.stringify(response, bigintReplacer)}`,
+                    });
+                }
+            }
+            if (!(0, typeGuards_1.isRemoteVincentToolExecutionResult)(parsedResult)) {
+                console.log('Result from `executeJs` was valid JSON, but not a vincentToolExecutionResult', { parsedResult, success });
+                return (0, resultCreators_1.createToolExecuteResponseFailureNoResult)({
+                    runtimeError: `Remote tool failed with unknown error: ${JSON.stringify(parsedResult, bigintReplacer)}`,
+                });
+            }
+            const remoteVincentToolResult = parsedResult;
+            console.log('Parsed executeJs vincentToolExecutionResult:', JSON.stringify(parsedResult, bigintReplacer));
+            const { toolContext, toolExecutionResult } = remoteVincentToolResult;
+            if ((0, typeGuards_1.isToolResponseSchemaValidationFailure)(toolExecutionResult) ||
+                (0, typeGuards_1.isToolResponseRuntimeFailure)(toolExecutionResult)) {
+                console.log('Detected runtime or schema validation error in toolExecutionResult - returning as-is:', JSON.stringify({
+                    isToolResponseRuntimeFailure: (0, typeGuards_1.isToolResponseRuntimeFailure)(toolExecutionResult),
+                    isToolResponseSchemaValidationFailure: (0, typeGuards_1.isToolResponseSchemaValidationFailure)(toolExecutionResult),
+                    toolExecutionResult,
+                }, bigintReplacer));
+                // Runtime errors and schema validation errors will not have results; return them as-is.
+                return (0, resultCreators_1.createToolExecuteResponseFailureNoResult)({
+                    ...(toolExecutionResult.runtimeError
+                        ? { runtimeError: toolExecutionResult.runtimeError }
+                        : {}),
+                    ...(toolExecutionResult.schemaValidationError
+                        ? { schemaValidationError: toolExecutionResult.schemaValidationError }
+                        : {}),
+                    context: remoteVincentToolResult.toolContext,
+                });
+            }
+            // Policy eval happens before `execute()` is ever called
+            // As a result, when policies return a `deny` result, there will be no tool result
+            // so we need to skip trying to run result through the success/fail schema logic
+            if (!toolContext.policiesContext.allow) {
+                return (0, resultCreators_1.createToolExecuteResponseFailureNoResult)({
+                    context: toolContext,
+                });
+            }
+            const resultSchemaDetails = (0, internal_1.getSchemaForToolResult)({
+                value: toolExecutionResult,
+                successResultSchema: executeSuccessSchema,
+                failureResultSchema: executeFailSchema,
+            });
+            const { schemaToUse, parsedType } = resultSchemaDetails;
+            console.log(`Parsing tool result using the ${parsedType} Zod schema`);
+            // Parse returned result using appropriate execute zod schema
+            const executeResult = (0, internal_1.validateOrFail)(toolExecutionResult.result, schemaToUse, 'execute', 'output');
+            console.log('Zod parse result:', executeResult);
+            if ((0, typeGuards_1.isToolResponseFailure)(executeResult)) {
+                // Parsing the result threw a zodError
+                return executeResult;
+            }
+            console.log('Raw toolExecutionResult was:', toolExecutionResult);
+            // We parsed the result -- it may be a success or a failure; return appropriately.
+            if ((0, typeGuards_1.isToolResponseFailure)(toolExecutionResult)) {
+                return (0, resultCreators_1.createToolExecuteResponseFailure)({
+                    ...(toolExecutionResult.runtimeError
+                        ? { runtimeError: toolExecutionResult.runtimeError }
+                        : {}),
+                    ...(toolExecutionResult.schemaValidationError
+                        ? { schemaValidationError: toolExecutionResult.schemaValidationError }
+                        : {}),
+                    result: executeResult,
+                    context: remoteVincentToolResult.toolContext,
+                });
+            }
+            const res = executeResult;
+            return (0, resultCreators_1.createToolExecuteResponseSuccess)({
+                result: res,
+                context: remoteVincentToolResult.toolContext,
+            });
+        },
+    };
+}
+//# sourceMappingURL=vincentToolClient.js.map

package/dist/src/toolClient/vincentToolClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vincentToolClient.js","sourceRoot":"","sources":["../../../src/toolClient/vincentToolClient.ts"],"names":[],"mappings":";AAAA,sCAAsC;;AAiHtC,oDAqWC;AApdD,mCAAgC;AAChC,6BAAwB;AAKxB,uDAAsD;AACtD,sEAOiD;AAMjD,iFAAsF;AACtF,6FAA0F;AAC1F,6DAIkC;AAClC,8DAGmC;AACnC,sEAAuE;AACvE,6CAKsB;AAEtB,MAAM,mBAAmB,GAAG,0CAA0C,CAAC;AAEvE,MAAM,cAAc,GAAG,CAAC,GAAQ,EAAE,KAAU,EAAE,EAAE;IAC9C,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAC9D,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAiEK;AACL,SAAgB,oBAAoB,CAUlC,MAiBD;;IAQC,MAAM,EAAE,kBAAkB,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;IACpD,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,GAAG,kBAAkB,CAAC;IAE3E,IAAA,qCAA0B,EAAC,qBAAqB,CAAC,CAAC;IAElD,MAAM,OAAO,GAAG,uBAAW,CAAC,KAAK,CAAC;IAElC,MAAM,oBAAoB,GAAG,CAAC,MAAA,WAAW,CAAC,aAAa,CAAC,oBAAoB,mCAC1E,OAAC,CAAC,SAAS,EAAE,CAAyB,CAAC;IACzC,MAAM,iBAAiB,GAAG,CAAC,MAAA,WAAW,CAAC,aAAa,CAAC,iBAAiB,mCACpE,OAAC,CAAC,SAAS,EAAE,CAAsB,CAAC;IAEtC,OAAO;QACL,KAAK,CAAC,QAAQ,CACZ,aAAwC,EACxC,EACE,MAAM,EACN,sBAAsB,GAGvB;YAID,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,EAAE,CAAC,CAAC;YAC3E,MAAM,sBAAsB,GAAG,eAAM,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,YAAY,CAAC,UAAU,EAAE,CAAC,CAAC;YAExF,qIAAqI;YACrI,MAAM,WAAW,GAAG;gBAClB,UAAU,EAAE;oBACV,gBAAgB,EAAE,sBAAsB;oBACxC,0BAA0B;iBAC3B;gBACD,WAAW,EAAE,OAAO;gBACpB,oBAAoB;gBACpB,yBAAyB;aACnB,CAAC;YAET,MAAM,YAAY,GAAG,IAAA,yBAAc,EACjC,aAAa,EACb,WAAW,CAAC,gBAAgB,EAC5B,UAAU,EACV,OAAO,CACR,CAAC;YAEF,IAAI,IAAA,kCAAqB,EAAC,YAAY,CAAC,EAAE,CAAC;gBACxC,OAAO,IAAA,0DAAyC,EAAC;oBAC/C,GAAG,YAAY;oBACf,OAAO,EAAE,WAAW;iBACrB,CAIA,CAAC;YACJ,CAAC;YAED,MAAM,WAAW,GAAG,MAAM,IAAA,qBAAU,EAAC;gBACnC,sBAAsB,EAAE,0CAA+B;gBACvD,iBAAiB,EAAE,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,mBAAmB;gBAChD,aAAa,EAAE,sBAAsB;aACtC,CAAC,CAAC;YACH,WAAW,CAAC,UAAU,CAAC,gBAAgB,GAAG,WAAW,CAAC;YAEtD,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;YAExC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,IAAA,mCAAwB,EAAC;gBAC5E,gBAAgB,EAAE,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,mBAAmB;gBAC/C,mBAAmB,EAAE,sBAAsB;gBAC3C,wBAAwB,EAAE,sBAAsB;gBAChD,WAAW,EAAE,OAAO;aACrB,CAAC,CAAC;YACH,WAAW,CAAC,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;YACrC,WAAW,CAAC,UAAU,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC;YAE/C,OAAO,CAAC,GAAG,CAAC,+BAA+B,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;YAErF,MAAM,eAAe,GAAG,MAAM,IAAA,2CAAsB,EAAC;gBACnD,kBAAkB;gBAClB,UAAU,EAAE,YAAyC;gBACrD,eAAe;gBACf,OAAO,EAAE;oBACP,GAAG,WAAW;oBACd,MAAM;iBACP;aACF,CAAC,CAAC;YAEH,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;gBAC1B,OAAO,CAAC,GAAG,CAAC,4EAA4E,EAAE;oBACxF,aAAa;oBACb,sBAAsB;oBACtB,MAAM;iBACP,CAAC,CAAC;gBACH,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;oBAC3C,OAAO,IAAA,0DAAyC,EAAC;wBAC/C,OAAO,EAAE,eAAe;qBACzB,CAIA,CAAC;gBACJ,CAAC;gBAED,OAAO,IAAA,0DAAyC,EAAC;oBAC/C,OAAO,EAAE,eAAe;iBACzB,CAIA,CAAC;YACJ,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;YAEvC,MAAM,cAAc,GAAG,MAAM,WAAW,CAAC,QAAQ,CAC/C,EAAE,UAAU,EAAE,YAAY,EAAE,EAC5B,eAAe,CAChB,CAAC;YAEF,IACE,IAAA,kDAAqC,EAAC,cAAc,CAAC;gBACrD,IAAA,yCAA4B,EAAC,cAAc,CAAC,EAC5C,CAAC;gBACD,OAAO,CAAC,GAAG,CACT,sFAAsF,EACtF,IAAI,CAAC,SAAS,CACZ;oBACE,4BAA4B,EAAE,IAAA,yCAA4B,EAAC,cAAc,CAAC;oBAC1E,qCAAqC,EACnC,IAAA,kDAAqC,EAAC,cAAc,CAAC;oBACvD,cAAc;iBACf,EACD,cAAc,CACf,CACF,CAAC;gBACF,wFAAwF;gBACxF,OAAO,cAIN,CAAC;YACJ,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC;YAChF,OAAO;gBACL,GAAG,cAAc;gBACjB,OAAO,EAAE,eAAe;aACiE,CAAC;QAC9F,CAAC;QAED,KAAK,CAAC,OAAO,CACX,aAAwC,EACxC,OAA0B;YAI1B,MAAM,YAAY,GAAG,IAAA,yBAAc,EACjC,aAAa,EACb,WAAW,CAAC,gBAAgB,EAC5B,SAAS,EACT,OAAO,CACR,CAAC;YAEF,IAAI,IAAA,kCAAqB,EAAC,YAAY,CAAC,EAAE,CAAC;gBACxC,OAAO;oBACL,GAAG,YAAY;oBACf,OAAO;iBAC+E,CAAC;YAC3F,CAAC;YAED,MAAM,aAAa,GAAG,MAAM,IAAA,2CAAwB,EAAC,EAAE,OAAO,EAAE,CAAC,CAAC;YAClE,MAAM,WAAW,GAAG,MAAM,IAAA,+DAA8B,EAAC,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC,CAAC;YAE1F,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,SAAS,CAAC;gBAC3C,MAAM,EAAE,OAAO;gBACf,WAAW;gBACX,QAAQ,EAAE;oBACR,UAAU,EAAE,YAAY;oBACxB,OAAO;oBACP,qBAAqB;iBACtB;aACF,CAAC,CAAC;YAEH,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,4DAA4D,EAAE;gBACxE,QAAQ;gBACR,OAAO;aACR,CAAC,CAAC;YAEH,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,OAAO,IAAA,yDAAwC,EAAC;oBAC9C,YAAY,EAAE,0CAA0C,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC,EAAE;iBACtG,CAAwF,CAAC;YAC5F,CAAC;YAED,IAAI,YAAY,GAAG,QAAQ,CAAC;YAE5B,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACjC,kGAAkG;gBAClG,IAAI,CAAC;oBACH,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;oBACpC,6DAA6D;gBAC/D,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,IAAA,yDAAwC,EAAC;wBAC9C,YAAY,EAAE,0CAA0C,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,cAAc,CAAC,EAAE;qBACnG,CAAwF,CAAC;gBAC5F,CAAC;YACH,CAAC;YAED,IAAI,CAAC,IAAA,+CAAkC,EAAC,YAAY,CAAC,EAAE,CAAC;gBACtD,OAAO,CAAC,GAAG,CACT,8EAA8E,EAC9E,EAAE,YAAY,EAAE,OAAO,EAAE,CAC1B,CAAC;gBAEF,OAAO,IAAA,yDAAwC,EAAC;oBAC9C,YAAY,EAAE,0CAA0C,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,cAAc,CAAC,EAAE;iBACvG,CAAwF,CAAC;YAC5F,CAAC;YAED,MAAM,uBAAuB,GAIzB,YAAY,CAAC;YAEjB,OAAO,CAAC,GAAG,CACT,8CAA8C,EAC9C,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,cAAc,CAAC,CAC7C,CAAC;YAEF,MAAM,EAAE,WAAW,EAAE,mBAAmB,EAAE,GAAG,uBAAuB,CAAC;YAErE,IACE,IAAA,kDAAqC,EAAC,mBAAmB,CAAC;gBAC1D,IAAA,yCAA4B,EAAC,mBAAmB,CAAC,EACjD,CAAC;gBACD,OAAO,CAAC,GAAG,CACT,uFAAuF,EACvF,IAAI,CAAC,SAAS,CACZ;oBACE,4BAA4B,EAAE,IAAA,yCAA4B,EAAC,mBAAmB,CAAC;oBAC/E,qCAAqC,EACnC,IAAA,kDAAqC,EAAC,mBAAmB,CAAC;oBAC5D,mBAAmB;iBACpB,EACD,cAAc,CACf,CACF,CAAC;gBACF,wFAAwF;gBACxF,OAAO,IAAA,yDAAwC,EAAC;oBAC9C,GAAG,CAAC,mBAAmB,CAAC,YAAY;wBAClC,CAAC,CAAC,EAAE,YAAY,EAAE,mBAAmB,CAAC,YAAY,EAAE;wBACpD,CAAC,CAAC,EAAE,CAAC;oBACP,GAAG,CAAC,mBAAmB,CAAC,qBAAqB;wBAC3C,CAAC,CAAC,EAAE,qBAAqB,EAAE,mBAAmB,CAAC,qBAAqB,EAAE;wBACtE,CAAC,CAAC,EAAE,CAAC;oBACP,OAAO,EAAE,uBAAuB,CAAC,WAAW;iBAC7C,CAAwF,CAAC;YAC5F,CAAC;YAED,wDAAwD;YACxD,kFAAkF;YAClF,gFAAgF;YAChF,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;gBACvC,OAAO,IAAA,yDAAwC,EAAC;oBAC9C,OAAO,EAAE,WAAW;iBACrB,CAAwF,CAAC;YAC5F,CAAC;YAED,MAAM,mBAAmB,GAAG,IAAA,iCAAsB,EAAC;gBACjD,KAAK,EAAE,mBAAmB;gBAC1B,mBAAmB,EAAE,oBAAoB;gBACzC,mBAAmB,EAAE,iBAAiB;aACvC,CAAC,CAAC;YAEH,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,mBAAmB,CAAC;YAExD,OAAO,CAAC,GAAG,CAAC,iCAAiC,UAAU,aAAa,CAAC,CAAC;YAEtE,6DAA6D;YAC7D,MAAM,aAAa,GAAG,IAAA,yBAAc,EAClC,mBAAmB,CAAC,MAAM,EAC1B,WAAW,EACX,SAAS,EACT,QAAQ,CACT,CAAC;YAEF,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC;YAEhD,IAAI,IAAA,kCAAqB,EAAC,aAAa,CAAC,EAAE,CAAC;gBACzC,sCAAsC;gBACtC,OAAO,aAIN,CAAC;YACJ,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,8BAA8B,EAAE,mBAAmB,CAAC,CAAC;YAEjE,kFAAkF;YAClF,IAAI,IAAA,kCAAqB,EAAC,mBAAmB,CAAC,EAAE,CAAC;gBAC/C,OAAO,IAAA,iDAAgC,EAAC;oBACtC,GAAG,CAAC,mBAAmB,CAAC,YAAY;wBAClC,CAAC,CAAC,EAAE,YAAY,EAAE,mBAAmB,CAAC,YAAY,EAAE;wBACpD,CAAC,CAAC,EAAE,CAAC;oBACP,GAAG,CAAC,mBAAmB,CAAC,qBAAqB;wBAC3C,CAAC,CAAC,EAAE,qBAAqB,EAAE,mBAAmB,CAAC,qBAAqB,EAAE;wBACtE,CAAC,CAAC,EAAE,CAAC;oBACP,MAAM,EAAE,aAAa;oBACrB,OAAO,EAAE,uBAAuB,CAAC,WAAW;iBAC7C,CAAwF,CAAC;YAC5F,CAAC;YAED,MAAM,GAAG,GAA6C,aAAa,CAAC;YAEpE,OAAO,IAAA,iDAAgC,EAAC;gBACtC,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,uBAAuB,CAAC,WAAW;aAC7C,CAAwF,CAAC;QAC5F,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/type-inference-verification/tool-client-inference.d.ts

@@ -0,0 +1,3 @@
+export declare function run(): Promise<void>;
+export declare function gogo(): Promise<void>;
+//# sourceMappingURL=tool-client-inference.d.ts.map

package/dist/src/type-inference-verification/tool-client-inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-client-inference.d.ts","sourceRoot":"","sources":["../../../src/type-inference-verification/tool-client-inference.ts"],"names":[],"mappings":"AAqEA,wBAAsB,GAAG,kBA6FxB;AAwDD,wBAAsB,IAAI,kBAiCzB"}

package/dist/src/type-inference-verification/tool-client-inference.js

@@ -0,0 +1,220 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+exports.gogo = gogo;
+const zod_1 = require("zod");
+const vincent_tool_sdk_1 = require("@lit-protocol/vincent-tool-sdk");
+const vincentToolClient_1 = require("../toolClient/vincentToolClient");
+const currencyPolicy = (0, vincent_tool_sdk_1.createVincentPolicy)({
+    packageName: 'currency-policy',
+    toolParamsSchema: zod_1.z.object({ currency: zod_1.z.string() }),
+    evaluate: async ({ toolParams }, ctx) => ctx.allow({ approvedCurrency: toolParams.currency }),
+    evalAllowResultSchema: zod_1.z.object({ approvedCurrency: zod_1.z.string() }),
+    evalDenyResultSchema: zod_1.z.object({ borked: zod_1.z.string() }),
+});
+const currencyToolPolicy = (0, vincent_tool_sdk_1.createVincentToolPolicy)({
+    toolParamsSchema: zod_1.z.object({
+        currency: zod_1.z.string(),
+    }),
+    bundledVincentPolicy: (0, vincent_tool_sdk_1.asBundledVincentPolicy)(currencyPolicy, 'QmCurrency123'),
+    toolParameterMappings: {
+        currency: 'currency',
+    },
+});
+const rateLimitPolicy = (0, vincent_tool_sdk_1.createVincentPolicy)({
+    packageName: 'rate-limit',
+    toolParamsSchema: zod_1.z.object({ userId: zod_1.z.string() }),
+    evaluate: async (_, ctx) => ctx.allow({ allowed: true }),
+    evalAllowResultSchema: zod_1.z.object({ allowed: zod_1.z.literal(true) }),
+    commit: async (_, ctx) => ctx.allow({ committed: true }),
+    commitAllowResultSchema: zod_1.z.object({ committed: zod_1.z.boolean() }),
+});
+const rateLimitToolPolicy = (0, vincent_tool_sdk_1.createVincentToolPolicy)({
+    toolParamsSchema: zod_1.z.object({
+        userId: zod_1.z.string(),
+    }),
+    bundledVincentPolicy: (0, vincent_tool_sdk_1.asBundledVincentPolicy)(rateLimitPolicy, 'QmRateLimit123'),
+    toolParameterMappings: {
+        userId: 'userId',
+    },
+});
+const toolParamsSchema = zod_1.z.object({
+    currency: zod_1.z.string(),
+    userId: zod_1.z.string(),
+});
+const tool = (0, vincent_tool_sdk_1.createVincentTool)({
+    packageName: '@lit-protocol/yestool3@1.0.0',
+    toolDescription: 'Yes Tool',
+    toolParamsSchema,
+    supportedPolicies: (0, vincent_tool_sdk_1.supportedPoliciesForTool)([currencyToolPolicy, rateLimitToolPolicy]),
+    execute: async ({ toolParams }, ctx) => ctx.succeed({ ok: true }),
+    executeSuccessSchema: zod_1.z.object({ ok: zod_1.z.literal(true) }),
+});
+const client = (0, vincentToolClient_1.getVincentToolClient)({
+    bundledVincentTool: (0, vincent_tool_sdk_1.asBundledVincentTool)(tool, 'QmFakeTool123'),
+    ethersSigner: {}, // stubbed
+});
+async function run() {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+    const toolParams = {
+        currency: 'USD',
+        userId: 'user-123',
+    };
+    const precheckResult = await client.precheck(toolParams, {
+        delegatorPkpEthAddress: '0xabc',
+    });
+    if (precheckResult.success === true) {
+        // ✅ Inferred success result shape
+        const successResult = precheckResult.result;
+        // Should be ok to access successResult with correct type
+        if (successResult !== undefined) {
+            // @ts-expect-error - no properties defined on undefined schema
+            console.log(successResult.foo);
+        }
+        const policiesContext = (_a = precheckResult === null || precheckResult === void 0 ? void 0 : precheckResult.context) === null || _a === void 0 ? void 0 : _a.policiesContext;
+        if (precheckResult && policiesContext && policiesContext.allow) {
+            const p = policiesContext.allowedPolicies;
+            // ✅ Should infer currency-policy result shape
+            if (p['currency-policy']) {
+                // @ts-expect-error There is no precheck result schema; result must be undefined
+                p['currency-policy'].result.approvedCurrency.toUpperCase();
+                // @ts-expect-error - no commit on currency-policy
+                p['currency-policy'].commit();
+            }
+            // ✅ Should infer rate-limit result shape and commit
+            if (p['rate-limit']) {
+                // @ts-expect-error There is no precheck result schema; result must be undefined
+                const val = p['rate-limit'].result.allowed;
+                console.log(val);
+            }
+            // @ts-expect-error - policy not in map
+            console.log(p['non-existent-policy']);
+        }
+    }
+    else {
+        // ✅ Inferred failure shape
+        const fail = precheckResult.result;
+        // @ts-expect-error - fail is z.undefined(), cannot have properties
+        console.log(fail.reason);
+        // Can still access error message
+        (_b = precheckResult.runtimeError) === null || _b === void 0 ? void 0 : _b.toUpperCase();
+        // Should still be optional policiesContext
+        const deniedPolicy = (_d = (_c = precheckResult.context) === null || _c === void 0 ? void 0 : _c.policiesContext) === null || _d === void 0 ? void 0 : _d.deniedPolicy;
+        if (deniedPolicy) {
+            if (deniedPolicy.packageName === 'currency-policy' &&
+                deniedPolicy.result &&
+                // @ts-expect-error There's no precheck deny schema!
+                deniedPolicy.result.borked) {
+                // @ts-expect-error There's no precheck deny schema!
+                console.log(deniedPolicy.result.borked);
+            }
+            console.log(deniedPolicy.result);
+        }
+    }
+    // 🧪 Now check execute inference
+    const executeResult = await client.execute(toolParams, {
+        delegatorPkpEthAddress: '0x09182301238',
+    });
+    if (executeResult.success === true) {
+        if (executeResult.result) {
+            const val = executeResult.result;
+            // @ts-expect-error - invalid field on success result
+            console.log(val.failureReason);
+            const result = (_f = (_e = executeResult.context) === null || _e === void 0 ? void 0 : _e.policiesContext) === null || _f === void 0 ? void 0 : _f.allowedPolicies;
+            if (result) {
+                const currencyPolicyResult = result['currency-policy'];
+                if (currencyPolicyResult) {
+                    console.log(currencyPolicyResult.result.approvedCurrency);
+                }
+            }
+        }
+    }
+    else {
+        console.log((_j = (_h = (_g = executeResult.context) === null || _g === void 0 ? void 0 : _g.policiesContext) === null || _h === void 0 ? void 0 : _h.deniedPolicy) === null || _j === void 0 ? void 0 : _j.result);
+    }
+}
+const fullSchemaPolicy = (0, vincent_tool_sdk_1.createVincentPolicy)({
+    packageName: 'full-policy',
+    toolParamsSchema: zod_1.z.object({ count: zod_1.z.number() }),
+    evaluate: async ({ toolParams }, ctx) => {
+        if (toolParams.count > 0) {
+            return ctx.allow({ result: 'ok' });
+        }
+        else {
+            return ctx.deny({ reason: 'must be > 0' });
+        }
+    },
+    evalAllowResultSchema: zod_1.z.object({ result: zod_1.z.literal('ok') }),
+    evalDenyResultSchema: zod_1.z.object({ reason: zod_1.z.string() }),
+});
+const fullSchemaToolPolicy = (0, vincent_tool_sdk_1.createVincentToolPolicy)({
+    toolParamsSchema: zod_1.z.object({ count: zod_1.z.number() }),
+    bundledVincentPolicy: (0, vincent_tool_sdk_1.asBundledVincentPolicy)(fullSchemaPolicy, 'QmFullSchema123'),
+    toolParameterMappings: {
+        count: 'count',
+    },
+});
+const fullTool = (0, vincent_tool_sdk_1.createVincentTool)({
+    packageName: '@lit-protocol/yestool3@1.0.0',
+    toolDescription: 'Yes Tool',
+    toolParamsSchema: zod_1.z.object({ count: zod_1.z.number() }),
+    supportedPolicies: (0, vincent_tool_sdk_1.supportedPoliciesForTool)([fullSchemaToolPolicy]),
+    precheck: async ({ toolParams }, ctx) => {
+        if (toolParams.count > 10) {
+            return ctx.succeed({ accepted: true });
+        }
+        else {
+            return ctx.fail({ reason: 'too small' });
+        }
+    },
+    precheckSuccessSchema: zod_1.z.object({ accepted: zod_1.z.literal(true) }),
+    precheckFailSchema: zod_1.z.object({ reason: zod_1.z.string() }),
+    execute: async ({ toolParams }, ctx) => {
+        if (toolParams.count < 100) {
+            return ctx.succeed({ ok: true });
+        }
+        else {
+            return ctx.fail({ reason: 'too big' });
+        }
+    },
+    executeSuccessSchema: zod_1.z.object({ ok: zod_1.z.literal(true) }),
+    executeFailSchema: zod_1.z.object({ reason: zod_1.z.string() }),
+});
+const fullClient = (0, vincentToolClient_1.getVincentToolClient)({
+    bundledVincentTool: (0, vincent_tool_sdk_1.asBundledVincentTool)(fullTool, 'QmFullTool123'),
+    ethersSigner: {},
+});
+const fullParams = { count: 5 };
+async function gogo() {
+    const precheck = await fullClient.precheck(fullParams, {
+        delegatorPkpEthAddress: '0x1sfskjdfhf',
+    });
+    if (precheck.success === true) {
+        const ok = precheck.result.accepted;
+        console.log(ok);
+        // @ts-expect-error foo not valid on precheck result
+        console.log(precheck.result.foo);
+    }
+    else {
+        const reason = precheck.result.reason;
+        console.log(reason);
+        // @ts-expect-error accepted not valid on failure!
+        console.log(precheck.result.accepted);
+    }
+    const execute = await fullClient.execute(fullParams, {
+        delegatorPkpEthAddress: '0x098479847928734',
+    });
+    if (execute.success === true) {
+        const val = execute.result.ok;
+        console.log(val);
+        // @ts-expect-error reason not valid on success result
+        console.log(execute.result.reason);
+    }
+    else {
+        const msg = execute.result.reason;
+        console.log(msg);
+        // @ts-expect-error OK not valid on failure result
+        console.log(execute.result.ok);
+    }
+}
+//# sourceMappingURL=tool-client-inference.js.map

package/dist/src/type-inference-verification/tool-client-inference.js.map

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

package/dist/src/utils/delegation.d.ts

@@ -0,0 +1,7 @@
+import type { GetDelegatorsAgentPkpsParams } from './types';
+/** Get a (paginated) list of delegator agent PKPs for a specific app version
+ *
+ * See documentation at {@link vincent-contracts-sdk!getDelegatedPkpEthAddresses | vincent-contracts-sdk/getDelegatedPkpEthAddresses}
+ */
+export declare function getDelegatorsAgentPkpAddresses(params: GetDelegatorsAgentPkpsParams): Promise<string[]>;
+//# sourceMappingURL=delegation.d.ts.map

package/dist/src/utils/delegation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation.d.ts","sourceRoot":"","sources":["../../../src/utils/delegation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAE5D;;;GAGG;AACH,wBAAsB,8BAA8B,CAAC,MAAM,EAAE,4BAA4B,qBASxF"}