Add connector namespaces by alexyaang · Pull Request #2250 · github/awesome-copilot

alexyaang · 2026-07-09T01:27:15Z

Pull Request Checklist

I have read and followed the CONTRIBUTING.md guidelines.
I have read and followed the Guidance for submissions involving paid services.
My contribution adds a new instruction, prompt, agent, skill, workflow, or canvas extension file in the correct directory.
The file follows the required naming convention.
The content is clearly structured and follows the example format.
I have tested my instructions, prompt, agent, skill, workflow, or canvas extension with GitHub Copilot.
I have run npm start and verified that README.md is up to date.
I am targeting the main branch for this pull request.

Description

Type of Contribution

Additional Notes

By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

A Copilot CLI canvas extension for browsing and adding MCP connectors from an Azure Connector Namespace into a Copilot session. Sign-in is dependency-free (OAuth 2.0 auth-code + PKCE via the Azure CLI public client, loopback redirect); network access is restricted to the public Azure Resource Manager endpoint. MIT licensed. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot

Pull request overview

This PR introduces a new Copilot CLI canvas extension, connector-namespaces, for browsing and connecting Azure “Connector Namespace” MCP connectors, plus companion test/preview harnesses to validate the UX and the end-to-end MCP handshake through the real unwrap proxy.

Changes:

Adds the connector-namespaces canvas extension (ARM auth, catalog fetch, install/reauth flows, loopback UI server, MCP unwrap proxy, state persistence).
Adds deterministic regression tests and a standalone preview server to guard recurring UI regressions.
Adds a standalone MCP smoke-test harness to exercise the real proxy path end-to-end (connect → initialize → tools/list → safe tools/call).

Show a summary per file

