@xynogen/pix-9router 0.6.0 → 0.8.0

package/src/http.ts

@@ -1,102 +0,0 @@
-/**
- * http.ts — shared 9Router HTTP plumbing.
- *
- * auth and curl serve the transcribe/tts fallback paths and the catalog reader.
- * curl differs only by timeout (audio needs longer) and stdin body, so both are
- * parameters with the old per-file defaults.
- */
-
-import { readFileSync } from "node:fs";
-import { basename } from "node:path";
-import { ioTimeoutMs } from "@xynogen/pix-runtime/io";
-
-export function auth(): string | undefined {
-	return process.env.NINEROUTER_KEY || process.env.ROUTER_API_KEY;
-}
-
-export interface CurlOptions {
-	/** Request timeout in ms (default ioTimeoutMs()). */
-	timeoutMs?: number;
-	/** Optional request body (was piped to curl stdin). */
-	stdin?: string;
-}
-
-// ponytail: this is NOT a general curl shim — it parses only the flag forms the
-// three fallback call sites actually pass (-L, -X, -H, -d, -F key=value /
-// file=@path, plus the -sS/--connect-timeout/--max-time defaults added below).
-// New curl flags won't work here; extend the parser or call fetch directly.
-function curlArgsToRequest(args: string[]): { url: string; init: RequestInit } {
-	const headers = new Headers();
-	let method = "GET";
-	let body: string | undefined;
-	let form: FormData | undefined;
-	let url = "";
-	for (let i = 0; i < args.length; i++) {
-		const a = args[i] ?? "";
-		switch (a) {
-			case "-sS":
-			case "-L":
-				break; // silent / follow-redirects are fetch defaults
-			case "--connect-timeout":
-			case "--max-time":
-				i++; // value handled by AbortSignal below
-				break;
-			case "-X":
-				method = args[++i] ?? method;
-				break;
-			case "-H": {
-				const h = args[++i] ?? "";
-				const idx = h.indexOf(":");
-				if (idx >= 0) headers.set(h.slice(0, idx).trim(), h.slice(idx + 1).trim());
-				break;
-			}
-			case "-d":
-				body = args[++i] ?? "";
-				break;
-			case "-F": {
-				form ??= new FormData();
-				const field = args[++i] ?? "";
-				const eq = field.indexOf("=");
-				const key = field.slice(0, eq);
-				const val = field.slice(eq + 1);
-				if (val.startsWith("@")) {
-					const path = val.slice(1);
-					form.set(key, new Blob([readFileSync(path)]), basename(path));
-				} else {
-					form.set(key, val);
-				}
-				break;
-			}
-			default:
-				if (!a.startsWith("-")) url = a; // positional = URL
-		}
-	}
-	const init: RequestInit = { method };
-	if (form)
-		init.body = form; // let fetch set the multipart boundary
-	else if (body !== undefined) init.body = body;
-	if ([...headers.keys()].length > 0) init.headers = headers;
-	return { url, init };
-}
-
-/** Raw fetch fallback (curl-signature compatible), rejecting on non-2xx or timeout. */
-export async function curl(args: string[], opts: CurlOptions = {}): Promise<string> {
-	const timeoutMs = opts.timeoutMs ?? ioTimeoutMs();
-	const { url, init } = curlArgsToRequest(args);
-	if (opts.stdin !== undefined) init.body = opts.stdin;
-	init.signal = AbortSignal.timeout(timeoutMs);
-	let res: Response;
-	try {
-		res = await fetch(url, init);
-	} catch (err) {
-		if (err instanceof DOMException && err.name === "TimeoutError") {
-			throw new Error("curl timed out");
-		}
-		throw new Error(`curl failed: ${err instanceof Error ? err.message : String(err)}`);
-	}
-	if (!res.ok) {
-		const errText = await res.text().catch(() => "");
-		throw new Error(`curl exit ${res.status}: ${errText.slice(0, 300)}`);
-	}
-	return res.text();
-}

package/src/recorder.ts

