@chat-js/cli 0.2.0 → 0.3.0

package/templates/chat-app/chat.config.ts

@@ -1,4 +1,4 @@
-import type { ConfigInput } from "@/lib/config-schema";
+import { defineConfig } from "@/lib/config-schema";
 
 const isProd = process.env.NODE_ENV === "production";
 
@@ -8,7 +8,7 @@ const isProd = process.env.NODE_ENV === "production";
  * Edit this file to customize your app.
  * @see https://chatjs.dev/docs/reference/config
  */
-const config = {
+const config = defineConfig({
   appPrefix: "chatjs",
   appName: "ChatJS",
   appTitle: "ChatJS - The prod ready AI chat app",
@@ -68,36 +68,12 @@ const config = {
     vercel: true, // Requires VERCEL_APP_CLIENT_ID + VERCEL_APP_CLIENT_SECRET
   },
   ai: {
-    gateway: "vercel",
-    providerOrder: ["openai", "google", "anthropic", "xai"],
-    disabledModels: ["morph/morph-v3-large", "morph/morph-v3-fast"],
-    curatedDefaults: [
-      // OpenAI
-      "openai/gpt-5-nano",
-      "openai/gpt-5-mini",
-      "openai/gpt-5.2",
-      "openai/gpt-5.2-chat",
-      // Google
-      "google/gemini-2.5-flash-lite",
-      "google/gemini-3-flash",
-      "google/gemini-3-pro-preview",
-      // Anthropic
-      "anthropic/claude-sonnet-4.5",
-      "anthropic/claude-opus-4.5",
-      // xAI
-      "xai/grok-4",
-    ],
-    anonymousModels: [
-      "google/gemini-2.5-flash-lite",
-      "openai/gpt-5-mini",
-      "openai/gpt-5-nano",
-      "anthropic/claude-haiku-4.5",
-    ],
+    gateway: "openai",
+    providerOrder: ["openai"],
+    disabledModels: [],
+    anonymousModels: ["gpt-5-nano"],
     workflows: {
-      chat: "openai/gpt-5-mini",
-      title: "openai/gpt-5-nano",
-      pdf: "openai/gpt-5-mini",
-      chatImageCompatible: "openai/gpt-4o-mini",
+      chatImageCompatible: "gpt-4o-mini",
     },
     tools: {
       webSearch: {
@@ -114,30 +90,25 @@ const config = {
       },
       followupSuggestions: {
         enabled: true,
-        default: "openai/gpt-5-nano",
       },
       text: {
-        polish: "openai/gpt-5-mini",
+        polish: "gpt-5-mini",
       },
       sheet: {
-        format: "openai/gpt-5-mini",
-        analyze: "openai/gpt-5-mini",
+        format: "gpt-5-mini",
+        analyze: "gpt-5-mini",
       },
       code: {
-        edits: "openai/gpt-5-mini",
+        edits: "gpt-5-mini",
       },
       image: {
         enabled: true, // Requires BLOB_READ_WRITE_TOKEN
-        default: "google/gemini-3-pro-image",
-      },
-      video: {
-        enabled: true, // Requires BLOB_READ_WRITE_TOKEN
-        default: "xai/grok-imagine-video",
+        default: "gpt-image-1",
       },
       deepResearch: {
         enabled: true, // Requires webSearch
-        defaultModel: "google/gemini-2.5-flash-lite",
-        finalReportModel: "google/gemini-3-flash",
+        defaultModel: "gpt-5-nano",
+        finalReportModel: "gpt-5-mini",
         allowClarification: true,
         maxResearcherIterations: 1,
         maxConcurrentResearchUnits: 2,
@@ -162,6 +133,6 @@ const config = {
       "application/pdf": [".pdf"],
     },
   },
-} satisfies ConfigInput;
+});
 
 export default config;

package/templates/chat-app/lib/ai/followup-suggestions.ts

@@ -5,16 +5,19 @@ import type { StreamWriter } from "@/lib/ai/types";
 import { config } from "@/lib/config";
 import { generateUUID } from "@/lib/utils";
 
+const FOLLOWUP_CONTEXT_MESSAGES = 2;
+
 export async function generateFollowupSuggestions(
   modelMessages: ModelMessage[]
 ) {
   const maxQuestionCount = 5;
   const minQuestionCount = 3;
   const maxCharactersPerQuestion = 80;
+  const recentMessages = modelMessages.slice(-FOLLOWUP_CONTEXT_MESSAGES);
   return streamText({
     model: await getLanguageModel(config.ai.tools.followupSuggestions.default),
     messages: [
-      ...modelMessages,
+      ...recentMessages,
       {
         role: "user",
         content: `What question should I ask next? Return an array of suggested questions (minimum ${minQuestionCount}, maximum ${maxQuestionCount}). Each question should be no more than ${maxCharactersPerQuestion} characters.`,

package/templates/chat-app/lib/ai/gateway-model-defaults.ts

@@ -1,45 +1,46 @@
-import type { GatewayType } from "./gateways/registry";
+import type {
+  GatewayImageModelIdMap,
+  GatewayModelIdMap,
+  GatewayType,
+  GatewayVideoModelIdMap,
+} from "./gateways/registry";
 
-interface ModelDefaults {
-  anonymousModels: string[];
-  curatedDefaults: string[];
-  disabledModels: string[];
+type VideoDefault<G extends GatewayType> = [GatewayVideoModelIdMap[G]] extends [
+  never,
+]
+  ? { enabled: false }
+  :
+      | { enabled: true; default: GatewayVideoModelIdMap[G] }
+      | { enabled: false; default?: GatewayVideoModelIdMap[G] };
+
+type ImageDefault<G extends GatewayType> = [GatewayImageModelIdMap[G]] extends [
+  never,
+]
+  ? { enabled: false }
+  :
+      | { enabled: true; default: GatewayImageModelIdMap[G] }
+      | { enabled: false; default?: GatewayImageModelIdMap[G] };
+
+export interface ModelDefaultsFor<G extends GatewayType> {
+  anonymousModels: GatewayModelIdMap[G][];
+  curatedDefaults: GatewayModelIdMap[G][];
+  disabledModels: GatewayModelIdMap[G][];
   providerOrder: string[];
   tools: {
-    webSearch: {
-      enabled: boolean;
-    };
-    urlRetrieval: {
-      enabled: boolean;
-    };
-    codeExecution: {
-      enabled: boolean;
-    };
-    mcp: {
-      enabled: boolean;
-    };
-    followupSuggestions: {
-      enabled: boolean;
-      default: string;
-    };
-    text: {
-      polish: string;
-    };
-    sheet: {
-      format: string;
-      analyze: string;
-    };
-    code: {
-      edits: string;
-    };
-    image: {
-      enabled: boolean;
-      default: string;
-    };
+    webSearch: { enabled: boolean };
+    urlRetrieval: { enabled: boolean };
+    codeExecution: { enabled: boolean };
+    mcp: { enabled: boolean };
+    followupSuggestions: { enabled: boolean; default: GatewayModelIdMap[G] };
+    text: { polish: GatewayModelIdMap[G] };
+    sheet: { format: GatewayModelIdMap[G]; analyze: GatewayModelIdMap[G] };
+    code: { edits: GatewayModelIdMap[G] };
+    image: ImageDefault<G>;
+    video: VideoDefault<G>;
     deepResearch: {
       enabled: boolean;
-      defaultModel: string;
-      finalReportModel: string;
+      defaultModel: GatewayModelIdMap[G];
+      finalReportModel: GatewayModelIdMap[G];
       allowClarification: boolean;
       maxResearcherIterations: number;
       maxConcurrentResearchUnits: number;
@@ -47,14 +48,14 @@ interface ModelDefaults {
     };
   };
   workflows: {
-    chat: string;
-    title: string;
-    pdf: string;
-    chatImageCompatible: string;
+    chat: GatewayModelIdMap[G];
+    title: GatewayModelIdMap[G];
+    pdf: GatewayModelIdMap[G];
+    chatImageCompatible: GatewayModelIdMap[G];
   };
 }
 
-const multiProviderDefaults = {
+const vercelDefaults = {
   providerOrder: ["openai", "google", "anthropic"],
   disabledModels: [],
   curatedDefaults: [
@@ -77,36 +78,67 @@ const multiProviderDefaults = {
     chatImageCompatible: "openai/gpt-4o-mini",
   },
   tools: {
-    webSearch: {
-      enabled: false,
-    },
-    urlRetrieval: {
-      enabled: false,
-    },
-    codeExecution: {
+    webSearch: { enabled: false },
+    urlRetrieval: { enabled: false },
+    codeExecution: { enabled: false },
+    mcp: { enabled: false },
+    followupSuggestions: {
       enabled: false,
+      default: "google/gemini-2.5-flash-lite",
     },
-    mcp: {
+    text: { polish: "openai/gpt-5-mini" },
+    sheet: { format: "openai/gpt-5-mini", analyze: "openai/gpt-5-mini" },
+    code: { edits: "openai/gpt-5-mini" },
+    image: { enabled: false, default: "google/gemini-3-pro-image" },
+    video: { enabled: false, default: "xai/grok-imagine-video" },
+    deepResearch: {
       enabled: false,
+      defaultModel: "google/gemini-2.5-flash-lite",
+      finalReportModel: "google/gemini-3-flash",
+      allowClarification: true,
+      maxResearcherIterations: 1,
+      maxConcurrentResearchUnits: 2,
+      maxSearchQueries: 2,
     },
+  },
+} satisfies ModelDefaultsFor<"vercel">;
+
+const openrouterDefaults = {
+  providerOrder: ["openai", "google", "anthropic"],
+  disabledModels: [],
+  curatedDefaults: [
+    "openai/gpt-5-nano",
+    "openai/gpt-5-mini",
+    "openai/gpt-5.2",
+    "openai/gpt-5.2-chat",
+    "google/gemini-2.5-flash-lite",
+    "google/gemini-3-flash",
+    "google/gemini-3-pro-preview",
+    "anthropic/claude-sonnet-4.5",
+    "anthropic/claude-opus-4.5",
+    "xai/grok-4",
+  ],
+  anonymousModels: ["google/gemini-2.5-flash-lite", "openai/gpt-5-nano"],
+  workflows: {
+    chat: "openai/gpt-5-mini",
+    title: "openai/gpt-5-nano",
+    pdf: "openai/gpt-5-mini",
+    chatImageCompatible: "openai/gpt-4o-mini",
+  },
+  tools: {
+    webSearch: { enabled: false },
+    urlRetrieval: { enabled: false },
+    codeExecution: { enabled: false },
+    mcp: { enabled: false },
     followupSuggestions: {
       enabled: false,
       default: "google/gemini-2.5-flash-lite",
     },
-    text: {
-      polish: "openai/gpt-5-mini",
-    },
-    sheet: {
-      format: "openai/gpt-5-mini",
-      analyze: "openai/gpt-5-mini",
-    },
-    code: {
-      edits: "openai/gpt-5-mini",
-    },
-    image: {
-      enabled: false,
-      default: "google/gemini-3-pro-image",
-    },
+    text: { polish: "openai/gpt-5-mini" },
+    sheet: { format: "openai/gpt-5-mini", analyze: "openai/gpt-5-mini" },
+    code: { edits: "openai/gpt-5-mini" },
+    image: { enabled: false },
+    video: { enabled: false },
     deepResearch: {
       enabled: false,
       defaultModel: "google/gemini-2.5-flash-lite",
@@ -117,9 +149,9 @@ const multiProviderDefaults = {
       maxSearchQueries: 2,
     },
   },
-} satisfies ModelDefaults;
+} satisfies ModelDefaultsFor<"openrouter">;
 
-const openaiOnlyDefaults = {
+const openaiDefaults = {
   providerOrder: ["openai"],
   disabledModels: [],
   curatedDefaults: [
@@ -136,36 +168,55 @@ const openaiOnlyDefaults = {
     chatImageCompatible: "gpt-4o-mini",
   },
   tools: {
-    webSearch: {
-      enabled: false,
-    },
-    urlRetrieval: {
-      enabled: false,
-    },
-    codeExecution: {
-      enabled: false,
-    },
-    mcp: {
-      enabled: false,
-    },
-    followupSuggestions: {
-      enabled: false,
-      default: "gpt-5-nano",
-    },
-    text: {
-      polish: "gpt-5-mini",
-    },
-    sheet: {
-      format: "gpt-5-mini",
-      analyze: "gpt-5-mini",
-    },
-    code: {
-      edits: "gpt-5-mini",
-    },
-    image: {
+    webSearch: { enabled: false },
+    urlRetrieval: { enabled: false },
+    codeExecution: { enabled: false },
+    mcp: { enabled: false },
+    followupSuggestions: { enabled: false, default: "gpt-5-nano" },
+    text: { polish: "gpt-5-mini" },
+    sheet: { format: "gpt-5-mini", analyze: "gpt-5-mini" },
+    code: { edits: "gpt-5-mini" },
+    image: { enabled: false },
+    video: { enabled: false },
+    deepResearch: {
       enabled: false,
-      default: "gpt-image-1",
+      defaultModel: "gpt-5-nano",
+      finalReportModel: "gpt-5-mini",
+      allowClarification: true,
+      maxResearcherIterations: 1,
+      maxConcurrentResearchUnits: 2,
+      maxSearchQueries: 2,
     },
+  },
+} satisfies ModelDefaultsFor<"openai">;
+
+const openaiCompatibleDefaults = {
+  providerOrder: ["openai"],
+  disabledModels: [],
+  curatedDefaults: [
+    "gpt-5-nano",
+    "gpt-5-mini",
+    "gpt-5.2",
+    "gpt-5.2-chat-latest",
+  ],
+  anonymousModels: ["gpt-5-nano"],
+  workflows: {
+    chat: "gpt-5-mini",
+    title: "gpt-5-nano",
+    pdf: "gpt-5-mini",
+    chatImageCompatible: "gpt-4o-mini",
+  },
+  tools: {
+    webSearch: { enabled: false },
+    urlRetrieval: { enabled: false },
+    codeExecution: { enabled: false },
+    mcp: { enabled: false },
+    followupSuggestions: { enabled: false, default: "gpt-5-nano" },
+    text: { polish: "gpt-5-mini" },
+    sheet: { format: "gpt-5-mini", analyze: "gpt-5-mini" },
+    code: { edits: "gpt-5-mini" },
+    image: { enabled: false },
+    video: { enabled: false },
     deepResearch: {
       enabled: false,
       defaultModel: "gpt-5-nano",
@@ -176,11 +227,14 @@ const openaiOnlyDefaults = {
       maxSearchQueries: 2,
     },
   },
-} satisfies ModelDefaults;
+} satisfies ModelDefaultsFor<"openai-compatible">;
 
-export const GATEWAY_MODEL_DEFAULTS: Record<GatewayType, ModelDefaults> = {
-  vercel: multiProviderDefaults,
-  openrouter: multiProviderDefaults,
-  openai: openaiOnlyDefaults,
-  "openai-compatible": openaiOnlyDefaults,
+// Record ensures a compile error if a new gateway is added but not here.
+export const GATEWAY_MODEL_DEFAULTS: {
+  [G in GatewayType]: ModelDefaultsFor<G>;
+} = {
+  vercel: vercelDefaults,
+  openrouter: openrouterDefaults,
+  openai: openaiDefaults,
+  "openai-compatible": openaiCompatibleDefaults,
 };

package/templates/chat-app/lib/ai/gateways/openrouter-gateway.ts

@@ -96,7 +96,7 @@ function toAiGatewayModel(model: OpenRouterModelResponse): AiGatewayModel {
 }
 
 export class OpenRouterGateway
-  implements GatewayProvider<"openrouter", string, string, never>
+  implements GatewayProvider<"openrouter", string, never, never>
 {
   readonly type = "openrouter" as const;
 
@@ -113,7 +113,7 @@ export class OpenRouterGateway
     return provider.chat(modelId);
   }
 
-  createImageModel(_modelId: string): ImageModel | null {
+  createImageModel(_modelId: never): ImageModel | null {
     // OpenRouter routes image generation through multimodal language models.
     // Return null to signal callers should use createLanguageModel instead.
     return null;

package/templates/chat-app/lib/ai/tools/generate-image.ts

@@ -41,6 +41,9 @@ async function resolveImageModel(selectedModel?: string): Promise<{
   }
 
   // Fall back to the configured default image model
+  if (!config.ai.tools.image.enabled) {
+    throw new Error("Image generation is not enabled");
+  }
   const defaultId = config.ai.tools.image.default;
   try {
     const model = await getAppModelDefinition(defaultId as AppModelId);
@@ -134,6 +137,10 @@ async function runGenerateImageTraditional({
   startMs: number;
   costAccumulator?: CostAccumulator;
 }): Promise<{ imageUrl: string; prompt: string }> {
+  if (!config.ai.tools.image.enabled) {
+    throw new Error("Image generation is not enabled");
+  }
+  const imageDefault = config.ai.tools.image.default;
   let promptInput:
     | string
     | {
@@ -161,7 +168,7 @@ async function runGenerateImageTraditional({
   }
 
   const res = await generateImage({
-    model: getImageModel(config.ai.tools.image.default),
+    model: getImageModel(imageDefault),
     prompt: promptInput,
     n: 1,
     providerOptions: {
@@ -184,7 +191,7 @@ async function runGenerateImageTraditional({
 
   if (res.usage) {
     costAccumulator?.addLLMCost(
-      config.ai.tools.image.default as AppModelId,
+      imageDefault as AppModelId,
       {
         inputTokens: res.usage.inputTokens,
         outputTokens: res.usage.outputTokens,

package/templates/chat-app/lib/ai/tools/generate-video.ts

@@ -48,6 +48,9 @@ async function resolveVideoModel(selectedModel?: string): Promise<string> {
       // Not in app models registry, fall through
     }
   }
+  if (!config.ai.tools.video.enabled) {
+    throw new Error("Video generation is not enabled");
+  }
   return config.ai.tools.video.default;
 }
 

package/templates/chat-app/lib/ai/types.ts

@@ -101,7 +101,7 @@ type webSearchTool = InferUITool<ReturnType<typeof tavilyWebSearch>>;
 type codeExecutionTool = InferUITool<ReturnType<typeof codeExecution>>;
 type retrieveUrlTool = InferUITool<typeof retrieveUrl>;
 
-// biome-ignore lint/style/useConsistentTypeDefinitions: <explanation>
+// biome-ignore lint/style/useConsistentTypeDefinitions: using type for mapped type compatibility
 export type ChatTools = {
   codeExecution: codeExecutionTool;
   createCodeDocument: createCodeDocumentToolType;
@@ -123,7 +123,7 @@ interface FollowupSuggestions {
   suggestions: string[];
 }
 
-// biome-ignore lint/style/useConsistentTypeDefinitions: <explanation>
+// biome-ignore lint/style/useConsistentTypeDefinitions: using type for mapped type compatibility
 export type CustomUIDataTypes = {
   appendMessage: string;
   chatConfirmed: {