@kya-os/mcp-i-core 1.3.25 → 1.3.26

package/dist/delegation/bitstring.d.ts

@@ -111,7 +111,8 @@ export declare class BitstringManager {
      */
     private bytesToBase64;
     /**
-     * Convert base64 to bytes
+     * Convert base64 or base64url to bytes
+     * Handles both standard base64 (+/) and base64url (-_) formats
      */
     private static base64ToBytes;
     /**

package/dist/delegation/bitstring.js

@@ -161,10 +161,16 @@ class BitstringManager {
         return btoa(binary);
     }
     /**
-     * Convert base64 to bytes
+     * Convert base64 or base64url to bytes
+     * Handles both standard base64 (+/) and base64url (-_) formats
      */
     static base64ToBytes(base64) {
-        const binary = atob(base64);
+        // Convert base64url to standard base64 if needed
+        let standardBase64 = base64.replace(/-/g, '+').replace(/_/g, '/');
+        // Add padding if needed
+        const paddingNeeded = (4 - (standardBase64.length % 4)) % 4;
+        standardBase64 += '='.repeat(paddingNeeded);
+        const binary = atob(standardBase64);
         const bytes = new Uint8Array(binary.length);
         for (let i = 0; i < binary.length; i++) {
             bytes[i] = binary.charCodeAt(i);

package/dist/identity/user-did-manager.d.ts

@@ -208,7 +208,8 @@ export declare class UserDidManager {
      */
     private base58Encode;
     /**
-     * Convert base64 string to Uint8Array
+     * Convert base64 or base64url string to Uint8Array
+     * Handles both standard base64 (+/) and base64url (-_) formats
      */
     private base64ToBytes;
     /**

package/dist/identity/user-did-manager.js

@@ -285,16 +285,23 @@ class UserDidManager {
         return result;
     }
     /**
-     * Convert base64 string to Uint8Array
+     * Convert base64 or base64url string to Uint8Array
+     * Handles both standard base64 (+/) and base64url (-_) formats
      */
     base64ToBytes(base64) {
+        // Convert base64url to standard base64 if needed
+        // Base64url uses - instead of + and _ instead of /
+        let standardBase64 = base64.replace(/-/g, "+").replace(/_/g, "/");
+        // Add padding if needed (base64url often omits padding)
+        const paddingNeeded = (4 - (standardBase64.length % 4)) % 4;
+        standardBase64 += "=".repeat(paddingNeeded);
         if (typeof Buffer !== "undefined") {
             // Node.js environment
-            return new Uint8Array(Buffer.from(base64, "base64"));
+            return new Uint8Array(Buffer.from(standardBase64, "base64"));
         }
         else {
             // Browser/Workers environment
-            const binaryString = atob(base64);
+            const binaryString = atob(standardBase64);
             const bytes = new Uint8Array(binaryString.length);
             for (let i = 0; i < binaryString.length; i++) {
                 bytes[i] = binaryString.charCodeAt(i);

package/dist/runtime/base.d.ts

@@ -190,6 +190,10 @@ export declare class MCPIRuntimeBase {
     rotateKeys(): Promise<AgentIdentity>;
     private signData;
     private generateNonce;
+    /**
+     * Generate a unique session ID
+     * Uses mcpi_{uuid} format for MCP protocol compliance and traceability
+     */
     private generateSessionId;
     /**
      * Log structured events in JSON format (NOT frozen audit format).

package/dist/runtime/base.js

@@ -1063,9 +1063,18 @@ class MCPIRuntimeBase {
         const bytes = await this.crypto.randomBytes(32);
         return this.bytesToBase64(bytes);
     }
+    /**
+     * Generate a unique session ID
+     * Uses mcpi_{uuid} format for MCP protocol compliance and traceability
+     */
     async generateSessionId() {
         const bytes = await this.crypto.randomBytes(16);
-        return this.bytesToHex(bytes);
+        // Set version (4) and variant (RFC4122)
+        bytes[6] = (bytes[6] & 0x0f) | 0x40;
+        bytes[8] = (bytes[8] & 0x3f) | 0x80;
+        const hex = this.bytesToHex(bytes);
+        const uuid = `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20, 32)}`;
+        return `mcpi_${uuid}`;
     }
     /**
      * Log structured events in JSON format (NOT frozen audit format).

package/dist/services/session-registration.service.js

@@ -54,7 +54,9 @@ class SessionRegistrationService {
                 return { success: false, sessionId, error: errorMsg };
             }
             const url = `${this.config.baseUrl}${agentshield_api_1.AGENTSHIELD_ENDPOINTS.SESSIONS}`;
-            this.config.logger("[SessionRegistration] Registering session", {
+            // NOTE: This registers the SESSION with AgentShield for dashboard visibility
+            // This is NOT the same as agent registration with Know That AI (which happens during deploy)
+            this.config.logger("[SessionRegistration] Registering session for dashboard visibility", {
                 sessionId,
                 agentDid: request.agent_did,
                 clientName: request.client_info.name,
@@ -99,7 +101,7 @@ class SessionRegistrationService {
                     // Still consider it a success if we got a 200 OK
                     return { success: true, sessionId };
                 }
-                this.config.logger("[SessionRegistration] Session registered", {
+                this.config.logger("[SessionRegistration] Session now visible in AgentShield dashboard", {
                     sessionId,
                     registered: parseResult.data.registered,
                 });

package/dist/utils/base64.d.ts

@@ -25,7 +25,8 @@ export declare function base64urlEncodeFromBytes(bytes: Uint8Array): string;
  */
 export declare function bytesToBase64(bytes: Uint8Array): string;
 /**
- * Convert standard base64 to bytes
+ * Convert standard base64 or base64url to bytes
+ * Handles both standard base64 (+/) and base64url (-_) formats
  */
 export declare function base64ToBytes(base64: string): Uint8Array;
 //# sourceMappingURL=base64.d.ts.map

package/dist/utils/base64.js

@@ -137,12 +137,19 @@ function bytesToBase64(bytes) {
     return Buffer.from(bytes).toString("base64");
 }
 /**
- * Convert standard base64 to bytes
+ * Convert standard base64 or base64url to bytes
+ * Handles both standard base64 (+/) and base64url (-_) formats
  */
 function base64ToBytes(base64) {
+    // Convert base64url to standard base64 if needed
+    // Base64url uses - instead of + and _ instead of /
+    let standardBase64 = base64.replace(/-/g, "+").replace(/_/g, "/");
+    // Add padding if needed (base64url often omits padding)
+    const paddingNeeded = (4 - (standardBase64.length % 4)) % 4;
+    standardBase64 += "=".repeat(paddingNeeded);
     // For platforms that don't have Buffer
     if (typeof atob !== "undefined") {
-        const binaryString = atob(base64);
+        const binaryString = atob(standardBase64);
         const bytes = new Uint8Array(binaryString.length);
         for (let i = 0; i < binaryString.length; i++) {
             bytes[i] = binaryString.charCodeAt(i);
@@ -150,7 +157,7 @@ function base64ToBytes(base64) {
         return bytes;
     }
     // For Node.js environments
-    return new Uint8Array(Buffer.from(base64, "base64"));
+    return new Uint8Array(Buffer.from(standardBase64, "base64"));
 }
 /**
  * Add padding to base64url string if needed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kya-os/mcp-i-core",
-  "version": "1.3.25",
+  "version": "1.3.26",
   "description": "Core runtime and types for MCP-I framework",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",