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

package/lib/controller.js

@@ -0,0 +1,352 @@
+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;
+    #binding;
+    #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 () => {
+                if (this.#binding) {
+                    await this.#binding.child.client.revokeConnection();
+                    this.#open = undefined;
+                    this.#uncertain = undefined;
+                    this.#binding = undefined;
+                }
+            });
+            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);
+                if (this.#binding)
+                    this.#disposing = undefined;
+            }
+        })());
+    }
+    async connection() {
+        if (this.#connection)
+            return this.#connection;
+        let connection;
+        try {
+            connection = await this.#connect();
+        }
+        catch {
+            // Discovery failures can contain descriptor credentials; neither protocol output nor diagnostics may echo them.
+            console.error('desktop-driver-mcp: connecting failed; verify private discovery and the service identity.');
+            throw new AdapterError('service-unavailable', 'The Desktop Driver service is not available. Ask the operator to start it.');
+        }
+        const binding = this.#binding;
+        if (binding && binding.root.incarnation === connection.incarnation && binding.root.principal === connection.principal) {
+            connection = binding.child;
+        }
+        else {
+            if (binding && binding.root.incarnation === connection.incarnation) {
+                await this.guard(() => binding.child.client.revokeConnection());
+                this.#open = undefined;
+                this.#uncertain = undefined;
+            }
+            const root = connection;
+            let child;
+            try {
+                child = await this.guard(() => root.client.delegateConnection());
+            }
+            catch (error) {
+                if (isWebDriverError(error) && ['unknown command', 'unsupported operation'].includes(error.code)) {
+                    throw new AdapterError('connection-authority-unsupported', 'The service does not support isolated connection authority.');
+                }
+                throw error;
+            }
+            const principal = child.principalId;
+            if (!principal)
+                throw new AdapterError('service-unavailable', 'The service does not support isolated connection authority.');
+            connection = { client: child, incarnation: root.incarnation, principal };
+            this.#binding = { child: connection, root };
+        }
+        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

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,YAAY,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAClH,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAC3D,YAAY,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC"}

package/lib/index.js

@@ -0,0 +1,3 @@
+export { connectWithDescriptor } from './connection.js';
+export { createDesktopDriverMcpServer } from './server.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC"}

package/lib/results.d.ts

@@ -0,0 +1,11 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+type Content = CallToolResult['content'][number];
+/**
+ * Renders a value as the model reads it: compact JSON, with any observation outline lifted out into its own text block
+ * so its lines read as lines instead of escaped `\n` runs. Nothing is sent twice.
+ */
+export declare function jsonResult(value: unknown, extra?: Content[]): CallToolResult;
+/** A failure the model can branch on: the WebDriver error code, the machine reason, and a bounded message. */
+export declare function errorResult(error: unknown): CallToolResult;
+export {};
+//# sourceMappingURL=results.d.ts.map

package/lib/results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../src/results.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAIzE,KAAK,OAAO,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAIjD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,GAAE,OAAO,EAAO,GAAG,cAAc,CAMhF;AAED,8GAA8G;AAC9G,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAgB1D"}

package/lib/results.js

@@ -0,0 +1,61 @@
+import { AdapterError, isWebDriverError } from './controller.js';
+const maxMessageLength = 300;
+/**
+ * Renders a value as the model reads it: compact JSON, with any observation outline lifted out into its own text block
+ * so its lines read as lines instead of escaped `\n` runs. Nothing is sent twice.
+ */
+export function jsonResult(value, extra = []) {
+    const outlines = [];
+    const lifted = liftOutlines(value, outlines);
+    return {
+        content: [{ text: JSON.stringify(lifted), type: 'text' }, ...outlines.map((text) => ({ text, type: 'text' })), ...extra],
+    };
+}
+/** A failure the model can branch on: the WebDriver error code, the machine reason, and a bounded message. */
+export function errorResult(error) {
+    let failure;
+    if (error instanceof AdapterError) {
+        failure = { error: 'adapter', message: error.message, reason: error.reason };
+    }
+    else if (isWebDriverError(error)) {
+        const data = error.data ?? {};
+        failure = {
+            error: error.code,
+            message: bound(error.message),
+            ...pick(data, ['reason', 'nativeCode', 'requestId', 'mutation']),
+        };
+    }
+    else {
+        console.error(`desktop-driver-mcp: ${error instanceof Error ? (error.stack ?? error.message) : String(error)}`);
+        failure = { error: 'adapter', message: 'The adapter failed unexpectedly.', reason: 'internal' };
+    }
+    return { content: [{ text: JSON.stringify(failure), type: 'text' }], isError: true };
+}
+function liftOutlines(value, outlines) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        return value;
+    }
+    const copy = {};
+    for (const [key, child] of Object.entries(value)) {
+        if (key === 'outline' && typeof child === 'string') {
+            outlines.push(child);
+            copy.outline = `(text block ${outlines.length + 1})`;
+        }
+        else if (key === 'result' || key === 'observation') {
+            copy[key] = liftOutlines(child, outlines);
+        }
+        else {
+            copy[key] = child;
+        }
+    }
+    return copy;
+}
+function pick(data, keys) {
+    return Object.fromEntries(keys.filter((key) => data[key] !== undefined).map((key) => [key, data[key]]));
+}
+function bound(message) {
+    // The service already bounds operation messages; session errors may quote provider text, so bound them here too.
+    const visible = message.replace(/\p{Cc}/gu, ' ');
+    return visible.length > maxMessageLength ? `${visible.slice(0, maxMessageLength - 1)}…` : visible;
+}
+//# sourceMappingURL=results.js.map

package/lib/results.js.map

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

package/lib/server.d.ts

@@ -0,0 +1,13 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ConnectDesktopDriver } from './connection.js';
+export type DesktopDriverMcpServerOptions = {
+    /** Returns a verified client and authority identity; called again after transport failure or authority invalidation. */
+    connect: ConnectDesktopDriver;
+    /** How often a long call reports progress to a client that asked for it. */
+    progressIntervalMs?: number;
+    /** The adapter version reported at initialization. */
+    version: string;
+};
+/** Creates the MCP server for one client connection. Close the server to end the session it opened. */
+export declare function createDesktopDriverMcpServer(options: DesktopDriverMcpServerOptions): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/lib/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAMtF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAI5D,MAAM,MAAM,6BAA6B,GAAG;IAC1C,wHAAwH;IACxH,OAAO,EAAE,oBAAoB,CAAC;IAC9B,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAqFF,uGAAuG;AACvG,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,6BAA6B,GAAG,SAAS,CAgK9F"}