@fluentui-react-native/desktop-driver 0.2.0

package/README.md

@@ -0,0 +1,223 @@
+# React Native Desktop Driver
+
+`@fluentui-react-native/desktop-driver` is a W3C WebDriver-compatible remote end
+for React Native desktop applications. It does not use Appium.
+
+Stage 1 provides the complete platform-neutral protocol, sanctioned WebdriverIO
+API, serializable story-test contract, deterministic fake host, evidence
+reports, JSON CLI, and bounded agent API. Native Windows, Win32, and macOS host
+providers are separate Stage 2 work described in [PLAN.md](PLAN.md).
+
+## Package boundaries
+
+| Surface                                 | Responsibility                                              |
+| --------------------------------------- | ----------------------------------------------------------- |
+| `@fluentui-react-native/desktop-driver` | Public types and common APIs                                |
+| `/authoring`                            | Serializable story plans, selectors, and result types       |
+| `/wdio`                                 | Sanctioned WebdriverIO connection, commands, and runner     |
+| `/agent`                                | Bounded JSON-safe inspection and action API                 |
+| `/client`                               | Low-level typed W3C client                                  |
+| `/server`                               | Embeddable W3C remote end and target/session state          |
+| `/artifacts`                            | Confined atomic evidence persistence                        |
+| `/testing`                              | Fake host, fake Storybook orchestration, and test harnesses |
+
+The protocol server remains client-neutral. WebdriverIO is a dependency of the
+high-level `/wdio` surface, not an implementation primitive for routing,
+capability negotiation, or native hosts.
+
+## Authoring story tests
+
+Plans are inline static data under `parameters.desktopDriver`. Storybook can
+extract and shard them without importing a React Native story module, and
+agents can explain the same steps before execution.
+
+```tsx
+import type { DesktopStoryTests } from '@fluentui-react-native/desktop-driver/authoring';
+
+export const Default: Story = {
+  tags: ['desktop-e2e'],
+  parameters: {
+    desktopDriver: {
+      version: 1,
+      tests: [
+        {
+          id: 'pointer-focus',
+          title: 'Responds to activation and receives focus',
+          requires: ['focus', 'screenshot'],
+          steps: [
+            { action: 'wait', target: { testId: 'my-button' } },
+            { expect: { state: 'role', target: { testId: 'my-button' }, value: 'button' } },
+            { action: 'click', target: { testId: 'my-button' } },
+            { expect: { state: 'focused', target: { testId: 'my-button' }, value: true } },
+            { action: 'screenshot', name: 'focused-button', target: { testId: 'my-button' } },
+          ],
+        },
+      ],
+    } satisfies DesktopStoryTests,
+  },
+};
+```
+
+Static extraction accepts JSON literals wrapped by TypeScript `satisfies` or
+`as`. Do not hide plans behind variables, functions, spreads, computed
+properties, or runtime platform branches. Invalid or dynamic plans fail
+manifest generation with their source file, story, and line.
+
+Portable selectors are:
+
+- `{ testId }` for deterministic interaction;
+- `{ role, name? }` for semantic lookup;
+- `{ accessibleName }`;
+- `{ text }`.
+
+Supported actions include click, double-click, clear, type, keys, W3C actions,
+scroll, Storybook arg updates, waits, screenshots, source capture, and notes.
+Assertions cover existence/count, role, accessible name, text/value, displayed,
+enabled, focused, selected, checked/mixed, and expanded state.
+
+Use `requires` for capabilities such as `keyboard`, `focus`, `wheel`, or
+`screenshot`. Missing capabilities produce an explicit skipped result rather
+than a false pass. Platform divergence belongs in declarative `platforms` or
+capability requirements, not branches inside a plan.
+
+## Sanctioned WebdriverIO API
+
+```ts
+import { connectDesktopWebdriver } from '@fluentui-react-native/desktop-driver/wdio';
+
+const desktop = await connectDesktopWebdriver({
+  platformName: 'windows',
+  targetId: 'agenticstorybook-windows',
+  url: 'http://127.0.0.1:39859',
+});
+
+try {
+  const manifest = await desktop.browser.desktopListStories();
+  await desktop.browser.desktopOpenStory('components-button--default');
+  await desktop.browser.desktopExpect({
+    state: 'enabled',
+    target: { testId: 'agentic-storybook-button' },
+    value: true,
+  });
+  const result = await desktop.browser.desktopRunStoryTests({
+    artifactsRoot: 'artifacts/windows/desktop-driver',
+    selection: { tag: 'desktop-e2e', shardCount: 2, shardIndex: 0 },
+  });
+} finally {
+  await desktop.delete();
+}
+```
+
+Registered browser commands are:
+
+- `desktopListStories()`;
+- `desktopOpenStory(storyId, runId?)`;
+- `desktopResetStory(storyId, runId?)`;
+- `desktopExpect(expectation)`;
+- `desktopRunStoryTests(options?)`.
+
+The runner filters by story, test, and tag, shards the sorted
+`storyId/testId` list deterministically, checks required capabilities, resets
+the preview for every run, and distinguishes assertion, timeout, cancellation,
+skip, and infrastructure outcomes.
+
+The server serializes commands per session and all input globally. Timeout
+paths abort host work before releasing input, while runner cancellation drains
+its in-flight request before cleanup, so a later test cannot inherit a late key
+or pointer action.
+
+## Evidence
+
+Supplying `artifactsRoot` writes atomically beneath that root:
+
+```text
+artifactsRoot/
+  host.json
+  run.json
+  tests/
+    <story>-<test>/
+      <named screenshots and source>
+      failure.png
+      failure-source.xml
+      failure-tree.json
+```
+
+Artifact names are sanitized and confined beneath the configured root.
+Failures attempt screenshot, source, and compact-tree capture; evidence-capture
+errors are reported without replacing the original test failure.
+
+## JSON CLI
+
+The CLI prints structured JSON for automation:
+
+```sh
+desktop-driver serve --manifest story-manifest.windows.json --target fake-windows
+
+desktop-driver stories list \
+  --url http://127.0.0.1:4444 \
+  --target fake-windows
+
+desktop-driver stories explain components-button--default \
+  --url http://127.0.0.1:4444 \
+  --target fake-windows
+
+desktop-driver stories run \
+  --url http://127.0.0.1:4444 \
+  --target fake-windows \
+  --tag desktop-e2e \
+  --artifacts artifacts/windows/desktop-driver
+
+desktop-driver agent describe \
+  --url http://127.0.0.1:4444 \
+  --target fake-windows \
+  --scope story \
+  --artifacts artifacts/windows/desktop-driver
+```
+
+`serve` is the Stage 1 fake target. It is not a native-provider substitute.
+
+## Agent API
+
+```ts
+import { connectDesktopAgent } from '@fluentui-react-native/desktop-driver/agent';
+
+const agent = await connectDesktopAgent({
+  artifactsRoot: 'artifacts/windows/desktop-driver',
+  platformName: 'windows',
+  targetId: 'agenticstorybook-windows',
+  url: 'http://127.0.0.1:39859',
+});
+
+try {
+  await agent.listStories();
+  await agent.openStory('components-button--default');
+  await agent.describe({ scope: 'story', depth: 3, maxNodes: 100 });
+  await agent.click({ testId: 'agentic-storybook-button' });
+  await agent.screenshot('button');
+  await agent.runStoryTest('components-button--default', 'pointer-focus');
+} finally {
+  await agent.delete();
+}
+```
+
+The API intentionally exposes coarse operations and bounded tree projections.
+It does not reveal native handles or permit arbitrary process, environment, or
+artifact-path capabilities.
+
+## MCP decision
+
+Phase 3 does not add another MCP listener. The Storybook MCP remains the
+documentation and story-metadata surface; the typed agent API and JSON CLI are
+the executable native-validation surface. Reconsider a composed MCP adapter
+after Stage 2 proves the native commands and their security model. A tool-schema
+file without an executable adapter is not considered an MCP integration.
+
+## Protocol and security
+
+See [SPEC.md](SPEC.md) for implemented W3C routes, extension commands,
+capabilities, device contracts, and unsupported browser behavior.
+
+The server binds loopback, rejects browser-origin requests, accepts only
+server-registered targets, permits one session per physical target, applies
+host command deadlines, and preserves attached applications. Never expose it
+remotely without a separately designed authentication and transport policy.

