@badliveware/pi-footer-framework 0.1.0 → 0.2.0

package/index.ts

@@ -1,40 +1,200 @@
 import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
-import { fileURLToPath } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import { Type } from "@mariozechner/pi-ai";
 import { defineTool, type ExtensionAPI, type ExtensionContext } from "@mariozechner/pi-coding-agent";
 import { truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
 
 type ChecksState = "pass" | "fail" | "running" | "unknown";
-type FooterAnchorMode = "gap" | "left" | "center" | "right" | "spread";
-type FooterLine = 1 | 2;
-type FooterZone = "left" | "right";
+export type FooterAnchorMode = "gap" | "left" | "center" | "right" | "spread";
+export type FooterLine = number;
+export type FooterZone = "left" | "right";
+export type FooterColumn = number | "center" | "middle" | `${number}%`;
 type ConfigScope = "user" | "project";
+export type ExternalFooterItemTone = "muted" | "info" | "success" | "warning" | "error" | "accent";
+export type ExternalFooterItemFormat = "auto" | "value" | "label-value" | "status";
+export type FooterAdapterSource = "pi" | "extensionStatus" | "sessionEntry";
 
-interface FooterItemPlacement {
+export interface FooterItemPlacement {
 	visible: boolean;
 	line: FooterLine;
 	zone: FooterZone;
 	order: number;
-	column?: number;
+	column?: FooterColumn;
 	before?: string;
 	after?: string;
 }
 
+interface FooterLineLayout {
+	anchor: FooterAnchorMode;
+	leftWidth: number;
+	rightWidthOriginal: number;
+	rightWidthFinal: number;
+	padCount: number;
+	rightStartCol: number;
+	rightEndCol: number;
+	truncated: boolean;
+}
+
+interface FooterRenderedToken {
+	text: string;
+	style?: string;
+	url?: string;
+	width: number;
+}
+
 interface FooterItem {
 	id: string;
 	text: string;
 	placement: FooterItemPlacement;
+	tokens?: FooterRenderedToken[];
+	renderSource?: "template" | "function" | "external";
+}
+
+export interface FooterSpan {
+	text: unknown;
+	style?: string;
+	url?: string;
+}
+
+export type FooterRenderable = string | number | boolean | null | undefined | FooterSpan | FooterRenderable[];
+
+export interface FooterRenderPiContext {
+	cwd: string;
+	model: Record<string, unknown> & { id?: string; provider?: string; thinking?: string };
+	stats: Record<string, unknown> & { inputText?: string; outputText?: string; costText?: string };
+	context?: Record<string, unknown> & { percentText?: string; tokenText?: string; tone?: ExternalFooterItemTone };
+	branch?: Record<string, unknown> & { name?: string; label?: string; prNumber?: number; prUrl?: string };
+	pr?: Record<string, unknown> & { number?: number; url?: string; checkGlyph?: string; checkTone?: ExternalFooterItemTone; commentsText?: string };
+	extensionStatuses: Record<string, unknown>;
+}
+
+export interface FooterRenderContext {
+	id: string;
+	value?: unknown;
+	label?: string;
+	status?: unknown;
+	data?: unknown;
+	url?: string;
+	source?: unknown;
+	pi: FooterRenderPiContext;
+	span(text: unknown, style?: string, options?: { url?: string }): FooterSpan;
+	fn: {
+		text(value: unknown): string;
+		width(value: string): number;
+		truncate(value: unknown, maxWidth: number, ellipsis?: string): string;
+		compactPath(value: unknown, maxWidth: number, tailSegments?: number): string;
+	};
+}
+
+export type FooterRenderFunction = (context: FooterRenderContext) => FooterRenderable;
+
+export interface FooterItemConfig extends Partial<FooterItemPlacement> {
+	render?: FooterRenderFunction;
+}
+
+interface FooterItemDisplayHint {
+	label?: string;
+	icon?: string;
+	format?: ExternalFooterItemFormat;
+	tone?: ExternalFooterItemTone;
+	placement?: Partial<FooterItemPlacement>;
 }
 
 interface ExternalFooterItemEvent {
 	id: string;
+	label?: string;
+	value?: unknown;
+	status?: unknown;
+	data?: unknown;
+	url?: string;
+	tone?: ExternalFooterItemTone;
+	/** Compatibility input. Prefer structured value/status/data plus optional hint. */
 	text?: string;
+	/** Display hint only. User config always wins over this placement/formatting advice. */
+	hint?: FooterItemDisplayHint;
 	placement?: Partial<FooterItemPlacement>;
 	remove?: boolean;
 }
 
+interface ExternalFooterItem {
+	id: string;
+	label?: string;
+	value?: unknown;
+	status?: unknown;
+	data?: unknown;
+	url?: string;
+	tone?: ExternalFooterItemTone;
+	text?: string;
+	hint: FooterItemDisplayHint;
+}
+
+interface FooterSnapshot {
+	width: number;
+	lines: Array<{ line: FooterLine; text: string; layout: FooterLineLayout }>;
+	line1: string;
+	line2: string;
+	line1Layout: FooterLineLayout;
+	line2Layout: FooterLineLayout;
+	gitBranch: string | null;
+	renderedItems: Array<{ id: string; line: FooterLine; zone: FooterZone; order: number; column?: FooterColumn; width: number; renderSource?: string; tokens?: FooterRenderedToken[] }>;
+	extensionStatuses: Array<{ key: string; value: string }>;
+	model: string;
+	contextUsage: { tokens: number | null; contextWindow: number; percent: number | null } | null;
+	thinkingLevel: string;
+	cwd: string;
+}
+
+export interface FooterAdapterConfig {
+	source: FooterAdapterSource;
+	/** Built-in Pi source key, extension status key, or custom entry type for sessionEntry adapters. */
+	key: string;
+	itemId?: string;
+	label?: string;
+	path?: string;
+	match?: string;
+	group?: string | number;
+	urlPath?: string;
+	tone?: ExternalFooterItemTone;
+	format?: ExternalFooterItemFormat;
+	/** Liquid-style interpolation template. Supports variables, string literals, and style filters. */
+	template?: string;
+	/** Optional fallback template when the selected source is empty. */
+	emptyTemplate?: string;
+	/** Default style applied to the full rendered adapter item. */
+	style?: string;
+	/** TS/JS config only: normal render closure returning text/spans. Not persisted to JSON. */
+	render?: FooterRenderFunction;
+	icon?: string;
+	placement?: Partial<FooterItemPlacement>;
+	hideWhenEmpty?: boolean;
+}
+
+interface FooterTemplateDiagnostic {
+	adapterId: string;
+	message: string;
+	token?: string;
+	severity: "warning" | "error";
+}
+
+interface FooterSourceInventoryOptions {
+	includeTools?: boolean;
+	includeCommands?: boolean;
+	includeSkills?: boolean;
+	includeDetails?: boolean;
+}
+
+interface FooterAdapterSourceValue {
+	label?: string;
+	value?: unknown;
+	status?: unknown;
+	data?: unknown;
+	url?: string;
+	tone?: ExternalFooterItemTone;
+	hint?: FooterItemDisplayHint;
+}
+
 interface PrState {
 	branch?: string;
 	error?: string;
@@ -48,44 +208,38 @@ interface PrState {
 	};
 }
 
+export interface FooterFrameworkConfig {
+	enabled?: boolean;
+	lineAnchors?: Record<string, FooterAnchorMode>;
+	minGap?: number;
+	maxGap?: number;
+	items?: Record<string, FooterItemConfig>;
+	adapters?: Record<string, FooterAdapterConfig>;
+}
+
 interface FooterFrameworkSettings {
 	enabled: boolean;
-	showCwd: boolean;
-	showStats: boolean;
-	showContext: boolean;
-	showModel: boolean;
-	showBranch: boolean;
-	showPr: boolean;
-	showExtensionStatuses: boolean;
-	hideZeroMcp: boolean;
-	line1Anchor: FooterAnchorMode;
-	line2Anchor: FooterAnchorMode;
-	branchMaxLength: number;
+	lineAnchors: Record<string, FooterAnchorMode>;
 	minGap: number;
 	maxGap: number;
 	items: Record<string, Partial<FooterItemPlacement>>;
+	adapters: Record<string, FooterAdapterConfig>;
 }
 
+const MIN_FOOTER_LINE = 1;
+
 const DEFAULT_SETTINGS: FooterFrameworkSettings = {
 	enabled: true,
-	showCwd: true,
-	showStats: true,
-	showContext: true,
-	showModel: true,
-	showBranch: true,
-	showPr: true,
-	showExtensionStatuses: true,
-	hideZeroMcp: true,
-	line1Anchor: "right",
-	line2Anchor: "right",
-	branchMaxLength: 22,
+	lineAnchors: { "1": "right", "2": "right" },
 	minGap: 2,
 	maxGap: 20,
 	items: {},
+	adapters: {},
 };
 
 const ANCHOR_MODES: FooterAnchorMode[] = ["gap", "left", "center", "right", "spread"];
 const CONFIG_FILE_NAME = "footer-framework.json";
+const CODE_CONFIG_FILE_NAMES = ["footer-framework.config.ts", "footer-framework.config.js", "footer-framework.config.mjs", "footer-framework.config.cjs"];
 const DEFAULT_ITEM_PLACEMENTS: Record<string, FooterItemPlacement> = {
 	cwd: { visible: true, line: 1, zone: "left", order: 10 },
 	model: { visible: true, line: 1, zone: "right", order: 10 },
@@ -96,6 +250,33 @@ const DEFAULT_ITEM_PLACEMENTS: Record<string, FooterItemPlacement> = {
 	ext: { visible: true, line: 2, zone: "right", order: 20 },
 };
 
+const DEFAULT_BUILT_IN_ADAPTERS: Record<string, FooterAdapterConfig> = {
+	cwd: { source: "pi", key: "cwd", itemId: "cwd", template: '{{ pi.cwd | style: "dim" }}', placement: DEFAULT_ITEM_PLACEMENTS.cwd },
+	model: {
+		source: "pi",
+		key: "model",
+		itemId: "model",
+		template: '{{ pi.model.id | style: "dim" }}{{ ":" | style: "dim" }}{{ pi.model.thinking | style: "dim" }}',
+		placement: DEFAULT_ITEM_PLACEMENTS.model,
+	},
+	branch: { source: "pi", key: "branch", itemId: "branch", template: '{{ pi.branch.label | truncate: 22 | style: "muted" }}', placement: DEFAULT_ITEM_PLACEMENTS.branch },
+	stats: {
+		source: "pi",
+		key: "stats",
+		itemId: "stats",
+		template: '{{ "↑" | style: "dim" }}{{ pi.stats.inputText | style: "dim" }} {{ "↓" | style: "dim" }}{{ pi.stats.outputText | style: "dim" }} {{ "$" | style: "dim" }}{{ pi.stats.costText | style: "dim" }}',
+		placement: DEFAULT_ITEM_PLACEMENTS.stats,
+	},
+	context: {
+		source: "pi",
+		key: "context",
+		itemId: "context",
+		template: '{{ "ctx" | style: pi.context.tone }} {{ pi.context.percentText | style: pi.context.tone }} {{ pi.context.tokenText | style: pi.context.tone }}',
+		placement: DEFAULT_ITEM_PLACEMENTS.context,
+	},
+	pr: { source: "pi", key: "pr", itemId: "pr", template: '{{ "PR " | style: "muted" }}{{ pi.pr.checkGlyph | style: pi.pr.checkTone }}{{ pi.pr.commentsText | style: "muted" }}', placement: DEFAULT_ITEM_PLACEMENTS.pr },
+};
+
 function formatTokens(count: number): string {
 	if (count < 1_000) return `${count}`;
 	if (count < 10_000) return `${(count / 1_000).toFixed(1)}k`;
@@ -113,6 +294,52 @@ function clamp(value: number, min: number, max: number): number {
 	return Math.max(min, Math.min(max, value));
 }
 
+function cloneDefaultSettings(): FooterFrameworkSettings {
+	return {
+		...DEFAULT_SETTINGS,
+		lineAnchors: { ...DEFAULT_SETTINGS.lineAnchors },
+		items: { ...DEFAULT_SETTINGS.items },
+		adapters: { ...DEFAULT_SETTINGS.adapters },
+	};
+}
+
+function normalizeFooterLine(value: unknown): FooterLine | undefined {
+	const parsed = typeof value === "number" ? value : typeof value === "string" && /^\d+$/.test(value.trim()) ? Number(value.trim()) : undefined;
+	if (!Number.isFinite(parsed)) return undefined;
+	const line = Math.round(parsed as number);
+	return line >= MIN_FOOTER_LINE ? line : undefined;
+}
+
+function parseFooterLineSelector(value: string): FooterLine | "all" | undefined {
+	if (value === "all") return "all";
+	const normalized = value.toLowerCase().startsWith("line") ? value.slice(4) : value;
+	return normalizeFooterLine(normalized);
+}
+
+function setLineAnchor(settings: FooterFrameworkSettings, line: FooterLine, mode: FooterAnchorMode): void {
+	settings.lineAnchors[String(line)] = mode;
+}
+
+function getLineAnchor(settings: FooterFrameworkSettings, line: FooterLine): FooterAnchorMode {
+	return settings.lineAnchors[String(line)] ?? settings.lineAnchors["2"] ?? "right";
+}
+
+function setAllLineAnchors(settings: FooterFrameworkSettings, mode: FooterAnchorMode): void {
+	setLineAnchor(settings, 1, mode);
+	setLineAnchor(settings, 2, mode);
+	for (const lineKey of Object.keys(settings.lineAnchors)) {
+		const line = normalizeFooterLine(lineKey);
+		if (line !== undefined) setLineAnchor(settings, line, mode);
+	}
+}
+
+function sortedLineAnchors(settings: FooterFrameworkSettings): string {
+	return Object.entries(settings.lineAnchors)
+		.sort(([a], [b]) => Number(a) - Number(b))
+		.map(([line, mode]) => `line${line}=${mode}`)
+		.join(", ");
+}
+
 function agentDir(): string {
 	return process.env.PI_CODING_AGENT_DIR ?? process.env.PI_AGENT_DIR ?? path.join(os.homedir(), ".pi", "agent");
 }
@@ -125,43 +352,116 @@ function projectConfigPath(ctx: ExtensionContext): string {
 	return path.join(ctx.cwd, ".pi", CONFIG_FILE_NAME);
 }
 
+function codeConfigPathCandidates(dir: string): string[] {
+	return CODE_CONFIG_FILE_NAMES.map((fileName) => path.join(dir, fileName));
+}
+
+function firstExistingPath(paths: string[]): string | undefined {
+	return paths.find((candidate) => fs.existsSync(candidate));
+}
+
+function userCodeConfigPath(): string | undefined {
+	return firstExistingPath(codeConfigPathCandidates(agentDir()));
+}
+
+function projectCodeConfigPath(ctx: ExtensionContext): string | undefined {
+	return firstExistingPath(codeConfigPathCandidates(path.join(ctx.cwd, ".pi")));
+}
+
+function configPaths(ctx?: ExtensionContext): Record<string, unknown> {
+	return {
+		user: userConfigPath(),
+		userCodeCandidates: codeConfigPathCandidates(agentDir()),
+		userCode: userCodeConfigPath(),
+		project: ctx ? projectConfigPath(ctx) : undefined,
+		projectCodeCandidates: ctx ? codeConfigPathCandidates(path.join(ctx.cwd, ".pi")) : undefined,
+		projectCode: ctx ? projectCodeConfigPath(ctx) : undefined,
+	};
+}
+
+function normalizeColumn(value: unknown): FooterColumn | undefined {
+	if (typeof value === "number" && Number.isFinite(value)) return Math.max(0, Math.round(value));
+	if (typeof value !== "string") return undefined;
+	const trimmed = value.trim().toLowerCase();
+	if (trimmed === "center" || trimmed === "middle") return trimmed;
+	if (/^-?\d+(?:\.\d+)?%$/.test(trimmed)) return trimmed as `${number}%`;
+	if (/^\d+$/.test(trimmed)) return Math.max(0, Math.round(Number(trimmed)));
+	return undefined;
+}
+
 function normalizePlacement(input: Partial<FooterItemPlacement>): Partial<FooterItemPlacement> {
 	const placement: Partial<FooterItemPlacement> = {};
+	const rawInput = input as Partial<FooterItemPlacement> & { line?: unknown; column?: unknown };
+	const line = normalizeFooterLine(rawInput.line);
+	const column = normalizeColumn(rawInput.column);
 	if (typeof input.visible === "boolean") placement.visible = input.visible;
-	if (input.line === 1 || input.line === 2) placement.line = input.line;
+	if (line !== undefined) placement.line = line;
 	if (input.zone === "left" || input.zone === "right") placement.zone = input.zone;
 	if (Number.isFinite(input.order)) placement.order = Math.round(input.order as number);
-	if (Number.isFinite(input.column)) placement.column = clamp(Math.round(input.column as number), 0, 500);
+	if (column !== undefined) placement.column = column;
 	if (typeof input.before === "string" && input.before.trim()) placement.before = input.before.trim();
 	if (typeof input.after === "string" && input.after.trim()) placement.after = input.after.trim();
 	return placement;
 }
 
-function normalizeSettings(input: Partial<FooterFrameworkSettings>): Partial<FooterFrameworkSettings> {
+function normalizeAdapter(input: unknown): FooterAdapterConfig | undefined {
+	if (!input || typeof input !== "object") return undefined;
+	const raw = input as Partial<FooterAdapterConfig>;
+	if (raw.source !== "pi" && raw.source !== "extensionStatus" && raw.source !== "sessionEntry") return undefined;
+	if (typeof raw.key !== "string" || !raw.key.trim()) return undefined;
+	const adapter: FooterAdapterConfig = {
+		source: raw.source,
+		key: raw.key.trim(),
+	};
+	if (typeof raw.itemId === "string" && raw.itemId.trim()) adapter.itemId = raw.itemId.trim();
+	if (typeof raw.label === "string" && raw.label.trim()) adapter.label = sanitizeStatusText(raw.label);
+	if (typeof raw.path === "string" && raw.path.trim()) adapter.path = raw.path.trim();
+	if (typeof raw.match === "string" && raw.match.trim()) adapter.match = raw.match;
+	if (typeof raw.group === "string" || typeof raw.group === "number") adapter.group = raw.group;
+	if (typeof raw.urlPath === "string" && raw.urlPath.trim()) adapter.urlPath = raw.urlPath.trim();
+	const tone = normalizeTone(raw.tone);
+	if (tone) adapter.tone = tone;
+	const format = normalizeFormat(raw.format);
+	if (format) adapter.format = format;
+	if (typeof raw.template === "string" && raw.template.trim()) adapter.template = raw.template;
+	if (typeof raw.emptyTemplate === "string" && raw.emptyTemplate.trim()) adapter.emptyTemplate = raw.emptyTemplate;
+	if (typeof raw.style === "string" && raw.style.trim()) adapter.style = raw.style.trim();
+	if (typeof raw.icon === "string" && raw.icon.trim()) adapter.icon = sanitizeStatusText(raw.icon);
+	if (raw.placement && typeof raw.placement === "object") adapter.placement = normalizePlacement(raw.placement);
+	if (typeof raw.hideWhenEmpty === "boolean") adapter.hideWhenEmpty = raw.hideWhenEmpty;
+	return adapter;
+}
+
+function normalizeSettings(input: Partial<FooterFrameworkConfig>): Partial<FooterFrameworkSettings> {
 	const normalized: Partial<FooterFrameworkSettings> = {};
-	for (const key of [
-		"enabled",
-		"showCwd",
-		"showStats",
-		"showContext",
-		"showModel",
-		"showBranch",
-		"showPr",
-		"showExtensionStatuses",
-		"hideZeroMcp",
-	] as const) {
+	for (const key of ["enabled"] as const) {
 		if (typeof input[key] === "boolean") normalized[key] = input[key];
 	}
-	if (input.line1Anchor && ANCHOR_MODES.includes(input.line1Anchor)) normalized.line1Anchor = input.line1Anchor;
-	if (input.line2Anchor && ANCHOR_MODES.includes(input.line2Anchor)) normalized.line2Anchor = input.line2Anchor;
-	if (Number.isFinite(input.branchMaxLength)) normalized.branchMaxLength = clamp(Math.round(input.branchMaxLength as number), 10, 64);
-	if (Number.isFinite(input.minGap)) normalized.minGap = clamp(Math.round(input.minGap as number), 1, 12);
-	if (Number.isFinite(input.maxGap)) normalized.maxGap = clamp(Math.round(input.maxGap as number), normalized.minGap ?? 1, 40);
+	const lineAnchors: Record<string, FooterAnchorMode> = {};
+	if (input.lineAnchors && typeof input.lineAnchors === "object") {
+		for (const [lineKey, mode] of Object.entries(input.lineAnchors)) {
+			const line = normalizeFooterLine(lineKey);
+			if (line !== undefined && ANCHOR_MODES.includes(mode)) lineAnchors[String(line)] = mode;
+		}
+	}
+	if (Object.keys(lineAnchors).length > 0) normalized.lineAnchors = lineAnchors;
+	if (Number.isFinite(input.minGap)) normalized.minGap = Math.max(0, Math.round(input.minGap as number));
+	if (Number.isFinite(input.maxGap)) normalized.maxGap = Math.max(normalized.minGap ?? 0, Math.round(input.maxGap as number));
 	if (input.items && typeof input.items === "object") {
 		normalized.items = {};
 		for (const [id, placement] of Object.entries(input.items)) {
 			if (!id.trim() || !placement || typeof placement !== "object") continue;
-			normalized.items[id] = normalizePlacement(placement as Partial<FooterItemPlacement>);
+			const normalizedPlacement = normalizePlacement(placement as Partial<FooterItemPlacement>);
+			if (Object.keys(normalizedPlacement).length > 0) normalized.items[id] = normalizedPlacement;
+		}
+		if (Object.keys(normalized.items).length === 0) delete normalized.items;
+	}
+	if (input.adapters && typeof input.adapters === "object") {
+		normalized.adapters = {};
+		for (const [id, adapterInput] of Object.entries(input.adapters)) {
+			if (!id.trim()) continue;
+			const adapter = normalizeAdapter(adapterInput);
+			if (adapter) normalized.adapters[id] = adapter;
 		}
 	}
 	return normalized;
@@ -170,28 +470,37 @@ function normalizeSettings(input: Partial<FooterFrameworkSettings>): Partial<Foo
 function readConfigFile(filePath: string): Partial<FooterFrameworkSettings> | undefined {
 	try {
 		if (!fs.existsSync(filePath)) return undefined;
-		const parsed = JSON.parse(fs.readFileSync(filePath, "utf-8")) as Partial<FooterFrameworkSettings>;
+		const parsed = JSON.parse(fs.readFileSync(filePath, "utf-8")) as Partial<FooterFrameworkConfig>;
 		return normalizeSettings(parsed);
 	} catch {
 		return undefined;
 	}
 }
 
+async function readCodeConfigFile(filePath: string): Promise<FooterFrameworkConfig | undefined> {
+	if (!fs.existsSync(filePath)) return undefined;
+	const stat = fs.statSync(filePath);
+	const imported = (await import(`${pathToFileURL(filePath).href}?mtime=${stat.mtimeMs}`)) as { default?: unknown };
+	if (!imported.default || typeof imported.default !== "object") throw new Error("default export must be a footer config object");
+	return imported.default as FooterFrameworkConfig;
+}
+
 function writeConfigFile(filePath: string, settings: FooterFrameworkSettings): void {
 	fs.mkdirSync(path.dirname(filePath), { recursive: true });
 	fs.writeFileSync(filePath, `${JSON.stringify(settings, null, 2)}\n`, "utf-8");
 }
 
-function compactBranchName(branch: string, maxLength: number): string {
-	if (branch.length <= maxLength) return branch;
-	const keep = Math.max(8, maxLength - 1);
-	return `${branch.slice(0, keep)}…`;
-}
-
 function osc8(label: string, url: string): string {
 	return `\u001b]8;;${url}\u0007${label}\u001b]8;;\u0007`;
 }
 
+function normalizeLinkUrl(value: unknown): string | undefined {
+	if (typeof value !== "string") return undefined;
+	const trimmed = value.trim();
+	if (!trimmed || /[\r\n]/.test(trimmed)) return undefined;
+	return trimmed;
+}
+
 function sanitizeStatusText(text: string): string {
 	return text
 		.replace(/[\r\n\t]/g, " ")
@@ -199,6 +508,675 @@ function sanitizeStatusText(text: string): string {
 		.trim();
 }
 
+function normalizeTone(tone: unknown): ExternalFooterItemTone | undefined {
+	return tone === "muted" || tone === "info" || tone === "success" || tone === "warning" || tone === "error" || tone === "accent" ? tone : undefined;
+}
+
+function normalizeFormat(format: unknown): ExternalFooterItemFormat | undefined {
+	return format === "auto" || format === "value" || format === "label-value" || format === "status" ? format : undefined;
+}
+
+function valueToText(value: unknown): string | undefined {
+	if (value === undefined || value === null) return undefined;
+	if (typeof value === "string") return sanitizeStatusText(value);
+	if (typeof value === "number" || typeof value === "bigint" || typeof value === "boolean") return String(value);
+	if (Array.isArray(value)) return sanitizeStatusText(value.map((entry) => valueToText(entry)).filter(Boolean).join(" "));
+	try {
+		return sanitizeStatusText(JSON.stringify(value));
+	} catch {
+		return sanitizeStatusText(String(value));
+	}
+}
+
+function valueToTemplateText(value: unknown): string | undefined {
+	if (value === undefined || value === null) return undefined;
+	if (typeof value === "string") return value.replace(/[\r\n\t]/g, " ").replace(/ +/g, " ");
+	return valueToText(value);
+}
+
+function normalizeDisplayHint(event: ExternalFooterItemEvent): FooterItemDisplayHint {
+	return {
+		label: typeof event.hint?.label === "string" ? sanitizeStatusText(event.hint.label) : undefined,
+		icon: typeof event.hint?.icon === "string" ? sanitizeStatusText(event.hint.icon) : undefined,
+		format: normalizeFormat(event.hint?.format),
+		tone: normalizeTone(event.hint?.tone),
+		placement: normalizePlacement({ ...(event.placement ?? {}), ...(event.hint?.placement ?? {}) }),
+	};
+}
+
+function normalizeExternalItemEvent(event: ExternalFooterItemEvent): ExternalFooterItem | undefined {
+	const id = event.id?.trim();
+	if (!id) return undefined;
+	return {
+		id,
+		label: typeof event.label === "string" ? sanitizeStatusText(event.label) : undefined,
+		value: event.value,
+		status: event.status,
+		data: event.data,
+		url: typeof event.url === "string" ? event.url : undefined,
+		tone: normalizeTone(event.tone),
+		text: typeof event.text === "string" ? sanitizeStatusText(event.text) : undefined,
+		hint: normalizeDisplayHint(event),
+	};
+}
+
+function applyExternalTone(theme: ExtensionContext["ui"]["theme"], tone: ExternalFooterItemTone | undefined, text: string): string {
+	if (tone === "success") return theme.fg("success", text);
+	if (tone === "warning") return theme.fg("warning", text);
+	if (tone === "error") return theme.fg("error", text);
+	if (tone === "accent") return theme.fg("accent", text);
+	if (tone === "muted") return theme.fg("muted", text);
+	return theme.fg("dim", text);
+}
+
+const THEME_FG_COLORS = new Set([
+	"accent",
+	"border",
+	"borderAccent",
+	"borderMuted",
+	"success",
+	"error",
+	"warning",
+	"muted",
+	"dim",
+	"text",
+	"thinkingText",
+	"userMessageText",
+	"customMessageText",
+	"customMessageLabel",
+	"toolTitle",
+	"toolOutput",
+	"mdHeading",
+	"mdLink",
+	"mdLinkUrl",
+	"mdCode",
+	"mdCodeBlock",
+	"mdCodeBlockBorder",
+	"mdQuote",
+	"mdQuoteBorder",
+	"mdHr",
+	"mdListBullet",
+	"toolDiffAdded",
+	"toolDiffRemoved",
+	"toolDiffContext",
+	"syntaxComment",
+	"syntaxKeyword",
+	"syntaxFunction",
+	"syntaxVariable",
+	"syntaxString",
+	"syntaxNumber",
+	"syntaxType",
+	"syntaxOperator",
+	"syntaxPunctuation",
+	"thinkingOff",
+	"thinkingMinimal",
+	"thinkingLow",
+	"thinkingMedium",
+	"thinkingHigh",
+	"thinkingXhigh",
+	"bashMode",
+]);
+
+const THEME_BG_COLORS = new Set(["selectedBg", "userMessageBg", "customMessageBg", "toolPendingBg", "toolSuccessBg", "toolErrorBg"]);
+const THEME_TEXT_ATTRIBUTES = new Set(["bold", "italic", "underline", "inverse", "strikethrough"]);
+
+function applyStyleSpec(
+	theme: ExtensionContext["ui"]["theme"],
+	text: string,
+	styleSpec: unknown,
+	diagnostics: FooterTemplateDiagnostic[],
+	adapterId: string,
+	token?: string,
+): string {
+	const spec = valueToText(styleSpec);
+	if (!spec) return text;
+	let out = text;
+	for (const rawPart of spec.split(",")) {
+		const part = rawPart.trim();
+		if (!part) continue;
+		const [prefix, value] = part.includes(":") ? (part.split(/:(.*)/s).filter(Boolean) as [string, string]) : [undefined, part];
+		if ((prefix === "fg" || prefix === "color") && THEME_FG_COLORS.has(value)) out = theme.fg(value as never, out);
+		else if ((prefix === "bg" || prefix === "background") && THEME_BG_COLORS.has(value)) out = theme.bg(value as never, out);
+		else if (!prefix && THEME_FG_COLORS.has(value)) out = theme.fg(value as never, out);
+		else if (!prefix && value === "bold") out = theme.bold(out);
+		else if (!prefix && value === "italic") out = theme.italic(out);
+		else if (!prefix && value === "underline") out = theme.underline(out);
+		else if (!prefix && value === "inverse") out = theme.inverse(out);
+		else if (!prefix && value === "strikethrough") out = theme.strikethrough(out);
+		else if (prefix === "attr" && THEME_TEXT_ATTRIBUTES.has(value)) out = applyStyleSpec(theme, out, value, diagnostics, adapterId, token);
+		else {
+			diagnostics.push({ adapterId, token, severity: "warning", message: `Unknown style token: ${part}` });
+			out = theme.fg("warning", out);
+		}
+	}
+	return out;
+}
+
+function renderExternalItem(theme: ExtensionContext["ui"]["theme"], item: ExternalFooterItem): string | undefined {
+	const hint = item.hint;
+	const label = hint.label ?? item.label;
+	const value = valueToText(item.value) ?? valueToText(item.status) ?? valueToText(item.data) ?? item.text;
+	const format = hint.format ?? (item.text && !label && item.value === undefined && item.status === undefined && item.data === undefined ? "value" : "auto");
+	const renderedValue = value ? applyExternalTone(theme, item.tone ?? hint.tone, value) : undefined;
+	const prefix = hint.icon ? `${hint.icon} ` : "";
+	let text: string | undefined;
+	if (format === "value") text = renderedValue ? `${prefix}${renderedValue}` : undefined;
+	else if (format === "status" && label && renderedValue) text = `${prefix}${theme.fg("muted", label)} ${renderedValue}`;
+	else if (label && renderedValue) text = `${prefix}${theme.fg("muted", label)}: ${renderedValue}`;
+	else if (renderedValue) text = `${prefix}${renderedValue}`;
+	else if (label) text = `${prefix}${theme.fg("muted", label)}`;
+	if (!text) return undefined;
+	return item.url ? osc8(text, item.url) : text;
+}
+
+function isFooterSpan(value: unknown): value is FooterSpan {
+	return Boolean(value && typeof value === "object" && "text" in value);
+}
+
+function renderValueText(value: unknown): string {
+	return valueToTemplateText(value) ?? "";
+}
+
+function renderSpan(
+	theme: ExtensionContext["ui"]["theme"],
+	span: FooterSpan,
+	diagnostics: FooterTemplateDiagnostic[],
+	adapterId: string,
+): { text: string; tokens: FooterRenderedToken[] } {
+	const plain = renderValueText(span.text);
+	let styled = span.style ? applyStyleSpec(theme, plain, span.style, diagnostics, adapterId) : plain;
+	if (span.url) styled = osc8(styled, span.url);
+	return { text: styled, tokens: [{ text: plain, style: span.style, url: span.url, width: visibleWidth(plain) }] };
+}
+
+function renderRenderable(
+	theme: ExtensionContext["ui"]["theme"],
+	value: FooterRenderable,
+	diagnostics: FooterTemplateDiagnostic[],
+	adapterId: string,
+): { text: string; tokens: FooterRenderedToken[] } {
+	if (value === undefined || value === null || value === false) return { text: "", tokens: [] };
+	if (Array.isArray(value)) {
+		const parts = value.map((entry) => renderRenderable(theme, entry, diagnostics, adapterId));
+		return { text: parts.map((part) => part.text).join(""), tokens: parts.flatMap((part) => part.tokens) };
+	}
+	if (isFooterSpan(value)) return renderSpan(theme, value, diagnostics, adapterId);
+	const text = renderValueText(value);
+	return { text, tokens: text ? [{ text, width: visibleWidth(text) }] : [] };
+}
+
+function footerRenderFunctions(): FooterRenderContext["fn"] {
+	return {
+		text(value: unknown) {
+			return renderValueText(value);
+		},
+		width(value: string) {
+			return visibleWidth(value);
+		},
+		truncate(value: unknown, maxWidth: number, ellipsis = "…") {
+			return truncateToWidth(renderValueText(value), Math.max(1, Math.round(maxWidth)), ellipsis);
+		},
+		compactPath(value: unknown, maxWidth: number, tailSegments = 2) {
+			return compactPathText(renderValueText(value), Math.max(4, Math.round(maxWidth)), Math.max(1, Math.round(tailSegments)));
+		},
+	};
+}
+
+function parsePath(pathExpression: string): string[] {
+	return pathExpression
+		.replace(/^\$\.?/, "")
+		.replace(/\[(\d+)\]/g, ".$1")
+		.split(".")
+		.map((part) => part.trim())
+		.filter(Boolean);
+}
+
+function selectPath(value: unknown, pathExpression?: string): unknown {
+	if (!pathExpression?.trim()) return value;
+	let current = value;
+	for (const part of parsePath(pathExpression)) {
+		if (current === undefined || current === null) return undefined;
+		if (Array.isArray(current)) {
+			const index = Number(part);
+			current = Number.isInteger(index) ? current[index] : undefined;
+		} else if (typeof current === "object") {
+			current = (current as Record<string, unknown>)[part];
+		} else {
+			return undefined;
+		}
+	}
+	return current;
+}
+
+function splitTemplatePipes(expression: string): string[] {
+	const parts: string[] = [];
+	let current = "";
+	let quote: string | undefined;
+	let escaped = false;
+	for (const char of expression) {
+		if (escaped) {
+			current += char;
+			escaped = false;
+			continue;
+		}
+		if (char === "\\") {
+			current += char;
+			escaped = true;
+			continue;
+		}
+		if (quote) {
+			current += char;
+			if (char === quote) quote = undefined;
+			continue;
+		}
+		if (char === '"' || char === "'") {
+			quote = char;
+			current += char;
+			continue;
+		}
+		if (char === "|") {
+			parts.push(current.trim());
+			current = "";
+			continue;
+		}
+		current += char;
+	}
+	parts.push(current.trim());
+	return parts;
+}
+
+function parseFilter(filterExpression: string): { name: string; arg?: string } {
+	let quote: string | undefined;
+	let escaped = false;
+	for (let index = 0; index < filterExpression.length; index++) {
+		const char = filterExpression[index];
+		if (escaped) {
+			escaped = false;
+			continue;
+		}
+		if (char === "\\") {
+			escaped = true;
+			continue;
+		}
+		if (quote) {
+			if (char === quote) quote = undefined;
+			continue;
+		}
+		if (char === '"' || char === "'") {
+			quote = char;
+			continue;
+		}
+		if (char === ":") {
+			return { name: filterExpression.slice(0, index).trim(), arg: filterExpression.slice(index + 1).trim() };
+		}
+	}
+	return { name: filterExpression.trim() };
+}
+
+function splitFilterArgs(expression: string | undefined): string[] {
+	if (!expression?.trim()) return [];
+	const args: string[] = [];
+	let current = "";
+	let quote: string | undefined;
+	let escaped = false;
+	for (const char of expression) {
+		if (escaped) {
+			current += char;
+			escaped = false;
+			continue;
+		}
+		if (char === "\\") {
+			current += char;
+			escaped = true;
+			continue;
+		}
+		if (quote) {
+			current += char;
+			if (char === quote) quote = undefined;
+			continue;
+		}
+		if (char === '"' || char === "'") {
+			quote = char;
+			current += char;
+			continue;
+		}
+		if (char === ",") {
+			args.push(current.trim());
+			current = "";
+			continue;
+		}
+		current += char;
+	}
+	args.push(current.trim());
+	return args.filter(Boolean);
+}
+
+function parseQuotedString(expression: string): string | undefined {
+	const trimmed = expression.trim();
+	if (trimmed.length < 2) return undefined;
+	const quote = trimmed[0];
+	if ((quote !== '"' && quote !== "'") || trimmed[trimmed.length - 1] !== quote) return undefined;
+	try {
+		return quote === '"' ? JSON.parse(trimmed) : trimmed.slice(1, -1).replace(/\\'/g, "'").replace(/\\\\/g, "\\");
+	} catch {
+		return undefined;
+	}
+}
+
+function evaluateTemplateTerm(
+	term: string | undefined,
+	context: Record<string, unknown>,
+	diagnostics: FooterTemplateDiagnostic[],
+	adapterId: string,
+	token: string,
+	reportMissing = true,
+): unknown {
+	if (!term) return undefined;
+	const trimmed = term.trim();
+	const literal = parseQuotedString(trimmed);
+	if (literal !== undefined) return literal;
+	if (/^-?\d+(?:\.\d+)?$/.test(trimmed)) return Number(trimmed);
+	if (trimmed === "true") return true;
+	if (trimmed === "false") return false;
+	const value = selectPath(context, trimmed);
+	if (value === undefined) {
+		if (reportMissing) diagnostics.push({ adapterId, token, severity: "error", message: `Missing template variable: ${trimmed}` });
+		return reportMissing ? `[missing:${trimmed}]` : undefined;
+	}
+	return value;
+}
+
+function numberFilterArg(value: unknown, fallback: number, min: number): number {
+	const parsed = typeof value === "number" ? value : typeof value === "string" ? Number(value.trim()) : Number.NaN;
+	return Number.isFinite(parsed) ? Math.max(min, Math.round(parsed)) : fallback;
+}
+
+function truncateStartToWidth(text: string, maxWidth: number, ellipsis = "…"): string {
+	if (visibleWidth(text) <= maxWidth) return text;
+	if (maxWidth <= visibleWidth(ellipsis)) return ellipsis;
+	let suffix = "";
+	for (const char of Array.from(text).reverse()) {
+		const next = `${char}${suffix}`;
+		if (visibleWidth(next) + visibleWidth(ellipsis) > maxWidth) break;
+		suffix = next;
+	}
+	return `${ellipsis}${suffix}`;
+}
+
+function compactPathText(input: string, maxWidth: number, tailSegments: number): string {
+	if (!input) return input;
+	const home = os.homedir();
+	let display = input;
+	if (home && (display === home || display.startsWith(`${home}/`) || display.startsWith(`${home}\\`))) display = `~${display.slice(home.length)}`;
+	if (visibleWidth(display) <= maxWidth) return display;
+
+	const normalized = display.replace(/\\/g, "/").replace(/\/+/g, "/");
+	const driveMatch = normalized.match(/^[A-Za-z]:\//);
+	const prefix = normalized.startsWith("~/") ? "~/" : driveMatch ? driveMatch[0] : normalized.startsWith("/") ? "/" : "";
+	const body = prefix ? normalized.slice(prefix.length) : normalized;
+	const segments = body.split("/").filter(Boolean);
+	const tailCount = Math.max(1, tailSegments);
+	if (segments.length <= tailCount) return truncateStartToWidth(normalized, maxWidth);
+	const compact = `${prefix}…/${segments.slice(-tailCount).join("/")}`;
+	return truncateStartToWidth(compact, maxWidth);
+}
+
+function evaluateFilterArgs(
+	arg: string | undefined,
+	context: Record<string, unknown>,
+	diagnostics: FooterTemplateDiagnostic[],
+	adapterId: string,
+	token: string,
+): unknown[] {
+	return splitFilterArgs(arg).map((part) => evaluateTemplateTerm(part, context, diagnostics, adapterId, token));
+}
+
+function applyTemplateFilter(
+	theme: ExtensionContext["ui"]["theme"],
+	value: string,
+	filterExpression: string,
+	context: Record<string, unknown>,
+	diagnostics: FooterTemplateDiagnostic[],
+	adapterId: string,
+	token: string,
+): string {
+	const { name, arg } = parseFilter(filterExpression);
+	if (name === "style" || name === "color") {
+		return applyStyleSpec(theme, value, evaluateTemplateTerm(arg, context, diagnostics, adapterId, token), diagnostics, adapterId, token);
+	}
+	if (name === "bg" || name === "background") {
+		const bg = valueToText(evaluateTemplateTerm(arg, context, diagnostics, adapterId, token));
+		return bg && THEME_BG_COLORS.has(bg) ? theme.bg(bg as never, value) : applyStyleSpec(theme, value, `bg:${bg}`, diagnostics, adapterId, token);
+	}
+	if (name === "bold" || name === "italic" || name === "underline" || name === "inverse" || name === "strikethrough") {
+		return applyStyleSpec(theme, value, name, diagnostics, adapterId, token);
+	}
+	if (name === "link") {
+		const url = valueToText(evaluateTemplateTerm(arg, context, diagnostics, adapterId, token));
+		return url ? osc8(value, url) : value;
+	}
+	if (name === "truncate") {
+		const [maxWidthArg, ellipsisArg] = evaluateFilterArgs(arg, context, diagnostics, adapterId, token);
+		const maxWidth = numberFilterArg(maxWidthArg, 40, 1);
+		const ellipsis = valueToText(ellipsisArg) || "…";
+		return truncateToWidth(value, maxWidth, ellipsis);
+	}
+	if (name === "compactPath") {
+		const [maxWidthArg, tailSegmentsArg] = evaluateFilterArgs(arg, context, diagnostics, adapterId, token);
+		const maxWidth = numberFilterArg(maxWidthArg, 40, 4);
+		const tailSegments = numberFilterArg(tailSegmentsArg, 2, 1);
+		return compactPathText(value, maxWidth, tailSegments);
+	}
+	if (name === "default") {
+		return value.length > 0 && !value.startsWith("[missing:") ? value : (valueToTemplateText(evaluateTemplateTerm(arg, context, diagnostics, adapterId, token)) ?? "");
+	}
+	diagnostics.push({ adapterId, token, severity: "warning", message: `Unknown template filter: ${name}` });
+	return theme.fg("warning", value);
+}
+
+function renderTemplate(
+	template: string,
+	context: Record<string, unknown>,
+	theme: ExtensionContext["ui"]["theme"],
+	adapterId: string,
+	diagnostics: FooterTemplateDiagnostic[],
+): string {
+	let output = "";
+	let cursor = 0;
+	const tokenPattern = /{{([\s\S]*?)}}/g;
+	for (let match = tokenPattern.exec(template); match; match = tokenPattern.exec(template)) {
+		output += template.slice(cursor, match.index);
+		const token = match[0];
+		const expression = match[1]?.trim() ?? "";
+		if (!expression) {
+			diagnostics.push({ adapterId, token, severity: "error", message: "Empty template token" });
+			output += theme.fg("error", "[empty-token]");
+		} else {
+			const [head, ...filters] = splitTemplatePipes(expression);
+			const hasDefaultFilter = filters.some((filter) => parseFilter(filter).name === "default");
+			let rendered = valueToTemplateText(evaluateTemplateTerm(head, context, diagnostics, adapterId, token, !hasDefaultFilter)) ?? "";
+			for (const filter of filters) rendered = applyTemplateFilter(theme, rendered, filter, context, diagnostics, adapterId, token);
+			output += rendered;
+		}
+		cursor = match.index + token.length;
+	}
+	output += template.slice(cursor);
+	const literalRemainder = template.replace(/{{[\s\S]*?}}/g, "");
+	if (literalRemainder.includes("{{") || literalRemainder.includes("}}")) {
+		diagnostics.push({ adapterId, severity: "error", message: "Unbalanced template braces" });
+		return `${output}${theme.fg("error", "[template braces]")}`;
+	}
+	return output;
+}
+
+function extractMatchedValue(text: string, adapter: FooterAdapterConfig): string | undefined {
+	if (!adapter.match) return text;
+	let match: RegExpMatchArray | null;
+	try {
+		match = text.match(new RegExp(adapter.match));
+	} catch {
+		return undefined;
+	}
+	if (!match) return undefined;
+	if (typeof adapter.group === "number") return match[adapter.group];
+	if (typeof adapter.group === "string" && adapter.group) {
+		if (/^\d+$/.test(adapter.group)) return match[Number(adapter.group)];
+		return match.groups?.[adapter.group];
+	}
+	return match[1] ?? match[0];
+}
+
+function sourceValueObject(sourceValue: unknown): FooterAdapterSourceValue {
+	return sourceValue && typeof sourceValue === "object" && !Array.isArray(sourceValue) ? (sourceValue as FooterAdapterSourceValue) : { value: sourceValue };
+}
+
+function adapterItemFromSource(adapterId: string, adapter: FooterAdapterConfig, sourceValue: unknown): ExternalFooterItem | undefined {
+	const sourceObject = sourceValueObject(sourceValue);
+	const defaultPath = adapter.source === "sessionEntry" ? "data" : "value";
+	const selected = selectPath(sourceValue, adapter.path ?? defaultPath);
+	const selectedText = valueToText(selected);
+	const allowEmpty = adapter.hideWhenEmpty === false || Boolean(adapter.emptyTemplate);
+	if (!selectedText && !allowEmpty) return undefined;
+	const matched = selectedText ? extractMatchedValue(selectedText, adapter) : undefined;
+	if (!matched && !allowEmpty) return undefined;
+	const url = (adapter.urlPath ? normalizeLinkUrl(selectPath(sourceValue, adapter.urlPath)) : undefined) ?? normalizeLinkUrl(sourceObject.url);
+	return {
+		id: adapter.itemId ?? adapterId,
+		label: adapter.label ?? sourceObject.label ?? adapterId,
+		value: matched ?? selectedText ?? "",
+		status: sourceObject.status,
+		data: sourceObject.data,
+		url,
+		tone: adapter.tone ?? sourceObject.tone,
+		hint: {
+			...sourceObject.hint,
+			format: adapter.format ?? sourceObject.hint?.format ?? "label-value",
+			icon: adapter.icon ?? sourceObject.hint?.icon,
+			placement: normalizePlacement({ ...(sourceObject.hint?.placement ?? {}), ...(adapter.placement ?? {}) }),
+		},
+	};
+}
+
+function templatePiContext(piSources: Record<string, FooterAdapterSourceValue>): Record<string, unknown> {
+	return {
+		cwd: piSources.cwd?.value,
+		model: piSources.model?.data ?? {},
+		stats: piSources.stats?.data ?? {},
+		context: piSources.context?.data ?? {},
+		branch: piSources.branch?.data ?? {},
+		pr: piSources.pr?.data ?? {},
+		extensionStatuses: piSources.extensionStatuses?.data ?? {},
+	};
+}
+
+function renderPiContext(piSources: Record<string, FooterAdapterSourceValue>): FooterRenderPiContext {
+	return {
+		cwd: renderValueText(piSources.cwd?.value),
+		model: (piSources.model?.data ?? {}) as FooterRenderPiContext["model"],
+		stats: (piSources.stats?.data ?? {}) as FooterRenderPiContext["stats"],
+		context: piSources.context?.data as FooterRenderPiContext["context"],
+		branch: piSources.branch?.data as FooterRenderPiContext["branch"],
+		pr: piSources.pr?.data as FooterRenderPiContext["pr"],
+		extensionStatuses: (piSources.extensionStatuses?.data ?? {}) as Record<string, unknown>,
+	};
+}
+
+function renderContextForAdapter(
+	id: string,
+	external: ExternalFooterItem | undefined,
+	sourceValue: unknown,
+	piSources: Record<string, FooterAdapterSourceValue>,
+): FooterRenderContext {
+	const sourceObject = sourceValueObject(sourceValue);
+	return {
+		id,
+		label: external?.label ?? sourceObject.label,
+		value: external?.value ?? sourceObject.value,
+		status: external?.status ?? sourceObject.status,
+		data: external?.data ?? sourceObject.data ?? sourceValue,
+		url: external?.url ?? sourceObject.url,
+		source: sourceObject,
+		pi: renderPiContext(piSources),
+		span: (text, style, options) => ({ text, style, url: options?.url }),
+		fn: footerRenderFunctions(),
+	};
+}
+
+function templateContextForAdapter(external: ExternalFooterItem, sourceValue: unknown, piSources: Record<string, FooterAdapterSourceValue>): Record<string, unknown> {
+	const sourceObject = sourceValueObject(sourceValue);
+	return {
+		label: external.label ?? sourceObject.label,
+		value: external.value ?? sourceObject.value,
+		status: external.status ?? sourceObject.status,
+		data: external.data ?? sourceObject.data ?? sourceValue,
+		url: external.url ?? sourceObject.url,
+		source: sourceObject,
+		pi: templatePiContext(piSources),
+	};
+}
+
+function renderFunctionOutput(
+	theme: ExtensionContext["ui"]["theme"],
+	id: string,
+	render: FooterRenderFunction,
+	context: FooterRenderContext,
+	diagnostics: FooterTemplateDiagnostic[],
+): { text: string; tokens: FooterRenderedToken[] } | undefined {
+	try {
+		const output = render(context);
+		if (output && typeof output === "object" && "then" in output && typeof (output as { then?: unknown }).then === "function") {
+			diagnostics.push({ adapterId: id, severity: "error", message: "Render functions must be synchronous" });
+			return undefined;
+		}
+		const rendered = renderRenderable(theme, output, diagnostics, id);
+		return rendered.text ? rendered : undefined;
+	} catch (error) {
+		diagnostics.push({ adapterId: id, severity: "error", message: `Render function failed: ${error instanceof Error ? error.message : String(error)}` });
+		return undefined;
+	}
+}
+
+function renderAdapterText(
+	theme: ExtensionContext["ui"]["theme"],
+	adapterId: string,
+	adapter: FooterAdapterConfig,
+	external: ExternalFooterItem,
+	sourceValue: unknown,
+	piSources: Record<string, FooterAdapterSourceValue>,
+	diagnostics: FooterTemplateDiagnostic[],
+	renderOverride?: FooterRenderFunction,
+): { text: string; tokens?: FooterRenderedToken[]; renderSource: "template" | "function" | "external" } | undefined {
+	if (renderOverride) {
+		const rendered = renderFunctionOutput(theme, adapterId, renderOverride, renderContextForAdapter(adapterId, external, sourceValue, piSources), diagnostics);
+		if (!rendered) return undefined;
+		let text = rendered.text;
+		if (adapter.style) text = applyStyleSpec(theme, text, adapter.style, diagnostics, adapterId);
+		return { text, tokens: rendered.tokens, renderSource: "function" };
+	}
+	const template = !external.value && adapter.emptyTemplate ? adapter.emptyTemplate : adapter.template;
+	let text = template ? renderTemplate(template, templateContextForAdapter(external, sourceValue, piSources), theme, adapterId, diagnostics) : renderExternalItem(theme, external);
+	if (text && adapter.style) text = applyStyleSpec(theme, text, adapter.style, diagnostics, adapterId);
+	if (text && template && external.url) text = osc8(text, external.url);
+	return text ? { text, renderSource: template ? "template" : "external" } : undefined;
+}
+
+function redactSensitive(value: unknown, depth = 0): unknown {
+	if (depth > 4) return "…";
+	if (Array.isArray(value)) return value.slice(0, 8).map((entry) => redactSensitive(entry, depth + 1));
+	if (!value || typeof value !== "object") return value;
+	const out: Record<string, unknown> = {};
+	for (const [key, entry] of Object.entries(value as Record<string, unknown>).slice(0, 30)) {
+		out[key] = /(token|secret|password|credential|authorization|api[_-]?key)/i.test(key) ? "[redacted]" : redactSensitive(entry, depth + 1);
+	}
+	return out;
+}
+
+function previewValue(value: unknown, maxLength = 1200): unknown {
+	const redacted = redactSensitive(value);
+	const text = valueToText(redacted) ?? "";
+	return text.length > maxLength ? `${text.slice(0, maxLength)}…` : redacted;
+}
+
 function parseSettingsInput(settings: FooterFrameworkSettings, args: string): string | undefined {
 	const tokens = args
 		.trim()
@@ -216,82 +1194,45 @@ function parseSettingsInput(settings: FooterFrameworkSettings, args: string): st
 		return "Footer framework disabled (default footer restored).";
 	}
 	if (command === "reset") {
-		Object.assign(settings, { ...DEFAULT_SETTINGS, items: { ...DEFAULT_SETTINGS.items } });
+		Object.assign(settings, cloneDefaultSettings());
 		return "Footer framework reset to defaults.";
 	}
 	if (command === "section") {
 		if (!key || !value) return "Usage: /footerfx section <cwd|stats|context|model|branch|pr|ext> <on|off>";
 		const enabled = value === "on" || value === "enable" || value === "true";
-		if (!["on", "off", "enable", "disable", "true", "false"].includes(value)) {
-			return "Section value must be on/off.";
-		}
-		switch (key) {
-			case "cwd":
-				settings.showCwd = enabled;
-				return `Section cwd ${enabled ? "enabled" : "disabled"}.`;
-			case "stats":
-				settings.showStats = enabled;
-				return `Section stats ${enabled ? "enabled" : "disabled"}.`;
-			case "context":
-				settings.showContext = enabled;
-				return `Section context ${enabled ? "enabled" : "disabled"}.`;
-			case "model":
-				settings.showModel = enabled;
-				return `Section model ${enabled ? "enabled" : "disabled"}.`;
-			case "branch":
-				settings.showBranch = enabled;
-				return `Section branch ${enabled ? "enabled" : "disabled"}.`;
-			case "pr":
-				settings.showPr = enabled;
-				return `Section pr ${enabled ? "enabled" : "disabled"}.`;
-			case "ext":
-				settings.showExtensionStatuses = enabled;
-				return `Section ext ${enabled ? "enabled" : "disabled"}.`;
-			default:
-				return "Unknown section. Use: cwd|stats|context|model|branch|pr|ext";
-		}
+		if (!["on", "off", "enable", "disable", "true", "false"].includes(value)) return "Section value must be on/off.";
+		if (!["cwd", "stats", "context", "model", "branch", "pr", "ext"].includes(key)) return "Unknown section. Use: cwd|stats|context|model|branch|pr|ext";
+		(settings.items[key] ??= {}).visible = enabled;
+		return `Section ${key} ${enabled ? "enabled" : "disabled"}.`;
 	}
 	if (command === "gap") {
 		if (!key || !value) return "Usage: /footerfx gap <min> <max>";
 		const min = Number(key);
 		const max = Number(value);
 		if (!Number.isFinite(min) || !Number.isFinite(max)) return "gap values must be numbers.";
-		settings.minGap = clamp(Math.round(min), 1, 12);
-		settings.maxGap = clamp(Math.round(max), settings.minGap, 40);
+		settings.minGap = Math.max(0, Math.round(min));
+		settings.maxGap = Math.max(settings.minGap, Math.round(max));
 		return `Gap updated (min=${settings.minGap}, max=${settings.maxGap}).`;
 	}
 	if (command === "anchor") {
-		if (!key || !value) return "Usage: /footerfx anchor <line1|line2|all> <gap|left|center|right|spread>";
+		if (!key || !value) return "Usage: /footerfx anchor <line|all> <gap|left|center|right|spread>";
 		if (!ANCHOR_MODES.includes(value as FooterAnchorMode)) {
 			return "Anchor must be one of: gap, left, center, right, spread.";
 		}
 		const mode = value as FooterAnchorMode;
-		if (key === "line1") settings.line1Anchor = mode;
-		else if (key === "line2") settings.line2Anchor = mode;
-		else if (key === "all") {
-			settings.line1Anchor = mode;
-			settings.line2Anchor = mode;
-		} else {
-			return "Anchor target must be one of: line1, line2, all.";
+		const target = parseFooterLineSelector(key);
+		if (target === "all") {
+			setAllLineAnchors(settings, mode);
+			return `Anchor all lines set to ${mode}.`;
 		}
-		return `Anchor ${key} set to ${mode}.`;
-	}
-	if (command === "branch-width") {
-		if (!key) return "Usage: /footerfx branch-width <n>";
-		const maxLength = Number(key);
-		if (!Number.isFinite(maxLength)) return "branch-width must be a number.";
-		settings.branchMaxLength = clamp(Math.round(maxLength), 10, 64);
-		return `Branch width max set to ${settings.branchMaxLength}.`;
-	}
-	if (command === "mcp-zero") {
-		if (!key || !["hide", "show"].includes(key)) return "Usage: /footerfx mcp-zero <hide|show>";
-		settings.hideZeroMcp = key === "hide";
-		return `MCP 0/x server line ${settings.hideZeroMcp ? "hidden" : "shown"}.`;
+		if (target === undefined) return "Anchor target must be all or a positive line number.";
+		setLineAnchor(settings, target, mode);
+		return `Anchor line ${target} set to ${mode}.`;
 	}
 	if (command === "item") {
 		const [id, action, arg] = tokens.slice(1);
 		if (!id || !action) {
-			return "Usage: /footerfx item <id> <show|hide|line|zone|order|column|before|after|reset> [value]";
+			return "Usage: /footerfx item <id> <show|hide|line|row|zone|order|column|before|after|reset> [value]";
 		}
 		const item = (settings.items[id] ??= {});
 		if (action === "show") {
@@ -306,9 +1247,9 @@ function parseSettingsInput(settings: FooterFrameworkSettings, args: string): st
 			delete settings.items[id];
 			return `Item ${id} reset.`;
 		}
-		if (action === "line") {
-			const line = Number(arg);
-			if (line !== 1 && line !== 2) return "Item line must be 1 or 2.";
+		if (action === "line" || action === "row") {
+			const line = normalizeFooterLine(arg);
+			if (line === undefined) return "Item line must be a positive number.";
 			item.line = line;
 			return `Item ${id} moved to line ${line}.`;
 		}
@@ -328,11 +1269,11 @@ function parseSettingsInput(settings: FooterFrameworkSettings, args: string): st
 		if (action === "column") {
 			if (arg === "off" || arg === "auto") {
 				delete item.column;
-				return `Item ${id} absolute column disabled.`;
+				return `Item ${id} column disabled.`;
 			}
-			const column = Number(arg);
-			if (!Number.isFinite(column)) return "Item column must be a number, off, or auto.";
-			item.column = clamp(Math.round(column), 0, 500);
+			const column = normalizeColumn(arg);
+			if (column === undefined) return "Item column must be a number, center, middle, percent like 50%, off, or auto.";
+			item.column = column;
 			return `Item ${id} column set to ${item.column}.`;
 		}
 		if (action === "before" || action === "after") {
@@ -342,23 +1283,88 @@ function parseSettingsInput(settings: FooterFrameworkSettings, args: string): st
 			item[action] = arg;
 			return `Item ${id} positioned ${action} ${arg}.`;
 		}
-		return "Unknown item action. Use show|hide|line|zone|order|column|before|after|reset.";
+		return "Unknown item action. Use show|hide|line|row|zone|order|column|before|after|reset.";
+	}
+	if (command === "adapter") {
+		const [id, action, sourceKey, label] = tokens.slice(1);
+		if (!id) {
+			const ids = Object.keys(settings.adapters).sort();
+			return ids.length ? `Adapters: ${ids.join(", ")}` : "No footer adapters configured.";
+		}
+		if (action === "remove" || action === "delete") {
+			delete settings.adapters[id];
+			if (DEFAULT_BUILT_IN_ADAPTERS[id]) {
+				(settings.items[id] ??= {}).visible = false;
+				return `Built-in item ${id} hidden.`;
+			}
+			return `Adapter ${id} removed.`;
+		}
+		if (action === "template" || action === "empty-template" || action === "style") {
+			const existing = settings.adapters[id] ?? DEFAULT_BUILT_IN_ADAPTERS[id];
+			if (!existing) return `Adapter ${id} does not exist yet. Create it with pi/status/custom or footer_framework_adapter_config first.`;
+			const match = args.match(new RegExp(`^adapter\\s+${id.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\s+${action}\\s+([\\s\\S]+)$`));
+			const body = match?.[1]?.trim();
+			if (!body) return `Usage: /footerfx adapter ${id} ${action} <value>`;
+			settings.adapters[id] = { ...existing };
+			if (action === "template") settings.adapters[id].template = body;
+			else if (action === "empty-template") settings.adapters[id].emptyTemplate = body;
+			else settings.adapters[id].style = body;
+			return `Adapter ${id} ${action} updated.`;
+		}
+		if (action === "pi") {
+			if (!sourceKey) return `Usage: /footerfx adapter ${id} pi <source-key> [label]`;
+			settings.adapters[id] = {
+				source: "pi",
+				key: sourceKey,
+				label: label ?? id,
+				format: "label-value",
+				placement: { visible: true, line: 2, zone: "right", order: 100 },
+			};
+			return `Adapter ${id} maps Pi source ${sourceKey}.`;
+		}
+		if (action === "status") {
+			if (!sourceKey) return `Usage: /footerfx adapter ${id} status <status-key> [label]`;
+			settings.adapters[id] = {
+				source: "extensionStatus",
+				key: sourceKey,
+				label: label ?? id,
+				format: "label-value",
+				placement: { visible: true, line: 2, zone: "right", order: 100 },
+			};
+			return `Adapter ${id} maps extension status ${sourceKey}.`;
+		}
+		if (action === "custom") {
+			const pathExpression = tokens[4];
+			const customLabel = tokens[5];
+			if (!sourceKey || !pathExpression) return `Usage: /footerfx adapter ${id} custom <custom-type> <path> [label]`;
+			const dataPath = pathExpression.startsWith("data.") || pathExpression.startsWith("$.data.") ? pathExpression : `data.${pathExpression.replace(/^\$\.?/, "")}`;
+			settings.adapters[id] = {
+				source: "sessionEntry",
+				key: sourceKey,
+				path: dataPath,
+				label: customLabel ?? id,
+				format: "label-value",
+				placement: { visible: true, line: 2, zone: "right", order: 100 },
+			};
+			return `Adapter ${id} maps latest custom entry ${sourceKey}.${pathExpression}.`;
+		}
+		return "Usage: /footerfx adapter [id] <pi|status|custom|remove> ...";
 	}
 
 	return `Unknown command: ${command}`;
 }
 
-function settingsSummary(settings: FooterFrameworkSettings, loadedConfig?: string): string {
+function settingsSummary(settings: FooterFrameworkSettings, loadedConfig?: string, configDiagnostics: string[] = []): string {
 	const customizedItems = Object.keys(settings.items).sort();
+	const adapters = Object.keys(settings.adapters).sort();
 	return [
 		loadedConfig ? `loaded=${loadedConfig}` : undefined,
 		`enabled=${settings.enabled}`,
-		`sections: cwd=${settings.showCwd}, stats=${settings.showStats}, context=${settings.showContext}, model=${settings.showModel}, branch=${settings.showBranch}, pr=${settings.showPr}, ext=${settings.showExtensionStatuses}`,
-		`anchor: line1=${settings.line1Anchor}, line2=${settings.line2Anchor}`,
+		`anchors: ${sortedLineAnchors(settings)}`,
 		`gap: min=${settings.minGap}, max=${settings.maxGap}`,
-		`branchMaxLength=${settings.branchMaxLength}`,
-		`hideZeroMcp=${settings.hideZeroMcp}`,
 		customizedItems.length ? `customizedItems=${customizedItems.join(",")}` : undefined,
+		adapters.length ? `adapters=${adapters.join(",")}` : undefined,
+		configDiagnostics.length ? `configDiagnostics=${configDiagnostics.length}` : undefined,
 	]
 		.filter(Boolean)
 		.join("\n");
@@ -367,52 +1373,37 @@ function settingsSummary(settings: FooterFrameworkSettings, loadedConfig?: strin
 const extensionDir = path.dirname(fileURLToPath(import.meta.url));
 
 export default function footerFramework(pi: ExtensionAPI): void {
-	const settings: FooterFrameworkSettings = { ...DEFAULT_SETTINGS, items: { ...DEFAULT_SETTINGS.items } };
+	const settings: FooterFrameworkSettings = cloneDefaultSettings();
 	let prState: PrState | undefined;
 	let currentCtx: ExtensionContext | undefined;
 	let requestRender: (() => void) | undefined;
-	const externalItems = new Map<string, { text: string; placement: Partial<FooterItemPlacement> }>();
+	const externalItems = new Map<string, ExternalFooterItem>();
+	let configuredItemRenderers: Record<string, { render: FooterRenderFunction; source: string }> = {};
+	let configuredAdapterRenderers: Record<string, { render: FooterRenderFunction; source: string }> = {};
 	let lastLoadedConfig = "defaults";
-	let lastFooterSnapshot:
-		| {
-				width: number;
-				line1: string;
-				line2: string;
-				line1Layout: {
-					anchor: FooterAnchorMode;
-					leftWidth: number;
-					rightWidthOriginal: number;
-					rightWidthFinal: number;
-					padCount: number;
-					rightStartCol: number;
-					rightEndCol: number;
-					truncated: boolean;
-				};
-				line2Layout: {
-					anchor: FooterAnchorMode;
-					leftWidth: number;
-					rightWidthOriginal: number;
-					rightWidthFinal: number;
-					padCount: number;
-					rightStartCol: number;
-					rightEndCol: number;
-					truncated: boolean;
-				};
-				gitBranch: string | null;
-				renderedItems: Array<{ id: string; line: FooterLine; zone: FooterZone; order: number; column?: number; width: number }>;
-				extensionStatuses: Array<{ key: string; value: string }>;
-				model: string;
-				contextUsage: { tokens: number | null; contextWindow: number; percent: number | null } | null;
-				thinkingLevel: string;
-				cwd: string;
-			}
-		| undefined;
+	let lastConfigDiagnostics: string[] = [];
+	let lastFooterSnapshot: FooterSnapshot | undefined;
+	let lastPiSources: Record<string, FooterAdapterSourceValue> = {};
+	let lastTemplateDiagnostics: FooterTemplateDiagnostic[] = [];
 
-	function applyValidatedSettings(input: Partial<FooterFrameworkSettings>): void {
+	function applyValidatedSettings(input: Partial<FooterFrameworkConfig>): void {
 		Object.assign(settings, normalizeSettings(input));
-		settings.minGap = clamp(settings.minGap, 1, 12);
-		settings.maxGap = clamp(settings.maxGap, settings.minGap, 40);
-		settings.branchMaxLength = clamp(settings.branchMaxLength, 10, 64);
+		settings.minGap = Math.max(0, Math.round(settings.minGap));
+		settings.maxGap = Math.max(settings.minGap, Math.round(settings.maxGap));
+	}
+
+	function applyCodeConfig(input: FooterFrameworkConfig, source: string): void {
+		applyValidatedSettings(input);
+		if (input.items && typeof input.items === "object") {
+			for (const [id, item] of Object.entries(input.items)) {
+				if (typeof item?.render === "function") configuredItemRenderers[id] = { render: item.render, source };
+			}
+		}
+		if (input.adapters && typeof input.adapters === "object") {
+			for (const [id, adapter] of Object.entries(input.adapters)) {
+				if (typeof adapter?.render === "function") configuredAdapterRenderers[id] = { render: adapter.render, source };
+			}
+		}
 	}
 
 	function saveSettings(scope: ConfigScope, ctx?: ExtensionContext): string {
@@ -434,27 +1425,69 @@ export default function footerFramework(pi: ExtensionAPI): void {
 		pi.appendEntry("footer-framework-state", settings);
 	}
 
-	function loadSettings(ctx: ExtensionContext): string {
-		Object.assign(settings, { ...DEFAULT_SETTINGS, items: { ...DEFAULT_SETTINGS.items } });
+	async function loadSettings(ctx: ExtensionContext): Promise<string> {
+		Object.assign(settings, cloneDefaultSettings());
+		configuredItemRenderers = {};
+		configuredAdapterRenderers = {};
+		lastConfigDiagnostics = [];
+		const loaded: string[] = [];
 		const userPath = userConfigPath();
 		const projectPath = projectConfigPath(ctx);
+		const userCodePath = userCodeConfigPath();
+		const projectCodePath = projectCodeConfigPath(ctx);
+
+		if (userCodePath) {
+			try {
+				const config = await readCodeConfigFile(userCodePath);
+				if (config) {
+					applyCodeConfig(config, `user-code:${userCodePath}`);
+					loaded.push(`user-code:${userCodePath}`);
+				}
+			} catch (error) {
+				lastConfigDiagnostics.push(`Failed to load ${userCodePath}: ${error instanceof Error ? error.message : String(error)}`);
+			}
+		}
+
 		const userConfig = readConfigFile(userPath);
-		const projectConfig = readConfigFile(projectPath);
+		if (userConfig) {
+			applyValidatedSettings(userConfig);
+			loaded.push(`user:${userPath}`);
+		}
+
+		if (projectCodePath) {
+			try {
+				const config = await readCodeConfigFile(projectCodePath);
+				if (config) {
+					applyCodeConfig(config, `project-code:${projectCodePath}`);
+					loaded.push(`project-code:${projectCodePath}`);
+				}
+			} catch (error) {
+				lastConfigDiagnostics.push(`Failed to load ${projectCodePath}: ${error instanceof Error ? error.message : String(error)}`);
+			}
+		}
 
-		if (userConfig) applyValidatedSettings(userConfig);
-		if (projectConfig) applyValidatedSettings(projectConfig);
+		const projectConfig = readConfigFile(projectPath);
+		if (projectConfig) {
+			applyValidatedSettings(projectConfig);
+			loaded.push(`project:${projectPath}`);
+		}
 
-		if (projectConfig) lastLoadedConfig = `project:${projectPath}`;
-		else if (userConfig) lastLoadedConfig = `user:${userPath}`;
-		else lastLoadedConfig = "defaults";
+		lastLoadedConfig = loaded.length ? loaded.join(" -> ") : "defaults";
 		return lastLoadedConfig;
 	}
 
-	function renderCheck(theme: ExtensionContext["ui"]["theme"], checks: ChecksState): string {
-		if (checks === "pass") return theme.fg("success", "✅");
-		if (checks === "fail") return theme.fg("error", "❌");
-		if (checks === "running") return theme.fg("warning", "⏳");
-		return theme.fg("muted", "•");
+	function checkGlyph(checks: ChecksState): string {
+		if (checks === "pass") return "✅";
+		if (checks === "fail") return "❌";
+		if (checks === "running") return "⏳";
+		return "•";
+	}
+
+	function checkTone(checks: ChecksState): ExternalFooterItemTone {
+		if (checks === "pass") return "success";
+		if (checks === "fail") return "error";
+		if (checks === "running") return "warning";
+		return "muted";
 	}
 
 	function composeLine(
@@ -527,29 +1560,12 @@ export default function footerFramework(pi: ExtensionAPI): void {
 		};
 	}
 
-	function renderBranch(theme: ExtensionContext["ui"]["theme"], gitBranch: string | null): string | undefined {
-		if (!settings.showBranch || !gitBranch) return undefined;
-		const compact = compactBranchName(gitBranch, settings.branchMaxLength);
-		if (!settings.showPr || !prState?.pr || prState.branch !== gitBranch) {
-			return theme.fg("muted", `(${compact})`);
-		}
-		const prLabel = osc8(theme.fg("accent", `#${prState.pr.number}`), prState.pr.url);
-		return `${theme.fg("muted", `(${compact} `)}${prLabel}${theme.fg("muted", ")")}`;
-	}
-
-	function renderPrStatus(theme: ExtensionContext["ui"]["theme"]): string | undefined {
-		if (!settings.showPr || !prState?.pr) return undefined;
-		const tokens = [theme.fg("muted", "PR"), renderCheck(theme, prState.pr.checks)];
-		if (prState.pr.comments > 0) tokens.push(theme.fg("muted", `💬${prState.pr.comments}`));
-		return tokens.join(" ");
-	}
-
 	function renderModelLabel(): string {
 		const model = currentCtx?.model?.id ?? "no-model";
 		return `${model}:${pi.getThinkingLevel()}`;
 	}
 
-	function renderContextUsage(theme: ExtensionContext["ui"]["theme"]): string | undefined {
+	function contextUsageSource(): FooterAdapterSourceValue | undefined {
 		const usage = currentCtx?.getContextUsage();
 		const contextWindow = usage?.contextWindow ?? currentCtx?.model?.contextWindow;
 		if (!contextWindow) return undefined;
@@ -558,11 +1574,13 @@ export default function footerFramework(pi: ExtensionAPI): void {
 		const percent = usage?.percent ?? null;
 		const percentText = percent === null ? "?%" : `${percent.toFixed(1)}%`;
 		const tokenText = tokens === null ? `?/${formatContextTokens(contextWindow)}` : `${formatContextTokens(tokens)}/${formatContextTokens(contextWindow)}`;
-		const text = `ctx ${percentText} ${tokenText}`;
-
-		if (percent !== null && percent > 90) return theme.fg("error", text);
-		if (percent !== null && percent > 70) return theme.fg("warning", text);
-		return theme.fg("dim", text);
+		const tone: ExternalFooterItemTone = percent !== null && percent > 90 ? "error" : percent !== null && percent > 70 ? "warning" : "muted";
+		return {
+			label: "ctx",
+			value: `ctx ${percentText} ${tokenText}`,
+			tone,
+			data: { tokens, contextWindow, window: contextWindow, percent, percentText, tokenText, tone },
+		};
 	}
 
 	function placementFor(id: string, fallback: FooterItemPlacement, external?: Partial<FooterItemPlacement>): FooterItemPlacement {
@@ -573,21 +1591,6 @@ export default function footerFramework(pi: ExtensionAPI): void {
 		};
 	}
 
-	function applyLegacySectionVisibility(items: FooterItem[]): void {
-		const legacy: Record<string, boolean> = {
-			cwd: settings.showCwd,
-			stats: settings.showStats,
-			context: settings.showContext,
-			model: settings.showModel,
-			branch: settings.showBranch,
-			pr: settings.showPr,
-			ext: settings.showExtensionStatuses,
-		};
-		for (const item of items) {
-			if (legacy[item.id] === false && settings.items[item.id]?.visible === undefined) item.placement.visible = false;
-		}
-	}
-
 	function resolveRelativeOrders(items: FooterItem[]): FooterItem[] {
 		const sorted = [...items].sort((a, b) => a.placement.order - b.placement.order || a.id.localeCompare(b.id));
 		for (const item of sorted) {
@@ -605,13 +1608,23 @@ export default function footerFramework(pi: ExtensionAPI): void {
 		return sorted.sort((a, b) => a.placement.order - b.placement.order || a.id.localeCompare(b.id));
 	}
 
+	function resolveOverlayColumn(column: FooterColumn | undefined, width: number, itemWidth: number): number | undefined {
+		if (column === undefined) return undefined;
+		if (typeof column === "number") return clamp(column, 0, Math.max(0, width - 1));
+		if (column === "center" || column === "middle") return clamp(Math.round((width - itemWidth) / 2), 0, Math.max(0, width - 1));
+		const percent = Number(column.slice(0, -1));
+		if (!Number.isFinite(percent)) return undefined;
+		const target = Math.round((width - 1) * (percent / 100));
+		return clamp(Math.round(target - itemWidth / 2), 0, Math.max(0, width - 1));
+	}
+
 	function overlayAbsoluteItems(theme: ExtensionContext["ui"]["theme"], width: number, line: string, items: FooterItem[]): string {
 		let out = line;
 		const sorted = items
-			.filter((item) => Number.isFinite(item.placement.column))
-			.sort((a, b) => (a.placement.column ?? 0) - (b.placement.column ?? 0) || a.placement.order - b.placement.order);
-		for (const item of sorted) {
-			const column = clamp(item.placement.column ?? 0, 0, width - 1);
+			.map((item) => ({ item, column: resolveOverlayColumn(item.placement.column, width, visibleWidth(item.text)) }))
+			.filter((entry): entry is { item: FooterItem; column: number } => entry.column !== undefined)
+			.sort((a, b) => a.column - b.column || a.item.placement.order - b.item.placement.order);
+		for (const { item, column } of sorted) {
 			const prefix = truncateToWidth(out, column, "");
 			const pad = " ".repeat(Math.max(0, column - visibleWidth(prefix)));
 			const available = Math.max(0, width - column);
@@ -623,7 +1636,7 @@ export default function footerFramework(pi: ExtensionAPI): void {
 
 	function renderFooterLine(theme: ExtensionContext["ui"]["theme"], width: number, items: FooterItem[], line: FooterLine, anchor: FooterAnchorMode) {
 		const lineItems = items.filter((item) => item.placement.line === line);
-		const normalItems = lineItems.filter((item) => !Number.isFinite(item.placement.column));
+		const normalItems = lineItems.filter((item) => item.placement.column === undefined);
 		const left = normalItems
 			.filter((item) => item.placement.zone === "left")
 			.sort((a, b) => a.placement.order - b.placement.order)
@@ -638,56 +1651,229 @@ export default function footerFramework(pi: ExtensionAPI): void {
 		return { ...result, line: overlayAbsoluteItems(theme, width, result.line, lineItems) };
 	}
 
-	function collectItems(
-		theme: ExtensionContext["ui"]["theme"],
+	function latestCustomEntry(customType: string): unknown {
+		const entries = currentCtx?.sessionManager.getEntries() ?? [];
+		for (let index = entries.length - 1; index >= 0; index--) {
+			const entry = entries[index] as { type?: string; customType?: string };
+			if (entry.type === "custom" && entry.customType === customType) return entry;
+		}
+		return undefined;
+	}
+
+	function adaptedExtensionStatusKeys(): Set<string> {
+		return new Set(
+			Object.values(allAdapters())
+				.filter((adapter) => adapter.source === "extensionStatus")
+				.map((adapter) => adapter.key),
+		);
+	}
+
+	function allAdapters(): Record<string, FooterAdapterConfig> {
+		return { ...DEFAULT_BUILT_IN_ADAPTERS, ...settings.adapters };
+	}
+
+	function buildPiSources(
 		footerData: { getGitBranch(): string | null; getExtensionStatuses(): ReadonlyMap<string, string> },
-		statsText: string,
+		stats: { input: number; output: number; cost: number; inputText: string; outputText: string; costText: string; value: string },
+	): Record<string, FooterAdapterSourceValue> {
+		const sources: Record<string, FooterAdapterSourceValue> = {
+			cwd: { label: "cwd", value: currentCtx?.cwd ?? "", tone: "muted", data: { path: currentCtx?.cwd ?? "" } },
+			model: {
+				label: "model",
+				value: renderModelLabel(),
+				tone: "muted",
+				data: { ...(currentCtx?.model ?? {}), id: currentCtx?.model?.id ?? "no-model", provider: currentCtx?.model?.provider, thinking: pi.getThinkingLevel() },
+			},
+			stats: { label: "stats", value: stats.value, tone: "muted", data: stats },
+			extensionStatuses: { label: "ext", value: footerData.getExtensionStatuses().size, data: Object.fromEntries(footerData.getExtensionStatuses()) },
+		};
+		const context = contextUsageSource();
+		if (context) sources.context = context;
+		const gitBranch = footerData.getGitBranch();
+		if (gitBranch) {
+			const pr = prState?.pr && prState.branch === gitBranch ? prState.pr : undefined;
+			const label = pr ? `(${gitBranch} #${pr.number})` : `(${gitBranch})`;
+			sources.branch = {
+				label: "branch",
+				value: label,
+				url: pr?.url,
+				tone: "muted",
+				data: { name: gitBranch, label, prNumber: pr?.number, prUrl: pr?.url, pr },
+			};
+		}
+		if (prState?.pr) {
+			const commentsText = prState.pr.comments > 0 ? ` 💬${prState.pr.comments}` : "";
+			const data = {
+				...prState,
+				number: prState.pr.number,
+				title: prState.pr.title,
+				url: prState.pr.url,
+				comments: prState.pr.comments,
+				commentsText,
+				checks: prState.pr.checks,
+				checkGlyph: checkGlyph(prState.pr.checks),
+				checkTone: checkTone(prState.pr.checks),
+			};
+			sources.pr = { label: "PR", value: `${data.checkGlyph}${commentsText}`, url: prState.pr.url, tone: data.checkTone, data };
+		}
+		return sources;
+	}
+
+	function collectConfiguredItems(
+		theme: ExtensionContext["ui"]["theme"],
+		piSources: Record<string, FooterAdapterSourceValue>,
+		diagnostics: FooterTemplateDiagnostic[],
 	): FooterItem[] {
 		const items: FooterItem[] = [];
-		items.push({ id: "cwd", text: theme.fg("dim", currentCtx?.cwd ?? ""), placement: placementFor("cwd", DEFAULT_ITEM_PLACEMENTS.cwd) });
-		items.push({ id: "model", text: theme.fg("dim", renderModelLabel()), placement: placementFor("model", DEFAULT_ITEM_PLACEMENTS.model) });
-		items.push({ id: "stats", text: statsText, placement: placementFor("stats", DEFAULT_ITEM_PLACEMENTS.stats) });
-		const contextUsageText = renderContextUsage(theme);
-		if (contextUsageText) items.push({ id: "context", text: contextUsageText, placement: placementFor("context", DEFAULT_ITEM_PLACEMENTS.context) });
+		for (const [id, renderer] of Object.entries(configuredItemRenderers)) {
+			const rendered = renderFunctionOutput(theme, id, renderer.render, renderContextForAdapter(id, undefined, undefined, piSources), diagnostics);
+			if (!rendered) continue;
+			items.push({
+				id,
+				text: rendered.text,
+				tokens: rendered.tokens,
+				renderSource: "function",
+				placement: placementFor(id, DEFAULT_ITEM_PLACEMENTS[id] ?? { visible: true, line: 2, zone: "right", order: 90 }),
+			});
+		}
+		return items;
+	}
 
-		const gitBranch = footerData.getGitBranch();
-		if (gitBranch) {
-			const compact = compactBranchName(gitBranch, settings.branchMaxLength);
-			const branchText = settings.showPr && prState?.pr && prState.branch === gitBranch
-				? `${theme.fg("muted", `(${compact} `)}${osc8(theme.fg("accent", `#${prState.pr.number}`), prState.pr.url)}${theme.fg("muted", ")")}`
-				: theme.fg("muted", `(${compact})`);
-			items.push({ id: "branch", text: branchText, placement: placementFor("branch", DEFAULT_ITEM_PLACEMENTS.branch) });
+	function collectAdapterItems(
+		theme: ExtensionContext["ui"]["theme"],
+		footerData: { getExtensionStatuses(): ReadonlyMap<string, string> },
+		piSources: Record<string, FooterAdapterSourceValue>,
+		diagnostics: FooterTemplateDiagnostic[],
+	): FooterItem[] {
+		const items: FooterItem[] = [];
+		const extensionStatuses = footerData.getExtensionStatuses();
+		for (const [adapterId, adapter] of Object.entries(allAdapters())) {
+			const itemId = adapter.itemId ?? adapterId;
+			if (configuredItemRenderers[itemId]) continue;
+			let sourceValue: unknown;
+			if (adapter.source === "pi") {
+				sourceValue = piSources[adapter.key];
+				if (sourceValue === undefined) continue;
+			} else if (adapter.source === "extensionStatus") {
+				const value = extensionStatuses.get(adapter.key);
+				if (value === undefined) continue;
+				sourceValue = { key: adapter.key, value };
+			} else if (adapter.source === "sessionEntry") {
+				sourceValue = latestCustomEntry(adapter.key);
+				if (sourceValue === undefined) continue;
+			}
+			const external = adapterItemFromSource(adapterId, adapter, sourceValue);
+			if (!external) continue;
+			const rendered = renderAdapterText(theme, adapterId, adapter, external, sourceValue, piSources, diagnostics, configuredAdapterRenderers[adapterId]?.render);
+			if (!rendered) continue;
+			items.push({
+				id: external.id,
+				text: rendered.text,
+				tokens: rendered.tokens,
+				renderSource: rendered.renderSource,
+				placement: placementFor(external.id, { visible: true, line: 2, zone: "right", order: 90 }, external.hint.placement),
+			});
 		}
+		return items;
+	}
 
-		const prStatus = renderPrStatus(theme);
-		if (prStatus) items.push({ id: "pr", text: prStatus, placement: placementFor("pr", DEFAULT_ITEM_PLACEMENTS.pr) });
+	function collectItems(
+		theme: ExtensionContext["ui"]["theme"],
+		footerData: { getGitBranch(): string | null; getExtensionStatuses(): ReadonlyMap<string, string> },
+		stats: { input: number; output: number; cost: number; inputText: string; outputText: string; costText: string; value: string },
+		diagnostics: FooterTemplateDiagnostic[],
+	): FooterItem[] {
+		const items: FooterItem[] = [];
+		const piSources = buildPiSources(footerData, stats);
+		lastPiSources = piSources;
 
+		const adaptedStatusKeys = adaptedExtensionStatusKeys();
 		const extStatuses = Array.from(footerData.getExtensionStatuses().entries())
 			.sort(([a], [b]) => a.localeCompare(b))
 			.flatMap(([key, value]) => {
 				const text = sanitizeStatusText(value);
-				if (key === "footer-framework" || key === "pr-upstream") return [];
+				if (key === "footer-framework" || key === "pr-upstream" || adaptedStatusKeys.has(key)) return [];
 				if (visibleWidth(text) === 0) return [];
-				if (settings.hideZeroMcp && /MCP:\s*0\/\d+\s+servers/.test(text)) return [];
 				return [text];
 			})
 			.join(" · ");
-		if (extStatuses) items.push({ id: "ext", text: extStatuses, placement: placementFor("ext", DEFAULT_ITEM_PLACEMENTS.ext) });
+		if (extStatuses && !configuredItemRenderers.ext) items.push({ id: "ext", text: extStatuses, placement: placementFor("ext", DEFAULT_ITEM_PLACEMENTS.ext), renderSource: "external" });
+
+		items.push(...collectConfiguredItems(theme, piSources, diagnostics));
+		items.push(...collectAdapterItems(theme, footerData, piSources, diagnostics));
 
 		for (const [id, external] of externalItems) {
-			if (!external.text) continue;
+			const text = renderExternalItem(theme, external);
+			if (!text) continue;
 			items.push({
 				id,
-				text: external.text,
-				placement: placementFor(id, { visible: true, line: 2, zone: "right", order: 100 }, external.placement),
+				text,
+				renderSource: "external",
+				placement: placementFor(id, { visible: true, line: 2, zone: "right", order: 100 }, external.hint.placement),
 			});
 		}
 
-		applyLegacySectionVisibility(items);
 		return resolveRelativeOrders(items).filter((item) => item.placement.visible && item.text.length > 0);
 	}
 
-	function applyFooterConfig(input: string, ctx?: ExtensionContext): string {
+	function compactRuntimeItem(item: { name: string; description?: string; sourceInfo?: unknown }, options: FooterSourceInventoryOptions) {
+		return options.includeDetails ? { name: item.name, description: item.description, sourceInfo: item.sourceInfo } : { name: item.name };
+	}
+
+	function footerSourceInventory(options: FooterSourceInventoryOptions = {}) {
+		const entries = currentCtx?.sessionManager.getEntries() ?? [];
+		const customEntries = new Map<string, { customType: string; count: number; latest: unknown }>();
+		for (const entry of entries as Array<{ type?: string; customType?: string; data?: unknown }>) {
+			if (entry.type !== "custom" || !entry.customType) continue;
+			const current = customEntries.get(entry.customType) ?? { customType: entry.customType, count: 0, latest: undefined };
+			current.count += 1;
+			current.latest = previewValue(entry.data);
+			customEntries.set(entry.customType, current);
+		}
+		const payload: Record<string, unknown> = {
+			builtInItems: Object.keys(DEFAULT_ITEM_PLACEMENTS).sort(),
+			piSources: Object.fromEntries(Object.entries(lastPiSources).map(([key, value]) => [key, previewValue(value)])),
+			stylePrimitives: {
+				foregroundColors: Array.from(THEME_FG_COLORS),
+				backgroundColors: Array.from(THEME_BG_COLORS),
+				attributes: Array.from(THEME_TEXT_ATTRIBUTES),
+			},
+			templateDiagnostics: lastTemplateDiagnostics,
+			defaultBuiltInAdapters: DEFAULT_BUILT_IN_ADAPTERS,
+			externalItems: Array.from(externalItems.values()).map((item) => ({
+				id: item.id,
+				label: item.label,
+				hasValue: item.value !== undefined,
+				hasStatus: item.status !== undefined,
+				hasData: item.data !== undefined,
+				hint: item.hint,
+			})),
+			extensionStatuses: lastFooterSnapshot?.extensionStatuses ?? [],
+			customEntries: Array.from(customEntries.values()).sort((a, b) => a.customType.localeCompare(b.customType)),
+			adapters: settings.adapters,
+			configuredRenderers: {
+				items: Object.fromEntries(Object.entries(configuredItemRenderers).map(([id, renderer]) => [id, { source: renderer.source }])),
+				adapters: Object.fromEntries(Object.entries(configuredAdapterRenderers).map(([id, renderer]) => [id, { source: renderer.source }])),
+			},
+			renderedItems: lastFooterSnapshot?.renderedItems ?? [],
+			configDiagnostics: lastConfigDiagnostics,
+			configPaths: configPaths(currentCtx),
+			omitted: {
+				tools: "pass includeTools: true to include registered tool names",
+				commands: "pass includeCommands: true to include command names",
+				details: "pass includeDetails: true with includeTools/includeCommands for descriptions and sourceInfo",
+				skills: "pass includeSkills: true with includeCommands to include skill commands",
+			},
+		};
+		if (options.includeTools) payload.tools = pi.getAllTools().map((tool) => compactRuntimeItem(tool, options));
+		if (options.includeCommands) {
+			const commands = options.includeSkills ? pi.getCommands() : pi.getCommands().filter((command) => !command.name.startsWith("skill:"));
+			payload.commands = commands.map((command) => compactRuntimeItem(command, options));
+		}
+		return payload;
+	}
+
+	async function applyFooterConfig(input: string, ctx?: ExtensionContext): Promise<string> {
 		try {
 			const trimmed = input.trim();
 			const [command, scope] = trimmed.split(/\s+/);
@@ -700,10 +1886,12 @@ export default function footerFramework(pi: ExtensionAPI): void {
 				shouldPersist = false;
 			} else if (command === "load") {
 				if (!ctx) return "Cannot load footer config before a session is active.";
-				message = `Loaded footer config from ${loadSettings(ctx)}.`;
+				message = `Loaded footer config from ${await loadSettings(ctx)}.`;
 				shouldPersist = false;
 			} else if (command === "config") {
-				message = [`Loaded: ${lastLoadedConfig}`, `User: ${userConfigPath()}`, ctx ? `Project: ${projectConfigPath(ctx)}` : "Project: unavailable before session"].join("\n");
+				message = [`Loaded: ${lastLoadedConfig}`, `Paths: ${JSON.stringify(configPaths(ctx), null, 2)}`, lastConfigDiagnostics.length ? `Diagnostics:\n${lastConfigDiagnostics.join("\n")}` : undefined]
+					.filter(Boolean)
+					.join("\n");
 				shouldPersist = false;
 			} else {
 				message = parseSettingsInput(settings, trimmed) ?? settingsSummary(settings, lastLoadedConfig);
@@ -736,7 +1924,7 @@ export default function footerFramework(pi: ExtensionAPI): void {
 					unsubscribe();
 				},
 				invalidate() {},
-				render(width: number): string[] {
+					render(width: number): string[] {
 					let input = 0;
 					let output = 0;
 					let cost = 0;
@@ -747,17 +1935,34 @@ export default function footerFramework(pi: ExtensionAPI): void {
 						cost += entry.message.usage.cost.total;
 					}
 
-					const statsText = theme.fg("dim", `↑${formatTokens(input)} ↓${formatTokens(output)} $${cost.toFixed(3)}`);
-					const items = collectItems(theme, footerData, statsText);
-					const line1Result = renderFooterLine(theme, width, items, 1, settings.line1Anchor);
-					const line2Result = renderFooterLine(theme, width, items, 2, settings.line2Anchor);
+					const stats = {
+						input,
+						output,
+						cost,
+						inputText: formatTokens(input),
+						outputText: formatTokens(output),
+						costText: cost.toFixed(3),
+						value: `↑${formatTokens(input)} ↓${formatTokens(output)} $${cost.toFixed(3)}`,
+					};
+					const diagnostics: FooterTemplateDiagnostic[] = [];
+					const items = collectItems(theme, footerData, stats, diagnostics);
+					lastTemplateDiagnostics = diagnostics;
+					const maxLine = Math.max(2, ...items.map((item) => item.placement.line));
+					const lineResults = Array.from({ length: maxLine }, (_, index) => {
+						const line = index + 1;
+						const result = renderFooterLine(theme, width, items, line, getLineAnchor(settings, line));
+						return { line, text: result.line, layout: result.layout };
+					});
+					const line1Result = lineResults[0];
+					const line2Result = lineResults[1];
 
 					lastFooterSnapshot = {
 						width,
-						line1: line1Result.line,
-						line2: line2Result.line,
-						line1Layout: line1Result.layout,
-						line2Layout: line2Result.layout,
+						lines: lineResults,
+						line1: line1Result?.text ?? "",
+						line2: line2Result?.text ?? "",
+						line1Layout: line1Result?.layout ?? renderFooterLine(theme, width, [], 1, getLineAnchor(settings, 1)).layout,
+						line2Layout: line2Result?.layout ?? renderFooterLine(theme, width, [], 2, getLineAnchor(settings, 2)).layout,
 						gitBranch: footerData.getGitBranch(),
 						renderedItems: items.map((item) => ({
 							id: item.id,
@@ -766,6 +1971,8 @@ export default function footerFramework(pi: ExtensionAPI): void {
 							order: item.placement.order,
 							column: item.placement.column,
 							width: visibleWidth(item.text),
+							renderSource: item.renderSource,
+							tokens: item.tokens,
 						})),
 						extensionStatuses: Array.from(footerData.getExtensionStatuses().entries()).map(([key, value]) => ({ key, value })),
 						model: ctx.model?.id ?? "no-model",
@@ -773,7 +1980,7 @@ export default function footerFramework(pi: ExtensionAPI): void {
 						thinkingLevel: pi.getThinkingLevel(),
 						cwd: ctx.cwd,
 					};
-					return [line1Result.line, line2Result.line];
+					return lineResults.map((line) => line.text);
 				},
 			};
 		});
@@ -790,23 +1997,25 @@ export default function footerFramework(pi: ExtensionAPI): void {
 
 	pi.events.on("footer-framework:item", (event) => {
 		const item = event as ExternalFooterItemEvent;
-		if (!item.id?.trim()) return;
-		if (item.remove) externalItems.delete(item.id);
-		else if (typeof item.text === "string") {
-			externalItems.set(item.id, { text: item.text, placement: normalizePlacement(item.placement ?? {}) });
+		const id = item.id?.trim();
+		if (!id) return;
+		if (item.remove) externalItems.delete(id);
+		else {
+			const normalized = normalizeExternalItemEvent(item);
+			if (normalized) externalItems.set(id, normalized);
 		}
 		requestRender?.();
 	});
 
 	pi.registerCommand("footerfx", {
-		description: "Footer framework controls (on/off, section, gap, branch-width, mcp-zero, reset)",
+		description: "Footer framework controls (on/off, item layout, anchor, gap, reset)",
 		handler: async (args, ctx) => {
 			const trimmed = args.trim();
 			if (!trimmed) {
-				ctx.ui.notify(settingsSummary(settings, lastLoadedConfig), "info");
+				ctx.ui.notify(settingsSummary(settings, lastLoadedConfig, lastConfigDiagnostics), "info");
 				return;
 			}
-			ctx.ui.notify(applyFooterConfig(trimmed, ctx), "info");
+			ctx.ui.notify(await applyFooterConfig(trimmed, ctx), "info");
 		},
 	});
 
@@ -816,8 +2025,14 @@ export default function footerFramework(pi: ExtensionAPI): void {
 			const payload = {
 				settings,
 				loadedConfig: lastLoadedConfig,
-				configPaths: { user: userConfigPath(), project: projectConfigPath(ctx) },
+				configDiagnostics: lastConfigDiagnostics,
+				configPaths: configPaths(ctx),
+				configuredRenderers: {
+					items: Object.fromEntries(Object.entries(configuredItemRenderers).map(([id, renderer]) => [id, { source: renderer.source }])),
+					adapters: Object.fromEntries(Object.entries(configuredAdapterRenderers).map(([id, renderer]) => [id, { source: renderer.source }])),
+				},
 				prState,
+				lastTemplateDiagnostics,
 				lastFooterSnapshot,
 			};
 			ctx.ui.notify(JSON.stringify(payload, null, 2), "info");
@@ -834,8 +2049,14 @@ export default function footerFramework(pi: ExtensionAPI): void {
 				const payload = {
 					settings,
 					loadedConfig: lastLoadedConfig,
-					configPaths: currentCtx ? { user: userConfigPath(), project: projectConfigPath(currentCtx) } : { user: userConfigPath() },
+					configDiagnostics: lastConfigDiagnostics,
+					configPaths: configPaths(currentCtx),
+					configuredRenderers: {
+						items: Object.fromEntries(Object.entries(configuredItemRenderers).map(([id, renderer]) => [id, { source: renderer.source }])),
+						adapters: Object.fromEntries(Object.entries(configuredAdapterRenderers).map(([id, renderer]) => [id, { source: renderer.source }])),
+					},
 					prState,
+					lastTemplateDiagnostics,
 					lastFooterSnapshot,
 				};
 				return {
@@ -846,6 +2067,79 @@ export default function footerFramework(pi: ExtensionAPI): void {
 		}),
 	);
 
+	pi.registerTool(
+		defineTool({
+			name: "footer_framework_sources",
+			label: "Footer Framework Sources",
+			description: "Inspect data sources the footer framework can adapt into footer items. Defaults to concise footer-relevant data; pass includeTools/includeCommands for runtime metadata.",
+			parameters: Type.Object({
+				includeTools: Type.Optional(Type.Boolean({ description: "Include registered tool names. Default false to avoid bloating footer discovery output." })),
+				includeCommands: Type.Optional(Type.Boolean({ description: "Include command names. Default false to avoid bloating footer discovery output." })),
+				includeSkills: Type.Optional(Type.Boolean({ description: "Include skill commands when includeCommands is true. Default false." })),
+				includeDetails: Type.Optional(Type.Boolean({ description: "Include descriptions and sourceInfo for included tools/commands. Default false." })),
+			}),
+			async execute(_toolCallId, params) {
+				const payload = footerSourceInventory(params as FooterSourceInventoryOptions);
+				return {
+					content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+					details: payload,
+				};
+			},
+		}),
+	);
+
+	pi.registerTool(
+		defineTool({
+			name: "footer_framework_adapter_config",
+			label: "Footer Framework Adapter Config",
+			description: "List, set, or remove footer adapters that map existing Pi/extension data sources into framework-owned footer items",
+			parameters: Type.Object({
+				action: Type.String({ description: "One of: list, set, remove" }),
+				id: Type.Optional(Type.String({ description: "Adapter id for set/remove" })),
+				adapterJson: Type.Optional(Type.String({ description: "JSON adapter config for set. Required fields: source ('pi', 'extensionStatus', or 'sessionEntry') and key." })),
+			}),
+			async execute(_toolCallId, params) {
+				const action = params.action.trim();
+				let message: string;
+				if (action === "list") {
+					message = JSON.stringify(
+						{
+							defaultBuiltInAdapters: DEFAULT_BUILT_IN_ADAPTERS,
+							adapters: settings.adapters,
+							configuredAdapterRenderers: Object.fromEntries(Object.entries(configuredAdapterRenderers).map(([id, renderer]) => [id, { source: renderer.source }])),
+						},
+						null,
+						2,
+					);
+				} else if (action === "remove") {
+					if (!params.id?.trim()) throw new Error("remove requires id");
+					const id = params.id.trim();
+					delete settings.adapters[id];
+					if (DEFAULT_BUILT_IN_ADAPTERS[id]) (settings.items[id] ??= {}).visible = false;
+					persistSettings();
+					if (currentCtx) installFooter(currentCtx);
+					message = DEFAULT_BUILT_IN_ADAPTERS[id] ? `Built-in item ${id} hidden.` : `Adapter ${id} removed.`;
+				} else if (action === "set") {
+					if (!params.id?.trim()) throw new Error("set requires id");
+					if (!params.adapterJson?.trim()) throw new Error("set requires adapterJson");
+					const adapter = normalizeAdapter(JSON.parse(params.adapterJson));
+					if (!adapter) throw new Error("adapterJson must include valid source and key");
+					settings.adapters[params.id.trim()] = adapter;
+					persistSettings();
+					if (currentCtx) installFooter(currentCtx);
+					message = `Adapter ${params.id.trim()} saved.`;
+				} else {
+					throw new Error("action must be list, set, or remove");
+				}
+				const payload = { message, adapters: settings.adapters };
+				return {
+					content: [{ type: "text", text: message }],
+					details: payload,
+				};
+			},
+		}),
+	);
+
 	pi.registerTool(
 		defineTool({
 			name: "footer_framework_config",
@@ -854,11 +2148,11 @@ export default function footerFramework(pi: ExtensionAPI): void {
 			parameters: Type.Object({
 				command: Type.String({
 					description:
-						"Same syntax as /footerfx, e.g. 'section context on', 'item context after stats', 'anchor all right', 'gap 1 10', 'save project', 'load', 'on', 'off', 'reset'",
+						"Same syntax as /footerfx, e.g. 'section context on', 'item context line 3', 'item context after stats', 'anchor all right', 'gap 1 10', 'save project', 'load', 'on', 'off', 'reset'",
 				}),
 			}),
 			async execute(_toolCallId, params) {
-				const message = applyFooterConfig(params.command, currentCtx);
+				const message = await applyFooterConfig(params.command, currentCtx);
 				return {
 					content: [{ type: "text", text: message }],
 					details: { message, settings },
@@ -869,7 +2163,7 @@ export default function footerFramework(pi: ExtensionAPI): void {
 
 	pi.on("session_start", async (_event, ctx) => {
 		currentCtx = ctx;
-		loadSettings(ctx);
+		await loadSettings(ctx);
 
 		// Compatibility migration: if no config file exists yet, seed from the last
 		// session entry and immediately persist it as the user default.