@xynogen/pix-data 0.1.0 → 0.1.2

package/README.md

@@ -19,13 +19,21 @@ Pi coding agent extension — shared model data layer. Fetches and caches [model
 ## Install
 
 ```bash
-pi install git:github.com/xynogen/pix-data
+pi install npm:@xynogen/pix-data
 ```
 
 ## How it works
 
 On session start the extension fires two parallel background fetches (`modelsDev.get()` + `benchmark.get()`). If the cache is fresh the fetches are skipped. Both cache files live in `~/.cache/pi/` — any Pi extension using the same `DataSource` + cache paths will share data automatically.
 
+## Full distro
+
+To install the complete pix suite (all packages + Pi itself):
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/xynogen/pix-mono/main/scripts/install.sh | sh
+```
+
 ## License
 
 MIT

package/package.json

@@ -1,36 +1,44 @@
 {
-  "name": "@xynogen/pix-data",
-  "version": "0.1.0",
-  "description": "Pi extension — shared model data layer (models.dev + BenchLM), cached at ~/.cache/pi",
-  "type": "module",
-  "main": "src/index.ts",
-  "scripts": {
-    "test": "bun test"
-  },
-  "files": [
-    "src",
-    "README.md",
-    "LICENSE"
-  ],
-  "pi": {
-    "extensions": ["src/index.ts"]
-  },
-  "keywords": ["pi", "pi-package", "pi-extension", "models.dev", "benchlm"],
-  "author": "xynogen",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/xynogen/pix-mono.git",
-    "directory": "packages/pix-data"
-  },
-  "homepage": "https://github.com/xynogen/pix-mono/tree/main/packages/pix-data#readme",
-  "bugs": {
-    "url": "https://github.com/xynogen/pix-mono/issues"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "*"
-  }
+	"name": "@xynogen/pix-data",
+	"version": "0.1.2",
+	"description": "Pi extension — shared model data layer (models.dev + BenchLM), cached at ~/.cache/pi",
+	"type": "module",
+	"main": "src/index.ts",
+	"scripts": {
+		"test": "bun test"
+	},
+	"files": [
+		"src",
+		"README.md",
+		"LICENSE"
+	],
+	"pi": {
+		"extensions": [
+			"src/index.ts"
+		]
+	},
+	"keywords": [
+		"pi",
+		"pi-package",
+		"pi-extension",
+		"models.dev",
+		"benchlm"
+	],
+	"author": "xynogen",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/xynogen/pix-mono.git",
+		"directory": "packages/pix-data"
+	},
+	"homepage": "https://github.com/xynogen/pix-mono/tree/main/packages/pix-data#readme",
+	"bugs": {
+		"url": "https://github.com/xynogen/pix-mono/issues"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"peerDependencies": {
+		"@earendil-works/pi-coding-agent": "*"
+	}
 }

package/src/data.test.ts

@@ -1,14 +1,14 @@
-import { describe, it, expect, beforeEach, afterEach } from "bun:test";
+import { afterEach, beforeEach, describe, expect, it } from "bun:test";
 import {
+	type BenchmarkEntry,
+	benchmark,
 	buildModelsDevIndex,
+	lookupBenchmark,
 	lookupInIndex,
 	lookupModelsDev,
-	lookupBenchmark,
-	modelsDev,
-	benchmark,
 	type ModelsDevApi,
 	type ModelsDevModel,
-	type BenchmarkEntry,
+	modelsDev,
 } from "./data.ts";
 
 // ── buildModelsDevIndex ──────────────────────────────────────────────────────
@@ -17,13 +17,24 @@ describe("buildModelsDevIndex", () => {
 	const api: ModelsDevApi = {
 		anthropic: {
 			models: {
-				"claude-sonnet-4-5": { id: "claude-sonnet-4-5", name: "Claude Sonnet 4.5" },
-				"claude-opus-4": { id: "claude-opus-4", name: "Claude Opus 4", reasoning: true },
+				"claude-sonnet-4-5": {
+					id: "claude-sonnet-4-5",
+					name: "Claude Sonnet 4.5",
+				},
+				"claude-opus-4": {
+					id: "claude-opus-4",
+					name: "Claude Opus 4",
+					reasoning: true,
+				},
 			},
 		},
 		openai: {
 			models: {
-				"gpt-4o": { id: "gpt-4o", name: "GPT-4o", modalities: { input: ["text", "image"] } },
+				"gpt-4o": {
+					id: "gpt-4o",
+					name: "GPT-4o",
+					modalities: { input: ["text", "image"] },
+				},
 			},
 		},
 	};
@@ -39,7 +50,10 @@ describe("buildModelsDevIndex", () => {
 		const a: ModelsDevApi = {
 			anthropic: {
 				models: {
-					"claude-sonnet-4-5-20250514": { id: "claude-sonnet-4-5-20250514", name: "Claude Sonnet 4.5" },
+					"claude-sonnet-4-5-20250514": {
+						id: "claude-sonnet-4-5-20250514",
+						name: "Claude Sonnet 4.5",
+					},
 				},
 			},
 		};
@@ -73,7 +87,10 @@ describe("lookupInIndex", () => {
 		index = buildModelsDevIndex({
 			anthropic: {
 				models: {
-					"claude-sonnet-4-5": { id: "claude-sonnet-4-5", name: "Claude Sonnet 4.5" },
+					"claude-sonnet-4-5": {
+						id: "claude-sonnet-4-5",
+						name: "Claude Sonnet 4.5",
+					},
 					"claude-opus-4": { id: "claude-opus-4", name: "Claude Opus 4" },
 				},
 			},
@@ -87,23 +104,33 @@ 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("strips provider prefix (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("strips deep prefix (cc/model)", () => {
-		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("strips date suffix", () => {
-		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("strips 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", () => {
@@ -123,7 +150,10 @@ describe("lookupModelsDev", () => {
 		(modelsDev as any)._mem = {
 			anthropic: {
 				models: {
-					"claude-sonnet-4-5": { id: "claude-sonnet-4-5", name: "Claude Sonnet 4.5" },
+					"claude-sonnet-4-5": {
+						id: "claude-sonnet-4-5",
+						name: "Claude Sonnet 4.5",
+					},
 				},
 			},
 			openai: {
@@ -139,7 +169,9 @@ describe("lookupModelsDev", () => {
 	});
 
 	it("finds by exact provider + id", () => {
-		expect(lookupModelsDev("anthropic", "claude-sonnet-4-5")?.name).toBe("Claude Sonnet 4.5");
+		expect(lookupModelsDev("anthropic", "claude-sonnet-4-5")?.name).toBe(
+			"Claude Sonnet 4.5",
+		);
 	});
 
 	it("falls back across providers when provider miss", () => {
@@ -147,9 +179,9 @@ describe("lookupModelsDev", () => {
 	});
 
 	it("strips path prefix from id", () => {
-		expect(lookupModelsDev("anthropic", "anthropic/claude-sonnet-4-5")?.name).toBe(
-			"Claude Sonnet 4.5",
-		);
+		expect(
+			lookupModelsDev("anthropic", "anthropic/claude-sonnet-4-5")?.name,
+		).toBe("Claude Sonnet 4.5");
 	});
 
 	it("returns undefined for unknown model", () => {
@@ -161,9 +193,30 @@ describe("lookupModelsDev", () => {
 
 describe("lookupBenchmark", () => {
 	const entries: BenchmarkEntry[] = [
-		{ rank: 1, model: "Claude Sonnet 4.5", creator: "Anthropic", overallScore: 95, inputPrice: 3, outputPrice: 15 },
-		{ rank: 2, model: "GPT-4o", creator: "OpenAI", overallScore: 90, inputPrice: 5, outputPrice: 15 },
-		{ rank: 3, model: "Gemini 1.5 Pro", creator: "Google", overallScore: 88, inputPrice: 3.5, outputPrice: 10.5 },
+		{
+			rank: 1,
+			model: "Claude Sonnet 4.5",
+			creator: "Anthropic",
+			overallScore: 95,
+			inputPrice: 3,
+			outputPrice: 15,
+		},
+		{
+			rank: 2,
+			model: "GPT-4o",
+			creator: "OpenAI",
+			overallScore: 90,
+			inputPrice: 5,
+			outputPrice: 15,
+		},
+		{
+			rank: 3,
+			model: "Gemini 1.5 Pro",
+			creator: "Google",
+			overallScore: 88,
+			inputPrice: 3.5,
+			outputPrice: 10.5,
+		},
 	];
 
 	beforeEach(() => {

package/src/data.ts

@@ -20,8 +20,8 @@
  *   import { lookupModelsDev, lookupBenchmark } from "./data.ts";
  */
 
-import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { existsSync, readFileSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 
@@ -131,7 +131,11 @@ export class DataSource<T> {
 		try {
 			const url =
 				typeof this.opts.url === "function" ? this.opts.url() : this.opts.url;
-			const response = await fetchWithTimeout(url, this.opts.timeoutMs, this.opts.headers());
+			const response = await fetchWithTimeout(
+				url,
+				this.opts.timeoutMs,
+				this.opts.headers(),
+			);
 			if (!response.ok)
 				throw new Error(`${this.opts.label} fetch failed: ${response.status}`);
 			const raw = await response.json();
@@ -142,7 +146,9 @@ export class DataSource<T> {
 		} catch (error) {
 			const msg = error instanceof Error ? error.message : String(error);
 			if (cached !== undefined) {
-				console.warn(`${this.opts.label} fetch failed, using stale cache: ${msg}`);
+				console.warn(
+					`${this.opts.label} fetch failed, using stale cache: ${msg}`,
+				);
 				const val = this.opts.parseCache(cached.data);
 				this._mem = val;
 				return val;
@@ -152,7 +158,9 @@ export class DataSource<T> {
 		}
 	}
 
-	private async _readCache(): Promise<{ ts: number; data: unknown } | undefined> {
+	private async _readCache(): Promise<
+		{ ts: number; data: unknown } | undefined
+	> {
 		try {
 			const raw = await readFile(this.opts.cachePath, "utf8");
 			const parsed = JSON.parse(raw) as { ts: number; data: unknown };
@@ -166,7 +174,10 @@ export class DataSource<T> {
 	private async _writeCache(data: unknown): Promise<void> {
 		try {
 			await mkdir(dirname(this.opts.cachePath), { recursive: true });
-			await writeFile(this.opts.cachePath, JSON.stringify({ ts: Date.now(), data }));
+			await writeFile(
+				this.opts.cachePath,
+				JSON.stringify({ ts: Date.now(), data }),
+			);
 		} catch {
 			// Write failure is non-fatal — stale cache used on next run
 		}
@@ -226,7 +237,9 @@ function stripPrefix(id: string): string {
 	return i >= 0 ? id.slice(i + 1) : id;
 }
 
-export function buildModelsDevIndex(api: ModelsDevApi): Map<string, ModelsDevModel> {
+export function buildModelsDevIndex(
+	api: ModelsDevApi,
+): Map<string, ModelsDevModel> {
 	const index = new Map<string, ModelsDevModel>();
 	for (const provider of Object.values(api)) {
 		if (!provider?.models) continue;
@@ -254,7 +267,10 @@ export function lookupInIndex(
 	return undefined;
 }
 
-export function lookupModelsDev(provider: string, id: string): ModelsDevModel | undefined {
+export function lookupModelsDev(
+	provider: string,
+	id: string,
+): ModelsDevModel | undefined {
 	const data = modelsDev.getCached();
 	const canonical = id.includes("/") ? id.slice(id.lastIndexOf("/") + 1) : id;
 	const exact = data[provider]?.models?.[canonical];
@@ -266,12 +282,18 @@ export function lookupModelsDev(provider: string, id: string): ModelsDevModel |
 	return undefined;
 }
 
-export async function fetchModelsDevIndex(): Promise<Map<string, ModelsDevModel>> {
+export async function fetchModelsDevIndex(): Promise<
+	Map<string, ModelsDevModel>
+> {
 	return buildModelsDevIndex(await modelsDev.get());
 }
 
 function normBench(s: string): string {
-	return s.toLowerCase().replace(/[-_.]+/g, " ").replace(/\s+/g, " ").trim();
+	return s
+		.toLowerCase()
+		.replace(/[-_.]+/g, " ")
+		.replace(/\s+/g, " ")
+		.trim();
 }
 
 export function lookupBenchmark(modelName: string): BenchmarkEntry | undefined {

package/src/index.ts

@@ -8,7 +8,27 @@
  */
 
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { modelsDev, benchmark } from "./data.ts";
+import { benchmark, modelsDev } from "./data.ts";
+
+export type {
+	BenchmarkEntry,
+	ModelsDevApi,
+	ModelsDevModel,
+} from "./data.ts";
+// Public data API — single source of truth for the shared model data layer.
+// Consumers (pix-core, pix-9router, …) import these instead of duplicating
+// the DataSource implementation and models.dev/BenchLM lookups.
+export {
+	benchmark,
+	buildModelsDevIndex,
+	CACHE_DIR,
+	DataSource,
+	fetchModelsDevIndex,
+	lookupBenchmark,
+	lookupInIndex,
+	lookupModelsDev,
+	modelsDev,
+} from "./data.ts";
 
 export default function (_pi: ExtensionAPI): void {
 	void modelsDev.get();