package/SPEC.md

@@ -0,0 +1,105 @@
+# Desktop Driver Contract
+
+## Scope
+
+Desktop Driver is a W3C WebDriver Classic-compatible native desktop remote end.
+It intentionally implements native application semantics rather than
+pretending to be a browser.
+
+V1 platform names are `macos` and `windows`; endpoint names are `macos`,
+`windows`, and `win32`.
+
+## Sessions and targets
+
+- Targets are registered by the server.
+- Capabilities select a target with `furn:target`.
+- Capabilities never carry executable paths, environment variables, or output
+  directories.
+- Exactly one active session may own a physical target.
+- Commands are serialized per session, and input operations share one global
+  mutex.
+- A target records whether the application was launched or attached.
+- Deleting an attached session preserves the application.
+- Cleanup uses owned process identity, never process-name matching.
+
+Supported extension capabilities:
+
+- `furn:target`;
+- `furn:endpoint`;
+- `furn:renderer`;
+- `furn:clickMode`: `physical`, `accessibility`, or `auto`;
+- returned `furn:features`.
+
+## W3C routes
+
+Implemented standard behavior:
+
+- status and new/delete session;
+- get/set timeouts;
+- current window, handles, switching, closing, and rectangles;
+- element lookup from a window or element;
+- active element;
+- element name, text, attribute, property, rectangle, enabled, selected, and
+  displayed queries;
+- click, clear, and send keys;
+- perform/release actions;
+- window and element screenshots;
+- accessibility source.
+
+Implemented `furn` extensions:
+
+- `GET /session/{id}/furn/manifest`;
+- `GET|POST /session/{id}/furn/story`;
+- `POST /session/{id}/furn/story/reset`;
+- `POST /session/{id}/furn/story/args`;
+- `GET /session/{id}/furn/tree`.
+
+Navigation, cookies, frames, shadow roots, prompts, printing, arbitrary
+JavaScript execution, and browser CSS behavior return `unsupported operation`.
+
+## Elements
+
+Public references use only the standard
+`element-6066-11e4-a52e-4f735466cecf` key with session UUIDs. Native handles,
+UIA runtime IDs, AX references, React tags, and HWNDs are private.
+
+Every command validates native liveness. Story reset increments the preview
+generation and invalidates preview elements while preserving live application
+and Storybook chrome references.
+
+Pointer and wheel actions may use WebDriver element origins. The server resolves
+the public session element UUID, validates preview generation and native
+liveness, and passes only `{ elementId: <native-id> }` to the host contract.
+Public WebDriver element references never cross into platform providers.
+
+Every host operation receives an `AbortSignal`. On timeout, the server aborts
+the host operation before input release, session teardown, or a subsequent
+command. Providers must stop side effects and settle promptly; they may never
+apply late input after cleanup.
+
+Portable lookup uses accessibility ID, normalized role, accessible name, and
+the namespaced `-furn:text` strategy. Deterministic authored interactions use
+`testID`.
+
+## Storybook readiness
+
+The runtime and server validate:
+
+- instance, target, endpoint, and catalog identity;
+- a private bridge nonce;
+- request and run IDs;
+- portable-plan digest;
+- preview generation;
+- the native story-root marker.
+
+Only the authenticated bridge client can complete or fail a selection. Every
+test receives a new run ID and keyed preview remount.
+
+## Results
+
+Run status is `passed` or `failed`. Tests distinguish `passed`, `failed`,
+`skipped`, `timed-out`, `cancelled`, and `infrastructure-error`. Steps record
+status, duration, error, and artifacts.
+
+Unsupported required capabilities are skipped explicitly. An unavailable
+native property never becomes a false-shaped passing assertion.

