telnyx 5.168.0 → 5.170.0

data/rbi/telnyx/models/ai/inference_embedding_webhook_tool_params.rbi

@@ -32,15 +32,56 @@ module Telnyx
         end
         attr_writer :webhook
 
+        # The maximum number of milliseconds to wait for the webhook to respond before the
+        # tool call is aborted. Set this at the tool level, as a sibling of `type` — a
+        # `timeout_ms` nested inside the `webhook` object is stored but not applied, and
+        # the tool runs at this default instead. Applies when `webhook.async` is false.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :timeout_ms
+
+        sig { params(timeout_ms: Integer).void }
+        attr_writer :timeout_ms
+
+        # Whether this tool comes from the shared Tools Library. Responses merge shared
+        # tools into `tools` with `shared: true`; inline tools carry `shared: false`.
+        # Read-only: set by the server, not accepted in requests. When updating an
+        # assistant, omit `shared: true` tools from the request `tools` array and manage
+        # them through `tool_ids` instead — re-sending their definitions creates an inline
+        # duplicate (rejected with error code 10015 when the type allows only one instance
+        # per assistant).
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :shared
+
+        sig { params(shared: T::Boolean).void }
+        attr_writer :shared
+
         sig do
           params(
             type:
               Telnyx::AI::InferenceEmbeddingWebhookToolParams::Type::OrSymbol,
             webhook:
-              Telnyx::AI::InferenceEmbeddingWebhookToolParams::Webhook::OrHash
+              Telnyx::AI::InferenceEmbeddingWebhookToolParams::Webhook::OrHash,
+            shared: T::Boolean,
+            timeout_ms: Integer
           ).returns(T.attached_class)
         end
-        def self.new(type:, webhook:)
+        def self.new(
+          type:,
+          webhook:,
+          # Whether this tool comes from the shared Tools Library. Responses merge shared
+          # tools into `tools` with `shared: true`; inline tools carry `shared: false`.
+          # Read-only: set by the server, not accepted in requests. When updating an
+          # assistant, omit `shared: true` tools from the request `tools` array and manage
+          # them through `tool_ids` instead — re-sending their definitions creates an inline
+          # duplicate (rejected with error code 10015 when the type allows only one instance
+          # per assistant).
+          shared: nil,
+          # The maximum number of milliseconds to wait for the webhook to respond before the
+          # tool call is aborted. Set this at the tool level, as a sibling of `type` — a
+          # `timeout_ms` nested inside the `webhook` object is stored but not applied, and
+          # the tool runs at this default instead. Applies when `webhook.async` is false.
+          timeout_ms: nil
+        )
         end
 
         sig do
@@ -48,7 +89,9 @@ module Telnyx
             {
               type:
                 Telnyx::AI::InferenceEmbeddingWebhookToolParams::Type::OrSymbol,
-              webhook: Telnyx::AI::InferenceEmbeddingWebhookToolParams::Webhook
+              webhook: Telnyx::AI::InferenceEmbeddingWebhookToolParams::Webhook,
+              shared: T::Boolean,
+              timeout_ms: Integer
             }
           )
         end
@@ -313,14 +356,6 @@ module Telnyx
           end
           attr_writer :store_fields_as_variables
 
-          # The maximum number of milliseconds to wait for the webhook to respond. Only
-          # applicable when async is false.
-          sig { returns(T.nilable(Integer)) }
-          attr_reader :timeout_ms
-
-          sig { params(timeout_ms: Integer).void }
-          attr_writer :timeout_ms
-
           sig do
             params(
               description: String,
@@ -352,8 +387,7 @@ module Telnyx
               store_fields_as_variables:
                 T::Array[
                   Telnyx::AI::InferenceEmbeddingWebhookToolParams::Webhook::StoreFieldsAsVariable::OrHash
-                ],
-              timeout_ms: Integer
+                ]
             ).returns(T.attached_class)
           end
           def self.new(
@@ -420,10 +454,7 @@ module Telnyx
             # A list of mappings that extract values from the webhook response and store them
             # as dynamic variables. Each mapping specifies a dynamic variable name and a
             # dot-notation path to the value in the response body.
-            store_fields_as_variables: nil,
-            # The maximum number of milliseconds to wait for the webhook to respond. Only
-            # applicable when async is false.
-            timeout_ms: nil
+            store_fields_as_variables: nil
           )
           end
 
