pi-harness-runtime 0.10.7 → 0.10.11

package/packages/clipboard/src/clipboard.ts

@@ -1,59 +0,0 @@
-/**
- * Clipboard — System clipboard integration
- */
-
-import { writeFileSync, readFileSync } from "node:fs";
-import type { ClipboardOptions } from "./types.js";
-
-/** Write text to system clipboard. */
-export async function copy(
-	text: string,
-	_options?: ClipboardOptions,
-): Promise<void> {
-	try {
-		const { spawn } = require("node:child_process");
-		// Use stdin mode — bypasses shell so UTF-8 bytes pass through untouched.
-		// The `echo '...' | xclip` pipeline corrupts box-drawing characters (â¬).
-		await new Promise<void>((resolve, reject) => {
-			const proc = spawn("xclip", ["-selection", "clipboard", "-i"], {
-				stdio: ["pipe", "ignore", "pipe"],
-			});
-			proc.on("error", reject);
-			proc.on("close", (code: number) =>
-				code === 0 ? resolve() : reject(new Error(`xclip exit ${code}`)),
-			);
-			proc.stdin!.end(text, "utf8");
-		});
-	} catch {
-		try {
-			writeFileSync("/dev/clipboard", text);
-		} catch {
-			// Silently fail if clipboard unavailable
-		}
-	}
-}
-
-/** Read text from system clipboard. */
-export async function read(): Promise<string> {
-	try {
-		const { execSync } = require("node:child_process");
-		return execSync("xclip -selection clipboard -o", {
-			encoding: "utf8",
-			stdio: ["ignore", "pipe", "ignore"],
-		}).trim();
-	} catch {
-		try {
-			return readFileSync("/dev/clipboard", "utf8");
-		} catch {
-			return "";
-		}
-	}
-}
-
-/** Copy the last assistant message from session service. */
-export async function copyLastResponse(
-	_sessionApi: unknown,
-	_options?: ClipboardOptions,
-): Promise<void> {
-	await copy("[session-api not yet integrated]", _options);
-}

package/packages/clipboard/src/copy-sync.ts

