@xynogen/pix-9router 0.3.1 → 0.3.3

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@xynogen/pix-9router",
-	"version": "0.3.1",
+	"version": "0.3.3",
 	"description": "Pi extension — 9Router provider + fetch/search tools via router API",
 	"type": "module",
 	"main": "src/index.ts",
@@ -42,7 +42,7 @@
 		"@earendil-works/pi-ai": "*"
 	},
 	"dependencies": {
-		"@xynogen/pix-data": "*",
+		"@xynogen/pix-data": "^0.3.0",
 		"typebox": "^1.1.38"
 	}
 }

package/src/data.test.ts

@@ -1,10 +1,5 @@
 import { afterEach, describe, expect, it } from "bun:test";
-import {
-	buildModelsDevIndex,
-	lookupInIndex,
-	type ModelGrepModel,
-	routerBaseUrl,
-} from "./data.ts";
+import { buildModelsDevIndex, lookupInIndex, type ModelGrepModel, routerBaseUrl } from "./data.ts";
 
 // modelgrep-shaped fixture builder (buildModelsDevIndex now takes ModelGrepModel[]).
 function mg(
@@ -92,33 +87,25 @@ describe("lookupInIndex", () => {
 	]);
 
 	it("finds exact match", () => {
-		expect(lookupInIndex("claude-sonnet-4-5", index)?.name).toBe(
-			"Claude Sonnet 4.5",
-		);
+		expect(lookupInIndex("claude-sonnet-4-5", index)?.name).toBe("Claude Sonnet 4.5");
 	});
 
 	it("finds by stripping provider prefix (router style: provider/model)", () => {
-		expect(lookupInIndex("anthropic/claude-opus-4", index)?.name).toBe(
-			"Claude Opus 4",
-		);
+		expect(lookupInIndex("anthropic/claude-opus-4", index)?.name).toBe("Claude Opus 4");
 	});
 
 	it("finds with deep prefix e.g. cc/claude-opus-4", () => {
-		expect(lookupInIndex("cc/claude-opus-4", index)?.name).toBe(
-			"Claude Opus 4",
-		);
+		expect(lookupInIndex("cc/claude-opus-4", index)?.name).toBe("Claude Opus 4");
 	});
 
 	it("finds with date suffix stripped", () => {
-		expect(lookupInIndex("claude-sonnet-4-5-20250514", index)?.name).toBe(
-			"Claude Sonnet 4.5",
-		);
+		expect(lookupInIndex("claude-sonnet-4-5-20250514", index)?.name).toBe("Claude Sonnet 4.5");
 	});
 
 	it("finds with provider prefix + date suffix", () => {
-		expect(
-			lookupInIndex("anthropic/claude-sonnet-4-5-20250514", index)?.name,
-		).toBe("Claude Sonnet 4.5");
+		expect(lookupInIndex("anthropic/claude-sonnet-4-5-20250514", index)?.name).toBe(
+			"Claude Sonnet 4.5",
+		);
 	});
 
 	it("returns undefined for unknown model", () => {

package/src/data.ts

@@ -52,10 +52,7 @@ interface RouterModelsResponse {
 const ROUTER_DEFAULT_BASE = "https://9router.example.com/v1";
 
 export function routerBaseUrl(): string {
-	return (process.env.ROUTER_API_BASE || ROUTER_DEFAULT_BASE).replace(
-		/\/$/,
-		"",
-	);
+	return (process.env.ROUTER_API_BASE || ROUTER_DEFAULT_BASE).replace(/\/$/, "");
 }
 
 // ── Router models ──────────────────────────────────────────────────────────────
@@ -70,12 +67,9 @@ export const routerModels = new DataSource<RouterModel[]>({
 	skip: () => !process.env.ROUTER_API_KEY,
 	cachePath: join(CACHE_DIR, "9router.json"),
 	ttlMs: 30 * 60 * 1000, // 30 minutes
-	parse: (raw) =>
-		((raw as RouterModelsResponse).data ?? []).filter((m) => Boolean(m.id)),
+	parse: (raw) => ((raw as RouterModelsResponse).data ?? []).filter((m) => Boolean(m.id)),
 	parseCache: (data) =>
-		((data as RouterModelsResponse | undefined)?.data ?? []).filter((m) =>
-			Boolean(m.id),
-		),
+		((data as RouterModelsResponse | undefined)?.data ?? []).filter((m) => Boolean(m.id)),
 	empty: [],
 });
 

package/src/fetch.ts

@@ -28,9 +28,7 @@ async function apiPost(
 	const key = auth();
 	const controller = new AbortController();
 	const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
-	const s = signal
-		? AbortSignal.any([signal, controller.signal])
-		: controller.signal;
+	const s = signal ? AbortSignal.any([signal, controller.signal]) : controller.signal;
 
 	try {
 		const res = await fetch(url, {
@@ -93,10 +91,7 @@ export function formatFetchResult(raw: string): string {
 		content?: { text?: string | null } | string | null;
 	};
 
-	const text =
-		typeof obj.content === "string"
-			? obj.content
-			: (obj.content?.text ?? undefined);
+	const text = typeof obj.content === "string" ? obj.content : (obj.content?.text ?? undefined);
 	if (typeof text !== "string") return raw;
 
 	const header: string[] = [];
@@ -110,15 +105,13 @@ export default function registerFetch(pi: ExtensionAPI): void {
 	pi.registerTool({
 		name: "fetch",
 		label: "Fetch",
-		description:
-			"Fetch a web page as markdown, text, or raw HTML via exa. Returns page content.",
+		description: "Fetch a web page as markdown, text, or raw HTML via exa. Returns page content.",
 		promptSnippet:
 			"fetch(url, format, max_characters?) — format: 'markdown', 'text', or 'html'. Read page content via exa.",
 		promptGuidelines: [
 			"Use fetch when you need to read the full content of a specific URL.",
 			"Prefer format='markdown' for readable content, 'text' for plain text extraction, 'html' for raw source.",
 			"Set max_characters to cap response size (default 1000, 0 = unlimited). Use 5000-10000 for typical pages.",
-			"Always prefer fetch over raw curl/browser for reading page content.",
 		],
 		renderCall: makeRenderCall("fetch", (args) => String(args.url ?? "")),
 		renderResult: makeRenderResult(),
@@ -142,9 +135,7 @@ export default function registerFetch(pi: ExtensionAPI): void {
 
 			try {
 				onUpdate?.({
-					content: [
-						{ type: "text", text: `Fetching (${fmt}): ${params.url}...` },
-					],
+					content: [{ type: "text", text: `Fetching (${fmt}): ${params.url}...` }],
 					details: undefined,
 				});
 
@@ -203,8 +194,7 @@ export default function registerFetch(pi: ExtensionAPI): void {
 					details: { source: "curl-fallback", chars: html.length },
 				};
 			} catch (curlErr: unknown) {
-				const curlMsg =
-					curlErr instanceof Error ? curlErr.message : String(curlErr);
+				const curlMsg = curlErr instanceof Error ? curlErr.message : String(curlErr);
 				return {
 					content: [
 						{

package/src/format.test.ts

@@ -36,9 +36,7 @@ describe("formatSearchResults", () => {
 	});
 
 	it("handles empty results", () => {
-		expect(formatSearchResults(JSON.stringify({ results: [] }))).toBe(
-			"No results.",
-		);
+		expect(formatSearchResults(JSON.stringify({ results: [] }))).toBe("No results.");
 	});
 
 	it("falls back to pretty JSON for unexpected shapes", () => {
@@ -52,14 +50,10 @@ describe("formatSearchResults", () => {
 
 	it("truncates long snippets to 300 chars", () => {
 		const raw = JSON.stringify({
-			results: [
-				{ title: "T", url: "https://x.dev", snippet: "y".repeat(1000) },
-			],
+			results: [{ title: "T", url: "https://x.dev", snippet: "y".repeat(1000) }],
 		});
 		const out = formatSearchResults(raw);
-		const snippetLine = out
-			.split("\n")
-			.find((l) => l.trimStart().startsWith("yyy"));
+		const snippetLine = out.split("\n").find((l) => l.trimStart().startsWith("yyy"));
 		expect(snippetLine?.trim().length).toBe(300);
 	});
 });
@@ -74,9 +68,7 @@ describe("formatFetchResult", () => {
 		});
 
 		const out = formatFetchResult(raw);
-		expect(out).toBe(
-			"# Example Page\nURL: https://example.com\n\n# Hello\n\nBody text.",
-		);
+		expect(out).toBe("# Example Page\nURL: https://example.com\n\n# Hello\n\nBody text.");
 	});
 
 	it("supports content as a plain string", () => {

package/src/provider.test.ts

@@ -8,18 +8,9 @@ import type { ModelsDevModel, RouterModel } from "./data.ts";
 const DEFAULT_CONTEXT_WINDOW = 128_000;
 const DEFAULT_MAX_TOKENS = 16_384;
 
-const IMAGE_CAPABLE_PATTERNS = [
-	/claude/i,
-	/gpt-5/i,
-	/gpt-4/i,
-	/kimi-k2/i,
-	/hy3/i,
-];
-
-function getInputTypes(
-	model: RouterModel,
-	devModel?: ModelsDevModel,
-): ("text" | "image")[] {
+const IMAGE_CAPABLE_PATTERNS = [/claude/i, /gpt-5/i, /gpt-4/i, /kimi-k2/i, /hy3/i];
+
+function getInputTypes(model: RouterModel, devModel?: ModelsDevModel): ("text" | "image")[] {
 	if (devModel?.modalities?.input) {
 		const inputs = devModel.modalities.input.filter(
 			(i): i is "text" | "image" => i === "text" || i === "image",
@@ -35,10 +26,7 @@ function getModelName(model: RouterModel, devModel?: ModelsDevModel): string {
 	return model.name || devModel?.name || model.id || "unknown";
 }
 
-function getContextWindow(
-	model: RouterModel,
-	devModel?: ModelsDevModel,
-): number {
+function getContextWindow(model: RouterModel, devModel?: ModelsDevModel): number {
 	return (
 		model.context_window ||
 		model.contextWindow ||
@@ -48,19 +36,12 @@ function getContextWindow(
 }
 
 function getMaxTokens(model: RouterModel, devModel?: ModelsDevModel): number {
-	return (
-		model.max_tokens ||
-		model.maxTokens ||
-		devModel?.limit?.output ||
-		DEFAULT_MAX_TOKENS
-	);
+	return model.max_tokens || model.maxTokens || devModel?.limit?.output || DEFAULT_MAX_TOKENS;
 }
 
 function getReasoning(model: RouterModel, devModel?: ModelsDevModel): boolean {
 	if (typeof devModel?.reasoning === "boolean") return devModel.reasoning;
-	return /reasoner|thinking|xhigh|high|max|pro|codex|opus|sonnet/i.test(
-		model.id ?? "",
-	);
+	return /reasoner|thinking|xhigh|high|max|pro|codex|opus|sonnet/i.test(model.id ?? "");
 }
 
 // ── getInputTypes ────────────────────────────────────────────────────────────
@@ -85,10 +66,7 @@ describe("getInputTypes", () => {
 	});
 
 	it("falls back to pattern match for claude", () => {
-		expect(getInputTypes({ id: "claude-sonnet-4-5" })).toEqual([
-			"text",
-			"image",
-		]);
+		expect(getInputTypes({ id: "claude-sonnet-4-5" })).toEqual(["text", "image"]);
 	});
 
 	it("falls back to pattern match for gpt-4o", () => {
@@ -96,10 +74,7 @@ describe("getInputTypes", () => {
 	});
 
 	it("falls back to pattern match for kimi-k2", () => {
-		expect(getInputTypes({ id: "kimi-k2-instruct" })).toEqual([
-			"text",
-			"image",
-		]);
+		expect(getInputTypes({ id: "kimi-k2-instruct" })).toEqual(["text", "image"]);
 	});
 
 	it("returns text-only for unknown model with no devModel", () => {
@@ -120,18 +95,13 @@ describe("getInputTypes", () => {
 
 describe("getModelName", () => {
 	it("prefers router model.name", () => {
-		expect(
-			getModelName(
-				{ id: "x", name: "Router Name" },
-				{ id: "x", name: "Dev Name" },
-			),
-		).toBe("Router Name");
+		expect(getModelName({ id: "x", name: "Router Name" }, { id: "x", name: "Dev Name" })).toBe(
+			"Router Name",
+		);
 	});
 
 	it("falls back to devModel.name", () => {
-		expect(getModelName({ id: "x" }, { id: "x", name: "Dev Name" })).toBe(
-			"Dev Name",
-		);
+		expect(getModelName({ id: "x" }, { id: "x", name: "Dev Name" })).toBe("Dev Name");
 	});
 
 	it("falls back to model.id", () => {
@@ -160,9 +130,7 @@ describe("getContextWindow", () => {
 	});
 
 	it("falls back to devModel.limit.context", () => {
-		expect(
-			getContextWindow({ id: "x" }, { id: "x", limit: { context: 200_000 } }),
-		).toBe(200_000);
+		expect(getContextWindow({ id: "x" }, { id: "x", limit: { context: 200_000 } })).toBe(200_000);
 	});
 
 	it("falls back to DEFAULT_CONTEXT_WINDOW", () => {
@@ -175,10 +143,7 @@ describe("getContextWindow", () => {
 describe("getMaxTokens", () => {
 	it("prefers model.max_tokens", () => {
 		expect(
-			getMaxTokens(
-				{ id: "x", max_tokens: 4_096 },
-				{ id: "x", limit: { output: 32_000 } },
-			),
+			getMaxTokens({ id: "x", max_tokens: 4_096 }, { id: "x", limit: { output: 32_000 } }),
 		).toBe(4_096);
 	});
 
@@ -187,9 +152,7 @@ describe("getMaxTokens", () => {
 	});
 
 	it("falls back to devModel.limit.output", () => {
-		expect(
-			getMaxTokens({ id: "x" }, { id: "x", limit: { output: 16_000 } }),
-		).toBe(16_000);
+		expect(getMaxTokens({ id: "x" }, { id: "x", limit: { output: 16_000 } })).toBe(16_000);
 	});
 
 	it("falls back to DEFAULT_MAX_TOKENS", () => {
@@ -206,12 +169,9 @@ describe("getReasoning", () => {
 
 	it("uses devModel.reasoning when boolean false", () => {
 		// even if pattern would match, devModel wins
-		expect(
-			getReasoning(
-				{ id: "claude-opus-4" },
-				{ id: "claude-opus-4", reasoning: false },
-			),
-		).toBe(false);
+		expect(getReasoning({ id: "claude-opus-4" }, { id: "claude-opus-4", reasoning: false })).toBe(
+			false,
+		);
 	});
 
 	it("falls back to pattern — opus", () => {

package/src/provider.ts

@@ -11,12 +11,7 @@
 
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { ModelsDevModel, RouterModel } from "./data.js";
-import {
-	fetchModelsDevIndex,
-	lookupInIndex,
-	routerBaseUrl,
-	routerModels,
-} from "./data.js";
+import { fetchModelsDevIndex, lookupInIndex, routerBaseUrl, routerModels } from "./data.js";
 
 const DEFAULT_CONTEXT_WINDOW = 128_000;
 const DEFAULT_MAX_TOKENS = 16_384;
@@ -29,18 +24,9 @@ const ZERO_COST = {
 };
 
 // Fallback pattern-based detection if models.dev lookup fails
-const IMAGE_CAPABLE_PATTERNS = [
-	/claude/i,
-	/gpt-5/i,
-	/gpt-4/i,
-	/kimi-k2/i,
-	/hy3/i,
-];
+const IMAGE_CAPABLE_PATTERNS = [/claude/i, /gpt-5/i, /gpt-4/i, /kimi-k2/i, /hy3/i];
 
-function getInputTypes(
-	model: RouterModel,
-	devModel?: ModelsDevModel,
-): ("text" | "image")[] {
+function getInputTypes(model: RouterModel, devModel?: ModelsDevModel): ("text" | "image")[] {
 	if (devModel?.modalities?.input) {
 		const inputs = devModel.modalities.input.filter(
 			(i): i is "text" | "image" => i === "text" || i === "image",
@@ -56,10 +42,7 @@ function getModelName(model: RouterModel, devModel?: ModelsDevModel): string {
 	return model.name || devModel?.name || model.id || "unknown";
 }
 
-function getContextWindow(
-	model: RouterModel,
-	devModel?: ModelsDevModel,
-): number {
+function getContextWindow(model: RouterModel, devModel?: ModelsDevModel): number {
 	return (
 		model.context_window ||
 		model.contextWindow ||
@@ -69,24 +52,15 @@ function getContextWindow(
 }
 
 function getMaxTokens(model: RouterModel, devModel?: ModelsDevModel): number {
-	return (
-		model.max_tokens ||
-		model.maxTokens ||
-		devModel?.limit?.output ||
-		DEFAULT_MAX_TOKENS
-	);
+	return model.max_tokens || model.maxTokens || devModel?.limit?.output || DEFAULT_MAX_TOKENS;
 }
 
 function getReasoning(model: RouterModel, devModel?: ModelsDevModel): boolean {
 	if (typeof devModel?.reasoning === "boolean") return devModel.reasoning;
-	return /reasoner|thinking|xhigh|high|max|pro|codex|opus|sonnet/i.test(
-		model.id ?? "",
-	);
+	return /reasoner|thinking|xhigh|high|max|pro|codex|opus|sonnet/i.test(model.id ?? "");
 }
 
-export default async function registerProvider(
-	pi: ExtensionAPI,
-): Promise<void> {
+export default async function registerProvider(pi: ExtensionAPI): Promise<void> {
 	const apiKey = process.env.ROUTER_API_KEY;
 
 	if (!apiKey) {

package/src/render.ts

@@ -37,15 +37,13 @@ const MAX_PREVIEW_LINES = 32;
 
 let TextComponent: TextCtor | undefined;
 try {
-	TextComponent = (require("@earendil-works/pi-tui") as { Text: TextCtor })
-		.Text;
+	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 lastComponent as TextLike;
+	if (lastComponent && "setText" in lastComponent) return 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.
@@ -71,16 +69,11 @@ function dimBody(body: string, theme: Theme, expanded: boolean): string {
 }
 
 /** Build a `renderCall` that shows `<title> <accent arg>`. */
-export function makeRenderCall<TArgs>(
-	title: string,
-	pickArg: (args: TArgs) => string,
-) {
+export function makeRenderCall<TArgs>(title: string, pickArg: (args: TArgs) => string) {
 	return (args: TArgs, theme: Theme, ctx: RenderCtx): Component => {
 		const text = getText(ctx.lastComponent);
 		const arg = pickArg(args);
-		text.setText(
-			`${theme.fg("toolTitle", theme.bold(title))} ${theme.fg("accent", arg)}`,
-		);
+		text.setText(`${theme.fg("toolTitle", theme.bold(title))} ${theme.fg("accent", arg)}`);
 		return text;
 	};
 }

package/src/search.ts

@@ -28,9 +28,7 @@ async function apiPost(
 	const key = auth();
 	const controller = new AbortController();
 	const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
-	const s = signal
-		? AbortSignal.any([signal, controller.signal])
-		: controller.signal;
+	const s = signal ? AbortSignal.any([signal, controller.signal]) : controller.signal;
 
 	try {
 		const res = await fetch(url, {
@@ -128,14 +126,12 @@ export default function registerSearch(pi: ExtensionAPI): void {
 	pi.registerTool({
 		name: "search",
 		label: "Search",
-		description:
-			"Web or news search via exa. Returns title, url, and snippet for each result.",
+		description: "Web or news search via exa. Returns title, url, and snippet for each result.",
 		promptSnippet:
 			"search(query, search_type, max_results?) — search_type: 'web' or 'news'. Defaults to 5 results, max 10.",
 		promptGuidelines: [
 			"Use search when you need up-to-date information or facts from the web.",
 			"Set search_type='web' for general web results, search_type='news' for recent news articles.",
-			"Always prefer search over raw curl/browser requests for information lookup.",
 		],
 		renderCall: makeRenderCall("search", (args) => String(args.query ?? "")),
 		renderResult: makeRenderResult(),
@@ -229,8 +225,7 @@ export default function registerSearch(pi: ExtensionAPI): void {
 					details: { source: "curl-fallback" },
 				};
 			} catch (curlErr: unknown) {
-				const curlMsg =
-					curlErr instanceof Error ? curlErr.message : String(curlErr);
+				const curlMsg = curlErr instanceof Error ? curlErr.message : String(curlErr);
 				return {
 					content: [
 						{

package/src/transcribe.test.ts

@@ -95,9 +95,7 @@ describe("parseTranscriptionResponse", () => {
 	});
 
 	it("returns plain text as-is when not JSON", () => {
-		expect(parseTranscriptionResponse("Just plain text")).toBe(
-			"Just plain text",
-		);
+		expect(parseTranscriptionResponse("Just plain text")).toBe("Just plain text");
 	});
 
 	it("returns empty string from JSON with empty text", () => {
@@ -203,12 +201,7 @@ describe("buildTranscriptionResult", () => {
 
 	it("returns inline text (truncated at 50_000) when no output_file is set", async () => {
 		const text = "a".repeat(60_000);
-		const result = await buildTranscriptionResult(
-			text,
-			"dg/nova-3",
-			"api",
-			undefined,
-		);
+		const result = await buildTranscriptionResult(text, "dg/nova-3", "api", undefined);
 		expect(result.content).toHaveLength(1);
 		expect(result.content[0]?.type).toBe("text");
 		expect(result.content[0]?.text.length).toBe(50_000);
@@ -221,12 +214,7 @@ describe("buildTranscriptionResult", () => {
 
 	it("returns inline text (untruncated) when short and no output_file", async () => {
 		const text = "short transcript";
-		const result = await buildTranscriptionResult(
-			text,
-			"dg/nova-3",
-			"api",
-			undefined,
-		);
+		const result = await buildTranscriptionResult(text, "dg/nova-3", "api", undefined);
 		expect(result.content[0]?.text).toBe("short transcript");
 		expect(result.details.chars).toBe(text.length);
 	});
@@ -234,12 +222,7 @@ describe("buildTranscriptionResult", () => {
 	it("writes full text to file and returns short path summary when output_file is set", async () => {
 		const text = "a".repeat(100_000); // way over 50k
 		const file = join(tmpRoot, "result-a.txt");
-		const result = await buildTranscriptionResult(
-			text,
-			"dg/nova-3",
-			"api",
-			file,
-		);
+		const result = await buildTranscriptionResult(text, "dg/nova-3", "api", file);
 
 		// content is a short summary, not the full text
 		expect(result.content).toHaveLength(1);
@@ -261,12 +244,7 @@ describe("buildTranscriptionResult", () => {
 
 	it("passes through curl-fallback source label", async () => {
 		const text = "hi";
-		const result = await buildTranscriptionResult(
-			text,
-			"dg/nova-3",
-			"curl-fallback",
-			undefined,
-		);
+		const result = await buildTranscriptionResult(text, "dg/nova-3", "curl-fallback", undefined);
 		expect(result.details.source).toBe("curl-fallback");
 	});
 
@@ -274,12 +252,7 @@ describe("buildTranscriptionResult", () => {
 		const text = "relative path content";
 		const relDir = join(tmpRoot, "rel", "sub");
 		const relFile = join(relDir, "out.txt");
-		const result = await buildTranscriptionResult(
-			text,
-			"dg/nova-3",
-			"api",
-			relFile,
-		);
+		const result = await buildTranscriptionResult(text, "dg/nova-3", "api", relFile);
 
 		expect(result.details.output_path).toBe(relFile);
 		expect(await readFile(relFile, "utf-8")).toBe("relative path content");
@@ -302,9 +275,7 @@ describe("validateOutputPath", () => {
 	});
 
 	it("accepts a fresh path several levels deep", async () => {
-		const result = await validateOutputPath(
-			join(tmpRoot, "a", "b", "c", "deep.txt"),
-		);
+		const result = await validateOutputPath(join(tmpRoot, "a", "b", "c", "deep.txt"));
 		expect(result.ok).toBe(true);
 	});
 
@@ -404,9 +375,7 @@ describe("writeTranscriptionFile — rejection propagation", () => {
 	});
 
 	it("throws on null byte", async () => {
-		await expect(
-			writeTranscriptionFile("/tmp/pix-test-\0x.txt", "x"),
-		).rejects.toThrow(/null byte/);
+		await expect(writeTranscriptionFile("/tmp/pix-test-\0x.txt", "x")).rejects.toThrow(/null byte/);
 	});
 });
 
@@ -415,12 +384,7 @@ describe("writeTranscriptionFile — rejection propagation", () => {
 describe("buildTranscriptionResult — write failure path", () => {
 	it("returns isError + inline fallback when output_file is rejected", async () => {
 		const text = "the actual transcription that was successfully produced";
-		const result = await buildTranscriptionResult(
-			text,
-			"dg/nova-3",
-			"api",
-			"/etc/passwd",
-		);
+		const result = await buildTranscriptionResult(text, "dg/nova-3", "api", "/etc/passwd");
 		expect(result.isError).toBe(true);
 		expect(result.details.write_error).toMatch(/refusing to write/);
 		expect(result.details.output_path).toBeUndefined();

package/src/transcribe.ts

@@ -55,9 +55,7 @@ async function apiMultipart(
 	const key = auth();
 	const controller = new AbortController();
 	const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
-	const s = signal
-		? AbortSignal.any([signal, controller.signal])
-		: controller.signal;
+	const s = signal ? AbortSignal.any([signal, controller.signal]) : controller.signal;
 
 	try {
 		const fileData = await readFile(filePath);
@@ -119,9 +117,7 @@ export function parseTranscriptionResponse(raw: string): string {
 
 /** Resolve a possibly-relative `output_file` to an absolute path. */
 export function resolveOutputPath(outputFile: string): string {
-	return isAbsolute(outputFile)
-		? outputFile
-		: resolve(process.cwd(), outputFile);
+	return isAbsolute(outputFile) ? outputFile : resolve(process.cwd(), outputFile);
 }
 
 /**
@@ -132,9 +128,7 @@ export function resolveOutputPath(outputFile: string): string {
  * Returns a discriminated result so the caller can surface a precise reason to
  * the model without leaking OS internals.
  */
-export type PathValidation =
-	| { ok: true; path: string }
-	| { ok: false; reason: string };
+export type PathValidation = { ok: true; path: string } | { ok: false; reason: string };
 
 /** Block-list of absolute prefixes that should never receive transcription output. */
 function sensitivePrefixes(): string[] {
@@ -151,9 +145,7 @@ function sensitivePrefixes(): string[] {
 	];
 }
 
-export async function validateOutputPath(
-	absPath: string,
-): Promise<PathValidation> {
+export async function validateOutputPath(absPath: string): Promise<PathValidation> {
 	// 1. Null byte injection guard (defence in depth — Node already rejects, fail fast with clear msg)
 	if (absPath.includes("\0")) {
 		return { ok: false, reason: "path contains a null byte" };
@@ -240,10 +232,7 @@ export async function validateOutputPath(
 
 /** Write transcription text to disk, creating parent directories as needed.
  *  Performs pre-flight safety checks; throws on rejection. */
-export async function writeTranscriptionFile(
-	outputFile: string,
-	text: string,
-): Promise<string> {
+export async function writeTranscriptionFile(outputFile: string, text: string): Promise<string> {
 	const abs = resolveOutputPath(outputFile);
 	const validation = await validateOutputPath(abs);
 	if (!validation.ok) {
@@ -289,8 +278,7 @@ export async function buildTranscriptionResult(
 				details,
 			};
 		} catch (writeErr) {
-			const msg =
-				writeErr instanceof Error ? writeErr.message : String(writeErr);
+			const msg = writeErr instanceof Error ? writeErr.message : String(writeErr);
 			details.write_error = msg;
 			return {
 				content: [
@@ -348,8 +336,7 @@ export default function registerTranscribe(pi: ExtensionAPI): void {
 			),
 			language: Type.Optional(
 				Type.String({
-					description:
-						"ISO 639-1 language code (e.g. 'en', 'es', 'fr') for better accuracy",
+					description: "ISO 639-1 language code (e.g. 'en', 'es', 'fr') for better accuracy",
 				}),
 			),
 		}),
@@ -361,12 +348,7 @@ export default function registerTranscribe(pi: ExtensionAPI): void {
 			let apiMsg = "";
 
 			const run = async (source: "api" | "curl-fallback", raw: string) =>
-				buildTranscriptionResult(
-					parseTranscriptionResponse(raw),
-					model,
-					source,
-					outputFile,
-				);
+				buildTranscriptionResult(parseTranscriptionResponse(raw), model, source, outputFile);
 
 			try {
 				onUpdate?.({
@@ -418,8 +400,7 @@ export default function registerTranscribe(pi: ExtensionAPI): void {
 				const raw = await curl(curlArgs);
 				return await run("curl-fallback", raw);
 			} catch (curlErr: unknown) {
-				const curlMsg =
-					curlErr instanceof Error ? curlErr.message : String(curlErr);
+				const curlMsg = curlErr instanceof Error ? curlErr.message : String(curlErr);
 				return {
 					content: [
 						{