Merge branch 'main' into users/joratz/removeenvid

Author: Jesus Terrazas

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,146 @@
+name: Bug Report
+description: Report an issue with the Agent365 Python SDK.
+title: "[BUG] - [short description]"
+labels: ["bug"]
+assignees: []
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ## Bug Report
+
+        Thank you for reporting a bug in the Agent365 Python SDK! Please fill out the following information to help us diagnose and fix the issue.
+
+  - type: input
+    attributes:
+      label: "Bug Description"
+      description: "Provide a clear and concise description of the bug."
+      placeholder: "e.g., Agent runtime throws TypeError when processing tool responses, or observability module fails to emit telemetry events."
+      required: true
+
+  - type: textarea
+    attributes:
+      label: "Steps to Reproduce"
+      description: "List the steps to reproduce the behavior. Include code snippets if possible."
+      placeholder: |
+        e.g., 
+        1. Import microsoft_agents_a365.runtime
+        2. Create an agent with custom tools
+        3. Call agent.process_activity() with a specific message
+        4. Observe error in console
+      value: |
+        1. 
+        2. 
+        3. 
+      required: true
+
+  - type: textarea
+    attributes:
+      label: "Expected Behavior"
+      description: "What did you expect to happen?"
+      placeholder: "e.g., The agent should process the tool response and return a successful activity without errors."
+      required: true
+
+  - type: textarea
+    attributes:
+      label: "Actual Behavior"
+      description: "What actually happened? Include error messages, stack traces, or unexpected output."
+      placeholder: |
+        e.g., 
+        TypeError: 'NoneType' object is not subscriptable
+        File "microsoft_agents_a365/runtime/agent.py", line 123, in process_activity
+      required: true
+
+  - type: dropdown
+    attributes:
+      label: "Affected SDK Component"
+      description: "Which Agent365 SDK package is affected?"
+      options:
+        - microsoft-agents-a365-runtime
+        - microsoft-agents-a365-tooling
+        - microsoft-agents-a365-observability-core
+        - microsoft-agents-a365-observability-extensions-langchain
+        - microsoft-agents-a365-observability-extensions-openai
+        - microsoft-agents-a365-observability-extensions-semantickernel
+        - microsoft-agents-a365-tooling-extensions-agentframework
+        - microsoft-agents-a365-tooling-extensions-azureaifoundry
+        - microsoft-agents-a365-tooling-extensions-openai
+        - microsoft-agents-a365-tooling-extensions-semantickernel
+        - microsoft-agents-a365-notifications
+        - Not sure / Multiple components
+      required: true
+
+  - type: input
+    attributes:
+      label: "SDK Version"
+      description: "What version of the Agent365 SDK are you using? (Run: pip show microsoft-agents-a365-runtime)"
+      placeholder: "e.g., 0.1.0 or 0.1.0.dev5"
+      required: true
+
+  - type: input
+    attributes:
+      label: "Python Version"
+      description: "What version of Python are you using? (Run: python --version)"
+      placeholder: "e.g., Python 3.11.5 or Python 3.12.0"
+      required: true
+
+  - type: dropdown
+    attributes:
+      label: "Operating System"
+      description: "What operating system are you running on?"
+      options:
+        - Windows
+        - macOS
+        - Linux (Ubuntu)
+        - Linux (other distribution)
+        - Azure (Container Apps / App Service)
+        - Other
+      required: true
+
+  - type: textarea
+    attributes:
+      label: "Environment Details"
+      description: "Additional environment information (virtual environment, container, cloud service, etc.)"
+      placeholder: |
+        e.g., 
+        - Running in Docker container
+        - Deployed on Azure Container Apps
+        - Using venv virtual environment
+        - Running in GitHub Codespaces
+      required: false
+
+  - type: textarea
+    attributes:
+      label: "Code Sample (Optional)"
+      description: "Provide a minimal code sample that reproduces the issue."
+      placeholder: |
+        ```python
+        from microsoft_agents_a365.runtime import Agent
+
+        # Your code here that reproduces the bug
+        agent = Agent(...)
+        ```
+      required: false
+
+  - type: textarea
+    attributes:
+      label: "Additional Context"
+      description: "Add any other context, logs, stack traces, or screenshots that might help."
+      placeholder: |
+        e.g., 
+        - Full stack trace
+        - Relevant log output
+        - Related issues or discussions
+        - Workarounds attempted
+      required: false
+
+  - type: checkboxes
+    attributes:
+      label: "Impact"
+      description: "How does this bug affect your work?"
+      options:
+        - label: Blocks development completely
+        - label: Blocks specific feature implementation
+        - label: Has a workaround but impacts productivity
+        - label: Minor issue with minimal impact

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,15 @@
+# .github/ISSUE_TEMPLATE/config.yml
+blank_issues_enabled: false
+contact_links:
+  - name: 📚 Documentation
+    url: https://github.com/microsoft/Agent365-python/blob/main/README.md
+    about: Check the documentation for guides, API references, and examples
+  - name: 💬 Discussions
+    url: https://github.com/microsoft/Agent365-python/discussions
+    about: Ask questions, share ideas, and engage with the community
+  - name: ⚡ Quick Start Guide
+    url: https://github.com/microsoft/Agent365-python/blob/main/README.md#getting-started
+    about: Get started with the Agent365 Python SDK
+  - name: 🔒 Security Vulnerability
+    url: https://github.com/microsoft/Agent365-python/security/advisories/new
+    about: Report security vulnerabilities privately (do not create public issues)

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,82 @@
+name: Feature Request
+description: Suggest a new feature or improvement for the Agent365 Python SDK.
+title: "[FEATURE] - [short description]"
+labels: ["enhancement"]
+assignees: []
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ## Feature Request
+
+        Thank you for suggesting a feature for the Agent365 Python SDK! Please fill out the following template to help us evaluate your request.
+
+  - type: input
+    attributes:
+      label: "Feature Description"
+      description: "Describe the feature or enhancement you would like to see in the Agent SDK."
+      placeholder: "e.g., Add support for streaming responses in the observability module, or support for custom authentication providers."
+      required: true
+
+  - type: textarea
+    attributes:
+      label: "Use Case"
+      description: "What problem does this feature solve or how would it improve agent development?"
+      placeholder: "e.g., Streaming responses would allow real-time monitoring of agent interactions in production, improving debugging capabilities for long-running agents."
+      required: true
+
+  - type: dropdown
+    attributes:
+      label: "Affected SDK Component"
+      description: "Which part of the Agent365 SDK would this feature affect?"
+      options:
+        - microsoft-agents-a365-runtime
+        - microsoft-agents-a365-tooling
+        - microsoft-agents-a365-observability-core
+        - microsoft-agents-a365-observability-extensions
+        - microsoft-agents-a365-tooling-extensions
+        - microsoft-agents-a365-notifications
+        - Documentation
+        - Multiple components
+        - Other (specify in additional context)
+      required: true
+
+  - type: input
+    attributes:
+      label: "Potential Impact"
+      description: "How would this feature impact agent development or the developer experience?"
+      placeholder: "e.g., Would reduce development time by 30% for implementing observability in production agents."
+      required: true
+
+  - type: dropdown
+    attributes:
+      label: "Priority"
+      description: "How important is this feature to your agent development workflow?"
+      options:
+        - Low - Nice to have
+        - Medium - Would improve workflow
+        - High - Blocking current development
+        - Critical - Prevents SDK adoption
+      required: true
+
+  - type: textarea
+    attributes:
+      label: "Proposed Solution (Optional)"
+      description: "If you have ideas on how this feature could be implemented, please share them."
+      placeholder: "e.g., Could add a StreamingObserver class that implements the Observer pattern for real-time event callbacks."
+      required: false
+
+  - type: textarea
+    attributes:
+      label: "Alternative Solutions Considered"
+      description: "Have you considered any workarounds or alternative approaches?"
+      placeholder: "e.g., Currently using custom logging, but it doesn't integrate with the SDK's observability framework."
+      required: false
+
+  - type: textarea
+    attributes:
+      label: "Additional Context"
+      description: "Add any other information that might be helpful (code examples, related issues, external resources)."
+      placeholder: "e.g., Related to #123, similar to feature in Microsoft.Agents .NET SDK, or example code showing the desired API."
+      required: false

