sunholo 0.70.1__py3-none-any.whl → 0.70.2__py3-none-any.whl

sunholo/components/vectorstore.py

@@ -138,4 +138,4 @@ def pick_vectorstore(vs_str: str, vector_name: str, embeddings, read_only=None):
         return vectorstore
 
     else:
-        raise NotImplementedError(f'No llm implemented for {vs_str}')   
+        log.warning(f'No llm implemented for {vs_str}')   

sunholo/utils/parsers.py

@@ -14,6 +14,38 @@
 import re
 import hashlib
 
+def validate_extension_id(ext_id):
+    """
+    Ensures the passed string fits the criteria for an extension ID.
+    If not, changes it so it will be.
+
+    Criteria:
+    - Length should be 4-63 characters.
+    - Valid characters are lowercase letters, numbers, and hyphens ("-").
+    - Should start with a number or a lowercase letter.
+
+    Args:
+        ext_id (str): The extension ID to validate and correct.
+
+    Returns:
+        str: The validated and corrected extension ID.
+    """
+    # Replace invalid characters
+    ext_id = re.sub(r'[^a-z0-9-]', '-', ext_id.lower())
+    
+    # Ensure it starts with a number or a lowercase letter
+    if not re.match(r'^[a-z0-9]', ext_id):
+        ext_id = 'a' + ext_id
+    
+    # Trim to 63 characters
+    ext_id = ext_id[:63]
+    
+    # Pad to at least 4 characters
+    while len(ext_id) < 4:
+        ext_id += 'a'
+    
+    return ext_id
+
 def contains_url(message_data):
     """
     Check if the provided text contains a URL.

sunholo/vertex/extensions.py

@@ -0,0 +1,138 @@
+# https://cloud.google.com/vertex-ai/generative-ai/docs/extensions/create-extension
+# https://cloud.google.com/vertex-ai/generative-ai/docs/model-reference/extension#python
+from vertexai.preview import extensions
+from .init import init_vertex
+from ..logging import log
+from ..utils.gcp_project import get_gcp_project
+from ..utils.parsers import validate_extension_id
+
+def get_extension_import_config(
+        display_name: str, 
+        description: str,
+        api_spec_gcs: dict,
+        service_account_name: dict,
+        tool_use_examples: list):
+
+    tool_use_examples = [
+        {
+            "extensionOperation": {
+                "operationId": "say_hello",
+            },
+            "displayName": "Say hello in the requested language",
+            "query": "Say hello in French",
+            "requestParams": {
+                "fields": [
+                {
+                    "key": "apiServicePrompt",
+                    "value": {
+                    "string_value": "French",
+                    }
+                }
+                ]
+            },
+            "responseParams": {
+                "fields": [
+                {
+                    "key": "apiServiceOutput",
+                    "value": {
+                    "string_value": "bonjour",
+                    },
+                }
+                ],
+            },
+            "responseSummary": "Bonjour"
+            }
+    ]
+
+    
+    return {
+        "displayName":  display_name,
+        "description": description,
+        "manifest": {
+            "name": "EXTENSION_NAME_LLM",
+            "description": "DESCRIPTION_LLM",
+            "apiSpec": {
+                "openApiGcsUri": api_spec_gcs,
+            },
+            "authConfig": {
+                "authType": "OAUTH",
+                "oauthConfig": {"service_account": service_account_name}
+            }
+        },
+        "toolUseExamples": tool_use_examples, 
+        }
+
+# once an extension is available, call it in code here
+def create_extension_instance(
+        display_name: str,
+        description: str,
+        open_api_gcs_uri: str,
+        llm_name: str=None,
+        llm_description: str=None,
+        runtime_config: dict=None,
+        service_account: str=None,
+):
+    """
+    Args:
+    - display_name: for the human. parsed to be used as extension_name
+    - description: for the human
+    - open_api_gcs_uri: location on GCS where open_ai yaml spec is
+    - llm_name: for the model.  If None, uses display_name
+    - llm_description: for the model.  If None, uses description
+    - service_account: If not specified, the Vertex AI Extension Service Agent is used to execute the extension.
+    
+    """
+    project_id = get_gcp_project()
+    extension_name = f"projects/{project_id}/locations/us-central1/extensions/{validate_extension_id(display_name)}"
+
+    extension = extensions.Extension.create(
+        extension_name=extension_name,
+        display_name=display_name,
+        description=description,
+        runtime_config=runtime_config or None,
+        manifest={
+            "name": llm_name or display_name,
+            "description": llm_description or description,
+            "api_spec": {
+                "open_api_gcs_uri": open_api_gcs_uri
+            },
+            "auth_config": {
+                "auth_type": "GOOGLE_SERVICE_ACCOUNT_AUTH",
+                "google_service_account_config": service_account or {},
+            },
+        },
+    )
+    log.info(f"Creating Vertex Extension: {extension=}")
+
+    return extension
+
+
+
+def create_extension_code_interpreter(
+        code_artifacts_bucket=None
+):
+
+    # only us-central for now
+    location = "us-central1"
+    init_vertex(location=location)
+
+    runtime_config=None
+    if code_artifacts_bucket:
+        runtime_config = {"codeInterpreterRuntimeConfig": 
+                            {
+                                "fileInputGcsBucket": code_artifacts_bucket,
+                                "fileOutputGcsBucket": code_artifacts_bucket
+                            }
+                        }
+
+    code_extension = create_extension_instance(
+        display_name="Code Interpreter",
+        description="This extension generates and executes code in the specified language",
+        open_api_gcs_uri="gs://vertex-extension-public/code_interpreter.yaml",
+        llm_name="code_interpreter_tool",
+        llm_description="Google Code Interpreter Extension",
+        runtime_config=runtime_config
+        )
+    log.info(f"Created code extension: {code_extension=}")
+
+    return code_extension

{sunholo-0.70.1.dist-info → sunholo-0.70.2.dist-info}/METADATA

@@ -1,9 +1,9 @@
 Metadata-Version: 2.1
 Name: sunholo
-Version: 0.70.1
+Version: 0.70.2
 Summary: Large Language Model DevOps - a package to help deploy LLMs to the Cloud.
 Home-page: https://github.com/sunholo-data/sunholo-py
-Download-URL: https://github.com/sunholo-data/sunholo-py/archive/refs/tags/v0.70.1.tar.gz
+Download-URL: https://github.com/sunholo-data/sunholo-py/archive/refs/tags/v0.70.2.tar.gz
 Author: Holosun ApS
 Author-email: multivac@sunholo.com
 License: Apache License, Version 2.0

{sunholo-0.70.1.dist-info → sunholo-0.70.2.dist-info}/RECORD

@@ -46,7 +46,7 @@ sunholo/cli/swagger.py,sha256=absYKAU-7Yd2eiVNUY-g_WLl2zJfeRUNdWQ0oH8M_HM,1564
 sunholo/components/__init__.py,sha256=IDoylb74zFKo6NIS3RQqUl0PDFBGVxM1dfUmO7OJ44U,176
 sunholo/components/llm.py,sha256=T4we3tGmqUj4tPwxQr9M6AXv_BALqZV_dRSvINan-oU,10374
 sunholo/components/retriever.py,sha256=jltG91N5r2P9RWKPW8A8tU3ilghciBczxapauW83Ir8,6377
-sunholo/components/vectorstore.py,sha256=BxtMF_wX8Zrexr67P07OTSJPjucTewmcPM5OQwIXHPM,5630
+sunholo/components/vectorstore.py,sha256=egFPeejf8kwM3Wx486X-FBzwoSSEziC2NV4LdxB2sXY,5616
 sunholo/database/__init__.py,sha256=Zz0Shcq-CtStf9rJGIYB_Ybzb8rY_Q9mfSj-nviM490,241
 sunholo/database/alloydb.py,sha256=d9W0pbZB0jTVIGF5OVaQ6kXHo-X3-6e9NpWNmV5e9UY,10464
 sunholo/database/alloydb_client.py,sha256=AYA0SSaBy-1XEfeZI97sMGehfrwnfbwZ8sE0exzI2E0,7254
@@ -103,17 +103,18 @@ sunholo/utils/config.py,sha256=5lzO9CkLpDslp66ZwSBC_95aA1FQs-zpiOLi5YaYWbM,8907
 sunholo/utils/config_schema.py,sha256=Wv-ncitzljOhgbDaq9qnFqH5LCuxNv59dTGDWgd1qdk,4189
 sunholo/utils/gcp.py,sha256=uueODEpA-P6O15-t0hmcGC9dONLO_hLfzSsSoQnkUss,4854
 sunholo/utils/gcp_project.py,sha256=0ozs6tzI4qEvEeXb8MxLnCdEVoWKxlM6OH05htj7_tc,1325
-sunholo/utils/parsers.py,sha256=NEfH6ZIYfMa-nuVaYmq9KhS0MNAYoKDbxvibT5MvGqM,4403
+sunholo/utils/parsers.py,sha256=z98cQ1v2_ScnqHxCtApNeAN2the8MdvS6RpKL6vWyOU,5287
 sunholo/utils/timedelta.py,sha256=BbLabEx7_rbErj_YbNM0MBcaFN76DC4PTe4zD2ucezg,493
 sunholo/utils/user_ids.py,sha256=SQd5_H7FE7vcTZp9AQuQDWBXd4FEEd7TeVMQe1H4Ny8,292
 sunholo/utils/version.py,sha256=jjU_4anXBikJxPg0Wur0X-B7-ec1tC7jToykAnAG9Dg,108
 sunholo/vertex/__init__.py,sha256=JvHcGFuv6R_nAhY2AdoqqhMpJ5ugeWPZ_svGhWrObBk,136
+sunholo/vertex/extensions.py,sha256=LDeuCp8RcHHACdlYhGyGjMoG5v70132HWA_2u-tzcAo,4533
 sunholo/vertex/init.py,sha256=RLjQppTUwubWgwf2PoAke-EtcwlVkFPaPMYvUsMw1KQ,2029
 sunholo/vertex/memory_tools.py,sha256=l2jNRFLjYpiNJULDZQq5b8fEEaqBQFPM4ehM9NhDHss,5718
 sunholo/vertex/safety.py,sha256=3meAX0HyGZYrH7rXPUAHxtI_3w_zoy_RX7Shtkoa660,1275
-sunholo-0.70.1.dist-info/LICENSE.txt,sha256=SdE3QjnD3GEmqqg9EX3TM9f7WmtOzqS1KJve8rhbYmU,11345
-sunholo-0.70.1.dist-info/METADATA,sha256=jQEMxget9tVvjMFDj7eaY1H-ctXIOLxoqxEFXU0Fcl0,6240
-sunholo-0.70.1.dist-info/WHEEL,sha256=mguMlWGMX-VHnMpKOjjQidIo1ssRlCFu4a4mBpz1s2M,91
-sunholo-0.70.1.dist-info/entry_points.txt,sha256=bZuN5AIHingMPt4Ro1b_T-FnQvZ3teBes-3OyO0asl4,49
-sunholo-0.70.1.dist-info/top_level.txt,sha256=wt5tadn5--5JrZsjJz2LceoUvcrIvxjHJe-RxuudxAk,8
-sunholo-0.70.1.dist-info/RECORD,,
+sunholo-0.70.2.dist-info/LICENSE.txt,sha256=SdE3QjnD3GEmqqg9EX3TM9f7WmtOzqS1KJve8rhbYmU,11345
+sunholo-0.70.2.dist-info/METADATA,sha256=657GueOuXqqE3LzXDsN6xgnIbPV16zJX7B03nF5upX4,6240
+sunholo-0.70.2.dist-info/WHEEL,sha256=mguMlWGMX-VHnMpKOjjQidIo1ssRlCFu4a4mBpz1s2M,91
+sunholo-0.70.2.dist-info/entry_points.txt,sha256=bZuN5AIHingMPt4Ro1b_T-FnQvZ3teBes-3OyO0asl4,49
+sunholo-0.70.2.dist-info/top_level.txt,sha256=wt5tadn5--5JrZsjJz2LceoUvcrIvxjHJe-RxuudxAk,8
+sunholo-0.70.2.dist-info/RECORD,,