@fluentui-react-native/desktop-driver-mcp 0.0.0-stage → 0.1.0

package/AGENTS.md

@@ -0,0 +1,44 @@
+# Desktop Driver MCP agent instructions
+
+This package is the Model Context Protocol adapter for the Desktop Driver agent
+operations. It is the instruction root for this package and every descendant.
+
+## Start here
+
+Read the [README](README.md), then the narrowest entry in the
+[reference index](references/README.md). The operations themselves, their
+schemas, and their failure reasons belong to `@fluentui-react-native/desktop-driver`
+(its agent operations reference); this package
+only maps them onto MCP.
+
+## Invariants
+
+- Stay a thin client. Every tool calls the service's operation routes through
+  the typed client; never add a second execution path, a host, or state the
+  service does not own. Tool input schemas come from the driver's registered
+  operation schemas, so the service and the adapter cannot drift apart.
+- stdout carries MCP protocol only. Diagnostics go to stderr. Never log the
+  grant, the descriptor contents, or application text.
+- Connect only through a private connection descriptor, verified by the
+  installed native helper before the grant is sent. Never launch or build the
+  service or a helper, and never accept a URL or grant from a command line,
+  environment variable, or the model.
+- Serialize acquisition, use, close, and disposal per MCP connection. Retain
+  cleanup responsibility after transport loss; reverify discovery and never
+  replay a failed mutation. A verified replacement invalidates old references.
+  Fence a lost acquisition response; disposal also cleans up late acquisitions.
+- Tie every artifact link to its session. Artifact ids restart in each session.
+- Progress ticks come from the adapter and never reach the service, so a waiting
+  model does not keep an idle session alive. Cancellation aborts the HTTP call,
+  which the service treats as the caller leaving.
+- Messages the model reads are fixed or bounded. Connection failures name no
+  paths; the details go to stderr.
+
+## Validation
+
+Run `yarn format`, `yarn lint`, `yarn build`, and `yarn test` in this package.
+Changes to tool schemas also need the tool-list size bound in `src/server.test.ts`
+to hold. A change to driver operations is validated in the driver package first.
+JavaScript tests use the fake host and are not native qualification; record a
+live run against a real application for native claims. Add a patch changeset
+for this published package when its behavior or shipped guidance changes.

package/README.md

@@ -1,3 +1,47 @@
-# Temporary Holding Version
+# @fluentui-react-native/desktop-driver-mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A [Model Context Protocol](https://modelcontextprotocol.io) server that gives
+coding agents the Desktop Driver agent operations: bounded observation,
+element search, actions, checks with waits, captures, and Storybook story
+selection on a native macOS or Windows application.
+
+**Work in progress:** [current status](references/current-status.md) records
+implemented connection safeguards, orchestration gaps, native qualification
+requirements, and measured MCP discovery costs.
+
+Agents working in this package start at [AGENTS.md](AGENTS.md).
+
+## How it connects
+
+The adapter does not start anything. A trusted supervisor runs the Desktop
+Driver service with an authority, issues the agent a grant, and publishes a
+private connection descriptor. The adapter reads that descriptor, has the
+installed native helper verify the listening service's process identity, and
+only then sends the grant. See
+[Connection and setup](references/connection.md).
+
+## Use it
+
+Register the server with an MCP client that launches it over stdio:
+
+```json
+{
+  "mcpServers": {
+    "desktop-driver": {
+      "command": "npx",
+      "args": ["desktop-driver-mcp", "--descriptor", "agent-connection.json"]
+    }
+  }
+}
+```
+
+The agent then calls `desktop_session` to list targets and open one,
+`desktop_observe` to read or page an immutable observation, compare it with a
+retained sample, search, or inspect the journal, `desktop_act` to change it,
+`desktop_check` to verify state, and `desktop_capture` for pixels. On a
+Storybook target, `desktop_story` lists the stories and renders one. See
+[Tools](references/tools.md).
+
+## References
+
+The [reference index](references/README.md) lists every package reference.

package/config/cli.cjs

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+
+const { version } = require('../package.json');
+
+import('../lib/cli.js')
+  .then(({ runDesktopDriverMcpCli }) => runDesktopDriverMcpCli({ version }))
+  .catch((error) => {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
+  });

package/lib/cli.d.ts

