@huseynsnmz/pi-suite 0.1.0 → 0.2.0

package/packages/frame/src/kit/ui/glyphs.ts

@@ -0,0 +1,132 @@
+// Every character the harness draws with, by name. Nerd Font marks live in look's icon sets.
+
+/** Marks in running text. */
+export const GLYPH = {
+	/** π, pi's own entries and the harness's name. */
+	pi: "\u03c0",
+	/** ✓ done, picked, passed. */
+	check: "\u2713",
+	/** ✗ failed. */
+	cross: "\u2717",
+	/** × close, remove. */
+	times: "\u00d7",
+	/** ↑ */
+	up: "\u2191",
+	/** ↓ */
+	down: "\u2193",
+	/** ← */
+	left: "\u2190",
+	/** → to whom, from what to what. */
+	right: "\u2192",
+	/** ▰ ▱ how well an agent fits a request, in the peers tool's bids. */
+	barFull: "\u25b0",
+	barEmpty: "\u25b1",
+	/** ↵ enter. */
+	enter: "\u21b5",
+	/** ↻ again. */
+	again: "\u21bb",
+	/** ❯ the selected row. */
+	pointer: "\u276f",
+	/** › a note on an option, a continuation. */
+	chevron: "\u203a",
+	/** ▸ a small pointer. */
+	triangle: "\u25b8",
+	/** ◆ an agent, a task in progress. */
+	diamond: "\u25c6",
+	/** ◇ an empty diamond: a task not started, a quiet mark. */
+	diamondEmpty: "\u25c7",
+	/** ◈ the judge. */
+	judge: "\u25c8",
+	/** ● on. */
+	dot: "\u25cf",
+	/** ○ off, not answered. */
+	ring: "\u25cb",
+	/** ◐ half: hearing a room without taking part in it. */
+	half: "\u25d0",
+	/** ◌ hidden, as tool output pruned from the context. */
+	ringDotted: "\u25cc",
+	/** ✎ words you typed. */
+	pencil: "\u270e",
+	/** ⚑ flagged. */
+	flag: "\u2691",
+	/** ⏵ running. */
+	play: "\u23f5",
+	/** ⌕ search. */
+	search: "\u2315",
+	/** ▍ where words arrive. */
+	cursor: "\u258d",
+	/** ▌ the bar on a selected row. */
+	bar: "\u258c",
+	/** ⋮ lines hidden above. */
+	ellipsisUp: "\u22ee",
+	/** ⋯ a gap between parts, as between two edits. */
+	ellipsisAcross: "\u22ef",
+} as const;
+
+/** Frames of the marks that move while something lasts, in order. */
+export const SPIN = {
+	/** ⠋ ⠙ ⠹ ⠸ ⠼ ⠴ ⠦ ⠧ ⠇ ⠏ a dot going round in one cell: someone writing. */
+	braille: [
+		"\u280b",
+		"\u2819",
+		"\u2839",
+		"\u2838",
+		"\u283c",
+		"\u2834",
+		"\u2826",
+		"\u2827",
+		"\u2807",
+		"\u280f",
+	],
+	/** ◴ ◷ ◶ ◵ a quarter of a circle going round: a call running. */
+	quadrants: ["\u25f4", "\u25f7", "\u25f6", "\u25f5"],
+	/** ⧖ ⧗ an hourglass and the same one flowing: a call waiting on you. */
+	hourglass: ["\u29d6", "\u29d7"],
+	/** | / - \ the same, in ASCII. */
+	ascii: ["|", "/", "-", "\\"],
+	/** ✎ ✏ ✐ ✏ a pencil that tilts as it writes, in one cell: the model writing a call. */
+	pencil: ["\u270e", "\u270f", "\u2710", "\u270f"],
+} as const;
+
+/** Three dots rather than `…`, which is one column in every font. */
+export const CUT = "...";
+
+/** The lines frames, rules and scroll bars are drawn with. */
+export const LINE = {
+	/** ─ */
+	h: "\u2500",
+	/** │ */
+	v: "\u2502",
+	/** ┃ the thumb of a scroll bar, and the sides of what is chosen. */
+	vHeavy: "\u2503",
+	/** ━ */
+	hHeavy: "\u2501",
+	/** ┏ */
+	topLeftHeavy: "\u250f",
+	/** ┓ */
+	topRightHeavy: "\u2513",
+	/** ┗ */
+	bottomLeftHeavy: "\u2517",
+	/** ┛ */
+	bottomRightHeavy: "\u251b",
+	/** ┄ a frame around what has not happened yet. */
+	hDashed: "\u2504",
+	/** ┆ */
+	vDashed: "\u2506",
+	/** ╭ */
+	topLeft: "\u256d",
+	/** ╮ */
+	topRight: "\u256e",
+	/** ╰ */
+	bottomLeft: "\u2570",
+	/** ╯ */
+	bottomRight: "\u256f",
+	/** ├ a rule that meets the left side. */
+	teeLeft: "\u251c",
+	/** ┤ a rule that meets the right side. */
+	teeRight: "\u2524",
+	/** ┬ a column that meets the top edge. */
+	teeTop: "\u252c",
+	/** ┴ a column that meets the bottom edge. */
+	teeBottom: "\u2534",
+} as const;

