yandexcloud 0.346.0__py3-none-any.whl → 0.347.0__py3-none-any.whl

yandex/cloud/ai/assistants/v1/common_pb2.py

@@ -27,7 +27,7 @@ from google.protobuf import wrappers_pb2 as google_dot_protobuf_dot_wrappers__pb
 from yandex.cloud import validation_pb2 as yandex_dot_cloud_dot_validation__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n*yandex/cloud/ai/assistants/v1/common.proto\x12\x1dyandex.cloud.ai.assistants.v1\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1egoogle/protobuf/wrappers.proto\x1a\x1dyandex/cloud/validation.proto\"\xf2\x02\n\x17PromptTruncationOptions\x12\x36\n\x11max_prompt_tokens\x18\x01 \x01(\x0b\x32\x1b.google.protobuf.Int64Value\x12\\\n\rauto_strategy\x18\x02 \x01(\x0b\x32\x43.yandex.cloud.ai.assistants.v1.PromptTruncationOptions.AutoStrategyH\x00\x12m\n\x16last_messages_strategy\x18\x03 \x01(\x0b\x32K.yandex.cloud.ai.assistants.v1.PromptTruncationOptions.LastMessagesStrategyH\x00\x1a\x0e\n\x0c\x41utoStrategy\x1a,\n\x14LastMessagesStrategy\x12\x14\n\x0cnum_messages\x18\x01 \x01(\x03\x42\x14\n\x12TruncationStrategy\"w\n\x11\x43ompletionOptions\x12/\n\nmax_tokens\x18\x02 \x01(\x0b\x32\x1b.google.protobuf.Int64Value\x12\x31\n\x0btemperature\x18\x03 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\"\x9b\x01\n\x04Tool\x12\x46\n\x0csearch_index\x18\x01 \x01(\x0b\x32..yandex.cloud.ai.assistants.v1.SearchIndexToolH\x00\x12?\n\x08\x66unction\x18\x02 \x01(\x0b\x32+.yandex.cloud.ai.assistants.v1.FunctionToolH\x00\x42\n\n\x08ToolType\"`\n\x08ToolCall\x12\x44\n\rfunction_call\x18\x01 \x01(\x0b\x32+.yandex.cloud.ai.assistants.v1.FunctionCallH\x00\x42\x0e\n\x0cToolCallType\"K\n\x0cToolCallList\x12;\n\ntool_calls\x18\x01 \x03(\x0b\x32\'.yandex.cloud.ai.assistants.v1.ToolCall\"h\n\nToolResult\x12H\n\x0f\x66unction_result\x18\x01 \x01(\x0b\x32-.yandex.cloud.ai.assistants.v1.FunctionResultH\x00\x42\x10\n\x0eToolResultType\"Q\n\x0eToolResultList\x12?\n\x0ctool_results\x18\x01 \x03(\x0b\x32).yandex.cloud.ai.assistants.v1.ToolResult\"\xad\x01\n\x0fSearchIndexTool\x12\x18\n\x10search_index_ids\x18\x01 \x03(\t\x12\x34\n\x0fmax_num_results\x18\x02 \x01(\x0b\x32\x1b.google.protobuf.Int64Value\x12J\n\x11rephraser_options\x18\x03 \x01(\x0b\x32/.yandex.cloud.ai.assistants.v1.RephraserOptions\"^\n\x0c\x46unctionTool\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12+\n\nparameters\x18\x03 \x01(\x0b\x32\x17.google.protobuf.Struct\"H\n\x0c\x46unctionCall\x12\x0c\n\x04name\x18\x01 \x01(\t\x12*\n\targuments\x18\x02 \x01(\x0b\x32\x17.google.protobuf.Struct\"@\n\x0e\x46unctionResult\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x11\n\x07\x63ontent\x18\x02 \x01(\tH\x00\x42\r\n\x0b\x43ontentType\"/\n\x10RephraserOptions\x12\x1b\n\rrephraser_uri\x18\x01 \x01(\tB\x04\xe8\xc7\x31\x01\x42q\n!yandex.cloud.api.ai.assistants.v1ZLgithub.com/yandex-cloud/go-genproto/yandex/cloud/ai/assistants/v1;assistantsb\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n*yandex/cloud/ai/assistants/v1/common.proto\x12\x1dyandex.cloud.ai.assistants.v1\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1egoogle/protobuf/wrappers.proto\x1a\x1dyandex/cloud/validation.proto\"\xf2\x02\n\x17PromptTruncationOptions\x12\x36\n\x11max_prompt_tokens\x18\x01 \x01(\x0b\x32\x1b.google.protobuf.Int64Value\x12\\\n\rauto_strategy\x18\x02 \x01(\x0b\x32\x43.yandex.cloud.ai.assistants.v1.PromptTruncationOptions.AutoStrategyH\x00\x12m\n\x16last_messages_strategy\x18\x03 \x01(\x0b\x32K.yandex.cloud.ai.assistants.v1.PromptTruncationOptions.LastMessagesStrategyH\x00\x1a\x0e\n\x0c\x41utoStrategy\x1a,\n\x14LastMessagesStrategy\x12\x14\n\x0cnum_messages\x18\x01 \x01(\x03\x42\x14\n\x12TruncationStrategy\"w\n\x11\x43ompletionOptions\x12/\n\nmax_tokens\x18\x02 \x01(\x0b\x32\x1b.google.protobuf.Int64Value\x12\x31\n\x0btemperature\x18\x03 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\"\x9b\x01\n\x04Tool\x12\x46\n\x0csearch_index\x18\x01 \x01(\x0b\x32..yandex.cloud.ai.assistants.v1.SearchIndexToolH\x00\x12?\n\x08\x66unction\x18\x02 \x01(\x0b\x32+.yandex.cloud.ai.assistants.v1.FunctionToolH\x00\x42\n\n\x08ToolType\"`\n\x08ToolCall\x12\x44\n\rfunction_call\x18\x01 \x01(\x0b\x32+.yandex.cloud.ai.assistants.v1.FunctionCallH\x00\x42\x0e\n\x0cToolCallType\"K\n\x0cToolCallList\x12;\n\ntool_calls\x18\x01 \x03(\x0b\x32\'.yandex.cloud.ai.assistants.v1.ToolCall\"h\n\nToolResult\x12H\n\x0f\x66unction_result\x18\x01 \x01(\x0b\x32-.yandex.cloud.ai.assistants.v1.FunctionResultH\x00\x42\x10\n\x0eToolResultType\"Q\n\x0eToolResultList\x12?\n\x0ctool_results\x18\x01 \x03(\x0b\x32).yandex.cloud.ai.assistants.v1.ToolResult\"\xf1\x01\n\x0fSearchIndexTool\x12\x18\n\x10search_index_ids\x18\x01 \x03(\t\x12\x34\n\x0fmax_num_results\x18\x02 \x01(\x0b\x32\x1b.google.protobuf.Int64Value\x12J\n\x11rephraser_options\x18\x03 \x01(\x0b\x32/.yandex.cloud.ai.assistants.v1.RephraserOptions\x12\x42\n\rcall_strategy\x18\x04 \x01(\x0b\x32+.yandex.cloud.ai.assistants.v1.CallStrategy\"\xf7\x01\n\x0c\x43\x61llStrategy\x12M\n\x0b\x61lways_call\x18\x01 \x01(\x0b\x32\x36.yandex.cloud.ai.assistants.v1.CallStrategy.AlwaysCallH\x00\x12I\n\tauto_call\x18\x02 \x01(\x0b\x32\x34.yandex.cloud.ai.assistants.v1.CallStrategy.AutoCallH\x00\x1a\x0c\n\nAlwaysCall\x1a\x33\n\x08\x41utoCall\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x19\n\x0binstruction\x18\x02 \x01(\tB\x04\xe8\xc7\x31\x01\x42\n\n\x08Strategy\"^\n\x0c\x46unctionTool\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12+\n\nparameters\x18\x03 \x01(\x0b\x32\x17.google.protobuf.Struct\"H\n\x0c\x46unctionCall\x12\x0c\n\x04name\x18\x01 \x01(\t\x12*\n\targuments\x18\x02 \x01(\x0b\x32\x17.google.protobuf.Struct\"@\n\x0e\x46unctionResult\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x11\n\x07\x63ontent\x18\x02 \x01(\tH\x00\x42\r\n\x0b\x43ontentType\"/\n\x10RephraserOptions\x12\x1b\n\rrephraser_uri\x18\x01 \x01(\tB\x04\xe8\xc7\x31\x01\x42q\n!yandex.cloud.api.ai.assistants.v1ZLgithub.com/yandex-cloud/go-genproto/yandex/cloud/ai/assistants/v1;assistantsb\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -35,6 +35,8 @@ _builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'yandex.cloud.ai.assistants.
 if not _descriptor._USE_C_DESCRIPTORS:
   _globals['DESCRIPTOR']._loaded_options = None
   _globals['DESCRIPTOR']._serialized_options = b'\n!yandex.cloud.api.ai.assistants.v1ZLgithub.com/yandex-cloud/go-genproto/yandex/cloud/ai/assistants/v1;assistants'