@@ -1,103 +0,0 @@
-import { spawn } from "node:child_process";
-import { randomUUID } from "node:crypto";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { findExecutableSync } from "@xynogen/pix-runtime/which";
-
-export function parsePulseSources(output: string): string[] {
-	return output
-		.split("\n")
-		.map((line) => line.split("\t")[1]?.trim())
-		.filter((name): name is string => Boolean(name));
-}
-
-export function parseRmsDb(output: string): number | undefined {
-	const matches = [
-		...output.matchAll(/(?:RMS level dB:\s*|lavfi\.astats\.Overall\.RMS_level=)(-?\d+(?:\.\d+)?)/g),
-	];
-	const value = matches.at(-1)?.[1];
-	return value === undefined ? undefined : Number(value);
-}
-
-export function ffmpegRecordArgs(device: string, output: string): string[] {
-	return [
-		"-hide_banner",
-		"-loglevel",
-		"info",
-		"-f",
-		"pulse",
-		"-i",
-		device,
-		"-ac",
-		"1",
-		"-ar",
-		"16000",
-		"-af",
-		"astats=metadata=1:reset=1,ametadata=print:key=lavfi.astats.Overall.RMS_level",
-		"-y",
-		output,
-	];
-}
-
-function run(command: string, args: string[]): Promise<string> {
-	return new Promise((resolve, reject) => {
-		const child = spawn(command, args, { stdio: ["ignore", "pipe", "pipe"] });
-		let stdout = "";
-		let stderr = "";
-		child.stdout.on("data", (data) => (stdout += String(data)));
-		child.stderr.on("data", (data) => (stderr += String(data)));
-		child.once("error", reject);
-		child.once("exit", (code) =>
-			code === 0
-				? resolve(stdout)
-				: reject(new Error(stderr.trim() || `${command} exited ${code}`)),
-		);
-	});
-}
-
-export async function microphoneDevices(): Promise<string[]> {
-	const pactl = findExecutableSync("pactl");
-	if (!pactl) return ["default"];
-	const names = parsePulseSources(await run(pactl, ["list", "short", "sources"]));
-	return [...new Set(["default", ...names])];
-}
-
-export interface Recording {
-	path: string;
-	stop(): Promise<number | undefined>;
-}
-
-export function startRecording(device: string, onLevel: (db: number) => void): Recording {
-	const ffmpeg = findExecutableSync("ffmpeg");
-	if (!ffmpeg) throw new Error("Microphone recording needs ffmpeg on PATH.");
-	const path = join(tmpdir(), `pix-stt-${randomUUID()}.wav`);
-	const child = spawn(ffmpeg, ffmpegRecordArgs(device, path), {
-		stdio: ["pipe", "ignore", "pipe"],
-	});
-	let stderr = "";
-	let lastLevel: number | undefined;
-	child.stderr.on("data", (data) => {
-		const text = String(data);
-		stderr += text;
-		const level = parseRmsDb(text);
-		if (level !== undefined) {
-			lastLevel = level;
-			onLevel(level);
-		}
-	});
-	const exit = new Promise<void>((resolve, reject) => {
-		child.once("error", reject);
-		child.once("exit", (code) =>
-			code === 0 ? resolve() : reject(new Error(stderr.trim() || `ffmpeg exited ${code}`)),
-		);
-	});
-	return {
-		path,
-		async stop() {
-			child.stdin.write("q");
-			child.stdin.end();
-			await exit;
-			return lastLevel;
-		},
-	};
-}

package/src/render.ts

