@gajae-code/ai 0.4.2 → 0.4.4

package/dist/types/types.d.ts

@@ -717,6 +717,14 @@ export interface Model<TApi extends Api = any> {
     baseUrl: string;
     reasoning: boolean;
     input: ("text" | "image")[];
+    /**
+     * Output modalities the model can produce. Defaults to text-only when
+     * unset. A model that lists `"image"` advertises image-generation support
+     * (e.g. an OpenAI-compatible `gpt-image` model behind a proxy), which the
+     * `generate_image` tool uses to route requests without first-party
+     * provider/id heuristics.
+     */
+    output?: ("text" | "image")[];
     cost: {
         input: number;
         output: number;

package/dist/types/utils/http-inspector.d.ts

@@ -13,6 +13,10 @@ export type CapturedHttpErrorResponse = {
     bodyText?: string;
     bodyJson?: unknown;
 };
+/** Whether `message` (from a 400 response) signals an unavailable/unknown model. */
+export declare function isModelUnavailableError(message: string, error: unknown): boolean;
+/** Actionable guidance for selecting an available model/provider. */
+export declare function formatModelUnavailableGuidance(dump: RawHttpRequestDump | undefined): string;
 export declare function appendRawHttpRequestDumpFor400(message: string, error: unknown, dump: RawHttpRequestDump | undefined): Promise<string>;
 export declare function finalizeErrorMessage(error: unknown, rawRequestDump: RawHttpRequestDump | undefined, capturedErrorResponse?: CapturedHttpErrorResponse): Promise<string>;
 export declare function withHttpStatus(error: unknown, status: number): Error;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@gajae-code/ai",
-	"version": "0.4.2",
+	"version": "0.4.4",
 	"description": "Unified LLM API with automatic model discovery and provider configuration",
 	"homepage": "https://gaebal-gajae.dev",
 	"author": "Yeachan-Heo",
@@ -43,7 +43,7 @@
 	"dependencies": {
 		"@anthropic-ai/sdk": "^0.94.0",
 		"@bufbuild/protobuf": "^2.12.0",
-		"@gajae-code/utils": "0.4.2",
+		"@gajae-code/utils": "0.4.4",
 		"openai": "^6.36.0",
 		"partial-json": "^0.1.7",
 		"zod": "4.4.3"

package/src/models.json

@@ -9853,7 +9853,8 @@
 			"baseUrl": "https://api.kilo.ai/api/gateway",
 			"reasoning": false,
 			"input": [
-				"text"
+				"text",
+				"image"
 			],
 			"cost": {
 				"input": 0,
@@ -9872,7 +9873,8 @@
 			"baseUrl": "https://api.kilo.ai/api/gateway",
 			"reasoning": false,
 			"input": [
-				"text"
+				"text",
+				"image"
 			],
 			"cost": {
 				"input": 0,
@@ -16768,7 +16770,8 @@
 			"baseUrl": "https://api.kilo.ai/api/gateway",
 			"reasoning": false,
 			"input": [
-				"text"
+				"text",
+				"image"
 			],
 			"cost": {
 				"input": 0,
@@ -63601,7 +63604,8 @@
 			"baseUrl": "https://api.venice.ai/api/v1",
 			"reasoning": false,
 			"input": [
-				"text"
+				"text",
+				"image"
 			],
 			"cost": {
 				"input": 0,

package/src/types.ts

@@ -854,6 +854,14 @@ export interface Model<TApi extends Api = any> {
 	baseUrl: string;
 	reasoning: boolean;
 	input: ("text" | "image")[];
+	/**
+	 * Output modalities the model can produce. Defaults to text-only when
+	 * unset. A model that lists `"image"` advertises image-generation support
+	 * (e.g. an OpenAI-compatible `gpt-image` model behind a proxy), which the
+	 * `generate_image` tool uses to route requests without first-party
+	 * provider/id heuristics.
+	 */
+	output?: ("text" | "image")[];
 	cost: {
 		input: number; // $/million tokens
 		output: number; // $/million tokens

package/src/utils/http-inspector.ts

@@ -1,5 +1,5 @@
 import * as path from "node:path";
-import { extractHttpStatusFromError, getLogsDir } from "@gajae-code/utils";
+import { APP_NAME, extractHttpStatusFromError, getLogsDir } from "@gajae-code/utils";
 import { isCopilotTransientModelError } from "./retry.js";
 import { formatErrorMessageWithRetryAfter } from "./retry-after.js";
 
@@ -26,6 +26,46 @@ type ErrorWithStatus = {
 
 const SENSITIVE_HEADERS = ["authorization", "x-api-key", "api-key", "cookie", "set-cookie", "proxy-authorization"];
 
+/**
+ * Privacy note appended next to a saved raw HTTP request dump. The dump is
+ * sanitized (secrets/thinking redacted) but can still contain prompt content
+ * and request metadata, so we explicitly discourage pasting it into public
+ * channels (issue #438).
+ */
+const RAW_HTTP_REQUEST_PRIVACY_NOTE =
+	"note: this local file is for your own debugging and may contain prompt content or request metadata — review it before sharing and do not paste its contents into public channels (issues, Discord, etc.).";
+
+/**
+ * Patterns that indicate the configured model is unavailable on the provider
+ * (e.g. OpenAI's "The requested model '...' does not exist."). Used to surface
+ * actionable model/provider guidance instead of only a raw 400 + log path.
+ */
+const MODEL_UNAVAILABLE_PATTERNS: readonly RegExp[] = [
+	/\bmodel\b[^\n]*\bdoes not exist\b/i,
+	/\bdoes not exist\b[^\n]*\bmodel\b/i,
+	/\bmodel\b[^\n]*\b(not found|unavailable|not supported|no access|does not have access)\b/i,
+	/\b(unknown|unsupported|invalid)\s+model\b/i,
+];
+
+/** Whether `message` (from a 400 response) signals an unavailable/unknown model. */
+export function isModelUnavailableError(message: string, error: unknown): boolean {
+	if (extractHttpStatusFromError(error) !== 400) return false;
+	return MODEL_UNAVAILABLE_PATTERNS.some(pattern => pattern.test(message));
+}
+
+/** Actionable guidance for selecting an available model/provider. */
+export function formatModelUnavailableGuidance(dump: RawHttpRequestDump | undefined): string {
+	const modelPart = dump?.model ? ` '${dump.model}'` : "";
+	const providerPart = dump?.provider ? ` on provider '${dump.provider}'` : "";
+	return [
+		`The configured model${modelPart}${providerPart} is not available on this account/provider.`,
+		"Pick an available model before retrying:",
+		`  • List available models:  ${APP_NAME} --list-models`,
+		`  • Run with a model:        ${APP_NAME} --model <model>`,
+		`  • Configure a provider:    ${APP_NAME} setup provider`,
+	].join("\n");
+}
+
 export async function appendRawHttpRequestDumpFor400(
 	message: string,
 	error: unknown,
@@ -41,7 +81,7 @@ export async function appendRawHttpRequestDumpFor400(
 
 	try {
 		await Bun.write(filePath, `${JSON.stringify(sanitizedDump, null, 2)}\n`);
-		return `${message}\nraw-http-request=${filePath}`;
+		return `${message}\nraw-http-request=${filePath}\n${RAW_HTTP_REQUEST_PRIVACY_NOTE}`;
 	} catch (writeError) {
 		const writeMessage = writeError instanceof Error ? writeError.message : String(writeError);
 		return `${message}\nraw-http-request-save-failed=${writeMessage}`;
@@ -62,6 +102,9 @@ export async function finalizeErrorMessage(
 			message = `${message}\n${capturedMessage}`;
 		}
 	}
+	if (isModelUnavailableError(message, error)) {
+		message = `${message}\n\n${formatModelUnavailableGuidance(rawRequestDump)}`;
+	}
 	return appendRawHttpRequestDumpFor400(message, error, rawRequestDump);
 }