docs: promote Agent-Native from experimental to stable

Author: antfubot

docs/.vitepress/config.ts

@@ -58,10 +58,15 @@ function guideGroups(prefix: string) {
       ],
     },
     {
-      text: 'Recipes & Advanced',
+      text: 'Agent-Native',
+      items: [
+        { text: 'Agent-Native', link: `${prefix}/guide/agent-native` },
+      ],
+    },
+    {
+      text: 'Recipes',
       items: [
         { text: 'Standalone CLI', link: `${prefix}/guide/standalone-cli` },
-        { text: 'Agent-Native (experimental)', link: `${prefix}/guide/agent-native` },
       ],
     },
   ] satisfies { text: string, items: DefaultTheme.NavItemWithLink[] }[]

docs/adapters/cac.md

@@ -35,7 +35,7 @@ my-devframe                     # dev server at http://localhost:9999/
 my-devframe --port 8080
 my-devframe build --out-dir dist-static
 my-devframe build --out-dir dist-static --base /devframe/
-my-devframe mcp                 # stdio MCP server (experimental)
+my-devframe mcp                 # stdio MCP server
 ```
 
 Standalone CLI serves the SPA at `/` by default. The `/__devframe/` prefix is for *hosted* adapters where devframe mounts alongside an existing app — see [Mount paths](./#mount-paths).

docs/adapters/mcp.md

@@ -4,9 +4,6 @@ outline: deep
 
 # MCP
 
-> [!WARNING] Experimental
-> The agent-native surface is experimental and may change without a major version bump.
-
 Translates a devframe's agent host into a [Model Context Protocol](https://modelcontextprotocol.io) server so coding agents (Claude Desktop, Cursor, Zed, Claude Code) can call flagged RPCs and read exposed resources.
 
 ```ts

docs/errors/DF0014.md

@@ -4,10 +4,6 @@ outline: deep
 
 # DF0014: Invalid Agent Field
 
-::: warning Experimental
-The agent-native surface is experimental and may change without a major version bump until it stabilizes.
-:::
-
 ## Message
 
 > RPC function "`{name}`" has an invalid `agent` field — `description` must be a non-empty string.

docs/errors/DF0015.md

@@ -4,10 +4,6 @@ outline: deep
 
 # DF0015: Agent Tool Already Registered
 
-::: warning Experimental
-The agent-native surface is experimental and may change without a major version bump until it stabilizes.
-:::
-
 ## Message
 
 > Agent tool "`{id}`" is already registered.

docs/errors/DF0016.md

@@ -4,10 +4,6 @@ outline: deep
 
 # DF0016: Agent Resource Already Registered
 
-::: warning Experimental
-The agent-native surface is experimental and may change without a major version bump until it stabilizes.
-:::
-
 ## Message
 
 > Agent resource "`{id}`" is already registered.

docs/errors/DF0017.md

@@ -4,10 +4,6 @@ outline: deep
 
 # DF0017: MCP Server Start Failure
 
-::: warning Experimental
-The agent-native surface is experimental and may change without a major version bump until it stabilizes.
-:::
-
 ## Message
 
 > Failed to start MCP server (`{transport}`): `{reason}`

docs/guide/agent-native.md

@@ -4,10 +4,6 @@ outline: deep
 
 # Agent-Native Devframe
 
-::: warning Experimental
-The agent-native surface (`agent` field on `defineRpcFunction`, `DevframeAgentHost`, and the `devframe/adapters/mcp` adapter) is experimental and may change without a major version bump until it stabilizes.
-:::
-
 Devframe can expose the same surface a browser UI consumes — RPC functions, resources, and shared state — to coding agents (Claude Desktop / Cursor / Zed / Claude Code, or any MCP-speaking client). Agent exposure is opt-in per function; functions stay private by default.
 
 ## How it works

docs/guide/devframe-definition.md

@@ -111,7 +111,7 @@ interface DevframeNodeContext {
   rpc: RpcFunctionsHost // register + broadcast + sharedState
   views: DevframeViewHost // static file hosting (`hostStatic`)
   diagnostics: DevframeDiagnosticsHost
-  agent: DevframeAgentHost // experimental
+  agent: DevframeAgentHost // expose tools + resources to coding agents
   services: DevframeServicesHost // typed cross-plugin service registry
 
   scope: (id) => DevframeScopedNodeContext // namespaced view (preferred)

docs/guide/index.md

@@ -81,7 +81,7 @@ Run it:
 ```sh
 node ./my-devframe.js        # dev server on http://localhost:9999/
 node ./my-devframe.js build  # self-contained static deploy in dist-static/
-node ./my-devframe.js mcp    # stdio MCP server (experimental)
+node ./my-devframe.js mcp    # stdio MCP server
 ```
 
 The CLI adapter serves the SPA at `/` by default. When the same devframe is embedded inside a host (`vite`, `embedded`), the default becomes `/.my-devframe/`. Override either side via `defineDevframe({ basePath })`.