+  _globals['_CALLSTRATEGY_AUTOCALL'].fields_by_name['instruction']._loaded_options = None
+  _globals['_CALLSTRATEGY_AUTOCALL'].fields_by_name['instruction']._serialized_options = b'\350\3071\001'
   _globals['_REPHRASEROPTIONS'].fields_by_name['rephraser_uri']._loaded_options = None
   _globals['_REPHRASEROPTIONS'].fields_by_name['rephraser_uri']._serialized_options = b'\350\3071\001'
   _globals['_PROMPTTRUNCATIONOPTIONS']._serialized_start=171
@@ -56,13 +58,19 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['_TOOLRESULTLIST']._serialized_start=1103
   _globals['_TOOLRESULTLIST']._serialized_end=1184
   _globals['_SEARCHINDEXTOOL']._serialized_start=1187
-  _globals['_SEARCHINDEXTOOL']._serialized_end=1360
-  _globals['_FUNCTIONTOOL']._serialized_start=1362
-  _globals['_FUNCTIONTOOL']._serialized_end=1456
-  _globals['_FUNCTIONCALL']._serialized_start=1458
-  _globals['_FUNCTIONCALL']._serialized_end=1530
-  _globals['_FUNCTIONRESULT']._serialized_start=1532
-  _globals['_FUNCTIONRESULT']._serialized_end=1596
-  _globals['_REPHRASEROPTIONS']._serialized_start=1598
-  _globals['_REPHRASEROPTIONS']._serialized_end=1645
+  _globals['_SEARCHINDEXTOOL']._serialized_end=1428
+  _globals['_CALLSTRATEGY']._serialized_start=1431
+  _globals['_CALLSTRATEGY']._serialized_end=1678
+  _globals['_CALLSTRATEGY_ALWAYSCALL']._serialized_start=1601
+  _globals['_CALLSTRATEGY_ALWAYSCALL']._serialized_end=1613
+  _globals['_CALLSTRATEGY_AUTOCALL']._serialized_start=1615
+  _globals['_CALLSTRATEGY_AUTOCALL']._serialized_end=1666
+  _globals['_FUNCTIONTOOL']._serialized_start=1680
+  _globals['_FUNCTIONTOOL']._serialized_end=1774
+  _globals['_FUNCTIONCALL']._serialized_start=1776
+  _globals['_FUNCTIONCALL']._serialized_end=1848
+  _globals['_FUNCTIONRESULT']._serialized_start=1850
+  _globals['_FUNCTIONRESULT']._serialized_end=1914
+  _globals['_REPHRASEROPTIONS']._serialized_start=1916
+  _globals['_REPHRASEROPTIONS']._serialized_end=1963
 # @@protoc_insertion_point(module_scope)

yandex/cloud/ai/assistants/v1/common_pb2.pyi

@@ -235,6 +235,7 @@ class SearchIndexTool(google.protobuf.message.Message):
     SEARCH_INDEX_IDS_FIELD_NUMBER: builtins.int
     MAX_NUM_RESULTS_FIELD_NUMBER: builtins.int
     REPHRASER_OPTIONS_FIELD_NUMBER: builtins.int
+    CALL_STRATEGY_FIELD_NUMBER: builtins.int
     @property
     def search_index_ids(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.str]:
         """A list of search index IDs that this tool will query. Currently, only a single index ID is supported."""
@@ -253,18 +254,82 @@ class SearchIndexTool(google.protobuf.message.Message):
         incorporating context from the previous conversation.
         """
 
+    @property
+    def call_strategy(self) -> global___CallStrategy:
+        """Defines the strategy for triggering search.
+        Controls whether search results are always included or returned only when
+        the model explicitly calls the tool.
+        """
+
     def __init__(
         self,
         *,
         search_index_ids: collections.abc.Iterable[builtins.str] | None = ...,
         max_num_results: google.protobuf.wrappers_pb2.Int64Value | None = ...,
         rephraser_options: global___RephraserOptions | None = ...,
+        call_strategy: global___CallStrategy | None = ...,
     ) -> None: ...
-    def HasField(self, field_name: typing.Literal["max_num_results", b"max_num_results", "rephraser_options", b"rephraser_options"]) -> builtins.bool: ...
-    def ClearField(self, field_name: typing.Literal["max_num_results", b"max_num_results", "rephraser_options", b"rephraser_options", "search_index_ids", b"search_index_ids"]) -> None: ...
+    def HasField(self, field_name: typing.Literal["call_strategy", b"call_strategy", "max_num_results", b"max_num_results", "rephraser_options", b"rephraser_options"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["call_strategy", b"call_strategy", "max_num_results", b"max_num_results", "rephraser_options", b"rephraser_options", "search_index_ids", b"search_index_ids"]) -> None: ...
 
 global___SearchIndexTool = SearchIndexTool
 
+@typing.final
+class CallStrategy(google.protobuf.message.Message):
+    """Defines when the assistant uses the search tool."""
+
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    @typing.final
+    class AlwaysCall(google.protobuf.message.Message):
+        """Always includes retrieved search results in the prompt."""
+
+        DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+        def __init__(
+            self,
+        ) -> None: ...
+
+    @typing.final
+    class AutoCall(google.protobuf.message.Message):
+        """Exposes the tool as a callable function.
+        The model decides when to trigger search based on the instruction.
+        """
+
+        DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+        NAME_FIELD_NUMBER: builtins.int
+        INSTRUCTION_FIELD_NUMBER: builtins.int
+        name: builtins.str
+        """The name of the tool as exposed to the model."""
+        instruction: builtins.str
+        """Required instruction that helps the model decide when to call the tool."""
+        def __init__(
+            self,
+            *,
+            name: builtins.str = ...,
+            instruction: builtins.str = ...,
+        ) -> None: ...
+        def ClearField(self, field_name: typing.Literal["instruction", b"instruction", "name", b"name"]) -> None: ...
+
+    ALWAYS_CALL_FIELD_NUMBER: builtins.int
+    AUTO_CALL_FIELD_NUMBER: builtins.int
+    @property
+    def always_call(self) -> global___CallStrategy.AlwaysCall: ...
+    @property
+    def auto_call(self) -> global___CallStrategy.AutoCall: ...
+    def __init__(
+        self,
+        *,
+        always_call: global___CallStrategy.AlwaysCall | None = ...,
+        auto_call: global___CallStrategy.AutoCall | None = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["Strategy", b"Strategy", "always_call", b"always_call", "auto_call", b"auto_call"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["Strategy", b"Strategy", "always_call", b"always_call", "auto_call", b"auto_call"]) -> None: ...
+    def WhichOneof(self, oneof_group: typing.Literal["Strategy", b"Strategy"]) -> typing.Literal["always_call", "auto_call"] | None: ...
+
+global___CallStrategy = CallStrategy
+
 @typing.final
 class FunctionTool(google.protobuf.message.Message):
     """Represents a function tool that can be invoked by the assistant."""

yandex/cloud/marketplace/licensemanager/saas/v1/lock_service_pb2.py

@@ -29,7 +29,7 @@ from yandex.cloud.operation import operation_pb2 as yandex_dot_cloud_dot_operati
 from yandex.cloud import validation_pb2 as yandex_dot_cloud_dot_validation__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\nByandex/cloud/marketplace/licensemanager/saas/v1/lock_service.proto\x12/yandex.cloud.marketplace.licensemanager.saas.v1\x1a\x1cgoogle/api/annotations.proto\x1a yandex/cloud/api/operation.proto\x1a\x35yandex/cloud/marketplace/licensemanager/v1/lock.proto\x1a&yandex/cloud/operation/operation.proto\x1a\x1dyandex/cloud/validation.proto\"L\n\x11\x45nsureLockRequest\x12\x1c\n\x0einstance_token\x18\x01 \x01(\tB\x04\xe8\xc7\x31\x01\x12\x19\n\x0bresource_id\x18\x02 \x01(\tB\x04\xe8\xc7\x31\x01\"%\n\x12\x45nsureLockMetadata\x12\x0f\n\x07lock_id\x18\x01 \x01(\t\"\'\n\x0eGetLockRequest\x12\x15\n\x07lock_id\x18\x01 \x01(\tB\x04\xe8\xc7\x31\x01\x32\xa6\x03\n\x0bLockService\x12\xdd\x01\n\x06\x45nsure\x12\x42.yandex.cloud.marketplace.licensemanager.saas.v1.EnsureLockRequest\x1a!.yandex.cloud.operation.Operation\"l\xb2\xd2*,\n\x12\x45nsureLockMetadata\x12\x16licensemanager.v1.Lock\x82\xd3\xe4\x93\x02\x36\"1/marketplace/license-manager/saas/v1/locks/ensure:\x01*\x12\xb6\x01\n\x03Get\x12?.yandex.cloud.marketplace.licensemanager.saas.v1.GetLockRequest\x1a\x30.yandex.cloud.marketplace.licensemanager.v1.Lock\"<\x82\xd3\xe4\x93\x02\x36\x12\x34/marketplace/license-manager/saas/v1/locks/{lock_id}B\x99\x01\n3yandex.cloud.api.marketplace.licensemanager.saas.v1Zbgithub.com/yandex-cloud/go-genproto/yandex/cloud/marketplace/licensemanager/saas/v1;licensemanagerb\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\nByandex/cloud/marketplace/licensemanager/saas/v1/lock_service.proto\x12/yandex.cloud.marketplace.licensemanager.saas.v1\x1a\x1cgoogle/api/annotations.proto\x1a yandex/cloud/api/operation.proto\x1a\x35yandex/cloud/marketplace/licensemanager/v1/lock.proto\x1a&yandex/cloud/operation/operation.proto\x1a\x1dyandex/cloud/validation.proto\"L\n\x11\x45nsureLockRequest\x12\x1c\n\x0einstance_token\x18\x01 \x01(\tB\x04\xe8\xc7\x31\x01\x12\x19\n\x0bresource_id\x18\x02 \x01(\tB\x04\xe8\xc7\x31\x01\"%\n\x12\x45nsureLockMetadata\x12\x0f\n\x07lock_id\x18\x01 \x01(\t\"\'\n\x0eGetLockRequest\x12\x15\n\x07lock_id\x18\x01 \x01(\tB\x04\xe8\xc7\x31\x01\"R\n\x1aGetLockByResourceIDRequest\x12\x19\n\x0bresource_id\x18\x01 \x01(\tB\x04\xe8\xc7\x31\x01\x12\x19\n\x0binstance_id\x18\x02 \x01(\tB\x04\xe8\xc7\x31\x01\x32\xfd\x04\n\x0bLockService\x12\xdd\x01\n\x06\x45nsure\x12\x42.yandex.cloud.marketplace.licensemanager.saas.v1.EnsureLockRequest\x1a!.yandex.cloud.operation.Operation\"l\xb2\xd2*,\n\x12\x45nsureLockMetadata\x12\x16licensemanager.v1.Lock\x82\xd3\xe4\x93\x02\x36\"1/marketplace/license-manager/saas/v1/locks/ensure:\x01*\x12\xb6\x01\n\x03Get\x12?.yandex.cloud.marketplace.licensemanager.saas.v1.GetLockRequest\x1a\x30.yandex.cloud.marketplace.licensemanager.v1.Lock\"<\x82\xd3\xe4\x93\x02\x36\x12\x34/marketplace/license-manager/saas/v1/locks/{lock_id}\x12\xd4\x01\n\x0fGetByResourceID\x12K.yandex.cloud.marketplace.licensemanager.saas.v1.GetLockByResourceIDRequest\x1a\x30.yandex.cloud.marketplace.licensemanager.v1.Lock\"B\x82\xd3\xe4\x93\x02<\x12:/marketplace/license-manager/saas/v1/locks:getByResourceIDB\x99\x01\n3yandex.cloud.api.marketplace.licensemanager.saas.v1Zbgithub.com/yandex-cloud/go-genproto/yandex/cloud/marketplace/licensemanager/saas/v1;licensemanagerb\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -43,16 +43,24 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['_ENSURELOCKREQUEST'].fields_by_name['resource_id']._serialized_options = b'\350\3071\001'
   _globals['_GETLOCKREQUEST'].fields_by_name['lock_id']._loaded_options = None
   _globals['_GETLOCKREQUEST'].fields_by_name['lock_id']._serialized_options = b'\350\3071\001'
+  _globals['_GETLOCKBYRESOURCEIDREQUEST'].fields_by_name['resource_id']._loaded_options = None
+  _globals['_GETLOCKBYRESOURCEIDREQUEST'].fields_by_name['resource_id']._serialized_options = b'\350\3071\001'
+  _globals['_GETLOCKBYRESOURCEIDREQUEST'].fields_by_name['instance_id']._loaded_options = None
+  _globals['_GETLOCKBYRESOURCEIDREQUEST'].fields_by_name['instance_id']._serialized_options = b'\350\3071\001'
   _globals['_LOCKSERVICE'].methods_by_name['Ensure']._loaded_options = None
   _globals['_LOCKSERVICE'].methods_by_name['Ensure']._serialized_options = b'\262\322*,\n\022EnsureLockMetadata\022\026licensemanager.v1.Lock\202\323\344\223\0026\"1/marketplace/license-manager/saas/v1/locks/ensure:\001*'
   _globals['_LOCKSERVICE'].methods_by_name['Get']._loaded_options = None
   _globals['_LOCKSERVICE'].methods_by_name['Get']._serialized_options = b'\202\323\344\223\0026\0224/marketplace/license-manager/saas/v1/locks/{lock_id}'
+  _globals['_LOCKSERVICE'].methods_by_name['GetByResourceID']._loaded_options = None
+  _globals['_LOCKSERVICE'].methods_by_name['GetByResourceID']._serialized_options = b'\202\323\344\223\002<\022:/marketplace/license-manager/saas/v1/locks:getByResourceID'
   _globals['_ENSURELOCKREQUEST']._serialized_start=309
   _globals['_ENSURELOCKREQUEST']._serialized_end=385
   _globals['_ENSURELOCKMETADATA']._serialized_start=387
   _globals['_ENSURELOCKMETADATA']._serialized_end=424
   _globals['_GETLOCKREQUEST']._serialized_start=426
   _globals['_GETLOCKREQUEST']._serialized_end=465
-  _globals['_LOCKSERVICE']._serialized_start=468
-  _globals['_LOCKSERVICE']._serialized_end=890
+  _globals['_GETLOCKBYRESOURCEIDREQUEST']._serialized_start=467
+  _globals['_GETLOCKBYRESOURCEIDREQUEST']._serialized_end=549
+  _globals['_LOCKSERVICE']._serialized_start=552
+  _globals['_LOCKSERVICE']._serialized_end=1189
 # @@protoc_insertion_point(module_scope)

yandex/cloud/marketplace/licensemanager/saas/v1/lock_service_pb2.pyi

@@ -61,3 +61,23 @@ class GetLockRequest(google.protobuf.message.Message):
     def ClearField(self, field_name: typing.Literal["lock_id", b"lock_id"]) -> None: ...
 
 global___GetLockRequest = GetLockRequest
+
+@typing.final
+class GetLockByResourceIDRequest(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    RESOURCE_ID_FIELD_NUMBER: builtins.int
+    INSTANCE_ID_FIELD_NUMBER: builtins.int
+    resource_id: builtins.str
+    """ID of the resource to with subscription is locked."""
+    instance_id: builtins.str
+    """ID of the subscription"""
+    def __init__(
+        self,
+        *,
+        resource_id: builtins.str = ...,
+        instance_id: builtins.str = ...,
+    ) -> None: ...
+    def ClearField(self, field_name: typing.Literal["instance_id", b"instance_id", "resource_id", b"resource_id"]) -> None: ...
+
+global___GetLockByResourceIDRequest = GetLockByResourceIDRequest

yandex/cloud/marketplace/licensemanager/saas/v1/lock_service_pb2_grpc.py

@@ -47,6 +47,11 @@ class LockServiceStub(object):
                 request_serializer=yandex_dot_cloud_dot_marketplace_dot_licensemanager_dot_saas_dot_v1_dot_lock__service__pb2.GetLockRequest.SerializeToString,
                 response_deserializer=yandex_dot_cloud_dot_marketplace_dot_licensemanager_dot_v1_dot_lock__pb2.Lock.FromString,
                 _registered_method=True)
+        self.GetByResourceID = channel.unary_unary(
+                '/yandex.cloud.marketplace.licensemanager.saas.v1.LockService/GetByResourceID',
+                request_serializer=yandex_dot_cloud_dot_marketplace_dot_licensemanager_dot_saas_dot_v1_dot_lock__service__pb2.GetLockByResourceIDRequest.SerializeToString,
+                response_deserializer=yandex_dot_cloud_dot_marketplace_dot_licensemanager_dot_v1_dot_lock__pb2.Lock.FromString,
+                _registered_method=True)
 
 
 class LockServiceServicer(object):
@@ -68,6 +73,13 @@ class LockServiceServicer(object):
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
+    def GetByResourceID(self, request, context):
+        """Returns the subscription lock for given resource and subscription.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
 
 def add_LockServiceServicer_to_server(servicer, server):
     rpc_method_handlers = {
@@ -81,6 +93,11 @@ def add_LockServiceServicer_to_server(servicer, server):
                     request_deserializer=yandex_dot_cloud_dot_marketplace_dot_licensemanager_dot_saas_dot_v1_dot_lock__service__pb2.GetLockRequest.FromString,
                     response_serializer=yandex_dot_cloud_dot_marketplace_dot_licensemanager_dot_v1_dot_lock__pb2.Lock.SerializeToString,
             ),