package/packages/frame/src/kit/ui/scroll.ts

@@ -0,0 +1,14 @@
+export interface ThumbRange {
+	/** From the top. */
+	start: number;
+	/** At least one. */
+	size: number;
+}
+
+/** Undefined when everything fits. */
+export function thumbRange(total: number, height: number, scroll: number): ThumbRange | undefined {
+	if (total <= height) return undefined;
+	const size = Math.max(1, Math.round((height * height) / total));
+	const start = Math.round((scroll / (total - height)) * (height - size));
+	return { start, size };
+}

package/packages/frame/src/render/diff.ts

@@ -1,9 +1,8 @@
 // An edit's diff inside the frame, without pi's colored box behind it: the line numbers in a gutter,
 // the sign and the text in the diff colors, and only the changed words on a tinted background.
-import { GLYPH, isObject } from "@adeildo/pi-kit";
+import { GLYPH, isObject } from "../kit/index.ts";
 import type { Theme, ThemeColor } from "@earendil-works/pi-coding-agent";
 import { type Component, wrapTextWithAnsi } from "@earendil-works/pi-tui";
-import { diffWords } from "diff";
 
 import { printable } from "./streaming.ts";
 
@@ -102,3 +101,57 @@ function changedWords(
 	}
 	return texts;
 }
+
+const TOKENS = /\s+|[\p{L}\p{N}_]+|./gsu;
+/** A pair of very long lines costs this much to compare, and a minified file isn't worth it. */
+const MOST_CELLS = 4_000_000;
+
+export interface WordChange {
+	value: string;
+	added?: boolean;
+	removed?: boolean;
+}
+
+/** What changed between two lines, word by word: the longest run of words they share stays. */
+export function diffWords(before: string, after: string): WordChange[] {
+	const a = before.match(TOKENS) ?? [];
+	const b = after.match(TOKENS) ?? [];
+	if ((a.length + 1) * (b.length + 1) > MOST_CELLS) {
+		return [
+			...(before === "" ? [] : [{ value: before, removed: true }]),
+			...(after === "" ? [] : [{ value: after, added: true }]),
+		];
+	}
+	const width = b.length + 1;
+	const shared = new Uint32Array((a.length + 1) * width);
+	for (let i = a.length - 1; i >= 0; i--) {
+		for (let j = b.length - 1; j >= 0; j--) {
+			shared[i * width + j] =
+				a[i] === b[j]
+					? (shared[(i + 1) * width + j + 1] ?? 0) + 1
+					: Math.max(shared[(i + 1) * width + j] ?? 0, shared[i * width + j + 1] ?? 0);
+		}
+	}
+	const parts: WordChange[] = [];
+	const push = (value: string, change: { added?: boolean; removed?: boolean }) => {
+		const last = parts.at(-1);
+		if (last !== undefined && last.added === change.added && last.removed === change.removed) last.value += value;
+		else parts.push({ value, ...change });
+	};
+	let i = 0;
+	let j = 0;
+	while (i < a.length || j < b.length) {
+		if (i < a.length && j < b.length && a[i] === b[j]) {
+			push(a[i] as string, {});
+			i++;
+			j++;
+		} else if (j >= b.length || (i < a.length && (shared[(i + 1) * width + j] ?? 0) >= (shared[i * width + j + 1] ?? 0))) {
+			push(a[i] as string, { removed: true });
+			i++;
+		} else {
+			push(b[j] as string, { added: true });
+			j++;
+		}
+	}
+	return parts;
+}

