From ac5d12037b6a72fcf217f43c700711bc784d168f Mon Sep 17 00:00:00 2001 From: Jason Morse <35609178+JasonVMo@users.noreply.github.com> Date: Thu, 19 Nov 2026 18:30:17 -0800 Subject: [PATCH] Move deprecated desktop-driver-mcp to shims Preserve driver-only compatibility, add deprecation metadata and migration guidance, and update workspace and test references. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../deprecate-desktop-driver-mcp-shim.md | 8 +++++++ AGENTS.md | 2 +- packages/agentic/desktop-driver-mcp/README.md | 9 ------- .../agentic/desktop-mcp/src/stdio.test.ts | 2 +- .../fixtures/neutral-boundary/loader.mjs | 2 +- .../references/native-qualification.md | 2 +- .../desktop-test/src/packageBoundary.test.ts | 2 +- .../desktop-driver-mcp/AGENTS.md | 0 .../desktop-driver-mcp/CHANGELOG.md | 0 packages/shims/desktop-driver-mcp/README.md | 24 +++++++++++++++++++ .../desktop-driver-mcp/config/cli.cjs | 0 .../desktop-driver-mcp/jest.config.cjs | 0 .../desktop-driver-mcp/package.json | 3 ++- .../desktop-driver-mcp/references/README.md | 2 +- .../references/connection.md | 2 +- .../references/current-status.md | 2 +- .../desktop-driver-mcp/references/tools.md | 2 +- .../desktop-driver-mcp/src/cli.ts | 0 .../desktop-driver-mcp/src/index.ts | 0 .../desktop-driver-mcp/src/shim.test.ts | 0 .../desktop-driver-mcp/tsconfig.json | 2 +- .../repository/package-guidance-packages.json | 2 +- tsconfig.json | 2 +- yarn.lock | 4 ++-- 24 files changed, 48 insertions(+), 24 deletions(-) create mode 100644 .changeset/deprecate-desktop-driver-mcp-shim.md delete mode 100644 packages/agentic/desktop-driver-mcp/README.md rename packages/{agentic => shims}/desktop-driver-mcp/AGENTS.md (100%) rename packages/{agentic => shims}/desktop-driver-mcp/CHANGELOG.md (100%) create mode 100644 packages/shims/desktop-driver-mcp/README.md rename packages/{agentic => shims}/desktop-driver-mcp/config/cli.cjs (100%) rename packages/{agentic => shims}/desktop-driver-mcp/jest.config.cjs (100%) rename packages/{agentic => shims}/desktop-driver-mcp/package.json (87%) rename packages/{agentic => shims}/desktop-driver-mcp/references/README.md (94%) rename packages/{agentic => shims}/desktop-driver-mcp/references/connection.md (91%) rename packages/{agentic => shims}/desktop-driver-mcp/references/current-status.md (91%) rename packages/{agentic => shims}/desktop-driver-mcp/references/tools.md (86%) rename packages/{agentic => shims}/desktop-driver-mcp/src/cli.ts (100%) rename packages/{agentic => shims}/desktop-driver-mcp/src/index.ts (100%) rename packages/{agentic => shims}/desktop-driver-mcp/src/shim.test.ts (100%) rename packages/{agentic => shims}/desktop-driver-mcp/tsconfig.json (70%) diff --git a/.changeset/deprecate-desktop-driver-mcp-shim.md b/.changeset/deprecate-desktop-driver-mcp-shim.md new file mode 100644 index 0000000000..0c6011e1b6 --- /dev/null +++ b/.changeset/deprecate-desktop-driver-mcp-shim.md @@ -0,0 +1,8 @@ +--- +"@fluentui-react-native/desktop-driver-mcp": patch +--- + +Move the deprecated desktop-driver-mcp compatibility package to packages/shims +and add explicit deprecation metadata and migration instructions. Use +@fluentui-react-native/desktop-mcp instead; desktop-mcp --driver-only preserves +the existing executable's driver-only behavior and discovery. diff --git a/AGENTS.md b/AGENTS.md index 745fef6ae5..3de863b2eb 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -74,7 +74,7 @@ For package-owned knowledge, follow the | [packages/agentic/components](packages/agentic/components/AGENTS.md) | Agentic components, primitives, and contracts | | [packages/agentic/design](packages/agentic/design/AGENTS.md) | Tokens, theming, styling, and color utilities | | [packages/agentic/desktop-driver](packages/agentic/desktop-driver/AGENTS.md) | Desktop WebDriver driver | -| [packages/agentic/desktop-driver-mcp](packages/agentic/desktop-driver-mcp/AGENTS.md) | Driver-only MCP compatibility shim | +| [packages/shims/desktop-driver-mcp](packages/shims/desktop-driver-mcp/AGENTS.md) | Deprecated driver-only MCP compatibility shim | | [packages/agentic/desktop-mcp](packages/agentic/desktop-mcp/AGENTS.md) | Desktop MCP adapter and workload tool | | [packages/agentic/desktop-test](packages/agentic/desktop-test/AGENTS.md) | Application-neutral desktop test harness | | [packages/agentic/native-core](packages/agentic/native-core/AGENTS.md) | Native components and modules | diff --git a/packages/agentic/desktop-driver-mcp/README.md b/packages/agentic/desktop-driver-mcp/README.md deleted file mode 100644 index b174b1b2d1..0000000000 --- a/packages/agentic/desktop-driver-mcp/README.md +++ /dev/null @@ -1,9 +0,0 @@ -# @fluentui-react-native/desktop-driver-mcp - -**Deprecated compatibility shim:** this package forwards to `@fluentui-react-native/desktop-mcp` in driver-only mode. -Its `desktop-driver-mcp` executable, public embedding APIs, `--descriptor`, `--root`, and default -`agent-connection.json` discovery remain available. It does not expose workload tools. - -Migrate to `desktop-mcp --driver-only` for equivalent behavior, or use `desktop-mcp` with a supervisor descriptor to -enable managed workloads. See `@fluentui-react-native/desktop-mcp/references/connection.md` and -`@fluentui-react-native/desktop-mcp/references/tools.md`. Agents start at [AGENTS.md](AGENTS.md). diff --git a/packages/agentic/desktop-mcp/src/stdio.test.ts b/packages/agentic/desktop-mcp/src/stdio.test.ts index 00d30e488e..19d0e8cc84 100644 --- a/packages/agentic/desktop-mcp/src/stdio.test.ts +++ b/packages/agentic/desktop-mcp/src/stdio.test.ts @@ -7,7 +7,7 @@ describe('desktop MCP executables', () => { test.each([ ['supervisor', '../config/cli.cjs', [], true], ['explicit driver-only', '../config/cli.cjs', ['--driver-only'], false], - ['legacy shim', '../../desktop-driver-mcp/config/cli.cjs', [], false], + ['legacy shim', '../../../shims/desktop-driver-mcp/config/cli.cjs', [], false], ] as const)('%s advertises only its startup mode over stdio', async (_label, executable, args, workload) => { const transport = new StdioClientTransport({ command: process.execPath, diff --git a/packages/agentic/desktop-test/fixtures/neutral-boundary/loader.mjs b/packages/agentic/desktop-test/fixtures/neutral-boundary/loader.mjs index dafbca6bb0..3e161038e3 100644 --- a/packages/agentic/desktop-test/fixtures/neutral-boundary/loader.mjs +++ b/packages/agentic/desktop-test/fixtures/neutral-boundary/loader.mjs @@ -1,7 +1,7 @@ const workspaceEntryPoints = new Map([ ['@fluentui-react-native/desktop-driver', new URL('../../../desktop-driver/lib/index.js', import.meta.url).href], ['@fluentui-react-native/desktop-test', new URL('../../../desktop-test/lib/index.js', import.meta.url).href], - ['@fluentui-react-native/desktop-driver-mcp', new URL('../../../desktop-driver-mcp/lib/index.js', import.meta.url).href], + ['@fluentui-react-native/desktop-driver-mcp', new URL('../../../../shims/desktop-driver-mcp/lib/index.js', import.meta.url).href], ['@fluentui-react-native/desktop-mcp', new URL('../../../desktop-mcp/lib/index.js', import.meta.url).href], ]); diff --git a/packages/agentic/desktop-test/references/native-qualification.md b/packages/agentic/desktop-test/references/native-qualification.md index 9d6e628de0..048f0ebfa4 100644 --- a/packages/agentic/desktop-test/references/native-qualification.md +++ b/packages/agentic/desktop-test/references/native-qualification.md @@ -4,7 +4,7 @@ kind: instruction-reference owner_paths: - packages/agentic/desktop-test - packages/agentic/desktop-driver - - packages/agentic/desktop-driver-mcp + - packages/shims/desktop-driver-mcp - packages/agentic/desktop-mcp - packages/agentic/storybook-desktop --- diff --git a/packages/agentic/desktop-test/src/packageBoundary.test.ts b/packages/agentic/desktop-test/src/packageBoundary.test.ts index 2a8d8cb3ae..97c7249639 100644 --- a/packages/agentic/desktop-test/src/packageBoundary.test.ts +++ b/packages/agentic/desktop-test/src/packageBoundary.test.ts @@ -10,7 +10,7 @@ const loaderPath = path.join(fixtureRoot, 'loader.mjs'); const neutralPackages = [ 'packages/agentic/desktop-driver', 'packages/agentic/desktop-test', - 'packages/agentic/desktop-driver-mcp', + 'packages/shims/desktop-driver-mcp', 'packages/agentic/desktop-mcp', ]; diff --git a/packages/agentic/desktop-driver-mcp/AGENTS.md b/packages/shims/desktop-driver-mcp/AGENTS.md similarity index 100% rename from packages/agentic/desktop-driver-mcp/AGENTS.md rename to packages/shims/desktop-driver-mcp/AGENTS.md diff --git a/packages/agentic/desktop-driver-mcp/CHANGELOG.md b/packages/shims/desktop-driver-mcp/CHANGELOG.md similarity index 100% rename from packages/agentic/desktop-driver-mcp/CHANGELOG.md rename to packages/shims/desktop-driver-mcp/CHANGELOG.md diff --git a/packages/shims/desktop-driver-mcp/README.md b/packages/shims/desktop-driver-mcp/README.md new file mode 100644 index 0000000000..4af60991f4 --- /dev/null +++ b/packages/shims/desktop-driver-mcp/README.md @@ -0,0 +1,24 @@ +# @fluentui-react-native/desktop-driver-mcp + +**Deprecated:** use `@fluentui-react-native/desktop-mcp` instead. +This compatibility shim forwards to that package in driver-only mode. +Its `desktop-driver-mcp` executable, public embedding APIs, `--descriptor`, `--root`, and default +`agent-connection.json` discovery remain available. It does not expose workload tools. + +## Migration + +Replace the old dependency with `@fluentui-react-native/desktop-mcp`: + +```sh +npm uninstall @fluentui-react-native/desktop-driver-mcp +npm install --save-dev @fluentui-react-native/desktop-mcp +``` + +In MCP server configurations, replace the `desktop-driver-mcp` command with `desktop-mcp` and add `--driver-only`. +Keep existing `--descriptor` and `--root` arguments; driver-only mode preserves `agent-connection.json` discovery. +For embedding, change imports to `@fluentui-react-native/desktop-mcp`; `connectWithDescriptor` and +`createDesktopDriverMcpServer` remain available with the same driver-only behavior. + +Use `desktop-mcp` without `--driver-only` with a supervisor descriptor to enable managed workloads instead. +See `@fluentui-react-native/desktop-mcp/references/connection.md` and +`@fluentui-react-native/desktop-mcp/references/tools.md`. Agents start at [AGENTS.md](AGENTS.md). diff --git a/packages/agentic/desktop-driver-mcp/config/cli.cjs b/packages/shims/desktop-driver-mcp/config/cli.cjs similarity index 100% rename from packages/agentic/desktop-driver-mcp/config/cli.cjs rename to packages/shims/desktop-driver-mcp/config/cli.cjs diff --git a/packages/agentic/desktop-driver-mcp/jest.config.cjs b/packages/shims/desktop-driver-mcp/jest.config.cjs similarity index 100% rename from packages/agentic/desktop-driver-mcp/jest.config.cjs rename to packages/shims/desktop-driver-mcp/jest.config.cjs diff --git a/packages/agentic/desktop-driver-mcp/package.json b/packages/shims/desktop-driver-mcp/package.json similarity index 87% rename from packages/agentic/desktop-driver-mcp/package.json rename to packages/shims/desktop-driver-mcp/package.json index c1d219efd7..dc443a8742 100644 --- a/packages/agentic/desktop-driver-mcp/package.json +++ b/packages/shims/desktop-driver-mcp/package.json @@ -6,7 +6,7 @@ "repository": { "type": "git", "url": "https://github.com/microsoft/fluentui-react-native.git", - "directory": "packages/agentic/desktop-driver-mcp" + "directory": "packages/shims/desktop-driver-mcp" }, "bin": "./config/cli.cjs", "files": [ @@ -48,6 +48,7 @@ "engines": { "node": "^22.19.0 || ^24.0.0 || >=26.0.0" }, + "deprecated": "Use @fluentui-react-native/desktop-mcp instead. For equivalent driver-only behavior, run desktop-mcp --driver-only.", "furn": { "jestPlatform": "react" }, diff --git a/packages/agentic/desktop-driver-mcp/references/README.md b/packages/shims/desktop-driver-mcp/references/README.md similarity index 94% rename from packages/agentic/desktop-driver-mcp/references/README.md rename to packages/shims/desktop-driver-mcp/references/README.md index 78212b61cc..424d25fd3b 100644 --- a/packages/agentic/desktop-driver-mcp/references/README.md +++ b/packages/shims/desktop-driver-mcp/references/README.md @@ -2,7 +2,7 @@ id: desktop-driver-mcp.index kind: index owner_paths: - - packages/agentic/desktop-driver-mcp + - packages/shims/desktop-driver-mcp --- # Compatibility references diff --git a/packages/agentic/desktop-driver-mcp/references/connection.md b/packages/shims/desktop-driver-mcp/references/connection.md similarity index 91% rename from packages/agentic/desktop-driver-mcp/references/connection.md rename to packages/shims/desktop-driver-mcp/references/connection.md index 5bfdf36d43..7ad81f5812 100644 --- a/packages/agentic/desktop-driver-mcp/references/connection.md +++ b/packages/shims/desktop-driver-mcp/references/connection.md @@ -2,7 +2,7 @@ id: desktop-driver-mcp.connection kind: instruction-reference owner_paths: - - packages/agentic/desktop-driver-mcp + - packages/shims/desktop-driver-mcp --- # Connection diff --git a/packages/agentic/desktop-driver-mcp/references/current-status.md b/packages/shims/desktop-driver-mcp/references/current-status.md similarity index 91% rename from packages/agentic/desktop-driver-mcp/references/current-status.md rename to packages/shims/desktop-driver-mcp/references/current-status.md index 5851bcf99e..e9709f1443 100644 --- a/packages/agentic/desktop-driver-mcp/references/current-status.md +++ b/packages/shims/desktop-driver-mcp/references/current-status.md @@ -2,7 +2,7 @@ id: desktop-driver-mcp.current-status kind: instruction-reference owner_paths: - - packages/agentic/desktop-driver-mcp + - packages/shims/desktop-driver-mcp --- # Compatibility status diff --git a/packages/agentic/desktop-driver-mcp/references/tools.md b/packages/shims/desktop-driver-mcp/references/tools.md similarity index 86% rename from packages/agentic/desktop-driver-mcp/references/tools.md rename to packages/shims/desktop-driver-mcp/references/tools.md index 60faff2b5b..63fced14e4 100644 --- a/packages/agentic/desktop-driver-mcp/references/tools.md +++ b/packages/shims/desktop-driver-mcp/references/tools.md @@ -2,7 +2,7 @@ id: desktop-driver-mcp.tools kind: instruction-reference owner_paths: - - packages/agentic/desktop-driver-mcp + - packages/shims/desktop-driver-mcp --- # Tools diff --git a/packages/agentic/desktop-driver-mcp/src/cli.ts b/packages/shims/desktop-driver-mcp/src/cli.ts similarity index 100% rename from packages/agentic/desktop-driver-mcp/src/cli.ts rename to packages/shims/desktop-driver-mcp/src/cli.ts diff --git a/packages/agentic/desktop-driver-mcp/src/index.ts b/packages/shims/desktop-driver-mcp/src/index.ts similarity index 100% rename from packages/agentic/desktop-driver-mcp/src/index.ts rename to packages/shims/desktop-driver-mcp/src/index.ts diff --git a/packages/agentic/desktop-driver-mcp/src/shim.test.ts b/packages/shims/desktop-driver-mcp/src/shim.test.ts similarity index 100% rename from packages/agentic/desktop-driver-mcp/src/shim.test.ts rename to packages/shims/desktop-driver-mcp/src/shim.test.ts diff --git a/packages/agentic/desktop-driver-mcp/tsconfig.json b/packages/shims/desktop-driver-mcp/tsconfig.json similarity index 70% rename from packages/agentic/desktop-driver-mcp/tsconfig.json rename to packages/shims/desktop-driver-mcp/tsconfig.json index 6e3b11d6ef..47082ce92c 100644 --- a/packages/agentic/desktop-driver-mcp/tsconfig.json +++ b/packages/shims/desktop-driver-mcp/tsconfig.json @@ -8,5 +8,5 @@ "tsBuildInfoFile": "node_modules/.cache/tsconfig.tsbuildinfo" }, "include": ["src"], - "references": [{ "path": "../desktop-mcp/tsconfig.json" }, { "path": "../../../scripts/tsconfig.json" }] + "references": [{ "path": "../../agentic/desktop-mcp/tsconfig.json" }, { "path": "../../../scripts/tsconfig.json" }] } diff --git a/references/agents/repository/package-guidance-packages.json b/references/agents/repository/package-guidance-packages.json index 23f5944476..2dde63159b 100644 --- a/references/agents/repository/package-guidance-packages.json +++ b/references/agents/repository/package-guidance-packages.json @@ -4,7 +4,7 @@ "packages/agentic/components", "packages/agentic/design", "packages/agentic/desktop-driver", - "packages/agentic/desktop-driver-mcp", + "packages/shims/desktop-driver-mcp", "packages/agentic/desktop-mcp", "packages/agentic/desktop-test", "packages/agentic/native-core", diff --git a/tsconfig.json b/tsconfig.json index d2af7fa65f..f88c2063e6 100644 --- a/tsconfig.json +++ b/tsconfig.json @@ -35,7 +35,7 @@ "path": "packages/agentic/desktop-driver/tsconfig.json" }, { - "path": "packages/agentic/desktop-driver-mcp/tsconfig.json" + "path": "packages/shims/desktop-driver-mcp/tsconfig.json" }, { "path": "packages/agentic/desktop-mcp/tsconfig.json" diff --git a/yarn.lock b/yarn.lock index 064d85b2ed..94fba6b82e 100644 --- a/yarn.lock +++ b/yarn.lock @@ -4142,9 +4142,9 @@ __metadata: languageName: unknown linkType: soft -"@fluentui-react-native/desktop-driver-mcp@workspace:packages/agentic/desktop-driver-mcp": +"@fluentui-react-native/desktop-driver-mcp@workspace:packages/shims/desktop-driver-mcp": version: 0.0.0-use.local - resolution: "@fluentui-react-native/desktop-driver-mcp@workspace:packages/agentic/desktop-driver-mcp" + resolution: "@fluentui-react-native/desktop-driver-mcp@workspace:packages/shims/desktop-driver-mcp" dependencies: "@fluentui-react-native/desktop-mcp": "workspace:*" "@fluentui-react-native/scripts": "workspace:*"