+            'GetByResourceID': grpc.unary_unary_rpc_method_handler(
+                    servicer.GetByResourceID,
+                    request_deserializer=yandex_dot_cloud_dot_marketplace_dot_licensemanager_dot_saas_dot_v1_dot_lock__service__pb2.GetLockByResourceIDRequest.FromString,
+                    response_serializer=yandex_dot_cloud_dot_marketplace_dot_licensemanager_dot_v1_dot_lock__pb2.Lock.SerializeToString,
+            ),
     }
     generic_handler = grpc.method_handlers_generic_handler(
             'yandex.cloud.marketplace.licensemanager.saas.v1.LockService', rpc_method_handlers)
@@ -146,3 +163,30 @@ class LockService(object):
             timeout,
             metadata,
             _registered_method=True)
+
+    @staticmethod
+    def GetByResourceID(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/yandex.cloud.marketplace.licensemanager.saas.v1.LockService/GetByResourceID',
+            yandex_dot_cloud_dot_marketplace_dot_licensemanager_dot_saas_dot_v1_dot_lock__service__pb2.GetLockByResourceIDRequest.SerializeToString,
+            yandex_dot_cloud_dot_marketplace_dot_licensemanager_dot_v1_dot_lock__pb2.Lock.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)

yandex/cloud/marketplace/licensemanager/saas/v1/lock_service_pb2_grpc.pyi

