@codemieai/code 0.0.45 → 0.0.47

package/dist/agents/plugins/claude/plugin/skills/msgraph/README.md

@@ -0,0 +1,183 @@
+# Microsoft Graph API Skill for Claude Code
+
+Work with your Microsoft 365 account from Claude Code — emails, calendar, SharePoint, Teams, OneDrive, contacts, and org chart — all via the Microsoft Graph API.
+
+---
+
+## Quick Start
+
+### 1. Install dependencies
+
+```bash
+pip install msal requests
+```
+
+### 2. Log in (first time only)
+
+```bash
+python .codemie/claude-plugin/skills/msgraph/msgraph.py login
+```
+
+You'll see a message like:
+```
+==============================
+To sign in, use a web browser to open the page https://microsoft.com/devicelogin
+and enter the code ABCD-1234 to authenticate.
+==============================
+```
+
+Open the URL in your browser, enter the code, and sign in with your Microsoft account.
+Your token is cached at `~/.ms_graph_token_cache.json` — you won't need to log in again until it expires (tokens refresh automatically).
+
+### 3. Ask Claude anything
+
+After logging in, just ask Claude naturally:
+
+- *"Show me my unread emails"*
+- *"What meetings do I have this week?"*
+- *"Find the Q4 report in SharePoint"*
+- *"What did Alice send me in Teams?"*
+- *"Who reports to me?"*
+
+Claude will use this skill automatically.
+
+---
+
+## CLI Reference
+
+```
+python .codemie/claude-plugin/skills/msgraph/msgraph.py <command> [options]
+```
+
+### Auth commands
+
+| Command | Description |
+|---------|-------------|
+| `login` | Authenticate (device code flow) |
+| `logout` | Remove cached credentials |
+| `status` | Check if you're logged in |
+
+### Data commands
+
+| Command | Key options | Description |
+|---------|-------------|-------------|
+| `me` | | Your profile |
+| `emails` | `--limit N`, `--unread`, `--search QUERY`, `--read ID`, `--send TO --subject S --body B`, `--folder NAME` | Work with Outlook emails |
+| `calendar` | `--limit N`, `--create TITLE --start DT --end DT`, `--availability` | Calendar events |
+| `sharepoint` | `--sites`, `--site ID [--path P]`, `--download ID` | SharePoint files |
+| `teams` | `--chats`, `--messages CHAT_ID`, `--send MSG --chat-id ID`, `--teams-list` | Teams messages |
+| `onedrive` | `[--path P]`, `--upload FILE`, `--download ID`, `--info ID` | OneDrive files |
+| `people` | `--search NAME`, `--contacts` | People & contacts |
+| `org` | `--manager`, `--reports` | Org chart |
+
+Add `--json` to any command for machine-readable JSON output.
+
+---
+
+## Examples
+
+```bash
+# List 20 most recent emails
+python .codemie/claude-plugin/skills/msgraph/msgraph.py emails --limit 20
+
+# Read a specific email (paste the ID from list output)
+python .codemie/claude-plugin/skills/msgraph/msgraph.py emails --read AAMkAGI2...
+
+# Send an email
+python .codemie/claude-plugin/skills/msgraph/msgraph.py emails \
+  --send colleague@company.com \
+  --subject "Quick question" \
+  --body "Are you free tomorrow at 2pm?"
+
+# Upcoming calendar events
+python .codemie/claude-plugin/skills/msgraph/msgraph.py calendar --limit 5
+
+# Create a meeting
+python .codemie/claude-plugin/skills/msgraph/msgraph.py calendar \
+  --create "Design Review" \
+  --start "2024-03-20T14:00" \
+  --end "2024-03-20T15:00" \
+  --timezone "Europe/Berlin"
+
+# List SharePoint sites you follow
+python .codemie/claude-plugin/skills/msgraph/msgraph.py sharepoint --sites
+
+# Browse a site's documents
+python .codemie/claude-plugin/skills/msgraph/msgraph.py sharepoint \
+  --site "contoso.sharepoint.com,abc123,def456" \
+  --path "Documents/2024"
+
+# Download a OneDrive file
+python .codemie/claude-plugin/skills/msgraph/msgraph.py onedrive --download ITEM_ID --output report.xlsx
+
+# Upload to OneDrive
+python .codemie/claude-plugin/skills/msgraph/msgraph.py onedrive \
+  --upload ./presentation.pptx \
+  --dest "Documents/presentations/deck.pptx"
+
+# Recent Teams chats
+python .codemie/claude-plugin/skills/msgraph/msgraph.py teams --chats
+
+# Read a chat conversation
+python .codemie/claude-plugin/skills/msgraph/msgraph.py teams --messages 19:abc123@thread.v2
+
+# Search your contacts
+python .codemie/claude-plugin/skills/msgraph/msgraph.py people --search "John"
+
+# Your manager
+python .codemie/claude-plugin/skills/msgraph/msgraph.py org --manager
+```
+
+---
+
+## Token Cache
+
+Credentials are stored in `~/.ms_graph_token_cache.json`.
+- Access tokens refresh automatically (they last ~1 hour, but MSAL handles renewal)
+- Refresh tokens last longer (~90 days by default in Azure)
+- Run `logout` to remove the cache: `python msgraph.py logout`
+
+---
+
+## Permissions
+
+The script requests these Microsoft Graph scopes on first login:
+
+| Scope | Used for |
+|-------|---------|
+| `User.Read` | Profile (`me`, `org`) |
+| `Mail.Read` | Reading emails |
+| `Mail.Send` | Sending emails |
+| `Calendars.Read` / `Calendars.ReadWrite` | Calendar events |
+| `Files.Read` / `Files.ReadWrite` | OneDrive files |
+| `Sites.Read.All` | SharePoint sites |
+| `Chat.Read` / `Chat.ReadWrite` | Teams chats |
+| `People.Read` | People rankings |
+| `Contacts.Read` | Outlook contacts |
+
+If your organization restricts some permissions, certain commands may return `Permission denied`.
+
+---
+
+## Troubleshooting
+
+**`ModuleNotFoundError: No module named 'msal'`**
+```bash
+pip install msal requests
+```
+
+**`NOT_LOGGED_IN`**
+```bash
+python .codemie/claude-plugin/skills/msgraph/msgraph.py login
+```
+
+**`Permission denied (403)`**
+Your organization may have restricted that Graph API permission. Contact your IT admin.
+
+**`Authentication expired (401)`**
+```bash
+python .codemie/claude-plugin/skills/msgraph/msgraph.py login
+```
+
+**Token cache is at wrong path**
+Edit `CACHE_FILE` at the top of `msgraph.py` to change the location.

