Compare commits

..

11 Commits

Author SHA1 Message Date
github-actions[bot]
e3c2723988 chore(release): Update version to v1.4.380 2026-01-16 01:05:53 +00:00
Kayvan Sylvan
198b5af12c Merge pull request #1936 from ksylvan/kayvan/msft_copilot_vendor_by_claude_opus_4_5
New Vendor: Microsoft Copilot
2026-01-15 17:03:30 -08:00
Kayvan Sylvan
c66aad556b chore: incoming 1936 changelog entry 2026-01-15 16:59:51 -08:00
Kayvan Sylvan
9f8a2531ca docs: README update for Microsoft Copilot vendor integration 2026-01-15 16:59:28 -08:00
Kayvan Sylvan
a2370a0e3b chore: Note in the guide about restricted env + modernize fixes 2026-01-15 15:16:40 -08:00
Kayvan Sylvan
1af6418486 chore: incoming 1936 changelog entry 2026-01-15 15:04:40 -08:00
Kayvan Sylvan
f50a7568d1 Merge branch 'main' into kayvan/msft_copilot_vendor_by_claude_opus_4_5 2026-01-15 15:00:42 -08:00
Kayvan Sylvan
83d9d0b336 Merge pull request #2 from tomstetson/fix/copilot-sendstream-interface
fix: update Copilot SendStream to use domain.StreamUpdate
2026-01-15 14:54:51 -08:00
Tom Stetson
d98ad5290c fix: update Copilot SendStream to use domain.StreamUpdate
Update the SendStream interface to match the current Vendor interface
which now uses chan domain.StreamUpdate instead of chan string.

Changes:
- Update SendStream signature to use chan domain.StreamUpdate
- Update sendChatMessageStream signature accordingly
- Update parseSSEStream signature accordingly
- Wrap all channel sends with domain.StreamUpdate{Type: StreamTypeContent}

This fixes the build error introduced when the streaming interface was
updated to support metadata like token usage alongside content.
2026-01-15 14:50:59 -05:00
Kayvan Sylvan
a2058ae26e Merge branch 'main' into kayvan/msft_copilot_vendor_by_claude_opus_4_5 2026-01-13 10:35:24 -08:00
Kayvan Sylvan
6a18913a23 feat: add Microsoft 365 Copilot integration
CHANGES:
- Introduce Microsoft 365 Copilot as a new AI vendor.
- Enable querying of Microsoft 365 data like emails, documents, and chats.
- Implement OAuth2 authentication for delegated user permissions.
- Support both synchronous and streaming responses from Copilot.
- Provide comprehensive setup instructions for Azure AD app registration.
- Detail licensing, technical, and permission requirements for Copilot.
- Add troubleshooting steps for common authentication and API errors.
- Document current API limitations and usage examples.
- Integrate Copilot into Fabric's setup process and model listing.
2025-12-05 23:01:58 +08:00
8 changed files with 950 additions and 3 deletions

View File

@@ -1,5 +1,15 @@
# Changelog
## v1.4.380 (2026-01-16)
### PR [#1936](https://github.com/danielmiessler/Fabric/pull/1936) by [ksylvan](https://github.com/ksylvan): New Vendor: Microsoft Copilot
- Add Microsoft 365 Copilot integration as a new AI vendor with OAuth2 authentication for delegated user permissions
- Enable querying of Microsoft 365 data including emails, documents, and chats with both synchronous and streaming response support
- Provide comprehensive setup instructions for Azure AD app registration and detail licensing, technical, and permission requirements
- Add troubleshooting steps for common authentication and API errors with current API limitations documentation
- Fix SendStream interface to use domain.StreamUpdate instead of chan string to match current Vendor interface requirements
## v1.4.379 (2026-01-15)
### PR [#1935](https://github.com/danielmiessler/Fabric/pull/1935) by [dependabot](https://github.com/apps/dependabot): chore(deps): bump the npm_and_yarn group across 1 directory with 2 updates

View File

