@heyo-sh/create-heyo-docs 0.4.0 → 1.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heyo-sh/create-heyo-docs",
-  "version": "0.4.0",
+  "version": "1.0.0",
   "description": "Create a standalone Heyo Docs documentation project.",
   "homepage": "https://heyo.sh",
   "repository": {

package/templates/astro/content/configuration.mdx

@@ -66,16 +66,17 @@ sidebar entry should point to a page outside the local documentation.
 
 ## AI chat
 
-Add `ai.chat` to enable a documentation-aware chat. `openai`, `claude`, and `grok`
-use the OpenAI, Anthropic, and xAI adapters respectively. Keep the key in a
-server environment variable; Heyo Docs sends it only from the chat endpoint.
+Add `ai.chat` to enable a documentation-aware chat through [Pi](https://github.com/badlogic/pi-mono).
+Use any provider identifier bundled with the installed Pi version, such as
+`openai`, `anthropic`, `google`, `openrouter`, or `xai`. Authentication stays
+server-only and is selected explicitly for the provider.
 
 <CodeBlock language="ts" title="heyo-docs.config.ts">
   {`ai: {
   chat: {
     provider: "openai",
-    key: process.env.OPENAI_API_KEY!,
     model: "gpt-5-mini",
+    auth: { type: "api-key", token: process.env.OPENAI_API_KEY! },
     variant: "right", // "center" shows the compact prompt first
     icon: "chat",
     text: "AI Chat",
@@ -85,8 +86,14 @@ server environment variable; Heyo Docs sends it only from the chat endpoint.
 },`}
 </CodeBlock>
 
-`provider`, `key`, and `model` are required. The model must be an actual model
-identifier, not the provider name. `variant` defaults to `right`. `name`
+`provider`, `model`, and `auth` are required. API-key providers use
+`{ type: "api-key", token }`. GitHub Copilot and OpenAI Codex use
+`{ type: "oauth", getAccessToken }`; the resolver runs before each Pi request,
+so it can refresh a short-lived token. Amazon Bedrock uses either
+`{ type: "aws", region?, profile? }` and the AWS credential chain, or
+`{ type: "bedrock-bearer", token, region? }`. The model must be an actual model
+identifier, not the provider name. Amazon Bedrock requires a Node.js chat
+endpoint. `variant` defaults to `right`. `name`
 defaults to `AI`; it is used for the drawer title and the assistant's message
 label. `placeholder` defaults to
 `Ask AI about the docs` and is shared by the compact prompt and drawer input.

package/templates/next/content/configuration.mdx

@@ -66,16 +66,17 @@ sidebar entry should point to a page outside the local documentation.
 
 ## AI chat
 
-Add `ai.chat` to enable a documentation-aware chat. `openai`, `claude`, and `grok`
-use the OpenAI, Anthropic, and xAI adapters respectively. Keep the key in a
-server environment variable; Heyo Docs sends it only from the chat endpoint.
+Add `ai.chat` to enable a documentation-aware chat through [Pi](https://github.com/badlogic/pi-mono).
+Use any provider identifier bundled with the installed Pi version, such as
+`openai`, `anthropic`, `google`, `openrouter`, or `xai`. Authentication stays
+server-only and is selected explicitly for the provider.
 
 <CodeBlock language="ts" title="heyo-docs.config.ts">
   {`ai: {
   chat: {
     provider: "openai",
-    key: process.env.OPENAI_API_KEY!,
     model: "gpt-5-mini",
+    auth: { type: "api-key", token: process.env.OPENAI_API_KEY! },
     variant: "right", // "center" shows the compact prompt first
     icon: "chat",
     text: "AI Chat",
@@ -85,8 +86,14 @@ server environment variable; Heyo Docs sends it only from the chat endpoint.
 },`}
 </CodeBlock>
 
-`provider`, `key`, and `model` are required. The model must be an actual model
-identifier, not the provider name. `variant` defaults to `right`. `name`
+`provider`, `model`, and `auth` are required. API-key providers use
+`{ type: "api-key", token }`. GitHub Copilot and OpenAI Codex use
+`{ type: "oauth", getAccessToken }`; the resolver runs before each Pi request,
+so it can refresh a short-lived token. Amazon Bedrock uses either
+`{ type: "aws", region?, profile? }` and the AWS credential chain, or
+`{ type: "bedrock-bearer", token, region? }`. The model must be an actual model
+identifier, not the provider name. Amazon Bedrock requires a Node.js chat
+endpoint. `variant` defaults to `right`. `name`
 defaults to `AI`; it is used for the drawer title and the assistant's message
 label. `placeholder` defaults to
 `Ask AI about the docs` and is shared by the compact prompt and drawer input.

package/templates/react-router/app/routes/ai-chat.ts

@@ -1,4 +1,3 @@
-import { createAiChatResponse } from "@heyo-sh/heyo-docs/ai";
 import type { ActionFunctionArgs } from "react-router";
 
 import config from "../../heyo-docs.config";
@@ -12,6 +11,7 @@ export async function action({ request }: ActionFunctionArgs) {
       status: 405,
     });
 
+  const { createAiChatResponse } = await import("@heyo-sh/heyo-docs/ai");
   return createAiChatResponse(request, {
     ai: config.ai,
     markdownPages,

package/templates/react-router/content/configuration.mdx

@@ -66,16 +66,17 @@ sidebar entry should point to a page outside the local documentation.
 
 ## AI chat
 
-Add `ai.chat` to enable a documentation-aware chat. `openai`, `claude`, and `grok`
-use the OpenAI, Anthropic, and xAI adapters respectively. Keep the key in a
-server environment variable; Heyo Docs sends it only from the chat endpoint.
+Add `ai.chat` to enable a documentation-aware chat through [Pi](https://github.com/badlogic/pi-mono).
+Use any provider identifier bundled with the installed Pi version, such as
+`openai`, `anthropic`, `google`, `openrouter`, or `xai`. Authentication stays
+server-only and is selected explicitly for the provider.
 
 <CodeBlock language="ts" title="heyo-docs.config.ts">
   {`ai: {
   chat: {
     provider: "openai",
-    key: process.env.OPENAI_API_KEY!,
     model: "gpt-5-mini",
+    auth: { type: "api-key", token: process.env.OPENAI_API_KEY! },
     variant: "right", // "center" shows the compact prompt first
     icon: "chat",
     text: "AI Chat",
@@ -85,8 +86,14 @@ server environment variable; Heyo Docs sends it only from the chat endpoint.
 },`}
 </CodeBlock>
 
-`provider`, `key`, and `model` are required. The model must be an actual model
-identifier, not the provider name. `variant` defaults to `right`. `name`
+`provider`, `model`, and `auth` are required. API-key providers use
+`{ type: "api-key", token }`. GitHub Copilot and OpenAI Codex use
+`{ type: "oauth", getAccessToken }`; the resolver runs before each Pi request,
+so it can refresh a short-lived token. Amazon Bedrock uses either
+`{ type: "aws", region?, profile? }` and the AWS credential chain, or
+`{ type: "bedrock-bearer", token, region? }`. The model must be an actual model
+identifier, not the provider name. Amazon Bedrock requires a Node.js chat
+endpoint. `variant` defaults to `right`. `name`
 defaults to `AI`; it is used for the drawer title and the assistant's message
 label. `placeholder` defaults to
 `Ask AI about the docs` and is shared by the compact prompt and drawer input.