@bytexbyte/nxtlinq-ai-agent-sdk 1.1.8 → 1.2.0

package/README.md

@@ -13,15 +13,17 @@ A powerful SDK for building intelligent conversation applications with Nxtlinq A
 - 🔌 Easy integration with React applications
 - 🔒 Secure authentication and API key management
 - 👛 MetaMask wallet integration
-- 🔐 AIT (AI Token) management
+- 🔐 AIT (AI Identity Token) management
 - 🔑 Permission-based access control
+- 🔍 Enhanced error handling and debugging
+- ⚡ Improved async operation handling
 
 ## Installation
 
 ```bash
-npm install @bytexbyte/nxtlinq-ai-agent-sdk
+npm install @bytexbyte/nxtlinq-ai-agent-sdk@1.1.9
 # or
-yarn add @bytexbyte/nxtlinq-ai-agent-sdk
+yarn add @bytexbyte/nxtlinq-ai-agent-sdk@1.1.9
 ```
 
 ## Quick Start
@@ -59,8 +61,8 @@ function App() {
       onMessage={handleMessage}
       onToolUse={handleToolUse}
       presetMessages={presetMessages}
-      onVerifyWallet={async (address) => {
-        // Implement your wallet verification logic here
+      onVerifyWallet={async () => {
+        // Implement Berify.me verification
         return { token: 'verification-token' };
       }}
     />
@@ -68,47 +70,47 @@ function App() {
 }
 ```
 
-## API Reference
-
-### NxtlinqAITSDK
-
-| Method | Description |
-|--------|-------------|
-| `connectWallet()` | Connect to MetaMask wallet |
-| `verifyWallet(token: string, method: string)` | Verify wallet ownership |
-| `signInWithWallet()` | Sign in using wallet |
-| `generateAndRegisterAIT(permissions: string[])` | Generate and register a new AIT |
-| `getAIT()` | Get AIT information |
-| `getWalletInfo()` | Get wallet information |
-
-### NxtlinqAIAgent
-
-| Method | Description |
-|--------|-------------|
-| `setAIT(ait: AIT, signer?: ethers.Signer)` | Set AIT for the agent |
-| `generateAIT(options: GenerateAITOptions)` | Generate a new AIT |
-| `getAITInfo(serviceId: string, controller: string, signer?: ethers.Signer)` | Get AIT information |
-| `sendMessage(message: string, toolName?: string)` | Send a message to the agent |
-
-### API Endpoints
+## Berify.me Integration
 
-#### AIT API
-- `getAITByServiceIdAndController`: Get AIT by service ID and controller
-- `createAIT`: Create a new AIT
+The SDK supports Berify.me wallet verification for enhanced security:
 
-#### Wallet API
-- `verifyWallet`: Verify wallet ownership
-- `getWallet`: Get wallet information
+```tsx
+import { ChatBot } from '@bytexbyte/nxtlinq-ai-agent-sdk';
 
-#### Metadata API
-- `createMetadata`: Create metadata for AIT
+function App() {
+  const handleVerifyWallet = async () => {
+    // Open Berify.me verification modal
+    const modal = window.open(
+      'https://berify.me/verify',
+      'BerifyMeModal',
+      'width=500,height=600'
+    );
+
+    return new Promise((resolve) => {
+      const handleMessage = (event) => {
+        if (event.origin === 'https://berify.me' && event.data.type === 'VERIFICATION_SUCCESS') {
+          window.removeEventListener('message', handleMessage);
+          modal?.close();
+          resolve({ token: event.data.token });
+        }
+      };
+
+      window.addEventListener('message', handleMessage);
+    });
+  };
 
-#### Auth API
-- `getNonce`: Get nonce for wallet sign-in
-- `signIn`: Sign in with wallet
+  return (
+    <ChatBot
+      serviceId="your-service-id"
+      apiKey="your-api-key"
+      apiSecret="your-api-secret"
+      onVerifyWallet={handleVerifyWallet}
+    />
+  );
+}
+```
 
-#### Agent API
-- `sendMessage`: Send message to AI agent
+## API Reference
 
 ### ChatBot Component Props
 
@@ -120,12 +122,13 @@ function App() {
 | onMessage | (message: Message) => void | No | Callback when a new message is received |
 | onError | (error: Error) => void | No | Callback when an error occurs |
 | onToolUse | (toolUse: ToolUse) => Promise<Message \| void> | No | Callback for handling tool usage |
-| onVerifyWallet | (address: string) => Promise<{ token: string }> | Yes | Callback for wallet verification |
+| onVerifyWallet | () => Promise<{ token: string } \| undefined> | Yes | Callback for wallet verification |
 | presetMessages | PresetMessage[] | No | Array of preset messages to display |
 | placeholder | string | No | Input placeholder text (default: "Type a message...") |
 | className | string | No | Additional CSS class name |
 | maxRetries | number | No | Maximum number of retry attempts (default: 3) |
 | retryDelay | number | No | Delay between retries in milliseconds (default: 1000) |
+| permissionGroup | string | No | Permission group name for filtering permissions |
 
 ## Types
 
@@ -136,7 +139,7 @@ interface Message {
   content: string;
   role: 'user' | 'assistant';
   timestamp: string;
-  button?: boolean;
+  button?: string;
   error?: string;
 }
 ```
@@ -165,7 +168,6 @@ interface AIT {
   metadata: AITMetadata;
   metadataHash: string;
   metadataCid: string;
-  signature: string;
 }
 
 interface AITMetadata {
@@ -174,39 +176,15 @@ interface AITMetadata {
   issuedBy: string;
   serviceId?: string;
 }
+```
 
-interface AITInfo {
-  aitId: string;
-  controller: string;
-  metadata: AITMetadata;
-  metadataHash: string;
-  metadataCid: string;
-  signature: string;
-}
-
-interface AITPermission {
-  hasPermission: boolean;
-  reason?: string;
-  permissions?: string[];
-}
-
-interface GenerateAITOptions {
-  hitAddress: string;
-  signer: ethers.Signer;
-  permissions: string[];
-  serviceId: string;
-}
-
-interface WalletInfo {
+### ServicePermission
+```typescript
+interface ServicePermission {
   id: string;
-  address: string;
-  verified: boolean;
-  method?: string;
-}
-
-interface MessageContext {
-  aitId?: string;
-  walletAddress?: string | null;
+  label: string;
+  description: string;
+  groups: string[];
 }
 ```
 
@@ -214,30 +192,32 @@ interface MessageContext {
 
 ### Wallet Integration
 - MetaMask wallet connection
-- Wallet verification
+- Berify.me wallet verification
 - Wallet-based authentication
-- AIT (AI Token) generation and management
-
-### Available Permissions
-- Set User Name
-- Navigate To Page
-- Add Member
+- AIT (AI Identity Token) generation and management
 
 ### Authentication Flow
 1. Connect MetaMask wallet
-2. Verify wallet ownership
+2. Verify wallet ownership (optional, via Berify.me)
 3. Sign in with wallet
 4. Generate and register AIT with required permissions
 5. Use AIT for authenticated operations
 
+### Enhanced Error Handling
+- Improved async operation handling
+- Better state management
+- Detailed error messages
+- Comprehensive debugging logs
+
 ## Error Handling
 
-The SDK includes built-in error handling with:
+The SDK includes enhanced error handling with:
 - Automatic retry mechanism for failed requests
 - Error callback for custom error handling
 - User-friendly error messages
 - Wallet connection error handling
 - Authentication error handling
+- Detailed console logging for debugging
 
 ## Best Practices
 
@@ -248,6 +228,32 @@ The SDK includes built-in error handling with:
 5. Use context management to maintain conversation coherence
 6. Handle wallet connection errors gracefully
 7. Implement proper error handling for authentication flow
+8. Monitor console logs for debugging
+
+## Troubleshooting
+
+Having issues? Check our [Troubleshooting Guide](./TROUBLESHOOTING.md) which includes:
+
+- Common problems and solutions
+- Authentication debugging steps
+- Permission issue resolution
+- Best practice recommendations
+
+### Common Issues
+
+**Q: Still need to sign in after connecting wallet?**
+A: This is usually due to expired authentication tokens or address mismatches. Check browser console logs and refer to the [Troubleshooting Guide](./TROUBLESHOOTING.md) for detailed solutions.
+
+**Q: Cannot use specific AI tool features?**
+A: Check AIT permission settings to ensure required tool permissions are included. See [Troubleshooting Guide](./TROUBLESHOOTING.md) for details.
+
+## Changelog
+
+### v1.1.9
+- 🔧 Fixed async operation timing issues in wallet connection
+- 🐛 Improved state management for AIT validation
+- 📝 Enhanced error messages and debugging logs
+- ⚡ Better handling of authentication flow
 
 ## License
 

package/dist/components/ChatBot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatBot.d.ts","sourceRoot":"","sources":["../../src/components/ChatBot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,OAAO,EAAE,OAAO,EAAkC,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC1D,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC;QAC7B,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,SAAS,CAAC,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AA0VD,eAAO,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CA27B1C,CAAC"}
+{"version":3,"file":"ChatBot.d.ts","sourceRoot":"","sources":["../../src/components/ChatBot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,OAAO,EAAE,OAAO,EAAkC,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC1D,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC;QAC7B,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,SAAS,CAAC,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AA0VD,eAAO,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CA08B1C,CAAC"}

package/dist/components/ChatBot.js

@@ -28,7 +28,7 @@ const PermissionForm = ({ hitAddress, permissions, setPermissions, setIsDisabled
     React.useEffect(() => {
         fetchAvailablePermissions();
     }, [serviceId, nxtlinqApi, permissionGroup]);
-    const isWalletVerified = walletInfo?.id;
+    const isWalletVerified = walletInfo?.id || !isNeedSignInWithWallet;
     return (_jsxs("div", { style: {
             backgroundColor: 'white',
             padding: '24px',
@@ -308,11 +308,13 @@ export const ChatBot = ({ onMessage, onError, onToolUse, presetMessages = [], pl
             if (exp < now) {
                 return true;
             }
-            // Check is the token's payload has the same address as the wallet address
+            // Check if the token's payload has the same address as the wallet address
             const address = payload.address;
             if (address !== hitAddress) {
                 return true;
             }
+            // If user has valid token but no AIT, they don't need to sign in again
+            // They just need to generate AIT through the permission form
             return false;
         }
         catch (error) {
@@ -538,12 +540,13 @@ export const ChatBot = ({ onMessage, onError, onToolUse, presetMessages = [], pl
             localStorage.setItem('walletAddress', userAddress);
             setHitAddress(userAddress);
             setSigner(userSigner);
-            // Refresh AIT after connecting wallet
+            // Refresh AIT after connecting wallet and wait for completion
             if (nxtlinqAITServiceAccessToken) {
-                refreshAIT();
+                await refreshAIT();
             }
-            // Auto-show appropriate message after connecting wallet
+            // Auto-show appropriate message after connecting wallet and AIT refresh
             if (autoShowSignInMessage) {
+                // Check state after refreshAIT has completed
                 if (isNeedSignInWithWallet) {
                     // User needs to sign in
                     setMessages(prev => [...prev, {
@@ -634,16 +637,26 @@ export const ChatBot = ({ onMessage, onError, onToolUse, presetMessages = [], pl
                 }]);
             return false;
         }
-        if (!ait) {
+        // Check if user has signed in with wallet
+        if (!nxtlinqAITServiceAccessToken) {
             setMessages(prev => [...prev, {
                     id: Date.now().toString(),
-                    content: 'Please sign in with your wallet to continue.',
+                    content: 'Please sign in with your HIT wallet to continue.',
                     role: 'assistant',
                     timestamp: new Date().toISOString(),
                     button: 'signIn'
                 }]);
             return false;
         }
+        if (!ait) {
+            setMessages(prev => [...prev, {
+                    id: Date.now().toString(),
+                    content: 'No AIT found for your wallet. Please click the settings button (⚙️) to configure your AIT permissions.',
+                    role: 'assistant',
+                    timestamp: new Date().toISOString()
+                }]);
+            return false;
+        }
         // Check if the tool permission is available for current identity provider
         const availablePermissionLabels = availablePermissions.map(p => p.label);
         if (!availablePermissionLabels.includes(toolName)) {
@@ -659,7 +672,7 @@ export const ChatBot = ({ onMessage, onError, onToolUse, presetMessages = [], pl
         if (!permissions.includes(toolName)) {
             setMessages(prev => [...prev, {
                     id: Date.now().toString(),
-                    content: `You do not have the required AIT permission: ${toolName}`,
+                    content: `You do not have the required AIT permission: ${toolName}. Please click the settings button (⚙️) to update your permissions.`,
                     role: 'assistant',
                     timestamp: new Date().toISOString()
                 }]);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bytexbyte/nxtlinq-ai-agent-sdk",
-  "version": "1.1.8",
-  "description": "Nxtlinq AI Agent SDK - Proprietary Software",
+  "version": "1.2.0",
+  "description": "Nxtlinq AI Agent SDK - Proprietary Software with enhanced async operation handling",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
@@ -16,7 +16,10 @@
     "nxtlinq",
     "ai",
     "agent",
-    "sdk"
+    "sdk",
+    "wallet",
+    "authentication",
+    "berify"
   ],
   "author": "ByteXByte",
   "license": "MIT",