telnyx 5.168.0 → 5.170.0

data/lib/telnyx/models/ai/memory/namespaces/profiles/memory_list_params.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        module Namespaces
+          module Profiles
+            # @see Telnyx::Resources::AI::Memory::Namespaces::Profiles::Memories#list
+            class MemoryListParams < Telnyx::Internal::Type::BaseModel
+              extend Telnyx::Internal::Type::RequestParameters::Converter
+              include Telnyx::Internal::Type::RequestParameters
+
+              # @!attribute namespace
+              #
+              #   @return [String]
+              required :namespace, String
+
+              # @!attribute profile_id
+              #
+              #   @return [String]
+              required :profile_id, String
+
+              # @!attribute page_number
+              #   The page to return, counting from 1. Bounded in depth: (page[number] - 1) \*
+              #   page[size] may be at most 10000.
+              #
+              #   @return [Integer, nil]
+              optional :page_number, Integer
+
+              # @!attribute page_size
+              #   How many results a page holds.
+              #
+              #   @return [Integer, nil]
+              optional :page_size, Integer
+
+              # @!attribute session_id
+              #   An ingested session, by the `session_id` it was ingested with. Narrows the
+              #   request to the source that session was stored as.
+              #
+              #   @return [String, nil]
+              optional :session_id, String, nil?: true
+
+              # @!attribute source_id
+              #   Narrows the listing to the memories extracted from one source, a remembered fact
+              #   as well as a session. Pass this or `session_id`, not both.
+              #
+              #   @return [String, nil]
+              optional :source_id, String, nil?: true
+
+              # @!method initialize(namespace:, profile_id:, page_number: nil, page_size: nil, session_id: nil, source_id: nil, request_options: {})
+              #   Some parameter documentations has been truncated, see
+              #   {Telnyx::Models::AI::Memory::Namespaces::Profiles::MemoryListParams} for more
+              #   details.
+              #
+              #   @param namespace [String]
+              #
+              #   @param profile_id [String]
+              #
+              #   @param page_number [Integer] The page to return, counting from 1. Bounded in depth: (page[number] - 1) \*
+              #   page
+              #
+              #   @param page_size [Integer] How many results a page holds.
+              #
+              #   @param session_id [String, nil] An ingested session, by the `session_id` it was ingested with. Narrows the reque
+              #
+              #   @param source_id [String, nil] Narrows the listing to the memories extracted from one source, a remembered fact
+              #
+              #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/ai/memory/namespaces/profiles/memory_list_response.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        module Namespaces
+          module Profiles
+            # @see Telnyx::Resources::AI::Memory::Namespaces::Profiles::Memories#list
+            class MemoryListResponse < Telnyx::Internal::Type::BaseModel
+              # @!attribute id
+              #
+              #   @return [String]
+              required :id, String
+
+              # @!attribute source_id
+              #   The source this memory was extracted from. Set for a fact, which comes from
+              #   exactly one source; null for a memory derived from other memories. Read it with
+              #   `GET .../sources/{source_id}`. A source deleted a moment ago can still be named
+              #   here, and then answers 404.
+              #
+              #   @return [String, nil]
+              required :source_id, String, nil?: true
+
+              # @!attribute text
+              #
+              #   @return [String]
+              required :text, String
+
+              # @!attribute recorded_at
+              #
+              #   @return [String, nil]
+              optional :recorded_at, String, nil?: true
+
+              # @!method initialize(id:, source_id:, text:, recorded_at: nil)
+              #   Some parameter documentations has been truncated, see
+              #   {Telnyx::Models::AI::Memory::Namespaces::Profiles::MemoryListResponse} for more
+              #   details.
+              #
+              #   @param id [String]
+              #
+              #   @param source_id [String, nil] The source this memory was extracted from. Set for a fact, which comes from exac
+              #
+              #   @param text [String]
+              #
+              #   @param recorded_at [String, nil]
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/ai/memory/namespaces/profiles/memory_retrieve_params.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        module Namespaces
+          module Profiles
+            # @see Telnyx::Resources::AI::Memory::Namespaces::Profiles::Memories#retrieve
+            class MemoryRetrieveParams < Telnyx::Internal::Type::BaseModel
+              extend Telnyx::Internal::Type::RequestParameters::Converter
+              include Telnyx::Internal::Type::RequestParameters
+
+              # @!attribute namespace
+              #   The namespace. `default` exists for every organization.
+              #
+              #   @return [String]
+              required :namespace, String
+
+              # @!attribute profile_id
+              #   The profile: your identifier for the user, caller or agent this memory is about.
+              #
+              #   @return [String]
+              required :profile_id, String
+
+              # @!attribute memory_id
+              #   A memory's id, as `recall` and the listing return it.
+              #
+              #   @return [String]
+              required :memory_id, String
+
+              # @!method initialize(namespace:, profile_id:, memory_id:, request_options: {})
+              #   Some parameter documentations has been truncated, see
+              #   {Telnyx::Models::AI::Memory::Namespaces::Profiles::MemoryRetrieveParams} for
+              #   more details.
+              #
+              #   @param namespace [String] The namespace. `default` exists for every organization.
+              #
+              #   @param profile_id [String] The profile: your identifier for the user, caller or agent this memory is about.
+              #
+              #   @param memory_id [String] A memory's id, as `recall` and the listing return it.
+              #
+              #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/ai/memory/namespaces/profiles/memory_retrieve_response.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        module Namespaces
+          module Profiles
+            # @see Telnyx::Resources::AI::Memory::Namespaces::Profiles::Memories#retrieve
+            class MemoryRetrieveResponse < Telnyx::Internal::Type::BaseModel
+              # @!attribute data
+              #
+              #   @return [Telnyx::Models::AI::Memory::Namespaces::Profiles::MemoryRetrieveResponse::Data]
+              required :data, -> { Telnyx::Models::AI::Memory::Namespaces::Profiles::MemoryRetrieveResponse::Data }
+
+              # @!method initialize(data:)
+              #   @param data [Telnyx::Models::AI::Memory::Namespaces::Profiles::MemoryRetrieveResponse::Data]
+
+              # @see Telnyx::Models::AI::Memory::Namespaces::Profiles::MemoryRetrieveResponse#data
+              class Data < Telnyx::Internal::Type::BaseModel
+                # @!attribute id
+                #
+                #   @return [String]
+                required :id, String
+
+                # @!attribute derived_from
+                #   The ids of the memories this one was derived from. Read each with
+                #   `GET .../memories/{memory_id}` to reach its `source_id`. Set for a derived
+                #   memory; null for a fact.
+                #
+                #   @return [Array<String>, nil]
+                required :derived_from, Telnyx::Internal::Type::ArrayOf[String], nil?: true
+
+                # @!attribute source_id
+                #   The source this memory was extracted from. Set for a fact, which comes from
+                #   exactly one source; null for a memory derived from other memories. Read it with
+                #   `GET .../sources/{source_id}`. A source deleted a moment ago can still be named
+                #   here, and then answers 404.
+                #
+                #   @return [String, nil]
+                required :source_id, String, nil?: true
+
+                # @!attribute text
+                #
+                #   @return [String]
+                required :text, String
+
+                # @!attribute recorded_at
+                #
+                #   @return [String, nil]
+                optional :recorded_at, String, nil?: true
+
+                # @!method initialize(id:, derived_from:, source_id:, text:, recorded_at: nil)
+                #   Some parameter documentations has been truncated, see
+                #   {Telnyx::Models::AI::Memory::Namespaces::Profiles::MemoryRetrieveResponse::Data}
+                #   for more details.
+                #
+                #   @param id [String]
+                #
+                #   @param derived_from [Array<String>, nil] The ids of the memories this one was derived from. Read each with `GET .../memor
+                #
+                #   @param source_id [String, nil] The source this memory was extracted from. Set for a fact, which comes from exac
+                #
+                #   @param text [String]
+                #
+                #   @param recorded_at [String, nil]
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/ai/memory/namespaces/profiles/source_delete_params.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        module Namespaces
+          module Profiles
+            # @see Telnyx::Resources::AI::Memory::Namespaces::Profiles::Sources#delete
+            class SourceDeleteParams < Telnyx::Internal::Type::BaseModel
+              extend Telnyx::Internal::Type::RequestParameters::Converter
+              include Telnyx::Internal::Type::RequestParameters
+
+              # @!attribute namespace
+              #   The namespace. `default` exists for every organization.
+              #
+              #   @return [String]
+              required :namespace, String
+
+              # @!attribute profile_id
+              #   The profile: your identifier for the user, caller or agent this memory is about.
+              #
+              #   @return [String]
+              required :profile_id, String
+
+              # @!attribute source_id
+              #   Identifies one source within its profile: an ingested session, or one remembered
+              #   fact. Returned by `ingest` and `remember` when the write is accepted.
+              #   Re-ingesting a session keeps its source id.
+              #
+              #   @return [String]
+              required :source_id, String
+
+              # @!method initialize(namespace:, profile_id:, source_id:, request_options: {})
+              #   Some parameter documentations has been truncated, see
+              #   {Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceDeleteParams} for more
+              #   details.
+              #
+              #   @param namespace [String] The namespace. `default` exists for every organization.
+              #
+              #   @param profile_id [String] The profile: your identifier for the user, caller or agent this memory is about.
+              #
+              #   @param source_id [String] Identifies one source within its profile: an ingested session, or one remembered
+              #
+              #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/ai/memory/namespaces/profiles/source_delete_response.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        module Namespaces
+          module Profiles
+            # @see Telnyx::Resources::AI::Memory::Namespaces::Profiles::Sources#delete
+            class SourceDeleteResponse < Telnyx::Internal::Type::BaseModel
+              # @!attribute data
+              #
+              #   @return [Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceDeleteResponse::Data]
+              required :data, -> { Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceDeleteResponse::Data }
+
+              # @!method initialize(data:)
+              #   @param data [Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceDeleteResponse::Data]
+
+              # @see Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceDeleteResponse#data
+              class Data < Telnyx::Internal::Type::BaseModel
+                # @!attribute memories_deleted
+                #   Memories the profile held and no longer does, counted before and after across
+                #   the whole profile: it includes memories derived from this source together with
+                #   others, and anything else the profile lost in between. A report rather than an
+                #   audit. The status carries the outcome.
+                #
+                #   @return [Integer]
+                required :memories_deleted, Integer
+
+                # @!attribute profile_id
+                #
+                #   @return [String]
+                required :profile_id, String
+
+                # @!attribute source_id
+                #   Identifies one source within its profile: an ingested session, or one remembered
+                #   fact. Returned by `ingest` and `remember` when the write is accepted.
+                #   Re-ingesting a session keeps its source id.
+                #
+                #   @return [String]
+                required :source_id, String
+
+                # @!method initialize(memories_deleted:, profile_id:, source_id:)
+                #   Some parameter documentations has been truncated, see
+                #   {Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceDeleteResponse::Data}
+                #   for more details.
+                #
+                #   @param memories_deleted [Integer] Memories the profile held and no longer does, counted before and after across th
+                #
+                #   @param profile_id [String]
+                #
+                #   @param source_id [String] Identifies one source within its profile: an ingested session, or one remembered
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/ai/memory/namespaces/profiles/source_list_params.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        module Namespaces
+          module Profiles
+            # @see Telnyx::Resources::AI::Memory::Namespaces::Profiles::Sources#list
+            class SourceListParams < Telnyx::Internal::Type::BaseModel
+              extend Telnyx::Internal::Type::RequestParameters::Converter
+              include Telnyx::Internal::Type::RequestParameters
+
+              # @!attribute namespace
+              #
+              #   @return [String]
+              required :namespace, String
+
+              # @!attribute profile_id
+              #
+              #   @return [String]
+              required :profile_id, String
+
+              # @!attribute page_number
+              #   The page to return, counting from 1. Bounded in depth: (page[number] - 1) \*
+              #   page[size] may be at most 10000.
+              #
+              #   @return [Integer, nil]
+              optional :page_number, Integer
+
+              # @!attribute page_size
+              #   How many results a page holds.
+              #
+              #   @return [Integer, nil]
+              optional :page_size, Integer
+
+              # @!attribute session_id
+              #   An ingested session, by the `session_id` it was ingested with. Narrows the
+              #   request to the source that session was stored as.
+              #
+              #   @return [String, nil]
+              optional :session_id, String, nil?: true
+
+              # @!method initialize(namespace:, profile_id:, page_number: nil, page_size: nil, session_id: nil, request_options: {})
+              #   Some parameter documentations has been truncated, see
+              #   {Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceListParams} for more
+              #   details.
+              #
+              #   @param namespace [String]
+              #
+              #   @param profile_id [String]
+              #
+              #   @param page_number [Integer] The page to return, counting from 1. Bounded in depth: (page[number] - 1) \*
+              #   page
+              #
+              #   @param page_size [Integer] How many results a page holds.
+              #
+              #   @param session_id [String, nil] An ingested session, by the `session_id` it was ingested with. Narrows the reque
+              #
+              #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/ai/memory/namespaces/profiles/source_retrieve_params.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        module Namespaces
+          module Profiles
+            # @see Telnyx::Resources::AI::Memory::Namespaces::Profiles::Sources#retrieve
+            class SourceRetrieveParams < Telnyx::Internal::Type::BaseModel
+              extend Telnyx::Internal::Type::RequestParameters::Converter
+              include Telnyx::Internal::Type::RequestParameters
+
+              # @!attribute namespace
+              #   The namespace. `default` exists for every organization.
+              #
+              #   @return [String]
+              required :namespace, String
+
+              # @!attribute profile_id
+              #   The profile: your identifier for the user, caller or agent this memory is about.
+              #
+              #   @return [String]
+              required :profile_id, String
+
+              # @!attribute source_id
+              #   Identifies one source within its profile: an ingested session, or one remembered
+              #   fact. Returned by `ingest` and `remember` when the write is accepted.
+              #   Re-ingesting a session keeps its source id.
+              #
+              #   @return [String]
+              required :source_id, String
+
+              # @!method initialize(namespace:, profile_id:, source_id:, request_options: {})
+              #   Some parameter documentations has been truncated, see
+              #   {Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveParams} for
+              #   more details.
+              #
+              #   @param namespace [String] The namespace. `default` exists for every organization.
+              #
+              #   @param profile_id [String] The profile: your identifier for the user, caller or agent this memory is about.
+              #
+              #   @param source_id [String] Identifies one source within its profile: an ingested session, or one remembered
+              #
+              #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/ai/memory/namespaces/profiles/source_retrieve_response.rb

