@chat-js/cli 0.2.0 → 0.3.0

package/dist/index.js

@@ -3914,17 +3914,17 @@ var {
 // package.json
 var package_default = {
   name: "@chat-js/cli",
-  version: "0.2.0",
+  version: "0.3.0",
   description: "CLI for creating and extending ChatJS apps",
   license: "Apache-2.0",
   repository: {
     type: "git",
-    url: "https://github.com/franciscomoretti/chat.js.git",
+    url: "https://github.com/franciscomoretti/chat-js.git",
     directory: "packages/cli"
   },
-  homepage: "https://github.com/franciscomoretti/chat.js/tree/main/packages/cli",
+  homepage: "https://github.com/franciscomoretti/chat-js/tree/main/packages/cli",
   bugs: {
-    url: "https://github.com/franciscomoretti/chat.js/issues"
+    url: "https://github.com/franciscomoretti/chat-js/issues"
   },
   keywords: [
     "chatjs",
@@ -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,50 +1,50 @@
 {
-  "name": "@chat-js/cli",
-  "version": "0.2.0",
-  "description": "CLI for creating and extending ChatJS apps",
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/franciscomoretti/chat.js.git",
-    "directory": "packages/cli"
-  },
-  "homepage": "https://github.com/franciscomoretti/chat.js/tree/main/packages/cli",
-  "bugs": {
-    "url": "https://github.com/franciscomoretti/chat.js/issues"
-  },
-  "keywords": [
-    "chatjs",
-    "ai",
-    "cli",
-    "scaffold",
-    "nextjs"
-  ],
-  "dependencies": {
-    "@clack/prompts": "^1.0.1",
-    "commander": "^14.0.0",
-    "kleur": "^4.1.5",
-    "ora": "^8.2.0",
-    "zod": "^4.3.6"
-  },
-  "bin": {
-    "chat-js": "./dist/index.js"
-  },
-  "files": [
-    "dist",
-    "templates"
-  ],
-  "private": false,
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "start": "bun src/index.ts",
-    "build": "bun build ./src/index.ts --target=node --format=esm --outfile ./dist/index.js",
-    "template:sync": "bun ../../scripts/sync-template.ts",
-    "prepublishOnly": "bun run template:sync && bun run build && node ./dist/index.js --help >/dev/null"
-  },
-  "type": "module",
-  "devDependencies": {
-    "@types/bun": "latest"
-  }
+	"name": "@chat-js/cli",
+	"version": "0.3.0",
+	"description": "CLI for creating and extending ChatJS apps",
+	"license": "Apache-2.0",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/franciscomoretti/chat-js.git",
+		"directory": "packages/cli"
+	},
+	"homepage": "https://github.com/franciscomoretti/chat-js/tree/main/packages/cli",
+	"bugs": {
+		"url": "https://github.com/franciscomoretti/chat-js/issues"
+	},
+	"keywords": [
+		"chatjs",
+		"ai",
+		"cli",
+		"scaffold",
+		"nextjs"
+	],
+	"dependencies": {
+		"@clack/prompts": "^1.0.1",
+		"commander": "^14.0.0",
+		"kleur": "^4.1.5",
+		"ora": "^8.2.0",
+		"zod": "^4.3.6"
+	},
+	"bin": {
+		"chat-js": "./dist/index.js"
+	},
+	"files": [
+		"dist",
+		"templates"
+	],
+	"private": false,
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"start": "bun src/index.ts",
+		"build": "bun build ./src/index.ts --target=node --format=esm --outfile ./dist/index.js",
+		"template:sync": "bun ../../scripts/sync-template.ts",
+		"prepublishOnly": "bun run template:sync && bun run build && node ./dist/index.js --help >/dev/null"
+	},
+	"type": "module",
+	"devDependencies": {
+		"@types/bun": "latest"
+	}
 }

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

@@ -12,11 +12,15 @@ export async function generateTitleFromUserMessage({
 }) {
   const { text: title } = await generateText({
     model: await getLanguageModel(config.ai.workflows.title),
-    system: `\n
-    - you will generate a short title based on the first message a user begins a conversation with
-    - ensure it is not more than 40 characters long
-    - the title should be a summary of the user's message
-    - do not use quotes or colons`,
+    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
+- 3-6 words is ideal
+- No quotes, colons, or punctuation at the end
+- 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 },
   });

package/templates/chat-app/app/globals.css

@@ -1,7 +1,7 @@
 @import "tailwindcss";
 @import "tw-animate-css";
 @plugin "@tailwindcss/typography";
-@source "../node_modules/streamdown/dist/index.js";
+@source "../node_modules/streamdown/dist/*.js";
 
 @custom-variant dark (&:is(.dark *));