@@ -1,201 +0,0 @@
-/**
- * Copy + Sync — Ctrl+Shift+C shortcut for clipboard sync
- *
- * Registers a keyboard shortcut that:
- * 1. Reads selected text from clipboard (Xvfb/X11 on headless server)
- * 2. Writes to bridge file for terminal paste
- * 3. POSTs to GitHub Gist for cross-device sync
- *
- * Only fires on explicit Ctrl+Shift+C — NOT on auto-select/highlight.
- */
-
-import { execSync } from "node:child_process";
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-import { homedir } from "node:os";
-import { postToGist, isConfigured as isGistConfigured } from "./gist-relay.js";
-
-// ─── Bridge file path ─────────────────────────────────────────────────────────
-
-const BRIDGE_FILE = join(homedir(), ".herdr-clipboard");
-const XCLIP_WRAPPER = join(homedir(), ".local", "bin", "xclip");
-
-// ─── Mojibake detection & repair ──────────────────────────────────────────────
-
-/**
- * Detect UTF-8 mojibake (double-encoding: UTF-8 → Latin-1 → UTF-8).
- *
- * The pattern:
- * - UTF-8 box-drawing chars (e2 xx xx) get Latin-1 decoded to "âÄx" chars
- * - When those Latin-1 chars are re-encoded as UTF-8:
- *   - "â" (c3 a2) = UTF-8 Latin small Letter A with Circumflex
- *   - "Ä" (c2 94) = UTF-8 Latin Capital Letter A with Diaeresis
- *   - "Œ" (c2 8c) = UTF-8 Latin Capital Ligature OE
- * - So raw UTF-8 box-drawing chars e2 94 8c become "âÄŒ" (c3 a2 c2 94 c2 8c)
- *   when misdecoded as Latin-1 then re-encoded.
- *
- * Detection heuristic: "â" or "Ã" followed by another non-ASCII char or
- * box-drawing surrogate pairs.  These sequences are almost always mojibake.
- */
-function isMojibake(text: string): boolean {
-	// "â" = \u00e2, "Ã" = \u00c3 — common Latin-1 surrogates in mojibake
-	// Check for these appearing before other non-ASCII chars (box-drawing etc.)
-	const moji = /[\u00e2\u00c2\u00e3\u00c3][\u0080-\u00ff]/;
-	return moji.test(text);
-}
-
-/**
- * Repair UTF-8 mojibake: UTF-8 bytes interpreted as Latin-1 → re-interpret as UTF-8.
- *
- * Safe because:
- * 1. isMojibake() already confirmed the string has the characteristic pattern
- * 2. We only apply Buffer.from(str, "latin1") to the affected substrings
- * 3. Plain ASCII and correctly-encoded UTF-8 pass through unchanged
- *    (Buffer.from("hello", "latin1").toString("utf8") === "hello")
- * 4. Thai/other CJK scripts don't have the "â"+"Ä" surrogate pattern
- *
- * @param text - possibly-mojibaked string
- * @returns repaired UTF-8 string
- */
-function repairMojibake(text: string): string {
-	if (!isMojibake(text)) return text;
-
-	try {
-		// Encode the JavaScript string back to its byte representation using
-		// Latin-1 (which is byte-identity for all code points 0-255), then
-		// decode those bytes as UTF-8.  This reverses the double-encoding.
-		return Buffer.from(text, "latin1").toString("utf8");
-	} catch {
-		// If encoding fails for any reason, return original
-		return text;
-	}
-}
-
-// ─── Read from Xvfb clipboard ─────────────────────────────────────────────────
-
-function readFromClipboard(): string | null {
-	// Try Xvfb xclip first (our headless clipboard)
-	try {
-		const content = execSync(
-			`"${XCLIP_WRAPPER}" -selection clipboard -o 2>/dev/null || DISPLAY=:99 xclip -selection clipboard -o 2>/dev/null || true`,
-			{ encoding: "utf8", timeout: 2000 },
-		)
-			.trim()
-			// Repair mojibake that xclip or Xvfb might have introduced
-			.replace(/\r\n/g, "\n");
-
-		if (content) return repairMojibake(content);
-	} catch {
-		// Fall through
-	}
-
-	// Fallback: read bridge file directly
-	try {
-		if (existsSync(BRIDGE_FILE)) {
-			const content = readFileSync(BRIDGE_FILE, "utf8").trim();
-			if (content) return repairMojibake(content);
-		}
-	} catch {
-		// fall through
-	}
-
-	return null;
-}
-
-// ─── Write to bridge file ─────────────────────────────────────────────────────
-
-function writeToBridge(text: string): void {
-	try {
-		// Write raw UTF-8 bytes — no transformation needed.
-		// UTF-8 strings in Node.js write correctly with writeFileSync(file, "utf8").
-		writeFileSync(BRIDGE_FILE, text, "utf8");
-	} catch {
-		// ignore
-	}
-}
-
-// ─── Write to Xvfb clipboard ──────────────────────────────────────────────────
-
-function writeToXvfb(text: string): boolean {
-	try {
-		// Pass raw bytes via Buffer to avoid any implicit encoding conversion.
-		// This ensures UTF-8 multi-byte sequences are sent as-is to xclip.
-		execSync(`"${XCLIP_WRAPPER}" -selection clipboard -in`, {
-			input: Buffer.from(text, "utf8"),
-			timeout: 5000,
-		});
-		return true;
-	} catch {
-		return false;
-	}
-}
-
-// ─── Main: copy + sync ───────────────────────────────────────────────────────
-
-/**
- * Read selected text, write to bridge, sync to Gist.
- * Called by the Ctrl+Shift+C shortcut handler.
- */
-export async function copyAndSync(ctx: {
-	ui: { notify: (msg: string, type?: string) => void };
-}): Promise<void> {
-	const text = readFromClipboard();
-
-	if (!text) {
-		ctx.ui.notify(
-			"No clipboard content. Make sure text is selected in the terminal.",
-			"warning",
-		);
-		return;
-	}
-
-	// Write to bridge file (for terminal paste)
-	writeToBridge(text);
-
-	// Write to Xvfb clipboard (for Ctrl+Shift+V paste in terminal)
-	const xvfbOk = writeToXvfb(text);
-
-	// Sync to GitHub Gist (for cross-device clipboard)
-	if (isGistConfigured()) {
-		const gistOk = await postToGist(text);
-		if (gistOk) {
-			ctx.ui.notify(`Synced ${text.length} chars to Gist ✓`, "info");
-		} else {
-			ctx.ui.notify(
-				`Copied ${text.length} chars (Gist sync failed)`,
-				"warning",
-			);
-		}
-	} else if (xvfbOk) {
-		ctx.ui.notify(`Copied ${text.length} chars to clipboard`, "info");
-	} else {
-		ctx.ui.notify(
-			`Copied ${text.length} chars (terminal paste may not work on headless server)`,
-			"warning",
-		);
-	}
-}
-
-// ─── Register shortcut ───────────────────────────────────────────────────────
-
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-type AnyPi = any;
-
-/**
- * Register Ctrl+Shift+C as the copy+sync shortcut.
- * The Key.ctrlShift("c") syntax comes from @earendil-works/pi-tui.
- */
-export function registerCopySyncShortcut(pi: AnyPi, Key: AnyPi): void {
-	try {
-		pi.registerShortcut(Key.ctrlShift("c"), {
-			description: "Copy to clipboard + sync to GitHub Gist",
-			handler: async (rawCtx: AnyPi) => {
-				await copyAndSync(
-					rawCtx as { ui: { notify: (msg: string, type?: string) => void } },
-				);
-			},
-		});
-	} catch (err) {
-		console.error("[copy-sync] Failed to register shortcut:", err);
-	}
-}