@@ -77,6 +77,7 @@ Below are the **new features and capabilities** we've added (newest first):
### Recent Major Features
- [v1.4.380](https://github.com/danielmiessler/fabric/releases/tag/v1.4.380) (Jan 15, 2026) — **Microsoft 365 Copilot Integration**: Added support for corporate Microsoft 365 Copilot, enabling enterprise users to leverage AI grounded in their organization's Microsoft 365 data (emails, documents, meetings.
- [v1.4.378](https://github.com/danielmiessler/fabric/releases/tag/v1.4.378) (Jan 14, 2026) — **Digital Ocean GenAI Support**: Added support for Digital Ocean GenAI, along with a [guide for how to use it](./docs/DigitalOcean-Agents-Setup.md).
- [v1.4.356](https://github.com/danielmiessler/fabric/releases/tag/v1.4.356) (Dec 22, 2025) — **Complete Internationalization**: Full i18n support for setup prompts across all 10 languages with intelligent environment variable handling—making Fabric truly accessible worldwide while maintaining configuration consistency.
- [v1.4.350](https://github.com/danielmiessler/fabric/releases/tag/v1.4.350) (Dec 18, 2025) — **Interactive API Documentation**: Adds Swagger/OpenAPI UI at `/swagger/index.html` with comprehensive REST API documentation, enhanced developer guides, and improved endpoint discoverability for easier integration.

View File

@@ -1,3 +1,3 @@
package main
var version = "v1.4.379"
var version = "v1.4.380"

Binary file not shown.

View File

@@ -0,0 +1,449 @@
# Microsoft 365 Copilot Setup Guide for Fabric
This guide walks you through setting up and using Microsoft 365 Copilot with Fabric CLI. Microsoft 365 Copilot provides AI capabilities grounded in your organization's Microsoft 365 data, including emails, documents, meetings, and more.
> NOTE: As per the conversation in [discussion 1853](https://github.com/danielmiessler/Fabric/discussions/1853) - enterprise users with restrictive consent policies will probably need their IT admin to either create an app registration with the required permissions, or grant admin consent for an existing app like Graph Explorer.
## Table of Contents
- [What is Microsoft 365 Copilot?](#what-is-microsoft-365-copilot)
- [Requirements](#requirements)
- [Azure AD App Registration](#azure-ad-app-registration)
- [Obtaining Access Tokens](#obtaining-access-tokens)
- [Configuring Fabric for Copilot](#configuring-fabric-for-copilot)
- [Testing Your Setup](#testing-your-setup)
- [Usage Examples](#usage-examples)
- [Troubleshooting](#troubleshooting)
- [API Limitations](#api-limitations)
---
## What is Microsoft 365 Copilot?
**Microsoft 365 Copilot** is an AI-powered assistant that works across Microsoft 365 applications. When integrated with Fabric, it allows you to:
- **Query your organization's data**: Ask questions about emails, documents, calendars, and Teams chats
- **Grounded responses**: Get AI responses that are based on your actual Microsoft 365 content
- **Enterprise compliance**: All interactions respect your organization's security policies, permissions, and sensitivity labels
### Why Use Microsoft 365 Copilot with Fabric?
- **Enterprise-ready**: Built for organizations with compliance requirements
- **Data grounding**: Responses are based on your actual organizational data
- **Unified access**: Single integration for all Microsoft 365 content
- **Security**: Respects existing permissions and access controls
---
## Requirements
Before you begin, ensure you have:
### Licensing Requirements
1. **Microsoft 365 Copilot License**: Required for each user accessing the API
2. **Microsoft 365 E3 or E5 Subscription** (or equivalent): Foundation for Copilot services
### Technical Requirements
1. **Azure AD Tenant**: Your organization's Azure Active Directory
2. **Azure AD App Registration**: To authenticate with Microsoft Graph
3. **Delegated Permissions**: The Chat API only supports delegated (user) permissions, not application permissions
### Permissions Required
The following Microsoft Graph permissions are needed:
| Permission | Type | Description |
|------------|------|-------------|
| `Sites.Read.All` | Delegated | Read SharePoint sites |
| `Mail.Read` | Delegated | Read user's email |
| `People.Read.All` | Delegated | Read organization's people directory |
| `OnlineMeetingTranscript.Read.All` | Delegated | Read meeting transcripts |
| `Chat.Read` | Delegated | Read Teams chat messages |
| `ChannelMessage.Read.All` | Delegated | Read Teams channel messages |
| `ExternalItem.Read.All` | Delegated | Read external content connectors |
---
## Azure AD App Registration
### Step 1: Create the App Registration
1. Go to the [Azure Portal](https://portal.azure.com)
2. Navigate to **Azure Active Directory** > **App registrations**
3. Click **New registration**
4. Configure the application:
- **Name**: `Fabric CLI - Copilot`
- **Supported account types**: Select "Accounts in this organizational directory only"
- **Redirect URI**: Select "Public client/native (mobile & desktop)" and enter `http://localhost:8400/callback`
5. Click **Register**
### Step 2: Note Your Application IDs
After registration, note these values from the **Overview** page:
- **Application (client) ID**: e.g., `12345678-1234-1234-1234-123456789abc`
- **Directory (tenant) ID**: e.g., `abcdef12-3456-7890-abcd-ef1234567890`
### Step 3: Configure API Permissions
1. Go to **API permissions** in your app registration
2. Click **Add a permission**
3. Select **Microsoft Graph**
4. Select **Delegated permissions**
5. Add the following permissions:
- `Sites.Read.All`
- `Mail.Read`
- `People.Read.All`
- `OnlineMeetingTranscript.Read.All`
- `Chat.Read`
- `ChannelMessage.Read.All`
- `ExternalItem.Read.All`
- `offline_access` (for refresh tokens)
6. Click **Add permissions**
7. **Important**: Click **Grant admin consent for [Your Organization]** (requires admin privileges)
### Step 4: Configure Authentication (Optional - For Confidential Clients)
If you want to use client credentials for token refresh:
1. Go to **Certificates & secrets**
2. Click **New client secret**
3. Add a description and select an expiration
4. Click **Add**
5. **Important**: Copy the secret value immediately (it won't be shown again)
---
## Obtaining Access Tokens
The Microsoft 365 Copilot Chat API requires **delegated permissions**, meaning you need to authenticate as a user. There are several ways to obtain tokens:
### Option 1: Using Azure CLI (Recommended for Development)
```bash
# Install Azure CLI if not already installed
# https://docs.microsoft.com/en-us/cli/azure/install-azure-cli
# Login with your work account
az login --tenant YOUR_TENANT_ID
# Get an access token for Microsoft Graph
az account get-access-token --resource https://graph.microsoft.com --query accessToken -o tsv
```
### Option 2: Using Device Code Flow
For headless environments or when browser authentication isn't possible:
```bash
# Request device code
curl -X POST "https://login.microsoftonline.com/YOUR_TENANT_ID/oauth2/v2.0/devicecode" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "client_id=YOUR_CLIENT_ID&scope=Sites.Read.All Mail.Read People.Read.All OnlineMeetingTranscript.Read.All Chat.Read ChannelMessage.Read.All ExternalItem.Read.All offline_access"
# Follow the instructions to authenticate in a browser
# Then poll for the token using the device_code from the response
```
### Option 3: Using Microsoft Graph Explorer (For Testing)
1. Go to [Microsoft Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer)
2. Sign in with your work account
3. Click the gear icon > "Select permissions"
4. Enable the required permissions
5. Use the access token from the "Access token" tab
### Option 4: Using MSAL Libraries
For production applications, use Microsoft Authentication Library (MSAL):
```go
// Example using Azure Identity SDK for Go
import "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
cred, err := azidentity.NewInteractiveBrowserCredential(&azidentity.InteractiveBrowserCredentialOptions{
TenantID: "YOUR_TENANT_ID",
ClientID: "YOUR_CLIENT_ID",
})
```
---
## Configuring Fabric for Copilot
### Method 1: Using Fabric Setup (Recommended)
1. **Run Fabric Setup:**
```bash
fabric --setup
```
2. **Select Copilot from the menu:**
- Find `Copilot` in the numbered list
- Enter the number and press Enter
3. **Enter Configuration Values:**
```
[Copilot] Enter your Azure AD Tenant ID:
> contoso.onmicrosoft.com
[Copilot] Enter your Azure AD Application (Client) ID:
> 12345678-1234-1234-1234-123456789abc
[Copilot] Enter your Azure AD Client Secret (optional):
> (press Enter to skip, or enter secret for token refresh)
[Copilot] Enter a pre-obtained OAuth2 Access Token:
> eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIs...
[Copilot] Enter a pre-obtained OAuth2 Refresh Token (optional):
> (press Enter to skip, or enter refresh token)
[Copilot] Enter your timezone:
> America/New_York
```
### Method 2: Manual Configuration
Edit `~/.config/fabric/.env`:
```bash
# Microsoft 365 Copilot Configuration
COPILOT_TENANT_ID=contoso.onmicrosoft.com
COPILOT_CLIENT_ID=12345678-1234-1234-1234-123456789abc
COPILOT_CLIENT_SECRET=your-client-secret-if-applicable
COPILOT_ACCESS_TOKEN=eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIs...
COPILOT_REFRESH_TOKEN=your-refresh-token-if-available
COPILOT_API_BASE_URL=https://graph.microsoft.com/beta/copilot
COPILOT_TIME_ZONE=America/New_York
```
### Verify Configuration
```bash
fabric --listmodels | grep -i copilot
```
Expected output:
```
[X] Copilot|microsoft-365-copilot
```
---
## Testing Your Setup
### Basic Test
```bash
# Simple query
echo "What meetings do I have tomorrow?" | fabric --vendor Copilot
# With explicit model (though there's only one)
echo "Summarize my recent emails" | fabric --vendor Copilot --model microsoft-365-copilot
```
### Test with Streaming
```bash
echo "What are the key points from my last team meeting?" | \
fabric --vendor Copilot --stream
```
### Test with Patterns
```bash
# Use a pattern with Copilot
echo "Find action items from my recent emails" | \
fabric --pattern extract_wisdom --vendor Copilot
```
---
## Usage Examples
### Query Calendar
```bash
echo "What meetings do I have scheduled for next week?" | fabric --vendor Copilot
```
### Summarize Emails
```bash
echo "Summarize the emails I received yesterday from my manager" | fabric --vendor Copilot
```
### Search Documents
```bash
echo "Find documents about the Q4 budget proposal" | fabric --vendor Copilot
```
### Team Collaboration
```bash
echo "What were the main discussion points in the engineering standup channel this week?" | fabric --vendor Copilot
```
### Meeting Insights
```bash
echo "What action items came out of the project review meeting on Monday?" | fabric --vendor Copilot
```
### Using with Fabric Patterns
```bash
# Extract wisdom from organizational content
echo "What are the key decisions from last month's leadership updates?" | \
fabric --pattern extract_wisdom --vendor Copilot
# Summarize with a specific pattern
echo "Summarize the HR policy document about remote work" | \
fabric --pattern summarize --vendor Copilot
```
---
## Troubleshooting
### Error: "Authentication failed" or "401 Unauthorized"
**Cause**: Invalid or expired access token
**Solutions**:
1. Obtain a fresh access token:
```bash
az account get-access-token --resource https://graph.microsoft.com --query accessToken -o tsv
```
2. Update your configuration:
```bash
fabric --setup
# Select Copilot and enter the new token
```
3. Check token hasn't expired (tokens typically expire after 1 hour)
### Error: "403 Forbidden"
**Cause**: Missing permissions or admin consent not granted
**Solutions**:
1. Verify all required permissions are added to your app registration
2. Ensure admin consent has been granted
3. Check that your user has a Microsoft 365 Copilot license
### Error: "Failed to create conversation"
**Cause**: API access issues or service unavailable
**Solutions**:
1. Verify the API base URL is correct: `https://graph.microsoft.com/beta/copilot`
2. Check Microsoft 365 service status
3. Ensure your organization has Copilot enabled
### Error: "Rate limit exceeded"
**Cause**: Too many requests
**Solutions**:
1. Wait a few minutes before retrying
2. Reduce request frequency
3. Consider batching queries
### Token Refresh Not Working
**Cause**: Missing client secret or refresh token
**Solutions**:
1. Ensure you have both a refresh token and client secret configured
2. Re-authenticate to get new tokens
3. Check that your app registration supports refresh tokens (public client)
---
## API Limitations
### Current Limitations
1. **Preview API**: The Chat API is currently in preview (`/beta` endpoint) and subject to change
2. **Delegated Only**: Only delegated (user) permissions are supported, not application permissions
3. **Single Model**: Copilot exposes a single unified model, unlike other vendors with multiple model options
4. **Enterprise Only**: Requires Microsoft 365 work or school accounts
5. **Licensing**: Requires Microsoft 365 Copilot license per user
### Rate Limits
The Microsoft Graph API has rate limits that apply:
- Per-app limits
- Per-user limits
- Tenant-wide limits
Consult [Microsoft Graph throttling guidance](https://docs.microsoft.com/en-us/graph/throttling) for details.
### Data Freshness
Copilot indexes data from Microsoft 365 services. There may be a delay between when content is created and when it becomes available in Copilot responses.
---
## Additional Resources
### Microsoft Documentation
- [Microsoft 365 Copilot APIs Overview](https://learn.microsoft.com/en-us/microsoft-365-copilot/extensibility/copilot-apis-overview)
- [Chat API Documentation](https://learn.microsoft.com/en-us/microsoft-365-copilot/extensibility/api/ai-services/chat/overview)
- [Microsoft Graph Authentication](https://learn.microsoft.com/en-us/graph/auth/)
- [Azure AD App Registration](https://learn.microsoft.com/en-us/azure/active-directory/develop/quickstart-register-app)
### Fabric Documentation
- [Fabric README](../README.md)
- [Contexts and Sessions Tutorial](./contexts-and-sessions-tutorial.md)
- [Other Vendor Setup Guides](./GitHub-Models-Setup.md)
---
## Summary
Microsoft 365 Copilot integration with Fabric provides enterprise-ready AI capabilities grounded in your organization's data. Key points:
- **Enterprise compliance**: Works within your organization's security and compliance policies
- **Data grounding**: Responses are based on your actual Microsoft 365 content
- **Single model**: Exposes one unified AI model (`microsoft-365-copilot`)
- **Delegated auth**: Requires user authentication (OAuth2 with delegated permissions)
- **Preview API**: Currently in beta; expect changes
### Quick Start Commands
```bash
# 1. Set up Azure AD app registration (see guide above)
# 2. Get access token
az login --tenant YOUR_TENANT_ID
ACCESS_TOKEN=$(az account get-access-token --resource https://graph.microsoft.com --query accessToken -o tsv)
# 3. Configure Fabric
fabric --setup
# Select Copilot, enter tenant ID, client ID, and access token
# 4. Test it
echo "What meetings do I have this week?" | fabric --vendor Copilot
```
Happy prompting with Microsoft 365 Copilot!

View File

@@ -15,6 +15,7 @@ import (
"github.com/danielmiessler/fabric/internal/plugins/ai/anthropic"
"github.com/danielmiessler/fabric/internal/plugins/ai/azure"
"github.com/danielmiessler/fabric/internal/plugins/ai/bedrock"
"github.com/danielmiessler/fabric/internal/plugins/ai/copilot"
"github.com/danielmiessler/fabric/internal/plugins/ai/digitalocean"
"github.com/danielmiessler/fabric/internal/plugins/ai/dryrun"
"github.com/danielmiessler/fabric/internal/plugins/ai/exolab"
@@ -107,7 +108,8 @@ func NewPluginRegistry(db *fsdb.Db) (ret *PluginRegistry, err error) {
vertexai.NewClient(),
lmstudio.NewClient(),
exolab.NewClient(),
perplexity.NewClient(), // Added Perplexity client
perplexity.NewClient(),
copilot.NewClient(), // Microsoft 365 Copilot
)
if hasAWSCredentials() {

View File

@@ -0,0 +1,485 @@
// Package copilot provides integration with Microsoft 365 Copilot Chat API.
// This vendor allows Fabric to interact with Microsoft 365 Copilot, which provides
// AI capabilities grounded in your organization's Microsoft 365 data.
//
// Requirements:
// - Microsoft 365 Copilot license for each user
// - Microsoft 365 E3 or E5 subscription (or equivalent)
// - Azure AD app registration with appropriate permissions
//
// The Chat API is currently in preview and requires delegated (work or school account)
// permissions. Application permissions are not supported.
package copilot
import (
"bufio"
"bytes"
"context"
"encoding/json"
"fmt"
"io"
"net/http"
"strings"
"time"
"github.com/danielmiessler/fabric/internal/chat"
"github.com/danielmiessler/fabric/internal/domain"
debuglog "github.com/danielmiessler/fabric/internal/log"
"github.com/danielmiessler/fabric/internal/plugins"
"golang.org/x/oauth2"
)
const (
vendorName = "Copilot"
// Microsoft Graph API endpoints
defaultBaseURL = "https://graph.microsoft.com/beta/copilot"
conversationsPath = "/conversations"
// OAuth2 endpoints for Microsoft identity platform
microsoftAuthURL = "https://login.microsoftonline.com/%s/oauth2/v2.0/authorize"
microsoftTokenURL = "https://login.microsoftonline.com/%s/oauth2/v2.0/token"
// Default scopes required for Copilot Chat API
// These are the minimum required permissions
defaultScopes = "Sites.Read.All Mail.Read People.Read.All OnlineMeetingTranscript.Read.All Chat.Read ChannelMessage.Read.All ExternalItem.Read.All offline_access"
// Model name exposed by Copilot (single model)
copilotModelName = "microsoft-365-copilot"
)
// NewClient creates a new Microsoft 365 Copilot client.
func NewClient() *Client {
c := &Client{}
c.PluginBase = &plugins.PluginBase{
Name: vendorName,
EnvNamePrefix: plugins.BuildEnvVariablePrefix(vendorName),
ConfigureCustom: c.configure,
}
// Setup questions for configuration
c.TenantID = c.AddSetupQuestion("Tenant ID", true)
c.TenantID.Question = "Enter your Azure AD Tenant ID (e.g., contoso.onmicrosoft.com or GUID)"
c.ClientID = c.AddSetupQuestion("Client ID", true)
c.ClientID.Question = "Enter your Azure AD Application (Client) ID"
c.ClientSecret = c.AddSetupQuestion("Client Secret", false)
c.ClientSecret.Question = "Enter your Azure AD Client Secret (optional, for confidential clients)"
c.AccessToken = c.AddSetupQuestion("Access Token", false)
c.AccessToken.Question = "Enter a pre-obtained OAuth2 Access Token (optional, for testing)"
c.RefreshToken = c.AddSetupQuestion("Refresh Token", false)
c.RefreshToken.Question = "Enter a pre-obtained OAuth2 Refresh Token (optional)"
c.ApiBaseURL = c.AddSetupQuestion("API Base URL", false)
c.ApiBaseURL.Value = defaultBaseURL
c.TimeZone = c.AddSetupQuestion("Time Zone", false)
c.TimeZone.Value = "America/New_York"
c.TimeZone.Question = "Enter your timezone (e.g., America/New_York, Europe/London)"
return c
}
// Client represents a Microsoft 365 Copilot API client.
type Client struct {
*plugins.PluginBase
// Configuration
TenantID *plugins.SetupQuestion
ClientID *plugins.SetupQuestion
ClientSecret *plugins.SetupQuestion
AccessToken *plugins.SetupQuestion
RefreshToken *plugins.SetupQuestion
ApiBaseURL *plugins.SetupQuestion
TimeZone *plugins.SetupQuestion
// Runtime state
httpClient *http.Client
oauth2Config *oauth2.Config
token *oauth2.Token
}
// configure initializes the client with OAuth2 configuration.
func (c *Client) configure() error {
if c.TenantID.Value == "" || c.ClientID.Value == "" {
return fmt.Errorf("tenant ID and client ID are required")
}
// Build OAuth2 configuration
c.oauth2Config = &oauth2.Config{
ClientID: c.ClientID.Value,
ClientSecret: c.ClientSecret.Value,
Endpoint: oauth2.Endpoint{
AuthURL: fmt.Sprintf(microsoftAuthURL, c.TenantID.Value),
TokenURL: fmt.Sprintf(microsoftTokenURL, c.TenantID.Value),
},
Scopes: strings.Split(defaultScopes, " "),
}
// If we have pre-configured tokens, use them
if c.AccessToken.Value != "" {
c.token = &oauth2.Token{
AccessToken: c.AccessToken.Value,
RefreshToken: c.RefreshToken.Value,
TokenType: "Bearer",
}
// If we have a refresh token, set expiry in the past to trigger refresh
if c.RefreshToken.Value != "" && c.ClientSecret.Value != "" {
c.token.Expiry = time.Now().Add(-time.Hour)
}
}
// Create HTTP client with OAuth2 token source
if c.token != nil {
tokenSource := c.oauth2Config.TokenSource(context.Background(), c.token)
c.httpClient = oauth2.NewClient(context.Background(), tokenSource)
} else {
// No tokens available - will need device code flow or manual token
c.httpClient = &http.Client{Timeout: 120 * time.Second}
}
return nil
}
// IsConfigured returns true if the client has valid configuration.
func (c *Client) IsConfigured() bool {
// Minimum requirement: tenant ID and client ID
if c.TenantID.Value == "" || c.ClientID.Value == "" {
return false
}
// Must have either an access token or ability to get one
return c.AccessToken.Value != "" || (c.RefreshToken.Value != "" && c.ClientSecret.Value != "")
}
// ListModels returns the available models.
// Microsoft 365 Copilot exposes a single model - the Copilot service itself.
func (c *Client) ListModels() ([]string, error) {
// Copilot doesn't expose multiple models - it's a unified service
// We expose it as a single "model" for consistency with Fabric's architecture
return []string{copilotModelName}, nil
}
// Send sends a message to Copilot and returns the response.
func (c *Client) Send(ctx context.Context, msgs []*chat.ChatCompletionMessage, opts *domain.ChatOptions) (string, error) {
// Create a conversation
conversationID, err := c.createConversation(ctx)
if err != nil {
return "", fmt.Errorf("failed to create conversation: %w", err)
}
// Build the message content from chat messages
messageText := c.buildMessageText(msgs)
// Send the chat message
response, err := c.sendChatMessage(ctx, conversationID, messageText)
if err != nil {
return "", fmt.Errorf("failed to send message: %w", err)
}
return response, nil
}
// SendStream sends a message to Copilot and streams the response.
func (c *Client) SendStream(msgs []*chat.ChatCompletionMessage, opts *domain.ChatOptions, channel chan domain.StreamUpdate) error {
defer close(channel)
ctx := context.Background()
// Create a conversation
conversationID, err := c.createConversation(ctx)
if err != nil {
return fmt.Errorf("failed to create conversation: %w", err)
}
// Build the message content from chat messages
messageText := c.buildMessageText(msgs)
// Send the streaming chat message
if err := c.sendChatMessageStream(ctx, conversationID, messageText, channel); err != nil {
return fmt.Errorf("failed to stream message: %w", err)
}
return nil
}
// NeedsRawMode returns whether the model needs raw mode.
func (c *Client) NeedsRawMode(modelName string) bool {
return false
}
// buildMessageText combines chat messages into a single prompt for Copilot.
func (c *Client) buildMessageText(msgs []*chat.ChatCompletionMessage) string {
var parts []string
for _, msg := range msgs {
content := strings.TrimSpace(msg.Content)
if content == "" {
continue
}
switch msg.Role {
case chat.ChatMessageRoleSystem:
// Prepend system messages as context
parts = append([]string{content}, parts...)
case chat.ChatMessageRoleUser, chat.ChatMessageRoleAssistant:
parts = append(parts, content)
}
}
return strings.Join(parts, "\n\n")
}
// createConversation creates a new Copilot conversation.
func (c *Client) createConversation(ctx context.Context) (string, error) {
url := c.ApiBaseURL.Value + conversationsPath
req, err := http.NewRequestWithContext(ctx, "POST", url, bytes.NewBufferString("{}"))
if err != nil {
return "", err
}
req.Header.Set("Content-Type", "application/json")
c.addAuthHeader(req)
resp, err := c.httpClient.Do(req)
if err != nil {
return "", err
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusCreated {
body, _ := io.ReadAll(resp.Body)
return "", fmt.Errorf("failed to create conversation: %s - %s", resp.Status, string(body))
}
var result conversationResponse
if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
return "", err
}
debuglog.Debug(debuglog.Detailed, "Created Copilot conversation: %s\n", result.ID)
return result.ID, nil
}
// sendChatMessage sends a message to an existing conversation (synchronous).
func (c *Client) sendChatMessage(ctx context.Context, conversationID, messageText string) (string, error) {
url := fmt.Sprintf("%s%s/%s/chat", c.ApiBaseURL.Value, conversationsPath, conversationID)
reqBody := chatRequest{
Message: messageParam{
Text: messageText,
},
LocationHint: locationHint{
TimeZone: c.TimeZone.Value,
},
}
jsonBody, err := json.Marshal(reqBody)
if err != nil {
return "", err
}
req, err := http.NewRequestWithContext(ctx, "POST", url, bytes.NewBuffer(jsonBody))
if err != nil {
return "", err
}
req.Header.Set("Content-Type", "application/json")
c.addAuthHeader(req)
resp, err := c.httpClient.Do(req)
if err != nil {
return "", err
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusOK {
body, _ := io.ReadAll(resp.Body)
return "", fmt.Errorf("chat request failed: %s - %s", resp.Status, string(body))
}
var result conversationResponse
if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
return "", err
}
// Extract the assistant's response from messages
return c.extractResponseText(result.Messages), nil
}
// sendChatMessageStream sends a message and streams the response via SSE.
func (c *Client) sendChatMessageStream(ctx context.Context, conversationID, messageText string, channel chan domain.StreamUpdate) error {
url := fmt.Sprintf("%s%s/%s/chatOverStream", c.ApiBaseURL.Value, conversationsPath, conversationID)
reqBody := chatRequest{
Message: messageParam{
Text: messageText,
},
LocationHint: locationHint{
TimeZone: c.TimeZone.Value,
},
}
jsonBody, err := json.Marshal(reqBody)
if err != nil {
return err
}
req, err := http.NewRequestWithContext(ctx, "POST", url, bytes.NewBuffer(jsonBody))
if err != nil {
return err
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Accept", "text/event-stream")
c.addAuthHeader(req)
resp, err := c.httpClient.Do(req)
if err != nil {
return err
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusOK {
body, _ := io.ReadAll(resp.Body)
return fmt.Errorf("stream request failed: %s - %s", resp.Status, string(body))
}
// Parse SSE stream
return c.parseSSEStream(resp.Body, channel)
}
// parseSSEStream parses the Server-Sent Events stream from Copilot.
func (c *Client) parseSSEStream(reader io.Reader, channel chan domain.StreamUpdate) error {
scanner := bufio.NewScanner(reader)
var lastMessageText string
for scanner.Scan() {
line := scanner.Text()
// SSE format: "data: {...json...}"
if !strings.HasPrefix(line, "data: ") {
continue
}
jsonData := strings.TrimPrefix(line, "data: ")
if jsonData == "" {
continue
}
var event conversationResponse
if err := json.Unmarshal([]byte(jsonData), &event); err != nil {
debuglog.Debug(debuglog.Detailed, "Failed to parse SSE event: %v\n", err)
continue
}
// Extract new text from the response
newText := c.extractResponseText(event.Messages)
if newText != "" && newText != lastMessageText {
// Send only the delta (new content)
if delta, ok := strings.CutPrefix(newText, lastMessageText); ok {
if delta != "" {
channel <- domain.StreamUpdate{Type: domain.StreamTypeContent, Content: delta}
}
} else {
// Complete message replacement
channel <- domain.StreamUpdate{Type: domain.StreamTypeContent, Content: newText}
}
lastMessageText = newText
}
}
if err := scanner.Err(); err != nil {
return fmt.Errorf("error reading stream: %w", err)
}
channel <- domain.StreamUpdate{Type: domain.StreamTypeContent, Content: "\n"}
return nil
}
// extractResponseText extracts the assistant's response from messages.
func (c *Client) extractResponseText(messages []responseMessage) string {
// Find the last assistant message (Copilot's response)
for i := len(messages) - 1; i >= 0; i-- {
msg := messages[i]
// Response messages from Copilot have the copilotConversationResponseMessage type
if msg.ODataType == "#microsoft.graph.copilotConversationResponseMessage" {
if msg.Text != "" {
return msg.Text
}
}
}
return ""
}
// addAuthHeader adds the authorization header to a request.
func (c *Client) addAuthHeader(req *http.Request) {
if c.token != nil && c.token.AccessToken != "" {
req.Header.Set("Authorization", "Bearer "+c.token.AccessToken)
} else if c.AccessToken.Value != "" {
req.Header.Set("Authorization", "Bearer "+c.AccessToken.Value)
}
}
// API request/response types
type chatRequest struct {
Message messageParam `json:"message"`
LocationHint locationHint `json:"locationHint"`
AdditionalContext []contextMessage `json:"additionalContext,omitempty"`
ContextualResources *contextualResources `json:"contextualResources,omitempty"`
}
type messageParam struct {
Text string `json:"text"`
}
type locationHint struct {
TimeZone string `json:"timeZone"`
}
type contextMessage struct {
Text string `json:"text"`
}
type contextualResources struct {
Files []fileResource `json:"files,omitempty"`
WebContext *webContext `json:"webContext,omitempty"`
}
type fileResource struct {
URI string `json:"uri"`
}
type webContext struct {
IsWebEnabled bool `json:"isWebEnabled"`
}
type conversationResponse struct {
ID string `json:"id"`
CreatedDateTime string `json:"createdDateTime"`
DisplayName string `json:"displayName"`
State string `json:"state"`
TurnCount int `json:"turnCount"`
Messages []responseMessage `json:"messages,omitempty"`
}
type responseMessage struct {
ODataType string `json:"@odata.type"`
ID string `json:"id"`
Text string `json:"text"`
CreatedDateTime string `json:"createdDateTime"`
AdaptiveCards []any `json:"adaptiveCards,omitempty"`
Attributions []attribution `json:"attributions,omitempty"`
}
type attribution struct {
AttributionType string `json:"attributionType"`
ProviderDisplayName string `json:"providerDisplayName"`
AttributionSource string `json:"attributionSource"`
SeeMoreWebURL string `json:"seeMoreWebUrl"`
}

View File

@@ -1 +1 @@
"1.4.379"
"1.4.380"