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 { promises as fs } from "node:fs";
import path from "node:path";
import os from "node:os";
import { afterEach, expect, it, vi } from "vitest";
const dirs: string[] = [];
afterEach(async () => {
vi.resetModules();
delete process.env.OS_A2A_STORE;
await Promise.all(
dirs.splice(0).map((dir) => fs.rm(dir, { recursive: true, force: true })),
);
});
it("stores registered public Agent Cards in a private atomic registry", async () => {
const dir = await fs.mkdtemp(path.join(os.tmpdir(), "mso-a2a-"));
dirs.push(dir);
process.env.OS_A2A_STORE = path.join(dir, "private", "agents.json");
const client = await import("./client");
vi.spyOn(client, "discoverA2AAgent").mockResolvedValue({
cardUrl: "https://agent.example/.well-known/agent-card.json",
selectedInterface: {
url: "https://agent.example/a2a",
protocolBinding: "JSONRPC",
protocolVersion: "1.0",
},
card: {
name: "Research Agent",
description: "Research",
version: "1",
supportedInterfaces: [
{
url: "https://agent.example/a2a",
protocolBinding: "JSONRPC",
protocolVersion: "1.0",
},
],
capabilities: {},
defaultInputModes: ["text/plain"],
defaultOutputModes: ["text/plain"],
skills: [],
securityRequirements: [],
securitySchemeNames: [],
requiresAuthentication: false,
},
});
const store = await import("./store");
const registered = await store.registerA2AAgent(
"https://agent.example",
"research",
);
expect(registered.alias).toBe("research");
expect(await store.listA2AAgents()).toHaveLength(1);
const registry = JSON.parse(await fs.readFile(process.env.OS_A2A_STORE, "utf8"));
registry.agents[0].credentialProfileId = "stored-owner-credential";
await fs.writeFile(process.env.OS_A2A_STORE, JSON.stringify(registry), { mode: 0o600 });
vi.mocked(client.discoverA2AAgent).mockClear();
for (const scope of ["read", "write"] as const) await expect(store.resolveA2AAgent("research", scope)).rejects.toThrow(/exec authority/);
expect(client.discoverA2AAgent).not.toHaveBeenCalled();
expect((await store.resolveA2AAgent("research", "exec")).credentialProfileId).toBe("stored-owner-credential");
const stat = await fs.stat(process.env.OS_A2A_STORE);
expect(stat.mode & 0o777).toBe(0o600);
expect(
(await fs.stat(path.dirname(process.env.OS_A2A_STORE))).mode & 0o777,
).toBe(0o700);
expect(await store.removeA2AAgent("research")).toBe(true);
expect(await store.listA2AAgents()).toHaveLength(0);
});