@@ -37,6 +37,12 @@ class LockServiceStub:
     ]
     """Returns the specified subscription lock."""
 
+    GetByResourceID: grpc.UnaryUnaryMultiCallable[
+        yandex.cloud.marketplace.licensemanager.saas.v1.lock_service_pb2.GetLockByResourceIDRequest,
+        yandex.cloud.marketplace.licensemanager.v1.lock_pb2.Lock,
+    ]
+    """Returns the subscription lock for given resource and subscription."""
+
 class LockServiceAsyncStub:
     """A set of methods for managing subscription locks."""
 
@@ -54,6 +60,12 @@ class LockServiceAsyncStub:
     ]
     """Returns the specified subscription lock."""
 
+    GetByResourceID: grpc.aio.UnaryUnaryMultiCallable[
+        yandex.cloud.marketplace.licensemanager.saas.v1.lock_service_pb2.GetLockByResourceIDRequest,
+        yandex.cloud.marketplace.licensemanager.v1.lock_pb2.Lock,
+    ]
+    """Returns the subscription lock for given resource and subscription."""
+
 class LockServiceServicer(metaclass=abc.ABCMeta):
     """A set of methods for managing subscription locks."""
 
@@ -75,4 +87,12 @@ class LockServiceServicer(metaclass=abc.ABCMeta):
     ) -> typing.Union[yandex.cloud.marketplace.licensemanager.v1.lock_pb2.Lock, collections.abc.Awaitable[yandex.cloud.marketplace.licensemanager.v1.lock_pb2.Lock]]:
         """Returns the specified subscription lock."""
 
