pi-harness-runtime 1.1.134 → 1.1.136

package/packages/tui/dist/harness-header.js

@@ -0,0 +1,184 @@
+/**
+ * Harness ASCII Banner — a Pi-compatible custom header using Unicode half-block art.
+ *
+ * Uses the same half-block rendering technique as Pi's built-in header:
+ * - `▀` (U+2580) fills the upper half of a terminal cell
+ * - `▄` (U+2584) fills the lower half of a terminal cell
+ * - Foreground + background color creates two "pixels" per cell
+ *
+ * Logo: 4 cells wide × 2 rows. Pattern is Harness-branded (accent + success colors).
+ * Compact/expanded states respond to Ctrl+O via Pi's global setExpanded() mechanism.
+ *
+ * MIT — derived from general technique documented in upstream pi-coding-agent.
+ * Harness branding is original work of the harness project.
+ */
+import { keyText, keyHint, rawKeyHint } from "@earendil-works/pi-coding-agent";
+// ---------------------------------------------------------------------------
+// Logo design
+// ---------------------------------------------------------------------------
+//
+// Logical 4×4 pixel grid (each cell = foreground+background color pair):
+//
+//   Row 0: ░ ░ ▓ ▒  (top half-blocks: accent, accent, dim, dim)
+//   Row 1: ▓ ░ ░ ▒  (bottom half-blocks: dim, success, success, dim)
+//
+// Rendered as 2 text rows with 4 terminal cells per row:
+//   Line 0: ▀▀█▄  (▀ = upper-half, █ = full-block, ▄ = lower-half)
+//   Line 1: █▀▀▄  (same characters, different color pairing)
+//
+// Colors:
+//   - accent   = harness primary (teal in harness theme, adapts to user's theme)
+//   - success  = harness secondary (green in harness theme)
+//   - muted    = dim teal (for visual depth)
+//   - dim      = dim blue (for visual depth)
+//
+// The logo is NOT Pi's logo — it uses the same rendering technique only.
+// Logo glyphs documented in logoLines() for reference.
+/** Harness primary color — uses theme "accent" (teal in harness theme) */
+function logoAccent(text, theme) {
+    return theme.fg("accent", text);
+}
+/** Harness secondary color — uses theme "success" (green in harness theme) */
+function logoSecondary(text, theme) {
+    return theme.fg("success", text);
+}
+/** Dim foreground — uses theme "muted" for depth */
+function logoDim(text, theme) {
+    return theme.fg("muted", text);
+}
+/**
+ * Build the two colored logo lines for the Harness mark.
+ *
+ * Color segment per cell (each char = one terminal cell):
+ *   Line 0:  ▀▀█▄   →  ▀(accent) ▀(accent) █(muted) ▄(muted)
+ *   Line 1:  █▀▀▄   →  █(muted) ▀(success) ▀(success) ▄(muted)
+ */
+function logoLines(theme) {
+    return [
+        logoAccent("▀", theme) +
+            logoAccent("▀", theme) +
+            logoDim("█", theme) +
+            logoDim("▄", theme),
+        logoDim("█", theme) +
+            logoSecondary("▀", theme) +
+            logoSecondary("▀", theme) +
+            logoDim("▄", theme),
+    ];
+}
+// ---------------------------------------------------------------------------
+// Fallback (Apple Terminal, no half-block support, or print/RPC modes)
+// ---------------------------------------------------------------------------
+const FALLBACK_LOGO_LINE0 = "Harness";
+const FALLBACK_LOGO_LINE1 = "";
+export function createHarnessHeader(_tui, _theme, options) {
+    return new HarnessHeaderComponent(_theme, options);
+}
+class HarnessHeaderComponent {
+    theme;
+    options;
+    expanded = false;
+    supportsHalfBlocks = true;
+    constructor(theme, options) {
+        this.theme = theme;
+        this.options = {
+            productName: "Harness",
+            onboardingText: "Harness extends Pi with quota management, automation, memory, and multi-agent workflows.",
+            ...options,
+        };
+    }
+    // --- Component interface ---
+    render(_width) {
+        const { version, onboardingText } = this.options;
+        // Logo: half-block art or plain fallback
+        const [logoLine0, logoLine1] = this.supportsHalfBlocks
+            ? logoLines(this.theme)
+            : [FALLBACK_LOGO_LINE0, FALLBACK_LOGO_LINE1];
+        const versionStr = this.theme.fg("dim", `v${version}`);
+        const expandKey = keyText("app.tools.expand");
+        const onboarding = this.theme.fg("dim", onboardingText);
+        if (this.expanded) {
+            return this.renderExpanded(logoLine0, versionStr, expandKey, onboarding);
+        }
+        return this.renderCompact(logoLine0, logoLine1, versionStr, expandKey, onboarding);
+    }
+    renderCompact(logoLine0, logoLine1, versionStr, expandKey, onboarding) {
+        const { productName } = this.options;
+        // Build compact one-line shortcuts
+        const hints = [
+            keyHint("app.interrupt", "interrupt"),
+            rawKeyHint(`${keyText("app.clear")}/${keyText("app.exit")}`, "clear/exit"),
+            rawKeyHint("/", "commands"),
+            rawKeyHint("!", "bash"),
+            keyHint("app.tools.expand", "more"),
+        ].join(this.theme.fg("muted", " · "));
+        // Line 0: logo + product name + version
+        const line0 = `${logoLine0}  ${this.theme.fg("text", productName)} ${versionStr}`;
+        // Line 1: bottom logo row + compact hints
+        const line1 = `${logoLine1}  ${hints}`;
+        // Line 2: expand prompt
+        const line2 = this.theme.fg("dim", `Press ${expandKey} to show full startup help and loaded resources.`);
+        // Line 4 (blank line 3): onboarding
+        const line4 = onboarding;
+        return ["", line0, line1, line2, "", line4, ""];
+    }
+    renderExpanded(logoLine0, versionStr, expandKey, onboarding) {
+        const { productName } = this.options;
+        // Line 0: logo + product name + version
+        const line0 = `${logoLine0}  ${this.theme.fg("text", productName)} ${versionStr}`;
+        // Expanded: one shortcut per line
+        const expandedLines = [
+            keyHint("app.interrupt", "abort the current agent turn"),
+            keyHint("app.clear", "clear the current session"),
+            keyHint("app.exit", "exit Pi"),
+            rawKeyHint("/", "show available slash commands"),
+            rawKeyHint("!", "open a bash shell"),
+            keyHint("app.tools.expand", "expand/collapse tool output and this header"),
+            this.theme.fg("muted", `${expandKey} to collapse`),
+        ];
+        // Line 2: expand prompt
+        const line2 = this.theme.fg("dim", `Press ${expandKey} to show compact header.`);
+        // Line 4: onboarding
+        const line4 = onboarding;
+        // Compose: blank, logo, blank, expanded hints (indented), blank, expand prompt, blank, onboarding, blank
+        const result = [""];
+        result.push(line0);
+        result.push(""); // blank after logo
+        for (const hint of expandedLines) {
+            result.push(`  ${hint}`);
+        }
+        result.push("");
+        result.push(line2);
+        result.push("");
+        result.push(line4);
+        result.push("");
+        return result;
+    }
+    invalidate() {
+        // Theme changes or expansion state changes call this to request re-render.
+        // The TUI calls render() again automatically.
+    }
+    // --- Expandable interface (called by Pi when Ctrl+O toggles) ---
+    setExpanded(expanded) {
+        if (this.expanded === expanded)
+            return;
+        this.expanded = expanded;
+        this.invalidate();
+    }
+    // --- Cleanup ---
+    dispose() {
+        // No persistent resources to clean up.
+    }
+}
+// ---------------------------------------------------------------------------
+// Visible width helper (ANSI-aware)
+// ---------------------------------------------------------------------------
+/** Strip ANSI escape sequences to get visible character count. */
+export function visibleWidth(str) {
+    // Remove all ANSI CSI sequences: \x1b[...X
+    return str.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, "").length;
+}
+/** Strip ANSI to get plain text for width/equality checks. */
+export function stripAnsi(str) {
+    return str.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, "");
+}
+//# sourceMappingURL=harness-header.js.map

