@vercel/geistdocs 2.11.0 → 2.12.0
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/internal/mdx-to-markdown.d.ts.map +1 -1
- package/dist/internal/mdx-to-markdown.js +48 -3
- package/dist/routes/chat.d.ts +24 -7
- package/dist/routes/chat.d.ts.map +1 -1
- package/dist/routes/chat.js +10 -9
- package/docs/agents.md +1 -1
- package/docs/llms.txt +19 -2
- package/docs/manifest.json +1 -1
- package/docs/pages/ask-ai.md +15 -1
- package/docs/pages/syntax.md +3 -0
- package/package.json +1 -1
- package/template/content/docs/ask-ai.cn.mdx +14 -0
- package/template/content/docs/ask-ai.mdx +15 -1
- package/template/content/docs/syntax.mdx +3 -0
- package/template/package.json +1 -1
package/dist/cli/index.js
CHANGED
|
@@ -4,4 +4,4 @@ import{Option as Rn,program as A}from"commander";import{access as Ke,copyFile as
|
|
|
4
4
|
`);throw new AggregateError(i,`Mixedbread search sync did not complete:
|
|
5
5
|
${a}`)}return r},Ft=async({client:e,file:t,pollIntervalMs:n,pollTimeoutMs:r,sleep:i})=>{let s=t,o=Date.now()+r;for(;s.status==="pending"||s.status==="in_progress";){if(Date.now()>=o)throw new Error(`Mixedbread timed out while indexing file ${t.id}.`);await i(n),s=await e.retrieveStoreFile(t.id)}if(s.status!=="completed")throw new Error(`Mixedbread failed to index file ${t.id} (${s.status}).`);return s},Dt=async({client:e,desired:t,pollIntervalMs:n,pollTimeoutMs:r,sleep:i})=>{let s=await e.uploadFile({content:t.document.content,filename:`${U(t.document.id).slice(0,32)}.md`}),o;try{o=await e.createStoreFile({externalId:t.externalId,fileId:s,metadata:{...t.metadata,[g.rawFileId]:s}})}catch(a){try{await e.deleteFile(s)}catch(d){throw new AggregateError([a,d],`Mixedbread failed to attach and clean up raw file ${s}.`)}throw a}return Ft({client:e,file:o,pollIntervalMs:n,pollTimeoutMs:r,sleep:i})},Ie=async({client:e,concurrency:t=St,manifest:n,pollIntervalMs:r=_t,pollTimeoutMs:i=Tt,revision:s,revisionAncestors:o=[],revisionTimestamp:a,sleep:d=Rt})=>{let c=_e(n);if(c.provider!=="mixedbread")return{deleted:0,skipped:c.documents.length,uploaded:0};let u=c.siteId?.trim();if(!u)throw new Error("Mixedbread retrieval requires a non-empty siteId in geistdocs.tsx.");if(c.documents.length===0)throw new Error("The Geistdocs search export is empty. Refusing to remove indexed documents.");let l=c.documents.map(p=>At(p,u,s,o,a)),m=new Map(l.map(p=>[p.document.id,p])),h=(await be(e)).flatMap(p=>{let y=q(p.metadata);return y?.siteId===u?[{file:p,metadata:y}]:[]}),x=new Map,P=new Set;for(let p of h){W(p.metadata,s,a)&&P.add(p.metadata.documentId);let y=m.get(p.metadata.documentId);y&&p.metadata.contentHash===y.hash&&p.file.status==="completed"&&!x.has(p.metadata.documentId)&&x.set(p.metadata.documentId,p)}let _=l.filter(p=>!(x.has(p.document.id)||P.has(p.document.id)));await Ee(_,t,p=>Dt({client:e,desired:p,pollIntervalMs:r,pollTimeoutMs:i,sleep:d}));let b=(await be(e)).flatMap(p=>{let y=q(p.metadata);return y?.siteId===u?[{file:p,metadata:y}]:[]}),D=new Set(b.filter(({metadata:p})=>W(p,s,a)).map(({metadata:p})=>p.documentId)),ie=new Set;for(let p of l){if(D.has(p.document.id))continue;let ae=b.filter(({file:V,metadata:k})=>V.status==="completed"&&k.documentId===p.document.id&&k.contentHash===p.hash).sort((V,k)=>V.file.id.localeCompare(k.file.id))[0];ae&&ie.add(ae.file.id)}let oe=b.filter(({file:p,metadata:y})=>p.status!=="pending"&&p.status!=="in_progress"&&!W(y,s,a)&&Mt({currentRevision:s,currentRevisionAncestors:o,currentRevisionTimestamp:a,desired:m.get(y.documentId),metadata:y})&&!ie.has(p.id));return await Ee(oe,t,async({file:p,metadata:y})=>{await e.deleteFile(y.rawFileId??p.id),await e.deleteStoreFile(p.id)}),{deleted:oe.length,skipped:l.length-_.length,uploaded:_.length}};var Ot=50,$t=e=>`vercel integration add mixedbread --name docs-${e||"your-site-id"} --environment production`,ve=(e,t)=>kt("git",t,{cwd:e,encoding:"utf8",stdio:["ignore","pipe","ignore"]}).trim(),Nt=e=>{let t=process.env.VERCEL_GIT_COMMIT_SHA?.trim(),n=[];try{n=ve(e,["rev-list",`--max-count=${Ot+1}`,t||"HEAD"]).split(`
|
|
6
6
|
`).filter(Boolean)}catch{n=[]}let r=t||n[0],i;for(let s of Array.from(new Set([r,"HEAD"].filter(Boolean))))try{let o=Number(ve(e,["show","-s","--format=%ct",s]));if(Number.isFinite(o)){i=o;break}}catch{}return{revision:r,revisionAncestors:n.filter(s=>s!==r),revisionTimestamp:i}},Pe=async({allowNonProduction:e=!1,dir:t=".next"}={})=>{let n=process.cwd();Ct.loadEnvConfig(n,!1);let r=process.env.MXBAI_API_KEY?.trim(),i=process.env.MXBAI_STORE_ID?.trim();if(process.env.VERCEL_ENV!=="production"&&!e){console.log("Geistdocs search sync skipped: this is not a production Vercel build.");return}if(!!r!=!!i)throw new Error("Mixedbread is partially configured. Set both MXBAI_API_KEY and MXBAI_STORE_ID.");let s;try{s=await Te({cwd:n,outputDirectory:t})}catch(a){if(!(r||i)){console.log("Geistdocs search sync skipped: no Mixedbread credentials or static search export were found.");return}throw a}if(s.provider!=="mixedbread"){console.log("Geistdocs search sync skipped: Ask AI uses local retrieval.");return}if(!(r&&i))throw new Error(["Mixedbread retrieval is enabled, but MXBAI_API_KEY or MXBAI_STORE_ID is missing.","From the root of this site's repository, linked to the correct Vercel project, run:",$t(s.siteId)].join(`
|
|
7
|
-
`));let o=await Ie({client:we({apiBaseUrl:process.env.MXBAI_BASE_URL,apiKey:r,storeId:i}),manifest:s,...Nt(n)});console.log(`Geistdocs search sync complete: ${o.uploaded} uploaded, ${o.deleted} deleted, ${o.skipped} unchanged.`)};import{readFileSync as Gt,writeFileSync as Ut}from"fs";import{mkdir as Lt,readFile as Z,writeFile as jt}from"fs/promises";import{dirname as Bt,extname as Vt,relative as Fe,resolve as j}from"path";import{intro as Jt,isCancel as Ht,log as I,multiselect as Xt,outro as L,spinner as Kt}from"@clack/prompts";import{glob as Yt}from"glob";import{Node as F,Project as qt,SyntaxKind as zt}from"ts-morph";var Wt="geistdocs.tsx",Qt="content/docs/**/*.mdx",ee=".translation-cache.json",Q=8,Ae=()=>({version:1,entries:{}}),Zt=async e=>{let t=await Z(e),{createHash:n}=await import("crypto");return n("sha256").update(t).digest("hex")},en=e=>{let t=j(process.cwd(),e);return Gt(t,"utf8")},Me=e=>F.isObjectLiteralExpression(e)?e.getProperties().flatMap(t=>{if(F.isPropertyAssignment(t)){let n=t.getNameNode();if(F.isIdentifier(n)||F.isStringLiteral(n))return[n.getText().replaceAll(/['"]/g,"")]}return[]}).filter(Boolean):[],tn=e=>{try{let t=new qt({compilerOptions:{allowJs:!0,jsx:4,module:99,target:10},skipAddingFilesFromTsConfig:!0,useInMemoryFileSystem:!0}),n=en(e),s=t.createSourceFile(e,n,{overwrite:!0}).getVariableDeclarations().find(a=>a.getName()==="translations")?.getInitializer();if(!s)return[];if(F.isObjectLiteralExpression(s))return Me(s);let o=s.getFirstDescendantByKind(zt.ObjectLiteralExpression);return o?Me(o):[]}catch(t){let n=t instanceof Error?t.message:`${t}`;return I.warn(`Failed to read locales from ${e}: ${n}`),[]}},nn=async()=>{let e=await Xt({message:"Which locales should be translated?",options:[{value:"cn",label:"Chinese (cn)"},{value:"jp",label:"Japanese (jp)"},{value:"es",label:"Spanish (es)"},{value:"fr",label:"French (fr)"},{value:"de",label:"German (de)"}],required:!0});return Ht(e)&&(L("Translation cancelled"),process.exit(0)),e},rn=async e=>(await Yt(e,{cwd:process.cwd(),absolute:!0,nodir:!0})).sort(),sn=async()=>{let e=j(process.cwd(),ee);try{let t=await Z(e,"utf8"),n=JSON.parse(t);return n.version!==1||!n.entries?Ae():{version:1,entries:n.entries}}catch{return Ae()}},Re=e=>{let t=j(process.cwd(),ee),n=JSON.stringify(e,null,2);Ut(t,n,"utf8")},on=async e=>{let t=await Promise.all(e.map(async n=>[n,await Zt(n)]));return Object.fromEntries(t)},an=(e,t)=>{let n=Vt(e);return`${e.slice(0,-n.length)}.${t}${n}`},De=(e,t)=>`${Fe(process.cwd(),e)}::${t}`,cn=(e,t,n,r,i=!1)=>{let s=[],o=0;for(let a of t){let d=n[a];for(let c of e){let u=an(a,c),l=De(a,c),m=r.entries[l];if(!i&&m?.hash===d){o+=1;continue}s.push({locale:c,sourceFile:a,sourceHash:d,targetFile:u})}}return{tasks:s,skippedCount:o}},dn=async e=>{await Lt(Bt(e),{recursive:!0})},ln=async(e,t,n)=>{let r=await fetch(e,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({content:t,locale:n})});if(!r.ok){let s=await r.text();throw new Error(`API request failed (${r.status}): ${s}`)}let i=await r.json();if(!i.translation)throw new Error("API response did not include a translation");return i.translation},pn=async(e,t,n)=>{let r=await Z(e.sourceFile,"utf8"),i=await ln(t,r,e.locale);await dn(e.targetFile),await jt(e.targetFile,i,"utf8"),n.entries[De(e.sourceFile,e.locale)]={hash:e.sourceHash,updatedAt:new Date().toISOString()}},ke=async(e,t)=>{Jt("Translate MDX content");let n=e??Qt,r=t.url||process.env.GEISTDOCS_TRANSLATE_URL||"https://geistdocs.com/translate",i=tn(t.config??Wt),s=await rn(n);s.length===0&&(I.error(`No MDX files found matching pattern: ${n}`),L("Translation cancelled"),process.exit(1)),I.info(`Found ${s.length} MDX file(s) matching pattern`),i.length===0&&(i=await nn());let o=j(process.cwd(),ee),a=await sn();await Re(a),I.info(`Using cache: ${o}`);let d=await on(s),{tasks:c,skippedCount:u}=cn(i,s,d,a,t.force);if(c.length===0){I.success("All translations are up to date!"),L(`Skipped ${u} file(s) (unchanged)`);return}let l=[];for(let h=0;h<c.length;h+=Q)l.push(c.slice(h,h+Q));I.info(`Processing ${c.length} translation(s) in ${l.length} batch(es) of up to ${Q}`),u>0&&I.info(`Skipped ${u} translation(s) (unchanged)`);let m=Kt();m.start("Translating content...");let f=0;for(let h of l)await Promise.all(h.map(async x=>{await pn(x,r,a),f+=1,m.message(`Translated ${f}/${c.length}: ${Fe(process.cwd(),x.targetFile)}`)})),await Re(a);m.stop("Translation complete!"),L(`Created/updated ${c.length} file(s)`)};import{access as un,copyFile as gn,mkdir as Ne,rm as re}from"fs/promises";import{dirname as mn,join as v}from"path";import{intro as fn,log as w,outro as B,spinner as Ge}from"@clack/prompts";import{glob as hn}from"glob";var wn=["**/*"],yn=["content/docs/**"],te=".geistdocs-tmp",xn=async(e,t)=>{let n=v(e,t);await re(n,{recursive:!0,force:!0}),await Ne(n,{recursive:!0})},ne=async e=>await re(e,{recursive:!0,force:!0}),Ce=async(e,t,n)=>(await hn(e,{cwd:n,nodir:!0,dot:!0,ignore:[".git/**",...t]})).sort(),bn=async e=>{try{return await un(e),!0}catch{return!1}},En=async(e,t,n)=>{let r=v(t,e),i=v(n,e);return await bn(r)?(await gn(r,i),{success:!0}):{success:!1,error:`Source file not found: ${r}`}},Sn=async(e,t)=>{let n=v(t,e);return await re(n,{force:!0}),{success:!0}},Oe=20,$e=async(e,t,n)=>{let r=[];for(let i=0;i<e.length;i+=n){let s=e.slice(i,i+n),o=await Promise.all(s.map(t));r.push(...o)}return r},_n=async(e,t,n,r,i)=>{let s={success:[],deleted:[],failed:[]},o=[...new Set(e.map(d=>mn(v(r,d))))];i.message(`Creating ${o.length} directories...`),await Promise.all(o.map(d=>Ne(d,{recursive:!0}))),i.message(`Updating ${e.length} files...`);let a=await $e(e,async d=>{let c=await En(d,n,r);return{file:d,...c}},Oe);for(let{file:d,success:c,error:u}of a)c?s.success.push(d):s.failed.push({file:d,error:u??"Unknown error"});if(t.length>0){i.message(`Deleting ${t.length} files...`);let d=await $e(t,async c=>{try{return await Sn(c,r),{file:c,success:!0}}catch(u){let l=u instanceof Error?u.message:`${u}`;return{file:c,success:!1,error:l}}},Oe);for(let c of d)c.success?s.deleted.push(c.file):s.failed.push({file:c.file,error:c.error})}return s},Tn=e=>{if(e.success.length>0){w.success(`Successfully updated ${e.success.length} files:`);for(let t of e.success)w.info(` \u2713 ${t}`)}if(e.deleted.length>0){w.success(`Deleted ${e.deleted.length} files:`);for(let t of e.deleted)w.info(` \u{1F5D1} ${t}`)}if(e.failed.length>0){w.warn(`Failed to update ${e.failed.length} files:`);for(let{file:t,error:n}of e.failed)w.error(` \u2717 ${t}: ${n}`)}},In=e=>e.includes("canary")?"canary":"latest",vn=async e=>{let t=await fetch(`https://registry.npmjs.org/${encodeURIComponent(S)}`);if(!t.ok)throw new Error(`Failed to resolve ${S}@${e}`);let r=(await t.json())["dist-tags"]?.[e];if(!r)throw new Error(`Could not find dist-tag ${e} for ${S}`);return r},Pn=async e=>{let t=await M(e),n=J(t,S);if(!n)return{currentVersion:n,nextVersion:void 0,updated:!1};let r=In(n),i=await vn(r);return n===i?{currentVersion:n,nextVersion:i,updateTag:r,updated:!1}:($(t,S,i),await O(e,t),{currentVersion:n,nextVersion:i,updateTag:r,updated:!0})},An=async(e,t,n)=>{let r=await M(e);if(!le(r,S))return!1;t&&t.length>0&&w.warn("Ignoring file patterns for a package-based site. This update will bump the package version instead."),n?.sync&&w.warn("Ignoring --sync for a package-based site. Runtime updates now come from the package version.");let{currentVersion:i,nextVersion:s,updateTag:o,updated:a}=await Pn(e);if(!a)return w.success(i?`@vercel/geistdocs is already at ${s} (${o}).`:"No package version update was needed."),B("Package-based site is already up to date."),!0;w.info(`Bumping ${S} from ${i} to ${s} (${o})`);let d=Ge();return d.start("Installing updated package version..."),await T("pnpm",["install"],{cwd:e}),d.stop("Package update complete!"),B("Please review and test the upgraded package version."),!0},Mn=async(e,t,n,r,i)=>{let s=v(e,te),o=Ge(),a=i?.sync?s:t;o.start("Preparing template snapshot..."),i?.sync&&(await xn(e,te),await N(s)),o.message("Scanning for files...");let d=await Ce(n,r,a),c=[];if(i?.sync){o.message("Comparing with local files...");let l=await Ce(n,r,e),m=new Set(d);c=l.filter(f=>!m.has(f))}if(o.stop(`Found ${d.length} files to update`),d.length===0&&c.length===0){w.warn("No files matched the patterns. Nothing to update."),i?.sync&&await ne(s),B("Update cancelled.");return}w.info(`Patterns: ${n.length}`),w.info(`Files to update: ${d.length}`),i?.sync&&w.info(`Files to delete: ${c.length}`),o.start("Updating files...");let u=await _n(d,c,a,e,o);i?.sync&&(o.message("Cleaning up..."),await ne(s)),o.stop("Update complete!"),Tn(u),B("Please review and test the changes carefully.")},Ue=async(e,t)=>{let n=process.cwd(),r=H(),i=e&&e.length>0?e:wn,s=e&&e.length>0?[]:yn;try{if(fn("Let's update your Geistdocs project!"),await An(n,e,t))return;w.info("Template source: bundled package snapshot"),e&&e.length>0&&w.info(`Updating specific files: ${e.join(", ")}`),t?.sync&&w.info("Sync mode enabled: will delete files removed from template"),await Mn(n,r,i,s,t)}catch(o){let a=o instanceof Error?o.message:`${o}`;try{await ne(v(n,te))}catch{}w.error(`Failed to update project: ${a}`),process.exit(1)}};A.name("geistdocs").description("CLI for Geistdocs projects").version("2.11.0","-v, --version","Output the current version");A.command("init").description("Initialize a new Geistdocs project").option("--name <name>","Name of the project").addOption(new Rn("--brand <brand>","Navbar brand").choices(["vercel","labs"]).default("vercel")).option("--disable-git","Disable git initialization").action(he);A.command("update [files...]").description("Update a Geistdocs project (optionally specify files/patterns to update)").option("--sync","Delete local files that no longer exist in the template").action(Ue);A.command("translate [pattern]").description("Translate MDX file(s) to one or more locales (default: content/docs/**/*.mdx)").option("--config <path>","Path to config file to load locales from (defaults to geistdocs.tsx)").option("--url <url>","Custom translation API URL (defaults to GEISTDOCS_TRANSLATE_URL or https://geistdocs.com/translate)").option("--force","Force re-translation of all files, ignoring cache").action(ke);var Fn=A.command("search").description("Manage the external search index used by Ask AI");Fn.command("sync").description("Sync the latest static docs export to Mixedbread").option("--dir <path>","Next.js output directory",".next").option("--allow-non-production","Run outside a production Vercel build").action(Pe);await A.parseAsync(process.argv).catch(e=>{console.error(e instanceof Error?e.message:e),process.exitCode=1});
|
|
7
|
+
`));let o=await Ie({client:we({apiBaseUrl:process.env.MXBAI_BASE_URL,apiKey:r,storeId:i}),manifest:s,...Nt(n)});console.log(`Geistdocs search sync complete: ${o.uploaded} uploaded, ${o.deleted} deleted, ${o.skipped} unchanged.`)};import{readFileSync as Gt,writeFileSync as Ut}from"fs";import{mkdir as Lt,readFile as Z,writeFile as jt}from"fs/promises";import{dirname as Bt,extname as Vt,relative as Fe,resolve as j}from"path";import{intro as Jt,isCancel as Ht,log as I,multiselect as Xt,outro as L,spinner as Kt}from"@clack/prompts";import{glob as Yt}from"glob";import{Node as F,Project as qt,SyntaxKind as zt}from"ts-morph";var Wt="geistdocs.tsx",Qt="content/docs/**/*.mdx",ee=".translation-cache.json",Q=8,Ae=()=>({version:1,entries:{}}),Zt=async e=>{let t=await Z(e),{createHash:n}=await import("crypto");return n("sha256").update(t).digest("hex")},en=e=>{let t=j(process.cwd(),e);return Gt(t,"utf8")},Me=e=>F.isObjectLiteralExpression(e)?e.getProperties().flatMap(t=>{if(F.isPropertyAssignment(t)){let n=t.getNameNode();if(F.isIdentifier(n)||F.isStringLiteral(n))return[n.getText().replaceAll(/['"]/g,"")]}return[]}).filter(Boolean):[],tn=e=>{try{let t=new qt({compilerOptions:{allowJs:!0,jsx:4,module:99,target:10},skipAddingFilesFromTsConfig:!0,useInMemoryFileSystem:!0}),n=en(e),s=t.createSourceFile(e,n,{overwrite:!0}).getVariableDeclarations().find(a=>a.getName()==="translations")?.getInitializer();if(!s)return[];if(F.isObjectLiteralExpression(s))return Me(s);let o=s.getFirstDescendantByKind(zt.ObjectLiteralExpression);return o?Me(o):[]}catch(t){let n=t instanceof Error?t.message:`${t}`;return I.warn(`Failed to read locales from ${e}: ${n}`),[]}},nn=async()=>{let e=await Xt({message:"Which locales should be translated?",options:[{value:"cn",label:"Chinese (cn)"},{value:"jp",label:"Japanese (jp)"},{value:"es",label:"Spanish (es)"},{value:"fr",label:"French (fr)"},{value:"de",label:"German (de)"}],required:!0});return Ht(e)&&(L("Translation cancelled"),process.exit(0)),e},rn=async e=>(await Yt(e,{cwd:process.cwd(),absolute:!0,nodir:!0})).sort(),sn=async()=>{let e=j(process.cwd(),ee);try{let t=await Z(e,"utf8"),n=JSON.parse(t);return n.version!==1||!n.entries?Ae():{version:1,entries:n.entries}}catch{return Ae()}},Re=e=>{let t=j(process.cwd(),ee),n=JSON.stringify(e,null,2);Ut(t,n,"utf8")},on=async e=>{let t=await Promise.all(e.map(async n=>[n,await Zt(n)]));return Object.fromEntries(t)},an=(e,t)=>{let n=Vt(e);return`${e.slice(0,-n.length)}.${t}${n}`},De=(e,t)=>`${Fe(process.cwd(),e)}::${t}`,cn=(e,t,n,r,i=!1)=>{let s=[],o=0;for(let a of t){let d=n[a];for(let c of e){let u=an(a,c),l=De(a,c),m=r.entries[l];if(!i&&m?.hash===d){o+=1;continue}s.push({locale:c,sourceFile:a,sourceHash:d,targetFile:u})}}return{tasks:s,skippedCount:o}},dn=async e=>{await Lt(Bt(e),{recursive:!0})},ln=async(e,t,n)=>{let r=await fetch(e,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({content:t,locale:n})});if(!r.ok){let s=await r.text();throw new Error(`API request failed (${r.status}): ${s}`)}let i=await r.json();if(!i.translation)throw new Error("API response did not include a translation");return i.translation},pn=async(e,t,n)=>{let r=await Z(e.sourceFile,"utf8"),i=await ln(t,r,e.locale);await dn(e.targetFile),await jt(e.targetFile,i,"utf8"),n.entries[De(e.sourceFile,e.locale)]={hash:e.sourceHash,updatedAt:new Date().toISOString()}},ke=async(e,t)=>{Jt("Translate MDX content");let n=e??Qt,r=t.url||process.env.GEISTDOCS_TRANSLATE_URL||"https://geistdocs.com/translate",i=tn(t.config??Wt),s=await rn(n);s.length===0&&(I.error(`No MDX files found matching pattern: ${n}`),L("Translation cancelled"),process.exit(1)),I.info(`Found ${s.length} MDX file(s) matching pattern`),i.length===0&&(i=await nn());let o=j(process.cwd(),ee),a=await sn();await Re(a),I.info(`Using cache: ${o}`);let d=await on(s),{tasks:c,skippedCount:u}=cn(i,s,d,a,t.force);if(c.length===0){I.success("All translations are up to date!"),L(`Skipped ${u} file(s) (unchanged)`);return}let l=[];for(let h=0;h<c.length;h+=Q)l.push(c.slice(h,h+Q));I.info(`Processing ${c.length} translation(s) in ${l.length} batch(es) of up to ${Q}`),u>0&&I.info(`Skipped ${u} translation(s) (unchanged)`);let m=Kt();m.start("Translating content...");let f=0;for(let h of l)await Promise.all(h.map(async x=>{await pn(x,r,a),f+=1,m.message(`Translated ${f}/${c.length}: ${Fe(process.cwd(),x.targetFile)}`)})),await Re(a);m.stop("Translation complete!"),L(`Created/updated ${c.length} file(s)`)};import{access as un,copyFile as gn,mkdir as Ne,rm as re}from"fs/promises";import{dirname as mn,join as v}from"path";import{intro as fn,log as w,outro as B,spinner as Ge}from"@clack/prompts";import{glob as hn}from"glob";var wn=["**/*"],yn=["content/docs/**"],te=".geistdocs-tmp",xn=async(e,t)=>{let n=v(e,t);await re(n,{recursive:!0,force:!0}),await Ne(n,{recursive:!0})},ne=async e=>await re(e,{recursive:!0,force:!0}),Ce=async(e,t,n)=>(await hn(e,{cwd:n,nodir:!0,dot:!0,ignore:[".git/**",...t]})).sort(),bn=async e=>{try{return await un(e),!0}catch{return!1}},En=async(e,t,n)=>{let r=v(t,e),i=v(n,e);return await bn(r)?(await gn(r,i),{success:!0}):{success:!1,error:`Source file not found: ${r}`}},Sn=async(e,t)=>{let n=v(t,e);return await re(n,{force:!0}),{success:!0}},Oe=20,$e=async(e,t,n)=>{let r=[];for(let i=0;i<e.length;i+=n){let s=e.slice(i,i+n),o=await Promise.all(s.map(t));r.push(...o)}return r},_n=async(e,t,n,r,i)=>{let s={success:[],deleted:[],failed:[]},o=[...new Set(e.map(d=>mn(v(r,d))))];i.message(`Creating ${o.length} directories...`),await Promise.all(o.map(d=>Ne(d,{recursive:!0}))),i.message(`Updating ${e.length} files...`);let a=await $e(e,async d=>{let c=await En(d,n,r);return{file:d,...c}},Oe);for(let{file:d,success:c,error:u}of a)c?s.success.push(d):s.failed.push({file:d,error:u??"Unknown error"});if(t.length>0){i.message(`Deleting ${t.length} files...`);let d=await $e(t,async c=>{try{return await Sn(c,r),{file:c,success:!0}}catch(u){let l=u instanceof Error?u.message:`${u}`;return{file:c,success:!1,error:l}}},Oe);for(let c of d)c.success?s.deleted.push(c.file):s.failed.push({file:c.file,error:c.error})}return s},Tn=e=>{if(e.success.length>0){w.success(`Successfully updated ${e.success.length} files:`);for(let t of e.success)w.info(` \u2713 ${t}`)}if(e.deleted.length>0){w.success(`Deleted ${e.deleted.length} files:`);for(let t of e.deleted)w.info(` \u{1F5D1} ${t}`)}if(e.failed.length>0){w.warn(`Failed to update ${e.failed.length} files:`);for(let{file:t,error:n}of e.failed)w.error(` \u2717 ${t}: ${n}`)}},In=e=>e.includes("canary")?"canary":"latest",vn=async e=>{let t=await fetch(`https://registry.npmjs.org/${encodeURIComponent(S)}`);if(!t.ok)throw new Error(`Failed to resolve ${S}@${e}`);let r=(await t.json())["dist-tags"]?.[e];if(!r)throw new Error(`Could not find dist-tag ${e} for ${S}`);return r},Pn=async e=>{let t=await M(e),n=J(t,S);if(!n)return{currentVersion:n,nextVersion:void 0,updated:!1};let r=In(n),i=await vn(r);return n===i?{currentVersion:n,nextVersion:i,updateTag:r,updated:!1}:($(t,S,i),await O(e,t),{currentVersion:n,nextVersion:i,updateTag:r,updated:!0})},An=async(e,t,n)=>{let r=await M(e);if(!le(r,S))return!1;t&&t.length>0&&w.warn("Ignoring file patterns for a package-based site. This update will bump the package version instead."),n?.sync&&w.warn("Ignoring --sync for a package-based site. Runtime updates now come from the package version.");let{currentVersion:i,nextVersion:s,updateTag:o,updated:a}=await Pn(e);if(!a)return w.success(i?`@vercel/geistdocs is already at ${s} (${o}).`:"No package version update was needed."),B("Package-based site is already up to date."),!0;w.info(`Bumping ${S} from ${i} to ${s} (${o})`);let d=Ge();return d.start("Installing updated package version..."),await T("pnpm",["install"],{cwd:e}),d.stop("Package update complete!"),B("Please review and test the upgraded package version."),!0},Mn=async(e,t,n,r,i)=>{let s=v(e,te),o=Ge(),a=i?.sync?s:t;o.start("Preparing template snapshot..."),i?.sync&&(await xn(e,te),await N(s)),o.message("Scanning for files...");let d=await Ce(n,r,a),c=[];if(i?.sync){o.message("Comparing with local files...");let l=await Ce(n,r,e),m=new Set(d);c=l.filter(f=>!m.has(f))}if(o.stop(`Found ${d.length} files to update`),d.length===0&&c.length===0){w.warn("No files matched the patterns. Nothing to update."),i?.sync&&await ne(s),B("Update cancelled.");return}w.info(`Patterns: ${n.length}`),w.info(`Files to update: ${d.length}`),i?.sync&&w.info(`Files to delete: ${c.length}`),o.start("Updating files...");let u=await _n(d,c,a,e,o);i?.sync&&(o.message("Cleaning up..."),await ne(s)),o.stop("Update complete!"),Tn(u),B("Please review and test the changes carefully.")},Ue=async(e,t)=>{let n=process.cwd(),r=H(),i=e&&e.length>0?e:wn,s=e&&e.length>0?[]:yn;try{if(fn("Let's update your Geistdocs project!"),await An(n,e,t))return;w.info("Template source: bundled package snapshot"),e&&e.length>0&&w.info(`Updating specific files: ${e.join(", ")}`),t?.sync&&w.info("Sync mode enabled: will delete files removed from template"),await Mn(n,r,i,s,t)}catch(o){let a=o instanceof Error?o.message:`${o}`;try{await ne(v(n,te))}catch{}w.error(`Failed to update project: ${a}`),process.exit(1)}};A.name("geistdocs").description("CLI for Geistdocs projects").version("2.12.0","-v, --version","Output the current version");A.command("init").description("Initialize a new Geistdocs project").option("--name <name>","Name of the project").addOption(new Rn("--brand <brand>","Navbar brand").choices(["vercel","labs"]).default("vercel")).option("--disable-git","Disable git initialization").action(he);A.command("update [files...]").description("Update a Geistdocs project (optionally specify files/patterns to update)").option("--sync","Delete local files that no longer exist in the template").action(Ue);A.command("translate [pattern]").description("Translate MDX file(s) to one or more locales (default: content/docs/**/*.mdx)").option("--config <path>","Path to config file to load locales from (defaults to geistdocs.tsx)").option("--url <url>","Custom translation API URL (defaults to GEISTDOCS_TRANSLATE_URL or https://geistdocs.com/translate)").option("--force","Force re-translation of all files, ignoring cache").action(ke);var Fn=A.command("search").description("Manage the external search index used by Ask AI");Fn.command("sync").description("Sync the latest static docs export to Mixedbread").option("--dir <path>","Next.js output directory",".next").option("--allow-non-production","Run outside a production Vercel build").action(Pe);await A.parseAsync(process.argv).catch(e=>{console.error(e instanceof Error?e.message:e),process.exitCode=1});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mdx-to-markdown.d.ts","sourceRoot":"","sources":["../../src/internal/mdx-to-markdown.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,aAAa,EAA2B,MAAM,SAAS,CAAC;AAkCtE,wEAAwE;AACxE,MAAM,MAAM,iBAAiB,GACzB,OAAO,GACP,IAAI,GACJ,MAAM,GACN,MAAM,GACN,iBAAiB,EAAE,GACnB;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAAA;CAAE,CAAC;AAEzC,8DAA8D;AAC9D,MAAM,WAAW,wBAAwB;IACvC,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,MAAM,EAAE,OAAO,CAAC;IAChB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC1C;AAED;;;GAGG;AACH,MAAM,MAAM,2BAA2B,CAAC,OAAO,GAAG,OAAO,IAAI,CAC3D,OAAO,EAAE,wBAAwB,EACjC,OAAO,EAAE,OAAO,KACb,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAEpE,MAAM,WAAW,oBAAoB,CAAC,OAAO,GAAG,OAAO;IACrD,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,OAAO,CAAC,CAAC,CAAC;IAClE,iFAAiF;IACjF,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;
|
|
1
|
+
{"version":3,"file":"mdx-to-markdown.d.ts","sourceRoot":"","sources":["../../src/internal/mdx-to-markdown.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,aAAa,EAA2B,MAAM,SAAS,CAAC;AAkCtE,wEAAwE;AACxE,MAAM,MAAM,iBAAiB,GACzB,OAAO,GACP,IAAI,GACJ,MAAM,GACN,MAAM,GACN,iBAAiB,EAAE,GACnB;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAAA;CAAE,CAAC;AAEzC,8DAA8D;AAC9D,MAAM,WAAW,wBAAwB;IACvC,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,MAAM,EAAE,OAAO,CAAC;IAChB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC1C;AAED;;;GAGG;AACH,MAAM,MAAM,2BAA2B,CAAC,OAAO,GAAG,OAAO,IAAI,CAC3D,OAAO,EAAE,wBAAwB,EACjC,OAAO,EAAE,OAAO,KACb,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAEpE,MAAM,WAAW,oBAAoB,CAAC,OAAO,GAAG,OAAO;IACrD,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,OAAO,CAAC,CAAC,CAAC;IAClE,iFAAiF;IACjF,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAwoDD;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,GAAG,SAAS,EACrD,UAAU,aAAa,GAAG,oBAAoB,CAAC,OAAO,CAAC,MAUzC,QAAQ,MAAM,EAAE,UAAU,OAAO,oBAgBhD,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,aAAa,WAnBF,MAAM,yCAmBoB,CAAC"}
|
|
@@ -936,9 +936,8 @@ const replaceComponent = (node) => {
|
|
|
936
936
|
if ((node.name === "CopyPrompt" || node.name === "Prompt") && text) {
|
|
937
937
|
return [paragraph(text)];
|
|
938
938
|
}
|
|
939
|
-
// Presentation-only components
|
|
940
|
-
//
|
|
941
|
-
// remain in document order, so every tab's fenced code is written out.
|
|
939
|
+
// Presentation-only components should not leak into agent-readable
|
|
940
|
+
// Markdown. Their meaningful children remain in document order.
|
|
942
941
|
return node.children ?? [];
|
|
943
942
|
};
|
|
944
943
|
const isJsxElement = (node) => node.type === "mdxJsxFlowElement" || node.type === "mdxJsxTextElement";
|
|
@@ -1007,6 +1006,48 @@ const tabsNodes = (node) => {
|
|
|
1007
1006
|
];
|
|
1008
1007
|
});
|
|
1009
1008
|
};
|
|
1009
|
+
const nodeText = (node) => typeof node.value === "string"
|
|
1010
|
+
? node.value
|
|
1011
|
+
: (node.children ?? []).map(nodeText).join("");
|
|
1012
|
+
// Fumadocs groups fences that share a `tab=` meta into `CodeBlockTabs` (or an
|
|
1013
|
+
// author writes `CompactCodeBlockTabs`), with the tab names in
|
|
1014
|
+
// `CodeBlockTabsTrigger` elements. Dropping the triggers left
|
|
1015
|
+
// unlabelled, near-identical fences (`pnpm add`, `npm install`, …), so each
|
|
1016
|
+
// panel keeps its trigger's label, or its `value`, in bold before its code.
|
|
1017
|
+
// A lone tab has nothing to tell apart, so its code stays bare.
|
|
1018
|
+
const codeBlockTabsNodes = (node) => {
|
|
1019
|
+
const panelCount = (node.children ?? []).filter((child) => isJsxElement(child) && child.name === "CodeBlockTab").length;
|
|
1020
|
+
// Triggers written on adjacent lines parse as inline elements inside a
|
|
1021
|
+
// paragraph, so search the whole list rather than its direct children.
|
|
1022
|
+
const labels = new Map();
|
|
1023
|
+
const collectLabels = (current) => {
|
|
1024
|
+
if (isJsxElement(current) && current.name === "CodeBlockTabsTrigger") {
|
|
1025
|
+
const value = getAttribute(current, "value");
|
|
1026
|
+
const label = nodeText(current).trim();
|
|
1027
|
+
if (value && label) {
|
|
1028
|
+
labels.set(value, label);
|
|
1029
|
+
}
|
|
1030
|
+
return;
|
|
1031
|
+
}
|
|
1032
|
+
for (const child of current.children ?? []) {
|
|
1033
|
+
if (!isJsxElement(child) || child.name !== "CodeBlockTab") {
|
|
1034
|
+
collectLabels(child);
|
|
1035
|
+
}
|
|
1036
|
+
}
|
|
1037
|
+
};
|
|
1038
|
+
collectLabels(node);
|
|
1039
|
+
return (node.children ?? []).flatMap((child) => {
|
|
1040
|
+
if (!isJsxElement(child) || child.name !== "CodeBlockTab") {
|
|
1041
|
+
return cleanNode(child);
|
|
1042
|
+
}
|
|
1043
|
+
const value = getAttribute(child, "value");
|
|
1044
|
+
const label = value ? (labels.get(value) ?? value) : undefined;
|
|
1045
|
+
const content = (child.children ?? []).flatMap(cleanNode);
|
|
1046
|
+
return label && panelCount > 1
|
|
1047
|
+
? [strongParagraph(label), ...content]
|
|
1048
|
+
: content;
|
|
1049
|
+
});
|
|
1050
|
+
};
|
|
1010
1051
|
// Steps exist in two shapes: the `Steps`/`Step` components authored in MDX and
|
|
1011
1052
|
// the `div.fd-steps`/`div.fd-step` output that remarkSteps emits for numbered
|
|
1012
1053
|
// headings. Both flatten to their content with the step number restored on
|
|
@@ -1051,6 +1092,10 @@ const cleanNode = (node) => {
|
|
|
1051
1092
|
if (isJsxElement(node) && node.name === "Tabs") {
|
|
1052
1093
|
return itemTabsNodes(node);
|
|
1053
1094
|
}
|
|
1095
|
+
if (isJsxElement(node) &&
|
|
1096
|
+
(node.name === "CodeBlockTabs" || node.name === "CompactCodeBlockTabs")) {
|
|
1097
|
+
return codeBlockTabsNodes(node);
|
|
1098
|
+
}
|
|
1054
1099
|
if (node.children) {
|
|
1055
1100
|
node.children = node.children.flatMap(cleanNode);
|
|
1056
1101
|
}
|
package/dist/routes/chat.d.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { type LanguageModel } from "ai";
|
|
2
2
|
import { type GeistdocsConfig } from "../config";
|
|
3
3
|
import { type ChatMixedbreadOptions } from "../internal/chat-retrieval";
|
|
4
|
+
import { type EveAgentClientContext } from "../internal/eve-agent";
|
|
4
5
|
import { type GeistdocsPageFilter } from "../page-visibility";
|
|
5
6
|
import type { GeistdocsSourceBundle } from "../source";
|
|
6
7
|
type SourceBundle = GeistdocsSourceBundle;
|
|
@@ -22,16 +23,32 @@ interface ChatProxyConfig {
|
|
|
22
23
|
* full, and no citations; every other message is forwarded as sent.
|
|
23
24
|
*/
|
|
24
25
|
type ChatContextInjection = "auto" | "page-only";
|
|
26
|
+
/** The page the reader is viewing, as `eveAgent.clientContext` resolves it. */
|
|
27
|
+
interface ChatEveAgentCurrentPage {
|
|
28
|
+
title?: string;
|
|
29
|
+
url: string;
|
|
30
|
+
}
|
|
31
|
+
/** Builds eve's `clientContext` for one message from the reader's page. */
|
|
32
|
+
type ChatEveAgentClientContextFunction = (context: {
|
|
33
|
+
currentPage?: ChatEveAgentCurrentPage;
|
|
34
|
+
}) => EveAgentClientContext | Promise<EveAgentClientContext>;
|
|
25
35
|
interface ChatEveAgentOptions {
|
|
26
36
|
/**
|
|
27
|
-
* Send eve's turn-scoped `clientContext
|
|
28
|
-
*
|
|
29
|
-
*
|
|
30
|
-
*
|
|
31
|
-
*
|
|
32
|
-
*
|
|
37
|
+
* Send eve's turn-scoped `clientContext` with every message, including the
|
|
38
|
+
* message that starts a replacement session; prewarm requests carry no
|
|
39
|
+
* message, so they never send it.
|
|
40
|
+
*
|
|
41
|
+
* `true` sends `{ currentPage: { url, title } }`. `url` is the absolute
|
|
42
|
+
* public URL of `currentRoute` (on `config.siteUrl`, or the request
|
|
43
|
+
* origin); `title` is included when the route is a page Ask AI may see.
|
|
44
|
+
* Nothing is sent without a usable `currentRoute`.
|
|
45
|
+
*
|
|
46
|
+
* A function receives that `currentPage`, unset without a usable
|
|
47
|
+
* `currentRoute`, and returns the `clientContext` to send, so an agent can
|
|
48
|
+
* get its own fields with the page. It runs for every message and may be
|
|
49
|
+
* async. @default false
|
|
33
50
|
*/
|
|
34
|
-
clientContext?: boolean;
|
|
51
|
+
clientContext?: boolean | ChatEveAgentClientContextFunction;
|
|
35
52
|
/**
|
|
36
53
|
* Extra headers for requests to the eve agent, replacing the default
|
|
37
54
|
* `Authorization: Bearer <Vercel OIDC token>` when an `authorization`
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/routes/chat.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,aAAa,EAQnB,MAAM,IAAI,CAAC;AAGZ,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,WAAW,CAAC;AAKhE,OAAO,EAEL,KAAK,qBAAqB,EAG3B,MAAM,4BAA4B,CAAC;
|
|
1
|
+
{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/routes/chat.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,aAAa,EAQnB,MAAM,IAAI,CAAC;AAGZ,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,WAAW,CAAC;AAKhE,OAAO,EAEL,KAAK,qBAAqB,EAG3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAIL,KAAK,qBAAqB,EAS3B,MAAM,uBAAuB,CAAC;AAW/B,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,KAAK,YAAY,GAAG,qBAAqB,CAAC;AA4B1C;;;GAGG;AACH,KAAK,mBAAmB,GACpB,WAAW,GACX,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;AAE/D,UAAU,eAAe;IACvB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;GAOG;AACH,KAAK,oBAAoB,GAAG,MAAM,GAAG,WAAW,CAAC;AAEjD,+EAA+E;AAC/E,UAAU,uBAAuB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,2EAA2E;AAC3E,KAAK,iCAAiC,GAAG,CAAC,OAAO,EAAE;IACjD,WAAW,CAAC,EAAE,uBAAuB,CAAC;CACvC,KAAK,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAE7D,UAAU,mBAAmB;IAC3B;;;;;;;;;;;;;;OAcG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,iCAAiC,CAAC;IAC5D;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,UAAU,iBAAiB;IACzB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,UAAU,sBAAsB;IAC9B,MAAM,EAAE,IAAI,CACV,eAAe,EACb,IAAI,GACJ,UAAU,GACV,iBAAiB,GACjB,QAAQ,GACR,SAAS,GACT,cAAc,CACjB,CAAC;IACF;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,4DAA4D;IAC5D,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC;;;OAGG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CAC1B;AA0oDD,eAAO,MAAM,eAAe,GAAI,wGAW7B,sBAAsB;gBAqBE,OAAO;;CAiMjC,CAAC"}
|
package/dist/routes/chat.js
CHANGED
|
@@ -345,11 +345,11 @@ const buildPageOnlyProxyMessages = (actualMessages, attachedDoc) => {
|
|
|
345
345
|
];
|
|
346
346
|
};
|
|
347
347
|
/**
|
|
348
|
-
*
|
|
348
|
+
* The page the reader is viewing, for eve `clientContext`. Returns
|
|
349
349
|
* `undefined` without a usable `currentRoute`. The URL is built from the
|
|
350
350
|
* route's path only, so a client cannot point it at another origin.
|
|
351
351
|
*/
|
|
352
|
-
const
|
|
352
|
+
const getEveCurrentPage = ({ basePath, baseUrl, currentRoute, defaultLanguage, filterPage, languages, sources, }) => {
|
|
353
353
|
if (typeof currentRoute !== "string" ||
|
|
354
354
|
!currentRoute.trim() ||
|
|
355
355
|
currentRoute.length > MAX_PAGE_CONTEXT_URL_CHARS) {
|
|
@@ -372,11 +372,9 @@ const getEveClientContext = ({ basePath, baseUrl, currentRoute, defaultLanguage,
|
|
|
372
372
|
sources,
|
|
373
373
|
});
|
|
374
374
|
const title = page ? getPageData(page.page).title?.trim() : undefined;
|
|
375
|
-
return
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
: { url },
|
|
379
|
-
};
|
|
375
|
+
return title
|
|
376
|
+
? { url, title: title.slice(0, MAX_CLIENT_CONTEXT_TITLE_CHARS) }
|
|
377
|
+
: { url };
|
|
380
378
|
};
|
|
381
379
|
const isFirstUserMessage = (messages) => messages.filter((message) => message.role === "user").length === 1;
|
|
382
380
|
const buildProxyMessages = async ({ actualMessages, config, currentRoute, defaultLanguage, filterPage, languages, pageContext, routeSources, searchDocuments, }) => {
|
|
@@ -961,8 +959,8 @@ const createEveAgentResponse = async ({ actualMessages, agentUrl, config, contex
|
|
|
961
959
|
const withPageContext = (message) => attachedDoc
|
|
962
960
|
? [createEvePageContextPart(attachedDoc), { type: "text", text: message }]
|
|
963
961
|
: message;
|
|
964
|
-
const
|
|
965
|
-
?
|
|
962
|
+
const currentPage = eveAgent?.clientContext
|
|
963
|
+
? getEveCurrentPage({
|
|
966
964
|
basePath: config.basePath,
|
|
967
965
|
baseUrl,
|
|
968
966
|
currentRoute,
|
|
@@ -972,6 +970,9 @@ const createEveAgentResponse = async ({ actualMessages, agentUrl, config, contex
|
|
|
972
970
|
sources: routeSources,
|
|
973
971
|
})
|
|
974
972
|
: undefined;
|
|
973
|
+
const clientContext = typeof eveAgent?.clientContext === "function"
|
|
974
|
+
? await eveAgent.clientContext({ currentPage })
|
|
975
|
+
: currentPage && { currentPage };
|
|
975
976
|
const headers = await getEveAgentRequestHeaders({ eveAgent, req });
|
|
976
977
|
let session;
|
|
977
978
|
// The session must be settled before the response starts so the cookie
|
package/docs/agents.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Geistdocs Package Docs
|
|
2
2
|
|
|
3
|
-
These docs are bundled with `@vercel/geistdocs` 2.
|
|
3
|
+
These docs are bundled with `@vercel/geistdocs` 2.12.0 so agents can understand the installed package without web access.
|
|
4
4
|
They are generated from `apps/template/content/docs` during the package build.
|
|
5
5
|
|
|
6
6
|
## How to use these files
|
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.12.0.
|
|
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
|
|
@@ -2161,6 +2161,9 @@ export const greeting: string = "Hello from TypeScript";
|
|
|
2161
2161
|
export const greeting = "Hello from JavaScript";
|
|
2162
2162
|
```
|
|
2163
2163
|
|
|
2164
|
+
The page's Markdown export writes each tab's label in bold before its fence, so
|
|
2165
|
+
agents can tell the examples apart.
|
|
2166
|
+
|
|
2164
2167
|
Wrap the same fences in `<CodeBlockTabs compact>` to move the selector into the
|
|
2165
2168
|
code-block header:
|
|
2166
2169
|
|
|
@@ -4299,7 +4302,7 @@ The `eveAgent` option also accepts a `url` override for pointing staging deploym
|
|
|
4299
4302
|
| `url` | `string` | `ai.eveAgent.url` | Agent base URL. Overrides `ai.eveAgent.url`; setting it here alone enables eve agent mode without exposing the URL in `geistdocs.tsx`. |
|
|
4300
4303
|
| `headers` | `HeadersInit \| (request: Request) => HeadersInit \| Promise<HeadersInit>` | OIDC headers | Extra request headers. An `authorization` header replaces the OIDC bearer token. |
|
|
4301
4304
|
| `secret` | `string` | `GEISTDOCS_CHAT_SECRET` | Secret that signs the eve session cookie, at least 32 bytes. |
|
|
4302
|
-
| `clientContext` | `boolean
|
|
4305
|
+
| `clientContext` | `boolean \| ({ currentPage }) => object \| Promise<object>` | `false` | Send the current page, or the object a function builds from it, as eve `clientContext` with every message. |
|
|
4303
4306
|
| `visibleTools` | `string[]` | All tools | Tool names whose calls the chat shows. |
|
|
4304
4307
|
| `toolCitations` | `boolean` | `true` | Forward tool outputs and show the URLs in them as source citations. |
|
|
4305
4308
|
|
|
@@ -4453,6 +4456,20 @@ The route derives `clientContext` from the `currentRoute` the Ask AI client alre
|
|
|
4453
4456
|
|
|
4454
4457
|
The agent's eve version must accept `clientContext` on its session routes; eve 0.59 does. Prewarm requests never carry `clientContext`, because eve rejects it on a session created without a message.
|
|
4455
4458
|
|
|
4459
|
+
#### Build the client context yourself
|
|
4460
|
+
|
|
4461
|
+
Pass a function instead of `true` to choose what `clientContext` carries, such as fields your agent expects next to the page. It receives `{ currentPage }`, derived the same way and unset without a usable `currentRoute`, runs for every message, and may be async:
|
|
4462
|
+
|
|
4463
|
+
```ts title="app/api/chat/route.ts"
|
|
4464
|
+
export const { POST, maxDuration } = createChatRoute({
|
|
4465
|
+
config,
|
|
4466
|
+
eveAgent: {
|
|
4467
|
+
clientContext: ({ currentPage }) => ({ surface: "docs", currentPage }),
|
|
4468
|
+
},
|
|
4469
|
+
sources: [geistdocsSource],
|
|
4470
|
+
});
|
|
4471
|
+
```
|
|
4472
|
+
|
|
4456
4473
|
### Choose which agent tool calls the chat shows
|
|
4457
4474
|
|
|
4458
4475
|
By default, the chat shows every eve tool call as an activity label, and URLs found in tool outputs become source citations. Two server-only `eveAgent` options change that:
|
package/docs/manifest.json
CHANGED
package/docs/pages/ask-ai.md
CHANGED
|
@@ -367,7 +367,7 @@ The `eveAgent` option also accepts a `url` override for pointing staging deploym
|
|
|
367
367
|
| `url` | `string` | `ai.eveAgent.url` | Agent base URL. Overrides `ai.eveAgent.url`; setting it here alone enables eve agent mode without exposing the URL in `geistdocs.tsx`. |
|
|
368
368
|
| `headers` | `HeadersInit \| (request: Request) => HeadersInit \| Promise<HeadersInit>` | OIDC headers | Extra request headers. An `authorization` header replaces the OIDC bearer token. |
|
|
369
369
|
| `secret` | `string` | `GEISTDOCS_CHAT_SECRET` | Secret that signs the eve session cookie, at least 32 bytes. |
|
|
370
|
-
| `clientContext` | `boolean
|
|
370
|
+
| `clientContext` | `boolean \| ({ currentPage }) => object \| Promise<object>` | `false` | Send the current page, or the object a function builds from it, as eve `clientContext` with every message. |
|
|
371
371
|
| `visibleTools` | `string[]` | All tools | Tool names whose calls the chat shows. |
|
|
372
372
|
| `toolCitations` | `boolean` | `true` | Forward tool outputs and show the URLs in them as source citations. |
|
|
373
373
|
|
|
@@ -521,6 +521,20 @@ The route derives `clientContext` from the `currentRoute` the Ask AI client alre
|
|
|
521
521
|
|
|
522
522
|
The agent's eve version must accept `clientContext` on its session routes; eve 0.59 does. Prewarm requests never carry `clientContext`, because eve rejects it on a session created without a message.
|
|
523
523
|
|
|
524
|
+
#### Build the client context yourself
|
|
525
|
+
|
|
526
|
+
Pass a function instead of `true` to choose what `clientContext` carries, such as fields your agent expects next to the page. It receives `{ currentPage }`, derived the same way and unset without a usable `currentRoute`, runs for every message, and may be async:
|
|
527
|
+
|
|
528
|
+
```ts title="app/api/chat/route.ts"
|
|
529
|
+
export const { POST, maxDuration } = createChatRoute({
|
|
530
|
+
config,
|
|
531
|
+
eveAgent: {
|
|
532
|
+
clientContext: ({ currentPage }) => ({ surface: "docs", currentPage }),
|
|
533
|
+
},
|
|
534
|
+
sources: [geistdocsSource],
|
|
535
|
+
});
|
|
536
|
+
```
|
|
537
|
+
|
|
524
538
|
### Choose which agent tool calls the chat shows
|
|
525
539
|
|
|
526
540
|
By default, the chat shows every eve tool call as an activity label, and URLs found in tool outputs become source citations. Two server-only `eveAgent` options change that:
|
package/docs/pages/syntax.md
CHANGED
|
@@ -525,6 +525,9 @@ export const greeting: string = "Hello from TypeScript";
|
|
|
525
525
|
export const greeting = "Hello from JavaScript";
|
|
526
526
|
```
|
|
527
527
|
|
|
528
|
+
The page's Markdown export writes each tab's label in bold before its fence, so
|
|
529
|
+
agents can tell the examples apart.
|
|
530
|
+
|
|
528
531
|
Wrap the same fences in `<CodeBlockTabs compact>` to move the selector into the
|
|
529
532
|
code-block header:
|
|
530
533
|
|
package/package.json
CHANGED
|
@@ -410,6 +410,20 @@ eve 智能体模式会把附加的页面作为开头的文本部分发送(页
|
|
|
410
410
|
|
|
411
411
|
路由根据 Ask AI 客户端已经发送的 `currentRoute` 生成 `clientContext`,客户端无需改动。`url` 是该路径(含 `basePath`)在 `siteUrl` 或请求来源上的绝对 URL,会忽略查询字符串、片段以及 `currentRoute` 中的任何来源。当路由是 Ask AI 可见的页面时,`title` 为页面标题(最多 256 个字符);否则 `currentPage` 只包含 `url`。没有 `currentRoute` 或其长度超过 2,048 个字符时,不发送 `clientContext`。发往会话 Cookie 中会话的后续消息,以及替换不再活动的会话时的第一条消息,也会携带 `clientContext`;预热请求从不携带 `clientContext`。
|
|
412
412
|
|
|
413
|
+
#### 自行构建客户端上下文
|
|
414
|
+
|
|
415
|
+
传入函数而不是 `true`,即可决定 `clientContext` 的内容,例如智能体需要与页面一起接收的字段。该函数接收 `{ currentPage }`(生成方式相同,没有可用的 `currentRoute` 时未设置),每条消息都会调用一次,并且可以是异步函数:
|
|
416
|
+
|
|
417
|
+
```ts title="app/api/chat/route.ts"
|
|
418
|
+
export const { POST, maxDuration } = createChatRoute({
|
|
419
|
+
config,
|
|
420
|
+
eveAgent: {
|
|
421
|
+
clientContext: ({ currentPage }) => ({ surface: "docs", currentPage }),
|
|
422
|
+
},
|
|
423
|
+
sources: [geistdocsSource],
|
|
424
|
+
});
|
|
425
|
+
```
|
|
426
|
+
|
|
413
427
|
### 选择聊天中显示哪些智能体工具调用
|
|
414
428
|
|
|
415
429
|
默认情况下,聊天会把每个 eve 工具调用显示为活动标签,并把工具输出中的 URL 显示为来源引用。仅在服务器端使用的 `eveAgent` 选项可以改变这一行为:
|
|
@@ -365,7 +365,7 @@ The `eveAgent` option also accepts a `url` override for pointing staging deploym
|
|
|
365
365
|
| `url` | `string` | `ai.eveAgent.url` | Agent base URL. Overrides `ai.eveAgent.url`; setting it here alone enables eve agent mode without exposing the URL in `geistdocs.tsx`. |
|
|
366
366
|
| `headers` | `HeadersInit \| (request: Request) => HeadersInit \| Promise<HeadersInit>` | OIDC headers | Extra request headers. An `authorization` header replaces the OIDC bearer token. |
|
|
367
367
|
| `secret` | `string` | `GEISTDOCS_CHAT_SECRET` | Secret that signs the eve session cookie, at least 32 bytes. |
|
|
368
|
-
| `clientContext` | `boolean
|
|
368
|
+
| `clientContext` | `boolean \| ({ currentPage }) => object \| Promise<object>` | `false` | Send the current page, or the object a function builds from it, as eve `clientContext` with every message. |
|
|
369
369
|
| `visibleTools` | `string[]` | All tools | Tool names whose calls the chat shows. |
|
|
370
370
|
| `toolCitations` | `boolean` | `true` | Forward tool outputs and show the URLs in them as source citations. |
|
|
371
371
|
|
|
@@ -519,6 +519,20 @@ The route derives `clientContext` from the `currentRoute` the Ask AI client alre
|
|
|
519
519
|
|
|
520
520
|
The agent's eve version must accept `clientContext` on its session routes; eve 0.59 does. Prewarm requests never carry `clientContext`, because eve rejects it on a session created without a message.
|
|
521
521
|
|
|
522
|
+
#### Build the client context yourself
|
|
523
|
+
|
|
524
|
+
Pass a function instead of `true` to choose what `clientContext` carries, such as fields your agent expects next to the page. It receives `{ currentPage }`, derived the same way and unset without a usable `currentRoute`, runs for every message, and may be async:
|
|
525
|
+
|
|
526
|
+
```ts title="app/api/chat/route.ts"
|
|
527
|
+
export const { POST, maxDuration } = createChatRoute({
|
|
528
|
+
config,
|
|
529
|
+
eveAgent: {
|
|
530
|
+
clientContext: ({ currentPage }) => ({ surface: "docs", currentPage }),
|
|
531
|
+
},
|
|
532
|
+
sources: [geistdocsSource],
|
|
533
|
+
});
|
|
534
|
+
```
|
|
535
|
+
|
|
522
536
|
### Choose which agent tool calls the chat shows
|
|
523
537
|
|
|
524
538
|
By default, the chat shows every eve tool call as an activity label, and URLs found in tool outputs become source citations. Two server-only `eveAgent` options change that:
|
|
@@ -529,6 +529,9 @@ export const greeting: string = "Hello from TypeScript";
|
|
|
529
529
|
export const greeting = "Hello from JavaScript";
|
|
530
530
|
```
|
|
531
531
|
|
|
532
|
+
The page's Markdown export writes each tab's label in bold before its fence, so
|
|
533
|
+
agents can tell the examples apart.
|
|
534
|
+
|
|
532
535
|
Wrap the same fences in `<CodeBlockTabs compact>` to move the selector into the
|
|
533
536
|
code-block header:
|
|
534
537
|
|
package/template/package.json
CHANGED