+    @abc.abstractmethod
+    def GetByResourceID(
+        self,
+        request: yandex.cloud.marketplace.licensemanager.saas.v1.lock_service_pb2.GetLockByResourceIDRequest,
+        context: _ServicerContext,
+    ) -> typing.Union[yandex.cloud.marketplace.licensemanager.v1.lock_pb2.Lock, collections.abc.Awaitable[yandex.cloud.marketplace.licensemanager.v1.lock_pb2.Lock]]:
+        """Returns the subscription lock for given resource and subscription."""
+
 def add_LockServiceServicer_to_server(servicer: LockServiceServicer, server: typing.Union[grpc.Server, grpc.aio.Server]) -> None: ...

yandex/cloud/marketplace/pim/v1/saas/product_instance_pb2.pyi

@@ -28,19 +28,29 @@ class _StateEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._EnumType
     DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
     STATE_UNSPECIFIED: _State.ValueType  # 0
     ACTIVATED: _State.ValueType  # 1
+    """Product instance is activated."""
     DEACTIVATED: _State.ValueType  # 2
+    """Product instance is deactivated."""
     PENDING_ACTIVATION: _State.ValueType  # 3
+    """Product instance is pending activation."""
     DEPRECATED: _State.ValueType  # 4
+    """Product instance is deprecated."""
     DELETED: _State.ValueType  # 5
