memori-client 0.1.1 → 0.1.6

data/lib/memori_client/engine/v2/unanswered_question.rb

@@ -1,47 +1,71 @@
-# Generated on 2024-01-18 17:37:07 +0000    
+# Generated on 2025-01-27 20:29:52 +0000    
 class MemoriClient::Engine::V2::UnansweredQuestion < MemoriClient::Engine::Resource
-    # GET /memori/v2/UnansweredQuestions/{strSessionID}
+    # `GET /memori/v2/UnansweredQuestions/{strSessionID}`
+    #
     # Lists all Unanswered Question objects.
-    # Params list:
+    #
+    #
     # @param [string] strSessionID The session ID. required
-    # list_unanswered_questions(strSessionID:)
+    #
+    # `list_unanswered_questions(strSessionID:)`
     def self.list_unanswered_questions(strSessionID:)
       args = build_arguments(binding)
 
       exec_http_request('get', '/memori/v2/UnansweredQuestions/{strSessionID}', **args)
     end
 
-    # GET /memori/v2/UnansweredQuestions/{strSessionID}/{from}/{howMany}
+    # `GET /memori/v2/UnansweredQuestions/{strSessionID}/{from}/{howMany}`
+    #
     # Lists Unanswered Question objects with pagination.
-    # Params list:
+    #
+    #
     # @param [string] strSessionID The session ID. required
+    #
     # @param [integer] from The 0-based index of the first Unanswered Question object to list. required
+    #
     # @param [integer] howMany The number of the Unanswered Question objects to list. required
-    # list_unanswered_questions_paginated(strSessionID:, from:, howMany:)
+    #
+    # `list_unanswered_questions_paginated(strSessionID:, from:, howMany:)`
     def self.list_unanswered_questions_paginated(strSessionID:, from:, howMany:)
       args = build_arguments(binding)
 
       exec_http_request('get', '/memori/v2/UnansweredQuestions/{strSessionID}/{from}/{howMany}', **args)
     end
 
-    # POST /memori/v2/UnansweredQuestion/{strSessionID}
+    # `POST /memori/v2/UnansweredQuestion/{strSessionID}`
+    #
     # Adds a new Unanswered Question object.
-    # Params list:
+    #
+    #
     # @param [string] strSessionID The session ID. required
