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.

4.1 KB
Raw Blame
import { findOrCreateAgentSessionForConversation, getAgentSession } from "@/lib/agent/session-store";
import { newAgentSessionId } from "@/lib/agent/session-files";
import { conversationHash } from "@/lib/agent/session-policy";

const MCP_SESSION_HEADER = "Mcp-Session-Id";

type RpcLike = {
  id?: string | number | null;
  method?: string;
  _meta?: Record<string, unknown>;
  params?: { name?: string; _meta?: Record<string, unknown> };
};

export interface ResolvedMcpSession {
  responseSessionId?: string;
  agentSessionId?: string;
  conversationBound: boolean;
}

export function mcpClientMeta(rpc: RpcLike): Record<string, unknown> {
  return { ...(rpc._meta ?? {}), ...(rpc.params?._meta ?? {}) };
}

function openAiSession(rpc: RpcLike): string | undefined {
  const value = mcpClientMeta(rpc)["openai/session"];
  return typeof value === "string" && value.length > 0 && value.length <= 1024 ? value : undefined;
}

function errorResponse(rpc: RpcLike, status: number, message: string): Response {
  return Response.json({ jsonrpc: "2.0", id: rpc.id ?? null, error: { code: -32600, message } }, { status, headers: { "Cache-Control": "no-store" } });
}

export async function resolveMcpSession(req: Request, rpc: RpcLike, principal: string, label: string): Promise<ResolvedMcpSession | { response: Response }> {
  const modern = mcpClientMeta(rpc)["io.modelcontextprotocol/protocolVersion"] === "2026-07-28";
  const transportId = modern ? undefined : (req.headers.get(MCP_SESSION_HEADER) ?? "").trim() || undefined;
  if (rpc.method === "initialize") return { responseSessionId: newAgentSessionId(), conversationBound: false };
  if (rpc.method !== "tools/call") return { responseSessionId: transportId, conversationBound: false };

  const explicitMeta = mcpClientMeta(rpc)["mso/sessionId"], explicitHeader = req.headers.get("Mso-Session-Id");
  if (explicitMeta !== undefined || explicitHeader) {
    if (explicitMeta !== undefined && typeof explicitMeta !== "string" || explicitHeader && explicitMeta !== undefined && explicitHeader !== explicitMeta) return { response: errorResponse(rpc, 400, "conflicting or invalid MSO session id") };
    const id = (explicitMeta ?? explicitHeader) as string;
    const session = await getAgentSession(principal, id).catch(() => null);
    if (!session) return { response: errorResponse(rpc, 403, "MSO session not found for this principal") };
    return { responseSessionId: transportId, agentSessionId: session.id, conversationBound: true };
  }
  if (rpc.params?.name === "agent_session_open") return { responseSessionId: transportId, conversationBound: false };
  const generic = mcpClientMeta(rpc)["mso/conversationKey"];
  if (generic !== undefined) {
    if (typeof generic !== "string" || !generic.trim() || generic.length > 256) return { response: errorResponse(rpc, 400, "invalid mso/conversationKey") };
    const session = await findOrCreateAgentSessionForConversation(principal, conversationHash(principal, "agent:" + generic), "Agent · MSO");
    return { responseSessionId: transportId, agentSessionId: session.id, conversationBound: true };
  }
  const conversation = openAiSession(rpc);
  if (conversation) {
    const session = await findOrCreateAgentSessionForConversation(principal, conversationHash(principal, conversation), `ChatGPT · ${label || "MSO"}`);
    return { responseSessionId: transportId, agentSessionId: session.id, conversationBound: true };
  }

  if (!transportId) {
    const autoHash = conversationHash(principal, "auto:default");
    const session = await findOrCreateAgentSessionForConversation(principal, autoHash, `Default · ${label || "MSO"}`);
    return { responseSessionId: session.id, agentSessionId: session.id, conversationBound: false };
  }
  const legacyHash = conversationHash(principal, `legacy:${transportId}`);
  const session = await findOrCreateAgentSessionForConversation(principal, legacyHash, `MCP legacy · ${label || "MSO"}`);
  return { responseSessionId: transportId, agentSessionId: session.id, conversationBound: false };
}

export function mcpSessionHeaders(sessionId?: string): Record<string, string> {
  return { "Cache-Control": "no-store", ...(sessionId ? { [MCP_SESSION_HEADER]: sessionId } : {}) };
}