package/dist/agents/plugins/claude/plugin/skills/msgraph/SKILL.md

@@ -0,0 +1,233 @@
+---
+name: msgraph
+description: >
+  Work with Microsoft 365 services via the Graph API — emails, calendar events, SharePoint sites,
+  Teams chats, OneDrive files, contacts, and org chart. Use this skill whenever the user asks
+  about their emails, inbox, unread messages, meetings, calendar, Teams messages or chats,
+  SharePoint documents, OneDrive files, colleagues, manager, direct reports, or any personal/
+  organizational Microsoft data. Invoke proactively any time the user mentions Outlook, Teams,
+  SharePoint, OneDrive, or wants to interact with their Microsoft 365 account. The skill uses
+  a local Python CLI (msgraph.py) that handles authentication, token caching, and all API calls.
+---
+
+# Microsoft Graph API Skill
+
+This skill lets you interact with Microsoft 365 services on behalf of the user using the
+Microsoft Graph API. The Python CLI at `scripts/msgraph.py` handles everything.
+
+## Setup & Authentication
+
+**Check login status first** — always run this before any other command:
+
+```bash
+python scripts/msgraph.py status
+```
+
+**Output interpretation:**
+- `Logged in as: user@company.com` → proceed with any command below
+- `NOT_LOGGED_IN` → follow the Login Flow below
+- `TOKEN_EXPIRED` → session expired, also follow the Login Flow below
+
+### Login Flow (first time or after expiry)
+
+```bash
+python scripts/msgraph.py login
+```
+
+This starts the **Device Code Flow** — it will print a URL and a short code like:
+```
+To sign in, use a web browser to open the page https://microsoft.com/devicelogin
+and enter the code ABCD-1234 to authenticate.
+```
+
+Tell the user exactly that message, then wait. Once they complete login in the browser,
+the token is cached at `~/.ms_graph_token_cache.json` and all subsequent commands run silently.
+
+### When NOT logged in or token expired
+
+If status returns `NOT_LOGGED_IN` or `TOKEN_EXPIRED`, tell the user:
+
+> "You need to log in to Microsoft first. Run this command in your terminal:
+> ```
+> python scripts/msgraph.py login
+> ```
+> A code and URL will appear — open the URL in your browser and enter the code."
+
+---
+
+## Available Commands
+
+### Profile & Org
+
+```bash
+# Your profile
+python scripts/msgraph.py me
+
+# Your manager
+python scripts/msgraph.py org --manager
+
+# Your direct reports
+python scripts/msgraph.py org --reports
+```
+
+### Emails
+
+```bash
+# List recent emails (default 10)
+python scripts/msgraph.py emails
+
+# More emails
+python scripts/msgraph.py emails --limit 25
+
+# Unread only
+python scripts/msgraph.py emails --unread
+
+# Search emails
+python scripts/msgraph.py emails --search "invoice Q4"
+
+# Read a specific email by ID (copy ID from list output)
+python scripts/msgraph.py emails --read MESSAGE_ID
+
+# Send an email
+python scripts/msgraph.py emails --send recipient@example.com --subject "Hello" --body "Message text"
+
+# Browse specific folder (inbox, sentitems, drafts, deleteditems, junkemail)
+python scripts/msgraph.py emails --folder sentitems --limit 5
+
+# Machine-readable JSON output
+python scripts/msgraph.py emails --json
+```
+
+### Calendar
+
+```bash
+# Upcoming events (default 10)
+python scripts/msgraph.py calendar
+
+# More events
+python scripts/msgraph.py calendar --limit 20
+
+# Create an event
+python scripts/msgraph.py calendar --create "Team Standup" \
+  --start "2024-03-20T09:00" --end "2024-03-20T09:30" \
+  --location "Teams" --timezone "Europe/Berlin"
+
+# Check availability for a time window
+python scripts/msgraph.py calendar --availability \
+  --start "2024-03-20T09:00:00" --end "2024-03-20T18:00:00"
+```
+
+### SharePoint
+
+```bash
+# List followed/joined SharePoint sites
+python scripts/msgraph.py sharepoint --sites
+
+# Browse files in a specific site (use ID from --sites output)
+python scripts/msgraph.py sharepoint --site SITE_ID
+
+# Browse a subfolder within a site
+python scripts/msgraph.py sharepoint --site SITE_ID --path "Documents/Reports"
+
+# Download a file
+python scripts/msgraph.py sharepoint --download ITEM_ID --output report.xlsx
+```
+
+### Teams
+
+```bash
+# List all Teams chats
+python scripts/msgraph.py teams --chats
+
+# Read messages from a chat (use chat ID from --chats output)
+python scripts/msgraph.py teams --messages CHAT_ID
+
+# Send a message to a chat
+python scripts/msgraph.py teams --send "Hello team!" --chat-id CHAT_ID
+
+# List teams you're a member of
+python scripts/msgraph.py teams --teams-list
+```
+
+### OneDrive
+
+```bash
+# List root files
+python scripts/msgraph.py onedrive
+
+# Browse a folder
+python scripts/msgraph.py onedrive --path "Documents"
+
+# Upload a file
+python scripts/msgraph.py onedrive --upload ./report.pdf --dest "Documents/report.pdf"
+
+# Download a file by ID
+python scripts/msgraph.py onedrive --download ITEM_ID --output local_copy.pdf
+
+# File metadata
+python scripts/msgraph.py onedrive --info ITEM_ID
+```
+
+### People & Contacts
+
+```bash
+# Frequent collaborators (AI-ranked by Microsoft)
+python scripts/msgraph.py people
+
+# Search people by name
+python scripts/msgraph.py people --search "Alice"
+
+# Outlook address book contacts
+python scripts/msgraph.py people --contacts
+```
+
+---
+
+## Workflow Patterns
+
+### "Show me my emails"
+1. Run `status` → check login
+2. Run `emails --limit 15` → show results
+3. If user wants to read one, run `emails --read ID`
+
+### "What's on my calendar today/this week?"
+1. Run `calendar --limit 10`
+2. Parse dates in output and filter for user's timeframe
+
+### "Find a file in SharePoint"
+1. Run `sharepoint --sites` → list sites
+2. Run `sharepoint --site SITE_ID` → browse files
+3. Use `--path` to drill into folders
+4. Offer `--download ITEM_ID` if user wants the file
+
+### "Check my Teams messages"
+1. Run `teams --chats` → list chats
+2. User picks a chat → run `teams --messages CHAT_ID`
+
+### "Who's my manager?" / "Who reports to me?"
+- Run `org --manager` or `org --reports`
+
+---
+
+## Error Handling
+
+| Exit code | Meaning |
+|-----------|---------|
+| 0 | Success |
+| 1 | API error (shown in output) |
+| 2 | NOT_LOGGED_IN — user must run `login` |
+
+When you see `Permission denied` errors, it means the OAuth scope isn't granted for that operation.
+This can happen if the user's organization has restricted certain Graph API permissions.
+
+---
+
+## Dependencies
+
+The script requires Python 3.10+ and two packages:
+```bash
+pip install msal requests
+```
+
+If `msal` or `requests` are not installed, the script prints the install command and exits.
+IMPORTANT: you must work with current date (get it from sh/bash)