-    # @param [object] payload request payload. optional
-    # @param [string] payload.unansweredQuestionID . optional
-    # @param [string] payload.text . optional
-    # @param [object] payload.contextVars . optional
-    # @param [integer] payload.occurrences . optional
-    # @param [string] payload.receiverID . optional
-    # @param [string] payload.receiverTag . optional
-    # @param [string] payload.receiverName . optional
-    # @param [array] payload.suggestions . optional
-    # @param [string] payload.creationTimestamp . optional
-    # @param [string] payload.creationSessionID . optional
-    # @param [string] payload.lastChangeTimestamp . optional
-    # @param [string] payload.lastChangeSessionID . optional
-    # add_unanswered_question(strSessionID:, payload: {})
+    #
+    # @param [Hash] payload request payload. optional
+    #
+    # @param [String] payload.unansweredQuestionID . optional
+    #
+    # @param [String] payload.text . optional
+    #
+    # @param [Object] payload.contextVars . optional
+    #
+    # @param [Integer] payload.occurrences . optional
+    #
+    # @param [String] payload.receiverID . optional
+    #
+    # @param [String] payload.receiverTag . optional
+    #
+    # @param [String] payload.receiverName . optional
+    #
+    # @param [Array] payload.suggestions . optional
+    #
+    # @param [String] payload.creationTimestamp . optional
+    #
+    # @param [String] payload.creationSessionID . optional
+    #
+    # @param [String] payload.lastChangeTimestamp . optional
+    #
+    # @param [String] payload.lastChangeSessionID . optional
+    #
+    # `add_unanswered_question(strSessionID:, payload: {})`
     def self.add_unanswered_question(strSessionID:, payload: {})
       args = build_arguments(binding)
       payload_keys = [
@@ -64,12 +88,16 @@ class MemoriClient::Engine::V2::UnansweredQuestion < MemoriClient::Engine::Resou
       exec_http_request('post', '/memori/v2/UnansweredQuestion/{strSessionID}', **args)
     end
 
-    # DELETE /memori/v2/UnansweredQuestion/{strSessionID}/{strUnansweredQuestionID}
+    # `DELETE /memori/v2/UnansweredQuestion/{strSessionID}/{strUnansweredQuestionID}`
+    #
     # Removes an existing Unanswered Question object.
-    # Params list:
+    #
+    #
     # @param [string] strSessionID The session ID. required
+    #
     # @param [string] strUnansweredQuestionID The Unanswered Question object ID. required
-    # remove_unanswered_question(strSessionID:, strUnansweredQuestionID:)
+    #
+    # `remove_unanswered_question(strSessionID:, strUnansweredQuestionID:)`
     def self.remove_unanswered_question(strSessionID:, strUnansweredQuestionID:)
       args = build_arguments(binding)
 

data/lib/memori_client/engine/v2/user.rb

@@ -1,47 +1,147 @@
-# Generated on 2024-01-18 17:37:07 +0000    
+# Generated on 2025-01-27 20:29:52 +0000    
 class MemoriClient::Engine::V2::User < MemoriClient::Engine::Resource
-    # GET /memori/v2/KnownFacts/{strSessionID}
+    # `GET /memori/v2/Users/{strSessionID}`
+    #
+    # Lists all User objects associated with the Memori of the current session.
+    #
+    #
+    # @param [string] strSessionID The session ID. required
+    #
+    # `list_users(strSessionID:)`
+    def self.list_users(strSessionID:)
+      args = build_arguments(binding)
+
+      exec_http_request('get', '/memori/v2/Users/{strSessionID}', **args)
+    end
+
+    # `GET /memori/v2/Users/{strSessionID}/{from}/{howMany}`
+    #
+    # Lists User objects associated with the Memori of the current session, with pagination.
+    #
+    #
+    # @param [string] strSessionID The session ID. required
+    #
+    # @param [integer] from The 0-based index of the first User to list. required
+    #
+    # @param [integer] howMany The number of User objects to list. required
+    #
+    # `list_users_paginated(strSessionID:, from:, howMany:)`
+    def self.list_users_paginated(strSessionID:, from:, howMany:)
+      args = build_arguments(binding)
+
+      exec_http_request('get', '/memori/v2/Users/{strSessionID}/{from}/{howMany}', **args)
+    end
+
+    # `GET /memori/v2/User/{strSessionID}/{strUserID}`
+    #
+    # Gets the details of a User object.
+    #
+    #
+    # @param [string] strSessionID The session ID. required
+    #
+    # @param [string] strUserID The User object ID. required
+    #
+    # `get_user(strSessionID:, strUserID:)`
+    def self.get_user(strSessionID:, strUserID:)
+      args = build_arguments(binding)
+
+      exec_http_request('get', '/memori/v2/User/{strSessionID}/{strUserID}', **args)
+    end
+
+    # `GET /memori/v2/UserTopics/{strSessionID}/{strUserID}`
+    #
+    # Lists all Topic objects referenced by a specified User object.
+    #
+    #
+    # @param [string] strSessionID The session ID. required
+    #
+    # @param [string] strUserID The User object ID. required
+    #
+    # `list_user_topics(strSessionID:, strUserID:)`
+    def self.list_user_topics(strSessionID:, strUserID:)
+      args = build_arguments(binding)
+
+      exec_http_request('get', '/memori/v2/UserTopics/{strSessionID}/{strUserID}', **args)
+    end
+
+    # `GET /memori/v2/UserTopics/{strSessionID}/{strUserID}/{from}/{howMany}`
+    #
+    # Lists Topic objects referenced by a specified User object, with pagination.
+    #
+    #
+    # @param [string] strSessionID The session ID. required
+    #
+    # @param [string] strUserID The User object ID. required
+    #
+    # @param [integer] from The 0-based index of the first Topic object to list. required
+    #
+    # @param [integer] howMany The number of Topic objects to list. required
+    #
+    # `list_user_topics_paginated(strSessionID:, strUserID:, from:, howMany:)`
+    def self.list_user_topics_paginated(strSessionID:, strUserID:, from:, howMany:)
+      args = build_arguments(binding)
+
+      exec_http_request('get', '/memori/v2/UserTopics/{strSessionID}/{strUserID}/{from}/{howMany}', **args)
+    end
+
+    # `GET /memori/v2/KnownFacts/{strSessionID}`
+    #
     # Lists all Known Facts objects associated with the current User.
-    # Params list:
+    #
+    #
     # @param [string] strSessionID The session ID. required
-    # list_known_facts(strSessionID:)
+    #
+    # `list_known_facts(strSessionID:)`
     def self.list_known_facts(strSessionID:)
       args = build_arguments(binding)
 
       exec_http_request('get', '/memori/v2/KnownFacts/{strSessionID}', **args)
     end
 
-    # GET /memori/v2/KnownFacts/{strSessionID}/{from}/{howMany}
+    # `GET /memori/v2/KnownFacts/{strSessionID}/{from}/{howMany}`
+    #
     # Lists Known Facts objects associated with the current User, with pagination.
-    # Params list:
+    #
+    #
     # @param [string] strSessionID The session ID. required
+    #
     # @param [integer] from The 0-based index of the first Known Fact to list. required
-    # @param [integer] howMany The number of the Known Fact to list. required
-    # list_known_facts_paginated(strSessionID:, from:, howMany:)
+    #
+    # @param [integer] howMany The number of Known Fact objects to list. required
+    #
+    # `list_known_facts_paginated(strSessionID:, from:, howMany:)`
     def self.list_known_facts_paginated(strSessionID:, from:, howMany:)
       args = build_arguments(binding)
 
       exec_http_request('get', '/memori/v2/KnownFacts/{strSessionID}/{from}/{howMany}', **args)
     end
 
-    # GET /memori/v2/KnownFact/{strSessionID}/{strKnownFactID}
+    # `GET /memori/v2/KnownFact/{strSessionID}/{strKnownFactID}`
+    #
     # Gets the details of a Known Fact object.
-    # Params list:
+    #
+    #
     # @param [string] strSessionID The session ID. required
+    #
     # @param [string] strKnownFactID The Known Fact object ID. required
-    # get_known_fact(strSessionID:, strKnownFactID:)
+    #
+    # `get_known_fact(strSessionID:, strKnownFactID:)`
     def self.get_known_fact(strSessionID:, strKnownFactID:)
       args = build_arguments(binding)
 
       exec_http_request('get', '/memori/v2/KnownFact/{strSessionID}/{strKnownFactID}', **args)
     end
 
-    # DELETE /memori/v2/KnownFact/{strSessionID}/{strKnownFactID}
+    # `DELETE /memori/v2/KnownFact/{strSessionID}/{strKnownFactID}`
+    #
     # Deletes an existing Known Fact object.
-    # Params list:
+    #
+    #
     # @param [string] strSessionID The session ID. required
+    #
     # @param [string] strKnownFactID The Known Fact object ID. required
-    # delete_known_fact(strSessionID:, strKnownFactID:)
+    #
+    # `delete_known_fact(strSessionID:, strKnownFactID:)`
     def self.delete_known_fact(strSessionID:, strKnownFactID:)
       args = build_arguments(binding)
 

data/lib/memori_client/engine/v2/web_hook.rb

@@ -1,16 +1,25 @@
-# Generated on 2024-01-18 17:37:07 +0000    
+# Generated on 2025-01-27 20:29:52 +0000    
 class MemoriClient::Engine::V2::WebHook < MemoriClient::Engine::Resource
-    # POST /memori/v2/TestSlot
+    # `POST /memori/v2/TestSlot`
+    #
     # Returns test slot values.
-    # Params list:
-    # @param [object] payload request payload. optional
-    # @param [string] payload.slotName . required
-    # @param [integer] payload.requestID . required
-    # @param [string] payload.requestDateTime . required
-    # @param [number] payload.requestValidityMinutes . required
-    # @param [string] payload.memoriID . required
-    # @param [string] payload.culture . required
-    # test_slot(payload: {})
+    #
+    #
+    # @param [Hash] payload request payload. optional
+    #
+    # @param [String] payload.slotName . optional
+    #
+    # @param [Integer] payload.requestID . optional
+    #
+    # @param [String] payload.requestDateTime . optional
+    #
+    # @param [Number] payload.requestValidityMinutes . optional
+    #
+    # @param [String] payload.memoriID . optional
+    #
+    # @param [String] payload.culture . optional
+    #
+    # `test_slot(payload: {})`
     def self.test_slot(payload: {})
       args = build_arguments(binding)
       payload_keys = [
@@ -21,35 +30,58 @@ class MemoriClient::Engine::V2::WebHook < MemoriClient::Engine::Resource
         'requestValidityMinutes',
         'slotName',
       ]
-      payload_required_keys = %w[culture memoriID requestDateTime requestID requestValidityMinutes slotName]
+      payload_required_keys = %w[]
       validate_payload!(args[:payload], keys: payload_keys, required: payload_required_keys)
 
       exec_http_request('post', '/memori/v2/TestSlot', **args)
     end
 
-    # POST /memori/v2/TestIntent
+    # `POST /memori/v2/TestIntent`
+    #
     # Returns test intent results.
-    # Params list:
-    # @param [object] payload request payload. optional
-    # @param [string] payload.intentName . required
-    # @param [string] payload.utterance . optional
-    # @param [object] payload.slotValues . required
-    # @param [string] payload.sessionID . required
-    # @param [string] payload.currentTag . optional
-    # @param [boolean] payload.currentTagAuthenticated . optional
-    # @param [string] payload.currentDateUTC . optional
+    #
+    #
+    # @param [Hash] payload request payload. optional
+    #
+    # @param [String] payload.intentName . optional
+    #
+    # @param [String] payload.utterance . optional
+    #
+    # @param [Object] payload.slotValues . optional
+    #
+    # @param [String] payload.sessionID . optional
+    #
+    # @param [String] payload.currentTag . optional
+    #
+    # @param [Boolean] payload.currentTagAuthenticated . optional
+    #
+    # @param [String] payload.currentDateUTC . optional
+    #
     # @param [] payload.currentPlace . optional
-    # @param [string] payload.timeZone . required
-    # @param [string] payload.beginUTC . required
-    # @param [string] payload.endUTC . required
-    # @param [object] payload.contextVars . required
-    # @param [array] payload.transitionHistory . required
-    # @param [integer] payload.requestID . required
-    # @param [string] payload.requestDateTime . required
-    # @param [number] payload.requestValidityMinutes . required
-    # @param [string] payload.memoriID . required
-    # @param [string] payload.culture . required
-    # test_intent(payload: {})
+    #
+    # @param [String] payload.timeZone . optional
+    #
+    # @param [String] payload.beginUTC . optional
+    #
+    # @param [String] payload.endUTC . optional
+    #
+    # @param [Object] payload.contextVars . optional
+    #
+    # @param [Array] payload.transitionHistory . optional
+    #
+    # @param [String] payload.userEmail . optional
+    #
+    # @param [Integer] payload.requestID . optional
+    #
+    # @param [String] payload.requestDateTime . optional
+    #
+    # @param [Number] payload.requestValidityMinutes . optional
+    #
+    # @param [String] payload.memoriID . optional
+    #
+    # @param [String] payload.culture . optional
+    #
+    # `test_intent(payload: {})`
     def self.test_intent(payload: {})
       args = build_arguments(binding)
       payload_keys = [
@@ -70,13 +102,27 @@ class MemoriClient::Engine::V2::WebHook < MemoriClient::Engine::Resource
         'slotValues',
         'timeZone',
         'transitionHistory',
+        'userEmail',
         'utterance',
       ]
-      payload_required_keys = %w[beginUTC contextVars culture endUTC intentName memoriID requestDateTime requestID requestValidityMinutes sessionID slotValues timeZone transitionHistory]
+      payload_required_keys = %w[]
       validate_payload!(args[:payload], keys: payload_keys, required: payload_required_keys)
 
       exec_http_request('post', '/memori/v2/TestIntent', **args)
     end
 
+    # `GET /memori/v2/TestFunctions/RandomNumber`
+    #
+    # Test function: returns a random number between 0 and 999999.
+    #
+
+    #
+    # `test_function_random_number()`
+    def self.test_function_random_number()
+      args = build_arguments(binding)
+
+      exec_http_request('get', '/memori/v2/TestFunctions/RandomNumber', **args)
+    end
+
 
 end

data/lib/memori_client/http_client.rb

@@ -72,10 +72,17 @@ class MemoriClient::HttpClient
 
   def handle_response(response, request)
     body = response.read_body
+
     if request['Content-Type'] == 'application/json'
+      if body.nil? || body == ''
+        response_body = {}
+      else
+        response_body = JSON.parse(body)
+      end
+
       [
         response.code,
-        (body.nil? ? {} : JSON.parse(body))
+        (body.nil? ? {} : response_body)
       ]
     else
       [response.code, body]

data/lib/memori_client/resource.rb

@@ -7,6 +7,7 @@ class MemoriClient::Resource
   end
 
   def self.exec_http_request(method, path, args)
+    headers = args[:headers] || {}
     stop = false
     processed_tokens = []
     path.split('/').each do |token|
@@ -29,9 +30,9 @@ class MemoriClient::Resource
 
     case method
     when 'get'
-      status, body = http.get(url)
+      status, body = http.get(url, headers: headers)
     else
-      status, body = http.send(method, url, payload: args[:payload])
+      status, body = http.send(method, url, payload: args[:payload], headers: headers)
     end
 
     [status, body]

data/lib/memori_client.rb

@@ -15,7 +15,9 @@ module MemoriClient
     end
 
     module V2
+      module Private
 
+      end
     end
   end
 
@@ -47,6 +49,10 @@ require "memori_client/http_client"
 require "memori_client/resource"
 require "memori_client/backend/resource"
 require "memori_client/backend/resources"
+require "memori_client/engine/hmac_helper"
 require "memori_client/engine/resource"
 require "memori_client/engine/resources"
 
+require "memori_client/engine/v2/private/memori"
+require "memori_client/engine/v2/private/memori_block"
+

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: memori-client
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.6
 platform: ruby
 authors:
 - Stefano Lampis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-01-18 00:00:00.000000000 Z
+date: 2025-04-30 00:00:00.000000000 Z
 dependencies: []
 description: Memori Client to interact with Memori backend and engine API
 email: me@stefanolampis.com
@@ -21,8 +21,10 @@ files:
 - lib/memori_client/backend/resources.rb
 - lib/memori_client/backend/v1/asset.rb
 - lib/memori_client/backend/v2/action_log.rb
+- lib/memori_client/backend/v2/analysis.rb
 - lib/memori_client/backend/v2/asset.rb
 - lib/memori_client/backend/v2/badge.rb
+- lib/memori_client/backend/v2/completion_config.rb
 - lib/memori_client/backend/v2/consumption_log.rb
 - lib/memori_client/backend/v2/import_export.rb
 - lib/memori_client/backend/v2/integration.rb
@@ -30,9 +32,11 @@ files:
 - lib/memori_client/backend/v2/memori.rb
 - lib/memori_client/backend/v2/memori_list.rb
 - lib/memori_client/backend/v2/notification.rb
+- lib/memori_client/backend/v2/process.rb
 - lib/memori_client/backend/v2/tenant.rb
 - lib/memori_client/backend/v2/user.rb
 - lib/memori_client/configuration.rb
+- lib/memori_client/engine/hmac_helper.rb
 - lib/memori_client/engine/resource.rb
 - lib/memori_client/engine/resources.rb
 - lib/memori_client/engine/v2/chat_log.rb
@@ -43,6 +47,7 @@ files:
 - lib/memori_client/engine/v2/dialog.rb
 - lib/memori_client/engine/v2/event_log.rb
 - lib/memori_client/engine/v2/expert_reference.rb
+- lib/memori_client/engine/v2/function.rb
 - lib/memori_client/engine/v2/intent.rb
 - lib/memori_client/engine/v2/localization_key.rb
 - lib/memori_client/engine/v2/medium.rb
@@ -50,10 +55,13 @@ files:
 - lib/memori_client/engine/v2/memory.rb
 - lib/memori_client/engine/v2/nlp.rb
 - lib/memori_client/engine/v2/person.rb
+- lib/memori_client/engine/v2/private/memori.rb
+- lib/memori_client/engine/v2/private/memori_block.rb
 - lib/memori_client/engine/v2/prompted_question.rb
 - lib/memori_client/engine/v2/search.rb
 - lib/memori_client/engine/v2/session.rb
 - lib/memori_client/engine/v2/stat.rb
+- lib/memori_client/engine/v2/topic.rb
 - lib/memori_client/engine/v2/unanswered_question.rb
 - lib/memori_client/engine/v2/user.rb
 - lib/memori_client/engine/v2/web_hook.rb