@@ -459,8 +490,7 @@ module Telnyx
                 store_fields_as_variables:
                   T::Array[
                     Telnyx::AI::InferenceEmbeddingWebhookToolParams::Webhook::StoreFieldsAsVariable
-                  ],
-                timeout_ms: Integer
+                  ]
               }
             )
           end

data/rbi/telnyx/models/ai/memory/namespace_retrieve_params.rbi

@@ -0,0 +1,50 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        class NamespaceRetrieveParams < Telnyx::Internal::Type::BaseModel
+          extend Telnyx::Internal::Type::RequestParameters::Converter
+          include Telnyx::Internal::Type::RequestParameters
+
+          OrHash =
+            T.type_alias do
+              T.any(
+                Telnyx::AI::Memory::NamespaceRetrieveParams,
+                Telnyx::Internal::AnyHash
+              )
+            end
+
+          sig { returns(String) }
+          attr_accessor :namespace
+
+          sig { returns(String) }
+          attr_accessor :operation_id
+
+          sig do
+            params(
+              namespace: String,
+              operation_id: String,
+              request_options: Telnyx::RequestOptions::OrHash
+            ).returns(T.attached_class)
+          end
+          def self.new(namespace:, operation_id:, request_options: {})
+          end
+
+          sig do
+            override.returns(
+              {
+                namespace: String,
+                operation_id: String,
+                request_options: Telnyx::RequestOptions
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/ai/memory/namespace_retrieve_response.rbi

@@ -0,0 +1,167 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        class NamespaceRetrieveResponse < Telnyx::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Telnyx::Models::AI::Memory::NamespaceRetrieveResponse,
+                Telnyx::Internal::AnyHash
+              )
+            end
+
+          sig do
+            returns(Telnyx::Models::AI::Memory::NamespaceRetrieveResponse::Data)
+          end
+          attr_reader :data
+
+          sig do
+            params(
+              data:
+                Telnyx::Models::AI::Memory::NamespaceRetrieveResponse::Data::OrHash
+            ).void
+          end
+          attr_writer :data
+
+          sig do
+            params(
+              data:
+                Telnyx::Models::AI::Memory::NamespaceRetrieveResponse::Data::OrHash
+            ).returns(T.attached_class)
+          end
+          def self.new(data:)
+          end
+
+          sig do
+            override.returns(
+              {
+                data:
+                  Telnyx::Models::AI::Memory::NamespaceRetrieveResponse::Data
+              }
+            )
+          end
+          def to_hash
+          end
+
+          class Data < Telnyx::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Telnyx::Models::AI::Memory::NamespaceRetrieveResponse::Data,
+                  Telnyx::Internal::AnyHash
+                )
+              end
+
+            sig { returns(String) }
+            attr_accessor :operation_id
+
+            # Where the write is. `completed`, `failed` and `cancelled` are terminal: stop
+            # polling at any of them, and treat `failed` and `cancelled` as writes that did
+            # not happen.
+            sig do
+              returns(
+                Telnyx::Models::AI::Memory::NamespaceRetrieveResponse::Data::Status::TaggedSymbol
+              )
+            end
+            attr_accessor :status
+
+            sig { returns(T.nilable(String)) }
+            attr_accessor :completed_at
+
+            sig { returns(T.nilable(String)) }
+            attr_accessor :created_at
+
+            sig do
+              params(
+                operation_id: String,
+                status:
+                  Telnyx::Models::AI::Memory::NamespaceRetrieveResponse::Data::Status::OrSymbol,
+                completed_at: T.nilable(String),
+                created_at: T.nilable(String)
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              operation_id:,
+              # Where the write is. `completed`, `failed` and `cancelled` are terminal: stop
+              # polling at any of them, and treat `failed` and `cancelled` as writes that did
+              # not happen.
+              status:,
+              completed_at: nil,
+              created_at: nil
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  operation_id: String,
+                  status:
+                    Telnyx::Models::AI::Memory::NamespaceRetrieveResponse::Data::Status::TaggedSymbol,
+                  completed_at: T.nilable(String),
+                  created_at: T.nilable(String)
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # Where the write is. `completed`, `failed` and `cancelled` are terminal: stop
+            # polling at any of them, and treat `failed` and `cancelled` as writes that did
+            # not happen.
+            module Status
+              extend Telnyx::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    Telnyx::Models::AI::Memory::NamespaceRetrieveResponse::Data::Status
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              PENDING =
+                T.let(
+                  :pending,
+                  Telnyx::Models::AI::Memory::NamespaceRetrieveResponse::Data::Status::TaggedSymbol
+                )
+              PROCESSING =
+                T.let(
+                  :processing,
+                  Telnyx::Models::AI::Memory::NamespaceRetrieveResponse::Data::Status::TaggedSymbol
+                )
+              COMPLETED =
+                T.let(
+                  :completed,
+                  Telnyx::Models::AI::Memory::NamespaceRetrieveResponse::Data::Status::TaggedSymbol
+                )
+              FAILED =
+                T.let(
+                  :failed,
+                  Telnyx::Models::AI::Memory::NamespaceRetrieveResponse::Data::Status::TaggedSymbol
+                )
+              CANCELLED =
+                T.let(
+                  :cancelled,
+                  Telnyx::Models::AI::Memory::NamespaceRetrieveResponse::Data::Status::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    Telnyx::Models::AI::Memory::NamespaceRetrieveResponse::Data::Status::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/ai/memory/namespaces/namespace_settings_response.rbi

@@ -0,0 +1,156 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        NamespaceSettingsResponse = Namespaces::NamespaceSettingsResponse
+
+        module Namespaces
+          class NamespaceSettingsResponse < Telnyx::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Telnyx::AI::Memory::Namespaces::NamespaceSettingsResponse,
+                  Telnyx::Internal::AnyHash
+                )
+              end
+
+            # A namespace's settings, grouped by what they affect.
+            sig do
+              returns(
+                Telnyx::AI::Memory::Namespaces::NamespaceSettingsResponse::Data
+              )
+            end
+            attr_reader :data
+
+            sig do
+              params(
+                data:
+                  Telnyx::AI::Memory::Namespaces::NamespaceSettingsResponse::Data::OrHash
+              ).void
+            end
+            attr_writer :data
+
+            sig do
+              params(
+                data:
+                  Telnyx::AI::Memory::Namespaces::NamespaceSettingsResponse::Data::OrHash
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # A namespace's settings, grouped by what they affect.
+              data:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  data:
+                    Telnyx::AI::Memory::Namespaces::NamespaceSettingsResponse::Data
+                }
+              )
+            end
+            def to_hash
+            end
+
+            class Data < Telnyx::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    Telnyx::AI::Memory::Namespaces::NamespaceSettingsResponse::Data,
+                    Telnyx::Internal::AnyHash
+                  )
+                end
+
+              # Settings that shape this namespace's summaries.
+              sig do
+                returns(
+                  T.nilable(
+                    Telnyx::AI::Memory::Namespaces::NamespaceSettingsResponse::Data::Summary
+                  )
+                )
+              end
+              attr_reader :summary
+
+              sig do
+                params(
+                  summary:
+                    Telnyx::AI::Memory::Namespaces::NamespaceSettingsResponse::Data::Summary::OrHash
+                ).void
+              end
+              attr_writer :summary
+
+              # A namespace's settings, grouped by what they affect.
+              sig do
+                params(
+                  summary:
+                    Telnyx::AI::Memory::Namespaces::NamespaceSettingsResponse::Data::Summary::OrHash
+                ).returns(T.attached_class)
+              end
+              def self.new(
+                # Settings that shape this namespace's summaries.
+                summary: nil
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    summary:
+                      Telnyx::AI::Memory::Namespaces::NamespaceSettingsResponse::Data::Summary
+                  }
+                )
+              end
+              def to_hash
+              end
+
+              class Summary < Telnyx::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      Telnyx::AI::Memory::Namespaces::NamespaceSettingsResponse::Data::Summary,
+                      Telnyx::Internal::AnyHash
+                    )
+                  end
+
+                # Free-form instructions that influence how this namespace's summaries are
+                # written, shared by every profile in the namespace. How you use them is up to you
+                # -- they steer the outcome, so try a phrasing and see how the summary comes out.
+                # Advisory: they steer the summary but never override or deny a profile's own
+                # facts, and they do not affect recall. Null or empty means none are set, and
+                # summaries use the neutral default. A change reaches each summary the next time
+                # it is regenerated.
+                sig { returns(T.nilable(String)) }
+                attr_accessor :instructions
+
+                # Settings that shape this namespace's summaries.
+                sig do
+                  params(instructions: T.nilable(String)).returns(
+                    T.attached_class
+                  )
+                end
+                def self.new(
+                  # Free-form instructions that influence how this namespace's summaries are
+                  # written, shared by every profile in the namespace. How you use them is up to you
+                  # -- they steer the outcome, so try a phrasing and see how the summary comes out.
+                  # Advisory: they steer the summary but never override or deny a profile's own
+                  # facts, and they do not affect recall. Null or empty means none are set, and
+                  # summaries use the neutral default. A change reaches each summary the next time
+                  # it is regenerated.
+                  instructions: nil
+                )
+                end
+
+                sig { override.returns({ instructions: T.nilable(String) }) }
+                def to_hash
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/ai/memory/namespaces/page_meta.rbi