@@ -0,0 +1,10 @@
+export type DesktopDriverMcpCliOptions = {
+    argv?: readonly string[];
+    /** The package version, reported by `--version` and at MCP initialization. */
+    version: string;
+};
+/**
+ * Serves MCP over stdio until the client closes stdin. stdout carries protocol only; diagnostics go to stderr.
+ */
+export declare function runDesktopDriverMcpCli({ argv, version }: DesktopDriverMcpCliOptions): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/lib/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,EAAE,IAAmB,EAAE,OAAO,EAAE,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBxH"}

package/lib/cli.js

@@ -0,0 +1,30 @@
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { Command } from 'commander';
+import { connectWithDescriptor } from './connection.js';
+import { createDesktopDriverMcpServer } from './server.js';
+/**
+ * Serves MCP over stdio until the client closes stdin. stdout carries protocol only; diagnostics go to stderr.
+ */
+export async function runDesktopDriverMcpCli({ argv = process.argv, version }) {
+    const program = new Command()
+        .name('desktop-driver-mcp')
+        .description('Serve Desktop Driver agent operations to an MCP client over stdio.')
+        .option('--descriptor <name>', 'record name of the connection descriptor a supervisor published', 'agent-connection.json')
+        .option('--root <path>', 'private storage root the descriptor was published under; defaults to the platform location')
+        .version(version)
+        .configureOutput({ writeOut: (value) => process.stderr.write(value) });
+    program.parse(argv);
+    const flags = program.opts();
+    const server = createDesktopDriverMcpServer({
+        connect: connectWithDescriptor({ descriptor: flags.descriptor, ...(flags.root === undefined ? {} : { root: flags.root }) }),
+        version,
+    });
+    await server.connect(new StdioServerTransport());
+    const close = () => {
+        void server.close();
+    };
+    process.stdin.once('end', close);
+    process.once('SIGINT', close);
+    process.once('SIGTERM', close);
+}
+//# sourceMappingURL=cli.js.map

package/lib/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAQ3D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,OAAO,EAA8B;IACvG,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;SAC1B,IAAI,CAAC,oBAAoB,CAAC;SAC1B,WAAW,CAAC,oEAAoE,CAAC;SACjF,MAAM,CAAC,qBAAqB,EAAE,iEAAiE,EAAE,uBAAuB,CAAC;SACzH,MAAM,CAAC,eAAe,EAAE,4FAA4F,CAAC;SACrH,OAAO,CAAC,OAAO,CAAC;SAChB,eAAe,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAyC,CAAC;IACpE,MAAM,MAAM,GAAG,4BAA4B,CAAC;QAC1C,OAAO,EAAE,qBAAqB,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC3H,OAAO;KACR,CAAC,CAAC;IACH,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC,CAAC;IACF,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC9B,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AACjC,CAAC"}

package/lib/connection.d.ts

@@ -0,0 +1,23 @@
+import type { DesktopDriverClient } from '@fluentui-react-native/desktop-driver/client';
+export type DesktopDriverConnection = {
+    client: DesktopDriverClient;
+    /** The verified service incarnation. Never a URL or a credential. */
+    incarnation: string;
+    /** The non-secret grant id, not its bearer token or display label. */
+    principal: string;
+};
+/** Revalidates private discovery and returns the client and its verified authority, without launching anything. */
+export type ConnectDesktopDriver = () => Promise<DesktopDriverConnection>;
+export type DescriptorConnectionOptions = {
+    /** The record name the supervisor published the connection descriptor under, such as `agent-connection.json`. */
+    descriptor: string;
+    /** The private storage root, when the supervisor published somewhere other than the platform default. */
+    root?: string;
+};
+/**
+ * Connects through the private descriptor a trusted supervisor published. The service's identity is verified by the
+ * installed native helper before the grant is sent. Nothing is launched or built: a missing helper, descriptor, or
+ * service is an error.
+ */
+export declare function connectWithDescriptor(options: DescriptorConnectionOptions): ConnectDesktopDriver;
+//# sourceMappingURL=connection.d.ts.map

package/lib/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AAExF,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,mHAAmH;AACnH,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,CAAC,uBAAuB,CAAC,CAAC;AAE1E,MAAM,MAAM,2BAA2B,GAAG;IACxC,iHAAiH;IACjH,UAAU,EAAE,MAAM,CAAC;IACnB,yGAAyG;IACzG,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,2BAA2B,GAAG,oBAAoB,CAmBhG"}

package/lib/connection.js

