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.
TypeScript browser-shellcontrol-planefile-managerhomelabmobile-firstnextjsptyreactself-hostedserver-managementshadcn-uisysadmintailwindcssterminaltypescriptvpsweb-desktopweb-terminal
import { afterEach, beforeEach, describe, expect, it } from "vitest";
import { SURFACE_TOOLS } from "./tools-surface";
const tool = (name: string) => {
const value = SURFACE_TOOLS.find((row) => row.name === name);
if (!value) throw new Error(`missing ${name}`);
return value;
};
describe("MSO Page MCP tools", () => {
beforeEach(() => { process.env.MSO_SURFACE_APPS_JSON = JSON.stringify([{ id: "demo", title: "Demo", description: "Configured demo", origin: "https://demo.example.test", startPath: "/embed", renderer: "remote", presentation: "inline", environment: "production", sandbox: "allow-scripts allow-same-origin" }]); });
afterEach(() => { delete process.env.MSO_SURFACE_APPS_JSON; });
it("returns only the server-reviewed public app catalog", async () => {
const result = await tool("mso_surface_apps_list").run({}, { scope: "read" }) as { apps: Array<Record<string, unknown>> };
expect(result.apps.map((app) => app.id)).toEqual(["demo"]);
expect(result.apps[0]).toMatchObject({
title: "Demo",
origin: "https://demo.example.test",
renderer: "remote",
startPath: "/embed",
environment: "production",
});
expect(JSON.stringify(result)).not.toContain("sandbox");
expect(JSON.stringify(result)).not.toContain("<script");
});
it("renders an instance-configured target without accepting a URL argument", async () => {
const render = tool("render_mso_page");
expect(render.inputSchema.properties).not.toHaveProperty("url");
expect(render.inputSchema.properties).not.toHaveProperty("html");
const result = await render.run({ route: "/apps/demo" }, { scope: "read" }) as { app?: Record<string, unknown> };
expect(result.app).toMatchObject({
id: "demo",
renderer: "remote",
presentation: "inline",
origin: "https://demo.example.test",
startPath: "/embed",
environment: "production",
url: "https://demo.example.test/embed",
});
expect(result.app).not.toHaveProperty("sandbox");
expect((render.meta?.ui as { resourceUri?: string }).resourceUri).toMatch(/^ui:\/\/mso\/page-v16\.html$/);
expect(render.meta?.["ui/resourceUri"]).toBe((render.meta?.ui as { resourceUri?: string }).resourceUri);
expect(render.meta?.["openai/outputTemplate"]).toBeUndefined();
});
it("keeps scanner-facing Page metadata generic", () => {
const render = tool("render_mso_page");
const metadata = JSON.stringify({ description: render.description, chatgptDescription: render.chatgptDescription });
expect(metadata).toContain("<configured-app-id>");
expect(metadata.toLowerCase()).not.toMatch(/rahmanef|antinrml/);
});
it("keeps project identity separate from the route string", async () => {
const result = await tool("render_mso_page").run({ route: "/project", project: "mso" }, { scope: "read" });
expect(result).toMatchObject({ route: "/project", kind: "project", project: "mso", openPath: "/files" });
});
it("uses only the standard resource binding for Page tools", () => {
for (const name of ["render_mso_page", "integration_setup_open"] as const) {
const value = tool(name);
expect((value.meta?.ui as { resourceUri?: string }).resourceUri).toMatch(/^ui:\/\/mso\/page-v16\.html$/);
expect(value.meta?.["ui/resourceUri"]).toBe((value.meta?.ui as { resourceUri?: string }).resourceUri);
expect(value.meta?.["openai/outputTemplate"]).toBeUndefined();
}
});
it("retains an app-only compatibility alias without another UI resource binding", async () => {
const legacy = tool("render_mso_surface");
expect(legacy.meta).toMatchObject({ ui: { visibility: ["app"] }, "openai/widgetAccessible": true });
expect((legacy.meta?.ui as { resourceUri?: string }).resourceUri).toBeUndefined();
const result = await legacy.run({ route: "/monitor" }, { scope: "read" });
expect(result).toMatchObject({ route: "/monitor", kind: "monitor", title: "System Monitor" });
});
});