@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.
Files changed (80) hide show
  1. package/dist/cli/index.js +1 -1
  2. package/dist/config.d.ts +18 -4
  3. package/dist/config.d.ts.map +1 -1
  4. package/dist/footer.js +1 -1
  5. package/dist/internal/chat/loading-skeleton.d.ts.map +1 -1
  6. package/dist/internal/chat/loading-skeleton.js +1 -3
  7. package/dist/internal/chat/prompt-input.js +1 -1
  8. package/dist/internal/chat/session.d.ts +2 -3
  9. package/dist/internal/chat/session.d.ts.map +1 -1
  10. package/dist/internal/chat/session.js +28 -4
  11. package/dist/internal/chat/shell.d.ts.map +1 -1
  12. package/dist/internal/chat/shell.js +8 -9
  13. package/dist/internal/eve-agent-session.d.ts +5 -7
  14. package/dist/internal/eve-agent-session.d.ts.map +1 -1
  15. package/dist/internal/eve-agent-session.js +5 -8
  16. package/dist/internal/eve-agent.d.ts +11 -3
  17. package/dist/internal/eve-agent.d.ts.map +1 -1
  18. package/dist/internal/eve-agent.js +19 -4
  19. package/dist/internal/languages.d.ts +22 -1
  20. package/dist/internal/languages.d.ts.map +1 -1
  21. package/dist/internal/languages.js +32 -0
  22. package/dist/internal/lazy-search.d.ts +13 -0
  23. package/dist/internal/lazy-search.d.ts.map +1 -0
  24. package/dist/internal/lazy-search.js +61 -0
  25. package/dist/internal/provider-client.d.ts +1 -1
  26. package/dist/internal/provider-client.d.ts.map +1 -1
  27. package/dist/internal/provider-client.js +2 -2
  28. package/dist/mdx.d.ts +1 -44
  29. package/dist/mdx.d.ts.map +1 -1
  30. package/dist/mdx.js +4 -4
  31. package/dist/navbar.d.ts +1 -1
  32. package/dist/navbar.d.ts.map +1 -1
  33. package/dist/navbar.js +3 -1
  34. package/dist/pages/changelog.d.ts +7 -4
  35. package/dist/pages/changelog.d.ts.map +1 -1
  36. package/dist/pages/changelog.js +6 -4
  37. package/dist/pages/docs.d.ts +4 -2
  38. package/dist/pages/docs.d.ts.map +1 -1
  39. package/dist/pages/docs.js +15 -3
  40. package/dist/providers/public/components/drawer.d.ts +2 -1
  41. package/dist/providers/public/components/drawer.d.ts.map +1 -1
  42. package/dist/providers/public/components/drawer.js +2 -2
  43. package/dist/providers/public/components/toasts.d.ts +4 -4
  44. package/dist/providers/public/components/toasts.d.ts.map +1 -1
  45. package/dist/providers/public/components/toasts.js +50 -14
  46. package/dist/proxy.d.ts +1 -1
  47. package/dist/proxy.d.ts.map +1 -1
  48. package/dist/proxy.js +12 -1
  49. package/dist/routes/agents.d.ts +1 -1
  50. package/dist/routes/agents.d.ts.map +1 -1
  51. package/dist/routes/agents.js +4 -3
  52. package/dist/routes/changelog.d.ts +19 -10
  53. package/dist/routes/changelog.d.ts.map +1 -1
  54. package/dist/routes/changelog.js +11 -11
  55. package/dist/routes/chat.d.ts.map +1 -1
  56. package/dist/routes/chat.js +21 -4
  57. package/dist/routes/llms.d.ts +10 -5
  58. package/dist/routes/llms.d.ts.map +1 -1
  59. package/dist/routes/llms.js +10 -5
  60. package/dist/routes/mcp.d.ts +1 -1
  61. package/dist/routes/mcp.d.ts.map +1 -1
  62. package/dist/routes/mcp.js +2 -1
  63. package/dist/routes/openapi.d.ts +1 -1
  64. package/dist/routes/openapi.d.ts.map +1 -1
  65. package/dist/routes/openapi.js +12 -5
  66. package/dist/routes/sitemap.d.ts +5 -5
  67. package/dist/routes/sitemap.d.ts.map +1 -1
  68. package/dist/routes/sitemap.js +4 -9
  69. package/dist/source.d.ts +6 -1
  70. package/dist/source.d.ts.map +1 -1
  71. package/dist/source.js +1 -0
  72. package/docs/agents.md +1 -1
  73. package/docs/llms.txt +12 -4
  74. package/docs/manifest.json +1 -1
  75. package/docs/pages/ask-ai.md +6 -2
  76. package/docs/pages/configuration.md +5 -1
  77. package/package.json +7 -7
  78. package/template/content/docs/ask-ai.mdx +6 -2
  79. package/template/content/docs/configuration.mdx +5 -1
  80. 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.12.5.
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` only when the agent runs eve 0.59 or newer and allocating an empty durable session when a reader starts typing is appropriate for the site.
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 start an empty session when a reader starts typing a question in a new conversation. The prewarm response binds the session to the reader's browser with the session cookie, and the first message waits for that request and reuses the session, avoiding workflow startup latency. Prewarming requires eve 0.59 or newer and [`GEISTDOCS_CHAT_SECRET`](#keep-eve-sessions-across-turns-with-geistdocs_chat_secret), and falls back to normal session creation if the early request fails. Leave it disabled when typing a draft should not allocate a durable session before the reader sends a message.
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 bottom drawer. The drawer has no expanded view.
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
 
@@ -467,5 +467,5 @@
467
467
  }
468
468
  ],
469
469
  "source": "apps/template/content/docs",
470
- "version": "2.12.5"
470
+ "version": "2.13.1-canary.87d00b3"
471
471
  }
@@ -336,7 +336,11 @@ export const ai = {
336
336
  };
337
337
  ```
338
338
 
339
- Set `prewarm: true` to start an empty session when a reader starts typing a question in a new conversation. The prewarm response binds the session to the reader's browser with the session cookie, and the first message waits for that request and reuses the session, avoiding workflow startup latency. Prewarming requires eve 0.59 or newer and [`GEISTDOCS_CHAT_SECRET`](#keep-eve-sessions-across-turns-with-geistdocs_chat_secret), and falls back to normal session creation if the early request fails. Leave it disabled when typing a draft should not allocate a durable session before the reader sends a message.
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 bottom drawer. The drawer has no expanded view.
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` only when the agent runs eve 0.59 or newer and allocating an empty durable session when a reader starts typing is appropriate for the site.
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.12.5",
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.7",
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 start an empty session when a reader starts typing a question in a new conversation. The prewarm response binds the session to the reader's browser with the session cookie, and the first message waits for that request and reuses the session, avoiding workflow startup latency. Prewarming requires eve 0.59 or newer and [`GEISTDOCS_CHAT_SECRET`](#keep-eve-sessions-across-turns-with-geistdocs_chat_secret), and falls back to normal session creation if the early request fails. Leave it disabled when typing a draft should not allocate a durable session before the reader sends a message.
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 bottom drawer. The drawer has no expanded view.
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` only when the agent runs eve 0.59 or newer and allocating an empty durable session when a reader starts typing is appropriate for the site.
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`.
@@ -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.12.5",
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",