feat(python): add Devin AI sample agent with A365 SDK integration

python/devin/sample-agent/.env.template

@@ -0,0 +1,98 @@
+# =============================================================================
+# Devin Sample Agent — Environment Configuration
+# =============================================================================
+# Copy this file to .env and fill in the values.
+# Lines marked <<PLACEHOLDER>> MUST be replaced before running the agent.
+#
+#   cp .env.template .env
+#
+
+# =============================================================================
+# DEVIN API CONFIGURATION
+# =============================================================================
+# Get your Devin API key and Org ID from https://app.devin.ai/settings
+
+# Devin SDK API key (also read automatically via DEVIN_SDK_API_KEY)
+DEVIN_SDK_API_KEY=<<YOUR_DEVIN_API_KEY>>
+
+# Devin organization ID (required for session management)
+DEVIN_ORG_ID=<<YOUR_DEVIN_ORG_ID>>
+
+# (Optional) Override the default Devin API base URL
+# DEVIN_BASE_URL=https://api.devin.ai/v1
+
+# Polling interval in seconds (how often to check for Devin responses)
+POLLING_INTERVAL_SECONDS=10
+
+# =============================================================================
+# AGENT 365 SERVICE CONNECTION
+# =============================================================================
+# Configured through the Agent 365 blueprint system (a365 init).
+connections__service_connection__settings__clientId=<<BLUEPRINT_CLIENT_ID>>
+connections__service_connection__settings__clientSecret=<<BLUEPRINT_CLIENT_SECRET>>
+connections__service_connection__settings__tenantId=<<TENANT_ID>>
+
+# Connection mapping (routes all service URLs through the service connection)
+connectionsMap__0__connection=service_connection
+connectionsMap__0__serviceUrl=*
+
+# =============================================================================
+# AGENT IDENTITY
+# =============================================================================
+# These are populated automatically after `a365 init` and `a365 publish`.
+# Override only when running outside the a365 CLI lifecycle.
+AGENTIC_APP_ID=<<AGENTIC_APP_ID>>
+AGENTIC_TENANT_ID=<<TENANT_ID>>
+AGENTIC_USER_ID=<<AGENTIC_USER_ID>>
+
+# =============================================================================
+# AUTHENTICATION
+# =============================================================================
+# Auth handler name — leave empty for Agents Playground / local-dev (anonymous).
+# Set to "AGENTIC" for production agentic auth (e.g. when running in Teams).
+# NOTE: The value is case-sensitive and must match the key in
+# AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC.
+AUTH_HANDLER_NAME=
+
+# Agentic auth configuration (used by the A365 SDK to request OBO tokens)
+agentic_type=agentic
+agentic_scopes=https://graph.microsoft.com/.default
+agentic_altBlueprintConnectionName=service_connection
+
+# (Optional) Bearer token for local development without agentic auth.
+# Acquire manually via `a365 query-entra instance-scopes` or Postman.
+# BEARER_TOKEN=
+
+# =============================================================================
+# OBSERVABILITY
+# =============================================================================
+# Master switch — set to "false" to disable all OpenTelemetry instrumentation.
+ENABLE_OBSERVABILITY=true
+
+# Agent 365 observability exporter (sends spans to the A365 backend).
+ENABLE_A365_OBSERVABILITY_EXPORTER=false
+
+# Log level for the observability subsystem.
+A365_OBSERVABILITY_LOG_LEVEL=info
+
+# FIC (Federated Identity Credential) env vars for A365 observability exporter.
+# These enable the distro to authenticate with the A365 backend.
+A365_AGENT_APP_INSTANCE_ID=<<AGENTIC_APP_ID>>
+A365_AGENTIC_USER_ID=<<AGENTIC_USER_ID>>
+
+# Observability agent metadata (populated by a365 setup)
+# AGENT365OBSERVABILITY__AGENTID=<<AGENTIC_APP_ID>>
+# AGENT365OBSERVABILITY__AGENTNAME=<<AGENT_NAME>>
+# AGENT365OBSERVABILITY__AGENTDESCRIPTION=<<DESCRIPTION>>
+# AGENT365OBSERVABILITY__TENANTID=<<TENANT_ID>>
+# AGENT365OBSERVABILITY__AGENTBLUEPRINTID=<<BLUEPRINT_ID>>
+# AGENT365OBSERVABILITY__CLIENTID=<<BLUEPRINT_ID>>
+# AGENT365OBSERVABILITY__CLIENTSECRET=<<BLUEPRINT_SECRET>>
+
+# (Optional) Azure Monitor / Application Insights connection string.
+# APPLICATIONINSIGHTS_CONNECTION_STRING=<<APP_INSIGHTS_CONNECTION_STRING>>
+
+# =============================================================================
+# SERVER
+# =============================================================================
+PORT=3978

python/devin/sample-agent/.gitignore

@@ -0,0 +1,44 @@
+# TeamsFx files
+env/.env.*.user
+env/.env.local
+env/.env.sandbox
+.localConfigs
+.localConfigs.playground
+.localConfigs
+.notification.localstore.json
+.notification.playgroundstore.json
+appPackage/build
+
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.venv/
+venv/
+
+# misc
+.env
+.deployment
+.DS_Store
+Thumbs.db
+
+# IDE
+.idea/
+*.swp
+*.swo
+*~
+
+# Dev tool directories
+/devTools/
+
+# Agent 365 generated / local state
+a365.generated.config.json
+chat.json
+deploy.zip
+log.txt
+*.log
+cred.json
+manifest/manifest.zip