@codemieai/code 0.0.46 → 0.0.48

package/dist/agents/plugins/claude/plugin/.claude-plugin/plugin.json

@@ -5,5 +5,5 @@
     "name": "AI/Run CodeMie",
     "email": "support@codemieai.com"
   },
-  "version": "1.0.12"
+  "version": "1.0.14"
 }

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

@@ -0,0 +1,182 @@
+# 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. Log in (first time only)
+
+```bash
+node .codemie/claude-plugin/skills/msgraph/scripts/msgraph.js 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).
+
+### 2. 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.
+
+---
+
+## No dependencies required
+
+The CLI uses **only built-in Node.js modules** — no `pip install`, no `npm install`.
+Node.js >= 18 is the only requirement, which CodeMie already provides.
+
+---
+
+## CLI Reference
+
+```
+node .codemie/claude-plugin/skills/msgraph/scripts/msgraph.js <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
+node .codemie/claude-plugin/skills/msgraph/scripts/msgraph.js emails --limit 20
+
+# Read a specific email (paste the ID from list output)
+node .codemie/claude-plugin/skills/msgraph/scripts/msgraph.js emails --read AAMkAGI2...
+
+# Send an email
+node .codemie/claude-plugin/skills/msgraph/scripts/msgraph.js emails \
+  --send colleague@company.com \
+  --subject "Quick question" \
+  --body "Are you free tomorrow at 2pm?"
+
+# Upcoming calendar events
+node .codemie/claude-plugin/skills/msgraph/scripts/msgraph.js calendar --limit 5
+
+# Create a meeting
+node .codemie/claude-plugin/skills/msgraph/scripts/msgraph.js calendar \
+  --create "Design Review" \
+  --start "2024-03-20T14:00" \
+  --end "2024-03-20T15:00" \
+  --timezone "Europe/Berlin"
+
+# List SharePoint sites you follow
+node .codemie/claude-plugin/skills/msgraph/scripts/msgraph.js sharepoint --sites
+
+# Browse a site's documents
+node .codemie/claude-plugin/skills/msgraph/scripts/msgraph.js sharepoint \
+  --site "contoso.sharepoint.com,abc123,def456" \
+  --path "Documents/2024"
+
+# Download a OneDrive file
+node .codemie/claude-plugin/skills/msgraph/scripts/msgraph.js onedrive --download ITEM_ID --output report.xlsx
+
+# Upload to OneDrive
+node .codemie/claude-plugin/skills/msgraph/scripts/msgraph.js onedrive \
+  --upload ./presentation.pptx \
+  --dest "Documents/presentations/deck.pptx"
+
+# Recent Teams chats
+node .codemie/claude-plugin/skills/msgraph/scripts/msgraph.js teams --chats
+
+# Read a chat conversation
+node .codemie/claude-plugin/skills/msgraph/scripts/msgraph.js teams --messages 19:abc123@thread.v2
+
+# Search your contacts
+node .codemie/claude-plugin/skills/msgraph/scripts/msgraph.js people --search "John"
+
+# Your manager
+node .codemie/claude-plugin/skills/msgraph/scripts/msgraph.js org --manager
+```
+
+---
+
+## Token Cache
+
+Credentials are stored in `~/.ms_graph_token_cache.json`.
+- Access tokens refresh automatically (they last ~1 hour, silently renewed via refresh token)
+- Refresh tokens last ~90 days by default in Azure
+- Run `logout` to remove the cache: `node msgraph.js 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 |
+| `offline_access` | Silent token refresh |
+
+If your organization restricts some permissions, certain commands may return `Permission denied`.
+
+---
+
+## Troubleshooting
+
+**`NOT_LOGGED_IN`**
+```bash
+node .codemie/claude-plugin/skills/msgraph/scripts/msgraph.js login
+```
+
+**`TOKEN_EXPIRED`**
+```bash
+node .codemie/claude-plugin/skills/msgraph/scripts/msgraph.js login
+```
+
+**`Permission denied (403)`**
+Your organization may have restricted that Graph API permission. Contact your IT admin.
+
+**`Authentication expired (401)`**
+```bash
+node .codemie/claude-plugin/skills/msgraph/scripts/msgraph.js login
+```

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

@@ -0,0 +1,230 @@
+---
+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 Node.js CLI (msgraph.js) 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 Node.js CLI at `scripts/msgraph.js` handles everything — no Python
+or extra packages needed, only the Node.js that CodeMie already requires.
+
+## Setup & Authentication
+
+**Check login status first** — always run this before any other command:
+
+```bash
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js 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
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js 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:
+> ```
+> node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js login
+> ```
+> A code and URL will appear — open the URL in your browser and enter the code."
+
+---
+
+## Available Commands
+
+### Profile & Org
+
+```bash
+# Your profile
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js me
+
+# Your manager
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js org --manager
+
+# Your direct reports
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js org --reports
+```
+
+### Emails
+
+```bash
+# List recent emails (default 10)
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js emails
+
+# More emails
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js emails --limit 25
+
+# Unread only
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js emails --unread
+
+# Search emails
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js emails --search "invoice Q4"
+
+# Read a specific email by ID (copy ID from list output)
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js emails --read MESSAGE_ID
+
+# Send an email
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js emails --send recipient@example.com --subject "Hello" --body "Message text"
+
+# Browse specific folder (inbox, sentitems, drafts, deleteditems, junkemail)
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js emails --folder sentitems --limit 5
+
+# Machine-readable JSON output
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js emails --json
+```
+
+### Calendar
+
+```bash
+# Upcoming events (default 10)
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js calendar
+
+# More events
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js calendar --limit 20
+
+# Create an event
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js 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
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js calendar --availability \
+  --start "2024-03-20T09:00:00" --end "2024-03-20T18:00:00"
+```
+
+### SharePoint
+
+```bash
+# List followed/joined SharePoint sites
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js sharepoint --sites
+
+# Browse files in a specific site (use ID from --sites output)
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js sharepoint --site SITE_ID
+
+# Browse a subfolder within a site
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js sharepoint --site SITE_ID --path "Documents/Reports"
+
+# Download a file
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js sharepoint --download ITEM_ID --output report.xlsx
+```
+
+### Teams
+
+```bash
+# List all Teams chats
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js teams --chats
+
+# Read messages from a chat (use chat ID from --chats output)
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js teams --messages CHAT_ID
+
+# Send a message to a chat
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js teams --send "Hello team!" --chat-id CHAT_ID
+
+# List teams you're a member of
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js teams --teams-list
+```
+
+### OneDrive
+
+```bash
+# List root files
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js onedrive
+
+# Browse a folder
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js onedrive --path "Documents"
+
+# Upload a file
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js onedrive --upload ./report.pdf --dest "Documents/report.pdf"
+
+# Download a file by ID
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js onedrive --download ITEM_ID --output local_copy.pdf
+
+# File metadata
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js onedrive --info ITEM_ID
+```
+
+### People & Contacts
+
+```bash
+# Frequent collaborators (AI-ranked by Microsoft)
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js people
+
+# Search people by name
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js people --search "Alice"
+
+# Outlook address book contacts
+node ${CLAUDE_PLUGIN_ROOT}/skills/msgraph/scripts/msgraph.js 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
+
+**None** — the script uses only built-in Node.js modules (`https`, `fs`, `path`, `os`).
+Node.js >= 18 is required, which is already a CodeMie prerequisite.
+IMPORTANT: you must work with current date (get it from sh/bash)