@@ -0,0 +1,81 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        module Namespaces
+          class PageMeta < Telnyx::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Telnyx::AI::Memory::Namespaces::PageMeta,
+                  Telnyx::Internal::AnyHash
+                )
+              end
+
+            # The page returned, counting from 1.
+            sig { returns(Integer) }
+            attr_accessor :page_number
+
+            # How many results a page holds.
+            sig { returns(Integer) }
+            attr_accessor :page_size
+
+            # Pages that can be requested; 0 when nothing matched. Page until `page_number`
+            # reaches it rather than until a page comes back short: a page can hold fewer than
+            # `page_size` results without being the last. Capped at the deepest page served,
+            # so on a very large listing it covers fewer results than `total_results`.
+            sig { returns(Integer) }
+            attr_accessor :total_pages
+
+            # Results the request matched, including any past the deepest page.
+            sig { returns(Integer) }
+            attr_accessor :total_results
+
+            # Where a listing's page sits in the whole.
+            #
+            # A page is a snapshot: the counts it reports and the order it is drawn in both
+            # move as writes land, so paging through a busy namespace can repeat or miss an
+            # entry at a page boundary.
+            sig do
+              params(
+                page_number: Integer,
+                page_size: Integer,
+                total_pages: Integer,
+                total_results: Integer
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # The page returned, counting from 1.
+              page_number:,
+              # How many results a page holds.
+              page_size:,
+              # Pages that can be requested; 0 when nothing matched. Page until `page_number`
+              # reaches it rather than until a page comes back short: a page can hold fewer than
+              # `page_size` results without being the last. Capped at the deepest page served,
+              # so on a very large listing it covers fewer results than `total_results`.
+              total_pages:,
+              # Results the request matched, including any past the deepest page.
+              total_results:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  page_number: Integer,
+                  page_size: Integer,
+                  total_pages: Integer,
+                  total_results: Integer
+                }
+              )
+            end
+            def to_hash
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/ai/memory/namespaces/profile_delete_params.rbi

@@ -0,0 +1,58 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        module Namespaces
+          class ProfileDeleteParams < Telnyx::Internal::Type::BaseModel
+            extend Telnyx::Internal::Type::RequestParameters::Converter
+            include Telnyx::Internal::Type::RequestParameters
+
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Telnyx::AI::Memory::Namespaces::ProfileDeleteParams,
+                  Telnyx::Internal::AnyHash
+                )
+              end
+
+            # The namespace. `default` exists for every organization.
+            sig { returns(String) }
+            attr_accessor :namespace
+
+            sig { returns(String) }
+            attr_accessor :profile_id
+
+            sig do
+              params(
+                namespace: String,
+                profile_id: String,
+                request_options: Telnyx::RequestOptions::OrHash
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # The namespace. `default` exists for every organization.
+              namespace:,
+              profile_id:,
+              request_options: {}
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  namespace: String,
+                  profile_id: String,
+                  request_options: Telnyx::RequestOptions
+                }
+              )
+            end
+            def to_hash
+            end
+          end
+        end
+      end
+    end
+  end
+end