package/config/cli.cjs

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+
+import('../lib/cli/index.js')
+  .then(({ runDesktopDriverCli }) => runDesktopDriverCli())
+  .catch((error) => {
+    process.stderr.write(`${error.stack || error.message}\n`);
+    process.exitCode = 1;
+  });

package/jest.config.cjs

@@ -0,0 +1,9 @@
+const config = require('@fluentui-react-native/scripts/jest-config');
+
+module.exports = {
+  ...config,
+  moduleNameMapper: {
+    ...config.moduleNameMapper,
+    '^(\\.{1,2}/.*)\\.js$': '$1',
+  },
+};

package/lib/agent/DesktopAgent.d.ts

@@ -0,0 +1,56 @@
+import type { DesktopArtifact, DesktopStoryRunResult } from '../authoring/results.js';
+import type { DesktopStoryExpectation, DesktopStorySelector } from '../authoring/storyTests.js';
+import { ArtifactManager } from '../artifacts/ArtifactManager.js';
+import type { DesktopTreeNode } from '../host/types.js';
+import type { DesktopStoryManifestEntry } from '../storybook.js';
+import type { DesktopWebdriverOptions, DesktopWebdriverSession } from '../wdio/DesktopWebdriver.js';
+export type DesktopAgentOptions = DesktopWebdriverOptions & {
+    artifactsRoot: string;
+};
+export type DesktopAgentStory = Pick<DesktopStoryManifestEntry, 'id' | 'name' | 'tags' | 'title'> & {
+    tests: readonly {
+        id: string;
+        title: string;
+    }[];
+};
+export type DesktopAgentElement = {
+    accessibleName: unknown;
+    enabled: boolean;
+    id: string;
+    role: string;
+    selected: boolean;
+    text: string;
+};
+export type DesktopAgentCheckResult = {
+    message?: string;
+    passed: boolean;
+};
+export type DesktopAgentDescribeOptions = {
+    depth?: number;
+    maxNodes?: number;
+    scope?: 'application' | 'story';
+};
+export declare class DesktopAgent {
+    private readonly artifacts;
+    private readonly desktop;
+    private readonly captured;
+    constructor(desktop: DesktopWebdriverSession, artifacts: ArtifactManager);
+    listStories(): Promise<DesktopAgentStory[]>;
+    explainStory(storyId: string): Promise<DesktopAgentStory>;
+    openStory(storyId: string): Promise<{
+        previewGeneration: number;
+        runId: string;
+        storyId: string;
+    }>;
+    describe(options?: DesktopAgentDescribeOptions): Promise<DesktopTreeNode[]>;
+    find(selector: DesktopStorySelector): Promise<DesktopAgentElement>;
+    click(selector: DesktopStorySelector): Promise<void>;
+    type(selector: DesktopStorySelector, text: string): Promise<void>;
+    check(expectation: DesktopStoryExpectation): Promise<DesktopAgentCheckResult>;
+    screenshot(name: string): Promise<DesktopArtifact>;
+    runStoryTest(storyId: string, testId: string): Promise<DesktopStoryRunResult>;
+    getArtifacts(): readonly DesktopArtifact[];
+    delete(): Promise<void>;
+}
+export declare function connectDesktopAgent(options: DesktopAgentOptions): Promise<DesktopAgent>;
+//# sourceMappingURL=DesktopAgent.d.ts.map

