@chat-js/cli 0.2.1 → 0.3.0

package/dist/index.js

@@ -3914,7 +3914,7 @@ var {
 // package.json
 var package_default = {
   name: "@chat-js/cli",
-  version: "0.2.1",
+  version: "0.3.0",
   description: "CLI for creating and extending ChatJS apps",
   license: "Apache-2.0",
   repository: {
@@ -17611,6 +17611,71 @@ var add = new Command().name("add").description("add a component or feature to a
   }
 });
 
+// src/commands/config.ts
+import { spawn } from "node:child_process";
+import path from "node:path";
+
+// src/utils/get-package-manager.ts
+function inferPackageManager() {
+  const ua = process.env.npm_config_user_agent ?? "";
+  if (ua.startsWith("pnpm/"))
+    return "pnpm";
+  if (ua.startsWith("yarn/"))
+    return "yarn";
+  if (ua.startsWith("npm/"))
+    return "npm";
+  if (ua.startsWith("bun/"))
+    return "bun";
+  return "bun";
+}
+
+// src/commands/config.ts
+var EVAL_SCRIPT = `
+import userConfig from "./chat.config.ts";
+import { applyDefaults } from "./lib/config-schema";
+console.log(JSON.stringify(applyDefaults(userConfig), null, 2));
+`;
+function getTsEvalCommand(pm) {
+  switch (pm) {
+    case "bun":
+      return ["bun", ["--eval", EVAL_SCRIPT]];
+    case "pnpm":
+      return ["pnpm", ["dlx", "tsx", "--eval", EVAL_SCRIPT]];
+    case "yarn":
+      return ["yarn", ["dlx", "tsx", "--eval", EVAL_SCRIPT]];
+    default:
+      return ["npx", ["tsx", "--eval", EVAL_SCRIPT]];
+  }
+}
+var config2 = new Command().name("config").description("print the resolved configuration for the current ChatJS project").option("-c, --cwd <cwd>", "the working directory (defaults to current directory)", process.cwd()).action(async (opts) => {
+  try {
+    const cwd = path.resolve(opts.cwd);
+    const pm = inferPackageManager();
+    const [cmd, args] = getTsEvalCommand(pm);
+    await new Promise((resolve, reject) => {
+      const child = spawn(cmd, args, {
+        cwd,
+        stdio: ["ignore", "inherit", "pipe"]
+      });
+      const stderr = [];
+      child.stderr?.on("data", (data) => stderr.push(String(data)));
+      child.on("error", (err) => {
+        reject(new Error(`Could not spawn ${cmd}. Make sure ${pm} is installed.
+${err.message}`));
+      });
+      child.on("close", (code) => {
+        if (code === 0)
+          resolve();
+        else
+          reject(new Error(`Failed to resolve config:
+${stderr.join("").trim()}`));
+      });
+    });
+  } catch (error48) {
+    handleError(error48);
+  }
+});
+
 // src/commands/create.ts
 import { readFile, writeFile } from "node:fs/promises";
 import { join as join2, resolve as resolve2 } from "node:path";
@@ -18661,7 +18726,7 @@ ${l}
 } }).prompt();
 
 // ../../apps/chat/lib/ai/gateway-model-defaults.ts
-var multiProviderDefaults = {
+var vercelDefaults = {
   providerOrder: ["openai", "google", "anthropic"],
   disabledModels: [],
   curatedDefaults: [
@@ -18684,36 +18749,66 @@ var multiProviderDefaults = {
     chatImageCompatible: "openai/gpt-4o-mini"
   },
   tools: {
-    webSearch: {
-      enabled: false
-    },
-    urlRetrieval: {
-      enabled: false
-    },
-    codeExecution: {
-      enabled: false
-    },
-    mcp: {
-      enabled: false
-    },
+    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: {
+    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,
-      default: "google/gemini-3-pro-image"
+      defaultModel: "google/gemini-2.5-flash-lite",
+      finalReportModel: "google/gemini-3-flash",
+      allowClarification: true,
+      maxResearcherIterations: 1,
+      maxConcurrentResearchUnits: 2,
+      maxSearchQueries: 2
+    }
+  }
+};
+var 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 },
+    video: { enabled: false },
     deepResearch: {
       enabled: false,
       defaultModel: "google/gemini-2.5-flash-lite",
@@ -18725,7 +18820,7 @@ var multiProviderDefaults = {
     }
   }
 };
-var openaiOnlyDefaults = {
+var openaiDefaults = {
   providerOrder: ["openai"],
   disabledModels: [],
   curatedDefaults: [
@@ -18742,36 +18837,54 @@ var 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
+    }
+  }
+};
+var 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",
@@ -18784,10 +18897,10 @@ var openaiOnlyDefaults = {
   }
 };
 var GATEWAY_MODEL_DEFAULTS = {
-  vercel: multiProviderDefaults,
-  openrouter: multiProviderDefaults,
-  openai: openaiOnlyDefaults,
-  "openai-compatible": openaiOnlyDefaults
+  vercel: vercelDefaults,
+  openrouter: openrouterDefaults,
+  openai: openaiDefaults,
+  "openai-compatible": openaiCompatibleDefaults
 };
 
 // ../../apps/chat/lib/config-schema.ts
