@xynogen/pix-9router 0.3.3 → 0.3.4

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@xynogen/pix-9router",
-	"version": "0.3.3",
+	"version": "0.3.4",
 	"description": "Pi extension — 9Router provider + fetch/search tools via router API",
 	"type": "module",
 	"main": "src/index.ts",

package/src/fetch.ts

@@ -118,7 +118,8 @@ export default function registerFetch(pi: ExtensionAPI): void {
 		parameters: Type.Object({
 			url: Type.String({ description: "URL to fetch" }),
 			format: StringEnum(["markdown", "text", "html"] as const, {
-				description: "Desired output format",
+				description:
+					'Required choice. Enter exactly "markdown" for readable Markdown, "text" for plain text, or "html" for raw HTML.',
 			}),
 			max_characters: Type.Optional(
 				Type.Number({

package/src/search.ts

@@ -138,7 +138,8 @@ export default function registerSearch(pi: ExtensionAPI): void {
 		parameters: Type.Object({
 			query: Type.String({ description: "Search query" }),
 			search_type: StringEnum(["web", "news"] as const, {
-				description: "web or news search",
+				description:
+					'Required choice. Enter exactly "web" for general web results or "news" for recent news articles.',
 			}),
 			max_results: Type.Optional(
 				Type.Number({

package/src/tool-schema.test.ts

@@ -0,0 +1,40 @@
+import { describe, expect, test } from "bun:test";
+import registerFetch from "./fetch.ts";
+import registerSearch from "./search.ts";
+
+function captureParameters(register: (pi: never) => void): {
+	properties: Record<string, { type?: string; enum?: string[]; description?: string }>;
+} {
+	let parameters: unknown;
+	register({
+		registerTool(tool: { parameters: unknown }) {
+			parameters = tool.parameters;
+		},
+	} as never);
+	if (!parameters) throw new Error("tool parameters not captured");
+	return parameters as {
+		properties: Record<string, { type?: string; enum?: string[]; description?: string }>;
+	};
+}
+
+describe("enum-like tool parameters", () => {
+	test("search_type exposes values and their semantics", () => {
+		const searchType = captureParameters(registerSearch).properties.search_type;
+		if (!searchType) throw new Error("search_type schema not found");
+
+		expect(searchType.type).toBe("string");
+		expect(searchType.enum).toEqual(["web", "news"]);
+		expect(searchType.description).toContain('exactly "web"');
+		expect(searchType.description).toContain('"news"');
+	});
+
+	test("fetch format exposes values and their semantics", () => {
+		const format = captureParameters(registerFetch).properties.format;
+		if (!format) throw new Error("format schema not found");
+
+		expect(format.type).toBe("string");
+		expect(format.enum).toEqual(["markdown", "text", "html"]);
+		expect(format.description).toContain('exactly "markdown"');
+		expect(format.description).toContain('"html"');
+	});
+});