@@ -0,0 +1,28 @@
+import { resolveNativeDesktopDriver } from '@fluentui-react-native/desktop-driver';
+import { createMacOSPrivateStorage, createMacOSServiceVerifier, createWindowsPrivateStorage, createWindowsServiceVerifier, readConnectionDescriptor, } from '@fluentui-react-native/desktop-driver/authority';
+import { createDesktopDriverClient } from '@fluentui-react-native/desktop-driver/client';
+/**
+ * Connects through the private descriptor a trusted supervisor published. The service's identity is verified by the
+ * installed native helper before the grant is sent. Nothing is launched or built: a missing helper, descriptor, or
+ * service is an error.
+ */
+export function connectWithDescriptor(options) {
+    return async () => {
+        const platform = process.platform === 'darwin' ? 'macos' : process.platform === 'win32' ? 'windows' : undefined;
+        if (platform === undefined) {
+            throw new Error('Desktop Driver services run on macOS and Windows.');
+        }
+        const artifact = await resolveNativeDesktopDriver({ buildPolicy: 'never', platform });
+        const storage = platform === 'macos'
+            ? await createMacOSPrivateStorage(...(options.root === undefined ? [] : [options.root]))
+            : await createWindowsPrivateStorage({ artifact, ...(options.root === undefined ? {} : { root: options.root }) });
+        const verify = platform === 'macos' ? createMacOSServiceVerifier({ artifact }) : createWindowsServiceVerifier({ artifact });
+        const descriptor = await readConnectionDescriptor(storage, options.descriptor, verify);
+        return {
+            client: createDesktopDriverClient({ grant: descriptor.grant, url: descriptor.url }),
+            incarnation: descriptor.service.incarnation,
+            principal: descriptor.grant.split('.')[1],
+        };
+    };
+}
+//# sourceMappingURL=connection.js.map

package/lib/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AACnF,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AAqBzF;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAoC;IACxE,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QAChH,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QACtF,MAAM,OAAO,GACX,QAAQ,KAAK,OAAO;YAClB,CAAC,CAAC,MAAM,yBAAyB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YACxF,CAAC,CAAC,MAAM,2BAA2B,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACrH,MAAM,MAAM,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,0BAA0B,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,4BAA4B,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC5H,MAAM,UAAU,GAAG,MAAM,wBAAwB,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACvF,OAAO;YACL,MAAM,EAAE,yBAAyB,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,UAAU,CAAC,GAAG,EAAE,CAAC;YACnF,WAAW,EAAE,UAAU,CAAC,OAAO,CAAC,WAAW;YAC3C,SAAS,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SAC1C,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/lib/controller.d.ts

@@ -0,0 +1,80 @@
+import type { OperationCallOptions } from '@fluentui-react-native/desktop-driver/client';
+import type { OperationResponse } from '@fluentui-react-native/desktop-driver/operations';
+import type { ConnectDesktopDriver } from './connection.js';
+/** A failure the adapter itself reports, with a machine reason as the service's own errors carry. */
+export declare class AdapterError extends Error {
+    readonly reason: string;
+    constructor(reason: string, message: string);
+}
+export type TargetSummary = {
+    endpoint?: string;
+    id: string;
+    launchModes?: ('launch' | 'attach')[];
+    platformName?: string;
+    quarantined?: true;
+    renderer?: string;
+};
+export type OperationSummary = {
+    available: boolean;
+    name: string;
+    unavailableReason?: string;
+};
+export type SessionSummary = {
+    clickMode?: string;
+    id: string;
+    operations: OperationSummary[];
+    target: string;
+};
+export type SessionResponse<Result> = {
+    response: OperationResponse<Result>;
+    session: string;
+};
+export type OpenSessionRequest = {
+    clickMode?: 'accessibility' | 'auto' | 'physical';
+    launch: boolean;
+    target: string;
+};
+/**
+ * Serializes one MCP connection's client lifetime. Transport failure retains cleanup responsibility; only verified
+ * replacement or an authoritative rejection invalidates it. No failed mutation or ambiguous acquisition is replayed.
+ */
+export declare class DesktopController {
+    #private;
+    constructor(connect: ConnectDesktopDriver);
+    status(): Promise<{
+        session?: SessionSummary;
+        sessionState?: 'uncertain';
+        targets: TargetSummary[];
+    }>;
+    open(request: OpenSessionRequest): Promise<SessionSummary>;
+    close(): Promise<{
+        closed?: string;
+    }>;
+    private closeSession;
+    /** Runs one operation in the open session, and names the session so a later reference can be tied to it. */
+    run<Result>(name: string, input: object, options?: OperationCallOptions): Promise<SessionResponse<Result>>;
+    private runOperation;
+    /**
+     * Reads a whole captured image by paging through `artifact`. Artifact ids restart in every session, so a reference
+     * from a closed session is refused rather than read from whichever session is open now.
+     */
+    readArtifact(session: string, artifact: string, signal?: AbortSignal): Promise<{
+        data: Buffer;
+        mimeType: string;
+    }>;
+    private readArtifactPages;
+    get session(): string | undefined;
+    /** Stops admissions immediately. Late acquisitions still run their cleanup after the bounded close wait expires. */
+    dispose(): Promise<void>;
+    private connection;
+    private enqueue;
+    private assertCertain;
+    private describe;
+    /** Transport errors retain ownership; authoritative invalidation never permits replaying a failed operation. */
+    private guard;
+}
+export declare function isWebDriverError(error: unknown): error is Error & {
+    code: string;
+    data?: Record<string, unknown>;
+};
+//# sourceMappingURL=controller.d.ts.map

