staff-mcp 1.2.0 → 2.0.0

package/dist/src/file-manager/extension.js

@@ -0,0 +1,514 @@
+import * as fs from 'node:fs/promises';
+import { createHash } from 'node:crypto';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+import { z } from 'zod';
+import { ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ReadResourceRequestSchema, SubscribeRequestSchema, UnsubscribeRequestSchema, McpError, } from '@modelcontextprotocol/sdk/types.js';
+import { FileError, fileError, fail, mimeType, utf8, relativePath, } from './file-core.js';
+import { TransferManager } from './transfers.js';
+import { APPS, DATA, FILES, TERMINAL, parse as parseExtension, operationId, supports, } from '../extensions/protocol.js';
+import { FILE_MANAGER } from '../extensions/apps.js';
+const RESOURCE_LIMIT = 256 * 1024;
+const pathField = z.string();
+const rootPath = { rootId: z.string().default('main'), path: pathField };
+const expected = z.string().min(1).optional();
+const params = {
+    roots: z.object({}).strict(),
+    list: z
+        .object({
+        ...rootPath,
+        path: pathField.default(''),
+        cursor: z.string().optional(),
+        limit: z.number().int().min(1).max(500).default(100),
+    })
+        .strict(),
+    stat: z
+        .object({ ...rootPath, includeVersion: z.boolean().default(false) })
+        .strict(),
+    readText: z.object(rootPath).strict(),
+    saveText: z
+        .object({
+        ...rootPath,
+        text: z.string(),
+        expectedVersion: z.string().min(1),
+    })
+        .strict(),
+    createFile: z
+        .object({ ...rootPath, text: z.string().default('') })
+        .strict(),
+    mkdir: z.object(rootPath).strict(),
+    move: z
+        .object({
+        rootId: z.string(),
+        from: pathField,
+        to: pathField,
+        expectedVersion: expected,
+    })
+        .strict(),
+    delete: z
+        .object({
+        ...rootPath,
+        recursive: z.boolean().default(false),
+        expectedVersion: expected,
+    })
+        .strict(),
+};
+function parse(schema, data) {
+    const parsed = schema.safeParse(data ?? {});
+    if (!parsed.success)
+        throw new FileError('INVALID_PARAMS', parsed.error.issues
+            .map((issue) => `${issue.path.join('.') || 'params'}: ${issue.message}`)
+            .join('; '), -32602);
+    return parsed.data;
+}
+function rpc(error) {
+    if (error instanceof McpError)
+        return error;
+    const e = fileError(error);
+    return new McpError(e.rpcCode, e.message, { code: e.code });
+}
+export function resourceUri(rootId, file) {
+    relativePath(file);
+    return `staff-file://${rootId}/${file.split('/').map(encodeURIComponent).join('/')}`;
+}
+function resource(uri) {
+    const match = /^staff-file:\/\/([a-z0-9-]+)\/(.*)$/.exec(uri);
+    if (!match)
+        throw new FileError('INVALID_URI', 'Invalid staff file resource URI', -32602);
+    let components;
+    try {
+        components = match[2]
+            .split('/')
+            .map((component) => decodeURIComponent(component));
+    }
+    catch {
+        throw new FileError('INVALID_URI', 'Invalid URI encoding', -32602);
+    }
+    // Decode exactly once, per component: encoded separators cannot create new
+    // components. Double-encoded '%' names remain literal filesystem names.
+    if (components.some((component) => component.includes('/')))
+        throw new FileError('INVALID_URI', 'Encoded separators are not accepted', -32602);
+    const file = relativePath(components.join('/'));
+    if (resourceUri(match[1], file) !== uri)
+        throw new FileError('INVALID_URI', 'Resource URI must use canonical component encoding', -32602);
+    return { rootId: match[1], file };
+}
+/** One instance per physical transport generation; no negotiation or handles survive reconnect. */
+export class FileManagerSession {
+    server;
+    transfers;
+    initialized = false;
+    closed = false;
+    negotiated = new Set();
+    constructor(core, server, runtimeDirectory, requireData) {
+        this.server = server;
+        this.transfers = new TransferManager(core, runtimeDirectory, () => {
+            this.requireExtension();
+            requireData();
+        });
+    }
+    initialize() {
+        if (this.closed || this.initialized)
+            return;
+        for (const extension of [APPS, FILES, TERMINAL, DATA]) {
+            if (supports(this.server, extension))
+                this.negotiated.add(extension);
+        }
+        this.initialized = true;
+    }
+    supports(extension) {
+        return (!this.closed && this.initialized && this.negotiated.has(extension));
+    }
+    requireExtension(extension = FILES) {
+        if (!this.supports(extension))
+            fail('CAPABILITY_UNAVAILABLE', 'Extension version 1 is unavailable on this initialized session');
+    }
+    close() {
+        this.closed = true;
+        this.initialized = false;
+        return this.transfers.close();
+    }
+}
+/** Standard MCP resources work without creating optional extension sessions. */
+export function registerFileResources(server, core, readApp) {
+    const protocol = server.server;
+    const subscriptions = new Set();
+    let closed = false;
+    let initialized = false;
+    const previousInitialized = protocol.oninitialized;
+    protocol.oninitialized = () => {
+        initialized = true;
+        previousInitialized?.();
+    };
+    const guarded = (handler) => async (request, extra) => {
+        try {
+            if (extra?.signal?.aborted)
+                fail('STALE_CONNECTION', 'Request connection closed');
+            return await handler(request);
+        }
+        catch (e) {
+            throw rpc(e);
+        }
+    };
+    const notify = (rootId, changedPath) => {
+        if (closed || !initialized)
+            return;
+        for (const uri of subscriptions) {
+            const entry = resource(uri);
+            if (entry.rootId !== rootId)
+                continue;
+            if (entry.file === changedPath ||
+                entry.file.startsWith(`${changedPath}/`) ||
+                entry.file === '' ||
+                changedPath.startsWith(`${entry.file}/`))
+                void server.server.sendResourceUpdated({ uri }).catch(() => { });
+        }
+    };
+    protocol.setRequestHandler(ListResourcesRequestSchema, guarded(async (request) => {
+        const entries = [];
+        for (const root of core.roots().roots) {
+            entries.push({
+                uri: resourceUri(root.rootId, ''),
+                name: root.name,
+                mimeType: 'application/json',
+            });
+            let cursor;
+            do {
+                const listing = await core.list(root.rootId, '', cursor, 500);
+                for (const child of listing.entries) {
+                    if (child.type === 'file')
+                        entries.push({
+                            uri: resourceUri(root.rootId, child.path),
+                            name: `${root.name}/${child.name}`,
+                            mimeType: mimeType(child.path),
+                        });
+                }
+                cursor = listing.nextCursor;
+            } while (cursor);
+        }
+        const version = createHash('sha256')
+            .update(JSON.stringify(entries))
+            .digest('hex');
+        let offset = 0;
+        if (request.params?.cursor) {
+            try {
+                const cursor = JSON.parse(Buffer.from(request.params.cursor, 'base64url').toString('utf8'));
+                if (cursor.version !== version ||
+                    !Number.isSafeInteger(cursor.offset) ||
+                    cursor.offset < 0 ||
+                    cursor.offset >= entries.length)
+                    fail('INVALID_CURSOR', 'Resource list changed; refresh');
+                offset = cursor.offset;
+            }
+            catch {
+                fail('INVALID_CURSOR', 'Invalid resource cursor; refresh');
+            }
+        }
+        return {
+            resources: entries.slice(offset, offset + 100),
+            ...(offset + 100 < entries.length
+                ? {
+                    nextCursor: Buffer.from(JSON.stringify({ version, offset: offset + 100 })).toString('base64url'),
+                }
+                : {}),
+        };
+    }));
+    protocol.setRequestHandler(ListResourceTemplatesRequestSchema, guarded(async (request) => {
+        if (request.params?.cursor)
+            fail('INVALID_CURSOR', 'Resource templates have no further pages');
+        return {
+            resourceTemplates: core.roots().roots.map((root) => ({
+                uriTemplate: `staff-file://${root.rootId}/{+path}`,
+                name: `${root.name} files`,
+                description: 'Actual root-relative files (256 KiB maximum) or directory manifests. Encode each path component once.',
+            })),
+        };
+    }));
+    protocol.setRequestHandler(ReadResourceRequestSchema, guarded(async (request) => {
+        const uri = request.params.uri;
+        const app = await readApp?.(uri);
+        if (app)
+            return app;
+        const entry = resource(uri);
+        const full = await core.resolve(entry.rootId, entry.file);
+        if ((await fs.lstat(full)).isDirectory()) {
+            const listing = await core.list(entry.rootId, entry.file);
+            const text = JSON.stringify({
+                rootId: entry.rootId,
+                path: entry.file,
+                ...listing,
+            });
+            if (Buffer.byteLength(text) > RESOURCE_LIMIT)
+                fail('TOO_LARGE', 'Resource limit is 256 KiB');
+            return {
+                contents: [{ uri, mimeType: 'application/json', text }],
+            };
+        }
+        const bytes = await core.readBytes(entry.rootId, entry.file, RESOURCE_LIMIT);
+        const type = mimeType(entry.file);
+        let text;
+        try {
+            text = utf8(bytes);
+        }
+        catch (e) {
+            if (!(e instanceof FileError && e.code === 'BINARY_FILE'))
+                throw e;
+        }
+        const textual = type.startsWith('text/') ||
+            ['application/json', 'image/svg+xml'].includes(type);
+        if (textual && text === undefined)
+            fail('BINARY_FILE', 'Text resource is not valid UTF-8');
+        const binary = type.startsWith('image/') && type !== 'image/svg+xml';
+        return {
+            contents: [
+                text !== undefined && !binary
+                    ? {
+                        uri,
+                        mimeType: type === 'application/octet-stream'
+                            ? 'text/plain'
+                            : type,
+                        text,
+                    }
+                    : {
+                        uri,
+                        mimeType: type,
+                        blob: bytes.toString('base64'),
+                    },
+            ],
+        };
+    }));
+    protocol.setRequestHandler(SubscribeRequestSchema, guarded(async (request) => {
+        const entry = resource(request.params.uri);
+        await core.resolve(entry.rootId, entry.file);
+        if (closed)
+            fail('STALE_CONNECTION', 'Resource subscription connection closed');
+        subscriptions.add(request.params.uri);
+        return {};
+    }));
+    protocol.setRequestHandler(UnsubscribeRequestSchema, guarded(async (request) => {
+        resource(request.params.uri);
+        subscriptions.delete(request.params.uri);
+        return {};
+    }));
+    const connect = server.connect.bind(server);
+    server.connect = async (transport) => {
+        closed = false;
+        initialized = false;
+        core.listeners.add(notify);
+        const cleanup = () => {
+            closed = true;
+            initialized = false;
+            subscriptions.clear();
+            core.listeners.delete(notify);
+        };
+        const previousClose = transport.onclose;
+        transport.onclose = () => {
+            cleanup();
+            previousClose?.();
+        };
+        try {
+            await connect(transport);
+        }
+        catch (error) {
+            cleanup();
+            throw error;
+        }
+        if (server.server.transport !== transport)
+            cleanup();
+    };
+}
+export function registerFileManager(server, core, runtimeDirectory) {
+    let session;
+    const protocol = server.server;
+    const previousInitialized = protocol.oninitialized;
+    protocol.oninitialized = () => {
+        session?.initialize();
+        previousInitialized?.();
+    };
+    function current() {
+        if (!session || session.closed)
+            fail('EXTENSION_NOT_NEGOTIATED', 'No initialized file-manager session');
+        return session;
+    }
+    function requireExtension(extension = FILES) {
+        current().requireExtension(extension);
+    }
+    const guarded = (handler) => async (request, extra) => {
+        try {
+            if (extra?.signal?.aborted)
+                fail('STALE_CONNECTION', 'Request connection closed');
+            return await handler(request);
+        }
+        catch (e) {
+            throw rpc(e);
+        }
+    };
+    async function extensionCall(method, input) {
+        requireExtension();
+        // Separate parse calls preserve the exact shape/types for every public method.
+        switch (method) {
+            case 'roots':
+                parse(params.roots, input);
+                return core.roots();
+            case 'list': {
+                const p = parse(params.list, input);
+                return core.list(p.rootId, p.path, p.cursor, p.limit);
+            }
+            case 'stat': {
+                const p = parse(params.stat, input);
+                return core.stat(p.rootId, p.path, p.includeVersion);
+            }
+            case 'readText': {
+                const p = parse(params.readText, input);
+                return core.readText(p.rootId, p.path);
+            }
+            case 'saveText': {
+                const p = parse(params.saveText, input);
+                return core.saveText(p.rootId, p.path, p.text, p.expectedVersion);
+            }
+            case 'createFile': {
+                const p = parse(params.createFile, input);
+                return core.createFile(p.rootId, p.path, p.text);
+            }
+            case 'mkdir': {
+                const p = parse(params.mkdir, input);
+                return core.mkdir(p.rootId, p.path);
+            }
+            case 'move': {
+                const p = parse(params.move, input);
+                return core.move(p.rootId, p.from, p.to, p.expectedVersion);
+            }
+            case 'delete': {
+                const p = parse(params.delete, input);
+                return core.delete(p.rootId, p.path, p.recursive, p.expectedVersion);
+            }
+        }
+    }
+    for (const method of Object.keys(params)) {
+        protocol.setRequestHandler(z.object({
+            method: z.literal(`${FILE_MANAGER}/${method}`),
+            params: z.unknown().optional(),
+        }), guarded(async (request) => extensionCall(method, request.params)));
+    }
+    const digest = z.string().regex(/^[a-f0-9]{64}$/);
+    const transferParams = {
+        roots: z.object({}).strict(),
+        resolve: z.object({ uri: z.string().min(1).max(8192) }).strict(),
+        stat: z
+            .object({
+            rootId: z.string().min(1),
+            path: z.string().min(1),
+        })
+            .strict(),
+        prepare: z
+            .object({
+            operationId,
+            mode: z.enum(['read', 'write']),
+            rootId: z.string().min(1),
+            path: z.string().min(1),
+            size: z
+                .number()
+                .int()
+                .nonnegative()
+                .safe()
+                .max(100 * 1024 * 1024)
+                .optional(),
+            sha256: digest.optional(),
+            overwrite: z.boolean().optional(),
+            expectedVersion: expected,
+        })
+            .strict(),
+        status: z.object({ operationId }).strict(),
+        commit: z
+            .object({
+            operationId,
+            transferId: z.string().min(1),
+            sha256: digest,
+        })
+            .strict(),
+        cancel: z.object({ operationId }).strict(),
+        release: z.object({ operationId }).strict(),
+        renew: z.object({ operationId }).strict(),
+    };
+    async function resolveUri(uri) {
+        let url;
+        let full;
+        try {
+            url = new URL(uri);
+            if (url.protocol !== 'file:' ||
+                (url.hostname && url.hostname !== 'localhost') ||
+                url.search ||
+                url.hash ||
+                url.username ||
+                url.password ||
+                url.port)
+                fail('INVALID_PARAMS', 'Expected a local file URI');
+            full = fileURLToPath(url);
+        }
+        catch {
+            return fail('INVALID_PARAMS', 'Expected a local file URI');
+        }
+        // Longest matching root is deterministic for overlapping allowed directories.
+        const roots = core
+            .roots()
+            .roots.map((root) => core.root(root.rootId))
+            .sort((a, b) => b.directory.length - a.directory.length);
+        for (const root of roots) {
+            const relative = path.relative(root.directory, full);
+            if (path.isAbsolute(relative) ||
+                relative === '..' ||
+                relative.startsWith(`..${path.sep}`))
+                continue;
+            const file = relative.split(path.sep).join('/');
+            // Resolve again through FileCore: no relaxation of symlink/private-area checks.
+            await core.resolve(root.rootId, file, { missing: true });
+            return { rootId: root.rootId, path: file };
+        }
+        return fail('OUTSIDE_ROOT', 'File URI is outside allowed roots');
+    }
+    for (const method of Object.keys(transferParams)) {
+        protocol.setRequestHandler(z.object({
+            method: z.literal(`${FILES}/v1/${method}`),
+            params: z.unknown().optional(),
+        }), guarded(async (request) => {
+            requireExtension();
+            const transfers = current().transfers;
+            switch (method) {
+                case 'roots':
+                    parseExtension(transferParams.roots, request.params);
+                    return core.roots();
+                case 'resolve':
+                    return resolveUri(parseExtension(transferParams.resolve, request.params).uri);
+                case 'stat': {
+                    const p = parseExtension(transferParams.stat, request.params);
+                    const stat = await core.stat(p.rootId, p.path, true);
+                    if (!stat.operations.read || stat.version === undefined)
+                        fail('NOT_FILE', 'Expected a regular file');
+                    return { version: stat.version };
+                }
+                case 'prepare':
+                    return transfers.prepare(parseExtension(transferParams.prepare, request.params));
+                case 'status':
+                    return transfers.status(parseExtension(transferParams.status, request.params).operationId);
+                case 'commit': {
+                    const p = parseExtension(transferParams.commit, request.params);
+                    return transfers.commit(p.operationId, p.transferId, p.sha256);
+                }
+                case 'renew':
+                    return transfers.renew(parseExtension(transferParams.renew, request.params)
+                        .operationId);
+                case 'cancel':
+                    return transfers.release(parseExtension(transferParams.cancel, request.params).operationId);
+                case 'release':
+                    return transfers.release(parseExtension(transferParams.release, request.params).operationId);
+            }
+        }));
+    }
+    return (requireData) => {
+        if (session && !session.closed)
+            throw new Error('Previous file-manager transport is still connected');
+        session = new FileManagerSession(core, server, runtimeDirectory, requireData);
+        return session;
+    };
+}
+//# sourceMappingURL=extension.js.map