package/packages/tui/dist/harness-header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-header.js","sourceRoot":"","sources":["../src/harness-header.ts"],"names":[],"mappings":"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"}

package/packages/tui/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @pi-harness/tui — TUI integration utilities for pi-harness-runtime.
+ *
+ * Exports the Harness custom header component that replaces Pi's built-in
+ * startup banner with a harness-branded version using Unicode half-block art.
+ */
+export { createHarnessHeader, type HarnessHeaderOptions } from "./harness-header.js";
+export { visibleWidth, stripAnsi } from "./harness-header.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/tui/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC"}

package/packages/tui/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * @pi-harness/tui — TUI integration utilities for pi-harness-runtime.
+ *
+ * Exports the Harness custom header component that replaces Pi's built-in
+ * startup banner with a harness-branded version using Unicode half-block art.
+ */
+export { createHarnessHeader } from "./harness-header.js";
+export { visibleWidth, stripAnsi } from "./harness-header.js";
+//# sourceMappingURL=index.js.map

package/packages/tui/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAA6B,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC"}

package/packages/tui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/tui",
-  "version": "1.1.134",
+  "version": "1.1.136",
   "description": "pi-harness-runtime — tui",
   "type": "module",
   "main": "./dist/index.js",

package/packages/tui/src/harness-header.ts

