@vercel/geistdocs 2.12.5 → 2.13.1-canary.87d00b3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli/index.js +1 -1
- package/dist/config.d.ts +18 -4
- package/dist/config.d.ts.map +1 -1
- package/dist/footer.js +1 -1
- package/dist/internal/chat/loading-skeleton.d.ts.map +1 -1
- package/dist/internal/chat/loading-skeleton.js +1 -3
- package/dist/internal/chat/prompt-input.js +1 -1
- package/dist/internal/chat/session.d.ts +2 -3
- package/dist/internal/chat/session.d.ts.map +1 -1
- package/dist/internal/chat/session.js +28 -4
- package/dist/internal/chat/shell.d.ts.map +1 -1
- package/dist/internal/chat/shell.js +8 -9
- package/dist/internal/eve-agent-session.d.ts +5 -7
- package/dist/internal/eve-agent-session.d.ts.map +1 -1
- package/dist/internal/eve-agent-session.js +5 -8
- package/dist/internal/eve-agent.d.ts +11 -3
- package/dist/internal/eve-agent.d.ts.map +1 -1
- package/dist/internal/eve-agent.js +19 -4
- package/dist/internal/languages.d.ts +22 -1
- package/dist/internal/languages.d.ts.map +1 -1
- package/dist/internal/languages.js +32 -0
- package/dist/internal/lazy-search.d.ts +13 -0
- package/dist/internal/lazy-search.d.ts.map +1 -0
- package/dist/internal/lazy-search.js +61 -0
- package/dist/internal/provider-client.d.ts +1 -1
- package/dist/internal/provider-client.d.ts.map +1 -1
- package/dist/internal/provider-client.js +2 -2
- package/dist/mdx.d.ts +1 -44
- package/dist/mdx.d.ts.map +1 -1
- package/dist/mdx.js +4 -4
- package/dist/navbar.d.ts +1 -1
- package/dist/navbar.d.ts.map +1 -1
- package/dist/navbar.js +3 -1
- package/dist/pages/changelog.d.ts +7 -4
- package/dist/pages/changelog.d.ts.map +1 -1
- package/dist/pages/changelog.js +6 -4
- package/dist/pages/docs.d.ts +4 -2
- package/dist/pages/docs.d.ts.map +1 -1
- package/dist/pages/docs.js +15 -3
- package/dist/providers/public/components/drawer.d.ts +2 -1
- package/dist/providers/public/components/drawer.d.ts.map +1 -1
- package/dist/providers/public/components/drawer.js +2 -2
- package/dist/providers/public/components/toasts.d.ts +4 -4
- package/dist/providers/public/components/toasts.d.ts.map +1 -1
- package/dist/providers/public/components/toasts.js +50 -14
- package/dist/proxy.d.ts +1 -1
- package/dist/proxy.d.ts.map +1 -1
- package/dist/proxy.js +12 -1
- package/dist/routes/agents.d.ts +1 -1
- package/dist/routes/agents.d.ts.map +1 -1
- package/dist/routes/agents.js +4 -3
- package/dist/routes/changelog.d.ts +19 -10
- package/dist/routes/changelog.d.ts.map +1 -1
- package/dist/routes/changelog.js +11 -11
- package/dist/routes/chat.d.ts.map +1 -1
- package/dist/routes/chat.js +21 -4
- package/dist/routes/llms.d.ts +10 -5
- package/dist/routes/llms.d.ts.map +1 -1
- package/dist/routes/llms.js +10 -5
- package/dist/routes/mcp.d.ts +1 -1
- package/dist/routes/mcp.d.ts.map +1 -1
- package/dist/routes/mcp.js +2 -1
- package/dist/routes/openapi.d.ts +1 -1
- package/dist/routes/openapi.d.ts.map +1 -1
- package/dist/routes/openapi.js +12 -5
- package/dist/routes/sitemap.d.ts +5 -5
- package/dist/routes/sitemap.d.ts.map +1 -1
- package/dist/routes/sitemap.js +4 -9
- package/dist/source.d.ts +6 -1
- package/dist/source.d.ts.map +1 -1
- package/dist/source.js +1 -0
- package/docs/agents.md +1 -1
- package/docs/llms.txt +12 -4
- package/docs/manifest.json +1 -1
- package/docs/pages/ask-ai.md +6 -2
- package/docs/pages/configuration.md +5 -1
- package/package.json +7 -7
- package/template/content/docs/ask-ai.mdx +6 -2
- package/template/content/docs/configuration.mdx +5 -1
- package/template/package.json +1 -1
package/docs/llms.txt
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Geistdocs Package Documentation
|
|
2
2
|
|
|
3
|
-
These docs are bundled with `@vercel/geistdocs` 2.
|
|
3
|
+
These docs are bundled with `@vercel/geistdocs` 2.13.1-canary.87d00b3.
|
|
4
4
|
They describe how to build package-backed Geistdocs sites and how to use the package APIs from generated project adapters.
|
|
5
5
|
|
|
6
6
|
## Documentation Index
|
|
@@ -1346,7 +1346,7 @@ export const ai = {
|
|
|
1346
1346
|
};
|
|
1347
1347
|
```
|
|
1348
1348
|
|
|
1349
|
-
Set `eveAgent.prewarm`
|
|
1349
|
+
Set `eveAgent.prewarm` when preparing a durable session while a reader types is appropriate for the site. Fresh-session creation requires eve 0.59 or newer. With eve 0.83 or newer, the same option also prepares existing conversations before follow-up messages, preserving the session and allowing Send to proceed without waiting.
|
|
1350
1350
|
|
|
1351
1351
|
The `ai` config also controls the chat panel and its route:
|
|
1352
1352
|
|
|
@@ -1372,6 +1372,10 @@ See [Ask AI](/docs/ask-ai) for the full eve agent mode behavior, including authe
|
|
|
1372
1372
|
|
|
1373
1373
|
Use [Versioned docs](/docs/versioned-docs) for versioned source setup and [Proxy and markdown routes](/docs/proxy) for route mappings.
|
|
1374
1374
|
|
|
1375
|
+
## Single-language sites
|
|
1376
|
+
|
|
1377
|
+
A site with one language can drop the `[lang]` route segment by setting `singleLanguage: true` in `defineConfig`. Routes then live directly under `app/`, the proxy skips locale rewrites, and route factories resolve every request to `defaultLanguage`. `translations` may only list `defaultLanguage`. Public URLs, `.md` routes, `llms.txt`, and `agents.md` keep their paths.
|
|
1378
|
+
|
|
1375
1379
|
## `source.config.ts`
|
|
1376
1380
|
|
|
1377
1381
|
Use the source-config-safe package export in `source.config.ts`. This file is evaluated by `fumadocs-mdx` during install and build, so it should avoid imports from runtime component entry points such as `@vercel/geistdocs/mdx`.
|
|
@@ -4271,7 +4275,11 @@ export const ai = {
|
|
|
4271
4275
|
};
|
|
4272
4276
|
```
|
|
4273
4277
|
|
|
4274
|
-
Set `prewarm: true` to
|
|
4278
|
+
Set `prewarm: true` to prepare a session when a reader starts typing each question. In a new conversation, the route creates an empty session and binds it to the browser with the session cookie. The first message waits for that request so it can reuse the session. Fresh-session prewarming requires eve 0.59 or newer.
|
|
4279
|
+
|
|
4280
|
+
With eve 0.83 or newer, typing a follow-up also prepares the existing session owner on the deployment accepting the request. An idle owner on another deployment can transfer before Send. This keeps the same session, history, stream position, and expiry, and runs no model call. The client prepares each idle turn once, including restored conversations. Send proceeds without waiting for existing-session preparation; acceptance does not mean a background transfer has finished.
|
|
4281
|
+
|
|
4282
|
+
Prewarming requires [`GEISTDOCS_CHAT_SECRET`](#keep-eve-sessions-across-turns-with-geistdocs_chat_secret). The route verifies the latest answer's session tag against the signed cookie before preparing an existing session. Preparation failures, older agents without support, and expired or mismatched cookies fall back to the normal send path. Leave prewarming disabled when typing a draft should not allocate a durable session before the reader sends a message.
|
|
4275
4283
|
|
|
4276
4284
|
The URL flows to `createChatRoute` through the config object you already pass in `app/api/chat/route.ts` — no route changes are required. Geistdocs speaks eve's session API directly: it starts or resumes a durable eve session, streams the agent's NDJSON events, and translates them into the same UI message stream the chat panel already renders. With `GEISTDOCS_CHAT_SECRET` set, Geistdocs continues one eve session across turns by binding it to the reader's browser with a signed, httpOnly cookie.
|
|
4277
4285
|
|
|
@@ -4677,7 +4685,7 @@ Ask AI accepts text questions only. It does not support file or image attachment
|
|
|
4677
4685
|
The chat interface adapts to different screen sizes:
|
|
4678
4686
|
|
|
4679
4687
|
- **Desktop**: Slides in from the right side as a sidebar panel. Select **Expand chat** in the panel header to fill the viewport, which gives long answers and code blocks more width without losing the conversation. Select **Collapse chat** or press `Escape` to return to the sidebar. Closing the chat also returns it to the sidebar, so the next open starts there.
|
|
4680
|
-
- **Mobile**: Opens as a
|
|
4688
|
+
- **Mobile**: Opens as a full-screen chat and waits for the reader to focus the prompt before opening the software keyboard.
|
|
4681
4689
|
|
|
4682
4690
|
## Configuration
|
|
4683
4691
|
|
package/docs/manifest.json
CHANGED
package/docs/pages/ask-ai.md
CHANGED
|
@@ -336,7 +336,11 @@ export const ai = {
|
|
|
336
336
|
};
|
|
337
337
|
```
|
|
338
338
|
|
|
339
|
-
Set `prewarm: true` to
|
|
339
|
+
Set `prewarm: true` to prepare a session when a reader starts typing each question. In a new conversation, the route creates an empty session and binds it to the browser with the session cookie. The first message waits for that request so it can reuse the session. Fresh-session prewarming requires eve 0.59 or newer.
|
|
340
|
+
|
|
341
|
+
With eve 0.83 or newer, typing a follow-up also prepares the existing session owner on the deployment accepting the request. An idle owner on another deployment can transfer before Send. This keeps the same session, history, stream position, and expiry, and runs no model call. The client prepares each idle turn once, including restored conversations. Send proceeds without waiting for existing-session preparation; acceptance does not mean a background transfer has finished.
|
|
342
|
+
|
|
343
|
+
Prewarming requires [`GEISTDOCS_CHAT_SECRET`](#keep-eve-sessions-across-turns-with-geistdocs_chat_secret). The route verifies the latest answer's session tag against the signed cookie before preparing an existing session. Preparation failures, older agents without support, and expired or mismatched cookies fall back to the normal send path. Leave prewarming disabled when typing a draft should not allocate a durable session before the reader sends a message.
|
|
340
344
|
|
|
341
345
|
The URL flows to `createChatRoute` through the config object you already pass in `app/api/chat/route.ts` — no route changes are required. Geistdocs speaks eve's session API directly: it starts or resumes a durable eve session, streams the agent's NDJSON events, and translates them into the same UI message stream the chat panel already renders. With `GEISTDOCS_CHAT_SECRET` set, Geistdocs continues one eve session across turns by binding it to the reader's browser with a signed, httpOnly cookie.
|
|
342
346
|
|
|
@@ -742,7 +746,7 @@ Ask AI accepts text questions only. It does not support file or image attachment
|
|
|
742
746
|
The chat interface adapts to different screen sizes:
|
|
743
747
|
|
|
744
748
|
- **Desktop**: Slides in from the right side as a sidebar panel. Select **Expand chat** in the panel header to fill the viewport, which gives long answers and code blocks more width without losing the conversation. Select **Collapse chat** or press `Escape` to return to the sidebar. Closing the chat also returns it to the sidebar, so the next open starts there.
|
|
745
|
-
- **Mobile**: Opens as a
|
|
749
|
+
- **Mobile**: Opens as a full-screen chat and waits for the reader to focus the prompt before opening the software keyboard.
|
|
746
750
|
|
|
747
751
|
## Configuration
|
|
748
752
|
|
|
@@ -207,7 +207,7 @@ export const ai = {
|
|
|
207
207
|
};
|
|
208
208
|
```
|
|
209
209
|
|
|
210
|
-
Set `eveAgent.prewarm`
|
|
210
|
+
Set `eveAgent.prewarm` when preparing a durable session while a reader types is appropriate for the site. Fresh-session creation requires eve 0.59 or newer. With eve 0.83 or newer, the same option also prepares existing conversations before follow-up messages, preserving the session and allowing Send to proceed without waiting.
|
|
211
211
|
|
|
212
212
|
The `ai` config also controls the chat panel and its route:
|
|
213
213
|
|
|
@@ -233,6 +233,10 @@ See [Ask AI](/docs/ask-ai) for the full eve agent mode behavior, including authe
|
|
|
233
233
|
|
|
234
234
|
Use [Versioned docs](/docs/versioned-docs) for versioned source setup and [Proxy and markdown routes](/docs/proxy) for route mappings.
|
|
235
235
|
|
|
236
|
+
## Single-language sites
|
|
237
|
+
|
|
238
|
+
A site with one language can drop the `[lang]` route segment by setting `singleLanguage: true` in `defineConfig`. Routes then live directly under `app/`, the proxy skips locale rewrites, and route factories resolve every request to `defaultLanguage`. `translations` may only list `defaultLanguage`. Public URLs, `.md` routes, `llms.txt`, and `agents.md` keep their paths.
|
|
239
|
+
|
|
236
240
|
## `source.config.ts`
|
|
237
241
|
|
|
238
242
|
Use the source-config-safe package export in `source.config.ts`. This file is evaluated by `fumadocs-mdx` during install and build, so it should avoid imports from runtime component entry points such as `@vercel/geistdocs/mdx`.
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@vercel/geistdocs",
|
|
3
3
|
"description": "Runtime and CLI for Geistdocs projects.",
|
|
4
|
-
"version": "2.
|
|
4
|
+
"version": "2.13.1-canary.87d00b3",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"repository": {
|
|
7
7
|
"type": "git",
|
|
@@ -299,6 +299,10 @@
|
|
|
299
299
|
"./theme.css": "./theme.css",
|
|
300
300
|
"./package.json": "./package.json"
|
|
301
301
|
},
|
|
302
|
+
"scripts": {
|
|
303
|
+
"build": "rm -rf dist docs template && node ./scripts/bundle-template.mjs && node ./scripts/bundle-docs.mjs && tsc -p tsconfig.runtime.json && tsup --config tsup.config.cli.ts",
|
|
304
|
+
"dev": "tsc -p tsconfig.runtime.json --watch --preserveWatchOutput"
|
|
305
|
+
},
|
|
302
306
|
"dependencies": {
|
|
303
307
|
"@ai-sdk/react": "^3.0.134",
|
|
304
308
|
"@clack/prompts": "^0.11.0",
|
|
@@ -333,7 +337,7 @@
|
|
|
333
337
|
"remark-mdx": "^3.1.1",
|
|
334
338
|
"remark-parse": "^11.0.0",
|
|
335
339
|
"remark-stringify": "^11.0.0",
|
|
336
|
-
"sonner": "^2.0.
|
|
340
|
+
"sonner": "^2.0.8",
|
|
337
341
|
"streamdown": "^2.1.0",
|
|
338
342
|
"tailwind-merge": "^3.4.0",
|
|
339
343
|
"ts-morph": "^27.0.2",
|
|
@@ -362,9 +366,5 @@
|
|
|
362
366
|
"react-dom": "^19.2.3",
|
|
363
367
|
"tsup": "^8.5.1",
|
|
364
368
|
"typescript": "^5.9.3"
|
|
365
|
-
},
|
|
366
|
-
"scripts": {
|
|
367
|
-
"build": "rm -rf dist docs template && node ./scripts/bundle-template.mjs && node ./scripts/bundle-docs.mjs && tsc -p tsconfig.runtime.json && tsup --config tsup.config.cli.ts",
|
|
368
|
-
"dev": "tsc -p tsconfig.runtime.json --watch --preserveWatchOutput"
|
|
369
369
|
}
|
|
370
|
-
}
|
|
370
|
+
}
|
|
@@ -334,7 +334,11 @@ export const ai = {
|
|
|
334
334
|
};
|
|
335
335
|
```
|
|
336
336
|
|
|
337
|
-
Set `prewarm: true` to
|
|
337
|
+
Set `prewarm: true` to prepare a session when a reader starts typing each question. In a new conversation, the route creates an empty session and binds it to the browser with the session cookie. The first message waits for that request so it can reuse the session. Fresh-session prewarming requires eve 0.59 or newer.
|
|
338
|
+
|
|
339
|
+
With eve 0.83 or newer, typing a follow-up also prepares the existing session owner on the deployment accepting the request. An idle owner on another deployment can transfer before Send. This keeps the same session, history, stream position, and expiry, and runs no model call. The client prepares each idle turn once, including restored conversations. Send proceeds without waiting for existing-session preparation; acceptance does not mean a background transfer has finished.
|
|
340
|
+
|
|
341
|
+
Prewarming requires [`GEISTDOCS_CHAT_SECRET`](#keep-eve-sessions-across-turns-with-geistdocs_chat_secret). The route verifies the latest answer's session tag against the signed cookie before preparing an existing session. Preparation failures, older agents without support, and expired or mismatched cookies fall back to the normal send path. Leave prewarming disabled when typing a draft should not allocate a durable session before the reader sends a message.
|
|
338
342
|
|
|
339
343
|
The URL flows to `createChatRoute` through the config object you already pass in `app/api/chat/route.ts` — no route changes are required. Geistdocs speaks eve's session API directly: it starts or resumes a durable eve session, streams the agent's NDJSON events, and translates them into the same UI message stream the chat panel already renders. With `GEISTDOCS_CHAT_SECRET` set, Geistdocs continues one eve session across turns by binding it to the reader's browser with a signed, httpOnly cookie.
|
|
340
344
|
|
|
@@ -740,7 +744,7 @@ Ask AI accepts text questions only. It does not support file or image attachment
|
|
|
740
744
|
The chat interface adapts to different screen sizes:
|
|
741
745
|
|
|
742
746
|
- **Desktop**: Slides in from the right side as a sidebar panel. Select **Expand chat** in the panel header to fill the viewport, which gives long answers and code blocks more width without losing the conversation. Select **Collapse chat** or press `Escape` to return to the sidebar. Closing the chat also returns it to the sidebar, so the next open starts there.
|
|
743
|
-
- **Mobile**: Opens as a
|
|
747
|
+
- **Mobile**: Opens as a full-screen chat and waits for the reader to focus the prompt before opening the software keyboard.
|
|
744
748
|
|
|
745
749
|
## Configuration
|
|
746
750
|
|
|
@@ -205,7 +205,7 @@ export const ai = {
|
|
|
205
205
|
};
|
|
206
206
|
```
|
|
207
207
|
|
|
208
|
-
Set `eveAgent.prewarm`
|
|
208
|
+
Set `eveAgent.prewarm` when preparing a durable session while a reader types is appropriate for the site. Fresh-session creation requires eve 0.59 or newer. With eve 0.83 or newer, the same option also prepares existing conversations before follow-up messages, preserving the session and allowing Send to proceed without waiting.
|
|
209
209
|
|
|
210
210
|
The `ai` config also controls the chat panel and its route:
|
|
211
211
|
|
|
@@ -231,6 +231,10 @@ See [Ask AI](/docs/ask-ai) for the full eve agent mode behavior, including authe
|
|
|
231
231
|
|
|
232
232
|
Use [Versioned docs](/docs/versioned-docs) for versioned source setup and [Proxy and markdown routes](/docs/proxy) for route mappings.
|
|
233
233
|
|
|
234
|
+
## Single-language sites
|
|
235
|
+
|
|
236
|
+
A site with one language can drop the `[lang]` route segment by setting `singleLanguage: true` in `defineConfig`. Routes then live directly under `app/`, the proxy skips locale rewrites, and route factories resolve every request to `defaultLanguage`. `translations` may only list `defaultLanguage`. Public URLs, `.md` routes, `llms.txt`, and `agents.md` keep their paths.
|
|
237
|
+
|
|
234
238
|
## `source.config.ts`
|
|
235
239
|
|
|
236
240
|
Use the source-config-safe package export in `source.config.ts`. This file is evaluated by `fumadocs-mdx` during install and build, so it should avoid imports from runtime component entry points such as `@vercel/geistdocs/mdx`.
|
package/template/package.json
CHANGED
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
"@streamdown/code": "^1.0.1",
|
|
18
18
|
"@vercel/agent-readability": "^0.7.0",
|
|
19
19
|
"@vercel/analytics": "^1.6.1",
|
|
20
|
-
"@vercel/geistdocs": "2.
|
|
20
|
+
"@vercel/geistdocs": "2.13.1-canary.87d00b3",
|
|
21
21
|
"@vercel/speed-insights": "^1.3.1",
|
|
22
22
|
"ai": "^6.0.132",
|
|
23
23
|
"clsx": "^2.1.1",
|