amosblomqvist
0b2e4e03fb
Owner round (2026-10-06): markdown export of sessions, actioned from
the sidebar context menu — "Export as Markdown…" sits with the
management actions, above Delete (the destructive action stays last).
- GET /api/chats/:id/markdown (404 unknown): the whole session as one
attachment — text/markdown; charset=utf-8, filename from the slugified
title ("relational-databases-joins-normal-forms.md", non-ascii titles
fall back to "session.md"). Both session kinds export.
- The client is a same-origin anchor download; the route's
Content-Disposition names the file.
- sessionMarkdown's user-facing debut — minted ANCHORLESS (message-id
anchors are extraction provenance, not learner-facing). The engine
joins the core barrel (pure, browser-safe) for its first consumer.
The practice join (owner-approved mid-round): practice tool results are
bare acks — statement, outcome, verdict, and the model solution all
live in the assistant's call arguments. The engine now folds them the
same way the view seam folds cards: Problem blocks render the pose's
statement (solution never leaks at pose time); Concluded blocks render
the outcome as prose ("Solved with hints.") + verdict, then the
pose-committed model solution as a blockquoted reveal via
problemInputForConclude (clean-poses-only, its refusal law). A
dismissed problem concludes as "The learner skipped this problem." —
no reveal. Errored poses render nothing (the failed-tool law).
1427 tests (route pins: headers, slug, anchorless body, 404; engine
pins: pose-time statement, the reveal, the dismissal refusal, the
errored-pose silence); tsc, lint, build green.
82 lines
3.9 KiB
TypeScript
82 lines
3.9 KiB
TypeScript
/**
|
|
* THE SESSION MARKDOWN EXPORT ROUTE (owner, release polish 2026-10-06):
|
|
* GET /api/chats/:id/markdown — the user-facing export. The engine
|
|
* itself is pinned by tests/session-markdown.test.ts; this file pins
|
|
* the ROUTE contract: 404 unknown chat, the attachment headers, the
|
|
* slugified filename, the anchorless document with the title header.
|
|
*
|
|
* Runs under an isolated LH_DATA_DIR (the chat-birth-stamp discipline:
|
|
* the seam is set before any config-loading import, so every
|
|
* app-module import is dynamic).
|
|
*/
|
|
import assert from "node:assert/strict";
|
|
import fs from "node:fs";
|
|
import * as os from "node:os";
|
|
import * as path from "node:path";
|
|
import { after, before, describe, it } from "node:test";
|
|
|
|
// ── the seam, BEFORE any config-loading import ──────────────────────────────
|
|
const TMP_DATA = fs.mkdtempSync(path.join(os.tmpdir(), "lh-md-export-"));
|
|
process.env.LH_DATA_DIR = TMP_DATA;
|
|
|
|
/** The route handler + the store seam, loaded AFTER the env is set. */
|
|
type Get = (req: Request, ctx: { params: Promise<{ id: string }> }) => Promise<Response>;
|
|
let GET: Get;
|
|
let createChat: (title: string, kind?: "practice") => { id: string; title: string };
|
|
let saveMessages: (id: string, messages: unknown[]) => void;
|
|
|
|
before(async () => {
|
|
const route = await import("../app/api/chats/[id]/markdown/route.ts");
|
|
GET = route.GET;
|
|
const server = await import("../src/server/chats.ts");
|
|
createChat = server.createChat;
|
|
const { chatStore } = await import("../src/store/chats.ts");
|
|
saveMessages = (id, messages) => chatStore.saveMessages(id, messages as never);
|
|
});
|
|
|
|
describe("GET /api/chats/:id/markdown", () => {
|
|
it("404s an unknown chat", async () => {
|
|
const res = await GET(new Request("http://x/api/chats/nope/markdown"), { params: Promise.resolve({ id: "nope" }) });
|
|
assert.equal(res.status, 404);
|
|
});
|
|
|
|
it("exports the session as an anchorless markdown attachment, filename from the title", async () => {
|
|
const chat = createChat("Relational Databases — Joins & Normal Forms");
|
|
saveMessages(chat.id, [
|
|
{ id: "m1", role: "user", content: "Teach me joins" },
|
|
{ id: "m2", role: "assistant", content: "A join combines rows." },
|
|
]);
|
|
const res = await GET(new Request("http://x/api"), { params: Promise.resolve({ id: chat.id }) });
|
|
assert.equal(res.status, 200);
|
|
assert.equal(res.headers.get("content-type"), "text/markdown; charset=utf-8");
|
|
const disposition = res.headers.get("content-disposition") ?? "";
|
|
assert.ok(disposition.startsWith("attachment;"), "it is a download");
|
|
assert.ok(disposition.includes('filename="relational-databases-joins-normal-forms.md"'), "slugified title names the file");
|
|
const body = await res.text();
|
|
assert.ok(body.startsWith("# Relational Databases"), "the title mints the document header");
|
|
assert.ok(body.includes("### Learner"), "learner blocks render");
|
|
assert.ok(body.includes("### Teacher"), "teacher blocks render");
|
|
assert.ok(!body.includes("m1"), "anchorless — no message-id provenance in the user-facing export");
|
|
});
|
|
|
|
it("an unsalvageable title falls back to 'session'", async () => {
|
|
const chat = createChat("日本語"); // no ascii alphanumerics survive the slug
|
|
saveMessages(chat.id, [{ id: "m1", role: "user", content: "hello" }]);
|
|
const res = await GET(new Request("http://x/api"), { params: Promise.resolve({ id: chat.id }) });
|
|
assert.equal(res.status, 200);
|
|
assert.ok((res.headers.get("content-disposition") ?? "").includes('filename="session.md"'));
|
|
});
|
|
|
|
it("an empty session exports the bare header document", async () => {
|
|
const chat = createChat("Quiet one");
|
|
const res = await GET(new Request("http://x/api"), { params: Promise.resolve({ id: chat.id }) });
|
|
assert.equal(res.status, 200);
|
|
const body = await res.text();
|
|
assert.equal(body, "# Quiet one");
|
|
});
|
|
});
|
|
|
|
after(() => {
|
|
fs.rmSync(TMP_DATA, { recursive: true, force: true });
|
|
});
|