[{"data":1,"prerenderedAt":478},["ShallowReactive",2],{"docs:\u002Fdocs\u002Fupgrade":3,"docs:navigation":356,"docs:surround:\u002Fdocs\u002Fupgrade":473},{"id":4,"title":5,"body":6,"description":347,"extension":348,"meta":349,"navigation":350,"navigationTitle":351,"path":352,"seo":353,"stem":354,"__hash__":355},"docs\u002Fdocs\u002F5.upgrade.md","Upgrading",{"type":7,"value":8,"toc":343},"minimark",[9,14,18,47,50,70,73,85,88,100,103,110,113,117,120,273,276,339],[10,11,13],"h2",{"id":12},"to-a-new-release","To a new release",[15,16,17],"p",{},"Run the upgrade command from your project root. It updates Nuxt Agentic packages together and\napplies codemods for the releases between your current version and the target:",[19,20,25],"pre",{"className":21,"code":22,"language":23,"meta":24,"style":24},"language-bash shiki shiki-themes github-dark-default","pnpm exec agentic upgrade\n","bash","",[26,27,28],"code",{"__ignoreMap":24},[29,30,33,37,41,44],"span",{"class":31,"line":32},"line",1,[29,34,36],{"class":35},"sQhOw","pnpm",[29,38,40],{"class":39},"s9uIt"," exec",[29,42,43],{"class":39}," agentic",[29,45,46],{"class":39}," upgrade\n",[15,48,49],{},"To install a specific version, pass it as an argument:",[19,51,53],{"className":21,"code":52,"language":23,"meta":24,"style":24},"pnpm exec agentic upgrade 1.2.0\n",[26,54,55],{"__ignoreMap":24},[29,56,57,59,61,63,66],{"class":31,"line":32},[29,58,36],{"class":35},[29,60,40],{"class":39},[29,62,43],{"class":39},[29,64,65],{"class":39}," upgrade",[29,67,69],{"class":68},"sFSAA"," 1.2.0\n",[15,71,72],{},"Generate the migration:",[19,74,76],{"className":21,"code":75,"language":23,"meta":24,"style":24},"pnpm db:generate\n",[26,77,78],{"__ignoreMap":24},[29,79,80,82],{"class":31,"line":32},[29,81,36],{"class":35},[29,83,84],{"class":39}," db:generate\n",[15,86,87],{},"Review the generated migration, then apply it:",[19,89,91],{"className":21,"code":90,"language":23,"meta":24,"style":24},"pnpm db:migrate\n",[26,92,93],{"__ignoreMap":24},[29,94,95,97],{"class":31,"line":32},[29,96,36],{"class":35},[29,98,99],{"class":39}," db:migrate\n",[15,101,102],{},"The command reinstalls dependencies and prints a comparison of the starter between versions.\nReview that comparison and copy any template changes your app needs.",[15,104,105,106,109],{},"All ",[26,107,108],{},"@nuxtagentic-pro\u002F*"," packages share one version. Breaking changes only ship in major\nreleases, with codemods and release notes.",[15,111,112],{},"Your license includes the releases published during its update window. Releases published after\nthe window ends are not offered; versions you could install before stay available.",[10,114,116],{"id":115},"from-the-free-module-to-pro","From the free module to Pro",[15,118,119],{},"Your agents and tools move unchanged.",[121,122,123,133,170,245],"ol",{},[124,125,126,127,132],"li",{},"Set up the private registry with your license key, as in\n",[128,129,131],"a",{"href":130},"\u002Fdocs\u002Fgetting-started\u002Fnuxt","Getting started",".",[124,134,135,136],{},"Install the layer and the CLI:",[19,137,139],{"className":21,"code":138,"language":23,"meta":24,"style":24},"pnpm add @nuxtagentic-pro\u002Fnuxt\npnpm add -D @nuxtagentic-pro\u002Fcli wrangler drizzle-kit\n",[26,140,141,151],{"__ignoreMap":24},[29,142,143,145,148],{"class":31,"line":32},[29,144,36],{"class":35},[29,146,147],{"class":39}," add",[29,149,150],{"class":39}," @nuxtagentic-pro\u002Fnuxt\n",[29,152,154,156,158,161,164,167],{"class":31,"line":153},2,[29,155,36],{"class":35},[29,157,147],{"class":39},[29,159,160],{"class":68}," -D",[29,162,163],{"class":39}," @nuxtagentic-pro\u002Fcli",[29,165,166],{"class":39}," wrangler",[29,168,169],{"class":39}," drizzle-kit\n",[124,171,172,173],{},"Extend the layer, keep the free module and build for Cloudflare:",[19,174,179],{"className":175,"code":176,"filename":177,"language":178,"meta":24,"style":24},"language-ts shiki shiki-themes github-dark-default","export default defineNuxtConfig({\n  extends: ['@nuxtagentic-pro\u002Fnuxt'],\n  modules: ['@nuxtagentic\u002Fnuxt'],\n  nitro: { preset: 'cloudflare-module' },\n})\n","nuxt.config.ts","ts",[26,180,181,197,212,225,239],{"__ignoreMap":24},[29,182,183,187,190,194],{"class":31,"line":32},[29,184,186],{"class":185},"suJrU","export",[29,188,189],{"class":185}," default",[29,191,193],{"class":192},"sc3cj"," defineNuxtConfig",[29,195,196],{"class":35},"({\n",[29,198,199,203,206,209],{"class":31,"line":153},[29,200,202],{"class":201},"sZEs4","  extends: [",[29,204,205],{"class":39},"'@nuxtagentic-pro\u002Fnuxt'",[29,207,208],{"class":201},"]",[29,210,211],{"class":35},",\n",[29,213,215,218,221,223],{"class":31,"line":214},3,[29,216,217],{"class":201},"  modules: [",[29,219,220],{"class":39},"'@nuxtagentic\u002Fnuxt'",[29,222,208],{"class":201},[29,224,211],{"class":35},[29,226,228,231,234,237],{"class":31,"line":227},4,[29,229,230],{"class":201},"  nitro: { preset: ",[29,232,233],{"class":39},"'cloudflare-module'",[29,235,236],{"class":201}," }",[29,238,211],{"class":35},[29,240,242],{"class":31,"line":241},5,[29,243,244],{"class":35},"})\n",[124,246,247,248,211,251,254,255,258,259,262,263,254,266,269,270,132],{},"Add the database, auth secret and Cloudflare bindings. Copy ",[26,249,250],{},"wrangler.jsonc",[26,252,253],{},"drizzle.config.ts",", ",[26,256,257],{},"server\u002Fdatabase\u002Fschema.ts"," and the ",[26,260,261],{},"db:*"," scripts from the Nuxt starter,\nthen run ",[26,264,265],{},"pnpm exec agentic keygen",[26,267,268],{},"pnpm db:generate"," and ",[26,271,272],{},"pnpm db:migrate",[15,274,275],{},"What changes:",[277,278,279,288,294,310,328],"ul",{},[124,280,281,269,284,287],{},[26,282,283],{},"server\u002Fagents",[26,285,286],{},"server\u002Ftools"," stay where they are and also appear in the dashboard.",[124,289,290,293],{},[26,291,292],{},"useAgent()"," keeps calling the same endpoint, which now requires a signed-in user.",[124,295,296,297,254,300,269,303,306,307,132],{},"Tool handlers also receive ",[26,298,299],{},"actor",[26,301,302],{},"database",[26,304,305],{},"env"," next to ",[26,308,309],{},"signal",[124,311,312,313,254,316,319,320,323,324,327],{},"Provider keys come from the Worker environment: ",[26,314,315],{},"OPENAI_API_KEY",[26,317,318],{},"ANTHROPIC_API_KEY"," and\n",[26,321,322],{},"GOOGLE_AI_API_KEY"," instead of the ",[26,325,326],{},"NUXT_AGENTIC_*"," variables.",[124,329,330,331,334,335,132],{},"For runs that survive a reload and pause for approval, switch pages to ",[26,332,333],{},"useDurableAgent()",".\nSee ",[128,336,338],{"href":337},"\u002Fdocs\u002Fguides\u002Fagents","Agents",[340,341,342],"style",{},"html pre.shiki code .sQhOw, html code.shiki .sQhOw{--shiki-default:#FFA657}html pre.shiki code .s9uIt, html code.shiki .s9uIt{--shiki-default:#A5D6FF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html pre.shiki code .sFSAA, html code.shiki .sFSAA{--shiki-default:#79C0FF}html pre.shiki code .suJrU, html code.shiki .suJrU{--shiki-default:#FF7B72}html pre.shiki code .sc3cj, html code.shiki .sc3cj{--shiki-default:#D2A8FF}html pre.shiki code .sZEs4, html code.shiki .sZEs4{--shiki-default:#E6EDF3}",{"title":24,"searchDepth":153,"depth":153,"links":344},[345,346],{"id":12,"depth":153,"text":13},{"id":115,"depth":153,"text":116},"Update to a new release or move from the free module to Pro.","md",{},{"title":5},null,"\u002Fdocs\u002Fupgrade",{"title":5,"description":347},"docs\u002F5.upgrade","4pBT6yIGAq1juEhNjhjgm4B3Bbm7jSaG0o7JYBEYVVI",[357],{"title":358,"path":359,"stem":360,"children":361,"navigationTitle":351},"Introduction","\u002Fdocs","docs\u002F0.index",[362,363,380,384,435,439,440,469],{"title":358,"path":359,"stem":360,"navigationTitle":351},{"title":364,"path":365,"stem":366,"children":367,"page":379},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started",[368,372,375],{"title":369,"path":370,"stem":371,"navigationTitle":351},"Free module","\u002Fdocs\u002Fgetting-started\u002Ffree","docs\u002F1.getting-started\u002F1.free",{"title":373,"path":130,"stem":374,"navigationTitle":351},"Pro on Nuxt","docs\u002F1.getting-started\u002F2.nuxt",{"title":376,"path":377,"stem":378,"navigationTitle":351},"Pro on Void","\u002Fdocs\u002Fgetting-started\u002Fvoid","docs\u002F1.getting-started\u002F3.void",false,{"title":381,"path":382,"stem":383,"navigationTitle":351},"Concepts","\u002Fdocs\u002Fconcepts","docs\u002F2.concepts",{"title":385,"path":386,"stem":387,"children":388,"page":379},"Guides","\u002Fdocs\u002Fguides","docs\u002F3.guides",[389,391,395,399,403,407,411,415,419,423,427,431],{"title":338,"path":337,"stem":390,"navigationTitle":351},"docs\u002F3.guides\u002F1.agents",{"title":392,"path":393,"stem":394,"navigationTitle":351},"Events","\u002Fdocs\u002Fguides\u002Fevents","docs\u002F3.guides\u002F10.events",{"title":396,"path":397,"stem":398,"navigationTitle":351},"Features","\u002Fdocs\u002Fguides\u002Ffeatures","docs\u002F3.guides\u002F11.features",{"title":400,"path":401,"stem":402,"navigationTitle":351},"Coding agents","\u002Fdocs\u002Fguides\u002Fcoding-agents","docs\u002F3.guides\u002F12.coding-agents",{"title":404,"path":405,"stem":406,"navigationTitle":351},"Tools","\u002Fdocs\u002Fguides\u002Ftools","docs\u002F3.guides\u002F2.tools",{"title":408,"path":409,"stem":410,"navigationTitle":351},"Automations","\u002Fdocs\u002Fguides\u002Fautomations","docs\u002F3.guides\u002F3.automations",{"title":412,"path":413,"stem":414,"navigationTitle":351},"Agentic Models","\u002Fdocs\u002Fguides\u002Fagentic-models","docs\u002F3.guides\u002F4.agentic-models",{"title":416,"path":417,"stem":418,"navigationTitle":351},"Outcomes","\u002Fdocs\u002Fguides\u002Foutcomes","docs\u002F3.guides\u002F5.outcomes",{"title":420,"path":421,"stem":422,"navigationTitle":351},"Integrations","\u002Fdocs\u002Fguides\u002Fintegrations","docs\u002F3.guides\u002F6.integrations",{"title":424,"path":425,"stem":426,"navigationTitle":351},"Prompt","\u002Fdocs\u002Fguides\u002Fprompt","docs\u002F3.guides\u002F7.prompt",{"title":428,"path":429,"stem":430,"navigationTitle":351},"Server logic","\u002Fdocs\u002Fguides\u002Fserver-logic","docs\u002F3.guides\u002F8.server-logic",{"title":432,"path":433,"stem":434,"navigationTitle":351},"Dashboard UI","\u002Fdocs\u002Fguides\u002Fui","docs\u002F3.guides\u002F9.ui",{"title":436,"path":437,"stem":438,"navigationTitle":351},"Deploy to Cloudflare","\u002Fdocs\u002Fdeploy","docs\u002F4.deploy",{"title":5,"path":352,"stem":354,"navigationTitle":351},{"title":441,"path":442,"stem":443,"children":444,"page":379},"Reference","\u002Fdocs\u002Freference","docs\u002F6.reference",[445,449,453,457,461,465],{"title":446,"path":447,"stem":448,"navigationTitle":351},"Configuration","\u002Fdocs\u002Freference\u002Fconfiguration","docs\u002F6.reference\u002F1.configuration",{"title":450,"path":451,"stem":452,"navigationTitle":351},"Composables","\u002Fdocs\u002Freference\u002Fcomposables","docs\u002F6.reference\u002F2.composables",{"title":454,"path":455,"stem":456,"navigationTitle":351},"Server utilities","\u002Fdocs\u002Freference\u002Fserver-utils","docs\u002F6.reference\u002F3.server-utils",{"title":458,"path":459,"stem":460,"navigationTitle":351},"Services","\u002Fdocs\u002Freference\u002Fservices","docs\u002F6.reference\u002F4.services",{"title":462,"path":463,"stem":464,"navigationTitle":351},"REST API","\u002Fdocs\u002Freference\u002Frest-api","docs\u002F6.reference\u002F5.rest-api",{"title":466,"path":467,"stem":468,"navigationTitle":351},"CLI","\u002Fdocs\u002Freference\u002Fcli","docs\u002F6.reference\u002F6.cli",{"title":470,"path":471,"stem":472,"navigationTitle":351},"Licensing & FAQ","\u002Fdocs\u002Flicensing","docs\u002F8.licensing",[474,476],{"title":436,"path":437,"stem":438,"description":475,"children":-1},"Ship a Pro app to Cloudflare Workers with D1, R2, Durable Objects and a maintenance cron.",{"title":446,"path":447,"stem":448,"description":477,"children":-1},"Nuxt module options, defineNuxtAgentic, the Void plugin, defineVoidAgentic and environment variables.",1792672479670]