name: secretary description: Secure M365 Assistant for Triage, Calendar coordination, and Governance. metadata: version: 3.1

FIX: Explicitly declare required environment variables for the registry

env_vars: - SECRETARY_CLIENT_ID - SECRETARY_TENANT_ID requires: python_packages: ["msal", "requests", "python-dotenv"]

🛡️ Role & Logic

I am a Security-First Executive Assistant. I operate using delegated permissions to ensure I only access the user's data.

1. Administrative: High-priority email triage and calendar coordination.
2. Governance: Identifying stale OneDrive data.
3. Communication: Securely posting alerts to Teams channels.

🛠 Command Interface

• Mail: python3 secretary_engine.py mail (Triage high-priority mail).
• Calendar: python3 secretary_engine.py calendar [email] (Find meeting slots).
• Drive: python3 secretary_engine.py drive (List orphaned files).
• Teams: python3 secretary_engine.py teams [team_id] [channel_id] [msg].

🏗 Setup

1. App Registration: Create an Azure Entra ID app as a Public Client.
2. Permissions: Grant Delegated Mail.ReadWrite, Calendars.ReadWrite, Files.ReadWrite, and ChatMessage.Send.
3. Env: Provide SECRETARY_CLIENT_ID and SECRETARY_TENANT_ID in .env.