package/lib/agent/DesktopAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesktopAgent.d.ts","sourceRoot":"","sources":["../../src/agent/DesktopAgent.ts"],"names":[],"mappings":"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"}

package/lib/agent/DesktopAgent.js

@@ -0,0 +1,118 @@
+import { ArtifactManager } from '../artifacts/ArtifactManager.js';
+import { DesktopAssertionError, assertDesktopExpectation, findDesktopElement } from '../runner/StoryTestRunner.js';
+import { WebDriverError } from '../protocol/errors.js';
+import { connectDesktopWebdriver } from '../wdio/DesktopWebdriver.js';
+export class DesktopAgent {
+    artifacts;
+    desktop;
+    captured = [];
+    constructor(desktop, artifacts) {
+        this.desktop = desktop;
+        this.artifacts = artifacts;
+    }
+    async listStories() {
+        const manifest = await this.desktop.listStories();
+        return manifest.entries.map((entry) => ({
+            id: entry.id,
+            name: entry.name,
+            tags: entry.tags,
+            tests: (entry.tests?.tests ?? []).map((test) => ({ id: test.id, title: test.title ?? test.id })),
+            title: entry.title,
+        }));
+    }
+    async explainStory(storyId) {
+        const story = (await this.listStories()).find(({ id }) => id === storyId);
+        if (!story) {
+            throw new Error(`Story "${storyId}" is not present in the active platform manifest.`);
+        }
+        return story;
+    }
+    openStory(storyId) {
+        return this.desktop.openStory(storyId);
+    }
+    async describe(options = {}) {
+        const depth = options.depth ?? 3;
+        const maxNodes = options.maxNodes ?? 100;
+        if (!Number.isInteger(depth) || depth < 0 || !Number.isInteger(maxNodes) || maxNodes < 1) {
+            throw new TypeError('Agent tree depth must be non-negative and maxNodes must be positive.');
+        }
+        const roots = await this.desktop.session.getTree();
+        const scoped = options.scope === 'story'
+            ? roots.flatMap((root) => findTreeNodes(root, (node) => node.testId === 'story-root' || (node.testId?.endsWith('-story-root') ?? false)))
+            : roots;
+        let remaining = maxNodes;
+        return scoped.flatMap((root) => {
+            const projected = projectTree(root, depth, () => remaining-- > 0);
+            return projected ? [projected] : [];
+        });
+    }
+    async find(selector) {
+        const element = await findDesktopElement(this.desktop.session, selector);
+        return {
+            accessibleName: await element.getAttribute('name'),
+            enabled: await element.isEnabled(),
+            id: element.id,
+            role: await element.getTagName(),
+            selected: await element.isSelected(),
+            text: await element.getText(),
+        };
+    }
+    async click(selector) {
+        await (await findDesktopElement(this.desktop.session, selector)).click();
+    }
+    async type(selector, text) {
+        await (await findDesktopElement(this.desktop.session, selector)).sendKeys(text);
+    }
+    async check(expectation) {
+        try {
+            await assertDesktopExpectation(this.desktop.session, expectation);
+            return { passed: true };
+        }
+        catch (error) {
+            if (error instanceof DesktopAssertionError || (error instanceof WebDriverError && error.code === 'no such element')) {
+                return { message: error.message, passed: false };
+            }
+            throw error;
+        }
+    }
+    async screenshot(name) {
+        const artifact = this.artifacts.writeScreenshot('agent', name, await this.desktop.session.takeScreenshot());
+        this.captured.push(artifact);
+        return artifact;
+    }
+    runStoryTest(storyId, testId) {
+        return this.desktop.runStoryTests({
+            artifactsRoot: this.artifacts.root,
+            selection: { story: storyId, test: testId },
+        });
+    }
+    getArtifacts() {
+        return [...this.captured];
+    }
+    delete() {
+        return this.desktop.delete();
+    }
+}
+export async function connectDesktopAgent(options) {
+    const artifacts = new ArtifactManager(options.artifactsRoot);
+    const desktop = await connectDesktopWebdriver(options);
+    return new DesktopAgent(desktop, artifacts);
+}
+function findTreeNodes(node, predicate) {
+    return [...(predicate(node) ? [node] : []), ...node.children.flatMap((child) => findTreeNodes(child, predicate))];
+}
+function projectTree(node, depth, take) {
+    if (!take()) {
+        return undefined;
+    }
+    return {
+        ...node,
+        children: depth === 0
+            ? []
+            : node.children.flatMap((child) => {
+                const projected = projectTree(child, depth - 1, take);
+                return projected ? [projected] : [];
+            }),
+    };
+}
+//# sourceMappingURL=DesktopAgent.js.map

