Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions .changeset/deprecate-desktop-driver-mcp-shim.md
Original file line number Diff line number Diff line change
@@ -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.
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
Expand Down
9 changes: 0 additions & 9 deletions packages/agentic/desktop-driver-mcp/README.md

This file was deleted.

2 changes: 1 addition & 1 deletion packages/agentic/desktop-mcp/src/stdio.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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,
Expand Down
Original file line number Diff line number Diff line change
@@ -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],
]);

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
---
Expand Down
2 changes: 1 addition & 1 deletion packages/agentic/desktop-test/src/packageBoundary.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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',
];

Expand Down
24 changes: 24 additions & 0 deletions packages/shims/desktop-driver-mcp/README.md
Original file line number Diff line number Diff line change
@@ -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).
Original file line number Diff line number Diff line change
Expand Up @@ -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": [
Expand Down Expand Up @@ -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"
},
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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" }]
}
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
2 changes: 1 addition & 1 deletion tsconfig.json
Original file line number Diff line number Diff line change
Expand Up @@ -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"
Expand Down
4 changes: 2 additions & 2 deletions yarn.lock
Original file line number Diff line number Diff line change
Expand Up @@ -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:*"
Expand Down
Loading