@@ -1,151 +0,0 @@
-/**
- * render.ts — shared dim renderers for fetch/search tool output.
- *
- * fetch/search return external web content the model already consumed; the
- * full body is noise in the transcript. We render it dim (theme `dim` token)
- * so it reads like faded reasoning — present for inspection, visually quiet.
- * The tool title line stays normal so calls remain scannable.
- *
- * pi-tui's Text component is loaded via require() so the renderers degrade to
- * the default pi renderer (undefined-safe via cast) when pi-tui is absent.
- */
-
-import type {
-	AgentToolResult,
-	Theme,
-	ToolRenderResultOptions,
-} from "@earendil-works/pi-coding-agent";
-import type { Component } from "@earendil-works/pi-tui";
-import {
-	type CollapsedToolStatus,
-	formatCollapsedToolRow,
-	frameToolResult,
-	hideCollapsedToolCall,
-	unframeToolResult,
-} from "@xynogen/pix-pretty/utils";
-import { type CollapseState, tickCollapse } from "@xynogen/pix-runtime/collapse";
-
-interface TextLike extends Component {
-	setText(text: string): void;
-}
-
-// ToolRenderContext is not re-exported by pi-coding-agent; model the fields the
-// renderers actually read. Structurally compatible with the SDK context.
-interface RenderCtx {
-	lastComponent: Component | undefined;
-	isError: boolean;
-	state: Record<string, unknown>;
-	expanded: boolean;
-	invalidate: () => void;
-}
-
-interface CompactRendererConfig<TDetails> {
-	tool: string;
-	target: (details: TDetails) => string;
-	meta: (details: TDetails) => string;
-	status?: (details: TDetails) => CollapsedToolStatus;
-}
-
-type TextCtor = new (text?: string, padX?: number, padY?: number) => TextLike;
-
-// Preview cap is intentionally generous — dimming already de-emphasises the
-// body, so we only truncate to keep pathological multi-thousand-line dumps
-// from flooding the viewport. Expanding shows everything.
-const MAX_PREVIEW_LINES = 32;
-
-let TextComponent: TextCtor | undefined;
-try {
-	TextComponent = (require("@earendil-works/pi-tui") as { Text: TextCtor }).Text;
-} catch {
-	TextComponent = undefined;
-}
-
-function getText(lastComponent: Component | undefined): TextLike {
-	if (lastComponent && "setText" in lastComponent)
-		return unframeToolResult(lastComponent as TextLike);
-	// TextComponent is always present in the interactive TUI (pi-tui peer); the
-	// require() guard only matters for headless/test contexts where renderers
-	// are never invoked.
-	if (TextComponent) return new TextComponent("", 0, 0);
-	throw new Error("pi-tui Text component unavailable");
-}
-
-function allText(result: AgentToolResult<unknown>): string {
-	return (result.content ?? [])
-		.filter((block): block is { type: "text"; text: string } => block.type === "text")
-		.map((block) => block.text)
-		.join("\n");
-}
-
-function dimBody(body: string, theme: Theme, expanded: boolean): string {
-	const lines = body.split("\n");
-	const maxShow = expanded ? lines.length : MAX_PREVIEW_LINES;
-	const shown = lines.slice(0, maxShow);
-	const out = shown.map((line) => `  ${theme.fg("dim", line)}`);
-	const remaining = lines.length - maxShow;
-	if (remaining > 0) {
-		out.push(`  ${theme.fg("muted", `… ${remaining} more lines`)}`);
-	}
-	return out.join("\n");
-}
-
-/** Build a `renderCall` that shows `<title> <secondary arg>`. */
-export function makeRenderCall<TArgs>(title: string, pickArg: (args: TArgs) => string) {
-	return (args: TArgs, theme: Theme, ctx: RenderCtx): Component => {
-		const text = getText(ctx.lastComponent);
-		if (
-			hideCollapsedToolCall(ctx.state as CollapseState, ctx.expanded, (value) =>
-				text.setText(value),
-			)
-		)
-			return text;
-		const arg = pickArg(args);
-		text.setText(`${theme.fg("toolTitle", theme.bold(title))} ${theme.fg("dim", arg)}`);
-		return text;
-	};
-}
-
-/** Build a `renderResult` with a bounded detail preview and optional compact terminal row. */
-export function makeRenderResult<TDetails>(config?: CompactRendererConfig<TDetails>) {
-	return (
-		result: AgentToolResult<unknown>,
-		opts: ToolRenderResultOptions,
-		theme: Theme,
-		ctx: RenderCtx,
-	): Component => {
-		const text = getText(ctx.lastComponent);
-		const body = allText(result);
-
-		if (ctx.isError) {
-			text.setText(`  ${theme.fg("error", body || "Error")}`);
-			return opts.isPartial ? text : frameToolResult(text, theme, true);
-		}
-		if (!body.trim()) {
-			text.setText(`  ${theme.fg("muted", "(empty)")}`);
-			return opts.isPartial ? text : frameToolResult(text, theme, false);
-		}
-
-		const details = result.details as TDetails | undefined;
-		const isError = Boolean(details && config?.status?.(details) === "error");
-		if (
-			!opts.isPartial &&
-			config &&
-			details &&
-			tickCollapse(config.tool, ctx.state as CollapseState, ctx.invalidate, opts.expanded)
-		) {
-			text.setText(
-				formatCollapsedToolRow(
-					theme,
-					config.tool,
-					config.target(details),
-					config.meta(details),
-					config.status?.(details) ?? "success",
-				),
-			);
-			return text;
-		}
-
-		text.setText(dimBody(body, theme, opts.expanded));
-		return opts.isPartial ? text : frameToolResult(text, theme, isError);
-	};
-}

package/src/stt-command.ts

