@lit-protocol/vincent-app-sdk 0.0.5-mma → 0.0.7-mma

package/CHANGELOG.md

@@ -2,18 +2,18 @@
 
 ### 🩹 Fixes
 
-- #### VincentToolClient Precheck fixes ([8da32df2](https://github.com/LIT-Protocol/Vincent/commit/8da32df2))
+- #### VincentAbilityClient Precheck fixes ([8da32df2](https://github.com/LIT-Protocol/Vincent/commit/8da32df2))
 
   - Fix a case where deny results from `precheck()` were not correctly bubbled to the caller
   - Fixed incorrect return type shape - `error` is a sibling of `result` in the policiesContext- Ensured `error` is bubbled up to the caller when provided
 
-- - VincentToolClient - Expose correct policiesContext type when calling `precheck()` ([812d4fe9](https://github.com/LIT-Protocol/Vincent/commit/812d4fe9))
-- - `VincentToolClient` - Fixed case where a tool without its own `precheck()` function would return `success` result even if a policy returned an `deny` result from its `precheck()` ([71380b89](https://github.com/LIT-Protocol/Vincent/commit/71380b89))
-- - `VincentToolClient` - Fixed case where a fail response did not return the `error` or `result` response to the caller correctly ([30e32f1e](https://github.com/LIT-Protocol/Vincent/commit/30e32f1e))
+- - VincentAbilityClient - Expose correct policiesContext type when calling `precheck()` ([812d4fe9](https://github.com/LIT-Protocol/Vincent/commit/812d4fe9))
+- - `VincentAbilityClient` - Fixed case where an ability without its own `precheck()` function would return `success` result even if a policy returned an `deny` result from its `precheck()` ([71380b89](https://github.com/LIT-Protocol/Vincent/commit/71380b89))
+- - `VincentAbilityClient` - Fixed case where a fail response did not return the `error` or `result` response to the caller correctly ([30e32f1e](https://github.com/LIT-Protocol/Vincent/commit/30e32f1e))
 
 ### 🧱 Updated Dependencies
 
-- Updated tool-sdk to 1.0.2
+- Updated ability-sdk to 1.0.2
 
 ### ❤️ Thank You
 
@@ -39,7 +39,7 @@
 - **vincent-app-sdk:** Add sdk-docs TypeDocs to root of repo ([fb15599](https://github.com/LIT-Protocol/Vincent/commit/fb15599))
 - **vincent-app-sdk:** Return both the original JWT string and the decoded JWT object from `decodeVincentLoginJWT()` - Also fixed inverted logic check for `isLoginUri()`, and converted to object params for `isLoginUri()` ([c2f3a19](https://github.com/LIT-Protocol/Vincent/commit/c2f3a19))
 - **vincent-app-sdk:** Add `removeLoginJWTFromURI()` method to `VincentWebAppClient` ([17072f4](https://github.com/LIT-Protocol/Vincent/commit/17072f4))
-- **vincent-app-sdk:** Replace `pkp/delegatee-sigs` with a `VincentToolClient` - Exposes a single method, `getVincentToolClient()`, which Vincent app developers will use to interact with Vincent Tool LIT actions - Fixes existing code that created new instances of LitNodeClient and connecting to them every time the tool is interacted with, using newly minted singleton module - Initial TSDoc configurations for exposing the tool client construction and usage under a 'Vincent Tools' category. ([2052ebe](https://github.com/LIT-Protocol/Vincent/commit/2052ebe))
+- **vincent-app-sdk:** Replace `pkp/delegatee-sigs` with a `VincentAbilityClient` - Exposes a single method, `getVincentAbilityClient()`, which Vincent app developers will use to interact with Vincent Ability LIT actions - Fixes existing code that created new instances of LitNodeClient and connecting to them every time the ability is interacted with, using newly minted singleton module - Initial TSDoc configurations for exposing the ability client construction and usage under a 'Vincent Abilities' category. ([2052ebe](https://github.com/LIT-Protocol/Vincent/commit/2052ebe))
 - **vincent-app-sdk:** Define an internal module for managing a singleton instance of a LitNodeClient ([d297b0c](https://github.com/LIT-Protocol/Vincent/commit/d297b0c))
 - update vincent sdk readme ([090614d](https://github.com/LIT-Protocol/Vincent/commit/090614d))
 - added contracts class ([ef1851e](https://github.com/LIT-Protocol/Vincent/commit/ef1851e))
@@ -49,7 +49,7 @@
 - ZodSchemmaMap typo ([095f38e](https://github.com/LIT-Protocol/Vincent/commit/095f38e))
 - doc reference ([b1450f8](https://github.com/LIT-Protocol/Vincent/commit/b1450f8))
 - remove unnecessary type annotation ([c71eeac](https://github.com/LIT-Protocol/Vincent/commit/c71eeac))
-- sdk nx project linting tool ([82dd819](https://github.com/LIT-Protocol/Vincent/commit/82dd819))
+- sdk nx project linting ability ([82dd819](https://github.com/LIT-Protocol/Vincent/commit/82dd819))
 - **docs:** rename (remove API) ([a4b8e83](https://github.com/LIT-Protocol/Vincent/commit/a4b8e83))
 - **docs:** formatting fixes, custom css for :::info ([6f2fcef](https://github.com/LIT-Protocol/Vincent/commit/6f2fcef))
 - **vincent-app-sdk:** Fix import of `JWT_ERROR` to import from root of `did-jwt` package ([dd96111](https://github.com/LIT-Protocol/Vincent/commit/dd96111))

package/CONTRIBUTING.md

@@ -4,7 +4,7 @@ This document provides guidelines for contributing to the Vincent SDK project.
 
 ## Overview
 
-The Vincent SDK is a TypeScript SDK that exposes useful tools to interact with Vincent systems in web or Node.js environments. It provides client libraries for both frontend applications and backend services.
+The Vincent SDK is a TypeScript SDK that exposes useful abilities to interact with Vincent systems in web or Node.js environments. It provides client libraries for both frontend applications and backend services.
 
 ## Setup
 
@@ -39,17 +39,16 @@ pnpm typedoc
   - `app/`: Web utilities to authenticate against Vincent Apps in clients
   - `express-authentication-middleware/`: Express middleware wrapper to properly validate clients JWT server side
   - `jwt/`: Utility functions to work with Vincent JWT between Vincent Apps client and server
-  - `tool/`: Utility functions to work with Vincent Tools
 
 ## SDK Components
 
 ### WebAuthClient
 
-The Vincent Web Auth Client provides methods for managing user authentication, JWT tokens, and consent flows in Vincent applications.
+The Vincent Web Auth Client provides methods for managing user authentication, JWT tokens, and connect flows in Vincent applications.
 
-### VincentToolClient
+### VincentAbilityClient
 
-The Vincent Tool Client uses an ethers signer for your delegatee account to run Vincent Tools on behalf of your app users.
+The Vincent Ability Client uses an ethers signer for your delegatee account to run Vincent Abilities on behalf of your app users.
 
 ## Coding Standards
 

package/README.md

@@ -12,34 +12,34 @@ npm install @lit-protocol/vincent-app-sdk
 
 ## WebAuthClient
 
-The Vincent Web Auth Client provides methods for managing user authentication, JWT tokens, and consent flows in Vincent applications.
+The Vincent Web Auth Client provides methods for managing user authentication, JWT tokens, and connect flows in Vincent applications.
 
 ### Methods
 
-#### redirectToConsentPage()
+#### redirectToConnectPage()
 
-Redirects the user to the Vincent consent page to obtain authorization. Once the user has completed the vincent consent flow
+Redirects the user to the Vincent connect page to obtain authorization. Once the user has completed the vincent connect flow
 they will be redirected back to your app with a signed JWT that you can use to authenticate requests against your backend APIs
 
 - When a JWT is expired, you need to use this method to get a new JWT
 
-#### isLoginUri()
+#### uriContainsVincentJWT()
 
-Checks if the current window location contains a Vincent login JWT. You can use this method to know that you should update login state with the newly provided JWT
+Checks if the current window location contains a Vincent connect JWT. You can use this method to know that you should update connect state with the newly provided JWT
 
-- Returns: Boolean indicating if the URI contains a login JWT
+- Returns: Boolean indicating if the URI contains a connect JWT
 
-#### decodeVincentLoginJWT(expectedAudience)
+#### decodeVincentJWT(expectedAudience)
 
-Decodes a Vincent login JWT. Performs basic sanity check but does not perform full verify() logic. You will want to run `verify()` from the jwt tools to verify the JWT is fully valid and not expired etc.
+Decodes a Vincent connect JWT. Performs basic sanity check but does not perform full verify() logic. You will want to run `verify()` from the jwt abilities to verify the JWT is fully valid and not expired etc.
 
 - The expected audience is typically your app's domain -- it should be one of your valid redirectUri values from your Vincent app configuration
 
 - Returns: An object containing both the original JWT string and the decoded JWT object
 
-#### removeLoginJWTFromURI()
+#### removeVincentJWTFromURI()
 
-Removes the login JWT parameter from the current URI. Call this after you have verified and stored the JWT for later usage.
+Removes the connect JWT parameter from the current URI. Call this after you have verified and stored the JWT for later usage.
 
 ### Basic Usage
 
@@ -49,9 +49,9 @@ import { isExpired } from '@lit-protocol/vincent-app-sdk/jwt';
 
 const vincentAppClient = getWebAuthClient({ appId: MY_APP_ID });
 // ... In your app logic:
-if (vincentAppClient.isLogin()) {
+if (vincentAppClient.uriContainsVincentJWT()) {
   // Handle app logic for the user has just logged in
-  const { decoded, jwt } = vincentAppClient.decodeVincentLoginJWT(window.location.origin);
+  const { decoded, jwt } = vincentAppClient.decodeVincentJWT(window.location.origin);
   // Store `jwt` for later usage; the user is now logged in.
 } else {
   // Handle app logic for the user is _already logged in_ (check for stored & unexpired JWT)
@@ -59,12 +59,12 @@ if (vincentAppClient.isLogin()) {
   const jwt = localStorage.getItem('VINCENT_AUTH_JWT');
   if (jwt && isExpired(jwt)) {
     // User must re-log in
-    vincentAppClient.redirectToConsentPage({ redirectUri: window.location.href });
+    vincentAppClient.redirectToConnectPage({ redirectUri: window.location.href });
   }
 
   if (!jwt) {
     // Handle app logic for the user is not yet logged in
-    vincentAppClient.redirectToConsentPage({ redirectUri: window.location.href });
+    vincentAppClient.redirectToConnectPage({ redirectUri: window.location.href });
   }
 }
 ```
@@ -73,63 +73,63 @@ if (vincentAppClient.isLogin()) {
 
 In your backend, you will have to verify the JWT to make sure the user has granted you the required permissions to act on their behalf.
 
-## VincentToolClient
+## VincentAbilityClient
 
-The Vincent Tool Client uses an ethers signer for your delegatee account to run Vincent Tools on behalf of your app users.
+The Vincent Ability Client uses an ethers signer for your delegatee account to run Vincent Abilities on behalf of your app users.
 
-This client will typically be used by an AI agent or your app backend service, as it requires a signer that conforms to the ethers v5 signer API, and with access to your delegatee account's private key to authenticate with the LIT network when executing the Vincent Tool.
+This client will typically be used by an AI agent or your app backend service, as it requires a signer that conforms to the ethers v5 signer API, and with access to your delegatee account's private key to authenticate with the LIT network when executing the Vincent Ability.
 
 ### Configuration
 
 ```typescript
-interface VincentToolClientConfig {
+interface VincentAbilityClientConfig {
   ethersSigner: ethers.Signer; // An ethers v5 compatible signer
-  vincentToolCid: string; // The CID of the Vincent Tool to execute
+  vincentAbilityCid: string; // The CID of the Vincent Ability to execute
 }
 ```
 
 ### Methods
 
-#### execute(params: VincentToolParams): Promise<ExecuteJsResponse>
+#### execute(params: VincentAbilityParams): Promise<ExecuteJsResponse>
 
-Executes a Vincent Tool with the provided parameters.
+Executes a Vincent Ability with the provided parameters.
 
-- `params`: Record<string, unknown> - Parameters to pass to the Vincent Tool
+- `params`: Record<string, unknown> - Parameters to pass to the Vincent Ability
 - Returns: Promise resolving to an ExecuteJsResponse from the LIT network
 
-### Tool execution
+### Ability execution
 
 ```typescript
-import { getVincentToolClient } from '@lit-protocol/vincent-app-sdk/toolClient';
-// Import the tool you want to execute
-import { bundledVincentTool as erc20BundledTool } from '@lit-protocol/vincent-tool-erc20-approval';
+import { getVincentAbilityClient } from '@lit-protocol/vincent-app-sdk/abilityClient';
+// Import the ability you want to execute
+import { bundledVincentAbility as erc20BundledAbility } from '@lit-protocol/vincent-ability-erc20-approval';
 
 // One of delegatee signers from your app's Vincent Dashboard
 const delegateeSigner = new ethers.Wallet('YOUR_DELEGATEE_PRIVATE_KEY');
 
-// Initialize the Vincent Tool Client
-const toolClient = getVincentToolClient({
+// Initialize the Vincent Ability Client
+const abilityClient = getVincentAbilityClient({
   ethersSigner: delegateeSigner,
-  bundledVincentTool: erc20BundledTool,
+  bundledVincentAbility: erc20BundledAbility,
 });
 const delegatorPkpEthAddress = '0x09182301238';
 
-const toolParams = {
-  // Fill with the params your tool needs
+const abilityParams = {
+  // Fill with the params your ability needs
 };
 
-// Run precheck to see if tool should be executed
-const precheckResult = await client.precheck(toolParams, {
+// Run precheck to see if ability should be executed
+const precheckResult = await client.precheck(abilityParams, {
   delegatorPkpEthAddress,
 });
 
 if (precheckResult.success === true) {
-  // Execute the Vincent Tool
-  const executeResult = await client.execute(toolParams, {
+  // Execute the Vincent Ability
+  const executeResult = await client.execute(abilityParams, {
     delegatorPkpEthAddress,
   });
 
-  // ...tool has executed, you can check `executeResult` for details
+  // ...ability has executed, you can check `executeResult` for details
 }
 ```
 
@@ -176,13 +176,13 @@ app.get('/profile', authenticateUser, authenticatedRequestHandler(getUserProfile
 
 ### Overview
 
-The JWT authentication system in Vincent SDK allows for secure communication between user applications and Vincent Tools. JWTs are used to verify user consent and authorize tool executions.
+The JWT authentication system in Vincent SDK allows for secure communication between user applications and Vincent Abilities. JWTs are used to verify user connect and authorize ability executions.
 
 ### Authentication Flow
 
-1. User initiates an action requiring Vincent Tool access
-2. Application redirects to the Vincent consent page using `VincentWebAppClient.redirectToConsentPage()`
-3. User provides consent for the requested tools/policies
+1. User initiates an action requiring Vincent Ability access
+2. Application redirects to the Vincent connect page using `VincentWebAppClient.redirectToConnectPage()`
+3. User provides login for the requested abilities/policies
 4. User is redirected back to the application with a JWT in the URL
 5. Application validates and stores the JWT using `VincentWebAppClient` methods
 6. JWT is used to authenticate with the app backend
@@ -202,7 +202,7 @@ When JWT validation fails, descriptive error messages are thrown to help with tr
 ### Usage Notes
 
 - JWTs have an expiration time after which they are no longer valid
-- When a JWT expires, redirect the user to the consent page to obtain a new one using the `VincentWebAppClient`
+- When a JWT expires, redirect the user to the connect page to obtain a new one using the `VincentWebAppClient`
 
 ## Release
 

package/dist/CHANGELOG.md

@@ -2,18 +2,18 @@
 
 ### 🩹 Fixes
 
-- #### VincentToolClient Precheck fixes ([8da32df2](https://github.com/LIT-Protocol/Vincent/commit/8da32df2))
+- #### VincentAbilityClient Precheck fixes ([8da32df2](https://github.com/LIT-Protocol/Vincent/commit/8da32df2))
 
   - Fix a case where deny results from `precheck()` were not correctly bubbled to the caller
   - Fixed incorrect return type shape - `error` is a sibling of `result` in the policiesContext- Ensured `error` is bubbled up to the caller when provided
 
-- - VincentToolClient - Expose correct policiesContext type when calling `precheck()` ([812d4fe9](https://github.com/LIT-Protocol/Vincent/commit/812d4fe9))
-- - `VincentToolClient` - Fixed case where a tool without its own `precheck()` function would return `success` result even if a policy returned an `deny` result from its `precheck()` ([71380b89](https://github.com/LIT-Protocol/Vincent/commit/71380b89))
-- - `VincentToolClient` - Fixed case where a fail response did not return the `error` or `result` response to the caller correctly ([30e32f1e](https://github.com/LIT-Protocol/Vincent/commit/30e32f1e))
+- - VincentAbilityClient - Expose correct policiesContext type when calling `precheck()` ([812d4fe9](https://github.com/LIT-Protocol/Vincent/commit/812d4fe9))
+- - `VincentAbilityClient` - Fixed case where an ability without its own `precheck()` function would return `success` result even if a policy returned an `deny` result from its `precheck()` ([71380b89](https://github.com/LIT-Protocol/Vincent/commit/71380b89))
+- - `VincentAbilityClient` - Fixed case where a fail response did not return the `error` or `result` response to the caller correctly ([30e32f1e](https://github.com/LIT-Protocol/Vincent/commit/30e32f1e))
 
 ### 🧱 Updated Dependencies
 
-- Updated tool-sdk to 1.0.2
+- Updated ability-sdk to 1.0.2
 
 ### ❤️ Thank You
 
@@ -39,7 +39,7 @@
 - **vincent-app-sdk:** Add sdk-docs TypeDocs to root of repo ([fb15599](https://github.com/LIT-Protocol/Vincent/commit/fb15599))
 - **vincent-app-sdk:** Return both the original JWT string and the decoded JWT object from `decodeVincentLoginJWT()` - Also fixed inverted logic check for `isLoginUri()`, and converted to object params for `isLoginUri()` ([c2f3a19](https://github.com/LIT-Protocol/Vincent/commit/c2f3a19))
 - **vincent-app-sdk:** Add `removeLoginJWTFromURI()` method to `VincentWebAppClient` ([17072f4](https://github.com/LIT-Protocol/Vincent/commit/17072f4))
-- **vincent-app-sdk:** Replace `pkp/delegatee-sigs` with a `VincentToolClient` - Exposes a single method, `getVincentToolClient()`, which Vincent app developers will use to interact with Vincent Tool LIT actions - Fixes existing code that created new instances of LitNodeClient and connecting to them every time the tool is interacted with, using newly minted singleton module - Initial TSDoc configurations for exposing the tool client construction and usage under a 'Vincent Tools' category. ([2052ebe](https://github.com/LIT-Protocol/Vincent/commit/2052ebe))
+- **vincent-app-sdk:** Replace `pkp/delegatee-sigs` with a `VincentAbilityClient` - Exposes a single method, `getVincentAbilityClient()`, which Vincent app developers will use to interact with Vincent Ability LIT actions - Fixes existing code that created new instances of LitNodeClient and connecting to them every time the ability is interacted with, using newly minted singleton module - Initial TSDoc configurations for exposing the ability client construction and usage under a 'Vincent Abilities' category. ([2052ebe](https://github.com/LIT-Protocol/Vincent/commit/2052ebe))
 - **vincent-app-sdk:** Define an internal module for managing a singleton instance of a LitNodeClient ([d297b0c](https://github.com/LIT-Protocol/Vincent/commit/d297b0c))
 - update vincent sdk readme ([090614d](https://github.com/LIT-Protocol/Vincent/commit/090614d))
 - added contracts class ([ef1851e](https://github.com/LIT-Protocol/Vincent/commit/ef1851e))
@@ -49,7 +49,7 @@
 - ZodSchemmaMap typo ([095f38e](https://github.com/LIT-Protocol/Vincent/commit/095f38e))
 - doc reference ([b1450f8](https://github.com/LIT-Protocol/Vincent/commit/b1450f8))
 - remove unnecessary type annotation ([c71eeac](https://github.com/LIT-Protocol/Vincent/commit/c71eeac))
-- sdk nx project linting tool ([82dd819](https://github.com/LIT-Protocol/Vincent/commit/82dd819))
+- sdk nx project linting ability ([82dd819](https://github.com/LIT-Protocol/Vincent/commit/82dd819))
 - **docs:** rename (remove API) ([a4b8e83](https://github.com/LIT-Protocol/Vincent/commit/a4b8e83))
 - **docs:** formatting fixes, custom css for :::info ([6f2fcef](https://github.com/LIT-Protocol/Vincent/commit/6f2fcef))
 - **vincent-app-sdk:** Fix import of `JWT_ERROR` to import from root of `did-jwt` package ([dd96111](https://github.com/LIT-Protocol/Vincent/commit/dd96111))

package/dist/CONTRIBUTING.md

@@ -4,7 +4,7 @@ This document provides guidelines for contributing to the Vincent SDK project.
 
 ## Overview
 
-The Vincent SDK is a TypeScript SDK that exposes useful tools to interact with Vincent systems in web or Node.js environments. It provides client libraries for both frontend applications and backend services.
+The Vincent SDK is a TypeScript SDK that exposes useful abilities to interact with Vincent systems in web or Node.js environments. It provides client libraries for both frontend applications and backend services.
 
 ## Setup
 
@@ -39,17 +39,16 @@ pnpm typedoc
   - `app/`: Web utilities to authenticate against Vincent Apps in clients
   - `express-authentication-middleware/`: Express middleware wrapper to properly validate clients JWT server side
   - `jwt/`: Utility functions to work with Vincent JWT between Vincent Apps client and server
-  - `tool/`: Utility functions to work with Vincent Tools
 
 ## SDK Components
 
 ### WebAuthClient
 
-The Vincent Web Auth Client provides methods for managing user authentication, JWT tokens, and consent flows in Vincent applications.
+The Vincent Web Auth Client provides methods for managing user authentication, JWT tokens, and connect flows in Vincent applications.
 
-### VincentToolClient
+### VincentAbilityClient
 
-The Vincent Tool Client uses an ethers signer for your delegatee account to run Vincent Tools on behalf of your app users.
+The Vincent Ability Client uses an ethers signer for your delegatee account to run Vincent Abilities on behalf of your app users.
 
 ## Coding Standards
 

package/dist/README.md

@@ -12,34 +12,34 @@ npm install @lit-protocol/vincent-app-sdk
 
 ## WebAuthClient
 
-The Vincent Web Auth Client provides methods for managing user authentication, JWT tokens, and consent flows in Vincent applications.
+The Vincent Web Auth Client provides methods for managing user authentication, JWT tokens, and connect flows in Vincent applications.
 
 ### Methods
 
-#### redirectToConsentPage()
+#### redirectToConnectPage()
 
-Redirects the user to the Vincent consent page to obtain authorization. Once the user has completed the vincent consent flow
+Redirects the user to the Vincent connect page to obtain authorization. Once the user has completed the vincent connect flow
 they will be redirected back to your app with a signed JWT that you can use to authenticate requests against your backend APIs
 
 - When a JWT is expired, you need to use this method to get a new JWT
 
-#### isLoginUri()
+#### uriContainsVincentJWT()
 
-Checks if the current window location contains a Vincent login JWT. You can use this method to know that you should update login state with the newly provided JWT
+Checks if the current window location contains a Vincent connect JWT. You can use this method to know that you should update connect state with the newly provided JWT
 
-- Returns: Boolean indicating if the URI contains a login JWT
+- Returns: Boolean indicating if the URI contains a connect JWT
 
-#### decodeVincentLoginJWT(expectedAudience)
+#### decodeVincentJWT(expectedAudience)
 
-Decodes a Vincent login JWT. Performs basic sanity check but does not perform full verify() logic. You will want to run `verify()` from the jwt tools to verify the JWT is fully valid and not expired etc.
+Decodes a Vincent connect JWT. Performs basic sanity check but does not perform full verify() logic. You will want to run `verify()` from the jwt abilities to verify the JWT is fully valid and not expired etc.
 
 - The expected audience is typically your app's domain -- it should be one of your valid redirectUri values from your Vincent app configuration
 
 - Returns: An object containing both the original JWT string and the decoded JWT object
 
-#### removeLoginJWTFromURI()
+#### removeVincentJWTFromURI()
 
-Removes the login JWT parameter from the current URI. Call this after you have verified and stored the JWT for later usage.
+Removes the connect JWT parameter from the current URI. Call this after you have verified and stored the JWT for later usage.
 
 ### Basic Usage
 
@@ -49,9 +49,9 @@ import { isExpired } from '@lit-protocol/vincent-app-sdk/jwt';
 
 const vincentAppClient = getWebAuthClient({ appId: MY_APP_ID });
 // ... In your app logic:
-if (vincentAppClient.isLogin()) {
+if (vincentAppClient.uriContainsVincentJWT()) {
   // Handle app logic for the user has just logged in
-  const { decoded, jwt } = vincentAppClient.decodeVincentLoginJWT(window.location.origin);
+  const { decoded, jwt } = vincentAppClient.decodeVincentJWT(window.location.origin);
   // Store `jwt` for later usage; the user is now logged in.
 } else {
   // Handle app logic for the user is _already logged in_ (check for stored & unexpired JWT)
@@ -59,12 +59,12 @@ if (vincentAppClient.isLogin()) {
   const jwt = localStorage.getItem('VINCENT_AUTH_JWT');
   if (jwt && isExpired(jwt)) {
     // User must re-log in
-    vincentAppClient.redirectToConsentPage({ redirectUri: window.location.href });
+    vincentAppClient.redirectToConnectPage({ redirectUri: window.location.href });
   }
 
   if (!jwt) {
     // Handle app logic for the user is not yet logged in
-    vincentAppClient.redirectToConsentPage({ redirectUri: window.location.href });
+    vincentAppClient.redirectToConnectPage({ redirectUri: window.location.href });
   }
 }
 ```
@@ -73,63 +73,63 @@ if (vincentAppClient.isLogin()) {
 
 In your backend, you will have to verify the JWT to make sure the user has granted you the required permissions to act on their behalf.
 
-## VincentToolClient
+## VincentAbilityClient
 
-The Vincent Tool Client uses an ethers signer for your delegatee account to run Vincent Tools on behalf of your app users.
+The Vincent Ability Client uses an ethers signer for your delegatee account to run Vincent Abilities on behalf of your app users.
 
-This client will typically be used by an AI agent or your app backend service, as it requires a signer that conforms to the ethers v5 signer API, and with access to your delegatee account's private key to authenticate with the LIT network when executing the Vincent Tool.
+This client will typically be used by an AI agent or your app backend service, as it requires a signer that conforms to the ethers v5 signer API, and with access to your delegatee account's private key to authenticate with the LIT network when executing the Vincent Ability.
 
 ### Configuration
 
 ```typescript
-interface VincentToolClientConfig {
+interface VincentAbilityClientConfig {
   ethersSigner: ethers.Signer; // An ethers v5 compatible signer
-  vincentToolCid: string; // The CID of the Vincent Tool to execute
+  vincentAbilityCid: string; // The CID of the Vincent Ability to execute
 }
 ```
 
 ### Methods
 
-#### execute(params: VincentToolParams): Promise<ExecuteJsResponse>
+#### execute(params: VincentAbilityParams): Promise<ExecuteJsResponse>
 
-Executes a Vincent Tool with the provided parameters.
+Executes a Vincent Ability with the provided parameters.
 
-- `params`: Record<string, unknown> - Parameters to pass to the Vincent Tool
+- `params`: Record<string, unknown> - Parameters to pass to the Vincent Ability
 - Returns: Promise resolving to an ExecuteJsResponse from the LIT network
 
-### Tool execution
+### Ability execution
 
 ```typescript
-import { getVincentToolClient } from '@lit-protocol/vincent-app-sdk/toolClient';
-// Import the tool you want to execute
-import { bundledVincentTool as erc20BundledTool } from '@lit-protocol/vincent-tool-erc20-approval';
+import { getVincentAbilityClient } from '@lit-protocol/vincent-app-sdk/abilityClient';
+// Import the ability you want to execute
+import { bundledVincentAbility as erc20BundledAbility } from '@lit-protocol/vincent-ability-erc20-approval';
 
 // One of delegatee signers from your app's Vincent Dashboard
 const delegateeSigner = new ethers.Wallet('YOUR_DELEGATEE_PRIVATE_KEY');
 
-// Initialize the Vincent Tool Client
-const toolClient = getVincentToolClient({
+// Initialize the Vincent Ability Client
+const abilityClient = getVincentAbilityClient({
   ethersSigner: delegateeSigner,
-  bundledVincentTool: erc20BundledTool,
+  bundledVincentAbility: erc20BundledAbility,
 });
 const delegatorPkpEthAddress = '0x09182301238';
 
-const toolParams = {
-  // Fill with the params your tool needs
+const abilityParams = {
+  // Fill with the params your ability needs
 };
 
-// Run precheck to see if tool should be executed
-const precheckResult = await client.precheck(toolParams, {
+// Run precheck to see if ability should be executed
+const precheckResult = await client.precheck(abilityParams, {
   delegatorPkpEthAddress,
 });
 
 if (precheckResult.success === true) {
-  // Execute the Vincent Tool
-  const executeResult = await client.execute(toolParams, {
+  // Execute the Vincent Ability
+  const executeResult = await client.execute(abilityParams, {
     delegatorPkpEthAddress,
   });
 
-  // ...tool has executed, you can check `executeResult` for details
+  // ...ability has executed, you can check `executeResult` for details
 }
 ```
 
@@ -176,13 +176,13 @@ app.get('/profile', authenticateUser, authenticatedRequestHandler(getUserProfile
 
 ### Overview
 
-The JWT authentication system in Vincent SDK allows for secure communication between user applications and Vincent Tools. JWTs are used to verify user consent and authorize tool executions.
+The JWT authentication system in Vincent SDK allows for secure communication between user applications and Vincent Abilities. JWTs are used to verify user connect and authorize ability executions.
 
 ### Authentication Flow
 
-1. User initiates an action requiring Vincent Tool access
-2. Application redirects to the Vincent consent page using `VincentWebAppClient.redirectToConsentPage()`
-3. User provides consent for the requested tools/policies
+1. User initiates an action requiring Vincent Ability access
+2. Application redirects to the Vincent connect page using `VincentWebAppClient.redirectToConnectPage()`
+3. User provides login for the requested abilities/policies
 4. User is redirected back to the application with a JWT in the URL
 5. Application validates and stores the JWT using `VincentWebAppClient` methods
 6. JWT is used to authenticate with the app backend
@@ -202,7 +202,7 @@ When JWT validation fails, descriptive error messages are thrown to help with tr
 ### Usage Notes
 
 - JWTs have an expiration time after which they are no longer valid
-- When a JWT expires, redirect the user to the consent page to obtain a new one using the `VincentWebAppClient`
+- When a JWT expires, redirect the user to the connect page to obtain a new one using the `VincentWebAppClient`
 
 ## Release
 

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lit-protocol/vincent-app-sdk",
-  "version": "0.0.4-mma",
+  "version": "1.0.2",
   "description": "Vincent SDK for browser and backend",
   "author": "Lit Protocol",
   "license": "ISC",
@@ -20,10 +20,10 @@
       "require": "./dist/src/jwt/index.js",
       "types": "./dist/src/jwt/index.d.ts"
     },
-    "./toolClient": {
-      "import": "./dist/src/toolClient/index.js",
-      "require": "./dist/src/toolClient/index.js",
-      "types": "./dist/src/toolClient/index.d.ts"
+    "./abilityClient": {
+      "import": "./dist/src/abilityClient/index.js",
+      "require": "./dist/src/abilityClient/index.js",
+      "types": "./dist/src/abilityClient/index.d.ts"
     },
     "./webAuthClient": {
       "import": "./dist/src/webAuthClient/index.js",
@@ -56,7 +56,7 @@
     "@lit-protocol/constants": "^7.0.8",
     "@lit-protocol/lit-node-client": "^7.0.8",
     "@lit-protocol/vincent-contracts-sdk": "workspace:*",
-    "@lit-protocol/vincent-tool-sdk": "workspace:*",
+    "@lit-protocol/vincent-ability-sdk": "workspace:*",
     "@noble/secp256k1": "^2.2.3",
     "did-jwt": "^8.0.8",
     "ethers": "5.8.0",

package/dist/src/abilityClient/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/abilityClient/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,UAAU,CAAC"}

package/dist/src/abilityClient/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/abilityClient/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,wBAAwB,GAAG,OAAO,CAAC"}

package/dist/src/{toolClient/execute/generateVincentToolSessionSigs.d.ts → abilityClient/execute/generateVincentAbilitySessionSigs.d.ts}

@@ -1,8 +1,8 @@
 import type { ethers } from 'ethers';
 import type { LitNodeClient } from '@lit-protocol/lit-node-client';
 /** @hidden */
-export declare const generateVincentToolSessionSigs: ({ litNodeClient, ethersSigner, }: {
+export declare const generateVincentAbilitySessionSigs: ({ litNodeClient, ethersSigner, }: {
     litNodeClient: LitNodeClient;
     ethersSigner: ethers.Signer;
 }) => Promise<import("@lit-protocol/types").SessionSigsMap>;
-//# sourceMappingURL=generateVincentToolSessionSigs.d.ts.map
+//# sourceMappingURL=generateVincentAbilitySessionSigs.d.ts.map

package/dist/src/abilityClient/execute/generateVincentAbilitySessionSigs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateVincentAbilitySessionSigs.d.ts","sourceRoot":"","sources":["../../../../src/abilityClient/execute/generateVincentAbilitySessionSigs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAUnE,cAAc;AACd,eAAO,MAAM,iCAAiC,GAAU,kCAGrD;IACD,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;CAC7B,0DAyBA,CAAC"}

package/dist/src/{toolClient/execute/generateVincentToolSessionSigs.js → abilityClient/execute/generateVincentAbilitySessionSigs.js}

@@ -1,11 +1,11 @@
 "use strict";
-// src/toolClient/execute/generateVincentToolSessionSigs.ts
+// src/abilityClient/execute/generateVincentAbilitySessionSigs.ts
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateVincentToolSessionSigs = void 0;
+exports.generateVincentAbilitySessionSigs = void 0;
 const auth_helpers_1 = require("@lit-protocol/auth-helpers");
 const constants_1 = require("@lit-protocol/constants");
 /** @hidden */
-const generateVincentToolSessionSigs = async ({ litNodeClient, ethersSigner, }) => {
+const generateVincentAbilitySessionSigs = async ({ litNodeClient, ethersSigner, }) => {
     return litNodeClient.getSessionSigs({
         chain: 'ethereum',
         resourceAbilityRequests: [
@@ -29,5 +29,5 @@ const generateVincentToolSessionSigs = async ({ litNodeClient, ethersSigner, })
         },
     });
 };
-exports.generateVincentToolSessionSigs = generateVincentToolSessionSigs;
-//# sourceMappingURL=generateVincentToolSessionSigs.js.map
+exports.generateVincentAbilitySessionSigs = generateVincentAbilitySessionSigs;
+//# sourceMappingURL=generateVincentAbilitySessionSigs.js.map

package/dist/src/abilityClient/execute/generateVincentAbilitySessionSigs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateVincentAbilitySessionSigs.js","sourceRoot":"","sources":["../../../../src/abilityClient/execute/generateVincentAbilitySessionSigs.ts"],"names":[],"mappings":";AAAA,iEAAiE;;;AAMjE,6DAKoC;AACpC,uDAAsD;AAEtD,cAAc;AACP,MAAM,iCAAiC,GAAG,KAAK,EAAE,EACtD,aAAa,EACb,YAAY,GAIb,EAAE,EAAE;IACH,OAAO,aAAa,CAAC,cAAc,CAAC;QAClC,KAAK,EAAE,UAAU;QACjB,uBAAuB,EAAE;YACvB,EAAE,QAAQ,EAAE,IAAI,6BAAc,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,uBAAW,CAAC,UAAU,EAAE;YACtE,EAAE,QAAQ,EAAE,IAAI,gCAAiB,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,uBAAW,CAAC,kBAAkB,EAAE;SAClF;QACD,kBAAkB,EAAE,KAAK,EAAE,EAAE,uBAAuB,EAAE,GAAG,EAAE,EAAE,EAAE;YAC7D,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC/C,YAAY,CAAC,UAAU,EAAE;gBACzB,aAAa,CAAC,kBAAkB,EAAE;aACnC,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,IAAA,0CAA2B,EAAC;gBAC/C,GAAG,EAAE,GAAG,IAAI,uBAAuB;gBACnC,UAAU,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE;gBAC/D,SAAS,EAAE,uBAAuB,IAAI,EAAE;gBACxC,aAAa;gBACb,KAAK;gBACL,aAAa;aACd,CAAC,CAAC;YAEH,OAAO,MAAM,IAAA,8BAAe,EAAC,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;QACjE,CAAC;KACF,CAAC,CAAC;AACL,CAAC,CAAC;AA/BW,QAAA,iCAAiC,qCA+B5C"}