@@ -0,0 +1,123 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        module Namespaces
+          module Profiles
+            # @see Telnyx::Resources::AI::Memory::Namespaces::Profiles::Sources#retrieve
+            class SourceRetrieveResponse < Telnyx::Internal::Type::BaseModel
+              # @!attribute data
+              #
+              #   @return [Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse::Data]
+              required :data, -> { Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse::Data }
+
+              # @!method initialize(data:)
+              #   @param data [Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse::Data]
+
+              # @see Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse#data
+              class Data < Telnyx::Internal::Type::BaseModel
+                # @!attribute id
+                #   Identifies one source within its profile: an ingested session, or one remembered
+                #   fact. Returned by `ingest` and `remember` when the write is accepted.
+                #   Re-ingesting a session keeps its source id.
+                #
+                #   @return [String]
+                required :id, String
+
+                # @!attribute content
+                #   What was stored, in the shape it was sent: an ingested JSON body as JSON, a
+                #   string body or a remembered fact as a string. A session ingested before formats
+                #   were recorded is returned as the text it was stored as.
+                #
+                #   @return [Hash{Symbol=>Object}, Array<Object>, String, Float, Boolean]
+                required :content,
+                         union: -> { Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse::Data::Content }
+
+                # @!attribute memory_count
+                #   Memories extracted from this source. A memory derived from several sources is
+                #   not counted here.
+                #
+                #   @return [Integer]
+                required :memory_count, Integer
+
+                # @!attribute session_id
+                #   The session this source was ingested as. Null for a remembered fact.
+                #
+                #   @return [String, nil]
+                required :session_id, String, nil?: true
+
+                # @!attribute created_at
+                #   When the source was first stored.
+                #
+                #   @return [String, nil]
+                optional :created_at, String, nil?: true
+
+                # @!attribute updated_at
+                #   When the source was last written; re-ingesting moves it.
+                #
+                #   @return [String, nil]
+                optional :updated_at, String, nil?: true
+
+                # @!method initialize(id:, content:, memory_count:, session_id:, created_at: nil, updated_at: nil)
+                #   Some parameter documentations has been truncated, see
+                #   {Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse::Data}
+                #   for more details.
+                #
+                #   @param id [String] Identifies one source within its profile: an ingested session, or one remembered
+                #
+                #   @param content [Hash{Symbol=>Object}, Array<Object>, String, Float, Boolean] What was stored, in the shape it was sent: an ingested JSON body as JSON, a stri
+                #
+                #   @param memory_count [Integer] Memories extracted from this source. A memory derived from several sources is no
+                #
+                #   @param session_id [String, nil] The session this source was ingested as. Null for a remembered fact.
+                #
+                #   @param created_at [String, nil] When the source was first stored.
+                #
+                #   @param updated_at [String, nil] When the source was last written; re-ingesting moves it.
+
+                # What was stored, in the shape it was sent: an ingested JSON body as JSON, a
+                # string body or a remembered fact as a string. A session ingested before formats
+                # were recorded is returned as the text it was stored as.
+                #
+                # @see Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse::Data#content
+                module Content
+                  extend Telnyx::Internal::Type::Union
+
+                  variant -> { Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse::Data::Content::UnionMember0Map }
+
+                  variant union: -> { Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse::Data::Content::UnionMember1 }
+
+                  module UnionMember1
+                    extend Telnyx::Internal::Type::Union
+
+                    variant -> { Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse::Data::Content::UnionMember1::UnionMember0Array }
+
+                    variant String
+
+                    variant Float
+
+                    variant Telnyx::Internal::Type::Boolean
+
+                    # @!method self.variants
+                    #   @return [Array(Array<Object>, String, Float, Boolean)]
+
+                    # @type [Telnyx::Internal::Type::Converter]
+                    UnionMember0Array = Telnyx::Internal::Type::ArrayOf[Telnyx::Internal::Type::Unknown]
+                  end
+
+                  # @!method self.variants
+                  #   @return [Array(Hash{Symbol=>Object}, Array<Object>, String, Float, Boolean)]
+
+                  # @type [Telnyx::Internal::Type::Converter]
+                  UnionMember0Map = Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/ai/memory/namespaces/setting_list_params.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        module Namespaces
+          # @see Telnyx::Resources::AI::Memory::Namespaces::Settings#list
+          class SettingListParams < Telnyx::Internal::Type::BaseModel
+            extend Telnyx::Internal::Type::RequestParameters::Converter
+            include Telnyx::Internal::Type::RequestParameters
+
+            # @!attribute namespace
+            #   The namespace. `default` exists for every organization.
+            #
+            #   @return [String]
+            required :namespace, String
+
+            # @!method initialize(namespace:, request_options: {})
+            #   @param namespace [String] The namespace. `default` exists for every organization.
+            #
+            #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+          end
+        end
+      end
+    end
+  end
+end