File	Description
extensions/connector-namespaces/test/smoke.mjs	Standalone orchestrator to install/connect/probe Microsoft MCP servers and write reports.
extensions/connector-namespaces/test/safe-tools.mjs	Heuristic + curated selection of safe read-only tools for automated tools/call.
extensions/connector-namespaces/test/README.md	Usage docs for the smoke-test harness and its consent model.
extensions/connector-namespaces/test/mcp-probe.mjs	Spawns the real unwrap proxy and drives initialize/tools/list/tools/call over stdio.
extensions/connector-namespaces/state.mjs	Persists selected gateway config; tracks session-added connectors.
extensions/connector-namespaces/server.test.mjs	Node tests covering CSRF/cross-site gating logic for POST /api/*.
extensions/connector-namespaces/server.mjs	Loopback HTTP server providing UI + API routes for the canvas.
extensions/connector-namespaces/renderer.test.mjs	Regression tests ensuring spinners aren’t frozen and banner dismiss remains effective.
extensions/connector-namespaces/README.md	Extension documentation (prereqs, install, usage, security notes).
extensions/connector-namespaces/preview/shots.mjs	Optional `agent-browser` script to capture visual evidence screenshots.
extensions/connector-namespaces/preview/server.mjs	Standalone preview server that stubs /api/* endpoints for deterministic UI states.
extensions/connector-namespaces/preview/README.md	Docs for running the preview server and optional screenshot capture.
extensions/connector-namespaces/preview/fixtures.mjs	Deterministic fixtures for preview server responses and catalog tiles.
extensions/connector-namespaces/preview/.gitignore	Ignores generated preview screenshots.
extensions/connector-namespaces/package.json	Declares the extension’s Node module metadata and Copilot SDK dependency.
extensions/connector-namespaces/mcp-unwrap-proxy.mjs	Stdio↔HTTP proxy that unwraps Logic Apps $content SSE envelopes into JSON-RPC lines.
extensions/connector-namespaces/LICENSE	MIT license for the extension content.
extensions/connector-namespaces/install.test.mjs	Unit tests guarding deterministic installed-state selection and safety invariants.
extensions/connector-namespaces/install.reauth.test.mjs	Tests ensuring reauth re-consents the existing connection without minting new resources.
extensions/connector-namespaces/install.mjs	Core install/reauth flows, ARM helpers, MCP config writer, and installed-state derivation.
extensions/connector-namespaces/extension.mjs	Canvas entry point wiring session, actions, and loopback server lifecycle.
extensions/connector-namespaces/createPage.mjs	HTML/JS renderer for “Create connector namespace” provisioning wizard page.
extensions/connector-namespaces/copilot-extension.json	Minimal extension metadata file (name/version).
extensions/connector-namespaces/categories.mjs	Frozen enum defining catalog routing categories (Microsoft vs Partners).
extensions/connector-namespaces/catalog.mjs	Fetches managed APIs and filters/categorizes MCP servers for the catalog UI.
extensions/connector-namespaces/canvas.json	Canvas metadata (id/name/description/author/screenshots).
extensions/connector-namespaces/armClient.mjs	Interactive Azure sign-in + ARM client helpers (paging, host guards, provisioning helpers).

Review details

Files reviewed: 28/29 changed files
Comments generated: 5
Review effort level: Low

+const PROFILE_MCP_PATH = join(homedir(), ".copilot", "mcp-config.json");
+let s_workspaceRoot = null;


+    const opts = { only: null, limit: Infinity, openConsent: false, cleanup: true };
+    for (const a of argv) {
+        if (a.startsWith("--only=")) opts.only = new Set(a.slice(7).split(",").map((s) => s.trim()).filter(Boolean));
+        else if (a.startsWith("--limit=")) opts.limit = Number.parseInt(a.slice(8), 10) || Infinity;


+This extension lives in the private `serverless-paas-balam/polaris` repo, so
+installing it pulls the files through GitHub's API. Before you start, your
+Copilot CLI / `gh` login must be a member of the `serverless-paas-balam` org
+**with SAML SSO authorized**. Verify it in two seconds:
+
+```
+gh api /repos/serverless-paas-balam/polaris --jq .visibility
+```
+
+If that prints `internal` (or `private`) you're set. If it returns `404`, your
+token isn't authorized yet — run `gh auth login`, approve the SSO prompt for the
+org, and retry. (GitHub returns `404`, not a permission error, when gating
+private-repo reads, so don't let the status code fool you.)
+
+### Option A — from the repo (recommended)
+
+Track `main` to get the latest committed version:
+
+```
+install_extension https://github.com/serverless-paas-balam/polaris/tree/main/.github/extensions/connector-namespaces
+```


+function parseBody(req) {
+    return new Promise((resolve) => {
+        let data = "";
+        req.on("data", (chunk) => { data += chunk; });
+        req.on("end", () => {
+            try { resolve(JSON.parse(data)); }
+            catch { resolve({}); }
+        });
+    });
+}


@@ -0,0 +1,279 @@
+// Regression guards for the connector-catalog renderer.
+//
+// Run: node --test .github/extensions/connector-namespaces/renderer.test.mjs


Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

yangalex1 and others added 2 commits June 26, 2026 14:38

Update Connector Namespaces canvas extension

1c85b67

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

alexyaang requested a review from aaronpowell as a code owner July 9, 2026 01:27

Copilot AI review requested due to automatic review settings July 9, 2026 01:27

github-actions Bot added canvas-extension PR touches canvas extensions new-submission PR adds at least one new contribution labels Jul 9, 2026

Copilot started reviewing on behalf of alexyaang July 9, 2026 01:27 View session

alexyaang marked this pull request as draft July 9, 2026 01:29

Copilot AI reviewed Jul 9, 2026

View reviewed changes

yangalex1 and others added 2 commits July 8, 2026 18:52

Harden Connector Namespaces canvas extension

0812930

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Sanitize connector icon brand colors

8beee98

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Add connector namespaces#2250

Add connector namespaces#2250
alexyaang wants to merge 4 commits into
github:mainfrom
alexyaang:add-connector-namespaces

alexyaang commented Jul 9, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

		const PROFILE_MCP_PATH = join(homedir(), ".copilot", "mcp-config.json");
		let s_workspaceRoot = null;

Uh oh!

Conversation

alexyaang commented Jul 9, 2026

Pull Request Checklist

Description

Type of Contribution

Additional Notes

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Review details

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants