staff-mcp 1.2.0 → 2.0.0

package/dist/src/extensions/runtime.js

@@ -0,0 +1,266 @@
+import { McpError } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import { DATA_OPEN_METHOD } from '../data/HttpDataSession.js';
+import { FileError } from '../file-manager/file-core.js';
+import { registerFileManager } from '../file-manager/extension.js';
+import { TerminalSession } from '../terminal/session.js';
+import { registerTerminal } from '../terminal/extension.js';
+import { DATA, FILES, TERMINAL, STREAMS, APPS, supports, extensionError, parse, } from './protocol.js';
+import { registerApps } from './apps.js';
+import { registerServerCleanup } from '../utils/server-lifecycle.js';
+import { registerServerActivity } from '../utils/server-activity.js';
+const dataFactories = new WeakMap();
+/** Configure before connect; the factory runs only on a negotiated data/v1/configure. */
+export function configureExtensionData(server, factory) {
+    dataFactories.set(server, factory);
+}
+/** Attach business lifecycle only. The official SDK receives the original transport unchanged. */
+export function installExtensions(server, core, transferDirectory, workspaceCore, terminalRuntime) {
+    let terminalSession;
+    let openData;
+    let configureData;
+    let initialized = false;
+    const enabled = new Set([
+        APPS,
+        DATA,
+        ...(core ? [FILES] : []),
+        ...(terminalRuntime ? [STREAMS] : []),
+    ]);
+    const negotiated = (extension) => initialized && enabled.has(extension) && supports(server, extension);
+    const requireExtension = (extension) => {
+        if (!negotiated(extension))
+            extensionError('CAPABILITY_UNAVAILABLE', 'Extension version 1 is unavailable on this initialized session');
+    };
+    const createFileSession = core
+        ? registerFileManager(server, core, transferDirectory)
+        : undefined;
+    const previousInitialized = server.server.oninitialized;
+    server.server.oninitialized = () => {
+        initialized = true;
+        previousInitialized?.();
+    };
+    registerApps(server, requireExtension, () => !!terminalSession, negotiated);
+    if (terminalRuntime)
+        registerTerminal(server, () => {
+            requireExtension(STREAMS);
+            return terminalSession;
+        });
+    for (const method of ['cc.qqxing/data/v1/configure', DATA_OPEN_METHOD]) {
+        server.server.setRequestHandler(z.object({
+            method: z.literal(method),
+            params: z.unknown().optional(),
+        }), async (request, extra) => {
+            if (extra.signal.aborted)
+                extensionError('STALE_CONNECTION', 'Data request connection closed');
+            try {
+                requireExtension(DATA);
+                const handler = method === DATA_OPEN_METHOD ? openData : configureData;
+                if (!handler)
+                    extensionError('STALE_CONNECTION', 'No active data connection');
+                return await handler(request.params);
+            }
+            catch (error) {
+                if (error instanceof FileError)
+                    throw new McpError(error.rpcCode, error.message, {
+                        code: error.code,
+                    });
+                throw error;
+            }
+        });
+    }
+    const connect = server.connect.bind(server);
+    server.connect = async (transport) => {
+        let closed = false;
+        initialized = false;
+        const lifetime = new AbortController();
+        let data;
+        const currentData = () => {
+            if (closed || !data)
+                extensionError('CAPABILITY_UNAVAILABLE', 'Data session has not been configured');
+            return data.session;
+        };
+        const files = createFileSession?.(() => {
+            requireExtension(DATA);
+            const session = currentData();
+            if (!session.supports(FILES, 'host-to-remote') ||
+                !session.supports(FILES, 'remote-to-host'))
+                extensionError('CAPABILITY_UNAVAILABLE', 'Files data session is unavailable');
+        });
+        const terminal = terminalRuntime
+            ? new TerminalSession(workspaceCore, terminalRuntime, () => {
+                requireExtension(STREAMS);
+                requireExtension(DATA);
+                if (!currentData().supports(TERMINAL, 'duplex'))
+                    extensionError('CAPABILITY_UNAVAILABLE', 'Terminal data session is unavailable');
+            })
+            : undefined;
+        terminalSession = terminal;
+        const accept = async (open, channel) => {
+            requireExtension(DATA);
+            if (open.purpose === FILES && files) {
+                requireExtension(FILES);
+                return files.transfers.acceptChannel(open, channel);
+            }
+            if (open.purpose === TERMINAL && terminal) {
+                requireExtension(STREAMS);
+                return terminal.acceptChannel(open, channel);
+            }
+            return extensionError('CAPABILITY_UNAVAILABLE', 'Unsupported data channel purpose');
+        };
+        const supportsPurpose = (purpose) => !closed &&
+            negotiated(DATA) &&
+            ((purpose === FILES && !!files && negotiated(FILES)) ||
+                (purpose === TERMINAL && !!terminal && negotiated(STREAMS)));
+        let configurationAttempted = false;
+        let configuration;
+        registerServerActivity(server, () => configuration !== undefined ||
+            !!files?.transfers.hasActivity() ||
+            !!terminal?.hasActivity() ||
+            !!data?.session.hasActivity());
+        let dataCleanup;
+        const disposeData = (owned) => {
+            dataCleanup ??= (async () => {
+                try {
+                    owned.session.close();
+                }
+                finally {
+                    await owned.close?.();
+                }
+            })();
+            return dataCleanup;
+        };
+        const configure = async (params) => {
+            if (closed)
+                extensionError('STALE_CONNECTION', 'Data connection closed');
+            const { binding, origin } = parse(z
+                .object({
+                binding: z.string().regex(/^[A-Za-z0-9_-]{16,256}$/),
+                origin: z.string().max(2048).optional(),
+            })
+                .strict(), params);
+            if (origin !== undefined) {
+                let endpoint;
+                try {
+                    endpoint = new URL(origin);
+                }
+                catch {
+                    return extensionError('INVALID_PARAMS', 'Invalid data advertisement origin');
+                }
+                if (!['http:', 'https:'].includes(endpoint.protocol) ||
+                    endpoint.username ||
+                    endpoint.password ||
+                    endpoint.search ||
+                    endpoint.hash ||
+                    endpoint.origin !== origin)
+                    extensionError('INVALID_PARAMS', 'Expected an absolute HTTP(S) origin without path or credentials');
+            }
+            if (configurationAttempted)
+                extensionError('INVALID_STATE', 'Data session is already configured');
+            configurationAttempted = true;
+            const factory = dataFactories.get(server);
+            if (!factory)
+                extensionError('CAPABILITY_UNAVAILABLE', 'Data endpoint is not configured');
+            configuration = Promise.resolve().then(() => factory(binding, accept, lifetime.signal, origin, supportsPurpose));
+            try {
+                let owned;
+                try {
+                    owned = await configuration;
+                }
+                catch (error) {
+                    if (closed)
+                        extensionError('STALE_CONNECTION', 'Data connection closed during setup');
+                    // Preserve explicit parameter/protocol errors, but a runtime
+                    // endpoint failure must not take down standard MCP control.
+                    if (error instanceof McpError)
+                        throw error;
+                    console.error('[staff-mcp] Warning: Extension data unavailable: endpoint setup failed.');
+                    return extensionError('CAPABILITY_UNAVAILABLE', 'Data endpoint setup failed');
+                }
+                if (closed) {
+                    await disposeData(owned);
+                    return extensionError('STALE_CONNECTION', 'Data connection closed during setup');
+                }
+                data = owned;
+                return owned.endpoint ? { endpoint: owned.endpoint } : {};
+            }
+            finally {
+                // Keep only a pending setup, not a completed configuration receipt.
+                configuration = undefined;
+            }
+        };
+        const open = async (params) => {
+            if (closed)
+                extensionError('STALE_CONNECTION', 'Data connection closed');
+            if (!data)
+                extensionError('CAPABILITY_UNAVAILABLE', 'Data session has not been configured');
+            // Reject disabled/unnegotiated purposes before the data core allocates a channel.
+            const { open } = parse(z
+                .object({
+                open: z.object({ purpose: z.string() }).passthrough(),
+            })
+                .passthrough(), params);
+            if (!supportsPurpose(open.purpose))
+                extensionError('CAPABILITY_UNAVAILABLE', 'Unsupported data channel purpose');
+            requireExtension(open.purpose === TERMINAL ? STREAMS : open.purpose);
+            return { ...(await data.session.acceptOpen(params)) };
+        };
+        configureData = configure;
+        openData = open;
+        let cleanupPromise;
+        const cleanup = () => {
+            if (cleanupPromise)
+                return cleanupPromise;
+            closed = true;
+            initialized = false;
+            lifetime.abort();
+            if (openData === open)
+                openData = undefined;
+            if (configureData === configure)
+                configureData = undefined;
+            // Fence bytes synchronously; await staging, PTYs and listener ownership
+            // together. A late configure result still belongs to this session.
+            cleanupPromise = Promise.allSettled([
+                (async () => {
+                    if (data)
+                        await disposeData(data);
+                    else if (configuration) {
+                        const owned = await configuration.catch(() => undefined);
+                        if (owned)
+                            await disposeData(owned);
+                    }
+                })(),
+                (async () => {
+                    await terminal?.close();
+                })(),
+                (async () => {
+                    await files?.close();
+                })(),
+            ]).then((results) => {
+                const errors = results
+                    .filter((result) => result.status === 'rejected')
+                    .map((result) => result.reason);
+                if (errors.length)
+                    throw new AggregateError(errors, 'Extension cleanup failed');
+            });
+            return cleanupPromise;
+        };
+        registerServerCleanup(server, cleanup);
+        try {
+            await connect(transport);
+        }
+        catch (error) {
+            const pendingCleanup = cleanup();
+            void pendingCleanup.catch(() => { });
+            await transport.close().catch(() => { });
+            // Transports may reject start without notifying the SDK.
+            if (server.server.transport === transport)
+                transport.onclose?.();
+            await pendingCleanup.catch(() => console.error('[staff-mcp] Extension cleanup failed.'));
+            throw error;
+        }
+        if (server.server.transport !== transport)
+            await cleanup();
+    };
+    return requireExtension;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/src/extensions/runtime.js.map

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

package/dist/src/file-manager/extension.d.ts

@@ -0,0 +1,21 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { FileCore } from './file-core.js';
+import { TransferManager } from './transfers.js';
+import { readAppResource } from '../extensions/apps.js';
+export declare function resourceUri(rootId: string, file: string): string;
+/** One instance per physical transport generation; no negotiation or handles survive reconnect. */
+export declare class FileManagerSession {
+    private readonly server;
+    readonly transfers: TransferManager;
+    initialized: boolean;
+    closed: boolean;
+    private readonly negotiated;
+    constructor(core: FileCore, server: McpServer, runtimeDirectory: string, requireData: () => void);
+    initialize(): void;
+    supports(extension: string): boolean;
+    requireExtension(extension?: string): void;
+    close(): Promise<void>;
+}
+/** Standard MCP resources work without creating optional extension sessions. */
+export declare function registerFileResources(server: McpServer, core: FileCore, readApp?: (uri: string) => ReturnType<typeof readAppResource>): void;
+export declare function registerFileManager(server: McpServer, core: FileCore, runtimeDirectory: string): (requireData: () => void) => FileManagerSession;