+    """Product instance is deleted."""
 
 class State(_State, metaclass=_StateEnumTypeWrapper): ...
 
 STATE_UNSPECIFIED: State.ValueType  # 0
 ACTIVATED: State.ValueType  # 1
+"""Product instance is activated."""
 DEACTIVATED: State.ValueType  # 2
+"""Product instance is deactivated."""
 PENDING_ACTIVATION: State.ValueType  # 3
+"""Product instance is pending activation."""
 DEPRECATED: State.ValueType  # 4
+"""Product instance is deprecated."""
 DELETED: State.ValueType  # 5
+"""Product instance is deleted."""
 global___State = State
 
 class _ResourceType:
@@ -51,17 +61,25 @@ class _ResourceTypeEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._E
     DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
     RESOURCE_TYPE_UNSPECIFIED: _ResourceType.ValueType  # 0
     SAAS: _ResourceType.ValueType  # 1
+    """SaaS resource."""
     K8S: _ResourceType.ValueType  # 2
+    """Kubernetes resource."""
     COMPUTE: _ResourceType.ValueType  # 3
+    """Compute resource."""
     CLOUD_APPS: _ResourceType.ValueType  # 4
+    """Cloud Apps resource."""
 
 class ResourceType(_ResourceType, metaclass=_ResourceTypeEnumTypeWrapper): ...
 
 RESOURCE_TYPE_UNSPECIFIED: ResourceType.ValueType  # 0
 SAAS: ResourceType.ValueType  # 1
+"""SaaS resource."""
 K8S: ResourceType.ValueType  # 2
+"""Kubernetes resource."""
 COMPUTE: ResourceType.ValueType  # 3
+"""Compute resource."""
 CLOUD_APPS: ResourceType.ValueType  # 4
+"""Cloud Apps resource."""
 global___ResourceType = ResourceType
 
 @typing.final
@@ -93,15 +111,25 @@ class ProductInstance(google.protobuf.message.Message):
     UPDATED_AT_FIELD_NUMBER: builtins.int
     SAAS_INFO_FIELD_NUMBER: builtins.int
     id: builtins.str
+    """ID of the product instance."""
     resource_id: builtins.str
+    """ID of the resource."""
     resource_type: global___ResourceType.ValueType
+    """Type of the resource."""
     state: global___State.ValueType
+    """State of the product instance."""
     @property
-    def resource_metadata(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]: ...
+    def resource_metadata(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]:
+        """Metadata of the resource; Reserved for future use."""
+
     @property
-    def created_at(self) -> google.protobuf.timestamp_pb2.Timestamp: ...
+    def created_at(self) -> google.protobuf.timestamp_pb2.Timestamp:
+        """Creation timestamp"""
+
     @property
