create-volt 0.48.3 → 0.50.0

package/CHANGELOG.md

@@ -4,6 +4,23 @@ All notable changes to `create-volt` are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/), and this project adheres to
 [Semantic Versioning](https://semver.org/).
 
+## [0.50.0] - 2026-06-30
+
+### Added
+- **Config editor AI falls back to the hosted gateway.** With no local provider
+  key, `/setup/ai` routes through the voltjs.com gateway via `VOLT_AI_TOKEN`
+  (free-capped, then pay-as-you-go on the host's key); a local key still wins
+  (BYO). Clear error when neither is set. The gateway now honors the client's
+  stream preference, so the editor gets a normal JSON response.
+
+## [0.49.0] - 2026-06-29
+
+### Added
+- **AI in the config editor.** The embedded RTEPro editor's AI button now works:
+  a new `/setup/ai` proxy injects the `.env` provider key server-side
+  (Anthropic / OpenAI / Gemini, BYO) and RTEPro is wired to it via aiProxy. The
+  key never reaches the browser. (Set ANTHROPIC_API_KEY etc. in the app's .env.)
+
 ## [0.48.3] - 2026-06-29
 
 ### Fixed
@@ -649,6 +666,8 @@ All notable changes to `create-volt` are documented here. The format follows
   watching and full-page hot reload. Supports `--skip-install` and `--force`,
   and auto-detects npm / pnpm / yarn / bun for the install step.
 
+[0.50.0]: https://github.com/MIR-2025/volt/releases/tag/v0.50.0
+[0.49.0]: https://github.com/MIR-2025/volt/releases/tag/v0.49.0
 [0.48.3]: https://github.com/MIR-2025/volt/releases/tag/v0.48.3
 [0.48.2]: https://github.com/MIR-2025/volt/releases/tag/v0.48.2
 [0.48.1]: https://github.com/MIR-2025/volt/releases/tag/v0.48.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-volt",
-  "version": "0.48.3",
+  "version": "0.50.0",
   "description": "Scaffold a new Volt app — no-build, signals-based UI with Socket.io hot reload.",
   "type": "module",
   "bin": {

package/templates/blog/server.js

@@ -344,6 +344,55 @@ function startSetup() {
       }
       return;
     }
+    // --- AI proxy for the in-config editor (RTEPro). Uses a local provider key
+    // (BYO) when set; otherwise falls back to the voltjs.com gateway via
+    // VOLT_AI_TOKEN (free-capped, then pay-as-you-go on the host's key). The
+    // key/token never reaches the browser. ---
+    if (req.method === "POST" && p === "/setup/ai") {
+      let cbody = "";
+      req.on("data", (c) => (cbody += c));
+      req.on("end", async () => {
+        res.setHeader("Content-Type", "application/json");
+        try {
+          const env = readEnvFile();
+          const body = JSON.parse(cbody || "{}");
+          const provider = body._provider || env.AI_PROVIDER || "anthropic";
+          delete body._provider;
+          const localKey = { anthropic: env.ANTHROPIC_API_KEY, openai: env.OPENAI_API_KEY, gemini: env.GEMINI_API_KEY }[provider];
+          let url, headers, payload = body;
+          if (localKey) {
+            if (provider === "anthropic") {
+              url = "https://api.anthropic.com/v1/messages";
+              headers = { "x-api-key": localKey, "anthropic-version": "2023-06-01", "content-type": "application/json" };
+            } else if (provider === "openai") {
+              url = "https://api.openai.com/v1/chat/completions";
+              headers = { authorization: "Bearer " + localKey, "content-type": "application/json" };
+            } else if (provider === "gemini") {
+              const model = body.model || "gemini-2.0-flash";
+              delete body.model;
+              url = `https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent?key=${localKey}`;
+              headers = { "content-type": "application/json" };
+            } else throw new Error("unknown AI provider: " + provider);
+          } else if (env.VOLT_AI_TOKEN) {
+            // no local key → host gateway (free-capped, then pay-as-you-go)
+            url = env.VOLT_AI_GATEWAY || "https://voltjs.com/api/ai";
+            headers = { authorization: "Bearer " + env.VOLT_AI_TOKEN, "content-type": "application/json" };
+            payload = { messages: body.messages, system: body.system, max_tokens: body.max_tokens, model: body.model };
+          } else {
+            throw new Error("No AI key in .env and no VOLT_AI_TOKEN — add a provider key, or a gateway token to use the hosted tier.");
+          }
+          const r = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
+          const text = await r.text();
+          res.statusCode = r.status;
+          res.setHeader("Content-Type", r.headers.get("content-type") || "application/json");
+          res.end(text);
+        } catch (e) {
+          res.statusCode = 400;
+          res.end(JSON.stringify({ error: e.message }));
+        }
+      });
+      return;
+    }
     // --- AI credits: in-config purchase flow. Proxies the hosted gateway with
     // the app's VOLT_AI_TOKEN — the buy flow lives here in the (shell-gated)
     // config only, never in the running app. ---

package/templates/blog/setup/setup.js

@@ -317,7 +317,7 @@ function parseDoc(raw) {
   return { title, body: fm ? raw.slice(fm[0].length) : raw, isHtml: /^format:\s*html\s*$/m.test(front) };
 }
 function mountEditor(doc) {
-  ed = window.RTEPro.init("#mg-editor", { height: "60vh", placeholder: "Write…" });
+  ed = window.RTEPro.init("#mg-editor", { height: "60vh", placeholder: "Write…", aiProxy: "/setup/ai", aiProvider: state().aiProvider || "anthropic" });
   if (doc && doc.isHtml) ed.setHTML(doc.body || "");
   else ed.setMarkdown((doc && doc.body) || "");
 }

package/templates/default/server.js

@@ -344,6 +344,55 @@ function startSetup() {
       }
       return;
     }
+    // --- AI proxy for the in-config editor (RTEPro). Uses a local provider key
+    // (BYO) when set; otherwise falls back to the voltjs.com gateway via
+    // VOLT_AI_TOKEN (free-capped, then pay-as-you-go on the host's key). The
+    // key/token never reaches the browser. ---
+    if (req.method === "POST" && p === "/setup/ai") {
+      let cbody = "";
+      req.on("data", (c) => (cbody += c));
+      req.on("end", async () => {
+        res.setHeader("Content-Type", "application/json");
+        try {
+          const env = readEnvFile();
+          const body = JSON.parse(cbody || "{}");
+          const provider = body._provider || env.AI_PROVIDER || "anthropic";
+          delete body._provider;
+          const localKey = { anthropic: env.ANTHROPIC_API_KEY, openai: env.OPENAI_API_KEY, gemini: env.GEMINI_API_KEY }[provider];
+          let url, headers, payload = body;
+          if (localKey) {
+            if (provider === "anthropic") {
+              url = "https://api.anthropic.com/v1/messages";
+              headers = { "x-api-key": localKey, "anthropic-version": "2023-06-01", "content-type": "application/json" };
+            } else if (provider === "openai") {
+              url = "https://api.openai.com/v1/chat/completions";
+              headers = { authorization: "Bearer " + localKey, "content-type": "application/json" };
+            } else if (provider === "gemini") {
+              const model = body.model || "gemini-2.0-flash";
+              delete body.model;
+              url = `https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent?key=${localKey}`;
+              headers = { "content-type": "application/json" };
+            } else throw new Error("unknown AI provider: " + provider);
+          } else if (env.VOLT_AI_TOKEN) {
+            // no local key → host gateway (free-capped, then pay-as-you-go)
+            url = env.VOLT_AI_GATEWAY || "https://voltjs.com/api/ai";
+            headers = { authorization: "Bearer " + env.VOLT_AI_TOKEN, "content-type": "application/json" };
+            payload = { messages: body.messages, system: body.system, max_tokens: body.max_tokens, model: body.model };
+          } else {
+            throw new Error("No AI key in .env and no VOLT_AI_TOKEN — add a provider key, or a gateway token to use the hosted tier.");
+          }
+          const r = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
+          const text = await r.text();
+          res.statusCode = r.status;
+          res.setHeader("Content-Type", r.headers.get("content-type") || "application/json");
+          res.end(text);
+        } catch (e) {
+          res.statusCode = 400;
+          res.end(JSON.stringify({ error: e.message }));
+        }
+      });
+      return;
+    }
     // --- AI credits: in-config purchase flow. Proxies the hosted gateway with
     // the app's VOLT_AI_TOKEN — the buy flow lives here in the (shell-gated)
     // config only, never in the running app. ---

package/templates/default/setup/setup.js

@@ -317,7 +317,7 @@ function parseDoc(raw) {
   return { title, body: fm ? raw.slice(fm[0].length) : raw, isHtml: /^format:\s*html\s*$/m.test(front) };
 }
 function mountEditor(doc) {
-  ed = window.RTEPro.init("#mg-editor", { height: "60vh", placeholder: "Write…" });
+  ed = window.RTEPro.init("#mg-editor", { height: "60vh", placeholder: "Write…", aiProxy: "/setup/ai", aiProvider: state().aiProvider || "anthropic" });
   if (doc && doc.isHtml) ed.setHTML(doc.body || "");
   else ed.setMarkdown((doc && doc.body) || "");
 }

package/templates/docs/server.js

@@ -344,6 +344,55 @@ function startSetup() {
       }
       return;
     }
+    // --- AI proxy for the in-config editor (RTEPro). Uses a local provider key
+    // (BYO) when set; otherwise falls back to the voltjs.com gateway via
+    // VOLT_AI_TOKEN (free-capped, then pay-as-you-go on the host's key). The
+    // key/token never reaches the browser. ---
+    if (req.method === "POST" && p === "/setup/ai") {
+      let cbody = "";
+      req.on("data", (c) => (cbody += c));
+      req.on("end", async () => {
+        res.setHeader("Content-Type", "application/json");
+        try {
+          const env = readEnvFile();
+          const body = JSON.parse(cbody || "{}");
+          const provider = body._provider || env.AI_PROVIDER || "anthropic";
+          delete body._provider;
+          const localKey = { anthropic: env.ANTHROPIC_API_KEY, openai: env.OPENAI_API_KEY, gemini: env.GEMINI_API_KEY }[provider];
+          let url, headers, payload = body;
+          if (localKey) {
+            if (provider === "anthropic") {
+              url = "https://api.anthropic.com/v1/messages";
+              headers = { "x-api-key": localKey, "anthropic-version": "2023-06-01", "content-type": "application/json" };
+            } else if (provider === "openai") {
+              url = "https://api.openai.com/v1/chat/completions";
+              headers = { authorization: "Bearer " + localKey, "content-type": "application/json" };
+            } else if (provider === "gemini") {
+              const model = body.model || "gemini-2.0-flash";
+              delete body.model;
+              url = `https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent?key=${localKey}`;
+              headers = { "content-type": "application/json" };
+            } else throw new Error("unknown AI provider: " + provider);
+          } else if (env.VOLT_AI_TOKEN) {
+            // no local key → host gateway (free-capped, then pay-as-you-go)
+            url = env.VOLT_AI_GATEWAY || "https://voltjs.com/api/ai";
+            headers = { authorization: "Bearer " + env.VOLT_AI_TOKEN, "content-type": "application/json" };
+            payload = { messages: body.messages, system: body.system, max_tokens: body.max_tokens, model: body.model };
+          } else {
+            throw new Error("No AI key in .env and no VOLT_AI_TOKEN — add a provider key, or a gateway token to use the hosted tier.");
+          }
+          const r = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
+          const text = await r.text();
+          res.statusCode = r.status;
+          res.setHeader("Content-Type", r.headers.get("content-type") || "application/json");
+          res.end(text);
+        } catch (e) {
+          res.statusCode = 400;
+          res.end(JSON.stringify({ error: e.message }));
+        }
+      });
+      return;
+    }
     // --- AI credits: in-config purchase flow. Proxies the hosted gateway with
     // the app's VOLT_AI_TOKEN — the buy flow lives here in the (shell-gated)
     // config only, never in the running app. ---

package/templates/docs/setup/setup.js

@@ -317,7 +317,7 @@ function parseDoc(raw) {
   return { title, body: fm ? raw.slice(fm[0].length) : raw, isHtml: /^format:\s*html\s*$/m.test(front) };
 }
 function mountEditor(doc) {
-  ed = window.RTEPro.init("#mg-editor", { height: "60vh", placeholder: "Write…" });
+  ed = window.RTEPro.init("#mg-editor", { height: "60vh", placeholder: "Write…", aiProxy: "/setup/ai", aiProvider: state().aiProvider || "anthropic" });
   if (doc && doc.isHtml) ed.setHTML(doc.body || "");
   else ed.setMarkdown((doc && doc.body) || "");
 }

package/templates/starter/server.js

@@ -370,6 +370,55 @@ function startSetup() {
       }
       return;
     }
