pi-interactive-shell 0.3.0

package/config.ts

@@ -0,0 +1,132 @@
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+export interface InteractiveShellConfig {
+	doubleEscapeThreshold: number;
+	exitAutoCloseDelay: number;
+	overlayWidthPercent: number;
+	overlayHeightPercent: number;
+	scrollbackLines: number;
+	ansiReemit: boolean;
+	handoffPreviewEnabled: boolean;
+	handoffPreviewLines: number;
+	handoffPreviewMaxChars: number;
+	handoffSnapshotEnabled: boolean;
+	handoffSnapshotLines: number;
+	handoffSnapshotMaxChars: number;
+	// Hands-free mode defaults
+	handsFreeUpdateMode: "on-quiet" | "interval";
+	handsFreeUpdateInterval: number;
+	handsFreeQuietThreshold: number;
+	handsFreeUpdateMaxChars: number;
+	handsFreeMaxTotalChars: number;
+}
+
+const DEFAULT_CONFIG: InteractiveShellConfig = {
+	doubleEscapeThreshold: 300,
+	exitAutoCloseDelay: 10,
+	overlayWidthPercent: 95,
+	overlayHeightPercent: 90,
+	scrollbackLines: 5000,
+	ansiReemit: true,
+	handoffPreviewEnabled: true,
+	handoffPreviewLines: 30,
+	handoffPreviewMaxChars: 2000,
+	handoffSnapshotEnabled: false,
+	handoffSnapshotLines: 200,
+	handoffSnapshotMaxChars: 12000,
+	// Hands-free mode defaults
+	handsFreeUpdateMode: "on-quiet" as const,
+	handsFreeUpdateInterval: 60000,
+	handsFreeQuietThreshold: 5000,
+	handsFreeUpdateMaxChars: 1500,
+	handsFreeMaxTotalChars: 100000,
+};
+
+export function loadConfig(cwd: string): InteractiveShellConfig {
+	const projectPath = join(cwd, ".pi", "interactive-shell.json");
+	const globalPath = join(homedir(), ".pi", "agent", "interactive-shell.json");
+
+	let globalConfig: Partial<InteractiveShellConfig> = {};
+	let projectConfig: Partial<InteractiveShellConfig> = {};
+
+	if (existsSync(globalPath)) {
+		try {
+			globalConfig = JSON.parse(readFileSync(globalPath, "utf-8"));
+		} catch (error) {
+			console.error(`Warning: Could not parse ${globalPath}: ${String(error)}`);
+		}
+	}
+
+	if (existsSync(projectPath)) {
+		try {
+			projectConfig = JSON.parse(readFileSync(projectPath, "utf-8"));
+		} catch (error) {
+			console.error(`Warning: Could not parse ${projectPath}: ${String(error)}`);
+		}
+	}
+
+	const merged = { ...DEFAULT_CONFIG, ...globalConfig, ...projectConfig };
+
+	return {
+		...merged,
+		overlayWidthPercent: clampPercent(merged.overlayWidthPercent, DEFAULT_CONFIG.overlayWidthPercent),
+		overlayHeightPercent: clampPercent(merged.overlayHeightPercent, DEFAULT_CONFIG.overlayHeightPercent),
+		scrollbackLines: Math.max(200, merged.scrollbackLines ?? DEFAULT_CONFIG.scrollbackLines),
+		ansiReemit: merged.ansiReemit !== false,
+		handoffPreviewEnabled: merged.handoffPreviewEnabled !== false,
+		handoffPreviewLines: clampInt(merged.handoffPreviewLines, DEFAULT_CONFIG.handoffPreviewLines, 0, 500),
+		handoffPreviewMaxChars: clampInt(
+			merged.handoffPreviewMaxChars,
+			DEFAULT_CONFIG.handoffPreviewMaxChars,
+			0,
+			50000,
+		),
+		handoffSnapshotEnabled: merged.handoffSnapshotEnabled === true,
+		handoffSnapshotLines: clampInt(merged.handoffSnapshotLines, DEFAULT_CONFIG.handoffSnapshotLines, 0, 5000),
+		handoffSnapshotMaxChars: clampInt(
+			merged.handoffSnapshotMaxChars,
+			DEFAULT_CONFIG.handoffSnapshotMaxChars,
+			0,
+			200000,
+		),
+		// Hands-free mode
+		handsFreeUpdateMode: merged.handsFreeUpdateMode === "interval" ? "interval" : "on-quiet",
+		handsFreeUpdateInterval: clampInt(
+			merged.handsFreeUpdateInterval,
+			DEFAULT_CONFIG.handsFreeUpdateInterval,
+			5000,
+			300000,
+		),
+		handsFreeQuietThreshold: clampInt(
+			merged.handsFreeQuietThreshold,
+			DEFAULT_CONFIG.handsFreeQuietThreshold,
+			1000,
+			30000,
+		),
+		handsFreeUpdateMaxChars: clampInt(
+			merged.handsFreeUpdateMaxChars,
+			DEFAULT_CONFIG.handsFreeUpdateMaxChars,
+			500,
+			50000,
+		),
+		handsFreeMaxTotalChars: clampInt(
+			merged.handsFreeMaxTotalChars,
+			DEFAULT_CONFIG.handsFreeMaxTotalChars,
+			10000,
+			1000000,
+		),
+	};
+}
+
+function clampPercent(value: number | undefined, fallback: number): number {
+	if (typeof value !== "number" || Number.isNaN(value)) return fallback;
+	return Math.min(100, Math.max(10, value));
+}
+
+function clampInt(value: number | undefined, fallback: number, min: number, max: number): number {
+	if (typeof value !== "number" || Number.isNaN(value)) return fallback;
+	const rounded = Math.trunc(value);
+	return Math.min(max, Math.max(min, rounded));
+}