A monorepo of Microsoft 365 Copilot connectors that bring MSR Event Agent content into the Microsoft 365 ecosystem. The repository contains two complementary connectors that share a common set of packages:

• Search Connector — A Microsoft Graph external connector that indexes MSR content (events, sessions, people, publications, projects, and videos) into Microsoft Graph for offline search and Copilot reasoning via Microsoft Search.
• Knowledge Connector — A Copilot declarative agent plugin that proxies live API queries against the MSR Event Agent API, providing real-time grounding for Microsoft 365 Copilot without pre-indexing.

Both connectors consume the MSR Event Agent API as their data source.

                        ┌────────────────────────┐
                        │    MSR Event Agent API  │
                        │  (events, sessions,     │
                        │  people, publications,  │
                        │  projects, videos)      │
                        └───────────┬────────────┘
                                    │
              ┌─────────────────────┼─────────────────────┐
              │                                           │
              ▼                                           ▼
┌──────────────────────────┐              ┌──────────────────────────┐
│   @msr-connectors/       │              │   @msr-connectors/       │
│   agent-api-client       │              │   agent-api-client       │
│   (typed HTTP client)    │              │   (typed HTTP client)    │
└────────────┬─────────────┘              └────────────┬─────────────┘
             │                                         │
             ▼                                         ▼
┌──────────────────────────┐              ┌──────────────────────────┐
│   search-connector       │              │   knowledge-connector    │
│   + graph-connector-core │              │   (declarative agent /   │
│   (batch indexing)       │              │    API plugin)           │
└────────────┬─────────────┘              └────────────┬─────────────┘
             │                                         │
             ▼                                         ▼
┌──────────────────────────┐              ┌──────────────────────────┐
│   Microsoft Graph        │              │   Microsoft 365 Copilot  │
│   External Connections   │              │   (live query grounding) │
└────────────┬─────────────┘              └──────────────────────────┘
             │
             ▼
┌──────────────────────────┐
│   Microsoft Search /     │
│   Microsoft 365 Copilot  │
│   (indexed content)      │
└──────────────────────────┘

msr-connectors/
├── apps/
│   ├── search-connector/              # Graph external connector (indexing + schema)
│   │   ├── src/
│   │   │   ├── schema/
│   │   │   │   ├── msr-schema.ts      # 19-property unified schema definition
│   │   │   │   ├── create-connection.ts
│   │   │   │   └── delete-connection.ts
│   │   │   ├── ingestion/
│   │   │   │   ├── run-ingestion.ts   # Full/incremental content ingestion
│   │   │   │   └── content-builder.ts # Maps API models → Graph external items
│   │   │   ├── dev-server.ts          # Express dev server with Swagger UI
│   │   │   └── openapi-spec.ts
│   │   └── .env.example
│   └── knowledge-connector/           # Copilot declarative agent plugin
│       ├── src/
│       │   └── api/
│       │       └── server.ts          # Express API server (proxy to Agent API)
│       ├── appPackage/
│       │   ├── declarativeAgent.json  # Agent manifest (v1.3)
│       │   ├── api-plugin.json        # Plugin definition (v2.2)
│       │   └── openapi.yaml           # OpenAPI spec for Copilot
│       └── .env.example
├── packages/
│   ├── graph-connector-core/          # Shared Microsoft Graph utilities
│   │   └── src/
│   │       ├── graph-client.ts        # Authenticated Graph client factory
│   │       └── throttle.ts            # Retry/throttle, semaphore, payload checks
│   └── agent-api-client/              # Typed MSR Event Agent API client
│       └── src/
│           ├── client.ts              # AgentApiClient class
│           └── types.ts               # MsrEvent, MsrSession, MsrPerson, etc.
├── scripts/
│   └── validate-connectors.ts         # 18 pre-flight validation checks
├── docs/
│   └── deployment.md                  # ALM-style deployment guide
├── .github/
│   └── workflows/
│       ├── ci.yml                     # Build, test, lint, validate on every PR
│       ├── validate-pr.yml            # Schema change detection, manifest checks
│       └── deploy.yml                 # Environment-gated deployment
├── package.json                       # npm workspace root
├── tsconfig.base.json                 # Shared TypeScript configuration
└── vitest.workspace.ts                # Vitest workspace test configuration

git clone https://github.com/microsoft/msr-connectors.git
cd msr-connectors
npm install

cp apps/search-connector/.env.example apps/search-connector/.env
cp apps/knowledge-connector/.env.example apps/knowledge-connector/.env