@@ -1,127 +0,0 @@
-import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
-import { matchesKey } from "@earendil-works/pi-tui";
-import {
-	frameModal,
-	modalOverlayOptions,
-	modalWidth,
-	terminalModalHeight,
-} from "@xynogen/pix-pretty/modal-frame";
-import { routerDefaults, saveDefaults } from "./defaults.js";
-import { microphoneDevices, type Recording, startRecording } from "./recorder.js";
-import { transcribeAudioFile } from "./transcribe.js";
-
-function levelBar(db: number | undefined): string {
-	if (db === undefined) return "░".repeat(24);
-	const count = Math.max(0, Math.min(24, Math.round(((db + 60) / 60) * 24)));
-	return `${"█".repeat(count)}${"░".repeat(24 - count)}`;
-}
-
-async function record(
-	ctx: ExtensionCommandContext,
-	devices: string[],
-): Promise<string | undefined> {
-	return (
-		(await ctx.ui.custom<string | null>(
-			(tui, theme, _keybindings, done) => {
-				let deviceIndex = Math.max(0, devices.indexOf(routerDefaults.sttDevice));
-				let recording: Recording | undefined;
-				let level: number | undefined;
-				let error = "";
-				let stopping = false;
-
-				const stop = async () => {
-					if (!recording || stopping) return;
-					stopping = true;
-					try {
-						const current = recording;
-						await current.stop();
-						done(current.path);
-					} catch (cause) {
-						error = cause instanceof Error ? cause.message : String(cause);
-						recording = undefined;
-						stopping = false;
-						tui.requestRender();
-					}
-				};
-
-				return {
-					render(width: number) {
-						const device = devices[deviceIndex] ?? "default";
-						return frameModal({
-							width: modalWidth(width),
-							maxHeight: terminalModalHeight(tui.terminal?.rows),
-							title: "Microphone",
-							titleColor: (text) => theme.fg("accent", theme.bold(text)),
-							header: [""],
-							body: [
-								`${theme.fg("dim", "input")}  ${theme.fg("success", device)}`,
-								"",
-								`${theme.fg("dim", "level")}  ${theme.fg(level !== undefined && level > -12 ? "warning" : "success", levelBar(level))} ${level === undefined ? "" : `${level.toFixed(1)} dB`}`,
-								"",
-								theme.fg(error ? "error" : "text", error || (recording ? "Recording…" : "Ready")),
-							],
-							footer: [
-								"",
-								theme.fg(
-									"muted",
-									recording
-										? "enter stop and transcribe · esc cancel"
-										: "←→ input · enter record · esc close",
-								),
-							],
-							color: (text) => theme.fg("accent", text),
-							bg: (text) => theme.bg("customMessageBg", text),
-						}).lines;
-					},
-					invalidate: () => {},
-					handleInput(data: string) {
-						if (matchesKey(data, "escape")) {
-							if (recording) void recording.stop().finally(() => done(null));
-							else done(null);
-						} else if (matchesKey(data, "enter")) {
-							if (recording) void stop();
-							else {
-								const device = devices[deviceIndex] ?? "default";
-								try {
-									recording = startRecording(device, (db) => {
-										level = db;
-										tui.requestRender();
-									});
-									routerDefaults.sttDevice = device;
-									saveDefaults(routerDefaults);
-								} catch (cause) {
-									error = cause instanceof Error ? cause.message : String(cause);
-								}
-							}
-						} else if (!recording && (matchesKey(data, "left") || matchesKey(data, "right"))) {
-							const direction = matchesKey(data, "left") ? -1 : 1;
-							deviceIndex = (deviceIndex + direction + devices.length) % devices.length;
-						}
-						tui.requestRender();
-					},
-				};
-			},
-			{ overlay: true, overlayOptions: modalOverlayOptions() },
-		)) ?? undefined
-	);
-}
-
-export default function registerSttCommand(pi: ExtensionAPI): void {
-	pi.registerCommand("stt", {
-		description: "Record microphone audio and put its transcript in the prompt",
-		handler: async (_args, ctx) => {
-			try {
-				const audio = await record(ctx, await microphoneDevices());
-				if (!audio) return;
-				ctx.ui.setStatus("9router-stt", "Transcribing microphone…");
-				const transcript = await transcribeAudioFile(audio);
-				ctx.ui.setEditorText(transcript);
-				ctx.ui.notify("The transcript is in the prompt editor.", "info");
-			} catch (error) {
-				ctx.ui.notify(error instanceof Error ? error.message : String(error), "error");
-			} finally {
-				ctx.ui.setStatus("9router-stt", undefined);
-			}
-		},
-	});
-}