+    // --- AI proxy for the in-config editor (RTEPro). Uses a local provider key
+    // (BYO) when set; otherwise falls back to the voltjs.com gateway via
+    // VOLT_AI_TOKEN (free-capped, then pay-as-you-go on the host's key). The
+    // key/token never reaches the browser. ---
+    if (req.method === "POST" && p === "/setup/ai") {
+      let cbody = "";
+      req.on("data", (c) => (cbody += c));
+      req.on("end", async () => {
+        res.setHeader("Content-Type", "application/json");
+        try {
+          const env = readEnvFile();
+          const body = JSON.parse(cbody || "{}");
+          const provider = body._provider || env.AI_PROVIDER || "anthropic";
+          delete body._provider;
+          const localKey = { anthropic: env.ANTHROPIC_API_KEY, openai: env.OPENAI_API_KEY, gemini: env.GEMINI_API_KEY }[provider];
+          let url, headers, payload = body;
+          if (localKey) {
+            if (provider === "anthropic") {
+              url = "https://api.anthropic.com/v1/messages";
+              headers = { "x-api-key": localKey, "anthropic-version": "2023-06-01", "content-type": "application/json" };
+            } else if (provider === "openai") {
+              url = "https://api.openai.com/v1/chat/completions";
+              headers = { authorization: "Bearer " + localKey, "content-type": "application/json" };
+            } else if (provider === "gemini") {
+              const model = body.model || "gemini-2.0-flash";
+              delete body.model;
+              url = `https://generativelanguage.googleapis.com/v1beta/models/${model}:generateContent?key=${localKey}`;
+              headers = { "content-type": "application/json" };
+            } else throw new Error("unknown AI provider: " + provider);
+          } else if (env.VOLT_AI_TOKEN) {
+            // no local key → host gateway (free-capped, then pay-as-you-go)
+            url = env.VOLT_AI_GATEWAY || "https://voltjs.com/api/ai";
+            headers = { authorization: "Bearer " + env.VOLT_AI_TOKEN, "content-type": "application/json" };
+            payload = { messages: body.messages, system: body.system, max_tokens: body.max_tokens, model: body.model };
+          } else {
+            throw new Error("No AI key in .env and no VOLT_AI_TOKEN — add a provider key, or a gateway token to use the hosted tier.");
+          }
+          const r = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
+          const text = await r.text();
+          res.statusCode = r.status;
+          res.setHeader("Content-Type", r.headers.get("content-type") || "application/json");
+          res.end(text);
+        } catch (e) {
+          res.statusCode = 400;
+          res.end(JSON.stringify({ error: e.message }));
+        }
+      });
+      return;
+    }
     // --- AI credits: in-config purchase flow. Proxies the hosted gateway with
     // the app's VOLT_AI_TOKEN — the buy flow lives here in the (shell-gated)
     // config only, never in the running app. ---

package/templates/starter/setup/setup.js

@@ -317,7 +317,7 @@ function parseDoc(raw) {
   return { title, body: fm ? raw.slice(fm[0].length) : raw, isHtml: /^format:\s*html\s*$/m.test(front) };
 }
 function mountEditor(doc) {
-  ed = window.RTEPro.init("#mg-editor", { height: "60vh", placeholder: "Write…" });
+  ed = window.RTEPro.init("#mg-editor", { height: "60vh", placeholder: "Write…", aiProxy: "/setup/ai", aiProvider: state().aiProvider || "anthropic" });
   if (doc && doc.isHtml) ed.setHTML(doc.body || "");
   else ed.setMarkdown((doc && doc.body) || "");
 }