package/packages/clipboard/src/gist-relay.ts

@@ -1,240 +0,0 @@
-/**
- * Gist Relay — GitHub Gist clipboard sync
- *
- * Stores clipboard content in a secret Gist, accessible from any device.
- * - POST: Upload clipboard content to Gist
- * - GET:  Download latest clipboard content from Gist
- *
- * Security: Uses secret Gist (only accessible via API token)
- */
-
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
-import { join } from "node:path";
-import { homedir } from "node:os";
-
-const HARNESS_DIR = join(homedir(), ".pi-harness-runtime");
-const CONFIG_FILE = join(HARNESS_DIR, "gist-config.json");
-
-interface GistConfig {
-	token: string;
-	gistId: string;
-	gistUrl: string;
-}
-
-interface GistFile {
-	content: string;
-}
-
-interface GistResponse {
-	id: string;
-	html_url: string;
-	files: Record<string, GistFile>;
-}
-
-// ─── Config ──────────────────────────────────────────────────────────────
-
-function loadConfig(): GistConfig | null {
-	try {
-		if (!existsSync(CONFIG_FILE)) return null;
-		const raw = readFileSync(CONFIG_FILE, "utf8");
-		return JSON.parse(raw) as GistConfig;
-	} catch {
-		return null;
-	}
-}
-
-function saveConfig(config: GistConfig): void {
-	mkdirSync(HARNESS_DIR, { recursive: true });
-	writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), "utf8");
-}
-
-// ─── API ────────────────────────────────────────────────────────────────
-
-/**
- * Check if Gist relay is configured
- */
-export function isConfigured(): boolean {
-	return loadConfig() !== null;
-}
-
-/**
- * Get stored GitHub token
- */
-export function getToken(): string | null {
-	return loadConfig()?.token ?? null;
-}
-
-/**
- * Store GitHub token and Gist ID after initial setup
- */
-export function saveCredentials(
-	token: string,
-	gistId: string,
-	gistUrl: string,
-): void {
-	saveConfig({ token, gistId, gistUrl });
-}
-
-/**
- * Create a new secret Gist and return its ID
- */
-export async function createGist(
-	token: string,
-	content: string,
-): Promise<GistConfig | null> {
-	try {
-		const response = await fetch("https://api.github.com/gists", {
-			method: "POST",
-			headers: {
-				Authorization: `Bearer ${token}`,
-				"Content-Type": "application/json",
-				Accept: "application/vnd.github+json",
-				"X-GitHub-Api-Version": "2022-11-28",
-			},
-			body: JSON.stringify({
-				description: "pi-harness-runtime clipboard sync",
-				public: false,
-				files: {
-					"clipboard.txt": {
-						content: content || "(empty)",
-					},
-				},
-			}),
-		});
-
-		if (!response.ok) {
-			const error = await response.text();
-			console.error(
-				`[gist-relay] Failed to create Gist: ${response.status} ${error}`,
-			);
-			return null;
-		}
-
-		const gist = (await response.json()) as GistResponse;
-		const config: GistConfig = {
-			token,
-			gistId: gist.id,
-			gistUrl: gist.html_url,
-		};
-		saveConfig(config);
-		return config;
-	} catch (err) {
-		console.error("[gist-relay] Failed to create Gist:", err);
-		return null;
-	}
-}
-
-/**
- * Update existing Gist with new clipboard content
- */
-export async function updateGist(content: string): Promise<boolean> {
-	const config = loadConfig();
-	if (!config) {
-		console.error(
-			"[gist-relay] Not configured. Run 'bun run gist-auth' first.",
-		);
-		return false;
-	}
-
-	try {
-		const response = await fetch(
-			`https://api.github.com/gists/${config.gistId}`,
-			{
-				method: "PATCH",
-				headers: {
-					Authorization: `Bearer ${config.token}`,
-					"Content-Type": "application/json",
-					Accept: "application/vnd.github+json",
-					"X-GitHub-Api-Version": "2022-11-28",
-				},
-				body: JSON.stringify({
-					description: "pi-harness-runtime clipboard sync",
-					files: {
-						"clipboard.txt": {
-							content: content,
-						},
-					},
-				}),
-			},
-		);
-
-		if (!response.ok) {
-			const error = await response.text();
-			console.error(
-				`[gist-relay] Failed to update Gist: ${response.status} ${error}`,
-			);
-			return false;
-		}
-
-		return true;
-	} catch (err) {
-		console.error("[gist-relay] Failed to update Gist:", err);
-		return false;
-	}
-}
-
-/**
- * Fetch current clipboard content from Gist
- */
-export async function fetchFromGist(): Promise<string | null> {
-	const config = loadConfig();
-	if (!config) {
-		return null;
-	}
-
-	try {
-		const response = await fetch(
-			`https://api.github.com/gists/${config.gistId}`,
-			{
-				headers: {
-					Authorization: `Bearer ${config.token}`,
-					Accept: "application/vnd.github+json",
-					"X-GitHub-Api-Version": "2022-11-28",
-				},
-			},
-		);
-
-		if (!response.ok) {
-			return null;
-		}
-
-		const gist = (await response.json()) as GistResponse;
-		return gist.files["clipboard.txt"]?.content ?? null;
-	} catch {
-		return null;
-	}
-}
-
-/**
- * Post clipboard content to Gist. Creates Gist on first call, updates on subsequent calls.
- */
-export async function postToGist(content: string): Promise<boolean> {
-	const config = loadConfig();
-
-	if (!config) {
-		// First time — need token
-		console.error(
-			"[gist-relay] Not configured. Run 'bun run gist-auth' first.",
-		);
-		return false;
-	}
-
-	// Update existing Gist
-	const ok = await updateGist(content);
-	if (ok) {
-		console.error(`[gist-relay] Synced ${content.length} chars to Gist`);
-	}
-	return ok;
-}
-
-/**
- * Delete stored Gist config (for reset)
- */
-export function clearConfig(): void {
-	try {
-		const { unlinkSync } = require("node:fs");
-		unlinkSync(CONFIG_FILE);
-	} catch {
-		// ignore
-	}
-}