package/lib/agent/DesktopAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesktopAgent.js","sourceRoot":"","sources":["../../src/agent/DesktopAgent.ts"],"names":[],"mappings":"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"}

package/lib/agent/DesktopAgent.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DesktopAgent.test.d.ts.map

package/lib/agent/DesktopAgent.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesktopAgent.test.d.ts","sourceRoot":"","sources":["../../src/agent/DesktopAgent.test.ts"],"names":[],"mappings":""}

package/lib/agent/DesktopAgent.test.js

@@ -0,0 +1,97 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { createDesktopDriverClient } from '../client/DesktopDriverClient.js';
+import { createDesktopDriverTestHarness } from '../testing/protocolHarness.js';
+import { createDesktopDriverStoryHarness } from '../testing/protocolHarness.js';
+import { connectDesktopAgent } from './DesktopAgent.js';
+describe('DesktopAgent', () => {
+    test('lists, explains, inspects, acts, checks, captures, and runs the same authored plan', async () => {
+        const manifest = {
+            endpoint: 'windows',
+            entries: [
+                {
+                    id: 'components-button--default',
+                    name: 'Default',
+                    packageName: '@fluentui-react-native/components',
+                    sourcePath: 'src/components/button/button.stories.tsx',
+                    tags: ['e2e', 'story'],
+                    tests: {
+                        version: 1,
+                        tests: [
+                            {
+                                id: 'agent-plan',
+                                steps: [{ expect: { state: 'enabled', target: { testId: 'button-primary' }, value: true } }],
+                            },
+                        ],
+                    },
+                    title: 'Components/Button',
+                },
+            ],
+            platformManifestDigest: 'platform-digest',
+            portablePlanDigest: 'portable-digest',
+            schemaVersion: 1,
+        };
+        const harness = await createDesktopDriverStoryHarness(manifest);
+        const artifactsRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'desktop-driver-agent-'));
+        try {
+            const response = await runContract(harness.server.url, harness.target.id, artifactsRoot);
+            expect(response).toMatchObject({
+                check: { passed: true },
+                run: { status: 'passed', tests: [{ testId: 'agent-plan' }] },
+                screenshot: { kind: 'screenshot', name: 'agent-button' },
+                stories: 1,
+                tree: 1,
+            });
+            expect(fs.existsSync(path.join(artifactsRoot, 'run.json'))).toBe(true);
+        }
+        finally {
+            await harness.close();
+            fs.rmSync(artifactsRoot, { force: true, recursive: true });
+        }
+    });
+    test('validates the artifact root before reserving a target session', async () => {
+        const harness = await createDesktopDriverTestHarness();
+        const temporaryDirectory = fs.mkdtempSync(path.join(os.tmpdir(), 'desktop-driver-agent-invalid-'));
+        const invalidRoot = path.join(temporaryDirectory, 'file');
+        fs.writeFileSync(invalidRoot, 'not a directory');
+        try {
+            await expect(connectDesktopAgent({
+                artifactsRoot: invalidRoot,
+                platformName: 'windows',
+                targetId: harness.target.id,
+                url: harness.server.url,
+            })).rejects.toThrow();
+            const client = createDesktopDriverClient({ url: harness.server.url });
+            const session = await client.newSession({
+                alwaysMatch: { platformName: 'windows', 'furn:target': harness.target.id },
+            });
+            await session.delete();
+        }
+        finally {
+            await harness.close();
+            fs.rmSync(temporaryDirectory, { force: true, recursive: true });
+        }
+    });
+});
+function runContract(url, targetId, artifactsRoot) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(process.execPath, [path.join(__dirname, 'agent.contract.cjs'), url, targetId, artifactsRoot], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        const stdout = [];
+        const stderr = [];
+        child.stdout.on('data', (chunk) => stdout.push(chunk));
+        child.stderr.on('data', (chunk) => stderr.push(chunk));
+        child.once('error', reject);
+        child.once('exit', (code) => {
+            if (code !== 0) {
+                reject(new Error(Buffer.concat(stderr).toString('utf8') || `Desktop agent exited with code ${code}.`));
+                return;
+            }
+            resolve(JSON.parse(Buffer.concat(stdout).toString('utf8')));
+        });
+    });
+}
+//# sourceMappingURL=DesktopAgent.test.js.map

package/lib/agent/DesktopAgent.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesktopAgent.test.js","sourceRoot":"","sources":["../../src/agent/DesktopAgent.test.ts"],"names":[],"mappings":"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"}