libraries/microsoft-agents-a365-notifications/microsoft_agents_a365/notifications/agent_notification.py

@@ -61,10 +61,8 @@ def on_agent_notification(
 
         def route_selector(context: TurnContext) -> bool:
             ch = context.activity.channel_id
-            received_channel = ch.channel if ch else ""
-            received_subchannel = ch.sub_channel if ch else ""
-            received_channel = received_channel.lower()
-            received_subchannel = received_subchannel.lower()
+            received_channel = (ch.channel if ch else "").lower()
+            received_subchannel = (ch.sub_channel if ch and ch.sub_channel else "").lower()
             if received_channel != registered_channel:
                 return False
             if registered_subchannel == "*":

libraries/microsoft-agents-a365-notifications/setup.py

@@ -1,13 +1,28 @@
 # Copyright (c) Microsoft Corporation.
 # Licensed under the MIT License.
 
+import sys
+from pathlib import Path
 from os import environ
 from setuptools import setup
 
 # Get version from environment variable set by CI/CD
-# This will be set by setuptools-git-versioning in the CI pipeline
 package_version = environ.get("AGENT365_PYTHON_SDK_PACKAGE_VERSION", "0.0.0")
 
+# Add versioning helper to path
+helper_path = Path(__file__).parent.parent.parent / "versioning" / "helper"
+sys.path.insert(0, str(helper_path))
+
+from setup_utils import get_dynamic_dependencies
+
+# Use minimum version strategy:
+# - Internal packages get: >= current_base_version (e.g., >= 0.1.0)
+# - Automatically updates when you build new versions
+# - Consumers can upgrade to any higher version
 setup(
     version=package_version,
+    install_requires=get_dynamic_dependencies(
+        use_compatible_release=False,  # No upper bound
+        use_exact_match=False,  # Not exact match
+    ),
 )

libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/config.py

@@ -14,6 +14,8 @@
 from .exporters.utils import is_agent365_exporter_enabled
 from .trace_processor.span_processor import SpanProcessor
 
+DEFAULT_LOGGER_NAME = __name__
+
 
 class TelemetryManager:
     """
@@ -46,7 +48,7 @@ def configure(
         self,
         service_name: str,
         service_namespace: str,
-        logger_name: str = "agent365",
+        logger_name: str = DEFAULT_LOGGER_NAME,
         token_resolver: Callable[[str, str], str | None] | None = None,
         cluster_category: str = "prod",
         **kwargs: Any,
@@ -158,11 +160,11 @@ def get_tracer(self, name: str | None = None, version: str | None = None):
         to call `configure(...)` during application startup so the tracer
         returned is backed by the configured TracerProvider.
 
-        :param name: Optional tracer name. Defaults to 'agent365' when not provided.
+        :param name: Optional tracer name. Defaults to 'microsoft_agents_a365.observability.core' when not provided.
         :param version: Optional tracer version.
         :return: An OpenTelemetry Tracer instance.
         """
-        tracer_name = name or "agent365"
+        tracer_name = name or DEFAULT_LOGGER_NAME
         if self._tracer_provider is None:
             # Not configured — return whatever tracer OpenTelemetry provides (no-op)
             self._logger.warning(
@@ -192,7 +194,7 @@ def get_tracer_provider(self):
 def configure(
     service_name: str,
     service_namespace: str,
-    logger_name: str = "agent365",
+    logger_name: str = DEFAULT_LOGGER_NAME,
     token_resolver: Callable[[str, str], str | None] | None = None,
     cluster_category: str = "prod",
     **kwargs: Any,
@@ -228,7 +230,7 @@ def get_tracer(name: str | None = None, version: str | None = None):
     """
     Return a tracer tied to the TracerProvider configured by the SDK.
 
-    :param name: Optional tracer name. If omitted, defaults to 'agent365'.
+    :param name: Optional tracer name. If omitted, defaults to 'microsoft_agents_a365.observability.core'.
     :param version: Optional tracer version.
     :return: An OpenTelemetry Tracer (may be a no-op tracer if SDK isn't configured).
     """