package/packages/frame/src/render/fit.ts

@@ -1,4 +1,4 @@
-import { CUT } from "@adeildo/pi-kit";
+import { CUT } from "../kit/index.ts";
 import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 
 export interface Piece {

package/packages/frame/src/render/format.ts

@@ -1,6 +1,6 @@
 import { sep } from "node:path";
 
-import { formatCost, formatTokens, tildify } from "@adeildo/pi-kit";
+import { formatCost, formatTokens, tildify } from "../kit/index.ts";
 import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 
 export const CELL = {

package/packages/frame/src/render/segments.ts

@@ -4,7 +4,7 @@ import {
 	formatClock,
 	type PeerMark,
 	type RoomMark,
-} from "@adeildo/pi-kit";
+} from "../kit/index.ts";
 import { visibleWidth } from "@earendil-works/pi-tui";
 
 import { SANDBOX_STATUS, type Snapshot } from "../data/snapshot.ts";

package/packages/frame/src/render/streaming.ts

@@ -2,7 +2,7 @@ import { readFileSync, statSync } from "node:fs";
 import { resolve } from "node:path";
 
 // While the model writes an edit or a write, these show the lines arriving, with a cursor.
-import { GLYPH, isObject, tildify } from "@adeildo/pi-kit";
+import { GLYPH, isObject, tildify } from "../kit/index.ts";
 import { getLanguageFromPath, highlightCode, type Theme } from "@earendil-works/pi-coding-agent";
 
 import { tabs } from "./format.ts";

package/packages/frame/src/render/tools.ts

@@ -1,5 +1,5 @@
 // The mark follows the icon set in the look's settings.
-import { GLYPH, SPIN } from "@adeildo/pi-kit";
+import { GLYPH, SPIN } from "../kit/index.ts";
 
 import type { IconSet } from "./glyphs.ts";
 

package/packages/frame/src/settings.ts

@@ -1,4 +1,4 @@
-import { boolean, literal, setting } from "@adeildo/pi-kit";
+import { boolean, literal, setting } from "./kit/index.ts";
 
 import type { FrameStyle } from "./render/frame.ts";
 import type { IconMode } from "./render/glyphs.ts";

package/packages/frame/src/ui/editor.ts

@@ -1,4 +1,4 @@
-import { skillQueryAt } from "@adeildo/pi-kit";
+import { skillQueryAt } from "../kit/index.ts";
 import { CustomEditor, type KeybindingsManager } from "@earendil-works/pi-coding-agent";
 import {
 	matchesKey,

package/packages/frame/src/ui/effort.ts

@@ -1,5 +1,5 @@
 // `/effort`: the thinking level by name, for when Shift+Tab belongs to another extension.
-import type { FeatureScope } from "@adeildo/pi-kit";
+import type { FeatureScope } from "../kit/index.ts";
 
 import { EFFORT_LEVELS } from "../render/paint.ts";
 

package/packages/frame/src/ui/header.ts

@@ -1,6 +1,6 @@
 import { readFileSync } from "node:fs";
 
-import { CUT, GLYPH } from "@adeildo/pi-kit";
+import { CUT, GLYPH } from "../kit/index.ts";
 import { keyText } from "@earendil-works/pi-coding-agent";
 import { type Component, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 

package/packages/frame/src/ui/outputs.ts

@@ -1,5 +1,5 @@
 // Alt+O: one tool call's whole output in a scrollable frame, newest first; the arrows move between calls.
-import { callTarget, CUT, frame, frameInner, FRAME_Y, GLYPH, type KeyHint } from "@adeildo/pi-kit";
+import { callTarget, CUT, frame, frameInner, FRAME_Y, GLYPH, type KeyHint } from "../kit/index.ts";
 import type { SessionEntry, Theme } from "@earendil-works/pi-coding-agent";
 import {
 	type Component,

package/packages/frame/src/ui/pi-entries.ts

@@ -1,6 +1,6 @@
 // Pi's own transcript entries in the harness frame instead of a background. Pi has no hook for
 // drawing them, so this wraps each component's render.
-import { CHANGES_CUT, CHANGES_X, entryFrame, type EntryFrame, GLYPH } from "@adeildo/pi-kit";
+import { CHANGES_CUT, CHANGES_X, entryFrame, type EntryFrame, GLYPH } from "../kit/index.ts";
 import {
 	BashExecutionComponent,
 	BranchSummaryMessageComponent,
@@ -12,12 +12,20 @@ import {
 } from "@earendil-works/pi-coding-agent";
 import { Container, Spacer, stripTerminalSequences, Text } from "@earendil-works/pi-tui";
 
+import { type Mode, modeColor } from "../data/mode.ts";
 import type { IconSet } from "../render/glyphs.ts";
 import { isBlank } from "./tool-frame.ts";
 
 /** Undefined leaves pi's entries as they are. `from` names the client a prompt came from. */
 export type EntryPaint = () =>
-	| { theme: Theme; set: IconSet; you: boolean; from?: (text: string) => string | undefined }
+	| {
+			theme: Theme;
+			set: IconSet;
+			you: boolean;
+			from?: (text: string) => string | undefined;
+			/** The mode a message went out in. A live message has no id yet, so it goes by its text. */
+			sentIn?: (id: string | undefined, text: string) => Mode | undefined;
+	  }
 	| undefined;
 
 const YOU: Readonly<Record<IconSet, string>> = {
@@ -56,7 +64,7 @@ export function framePiEntries(source: EntryPaint): void {
 	if (installed) return;
 	installed = true;
 	wrap(UserMessageComponent, (self, look) =>
-		look.you ? youFrame(look, fromOf(self, look)) : undefined,
+		look.you ? youFrame(look, fromOf(self, look), sentInOf(self, look)) : undefined,
 	);
 	wrap(CompactionSummaryMessageComponent, (_self, look) => pi(look, "compacted"));
 	wrap(BranchSummaryMessageComponent, (_self, look) => pi(look, "branch summary"));
@@ -167,10 +175,24 @@ function fromOf(self: object, look: Paint): string | undefined {
 	return sentFrom.get(self);
 }
 
-function youFrame(look: Paint, from: string | undefined): Framing {
-	const you = `${look.theme.fg("accent", YOU[look.set])} ${look.theme.fg("muted", "you")}`;
+const sentModes = new WeakMap<object, Mode | undefined>();
+
+function sentInOf(self: object, look: Paint): Mode | undefined {
+	if (sentModes.has(self)) return sentModes.get(self);
+	const { messageId, text } = self as { messageId?: string; text?: string };
+	const mode = look.sentIn?.(messageId, text ?? "");
+	// A later message with the same text may go out in another mode, so a found mode sticks to this one.
+	if (mode !== undefined || messageId !== undefined) sentModes.set(self, mode);
+	return mode;
+}
+
+/** Plan is the same color as a plain message, so the name says it too. */
+function youFrame(look: Paint, from: string | undefined, mode: Mode | undefined): Framing {
+	const color = (mode && modeColor(mode)) ?? "accent";
+	const named = mode === undefined || mode === "normal" ? "" : ` ${look.theme.fg(color, mode)}`;
+	const you = `${look.theme.fg(color, YOU[look.set])} ${look.theme.fg("muted", "you")}${named}`;
 	const top = from === undefined ? you : `${you} ${look.theme.fg("dim", `from ${from}`)}`;
-	return { top, color: "accent" };
+	return { top, color };
 }
 
 function pi(look: Paint, what: string): Framing {

package/packages/frame/src/ui/previews.ts

@@ -1,5 +1,5 @@
 // What each look setting changes, drawn under the list in Alt+S.
-import { entryFrame, GLYPH, type Json } from "@adeildo/pi-kit";
+import { entryFrame, GLYPH, type Json } from "../kit/index.ts";
 import type { Theme } from "@earendil-works/pi-coding-agent";
 import { visibleWidth } from "@earendil-works/pi-tui";
 

package/packages/frame/src/ui/queue.ts

@@ -1,6 +1,6 @@
 // Messages sent while the agent works, in a dashed frame above the editor. Pi has no hook for
 // drawing them, so this wraps its method.
-import { CUT, drawnByWidth, CHANGES_X, entryFrame } from "@adeildo/pi-kit";
+import { CUT, drawnByWidth, CHANGES_X, entryFrame } from "../kit/index.ts";
 import { InteractiveMode, type Theme } from "@earendil-works/pi-coding-agent";
 import { type Component, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 

package/packages/frame/src/ui/todos.ts

@@ -1,5 +1,5 @@
 // The agent's checklist: the `todo` tool, a panel above the editor and `/todos`.
-import { CUT, entryFrame, type FeatureScope } from "@adeildo/pi-kit";
+import { CUT, entryFrame, type FeatureScope } from "../kit/index.ts";
 import type { ExtensionContext, Theme } from "@earendil-works/pi-coding-agent";
 import { type Component, Text, type TUI, truncateToWidth } from "@earendil-works/pi-tui";
 import { Type } from "typebox";

package/packages/frame/src/ui/tool-frame.ts

@@ -9,7 +9,7 @@ import {
 	type RulingTone,
 	GLYPH,
 	LINE,
-} from "@adeildo/pi-kit";
+} from "../kit/index.ts";
 import type { Theme, ToolRenderers } from "@earendil-works/pi-coding-agent";
 import {
 	type Component,

package/packages/frame/src/view/state.ts

@@ -1,5 +1,5 @@
 // A viewed session's folded state and scroll position, kept apart from drawing so it tests without a terminal.
-import type { SessionSummary, SourceItem } from "@adeildo/pi-kit";
+import type { SessionSummary, SourceItem } from "../kit/index.ts";
 import type { SessionEntry } from "@earendil-works/pi-coding-agent";
 
 export class ViewState {

package/packages/frame/src/view/transcript.ts

@@ -1,5 +1,5 @@
 // Another session's entries, built as pi's interactive mode builds a loaded session.
-import { messageRendererFor, resolveToolRenderers } from "@adeildo/pi-kit";
+import { messageRendererFor, resolveToolRenderers } from "../kit/index.ts";
 import {
 	AssistantMessageComponent,
 	BashExecutionComponent,

package/packages/frame/src/view/view.ts

@@ -1,6 +1,6 @@
 // Another session over the whole screen. A read-only source has a line in place of the editor.
 import { keyLabel } from "../render/keys.ts";
-import { entryFrame, type SessionSummary, type SessionSource } from "@adeildo/pi-kit";
+import { entryFrame, type SessionSummary, type SessionSource } from "../kit/index.ts";
 import type { Theme } from "@earendil-works/pi-coding-agent";
 import {
 	type Component,

package/packages/web/package.json

@@ -41,8 +41,7 @@
   },
   "dependencies": {
     "@mozilla/readability": "0.6.0",
-    "linkedom": "0.18.12",
-    "turndown": "7.2.2"
+    "linkedom": "0.18.12"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "*",
@@ -53,7 +52,6 @@
     "@earendil-works/pi-ai": "1.5.0",
     "@earendil-works/pi-coding-agent": "1.5.0",
     "@types/node": "26.6.6",
-    "@types/turndown": "5.0.6",
     "typebox": "1.4.3",
     "typescript": "7.0.2"
   },

package/packages/web/src/extract.ts

@@ -1,7 +1,7 @@
 /** Turns a response into plain Markdown, leaving out what a person wouldn't see: that's where attacks on a reader hide. */
 import { Readability } from "@mozilla/readability";
 import { parseHTML } from "linkedom";
-import TurndownService from "turndown";
+import { markdownOf } from "./markdown.ts";
 import { clean } from "./sanitize.ts";
 
 const NEVER_SHOWN = "script,style,noscript,template,iframe,object,embed,svg,canvas,form,input,textarea,select,button,img,picture,video,audio,meta,link,head";
@@ -49,7 +49,7 @@ function htmlToMarkdown(html: string, base: string): string {
   for (const node of document.querySelectorAll(`body ${NEVER_SHOWN.split(",").join(",body ")},${HIDDEN}`)) node.remove();
   const article = new Readability(document as unknown as Document).parse();
   const content = article?.content ?? document.querySelector("body")?.innerHTML ?? "";
-  const markdown = new TurndownService({ headingStyle: "atx", codeBlockStyle: "fenced" }).turndown(content);
+  const markdown = markdownOf(content);
   return title ? `# ${title}\n\n${markdown}` : markdown;
 }
 

package/packages/web/src/markdown.ts

@@ -0,0 +1,122 @@
+/** Page HTML to Markdown. The page is hostile, so this only ever emits text, and escapes what would read as Markdown. */
+import { parseHTML } from "linkedom";
+
+interface DomNode {
+  nodeType: number;
+  tagName?: string;
+  textContent: string | null;
+  childNodes: Iterable<DomNode>;
+  getAttribute?(name: string): string | null;
+}
+
+const TEXT = 3;
+const ELEMENT = 1;
+const NEVER = new Set(["script", "style", "noscript", "template", "head", "title", "meta", "link", "iframe", "object", "embed", "svg", "canvas", "form", "input", "textarea", "select", "button", "img", "picture", "video", "audio"]);
+const BLOCK = new Set(["p", "div", "section", "article", "main", "aside", "header", "footer", "nav", "figure", "figcaption", "address", "details", "summary", "dl", "dt", "dd", "center"]);
+
+function escaped(text: string): string {
+  return text
+    .replace(/\\/g, "\\\\")
+    .replace(/[*`[\]_]/g, "\\$&")
+    .replace(/^(\s*)([-+=>]|#{1,6}(?=\s)|~~~)/, "$1\\$2")
+    .replace(/^(\s*\d+)\./, "$1\\.");
+}
+
+/** Text with backticks in it needs a longer run of them around it. */
+function fenceFor(text: string, shortest: number): string {
+  const longest = Math.max(0, ...[...text.matchAll(/`+/g)].map((run) => run[0].length));
+  return "`".repeat(Math.max(shortest, longest + 1));
+}
+
+function inside(node: DomNode): string {
+  return [...node.childNodes].map(render).join("");
+}
+
+function list(node: DomNode, ordered: boolean): string {
+  let number = 0;
+  const items = [...node.childNodes]
+    .filter((child) => child.tagName?.toLowerCase() === "li")
+    .map((item) => {
+      number++;
+      const marker = ordered ? `${number}. ` : "- ";
+      const body = inside(item).trim().replace(/\n{3,}/g, "\n\n");
+      return marker + body.replace(/\n/g, `\n${" ".repeat(marker.length)}`);
+    });
+  return `\n\n${items.join("\n")}\n\n`;
+}
+
+function render(node: DomNode): string {
+  if (node.nodeType === TEXT) return escaped((node.textContent ?? "").replace(/\s+/g, " "));
+  // Comments are never shown, so they don't count as the page's text.
+  if (node.nodeType !== ELEMENT) return "";
+  const tag = (node.tagName ?? "").toLowerCase();
+  if (NEVER.has(tag)) return "";
+  const heading = /^h([1-6])$/.exec(tag)?.[1];
+  if (heading !== undefined) {
+    const text = inside(node).trim();
+    return text === "" ? "" : `\n\n${"#".repeat(Number(heading))} ${text.replace(/\s*\n\s*/g, " ")}\n\n`;
+  }
+  if (BLOCK.has(tag)) return `\n\n${inside(node)}\n\n`;
+  switch (tag) {
+    case "br":
+      return "\n";
+    case "hr":
+      return "\n\n---\n\n";
+    case "ul":
+    case "ol":
+      return list(node, tag === "ol");
+    case "li":
+      return `\n- ${inside(node).trim()}\n`;
+    case "blockquote": {
+      const text = inside(node).trim().replace(/\n{3,}/g, "\n\n");
+      return text === "" ? "" : `\n\n${text.replace(/^/gm, "> ")}\n\n`;
+    }
+    case "pre": {
+      const text = (node.textContent ?? "").replace(/\n$/, "");
+      const fence = fenceFor(text, 3);
+      const code = [...node.childNodes].find((child) => child.tagName?.toLowerCase() === "code");
+      const language = /language-([\w+-]+)/.exec(code?.getAttribute?.("class") ?? "")?.[1] ?? "";
+      return `\n\n${fence}${language}\n${text}\n${fence}\n\n`;
+    }
+    case "code": {
+      const text = (node.textContent ?? "").replace(/\s+/g, " ");
+      if (text.trim() === "") return "";
+      const fence = fenceFor(text, 1);
+      const pad = text.startsWith("`") || text.endsWith("`") ? " " : "";
+      return `${fence}${pad}${text}${pad}${fence}`;
+    }
+    case "strong":
+    case "b":
+    case "em":
+    case "i": {
+      const text = inside(node);
+      const mark = tag === "strong" || tag === "b" ? "**" : "_";
+      return text.trim() === "" ? text : `${mark}${text.trim()}${mark}`;
+    }
+    case "a": {
+      const text = inside(node).trim().replace(/\s*\n\s*/g, " ");
+      const href = node.getAttribute?.("href");
+      if (text === "" || !href) return text;
+      return `[${text}](${href.replace(/[()\s]/g, encodeURIComponent)})`;
+    }
+    case "table":
+      return `\n\n${[...node.childNodes].map(render).join("").trim()}\n\n`;
+    case "thead":
+    case "tbody":
+    case "tfoot":
+      return [...node.childNodes].filter((child) => child.nodeType === ELEMENT).map(render).join("");
+    case "tr":
+      return `${[...node.childNodes].map((cell) => render(cell).trim()).filter(Boolean).join(" | ")}\n`;
+    default:
+      return inside(node);
+  }
+}
+
+export function markdownOf(html: string): string {
+  const { document } = parseHTML(`<!doctype html><html><body>${html}</body></html>`);
+  return render(document.body as unknown as DomNode)
+    .replace(/[ \t]*\n[ \t]*(?=\n)/g, "\n")
+    .replace(/[ \t]+\n/g, "\n")
+    .replace(/\n{3,}/g, "\n\n")
+    .trim();
+}

package/src/index.ts

@@ -1,4 +1,4 @@
-// One package, six parts. A part that's off isn't even imported, so it adds no tools, prompts or start-up time.
+// One package, seven parts. A part that's off isn't even imported, so it adds no tools, prompts or start-up time.
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
 import { fileURLToPath } from "node:url";

package/src/settings.ts

@@ -9,6 +9,7 @@ export const PARTS = {
   memory: "Memory the agent keeps between sessions",
   frame: "The start card, framed editor, tool boxes, footer and todo list",
   board: "The board of agent sessions",
+  commands: "/clear and /security-review",
 } as const;
 
 export type Part = keyof typeof PARTS;