sunholo 0.140.12__tar.gz → 0.141.1__tar.gz

{sunholo-0.140.12/src/sunholo.egg-info → sunholo-0.141.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sunholo
-Version: 0.140.12
+Version: 0.141.1
 Summary: AI DevOps - a package to help deploy GenAI to the Cloud.
 Author-email: Holosun ApS <multivac@sunholo.com>
 License: Apache License, Version 2.0
@@ -255,7 +255,7 @@ vac:
 sunholo vac chat my-agent
 ```
 
-4. **Deploy to Google Cloud Run:**
+4. **Run your agent as a local Flask app:**
 ```bash
 sunholo deploy my-agent
 ```
@@ -369,102 +369,132 @@ vac:
 
 ```bash
 # Project Management
-sunholo init <project-name>              # Create new project
+sunholo init <project-name>              # Create new project from template
 sunholo list-configs                     # List all configurations
-sunholo list-configs --validate          # Validate configs
+sunholo list-configs --validate          # Validate configurations
 
 # Development
 sunholo vac chat <vac-name>             # Chat with a VAC locally
-sunholo vac list                        # List available VACs
+sunholo vac list                        # List available VACs  
+sunholo vac get-url <vac-name>          # Get Cloud Run URL for a VAC
 sunholo proxy start <service>           # Start local proxy to cloud service
-
-# Deployment
-sunholo deploy <vac-name>               # Deploy to Cloud Run
-sunholo deploy <vac-name> --dev         # Deploy to dev environment
+sunholo proxy list                      # List running proxies
+sunholo deploy <vac-name>               # Run Flask app locally
 
 # Document Processing
-sunholo embed <vac-name>                # Embed documents
+sunholo embed <vac-name>                # Process and embed documents
 sunholo merge-text <folder> <output>    # Merge files for context
 
 # Cloud Services
-sunholo discovery-engine create <name>   # Create Discovery Engine
-sunholo proxy list                      # List running proxies
+sunholo discovery-engine create <name>   # Create Discovery Engine instance
+sunholo vertex list-extensions          # List Vertex AI extensions
+sunholo swagger <vac-name>              # Generate OpenAPI spec
+
+# Integration Tools
+sunholo excel-init                      # Initialize Excel plugin
+sunholo llamaindex <query>              # Query with LlamaIndex
+sunholo mcp list-tools                  # List MCP tools
+sunholo tts <text>                      # Text-to-speech synthesis
 ```
 
 ## 📝 Examples
 
-### Vertex AI Chat with Memory
+### Chat with History Extraction
 
 ```python
 from sunholo.utils import ConfigManager
 from sunholo.components import pick_llm
-from sunholo.agents import memory_client
+from sunholo.agents import extract_chat_history
 
 config = ConfigManager('my-agent')
 llm = pick_llm(config=config)
-memory = memory_client(config=config)
 
-# Chat with context
-response = llm.invoke("What is Google Cloud?")
-memory.add_message("user", "What is Google Cloud?")
-memory.add_message("assistant", response)
+# Extract chat history from messages
+chat_history = [
+    {"role": "user", "content": "Hello"},
+    {"role": "assistant", "content": "Hi there!"}
+]
+history_str = extract_chat_history(chat_history)
+
+# Use in prompt
+response = llm.invoke(f"Given this history:\n{history_str}\n\nUser: How are you?")
 ```
 
-### Document Processing with Discovery Engine
+### Document Processing with Chunker
 
 ```python
-from sunholo.discovery_engine import DiscoveryEngineClient
-from sunholo.chunker import chunk_doc
+from sunholo.chunker import direct_file_to_embed
+from sunholo.utils import ConfigManager
 
-# Initialize client
-client = DiscoveryEngineClient(
-    project_id='my-project',
-    data_store_id='my-datastore'
+config = ConfigManager('my-agent')
+
+# Process a file directly
+result = direct_file_to_embed(
+    "document.pdf",
+    embed_prefix="doc",
+    metadata={"source": "user_upload"},
+    vectorstore=config.vacConfig("vectorstore")
 )
+```
 
-# Process and index document
-chunks = chunk_doc.chunk_file("document.pdf", chunk_size=1000)
-client.import_documents(chunks)
+### Vertex AI with Memory Tools
 
-# Search
-results = client.search("What is the main topic?")
+```python
+from sunholo.vertex import get_vertex_memories
+from sunholo.utils import ConfigManager
+
+config = ConfigManager('my-agent')
+
+# Get Vertex AI memory configuration
+memory_config = get_vertex_memories(config)
+
+# Use with Vertex AI
+if memory_config:
+    print(f"Memory tools configured: {memory_config}")
 ```
 
-### Streaming Flask API
+### Streaming Response with Flask
 
 ```python
-from sunholo.agents import dispatch_to_qa
+from sunholo.agents import send_to_qa
+from flask import Response, request
 
 @app.route('/vac/streaming/<vac_name>', methods=['POST'])
 def streaming_endpoint(vac_name):
     question = request.json.get('user_input')
     
     def generate():
-        for chunk in dispatch_to_qa(
+        # Stream responses from the QA system
+        response = send_to_qa(
             question, 
             vac_name=vac_name,
             stream=True
-        ):
-            yield f"data: {chunk}\n\n"
+        )
+        if hasattr(response, '__iter__'):
+            for chunk in response:
+                yield f"data: {chunk}\n\n"
+        else:
+            yield f"data: {response}\n\n"
     
     return Response(generate(), content_type='text/event-stream')
 ```
 
-### Deploy from Template
+### Discovery Engine Integration
 
-```bash
-# Create from template
-sunholo init my-api --template agent
-
-# Customize configuration
-cd my-api
-vi config/vac_config.yaml
+```python
+from sunholo.discovery_engine import DiscoveryEngineClient
 
-# Test locally
-sunholo vac chat my-agent --local
+# Initialize client
+client = DiscoveryEngineClient(
+    project_id='my-project',
+    data_store_id='my-datastore'
+)
 
-# Deploy to production
-sunholo deploy my-agent
+# Search documents
+results = client.search("What is Vertex AI?")
+for result in results:
+    print(f"Content: {result.chunk.content}")
+    print(f"Score: {result.relevance_score}")
 ```
 
 ## 🧪 Testing

{sunholo-0.140.12 → sunholo-0.141.1}/README.md

@@ -69,7 +69,7 @@ vac:
 sunholo vac chat my-agent
 ```
 
-4. **Deploy to Google Cloud Run:**
+4. **Run your agent as a local Flask app:**
 ```bash
 sunholo deploy my-agent
 ```
@@ -183,102 +183,132 @@ vac:
 
 ```bash
 # Project Management
-sunholo init <project-name>              # Create new project
+sunholo init <project-name>              # Create new project from template
 sunholo list-configs                     # List all configurations
-sunholo list-configs --validate          # Validate configs
+sunholo list-configs --validate          # Validate configurations
 
 # Development
 sunholo vac chat <vac-name>             # Chat with a VAC locally
-sunholo vac list                        # List available VACs
+sunholo vac list                        # List available VACs  
+sunholo vac get-url <vac-name>          # Get Cloud Run URL for a VAC
 sunholo proxy start <service>           # Start local proxy to cloud service
-
-# Deployment
-sunholo deploy <vac-name>               # Deploy to Cloud Run
-sunholo deploy <vac-name> --dev         # Deploy to dev environment
+sunholo proxy list                      # List running proxies
+sunholo deploy <vac-name>               # Run Flask app locally
 
 # Document Processing
-sunholo embed <vac-name>                # Embed documents
+sunholo embed <vac-name>                # Process and embed documents
 sunholo merge-text <folder> <output>    # Merge files for context
 
 # Cloud Services
-sunholo discovery-engine create <name>   # Create Discovery Engine
-sunholo proxy list                      # List running proxies
+sunholo discovery-engine create <name>   # Create Discovery Engine instance
+sunholo vertex list-extensions          # List Vertex AI extensions
+sunholo swagger <vac-name>              # Generate OpenAPI spec
+
+# Integration Tools
+sunholo excel-init                      # Initialize Excel plugin
+sunholo llamaindex <query>              # Query with LlamaIndex
+sunholo mcp list-tools                  # List MCP tools
+sunholo tts <text>                      # Text-to-speech synthesis
 ```
 
 ## 📝 Examples
 
-### Vertex AI Chat with Memory
+### Chat with History Extraction
 
 ```python
 from sunholo.utils import ConfigManager
 from sunholo.components import pick_llm
-from sunholo.agents import memory_client
+from sunholo.agents import extract_chat_history
 
 config = ConfigManager('my-agent')
 llm = pick_llm(config=config)
-memory = memory_client(config=config)
 
-# Chat with context
-response = llm.invoke("What is Google Cloud?")
-memory.add_message("user", "What is Google Cloud?")
-memory.add_message("assistant", response)
+# Extract chat history from messages
+chat_history = [
+    {"role": "user", "content": "Hello"},
+    {"role": "assistant", "content": "Hi there!"}
+]
+history_str = extract_chat_history(chat_history)
+
+# Use in prompt
+response = llm.invoke(f"Given this history:\n{history_str}\n\nUser: How are you?")
 ```
 
-### Document Processing with Discovery Engine
+### Document Processing with Chunker
 
 ```python
-from sunholo.discovery_engine import DiscoveryEngineClient
-from sunholo.chunker import chunk_doc
+from sunholo.chunker import direct_file_to_embed
+from sunholo.utils import ConfigManager
 
-# Initialize client
-client = DiscoveryEngineClient(
-    project_id='my-project',
-    data_store_id='my-datastore'
+config = ConfigManager('my-agent')
+
+# Process a file directly
+result = direct_file_to_embed(
+    "document.pdf",
+    embed_prefix="doc",
+    metadata={"source": "user_upload"},
+    vectorstore=config.vacConfig("vectorstore")
 )
+```
 
-# Process and index document
-chunks = chunk_doc.chunk_file("document.pdf", chunk_size=1000)
-client.import_documents(chunks)
+### Vertex AI with Memory Tools
 
-# Search
-results = client.search("What is the main topic?")
+```python
+from sunholo.vertex import get_vertex_memories
+from sunholo.utils import ConfigManager
+
+config = ConfigManager('my-agent')
+
+# Get Vertex AI memory configuration
+memory_config = get_vertex_memories(config)
+
+# Use with Vertex AI
+if memory_config:
+    print(f"Memory tools configured: {memory_config}")
 ```
 
-### Streaming Flask API
+### Streaming Response with Flask
 
 ```python
-from sunholo.agents import dispatch_to_qa
+from sunholo.agents import send_to_qa
+from flask import Response, request
 
 @app.route('/vac/streaming/<vac_name>', methods=['POST'])
 def streaming_endpoint(vac_name):
     question = request.json.get('user_input')
     
     def generate():
-        for chunk in dispatch_to_qa(
+        # Stream responses from the QA system
+        response = send_to_qa(
             question, 
             vac_name=vac_name,
             stream=True
-        ):
-            yield f"data: {chunk}\n\n"
+        )
+        if hasattr(response, '__iter__'):
+            for chunk in response:
+                yield f"data: {chunk}\n\n"
+        else:
+            yield f"data: {response}\n\n"
     
     return Response(generate(), content_type='text/event-stream')
 ```
 
-### Deploy from Template
+### Discovery Engine Integration
 
-```bash
-# Create from template
-sunholo init my-api --template agent
-
-# Customize configuration
-cd my-api
-vi config/vac_config.yaml
+```python
+from sunholo.discovery_engine import DiscoveryEngineClient
 
-# Test locally
-sunholo vac chat my-agent --local
+# Initialize client
+client = DiscoveryEngineClient(
+    project_id='my-project',
+    data_store_id='my-datastore'
+)
 
-# Deploy to production
-sunholo deploy my-agent
+# Search documents
+results = client.search("What is Vertex AI?")
+for result in results:
+    print(f"Content: {result.chunk.content}")
+    print(f"Score: {result.relevance_score}")
 ```
 
 ## 🧪 Testing

{sunholo-0.140.12 → sunholo-0.141.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sunholo"
-version = "0.140.12"
+version = "0.141.1"
 description = "AI DevOps - a package to help deploy GenAI to the Cloud."
 readme = "README.md"
 requires-python = ">=3.10"

{sunholo-0.140.12 → sunholo-0.141.1}/src/sunholo/agents/chat_history.py

@@ -441,10 +441,10 @@ def create_message_element(message: dict):
     ```
     """
     if 'text' in message:  # This is a Slack or Google Chat message
-        log.info(f"Found text element - {message['text']}")
+        #log.info(f"Found text element - {message['text']}")
         return message['text']
     elif 'content' in message: # Discord or OpenAI history message
-        log.info(f"Found content element - {message['content']}")
+        #log.info(f"Found content element - {message['content']}")
         return message['content']
     else:  
         raise KeyError(f"Could not extract 'content' or 'text' element from message: {message}, {type(message)}")

{sunholo-0.140.12 → sunholo-0.141.1}/src/sunholo/discovery_engine/discovery_engine_client.py

@@ -280,7 +280,7 @@ class DiscoveryEngineClient:
         # Use async_search_with_filters with filter_str=None to perform a regular search
         return await self.async_search_with_filters(
             query=query,
-            filter_str=None,
+            filter_str=filter_str,
             num_previous_chunks=num_previous_chunks,
             num_next_chunks=num_next_chunks,
             page_size=page_size,

{sunholo-0.140.12 → sunholo-0.141.1}/src/sunholo/utils/mime.py

@@ -83,7 +83,6 @@ def get_mime_type_gemini(file_path:str) -> str:
     
     # Define the mapping of extensions to MIME types
     mime_types = {
-
         # Images
         'png': 'image/png',
         'jpg': 'image/jpeg',
@@ -111,7 +110,20 @@ def get_mime_type_gemini(file_path:str) -> str:
         'rtf': 'text/rtf',
         
         # Special case: JSON files are treated as plain text
-        'json': 'text/plain'
+        'json': 'text/plain',
+        
+        # Audio
+        'mp3': 'audio/mp3',
+        'mpeg': 'audio/mpeg',
+        'wav': 'audio/wav',
+        
+        # Video
+        'mov': 'video/mov',
+        'mp4': 'video/mp4',
+        'mpg': 'video/mpeg',
+        'avi': 'video/avi',
+        'wmv': 'video/wmv',
+        'flv': 'video/flv'
     }
     
     # Return the appropriate MIME type, defaulting to None if unknown

sunholo-0.141.1/src/sunholo/utils/proto_convert.py

@@ -0,0 +1,25 @@
+
+
+def convert_composite_to_native(value):
+    """
+    Recursively converts a proto MapComposite or RepeatedComposite object to native Python types.
+
+    Args:
+        value: The proto object, which could be a MapComposite, RepeatedComposite, or a primitive.
+
+    Returns:
+        The equivalent Python dictionary, list, or primitive type.
+    """
+    import proto
+    
+    if isinstance(value, proto.marshal.collections.maps.MapComposite):
+        # Convert MapComposite to a dictionary, recursively processing its values
+        return {key: convert_composite_to_native(val) for key, val in value.items()}
+    elif isinstance(value, proto.marshal.collections.repeated.RepeatedComposite):
+        # Convert RepeatedComposite to a list, recursively processing its elements
+        return [convert_composite_to_native(item) for item in value]
+    else:
+        # If it's a primitive value, return it as is
+        return value
+
+

{sunholo-0.140.12 → sunholo-0.141.1/src/sunholo.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sunholo
-Version: 0.140.12
+Version: 0.141.1
 Summary: AI DevOps - a package to help deploy GenAI to the Cloud.
 Author-email: Holosun ApS <multivac@sunholo.com>
 License: Apache License, Version 2.0
@@ -255,7 +255,7 @@ vac:
 sunholo vac chat my-agent
 ```
 
-4. **Deploy to Google Cloud Run:**
+4. **Run your agent as a local Flask app:**
 ```bash
 sunholo deploy my-agent
 ```
@@ -369,102 +369,132 @@ vac:
 
 ```bash
 # Project Management
-sunholo init <project-name>              # Create new project
+sunholo init <project-name>              # Create new project from template
 sunholo list-configs                     # List all configurations
-sunholo list-configs --validate          # Validate configs
+sunholo list-configs --validate          # Validate configurations
 
 # Development
 sunholo vac chat <vac-name>             # Chat with a VAC locally
-sunholo vac list                        # List available VACs
+sunholo vac list                        # List available VACs  
+sunholo vac get-url <vac-name>          # Get Cloud Run URL for a VAC
 sunholo proxy start <service>           # Start local proxy to cloud service
-
-# Deployment
-sunholo deploy <vac-name>               # Deploy to Cloud Run
-sunholo deploy <vac-name> --dev         # Deploy to dev environment
+sunholo proxy list                      # List running proxies
+sunholo deploy <vac-name>               # Run Flask app locally
 
 # Document Processing
-sunholo embed <vac-name>                # Embed documents
+sunholo embed <vac-name>                # Process and embed documents
 sunholo merge-text <folder> <output>    # Merge files for context
 
 # Cloud Services
-sunholo discovery-engine create <name>   # Create Discovery Engine
-sunholo proxy list                      # List running proxies
+sunholo discovery-engine create <name>   # Create Discovery Engine instance
+sunholo vertex list-extensions          # List Vertex AI extensions
+sunholo swagger <vac-name>              # Generate OpenAPI spec
+
+# Integration Tools
+sunholo excel-init                      # Initialize Excel plugin
+sunholo llamaindex <query>              # Query with LlamaIndex
+sunholo mcp list-tools                  # List MCP tools
+sunholo tts <text>                      # Text-to-speech synthesis
 ```
 
 ## 📝 Examples
 
-### Vertex AI Chat with Memory
+### Chat with History Extraction
 
 ```python
 from sunholo.utils import ConfigManager
 from sunholo.components import pick_llm
-from sunholo.agents import memory_client
+from sunholo.agents import extract_chat_history
 
 config = ConfigManager('my-agent')
 llm = pick_llm(config=config)
-memory = memory_client(config=config)
 
-# Chat with context
-response = llm.invoke("What is Google Cloud?")
-memory.add_message("user", "What is Google Cloud?")
-memory.add_message("assistant", response)
+# Extract chat history from messages
+chat_history = [
+    {"role": "user", "content": "Hello"},
+    {"role": "assistant", "content": "Hi there!"}
+]
+history_str = extract_chat_history(chat_history)
+
+# Use in prompt
+response = llm.invoke(f"Given this history:\n{history_str}\n\nUser: How are you?")
 ```
 
-### Document Processing with Discovery Engine
+### Document Processing with Chunker
 
 ```python
-from sunholo.discovery_engine import DiscoveryEngineClient
-from sunholo.chunker import chunk_doc
+from sunholo.chunker import direct_file_to_embed
+from sunholo.utils import ConfigManager
 
-# Initialize client
-client = DiscoveryEngineClient(
-    project_id='my-project',
-    data_store_id='my-datastore'
+config = ConfigManager('my-agent')
+
+# Process a file directly
+result = direct_file_to_embed(
+    "document.pdf",
+    embed_prefix="doc",
+    metadata={"source": "user_upload"},
+    vectorstore=config.vacConfig("vectorstore")
 )
+```
 
-# Process and index document
-chunks = chunk_doc.chunk_file("document.pdf", chunk_size=1000)
-client.import_documents(chunks)
+### Vertex AI with Memory Tools
 
-# Search
-results = client.search("What is the main topic?")
+```python
+from sunholo.vertex import get_vertex_memories
+from sunholo.utils import ConfigManager
+
+config = ConfigManager('my-agent')
+
+# Get Vertex AI memory configuration
+memory_config = get_vertex_memories(config)
+
+# Use with Vertex AI
+if memory_config:
+    print(f"Memory tools configured: {memory_config}")
 ```
 
-### Streaming Flask API
+### Streaming Response with Flask
 
 ```python
-from sunholo.agents import dispatch_to_qa
+from sunholo.agents import send_to_qa
+from flask import Response, request
 
 @app.route('/vac/streaming/<vac_name>', methods=['POST'])
 def streaming_endpoint(vac_name):
     question = request.json.get('user_input')
     
     def generate():
-        for chunk in dispatch_to_qa(
+        # Stream responses from the QA system
+        response = send_to_qa(
             question, 
             vac_name=vac_name,
             stream=True
-        ):
-            yield f"data: {chunk}\n\n"
+        )
+        if hasattr(response, '__iter__'):
+            for chunk in response:
+                yield f"data: {chunk}\n\n"
+        else:
+            yield f"data: {response}\n\n"
     
     return Response(generate(), content_type='text/event-stream')
 ```
 
-### Deploy from Template
+### Discovery Engine Integration
 
-```bash
-# Create from template
-sunholo init my-api --template agent
-
-# Customize configuration
-cd my-api
-vi config/vac_config.yaml
+```python
+from sunholo.discovery_engine import DiscoveryEngineClient
 
-# Test locally
-sunholo vac chat my-agent --local
+# Initialize client
+client = DiscoveryEngineClient(
+    project_id='my-project',
+    data_store_id='my-datastore'
+)
 
-# Deploy to production
-sunholo deploy my-agent
+# Search documents
+results = client.search("What is Vertex AI?")
+for result in results:
+    print(f"Content: {result.chunk.content}")
+    print(f"Score: {result.relevance_score}")
 ```
 
 ## 🧪 Testing