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 { expect, it } from "vitest";
import {
a2aAgentCardUrl,
cancelA2ATask,
discoverA2AAgent,
getA2ATask,
MAX_A2A_MESSAGE_BYTES,
MAX_A2A_RESPONSE_BYTES,
sendA2AMessage,
} from "./client";
const card = (binding = "JSONRPC") => ({
name: "Research Agent",
description: "Finds concise answers",
version: "1.2.0",
capabilities: { streaming: false },
supportedInterfaces: [
{
url: "https://agent.example.test/a2a",
protocolBinding: binding,
protocolVersion: "1.0",
tenant: "research",
},
],
defaultInputModes: ["text/plain"],
defaultOutputModes: ["text/plain"],
skills: [
{
id: "research",
name: "Research",
description: "Research topics",
tags: ["web"],
},
],
});
function response(value: unknown) {
return new Response(JSON.stringify(value), {
status: 200,
headers: { "content-type": "application/json" },
});
}
it("discovers the standard well-known v1 Agent Card and selects JSONRPC", async () => {
let seen = "";
const agent = await discoverA2AAgent(
"https://agent.example.test/a2a",
async (input) => {
seen = String(input);
return response(card());
},
);
expect(seen).toBe("https://agent.example.test/.well-known/agent-card.json");
expect(agent.card.name).toBe("Research Agent");
expect(agent.selectedInterface.protocolBinding).toBe("JSONRPC");
});
it("sends v1 JSONRPC SendMessage with tenant and member-discriminated text parts", async () => {
const calls: Array<{ url: string; init?: RequestInit }> = [];
const fetcher = async (input: RequestInfo | URL, init?: RequestInit) => {
calls.push({ url: String(input), init });
return calls.length === 1
? response(card())
: response({ jsonrpc: "2.0", id: "x", result: { task: { id: "t-1" } } });
};
const agent = await discoverA2AAgent("https://agent.example.test", fetcher);
const result = (await sendA2AMessage(
agent,
"Do the research",
{ returnImmediately: true },
fetcher,
)) as { task: { id: string } };
const body = JSON.parse(String(calls[1].init?.body));
expect(body.method).toBe("SendMessage");
expect(body.params.tenant).toBe("research");
expect(body.params.message.role).toBe("ROLE_USER");
expect(body.params.message.parts).toEqual([
{ text: "Do the research", mediaType: "text/plain" },
]);
expect(body.params.message.parts[0]).not.toHaveProperty("kind");
expect(result.task.id).toBe("t-1");
});
it("uses v1 HTTP+JSON operation paths for send/get/cancel including tenant", async () => {
const calls: Array<{ url: string; init?: RequestInit }> = [];
const fetcher = async (input: RequestInfo | URL, init?: RequestInit) => {
calls.push({ url: String(input), init });
return calls.length === 1
? response(card("HTTP+JSON"))
: response({ task: { id: "t-1" } });
};
const agent = await discoverA2AAgent("https://agent.example.test", fetcher);
await sendA2AMessage(agent, "go", {}, fetcher);
await getA2ATask(agent, "t-1", 4, fetcher);
await cancelA2ATask(agent, "t-1", fetcher);
expect(calls[1].url).toBe("https://agent.example.test/a2a/message:send");
expect(JSON.parse(String(calls[1].init?.body)).tenant).toBe("research");
expect(calls[2].url).toBe(
"https://agent.example.test/a2a/tasks/t-1?tenant=research&historyLength=4",
);
expect(calls[3].url).toBe("https://agent.example.test/a2a/tasks/t-1:cancel");
expect(JSON.parse(String(calls[3].init?.body))).toEqual({
tenant: "research",
});
});
it("fails closed when the Agent Card requires authentication", async () => {
const secured = {
...card(),
securityRequirements: [{ oauth: { scopes: ["agent"] } }],
securitySchemes: { oauth: { oauth2SecurityScheme: {} } },
};
const fetcher = async () => response(secured);
const agent = await discoverA2AAgent("https://agent.example.test", fetcher);
await expect(
sendA2AMessage(agent, "secret work", {}, fetcher),
).rejects.toThrow("credential profiles are not configured");
});
it("rejects insecure/private targets before any A2A network call", () => {
expect(() => a2aAgentCardUrl("http://agent.example.com")).toThrow(/HTTPS/);
expect(() => a2aAgentCardUrl("https://127.0.0.1:9999")).toThrow(
/host not allowed/i,
);
});
it("rejects peers that advertise only pre-v1 interfaces", async () => {
const legacy = {
...card(),
supportedInterfaces: [
{
url: "https://agent.example.test/a2a",
protocolBinding: "JSONRPC",
protocolVersion: "0.3",
},
],
};
await expect(
discoverA2AAgent("https://agent.example.test", async () =>
response(legacy),
),
).rejects.toThrow(/no supported v1/i);
});
it("bounds Agent Card/remote response bytes and outbound message bytes", async () => {
const oversized = new Response("{}", {
status: 200,
headers: { "content-length": String(MAX_A2A_RESPONSE_BYTES + 1) },
});
await expect(
discoverA2AAgent("https://agent.example.test", async () => oversized),
).rejects.toThrow(/response exceeds/);
const agent = await discoverA2AAgent("https://agent.example.test", async () =>
response(card()),
);
await expect(
sendA2AMessage(agent, "x".repeat(MAX_A2A_MESSAGE_BYTES + 1), {}, async () =>
response({}),
),
).rejects.toThrow(/message exceeds/);
});