-    def updated_at(self) -> google.protobuf.timestamp_pb2.Timestamp: ...
+    def updated_at(self) -> google.protobuf.timestamp_pb2.Timestamp:
+        """Update timestamp"""
+
     @property
     def saas_info(self) -> global___SaasInfo: ...
     def __init__(
@@ -145,8 +173,11 @@ class SaasInfo(google.protobuf.message.Message):
     ID_FIELD_NUMBER: builtins.int
     DATA_FIELD_NUMBER: builtins.int
     id: builtins.str
+    """ID of the SaaS resource."""
     @property
-    def data(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]: ...
+    def data(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]:
+        """Additional data about the SaaS resource."""
+
     def __init__(
         self,
         *,

yandex/cloud/marketplace/pim/v1/saas/product_instance_service_pb2.pyi

@@ -17,6 +17,7 @@ class GetProductInstanceRequest(google.protobuf.message.Message):
 
     PRODUCT_INSTANCE_ID_FIELD_NUMBER: builtins.int
     product_instance_id: builtins.str
+    """ID of the product instance to return."""
     def __init__(
         self,
         *,
@@ -34,9 +35,13 @@ class ClaimProductInstanceRequest(google.protobuf.message.Message):
     RESOURCE_ID_FIELD_NUMBER: builtins.int
     RESOURCE_INFO_FIELD_NUMBER: builtins.int
     token: builtins.str
+    """Signed JWT token which contains information about product instance and subscription."""
     resource_id: builtins.str
+    """ID of the resource to which the product instance will be claimed."""
     @property
-    def resource_info(self) -> yandex.cloud.marketplace.pim.v1.saas.product_instance_pb2.SaasInfo: ...
+    def resource_info(self) -> yandex.cloud.marketplace.pim.v1.saas.product_instance_pb2.SaasInfo:
+        """Additional information about the resource."""
+
     def __init__(
         self,
         *,
@@ -57,8 +62,11 @@ class ClaimProductInstanceMetadata(google.protobuf.message.Message):
     PRODUCT_INSTANCE_ID_FIELD_NUMBER: builtins.int
     LICENSE_INSTANCE_ID_FIELD_NUMBER: builtins.int
     product_id: builtins.str
+    """ID of the product to which the product instance belongs."""
     product_instance_id: builtins.str
+    """ID of the product instance."""
     license_instance_id: builtins.str
+    """ID of the subscription."""
     def __init__(
         self,
         *,

yandex/cloud/marketplace/pim/v1/saas/product_instance_service_pb2_grpc.py

@@ -28,7 +28,8 @@ if _version_not_supported:
 
 
 class ProductInstanceServiceStub(object):
-    """Missing associated documentation comment in .proto file."""
+    """A set of methods for managing product instances.
+    """
 
     def __init__(self, channel):
         """Constructor.
@@ -49,16 +50,19 @@ class ProductInstanceServiceStub(object):
 
 
 class ProductInstanceServiceServicer(object):
-    """Missing associated documentation comment in .proto file."""
+    """A set of methods for managing product instances.
+    """
 
     def Get(self, request, context):
-        """Missing associated documentation comment in .proto file."""
+        """Returns the specified product instance.
+        """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
     def Claim(self, request, context):
-        """Missing associated documentation comment in .proto file."""
+        """Claims a product instance - activates it and optionally locks to subscription
+        """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
@@ -85,7 +89,8 @@ def add_ProductInstanceServiceServicer_to_server(servicer, server):
 
  # This class is part of an EXPERIMENTAL API.
 class ProductInstanceService(object):
-    """Missing associated documentation comment in .proto file."""
+    """A set of methods for managing product instances.
+    """
 
     @staticmethod
     def Get(request,

yandex/cloud/marketplace/pim/v1/saas/product_instance_service_pb2_grpc.pyi

@@ -20,41 +20,53 @@ class _ServicerContext(grpc.ServicerContext, grpc.aio.ServicerContext):  # type:
     ...
 
 class ProductInstanceServiceStub:
+    """A set of methods for managing product instances."""
+
     def __init__(self, channel: typing.Union[grpc.Channel, grpc.aio.Channel]) -> None: ...
     Get: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.marketplace.pim.v1.saas.product_instance_service_pb2.GetProductInstanceRequest,
         yandex.cloud.marketplace.pim.v1.saas.product_instance_pb2.ProductInstance,
     ]
+    """Returns the specified product instance."""
 
     Claim: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.marketplace.pim.v1.saas.product_instance_service_pb2.ClaimProductInstanceRequest,
         yandex.cloud.operation.operation_pb2.Operation,
     ]
+    """Claims a product instance - activates it and optionally locks to subscription"""
 
 class ProductInstanceServiceAsyncStub:
+    """A set of methods for managing product instances."""
+
     Get: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.marketplace.pim.v1.saas.product_instance_service_pb2.GetProductInstanceRequest,
         yandex.cloud.marketplace.pim.v1.saas.product_instance_pb2.ProductInstance,
     ]
+    """Returns the specified product instance."""
 
     Claim: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.marketplace.pim.v1.saas.product_instance_service_pb2.ClaimProductInstanceRequest,
         yandex.cloud.operation.operation_pb2.Operation,
     ]
+    """Claims a product instance - activates it and optionally locks to subscription"""
 
 class ProductInstanceServiceServicer(metaclass=abc.ABCMeta):
+    """A set of methods for managing product instances."""
+
     @abc.abstractmethod
     def Get(
         self,
         request: yandex.cloud.marketplace.pim.v1.saas.product_instance_service_pb2.GetProductInstanceRequest,
         context: _ServicerContext,
-    ) -> typing.Union[yandex.cloud.marketplace.pim.v1.saas.product_instance_pb2.ProductInstance, collections.abc.Awaitable[yandex.cloud.marketplace.pim.v1.saas.product_instance_pb2.ProductInstance]]: ...
+    ) -> typing.Union[yandex.cloud.marketplace.pim.v1.saas.product_instance_pb2.ProductInstance, collections.abc.Awaitable[yandex.cloud.marketplace.pim.v1.saas.product_instance_pb2.ProductInstance]]:
+        """Returns the specified product instance."""
 
     @abc.abstractmethod
     def Claim(
         self,
         request: yandex.cloud.marketplace.pim.v1.saas.product_instance_service_pb2.ClaimProductInstanceRequest,
         context: _ServicerContext,
-    ) -> typing.Union[yandex.cloud.operation.operation_pb2.Operation, collections.abc.Awaitable[yandex.cloud.operation.operation_pb2.Operation]]: ...
+    ) -> typing.Union[yandex.cloud.operation.operation_pb2.Operation, collections.abc.Awaitable[yandex.cloud.operation.operation_pb2.Operation]]:
+        """Claims a product instance - activates it and optionally locks to subscription"""
 
 def add_ProductInstanceServiceServicer_to_server(servicer: ProductInstanceServiceServicer, server: typing.Union[grpc.Server, grpc.aio.Server]) -> None: ...