Edit each .env file with your Azure AD credentials and Agent API details. See Environment Variables for the full reference.

npm run build
npm run typecheck
npm run test
npm run validate

# Search Connector — http://localhost:8081
cd apps/search-connector && npm run dev

# Knowledge Connector — http://localhost:8080
cd apps/knowledge-connector && npm run dev

Both connectors serve a Swagger UI at /docs for interactive exploration:

• Search Connector: http://localhost:8081/docs
• Knowledge Connector: http://localhost:8080/docs

cd apps/search-connector
npm run schema:create

This registers the external connection and 19-property schema with Microsoft Graph.

cd apps/search-connector
npm run ingest

This fetches content from the MSR Event Agent API and pushes it to Microsoft Graph as external items.

Shared library for Microsoft Graph external connector operations. Wraps the @microsoft/microsoft-graph-client and @azure/identity SDKs with connector-specific utilities.

Typed HTTP client for the MSR Event Agent API. Provides strongly typed request/response models, pagination support, and error mapping.

Creates a Microsoft Graph external connection, registers a unified schema, and ingests MSR Event Agent content as external items. Indexed content surfaces in Microsoft Search results and Microsoft 365 Copilot reasoning.

The schema covers 6 content types with 19 searchable/retrievable properties, enabling rich filtering and refinement across all MSR content domains.

Available scripts:

Dev server endpoints:

A Microsoft 365 Copilot plugin implemented as a declarative agent (v1.3 manifest). Proxies natural-language queries from Copilot to the MSR Event Agent API in real time, enabling Copilot to ground responses with live data without requiring content to be pre-indexed.

The agent is configured via the appPackage/ directory:

Available scripts:

# Terminal 1 — Search Connector (http://localhost:8081)
cd apps/search-connector
npm run dev

# Terminal 2 — Knowledge Connector (http://localhost:8080)
cd apps/knowledge-connector
npm run dev

# Run all 18 pre-flight checks
npm run validate

# CI mode — treats warnings as failures
npm run validate:ci

# Run the full test suite
npm run test

# Watch mode
npm run test:watch

Tests use Vitest and are co-located with source files.

npm run typecheck

The validate-connectors.ts script runs 18 pre-flight checks across three categories before deployment:

Search Connector — Schema integrity checks:

• All searchable properties have descriptions
• All properties have descriptions
• Recommended semantic labels are applied (title, url, iconUrl, lastModifiedDateTime, createdBy, authors)
• No duplicate property names
• All property types are valid Graph types (String, DateTime, Boolean, Int64, Double, StringCollection)
• Connection ID matches the required pattern (^[a-zA-Z][a-zA-Z0-9]{2,31}$)
• Content builder exports cover all 6 content types

Knowledge Connector — Manifest and API checks:

• Declarative agent manifest validates against the v1.3 schema
• GraphConnectors capability references the correct connection ID
• Actions reference points to a valid api-plugin.json
• API plugin has a valid runtime configuration
• Plugin function names match runtime definitions
• OpenAPI operation IDs are unique
• Required parameters are documented
• OpenAPI paths match Express server routes

Cross-Connector — Consistency checks:

• Connection ID in declarativeAgent.json matches the search connector schema
• search-connector/.env.example documents all required variables
• knowledge-connector/.env.example documents all required variables

Run in CI mode (npm run validate:ci) to treat warnings as failures.

The repository includes three GitHub Actions workflows:

See docs/deployment.md for the full deployment guide, including Azure federated identity setup, environment configuration, and rollback procedures.

The search connector registers a unified schema with 19 properties across all content types:

The MSR Event Agent API exposes six content domains, each mapped to a contentType value in the unified schema:

• MSR Event Agent API — The upstream data service consumed by both connectors
• Microsoft Graph Connectors Overview — How Graph connectors work
• Microsoft Graph External Content API — Schema and item management reference
• Copilot Declarative Agents — Building declarative agents for Microsoft 365 Copilot
• Copilot ALM Starter — ALM patterns that inspired the deployment pipeline

We welcome contributions! Please review the following before submitting a pull request:

1. Read and follow the Code of Conduct
2. Fork the repository and create a feature branch from main
3. Use descriptive branch names: feature/add-incremental-sync, fix/retry-on-throttle
4. Write or update tests for your changes
5. Ensure all checks pass:

   npm run build && npm run typecheck && npm run test && npm run validate

6. Open a pull request with a clear description of the changes

For security concerns, please see SECURITY.md. Do not open a public GitHub issue for security vulnerabilities.

This project is licensed under the MIT License.