package/lib/controller.d.ts.map

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

package/lib/controller.js

@@ -0,0 +1,318 @@
+import { createHash } from 'node:crypto';
+import { DesktopSessionClient } from '@fluentui-react-native/desktop-driver/client';
+/** A failure the adapter itself reports, with a machine reason as the service's own errors carry. */
+export class AdapterError extends Error {
+    reason;
+    constructor(reason, message) {
+        super(message);
+        this.name = 'AdapterError';
+        this.reason = reason;
+    }
+}
+const deleteTimeoutMs = 10_000;
+const artifactPageBytes = 1024 * 1024;
+/** The service never keeps a larger capture; a larger claim is a fault, not something to buffer. */
+const maxArtifactBytes = 16 * 1024 * 1024;
+/**
+ * Serializes one MCP connection's client lifetime. Transport failure retains cleanup responsibility; only verified
+ * replacement or an authoritative rejection invalidates it. No failed mutation or ambiguous acquisition is replayed.
+ */
+export class DesktopController {
+    #connect;
+    #connection;
+    #open;
+    #uncertain;
+    #pending = Promise.resolve();
+    #disposed = false;
+    #disposing;
+    #disconnected = new AbortController();
+    constructor(connect) {
+        this.#connect = connect;
+    }
+    status() {
+        return this.enqueue(async () => {
+            const { client } = await this.connection();
+            const status = await this.guard(() => client.status());
+            const targets = Array.isArray(status.targets) ? status.targets.map(summarizeTarget) : [];
+            const session = this.#open ? await this.describe(this.#open) : undefined;
+            return { ...(session ? { session } : {}), ...(this.#uncertain ? { sessionState: 'uncertain' } : {}), targets };
+        });
+    }
+    open(request) {
+        return this.enqueue(async () => {
+            const connection = await this.connection();
+            if (this.#disposed)
+                throw new AdapterError('connection-closed', 'The MCP connection is closed.');
+            this.assertCertain();
+            if (this.#open) {
+                throw new AdapterError('session-open', 'A session is already open. Close it first.');
+            }
+            // A lost response can hide a successful acquisition. Retain the fence until a definitive response or replacement.
+            this.#uncertain = connection;
+            let session;
+            try {
+                session = await this.guard(() => connection.client.newSession({
+                    alwaysMatch: {
+                        'furn:launchMode': request.launch ? 'launch' : 'attach',
+                        'furn:target': request.target,
+                        ...(request.clickMode === undefined ? {} : { 'furn:clickMode': request.clickMode }),
+                    },
+                }));
+            }
+            catch (error) {
+                if (isWebDriverError(error))
+                    this.#uncertain = undefined;
+                throw error;
+            }
+            this.#uncertain = undefined;
+            this.#open = { connection, session, target: request.target };
+            if (this.#disposed) {
+                await this.closeSession();
+                throw new AdapterError('connection-closed', 'The MCP connection is closed.');
+            }
+            return this.describe(this.#open);
+        });
+    }
+    close() {
+        return this.enqueue(async () => {
+            if (!this.#open && !this.#uncertain)
+                return {};
+            await this.connection();
+            this.assertCertain();
+            return this.closeSession();
+        });
+    }
+    async closeSession() {
+        const open = this.#open;
+        if (!open) {
+            return {};
+        }
+        try {
+            await this.guard(() => open.session.delete());
+        }
+        catch (error) {
+            if (!isWebDriverError(error) || error.code !== 'invalid session id')
+                throw error;
+        }
+        this.#open = undefined;
+        return { closed: open.session.id };
+    }
+    /** Runs one operation in the open session, and names the session so a later reference can be tied to it. */
+    run(name, input, options = {}) {
+        return this.enqueue(async () => {
+            if (this.#open || this.#uncertain)
+                await this.connection();
+            this.assertCertain();
+            return this.runOperation(name, input, options);
+        });
+    }
+    async runOperation(name, input, options) {
+        const open = this.#open;
+        if (!open) {
+            throw new AdapterError('no-session', 'No session is open. Open one with desktop_session first.');
+        }
+        const signal = AbortSignal.any([this.#disconnected.signal, ...(options.signal ? [options.signal] : [])]);
+        const response = await this.guard(() => open.session.operation(name, input, { ...options, signal }), signal);
+        return { response, session: open.session.id };
+    }
+    /**
+     * Reads a whole captured image by paging through `artifact`. Artifact ids restart in every session, so a reference
+     * from a closed session is refused rather than read from whichever session is open now.
+     */
+    readArtifact(session, artifact, signal) {
+        return this.enqueue(async () => {
+            if (this.#open || this.#uncertain)
+                await this.connection();
+            this.assertCertain();
+            return this.readArtifactPages(session, artifact, signal);
+        });
+    }
+    async readArtifactPages(session, artifact, signal) {
+        if (this.#open?.session.id !== session) {
+            throw new AdapterError('artifact-expired', 'That capture belongs to a session that is no longer open.');
+        }
+        const pages = [];
+        let offset = 0;
+        let first;
+        let total = 0;
+        while (offset !== undefined) {
+            const { response } = await this.runOperation('artifact', { artifact, length: artifactPageBytes, offset }, { signal });
+            const page = response.result;
+            first ??= page;
+            if (page.sha256 !== first.sha256 || page.bytes > maxArtifactBytes) {
+                throw new AdapterError('artifact-changed', 'The capture changed while it was being read.');
+            }
+            const bytes = Buffer.from(page.data, 'base64');
+            total += bytes.byteLength;
+            if (total > page.bytes || (page.next !== undefined && page.next <= offset)) {
+                throw new AdapterError('artifact-changed', 'The capture changed while it was being read.');
+            }
+            pages.push(bytes);
+            offset = page.next;
+        }
+        const data = Buffer.concat(pages);
+        if (!first || data.byteLength !== first.bytes || createHash('sha256').update(data).digest('hex') !== first.sha256) {
+            throw new AdapterError('artifact-changed', 'The capture did not match its recorded digest.');
+        }
+        return { data, mimeType: first.mimeType };
+    }
+    get session() {
+        return this.#open?.session.id;
+    }
+    /** Stops admissions immediately. Late acquisitions still run their cleanup after the bounded close wait expires. */
+    dispose() {
+        this.#disposed = true;
+        this.#disconnected.abort();
+        return (this.#disposing ??= (async () => {
+            const cleanup = this.#pending.then(async () => {
+                await this.closeSession();
+                this.assertCertain();
+            });
+            this.#pending = cleanup.catch(() => {
+                console.error('desktop-driver-mcp: session cleanup is incomplete; the service must drain or expire the session.');
+            });
+            let timer;
+            try {
+                await Promise.race([
+                    this.#pending,
+                    new Promise((resolve) => {
+                        timer = setTimeout(() => {
+                            console.error('desktop-driver-mcp: session cleanup is still pending; the service must drain or expire the session.');
+                            resolve();
+                        }, deleteTimeoutMs);
+                        timer.unref();
+                    }),
+                ]);
+            }
+            finally {
+                if (timer)
+                    clearTimeout(timer);
+            }
+        })());
+    }
+    async connection() {
+        if (this.#connection)
+            return this.#connection;
+        let connection;
+        try {
+            connection = await this.#connect();
+        }
+        catch (error) {
+            // The cause can name machine-local paths; the operator reads it on stderr, the model reads a fixed message.
+            console.error(`desktop-driver-mcp: connecting failed: ${error instanceof Error ? error.message : String(error)}`);
+            throw new AdapterError('service-unavailable', 'The Desktop Driver service is not available. Ask the operator to start it.');
+        }
+        const previous = this.#open?.connection ?? this.#uncertain;
+        if (previous && previous.incarnation !== connection.incarnation) {
+            this.#open = undefined;
+            this.#uncertain = undefined;
+        }
+        else if (previous && previous.principal !== connection.principal) {
+            // A new grant on the same live service does not prove that the old grant's session has ended.
+            if (this.#open) {
+                try {
+                    await this.closeSession();
+                }
+                catch (error) {
+                    if (this.#open)
+                        throw error;
+                }
+            }
+            if (this.#uncertain) {
+                try {
+                    await this.guard(() => previous.client.status());
+                }
+                catch (error) {
+                    if (this.#uncertain)
+                        throw error;
+                }
+            }
+            this.assertCertain();
+        }
+        else if (this.#open) {
+            // Rebind only to the same verified service and principal. A subsequent command still validates session liveness.
+            this.#open = {
+                ...this.#open,
+                connection,
+                session: new DesktopSessionClient(connection.client, this.#open.session.id, this.#open.session.capabilities),
+            };
+        }
+        this.#connection = connection;
+        return connection;
+    }
+    enqueue(work) {
+        const result = this.#pending.then(() => {
+            if (this.#disposed)
+                throw new AdapterError('connection-closed', 'The MCP connection is closed.');
+            return work();
+        });
+        this.#pending = result.catch(() => undefined);
+        return result;
+    }
+    assertCertain() {
+        if (this.#uncertain) {
+            throw new AdapterError('session-uncertain', 'A session acquisition lost its response. Ask the operator to revoke the old grant or restart the service before opening another.');
+        }
+    }
+    async describe(open) {
+        const catalog = await this.guard(() => open.session.operations());
+        const operations = catalog.operations.map(({ available, name, unavailableReason }) => ({
+            available,
+            name,
+            ...(unavailableReason === undefined ? {} : { unavailableReason }),
+        }));
+        const clickMode = open.session.capabilities['furn:clickMode'];
+        return {
+            ...(typeof clickMode === 'string' ? { clickMode } : {}),
+            id: open.session.id,
+            operations,
+            target: open.target,
+        };
+    }
+    /** Transport errors retain ownership; authoritative invalidation never permits replaying a failed operation. */
+    async guard(call, signal) {
+        try {
+            return await call();
+        }
+        catch (error) {
+            if (signal?.aborted) {
+                throw new AdapterError('cancelled', 'The call was cancelled.');
+            }
+            if (isWebDriverError(error)) {
+                if (error.code === 'invalid session id') {
+                    this.#open = undefined;
+                }
+                if (error.code === 'unauthorized') {
+                    this.#open = undefined;
+                    this.#uncertain = undefined;
+                    this.#connection = undefined;
+                    throw new AdapterError('service-unavailable', 'The Desktop Driver authority is no longer valid. Reconnect before opening a session.');
+                }
+                throw error;
+            }
+            this.#connection = undefined;
+            throw new AdapterError('service-unavailable', 'The Desktop Driver service stopped answering. Recheck status before continuing.');
+        }
+    }
+}
+export function isWebDriverError(error) {
+    return error instanceof Error && error.name === 'WebDriverError' && typeof error.code === 'string';
+}
+function summarizeTarget(target) {
+    const text = (value) => (typeof value === 'string' ? value : undefined);
+    const summary = { id: String(target.id) };
+    for (const key of ['endpoint', 'platformName', 'renderer']) {
+        const value = text(target[key]);
+        if (value !== undefined) {
+            summary[key] = value;
+        }
+    }
+    if (target.quarantine !== undefined) {
+        summary.quarantined = true;
+    }
+    if (Array.isArray(target.launchModes)) {
+        summary.launchModes = target.launchModes.filter((mode) => mode === 'launch' || mode === 'attach');
+    }
+    return summary;
+}
+//# sourceMappingURL=controller.js.map

package/lib/controller.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,5 @@
+export { connectWithDescriptor } from './connection.js';
+export type { ConnectDesktopDriver, DescriptorConnectionOptions, DesktopDriverConnection } from './connection.js';
+export { createDesktopDriverMcpServer } from './server.js';
+export type { DesktopDriverMcpServerOptions } from './server.js';
+//# sourceMappingURL=index.d.ts.map