pi-jev-lens 0.4.0 → 0.4.1

package/README.md

@@ -282,4 +282,6 @@ Issues and pull requests are welcome at [github.com/dizk/pi-jev-lens](https://gi
 built or chosen must come with benchmark numbers. If the change touches code views, you must use the 500-trajectory
 slice.
 
+For npm publication through GitHub Releases, see [Release to npm](docs/releasing.md).
+
 MIT, see LICENSE.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-jev-lens",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "pi extension that compresses large tool results before they reach the model: jev picks the view (outline, relevant blocks, sections, signals, testlog), full text stays recallable",
   "author": "Didrik Rognstad",
   "license": "MIT",

package/src/health.ts

@@ -2,6 +2,29 @@ export type Stage = "presend" | "postsend";
 
 type StageHealth = { failures: number; failing: boolean; reason: string; notified: boolean };
 
+/** Report only validated status codes and fixed advice, never raw provider data. */
+function failureReason(error: unknown): string {
+	const e = error && typeof error === "object" ? error as { status?: unknown; name?: unknown } : {};
+	const status = typeof e.status === "number" && Number.isInteger(e.status) && e.status >= 100 && e.status <= 599 ? e.status : undefined;
+	if (status !== undefined) {
+		const advice = status === 402 ? "Payment required. Check your TypeSafe credits and billing at https://console.typesafe.ai."
+			: status === 401 ? "Authentication failed. Check your TypeSafe API key."
+			: status === 403 ? "Access denied. Check your TypeSafe API key and account permissions."
+			: status === 429 ? "TypeSafe rejected the request because of a usage limit. Check your rate limits and quota at https://console.typesafe.ai."
+			: status === 400 || status === 422 ? "TypeSafe rejected the request format. Check SDK compatibility and the model configuration."
+			: status === 404 ? "TypeSafe could not find the requested resource. Check the model and API endpoint."
+			: status === 408 || status === 504 ? "The API request timed out. Retry later."
+			: status >= 500 ? "TypeSafe reported a server error. Retry later and check service availability."
+			: "TypeSafe returned an unexpected HTTP response. Check service availability and account settings.";
+		return `HTTP ${status}: ${advice}`;
+	}
+	if (e.name === "APITimeoutError" || e.name === "TimeoutError") return "Request timed out (no HTTP status). Check your connection and TypeSafe service availability.";
+	if (e.name === "APIConnectionError") return "Connection failed (no HTTP status). Check your network, proxy, and TypeSafe service availability.";
+	if (e.name === "TypeSafeError") return "TypeSafe SDK error (no HTTP status). Check SDK compatibility and configuration.";
+	if (e.name === "TypeError" || e.name === "RangeError" || e.name === "SyntaxError") return `${e.name} during compression (no HTTP status). The cause is unknown. Report this as a jev-lens bug if it persists.`;
+	return "Unclassified error (no HTTP status). The cause is unknown. Report this as a jev-lens bug if it persists.";
+}
+
 /** Session-local failure counters. Never expose provider error messages or credentials. */
 export class Health {
 	private stages: Record<Stage, StageHealth> = {
@@ -10,10 +33,7 @@ export class Health {
 	};
 
 	failure(stage: Stage, error: unknown): void {
-		const status = error && typeof error === "object" && "status" in error ? error.status : undefined;
-		const reason = status === 401 || status === 403 ? "Check your TypeSafe API key."
-			: status === 429 ? "TypeSafe rejected the request because of a usage limit."
-			: "Check your connection and TypeSafe service availability.";
+		const reason = failureReason(error);
 		Object.assign(this.stages[stage], { failures: this.stages[stage].failures + 1, failing: true, reason });
 	}