package/packages/clipboard/src/github-login.ts

@@ -1,107 +0,0 @@
-/**
- * GitHub Login — /github-login slash command
- *
- * Registers the /github-login command that prompts for GitHub PAT
- * and creates a secret Gist for clipboard sync.
- */
-
-import { createGist, isConfigured } from "./gist-relay.js";
-
-/**
- * Register /github-login command in pi-coding-agent
- */
-export function registerGithubLoginCommand(pi: {
-	registerCommand: (
-		name: string,
-		options: {
-			description: string;
-			handler: (args: string, ctx: unknown) => Promise<void>;
-		},
-	) => void;
-}): void {
-	pi.registerCommand("github-login", {
-		description: "Connect GitHub Gist for clipboard sync across devices",
-		handler: async (_args: string, rawCtx: unknown) => {
-			const ctx = rawCtx as {
-				ui: {
-					notify: (msg: string, type?: string) => void;
-					input: (
-						title: string,
-						placeholder?: string,
-					) => Promise<string | undefined>;
-					confirm: (title: string, msg: string) => Promise<boolean>;
-				};
-			};
-			// Check if already configured
-			if (isConfigured()) {
-				const reset = await ctx.ui.confirm(
-					"GitHub Gist already configured",
-					"Reset and reconfigure?",
-				);
-				if (!reset) {
-					ctx.ui.notify("Cancelled.", "info");
-					return;
-				}
-			}
-
-			ctx.ui.notify("Setting up GitHub Gist clipboard sync...", "info");
-
-			// Step 1: Ask user to create PAT
-			const instructions = [
-				"",
-				"Create a GitHub Personal Access Token:",
-				"  1. Go to https://github.com/settings/tokens",
-				"  2. Generate new token (classic)",
-				"  3. Select scope: gist",
-				"  4. Copy the token",
-				"",
-			].join("\n");
-
-			ctx.ui.notify(instructions, "info");
-
-			// Step 2: Prompt for PAT
-			const token = await ctx.ui.input(
-				"GitHub Personal Access Token",
-				"ghp_xxxxxxxxxxxxxxxxxxxx",
-			);
-
-			if (!token?.trim()) {
-				ctx.ui.notify("No token provided. Cancelled.", "warning");
-				return;
-			}
-
-			// Step 3: Create Gist
-			ctx.ui.notify("Creating secret Gist...", "info");
-
-			const testContent = [
-				"pi-harness-runtime clipboard sync",
-				`Connected at: ${new Date().toISOString()}`,
-				"",
-				"This Gist stores clipboard content for cross-device sync.",
-				"Polling script: see scripts/gist-poll.sh",
-			].join("\n");
-
-			const result = await createGist(token.trim(), testContent);
-
-			if (result) {
-				ctx.ui.notify(
-					[
-						"✅ GitHub Gist clipboard sync configured!",
-						"",
-						`   Gist: ${result.gistUrl}`,
-						"",
-						"   Polling script: scripts/gist-poll.sh",
-						"   Run: bun scripts/gist-auth-poll.ts on client devices",
-						"",
-					].join("\n"),
-					"info",
-				);
-			} else {
-				ctx.ui.notify(
-					"❌ Failed to create Gist. Check your PAT and try again.",
-					"error",
-				);
-			}
-		},
-	});
-}

package/packages/clipboard/src/index.ts

@@ -1,3 +0,0 @@
-export type { ClipboardContent, ClipboardOptions } from "./types.js";
-export * from "./gist-relay.js";
-export { registerGithubLoginCommand } from "./github-login.js";

package/packages/clipboard/src/types.ts

@@ -1,14 +0,0 @@
-/**
- * Clipboard — Types
- */
-
-export interface ClipboardContent {
-	text: string;
-	html?: string;
-	source?: string;
-}
-
-export interface ClipboardOptions {
-	notify?: boolean;
-	format?: "text" | "html";
-}