@@ -18850,14 +18963,26 @@ function createAiSchema(g) {
       code: exports_external.object({
         edits: gatewayModelId()
       }),
-      image: exports_external.object({
-        enabled: exports_external.boolean(),
-        default: gatewayImageModelId()
-      }),
-      video: exports_external.object({
-        enabled: exports_external.boolean(),
-        default: gatewayVideoModelId()
-      }),
+      image: exports_external.discriminatedUnion("enabled", [
+        exports_external.object({
+          enabled: exports_external.literal(true),
+          default: gatewayImageModelId()
+        }),
+        exports_external.object({
+          enabled: exports_external.literal(false),
+          default: gatewayImageModelId().optional()
+        })
+      ]),
+      video: exports_external.discriminatedUnion("enabled", [
+        exports_external.object({
+          enabled: exports_external.literal(true),
+          default: gatewayVideoModelId()
+        }),
+        exports_external.object({
+          enabled: exports_external.literal(false),
+          default: gatewayVideoModelId().optional()
+        })
+      ]),
       deepResearch: deepResearchToolConfigSchema.extend({
         enabled: exports_external.boolean(),
         defaultModel: gatewayModelId(),
@@ -18879,72 +19004,7 @@ var aiConfigSchema = exports_external.discriminatedUnion("gateway", [
   gatewaySchemaMap["openai-compatible"]
 ]).default({
   gateway: DEFAULT_GATEWAY,
-  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"
-    },
-    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
-    }
-  }
+  ...GATEWAY_MODEL_DEFAULTS[DEFAULT_GATEWAY]
 });
 var pricingConfigSchema = exports_external.object({
   currency: exports_external.string().optional(),
@@ -19074,8 +19134,8 @@ function extractDescriptions(schema, prefix = "", result = new Map) {
   if (unwrapped instanceof exports_external.ZodObject) {
     const shape = unwrapped._zod.def.shape;
     for (const [key, propSchema] of Object.entries(shape)) {
-      const path = prefix ? `${prefix}.${key}` : key;
-      extractDescriptions(propSchema, path, result);
+      const path2 = prefix ? `${prefix}.${key}` : key;
+      extractDescriptions(propSchema, path2, result);
     }
   }
   return result;
@@ -19117,11 +19177,11 @@ ${spaces}}`;
 function generateConfig(obj, indent, pathPrefix, descs) {
   const spaces = "  ".repeat(indent);
   return Object.entries(obj).map(([key, value]) => {
-    const path = pathPrefix ? `${pathPrefix}.${key}` : key;
-    const desc = descs.get(path);
+    const path2 = pathPrefix ? `${pathPrefix}.${key}` : key;
+    const desc = descs.get(path2);
     const comment = desc ? ` // ${desc}` : "";
     if (typeof value === "object" && value !== null && !Array.isArray(value)) {
-      const nested = generateConfig(value, indent + 1, path, descs);
+      const nested = generateConfig(value, indent + 1, path2, descs);
       return `${spaces}${formatKey(key)}: {
 ${nested}
 ${spaces}},`;
@@ -19131,7 +19191,6 @@ ${spaces}},`;
 `);
 }
 function buildConfigTs(input) {
-  const modelDefaults = GATEWAY_MODEL_DEFAULTS[input.gateway];
   const fullConfig = {
     appPrefix: input.appPrefix,
     appName: input.appName,
@@ -19160,7 +19219,7 @@ function buildConfigTs(input) {
       terms: { title: "Terms of Service" }
     },
     authentication: input.auth,
-    models: { gateway: input.gateway, ...modelDefaults },
+    ai: { gateway: input.gateway },
     anonymous: {
       credits: 10,
       availableTools: [],
@@ -19177,15 +19236,9 @@ function buildConfigTs(input) {
         "image/jpeg": [".jpg", ".jpeg"],
         "application/pdf": [".pdf"]
       }
-    },
-    deepResearch: {
-      allowClarification: true,
-      maxResearcherIterations: 1,
-      maxConcurrentResearchUnits: 2,
-      maxSearchQueries: 2
     }
   };
-  return `import type { ConfigInput } from "@/lib/config-schema";
+  return `import { defineConfig } from "@/lib/config-schema";
 
 /**
  * ChatJS Configuration
@@ -19193,9 +19246,9 @@ function buildConfigTs(input) {
  * Edit this file to customize your app.
  * @see https://chatjs.dev/docs/reference/config
  */
-const config: ConfigInput = {
+const config = defineConfig({
 ${generateConfig(fullConfig, 1, "", descriptions)}
-};
+});
 
 export default config;
 `;
@@ -19514,10 +19567,10 @@ import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
 // src/utils/run-command.ts
-import { spawn } from "node:child_process";
+import { spawn as spawn2 } from "node:child_process";
 async function runCommand(command, args, cwd) {
   await new Promise((resolvePromise, rejectPromise) => {
-    const child = spawn(command, args, { cwd, stdio: "pipe" });
+    const child = spawn2(command, args, { cwd, stdio: "pipe" });
     const stderr = [];
     child.stderr?.on("data", (data) => {
       stderr.push(String(data));
@@ -19552,20 +19605,6 @@ async function scaffoldFromGit(url2, destination) {
   await rm(join(destination, ".git"), { recursive: true, force: true });
 }
 
-// src/utils/get-package-manager.ts
-function inferPackageManager() {
-  const ua = process.env.npm_config_user_agent ?? "";
-  if (ua.startsWith("pnpm/"))
-    return "pnpm";
-  if (ua.startsWith("yarn/"))
-    return "yarn";
-  if (ua.startsWith("npm/"))
-    return "npm";
-  if (ua.startsWith("bun/"))
-    return "bun";
-  return "bun";
-}
-
 // ../../node_modules/ora/index.js
 import process10 from "node:process";
 
@@ -21056,4 +21095,5 @@ process.on("SIGTERM", () => process.exit(0));
 var program2 = new Command().name("chat-js").description("ChatJS CLI").version(package_default.version, "-v, --version", "display the version number");
 program2.addCommand(create, { isDefault: true });
 program2.addCommand(add);
+program2.addCommand(config2);
 program2.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@chat-js/cli",
-	"version": "0.2.1",
+	"version": "0.3.0",
 	"description": "CLI for creating and extending ChatJS apps",
 	"license": "Apache-2.0",
 	"repository": {

package/templates/chat-app/CHANGELOG.md

@@ -0,0 +1,19 @@
+# @chatjs/chat
+
+## 0.2.0
+
+### Minor Changes
+
+- [#94](https://github.com/FranciscoMoretti/chat-js/pull/94) [`2a8a7cc`](https://github.com/FranciscoMoretti/chat-js/commit/2a8a7cc2b0649bd73e41999dbf0528a21e8065be) Thanks [@FranciscoMoretti](https://github.com/FranciscoMoretti)! - ## Config defaults & `defineConfig` helper
+
+  ### New features
+
+  - **`defineConfig()` helper** — new type-safe wrapper for `chat.config.ts`. The gateway type is inferred from `ai.gateway`, so autocomplete and type errors are scoped to the model IDs available in the chosen gateway. Replace `satisfies ConfigInput` with `defineConfig({...})`.
+  - **Gateway-specific defaults** — all AI config fields (models, tools, workflows) are now optional. Omitted fields are automatically filled from per-gateway defaults at runtime via `applyDefaults()`. Only `ai.gateway` is required.
+  - **`chatjs config` CLI command** — new command that prints the fully-resolved configuration for the current project, applying all defaults. Useful for debugging and verifying your setup.
+  - **Separate defaults per gateway** — `vercel`, `openrouter`, `openai`, and `openai-compatible` each have their own typed defaults (`ModelDefaultsFor<G>`), ensuring model IDs are validated against the correct gateway's model registry.
+  - **Stricter image/video tool schemas** — `tools.image` and `tools.video` now use a discriminated union: `enabled: true` requires a `default` model, while `enabled: false` makes it optional.
+
+  ### Breaking changes
+
+  None — existing configs using `satisfies ConfigInput` continue to work. Migrating to `defineConfig()` is recommended for better DX but not required.

package/templates/chat-app/app/(chat)/actions.ts

@@ -6,13 +6,13 @@ import type { ChatMessage } from "@/lib/ai/types";
 import { config } from "@/lib/config";
 
 export async function generateTitleFromUserMessage({
-	message,
+  message,
 }: {
-	message: ChatMessage;
+  message: ChatMessage;
 }) {
-	const { text: title } = await generateText({
-		model: await getLanguageModel(config.ai.workflows.title),
-		system: `Generate a concise title for a chat conversation based on the user's first message.
+  const { text: title } = await generateText({
+    model: await getLanguageModel(config.ai.workflows.title),
+    system: `Generate a concise title for a chat conversation based on the user's first message.
 
 Rules (strictly follow all):
 - Maximum 40 characters — hard limit, never exceed this
@@ -21,9 +21,9 @@ Rules (strictly follow all):
 - No filler words like "How to" or "Question about"
 - Use title case
 - Return ONLY the title, nothing else`,
-		prompt: JSON.stringify(message),
-		experimental_telemetry: { isEnabled: true },
-	});
+    prompt: JSON.stringify(message),
+    experimental_telemetry: { isEnabled: true },
+  });
 
-	return title;
+  return title;
 }

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: "google/gemini-2.5-flash-lite",
-      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: "google/gemini-2.5-flash-lite",
       },
       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;