diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 00000000..643577df
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,9 @@
+
+
+# This is NOT the Next.js you know
+
+This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` (resolved from this file's directory; in monorepos the `next` package may not be visible from the repo root) before writing any code. Heed deprecation notices.
+
+This block is written and re-added by `next dev` — verify at `node_modules/next/dist/server/lib/generate-agent-files.js`. Removing it from a diff only re-creates the uncommitted change; committing it with your work keeps the tree clean.
+
+
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 00000000..43c994c2
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+@AGENTS.md
diff --git a/next.config.mjs b/next.config.mjs
index 186cd731..088bc5ae 100644
--- a/next.config.mjs
+++ b/next.config.mjs
@@ -1,10 +1,11 @@
/** @type {import('next').NextConfig} */
import createMDX from "@next/mdx";
-import rehypeUnwrapImages from 'rehype-unwrap-images'
-import remarkFrontmatter from 'remark-frontmatter'
-import remarkGfm from 'remark-gfm'
-import { remarkVersionSubstitution } from './scripts/remark-version-substitution.mjs'
+import { fileURLToPath } from 'node:url'
+
+const remarkVersionSubstitutionPath = fileURLToPath(
+ new URL('./scripts/remark-version-substitution.mjs', import.meta.url)
+)
const nextConfig = {
pageExtensions: ['js', 'jsx', 'md', 'mdx', 'ts', 'tsx'],
@@ -29,6 +30,18 @@ const nextConfig = {
});
return config;
},
+ turbopack: {
+ rules: {
+ '*.yaml': {
+ loaders: ['yaml-loader'],
+ as: '*.js',
+ },
+ '*.yml': {
+ loaders: ['yaml-loader'],
+ as: '*.js',
+ },
+ },
+ },
images: {
remotePatterns: [
{
@@ -42,8 +55,9 @@ const nextConfig = {
const withMDX = createMDX({
options: {
- remarkPlugins: [remarkFrontmatter, remarkGfm, remarkVersionSubstitution],
- rehypePlugins: [rehypeUnwrapImages],
+ // Turbopack requires serializable options: plugins as name/path strings
+ remarkPlugins: ['remark-frontmatter', 'remark-gfm', remarkVersionSubstitutionPath],
+ rehypePlugins: ['rehype-unwrap-images'],
},
})
diff --git a/package-lock.json b/package-lock.json
index e02ec976..7c198601 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -12,8 +12,8 @@
"@heroicons/react": "^2.2.0",
"@mdx-js/loader": "^3.1.1",
"@mdx-js/react": "^3.1.1",
- "@next/mdx": "^15.5.4",
- "@next/third-parties": "^15.5.4",
+ "@next/mdx": "^16.3.0",
+ "@next/third-parties": "^16.3.0",
"@radix-ui/react-dropdown-menu": "^2.1.16",
"@radix-ui/react-separator": "^1.1.7",
"@radix-ui/react-slot": "^1.2.3",
@@ -3525,9 +3525,9 @@
}
},
"node_modules/@next/mdx": {
- "version": "15.5.12",
- "resolved": "https://registry.npmjs.org/@next/mdx/-/mdx-15.5.12.tgz",
- "integrity": "sha512-XXQcGERYHrC41rJXzd8kqEhsjeQ1r5N+eUxA+gcl8COapdVqI7iZjT4Npz6D845/txFTtechafx/+s8RZxO2aw==",
+ "version": "16.3.0",
+ "resolved": "https://registry.npmjs.org/@next/mdx/-/mdx-16.3.0.tgz",
+ "integrity": "sha512-Vpfuf928ACvx4AOdDXWx/cj13Ak6xlvMn3QCkjvfQMmLnQWCesQTeY01CPDbIyZvjY+NOwP7bvbvJ2ghkj/3GA==",
"license": "MIT",
"dependencies": {
"source-map": "^0.7.0"
@@ -3674,15 +3674,15 @@
}
},
"node_modules/@next/third-parties": {
- "version": "15.5.12",
- "resolved": "https://registry.npmjs.org/@next/third-parties/-/third-parties-15.5.12.tgz",
- "integrity": "sha512-1wVoarmu7CHc2+lhHdMHqfenbIopkppTscgyVym6eUD78JBDp1VCYQif+LiSUKJL2xMUwN8GvnAqsSrDTamvtg==",
+ "version": "16.3.0",
+ "resolved": "https://registry.npmjs.org/@next/third-parties/-/third-parties-16.3.0.tgz",
+ "integrity": "sha512-cAA96hSI9NC7083b6sEsKjgyvM/YJ2eqXs4HWv8a/z5LE12CL1sUJS+cmcTwNMY4yAFpLyyuZHrMBEfh/4Xupw==",
"license": "MIT",
"dependencies": {
"third-party-capital": "1.0.20"
},
"peerDependencies": {
- "next": "^13.0.0 || ^14.0.0 || ^15.0.0",
+ "next": "^13.0.0 || ^14.0.0 || ^15.0.0 || ^16.0.0-beta.0",
"react": "^18.2.0 || 19.0.0-rc-de68d2f4-20241204 || ^19.0.0"
}
},
diff --git a/package.json b/package.json
index ca865238..8c9e0641 100644
--- a/package.json
+++ b/package.json
@@ -21,8 +21,8 @@
"@heroicons/react": "^2.2.0",
"@mdx-js/loader": "^3.1.1",
"@mdx-js/react": "^3.1.1",
- "@next/mdx": "^15.5.4",
- "@next/third-parties": "^15.5.4",
+ "@next/mdx": "^16.3.0",
+ "@next/third-parties": "^16.3.0",
"@radix-ui/react-dropdown-menu": "^2.1.16",
"@radix-ui/react-separator": "^1.1.7",
"@radix-ui/react-slot": "^1.2.3",
diff --git a/public/sitemap.xml b/public/sitemap.xml
index 31d3a805..43410bc1 100644
--- a/public/sitemap.xml
+++ b/public/sitemap.xml
@@ -2,847 +2,847 @@
https://kagent.dev/agents
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/blog
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/community
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/concepts/agent-harness
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/concepts/agent-memory
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/concepts/agent-substrate
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/concepts/agents
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/concepts/architecture
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/concepts/mcp-apps
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/concepts
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/concepts/tools
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/examples/a2a-agents
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/examples/a2a-byo
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/examples/agent-harness
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/examples/agent-substrate
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/examples/agentgateway
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/examples/agents-mcp
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/examples/crewai-byo
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/examples/discord-a2a
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/examples/documentation
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/examples/human-in-the-loop
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/examples/langchain-byo
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/examples
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/examples/skills
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/examples/slack-a2a
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/examples/telegram-bot
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/getting-started/first-agent
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/getting-started/first-mcp-tool
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/getting-started/local-development
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/getting-started
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/getting-started/quickstart
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/getting-started/system-prompts
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/introduction/features
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/introduction/installation
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/introduction
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/introduction/what-is-kagent
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/observability/audit-prompts
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/observability/launch-ui
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/observability
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/observability/tracing
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/operations/debug
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/operations/operational-considerations
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/operations
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/operations/uninstall
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/operations/upgrade
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/resources/api-ref
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/resources/cli/kagent-add-mcp
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/resources/cli/kagent-bug-report
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/resources/cli/kagent-build
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/resources/cli/kagent-completion
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/resources/cli/kagent-dashboard
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/resources/cli/kagent-deploy
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/resources/cli/kagent-get
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/resources/cli/kagent-help
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/resources/cli/kagent-init
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/resources/cli/kagent-install
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/resources/cli/kagent-invoke
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/resources/cli/kagent-mcp
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/resources/cli/kagent-run
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/resources/cli/kagent-uninstall
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/resources/cli/kagent-version
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/resources/cli
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/resources/faq
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/resources/helm
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/resources
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/resources/release-notes
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/resources/tools-ecosystem
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/supported-providers/amazon-bedrock
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/supported-providers/anthropic
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/supported-providers/azure-openai
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/supported-providers/byo-openai
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/supported-providers/gemini
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/supported-providers/google-vertexai
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/supported-providers/ollama
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/supported-providers/openai
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/supported-providers
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/supported-providers/sap-ai-core
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kagent/supported-providers/xai
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kmcp/deploy/install-controller
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kmcp/deploy
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kmcp/deploy/server
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kmcp/develop/fastmcp-python
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kmcp/develop/mcp-go
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kmcp/develop
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kmcp/introduction
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kmcp
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kmcp/quickstart
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kmcp/reference/api-ref
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kmcp/reference/kmcp-add-tool
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kmcp/reference/kmcp-build
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kmcp/reference/kmcp-completion
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kmcp/reference/kmcp-deploy
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kmcp/reference/kmcp-help
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kmcp/reference/kmcp-init
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kmcp/reference/kmcp-install
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kmcp/reference/kmcp-run
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kmcp/reference/kmcp-secrets
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kmcp/reference
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs/kmcp/secrets
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/docs
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/enterprise
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/page.tsx
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/tools
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/agents/argo-rollouts-conversion-agent
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/agents/cilium-crd-agent
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/agents/helm-agent
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/agents/istio-agent
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/agents/k8s-agent
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/agents/kgateway-agent
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/agents/observability-agent
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/agents/promql-agent
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/tools/istio
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/tools/kubernetes
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/tools/prometheus
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/tools/documentation
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/tools/helm
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/tools/argo
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/tools/grafana
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/tools/other
- 2026-07-13
+ 2026-08-05
weekly
0.8
https://kagent.dev/tools/cilium
- 2026-07-13
+ 2026-08-05
weekly
0.8
diff --git a/scripts/remark-version-substitution.mjs b/scripts/remark-version-substitution.mjs
index 5e9cdefb..66de256c 100644
--- a/scripts/remark-version-substitution.mjs
+++ b/scripts/remark-version-substitution.mjs
@@ -31,3 +31,6 @@ export function remarkVersionSubstitution() {
});
};
}
+
+// Default export so @next/mdx can load this plugin from a path string (Turbopack)
+export default remarkVersionSubstitution;
diff --git a/tsconfig.json b/tsconfig.json
index 7a514498..6d4174e7 100644
--- a/tsconfig.json
+++ b/tsconfig.json
@@ -1,7 +1,11 @@
{
"compilerOptions": {
"target": "ES2017",
- "lib": ["dom", "dom.iterable", "esnext"],
+ "lib": [
+ "dom",
+ "dom.iterable",
+ "esnext"
+ ],
"allowJs": true,
"skipLibCheck": true,
"strict": true,
@@ -11,7 +15,7 @@
"moduleResolution": "bundler",
"resolveJsonModule": true,
"isolatedModules": true,
- "jsx": "preserve",
+ "jsx": "react-jsx",
"incremental": true,
"plugins": [
{
@@ -19,9 +23,20 @@
}
],
"paths": {
- "@/*": ["./src/*"]
+ "@/*": [
+ "./src/*"
+ ]
}
},
- "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts", "next.config.mjs"],
- "exclude": ["node_modules"]
+ "include": [
+ "next-env.d.ts",
+ "**/*.ts",
+ "**/*.tsx",
+ ".next/types/**/*.ts",
+ "next.config.mjs",
+ ".next/dev/types/**/*.ts"
+ ],
+ "exclude": [
+ "node_modules"
+ ]
}