@@ -0,0 +1,255 @@
+/**
+ * Harness ASCII Banner — a Pi-compatible custom header using Unicode half-block art.
+ *
+ * Uses the same half-block rendering technique as Pi's built-in header:
+ * - `▀` (U+2580) fills the upper half of a terminal cell
+ * - `▄` (U+2584) fills the lower half of a terminal cell
+ * - Foreground + background color creates two "pixels" per cell
+ *
+ * Logo: 4 cells wide × 2 rows. Pattern is Harness-branded (accent + success colors).
+ * Compact/expanded states respond to Ctrl+O via Pi's global setExpanded() mechanism.
+ *
+ * MIT — derived from general technique documented in upstream pi-coding-agent.
+ * Harness branding is original work of the harness project.
+ */
+
+import type { Component, TUI } from "@earendil-works/pi-tui";
+
+// Re-export Theme from pi-coding-agent since @pi-harness/tui has no theme dependency.
+// Extensions already depend on @earendil-works/pi-coding-agent.
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import { keyText, keyHint, rawKeyHint } from "@earendil-works/pi-coding-agent";
+
+// ---------------------------------------------------------------------------
+// Logo design
+// ---------------------------------------------------------------------------
+//
+// Logical 4×4 pixel grid (each cell = foreground+background color pair):
+//
+//   Row 0: ░ ░ ▓ ▒  (top half-blocks: accent, accent, dim, dim)
+//   Row 1: ▓ ░ ░ ▒  (bottom half-blocks: dim, success, success, dim)
+//
+// Rendered as 2 text rows with 4 terminal cells per row:
+//   Line 0: ▀▀█▄  (▀ = upper-half, █ = full-block, ▄ = lower-half)
+//   Line 1: █▀▀▄  (same characters, different color pairing)
+//
+// Colors:
+//   - accent   = harness primary (teal in harness theme, adapts to user's theme)
+//   - success  = harness secondary (green in harness theme)
+//   - muted    = dim teal (for visual depth)
+//   - dim      = dim blue (for visual depth)
+//
+// The logo is NOT Pi's logo — it uses the same rendering technique only.
+
+// Logo glyphs documented in logoLines() for reference.
+
+/** Harness primary color — uses theme "accent" (teal in harness theme) */
+function logoAccent(text: string, theme: Theme): string {
+	return theme.fg("accent", text);
+}
+
+/** Harness secondary color — uses theme "success" (green in harness theme) */
+function logoSecondary(text: string, theme: Theme): string {
+	return theme.fg("success", text);
+}
+
+/** Dim foreground — uses theme "muted" for depth */
+function logoDim(text: string, theme: Theme): string {
+	return theme.fg("muted", text);
+}
+
+/**
+ * Build the two colored logo lines for the Harness mark.
+ *
+ * Color segment per cell (each char = one terminal cell):
+ *   Line 0:  ▀▀█▄   →  ▀(accent) ▀(accent) █(muted) ▄(muted)
+ *   Line 1:  █▀▀▄   →  █(muted) ▀(success) ▀(success) ▄(muted)
+ */
+function logoLines(theme: Theme): [string, string] {
+	return [
+		logoAccent("▀", theme) +
+		logoAccent("▀", theme) +
+		logoDim("█", theme) +
+		logoDim("▄", theme),
+		logoDim("█", theme) +
+		logoSecondary("▀", theme) +
+		logoSecondary("▀", theme) +
+		logoDim("▄", theme),
+	];
+}
+
+// ---------------------------------------------------------------------------
+// Fallback (Apple Terminal, no half-block support, or print/RPC modes)
+// ---------------------------------------------------------------------------
+
+const FALLBACK_LOGO_LINE0 = "Harness";
+const FALLBACK_LOGO_LINE1 = "";
+
+// ---------------------------------------------------------------------------
+// HarnessHeader component
+// ---------------------------------------------------------------------------
+
+export interface HarnessHeaderOptions {
+	version: string;
+	productName?: string;
+	onboardingText?: string;
+}
+
+export function createHarnessHeader(
+	_tui: TUI,
+	_theme: Theme,
+	options: HarnessHeaderOptions,
+): HarnessHeaderComponent {
+	return new HarnessHeaderComponent(_theme, options);
+}
+
+class HarnessHeaderComponent implements Component {
+	private readonly theme: Theme;
+	private readonly options: Required<HarnessHeaderOptions>;
+	private expanded = false;
+	private supportsHalfBlocks = true;
+
+	constructor(theme: Theme, options: HarnessHeaderOptions) {
+		this.theme = theme;
+		this.options = {
+			productName: "Harness",
+			onboardingText:
+				"Harness extends Pi with quota management, automation, memory, and multi-agent workflows.",
+			...options,
+		};
+	}
+
+	// --- Component interface ---
+
+	render(_width: number): string[] {
+		const { version, onboardingText } = this.options;
+
+		// Logo: half-block art or plain fallback
+		const [logoLine0, logoLine1] = this.supportsHalfBlocks
+			? logoLines(this.theme)
+			: [FALLBACK_LOGO_LINE0, FALLBACK_LOGO_LINE1];
+
+		const versionStr = this.theme.fg("dim", `v${version}`);
+		const expandKey = keyText("app.tools.expand");
+		const onboarding = this.theme.fg("dim", onboardingText);
+
+		if (this.expanded) {
+			return this.renderExpanded(logoLine0, versionStr, expandKey, onboarding);
+		}
+		return this.renderCompact(logoLine0, logoLine1, versionStr, expandKey, onboarding);
+	}
+
+	private renderCompact(
+		logoLine0: string,
+		logoLine1: string,
+		versionStr: string,
+		expandKey: string,
+		onboarding: string,
+	): string[] {
+		const { productName } = this.options;
+
+		// Build compact one-line shortcuts
+		const hints = [
+			keyHint("app.interrupt", "interrupt"),
+			rawKeyHint(`${keyText("app.clear")}/${keyText("app.exit")}`, "clear/exit"),
+			rawKeyHint("/", "commands"),
+			rawKeyHint("!", "bash"),
+			keyHint("app.tools.expand", "more"),
+		].join(this.theme.fg("muted", " · "));
+
+		// Line 0: logo + product name + version
+		const line0 = `${logoLine0}  ${this.theme.fg("text", productName)} ${versionStr}`;
+
+		// Line 1: bottom logo row + compact hints
+		const line1 = `${logoLine1}  ${hints}`;
+
+		// Line 2: expand prompt
+		const line2 = this.theme.fg(
+			"dim",
+			`Press ${expandKey} to show full startup help and loaded resources.`,
+		);
+
+		// Line 4 (blank line 3): onboarding
+		const line4 = onboarding;
+
+		return ["", line0, line1, line2, "", line4, ""];
+	}
+
+	private renderExpanded(
+		logoLine0: string,
+		versionStr: string,
+		expandKey: string,
+		onboarding: string,
+	): string[] {
+		const { productName } = this.options;
+
+		// Line 0: logo + product name + version
+		const line0 = `${logoLine0}  ${this.theme.fg("text", productName)} ${versionStr}`;
+
+		// Expanded: one shortcut per line
+		const expandedLines = [
+			keyHint("app.interrupt", "abort the current agent turn"),
+			keyHint("app.clear", "clear the current session"),
+			keyHint("app.exit", "exit Pi"),
+			rawKeyHint("/", "show available slash commands"),
+			rawKeyHint("!", "open a bash shell"),
+			keyHint("app.tools.expand", "expand/collapse tool output and this header"),
+			this.theme.fg("muted", `${expandKey} to collapse`),
+		];
+
+		// Line 2: expand prompt
+		const line2 = this.theme.fg("dim", `Press ${expandKey} to show compact header.`);
+
+		// Line 4: onboarding
+		const line4 = onboarding;
+
+		// Compose: blank, logo, blank, expanded hints (indented), blank, expand prompt, blank, onboarding, blank
+		const result: string[] = [""];
+		result.push(line0);
+		result.push(""); // blank after logo
+		for (const hint of expandedLines) {
+			result.push(`  ${hint}`);
+		}
+		result.push("");
+		result.push(line2);
+		result.push("");
+		result.push(line4);
+		result.push("");
+
+		return result;
+	}
+
+	invalidate(): void {
+		// Theme changes or expansion state changes call this to request re-render.
+		// The TUI calls render() again automatically.
+	}
+
+	// --- Expandable interface (called by Pi when Ctrl+O toggles) ---
+
+	setExpanded(expanded: boolean): void {
+		if (this.expanded === expanded) return;
+		this.expanded = expanded;
+		this.invalidate();
+	}
+
+	// --- Cleanup ---
+
+	dispose(): void {
+		// No persistent resources to clean up.
+	}
+}
+
+// ---------------------------------------------------------------------------
+// Visible width helper (ANSI-aware)
+// ---------------------------------------------------------------------------
+
+/** Strip ANSI escape sequences to get visible character count. */
+export function visibleWidth(str: string): number {
+	// Remove all ANSI CSI sequences: \x1b[...X
+	return str.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, "").length;
+}
+
+/** Strip ANSI to get plain text for width/equality checks. */
+export function stripAnsi(str: string): string {
+	return str.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, "");
+}

package/packages/tui/src/index.ts

@@ -0,0 +1,9 @@
+/**
+ * @pi-harness/tui — TUI integration utilities for pi-harness-runtime.
+ *
+ * Exports the Harness custom header component that replaces Pi's built-in
+ * startup banner with a harness-branded version using Unicode half-block art.
+ */
+
+export { createHarnessHeader, type HarnessHeaderOptions } from "./harness-header.js";
+export { visibleWidth, stripAnsi } from "./harness-header.js";