@xynogen/pix-runtime 0.1.2 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@xynogen/pix-runtime",
-	"version": "0.1.2",
+	"version": "0.3.0",
 	"description": "Pix shared runtime — versioned pix.json config, atomic persistence, typed change events",
 	"type": "module",
 	"main": "src/index.ts",

package/src/collapse.ts

@@ -18,3 +18,34 @@ export function shouldCollapse(toolName: string): boolean {
 export function collapseDelayMs(): number {
 	return pixRuntime().get(collapseSection).delaySec * 1000;
 }
+
+/** Per-card render state bag for the collapse timer. */
+export interface CollapseState {
+	collapsed?: boolean;
+	timer?: ReturnType<typeof setTimeout>;
+}
+
+/**
+ * Run the collapse timer for a tool card. Call this inside `renderResult`.
+ *
+ * @param toolName — the tool name (e.g. "bash", "read") for per-tool config
+ * @param state    — the render context's `state` bag (mutable, per-card)
+ * @param invalidate — `context.invalidate()` to trigger re-render
+ * @param expanded — whether the host currently requests the detailed view
+ * @returns `true` if the card is currently collapsed and not expanded
+ */
+export function tickCollapse(
+	toolName: string,
+	state: CollapseState,
+	invalidate: () => void,
+	expanded = false,
+): boolean {
+	if (!shouldCollapse(toolName)) return false;
+	if (!state.timer && !state.collapsed) {
+		state.timer = setTimeout(() => {
+			state.collapsed = true;
+			invalidate();
+		}, collapseDelayMs());
+	}
+	return state.collapsed === true && !expanded;
+}

package/src/pix-command.ts

@@ -12,7 +12,6 @@ import type { PixRuntime } from "./runtime.ts";
 import type { DeepPartial, SectionHandle } from "./schema.ts";
 import { collapseSection } from "./sections/collapse.ts";
 import { gateSection } from "./sections/gate.ts";
-import { optimizerSection } from "./sections/optimizer.ts";
 import { prettySection } from "./sections/pretty.ts";
 
 interface SettingRow<T> {
@@ -62,29 +61,13 @@ const SETTINGS: SettingRow<unknown>[] = [
 		read: (v) => String(v.delaySec),
 		patch: (value) => ({ delaySec: Number(value) }),
 	}),
-	row({
-		section: "Optimizer",
-		label: "caveman",
-		handle: optimizerSection,
-		values: ["off", "lite", "full", "ultra", "micro"],
-		read: (v) => v.caveman,
-		patch: (value) => ({ caveman: value as "off" | "lite" | "full" | "ultra" | "micro" }),
-	}),
-	row({
-		section: "Optimizer",
-		label: "rtk",
-		handle: optimizerSection,
-		values: ["on", "off"],
-		read: (v) => v.rtk,
-		patch: (value) => ({ rtk: value as "on" | "off" }),
-	}),
 	row({
 		section: "Gate",
-		label: "disable defaults",
+		label: "Guardrails",
 		handle: gateSection,
-		values: ["false", "true"],
-		read: (v) => String(v.disableDefaults),
-		patch: (value) => ({ disableDefaults: value === "true" }),
+		values: ["on", "off"],
+		read: (v) => v.guardrails,
+		patch: (guardrails) => ({ guardrails: guardrails as "on" | "off" }),
 	}),
 ];
 
@@ -124,6 +107,7 @@ export function registerPixCommand(pi: ExtensionAPI, runtime: PixRuntime): void
 					tui: { requestRender(): void },
 					theme: {
 						fg(c: string, t: string): string;
+						bg(c: string, t: string): string;
 						bold(t: string): string;
 					},
 					_kb: unknown,
@@ -165,7 +149,12 @@ export function registerPixCommand(pi: ExtensionAPI, runtime: PixRuntime): void
 							}
 							lines.push("");
 							lines.push(theme.fg("dim", "←→ change · ↑↓ move · esc close"));
