Something went wrong. Try again.
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195import { randomBytes } from "node:crypto";import { readFile } from "node:fs/promises";import { createRequire } from "node:module";import { createServer } from "node:http";import { join } from "node:path";import { getAgentDir } from "@earendil-works/pi-coding-agent";import { Type } from "typebox";import { Check } from "typebox/value";import { CONTENT_POLICY, MERMAID_PATH, renderCatalogue, renderError, renderFile, renderRecord, renderTranscript,} from "./report.ts";import { findSessionFile, readTranscript } from "./transcript.ts";import type { WorkStore } from "./store.ts";import { readProjectFile } from "./files.ts";import { compileLinks, type Links } from "../links/contract.ts";
export interface WorkViewer { url: string; /** Query parameter value that admits a browser opened by /work. */ token: string; close(): Promise<void>;}
export async function startWorkViewer( store: WorkStore, settings: Links = {}, sessions = join(getAgentDir(), "sessions"),): Promise<WorkViewer> { const links = compileLinks(settings); const token = randomBytes(16).toString("base64url"); let host = ""; let cookie = ""; const server = createServer(async (request, response) => { response.setHeader("Content-Type", "text/html; charset=utf-8"); response.setHeader("Content-Security-Policy", CONTENT_POLICY); response.setHeader("Cache-Control", "no-store"); response.setHeader("Referrer-Policy", "no-referrer"); // script-src 'self' must not run HTML responses. response.setHeader("X-Content-Type-Options", "nosniff"); try { // A DNS-rebound page sends its own host name. if (request.headers.host !== host) { response.statusCode = 421; response.end(); return; } const url = new URL(request.url ?? "/", "http://127.0.0.1"); if (url.searchParams.get("token") === token) { response.setHeader( "Set-Cookie", `${cookie}; HttpOnly; SameSite=Strict; Path=/; Max-Age=86400`, ); } else if (!request.headers.cookie?.split(/;\s*/).includes(cookie)) { response.statusCode = 403; response.end(renderError("Run /work in Pi to open the work viewer.")); return; } if (request.method !== "GET" && request.method !== "HEAD") { response.writeHead(405, { Allow: "GET, HEAD" }); response.end(renderError("This viewer is read-only.")); return; } const path = url.pathname; if (path === MERMAID_PATH) { response.setHeader("Content-Type", "text/javascript; charset=utf-8"); response.setHeader("Cache-Control", "private, max-age=86400"); response.end( request.method === "HEAD" ? undefined : await readFile( createRequire(import.meta.url).resolve("@mermaid-js/tiny"), ), ); return; } if (path === "/") { // Read the version first so a concurrent write makes it stale rather than missed. const version = String(store.version()); response.setHeader("ETag", `"${version}"`); response.end( request.method === "HEAD" ? undefined : renderCatalogue(store.catalogue(), links, version), ); return; } const session = /^\/sessions\/([^/]+)$/.exec(path); if (session) { const file = await findSessionFile(sessions, decodeURIComponent(session[1])); response.statusCode = file ? 200 : 404; response.end( request.method === "HEAD" ? undefined : file ? renderTranscript( await readTranscript(file), links, url.searchParams.get("record") ?? "", ) : renderError( "The transcript of this session was not found. Its session file may be deleted.", ), ); return; } const match = /^\/records\/([^/]+)(\/file)?$/.exec(path); if (match) { const id = decodeURIComponent(match[1]); if (match[2]) { const brief = store.revision(id) === undefined ? undefined : store.read(id, { entry_ids: ["brief"] }).entries[0]?.content; if (brief?.kind === "brief") { const result = readProjectFile( brief.projects, url.searchParams.get("path") ?? "", ); response.statusCode = "file" in result ? 200 : result.status; response.end( request.method === "HEAD" ? undefined : "file" in result ? renderFile(result.file, id) : renderError(result.message), ); return; } } else if (request.method === "HEAD") { const revision = store.revision(id); response.statusCode = revision === undefined ? 404 : 200; if (revision !== undefined) { response.setHeader("ETag", `"${revision}"`); } response.end(); return; } const snapshot = match[2] ? undefined : store.snapshot(id); if (snapshot) { response.setHeader("ETag", `"${snapshot.revision}"`); response.end(renderRecord(snapshot, links)); return; } } response.statusCode = 404; response.end( request.method === "HEAD" ? undefined : renderError("Page was not found."), ); } catch (error) { response.statusCode = error instanceof URIError || error instanceof TypeError ? 400 : 500; response.end( request.method === "HEAD" ? undefined : renderError( response.statusCode === 400 ? "Invalid viewer URL." : "Could not read the page.", ), ); } }); await new Promise<void>((resolve, reject) => { server.once("error", reject); server.listen(0, "127.0.0.1", () => { server.off("error", reject); resolve(); }); }); server.unref(); const address = server.address(); if (!Check(Type.Object({ port: Type.Integer({ minimum: 1, maximum: 65535 }) }), address)) { server.close(); throw new Error("Work viewer has no listening address"); } host = `127.0.0.1:${address.port}`; // Viewers of other Pi processes share the cookie jar of 127.0.0.1, so the name has the port. cookie = `work-viewer-${address.port}=${token}`; return { url: `http://${host}`, token, close: () => new Promise<void>((resolve) => { server.close(() => resolve()); server.closeAllConnections(); }), };}