Skip to content

armgit / mso

Public Imported from GitHub
0

Browser-based graphical shell and control plane for a Linux server you own — real terminal, file manager, live metrics and BYOK AI in one mobile-first workspace. Next.js 16 · React 19 · node-pty · Tailwind v4 · shadcn/ui. Public alpha, self-hosted.

3.9 KB
Raw Blame
import { promises as fs } from "fs";
import os from "os";
import path from "path";
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { createMcpFileResource, readMcpFileResource } from "./file-transfer-resource";

const ROOT = path.join(os.tmpdir(), `mso-mcp-file-resources-${process.pid}`);
beforeEach(async () => { await fs.rm(ROOT, { recursive: true, force: true }); vi.useRealTimers(); });
afterEach(async () => { vi.restoreAllMocks(); vi.useRealTimers(); await fs.rm(ROOT, { recursive: true, force: true }); });

describe("principal-bound MCP file resources", () => {
  it("returns exact bytes only to the creating principal", async () => {
    const data = Buffer.from([0,1,2,3,255]);
    const resource = await createMcpFileResource({ data, filename: "x.bin", mimeType: "application/octet-stream", principal: "alice", sessionId: "session-a", maxReads: 3 });
    expect(resource.uri).toMatch(/^mso-file:\/\/[\/][a-f0-9]{48}$/);
    await expect(readMcpFileResource(resource.uri, "bob", "session-a")).rejects.toThrow(/unknown or expired/i);
    const read = await readMcpFileResource(resource.uri, "alice", "session-a");
    expect(read?.data).toEqual(data);
    expect(read?.sha256).toBe(resource.sha256);
  });
  it("enforces read exhaustion", async () => {
    const one = await createMcpFileResource({ data: Buffer.from("x"), filename: "x.txt", mimeType: "text/plain", principal: "alice", sessionId: "session-a", maxReads: 1 });
    expect((await readMcpFileResource(one.uri, "alice", "session-a"))?.data.toString()).toBe("x");
    await expect(readMcpFileResource(one.uri, "alice", "session-a")).rejects.toThrow(/unknown or expired/i);
  });
  it("claims concurrent reads atomically without resurrecting the allowance", async () => {
    const resource = await createMcpFileResource({ data: Buffer.from("bounded"), filename: "x.txt", mimeType: "text/plain", principal: "alice", sessionId: "session-a", maxReads: 5 });
    const burst = await Promise.allSettled(Array.from({ length: 20 }, () => readMcpFileResource(resource.uri, "alice", "session-a")));
    const completed = burst.filter(result => result.status === "fulfilled").length;
    expect(completed).toBeGreaterThan(0);
    expect(completed).toBeLessThanOrEqual(5);
    expect(burst.some(result => result.status === "rejected" && /busy/.test(String(result.reason)))).toBe(true);
    for (let remaining = completed; remaining < 5; remaining++) await readMcpFileResource(resource.uri, "alice", "session-a");
    await expect(readMcpFileResource(resource.uri, "alice", "session-a")).rejects.toThrow(/unknown or expired/);
    expect(await fs.readdir(ROOT)).toEqual([]);
  });
  it("rejects process-wide saturation before reading file bytes and releases completed claims", async () => {
    const resources = await Promise.all(Array.from({ length: 9 }, (_, index) => createMcpFileResource({
      data: Buffer.from("bounded"), filename: "x.txt", mimeType: "text/plain", principal: `reader-${index}`, sessionId: "session-a",
    })));
    const read = vi.spyOn(fs, "readFile");
    const active = resources.slice(0, 8).map((resource, index) => readMcpFileResource(resource.uri, `reader-${index}`, "session-a"));
    await expect(readMcpFileResource(resources[8].uri, "reader-8", "session-a")).rejects.toThrow(/busy/);
    expect(read.mock.calls.some(([name]) => String(name).endsWith(`${resources[8].id}.bin`))).toBe(false);
    await Promise.all(active);
    expect((await readMcpFileResource(resources[8].uri, "reader-8", "session-a"))?.data.toString()).toBe("bounded");
  });
  it("expires after its TTL", async () => {
    vi.useFakeTimers();
    const now = Date.now(); vi.setSystemTime(now);
    const expiring = await createMcpFileResource({ data: Buffer.from("y"), filename: "y.txt", mimeType: "text/plain", principal: "alice", sessionId: "session-a", ttlMs: 60_000 });
    vi.setSystemTime(now + 61_000);
    await expect(readMcpFileResource(expiring.uri, "alice", "session-a")).rejects.toThrow(/unknown or expired/i);
  });
});