-							return lines;
+							return frameLines({
+								width: boxW,
+								lines,
+								color: (s: string) => theme.fg("accent", s),
+								bg: (s: string) => theme.bg("customMessageBg", s),
+							});
 						},
 						invalidate: () => {},
 						handleInput: (data: string) => {
@@ -195,3 +184,47 @@ export function registerPixCommand(pi: ExtensionAPI, runtime: PixRuntime): void
 		},
 	});
 }
+
+// ── Inline frameLines (runtime must not depend on pix-pretty — pretty depends on us) ─
+
+interface FrameOptions {
+	width: number;
+	lines: string[];
+	color: (s: string) => string;
+	bg?: (s: string) => string;
+}
+
+function visibleWidth(s: string): number {
+	// Strip ANSI escape sequences for width calculation.
+	return s.replace(/\x1b\[[0-9;]*m/g, "").length;
+}
+
+/** Render a rounded bordered modal box (╭─╮╰─╯) with solid background fill. */
+function frameLines(opts: FrameOptions): string[] {
+	const { width, lines, color } = opts;
+	const bg = opts.bg ?? ((s: string) => s);
+	const inner = Math.max(1, width - 4); // 2 border + 2 padding
+	const dashes = "─".repeat(width - 2);
+
+	// Re-assert the bg OPEN sequence after any full reset (\x1b[0m) or bg reset
+	// (\x1b[49m) embedded in themed content, so the fill has no transparent holes.
+	const SENTINEL = "\x00";
+	const bgOpen = bg(SENTINEL).split(SENTINEL)[0] ?? "";
+	const reassert = (s: string): string =>
+		bgOpen
+			? s.replace(/\x1b\[([0-9;]*)m/g, (seq, p: string) =>
+					p === "0" || p.split(";").includes("49") ? `${seq}${bgOpen}` : seq,
+				)
+			: s;
+
+	const row = (content: string): string => {
+		const pad = inner - visibleWidth(content);
+		const padded = pad > 0 ? content + " ".repeat(pad) : content.slice(0, inner);
+		return bg(`${color("│")} ${reassert(padded)} ${color("│")}`);
+	};
+
+	const out: string[] = [bg(color(`╭${dashes}╮`))];
+	for (const line of lines) out.push(row(line));
+	out.push(bg(color(`╰${dashes}╯`)));
+	return out;
+}

package/src/sections/gate.ts

@@ -1,4 +1,4 @@
-import { boolOr, defineSection, isObj, strArr } from "../schema.ts";
+import { defineSection, enumOr, isObj, strArr } from "../schema.ts";
 
 export type GateSeverity = "risky" | "dangerous" | "critical";
 
@@ -10,7 +10,8 @@ export interface GateRuleConfig {
 }
 
 export interface GateConfig {
-	disableDefaults: boolean;
+	/** Whether Pix's built-in command protections are active. */
+	guardrails: "on" | "off";
 	autoApprove: string[];
 	extraRules: GateRuleConfig[];
 }
@@ -18,7 +19,7 @@ export interface GateConfig {
 const SEVERITIES: readonly GateSeverity[] = ["risky", "dangerous", "critical"];
 
 const DEFAULTS: Readonly<GateConfig> = {
-	disableDefaults: false,
+	guardrails: "on",
 	autoApprove: [],
 	extraRules: [],
 };
@@ -37,7 +38,7 @@ export const gateSection = defineSection<"gate", GateConfig>({
 	key: "gate",
 	defaults: DEFAULTS,
 	parse(raw, ctx) {
-		if (!isObj(raw)) return { disableDefaults: false, autoApprove: [], extraRules: [] };
+		if (!isObj(raw)) return { guardrails: "on", autoApprove: [], extraRules: [] };
 		const extraRules: GateRuleConfig[] = [];
 		if (Array.isArray(raw.extraRules)) {
 			raw.extraRules.forEach((r, i) => {
@@ -63,7 +64,7 @@ export const gateSection = defineSection<"gate", GateConfig>({
 			});
 		}
 		return {
-			disableDefaults: boolOr(raw.disableDefaults, DEFAULTS.disableDefaults),
+			guardrails: enumOr(raw.guardrails, ["on", "off"], DEFAULTS.guardrails),
 			autoApprove: strArr(raw.autoApprove),
 			extraRules,
 		};