package/dist/src/file-manager/extension.js.map

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

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

@@ -0,0 +1,128 @@
+export declare const TEXT_LIMIT: number;
+export declare const FILE_LIMIT: number;
+export declare const CHUNK_LIMIT: number;
+export declare class FileError extends Error {
+    code: string;
+    rpcCode: number;
+    constructor(code: string, message: string, rpcCode?: number);
+}
+export declare function fail(code: string, message: string): never;
+export declare function fileError(error: unknown): FileError;
+export declare class Mutex {
+    private tail;
+    run<T>(fn: () => Promise<T>): Promise<T>;
+}
+export interface Root {
+    rootId: string;
+    name: string;
+    readOnly: boolean;
+    directory: string;
+}
+export interface Entry {
+    name: string;
+    path: string;
+    type: 'file' | 'directory' | 'symlink';
+    size: number;
+    mtime: string;
+}
+export declare function relativePath(value: string): string;
+export declare function mimeType(file: string): string;
+export declare function utf8(bytes: Uint8Array): string;
+export declare function secureDirectory(directory: string): Promise<void>;
+export declare class FileCore {
+    readonly mutex: Mutex;
+    private readonly changes;
+    private readonly publications;
+    private readonly privateDirectories;
+    readonly listeners: Set<(rootId: string, changedPath: string) => void>;
+    constructor(roots: Root[], privateDirectory?: string, shared?: FileCore, privateDirectoryAliases?: string[]);
+    private readonly rootMap;
+    roots(): {
+        roots: {
+            rootId: string;
+            name: string;
+            readOnly: boolean;
+        }[];
+    };
+    root(id: string, write?: boolean): Root;
+    resolve(rootId: string, input: string, options?: {
+        write?: boolean;
+        missing?: boolean;
+        allowLeafLink?: boolean;
+    }): Promise<string>;
+    private changed;
+    private notifyChanged;
+    private checkPrivate;
+    private protectRoots;
+    /** Standard tools retain their path and result contracts, but share the extension's lock. */
+    validateToolPath(full: string, missingParents?: boolean): Promise<string>;
+    withWriteLock<T>(task: () => Promise<T>): Promise<T>;
+    toolWrite<T>(full: string, task: () => Promise<T>, missingParents?: boolean): Promise<T>;
+    private hashFile;
+    private version;
+    stat(rootId: string, file: string, includeVersion?: boolean): Promise<{
+        readOnly: boolean;
+        mimeType: string;
+        operations: {
+            read: boolean;
+            write: boolean;
+            delete: boolean;
+            move: boolean;
+        };
+        version?: string | undefined;
+        path: string;
+        type: string;
+        size: number;
+        mtime: string;
+    }>;
+    list(rootId: string, file: string, cursor?: string, limit?: number): Promise<{
+        nextCursor?: string | undefined;
+        entries: Entry[];
+    }>;
+    readBytes(rootId: string, file: string, max?: number): Promise<Buffer<ArrayBuffer>>;
+    readText(rootId: string, file: string, max?: number): Promise<{
+        text: string;
+        encoding: string;
+        version: string;
+        size: number;
+    }>;
+    checkDestination(rootId: string, file: string, overwrite?: boolean, expectedVersion?: string): Promise<{
+        full: string;
+        exists: boolean;
+        mode: number | undefined;
+    }>;
+    private atomic;
+    saveText(rootId: string, file: string, text: string, expectedVersion: string): Promise<{
+        path: string;
+        version: string;
+        size: number;
+    }>;
+    createFile(rootId: string, file: string, text?: string): Promise<{
+        path: string;
+        version: string;
+        size: number;
+    }>;
+    commitUpload(rootId: string, file: string, source: string, overwrite: boolean, expectedVersion?: string, sourceVersion?: string): Promise<{
+        path: string;
+        version: string;
+        size: number;
+    }>;
+    mkdir(rootId: string, file: string): Promise<{
+        path: string;
+        version: string;
+    }>;
+    move(rootId: string, from: string, to: string, expectedVersion?: string): Promise<{
+        path: string;
+        version: string;
+    }>;
+    private validateTree;
+    delete(rootId: string, file: string, recursive?: boolean, expectedVersion?: string): Promise<{
+        deleted: boolean;
+        path: string;
+    }>;
+    snapshot(rootId: string, file: string, destination: string): Promise<{
+        name: string;
+        size: number;
+        version: string;
+    }>;
+}