Merge branch 'main' into codewizard-logo

Signed-off-by: Peter Jausovec <peterj@users.noreply.github.com>

Author: peterj

.github/workflows/update-ref-docs.yaml

@@ -41,9 +41,9 @@ jobs:
 
       - name: Verify API directory exists
         run: |
-          if [ ! -d "$GITHUB_WORKSPACE/kagent/go/controller/api/v1alpha2" ]; then
-            echo "Error: API directory not found at $GITHUB_WORKSPACE/kagent/go/controller/api/v1alpha2"
-            ls -la "$GITHUB_WORKSPACE/kagent/go/controller/api/"
+          if [ ! -d "$GITHUB_WORKSPACE/kagent/go/api/v1alpha2" ]; then
+            echo "Error: API directory not found at $GITHUB_WORKSPACE/kagent/go/api/v1alpha2"
+            ls -la "$GITHUB_WORKSPACE/kagent/go/api/"
             exit 1
           fi
           echo "API directory found and verified"
@@ -75,7 +75,7 @@ jobs:
 
           # Generate API docs
           go run github.com/elastic/crd-ref-docs@v0.1.0 \
-            --source-path="$GITHUB_WORKSPACE/kagent/go/controller/api/v1alpha2/" \
+            --source-path="$GITHUB_WORKSPACE/kagent/go/api/v1alpha2/" \
             --renderer=markdown \
             --output-path ./ \
             --config=crd-ref-docs-config.yaml
@@ -91,13 +91,13 @@ jobs:
 
           # Create index file with frontmatter
           echo '---' > src/app/docs/kagent/resources/api-ref/page.mdx
-          echo 'title: "API Reference"' >> src/app/docs/kagent/resources/api-ref/page.mdx
-          echo 'sectionOrder: 1' >> src/app/docs/kagent/resources/api-ref/page.mdx
+          echo 'title: "API docs"' >> src/app/docs/kagent/resources/api-ref/page.mdx
+          echo 'pageOrder: 1' >> src/app/docs/kagent/resources/api-ref/page.mdx
           echo 'description: "kagent API reference documentation"' >> src/app/docs/kagent/resources/api-ref/page.mdx
           echo '---' >> src/app/docs/kagent/resources/api-ref/page.mdx
           echo '' >> src/app/docs/kagent/resources/api-ref/page.mdx
           echo 'export const metadata = {' >> src/app/docs/kagent/resources/api-ref/page.mdx
-          echo '  title: "API Reference",' >> src/app/docs/kagent/resources/api-ref/page.mdx
+          echo '  title: "API docs",' >> src/app/docs/kagent/resources/api-ref/page.mdx
           echo '  description: "kagent API reference documentation",' >> src/app/docs/kagent/resources/api-ref/page.mdx
           echo '  author: "kagent.dev"' >> src/app/docs/kagent/resources/api-ref/page.mdx
           echo '};' >> src/app/docs/kagent/resources/api-ref/page.mdx
@@ -107,13 +107,28 @@ jobs:
           # Remove temporary file
           rm -f "./out.md"
 
+          # Fix problematic angle brackets in the generated MDX file
+          # Convert literal angle brackets to HTML entities to prevent MDX parsing errors
+          # But preserve legitimate HTML tags like <br />, <kagent-controller-ip>, etc.
+          echo "Fixing problematic angle brackets in generated MDX..."
+          
+          # First, temporarily replace legitimate HTML tags with placeholders
+          sed -i 's/<br \/>/__BR_TAG__/g' "src/app/docs/kagent/resources/api-ref/page.mdx"
+          
+          # Convert remaining angle brackets to HTML entities
+          sed -i 's/</\&lt;/g' "src/app/docs/kagent/resources/api-ref/page.mdx"
+          sed -i 's/>/\&gt;/g' "src/app/docs/kagent/resources/api-ref/page.mdx"
+          
+          # Restore legitimate HTML tags
+          sed -i 's/__BR_TAG__/<br \/>/g' "src/app/docs/kagent/resources/api-ref/page.mdx"
+          
           # Verify the output file was created
           if [ ! -f "src/app/docs/kagent/resources/api-ref/page.mdx" ]; then
             echo "Error: Failed to create API docs page"
             exit 1
           fi
 
-          echo "API docs generated successfully"
+          echo "API docs generated and processed successfully"
 
       - name: Generate Helm Chart Reference
         run: |
@@ -135,22 +150,94 @@ jobs:
 
             echo "Processing kagent Helm chart..."
 
+            echo "Chart directory contents:"
+            ls -la "$GITHUB_WORKSPACE/kagent/helm/kagent/"
+            
+            # Generate Chart.yaml from template for helm-docs to work
+            echo "Generating Chart.yaml from template..."
+            cd "$GITHUB_WORKSPACE/kagent/helm/kagent"
+            
+            # Get the version from git or use a default
+            VERSION=$(git describe --tags --abbrev=0 2>/dev/null | sed 's/^v//' || echo "0.5.5")
+            echo "Using version: $VERSION"
+            
+            # Copy template and substitute version
+            cp Chart-template.yaml Chart.yaml
+            sed -i "s/\${VERSION}/$VERSION/g" Chart.yaml
+            
+            echo "Generated Chart.yaml contents:"
+            cat Chart.yaml
+            
+            # Go back to website directory
+            cd "$GITHUB_WORKSPACE/website"
+            
+            echo "Chart.yaml contents:"
+            cat "$GITHUB_WORKSPACE/kagent/helm/kagent/Chart.yaml" || echo "Chart.yaml not found!"
+            
+            echo "Values.yaml contents (first 20 lines):"
+            head -20 "$GITHUB_WORKSPACE/kagent/helm/kagent/values.yaml" || echo "values.yaml not found!"
+            
+            # Generate the helm documentation
+            echo "Running helm-docs..."
+            
+            # Debug: Show all available paths
+            echo "Available paths:"
+            echo "GITHUB_WORKSPACE: $GITHUB_WORKSPACE"
+            echo "Current directory: $PWD"
+            echo "kagent repo path: $GITHUB_WORKSPACE/kagent"
+            echo "kagent helm path: $GITHUB_WORKSPACE/kagent/helm"
+            echo "kagent chart path: $GITHUB_WORKSPACE/kagent/helm/kagent"
+            
+            # List all helm directories to see what's available
+            echo "All helm directories:"
+            find "$GITHUB_WORKSPACE/kagent/helm" -name "Chart.yaml" -type f 2>/dev/null | head -10
+            
+            # Check if the specific chart directory exists and what's in it
+            echo "Checking chart directory:"
+            if [ -d "$GITHUB_WORKSPACE/kagent/helm/kagent" ]; then
+              echo "Chart directory exists"
+              ls -la "$GITHUB_WORKSPACE/kagent/helm/kagent/"
+              echo "Chart.yaml exists: $([ -f "$GITHUB_WORKSPACE/kagent/helm/kagent/Chart.yaml" ] && echo "YES" || echo "NO")"
+              echo "Values.yaml exists: $([ -f "$GITHUB_WORKSPACE/kagent/helm/kagent/values.yaml" ] && echo "YES" || echo "NO")"
+            else
+              echo "Chart directory does NOT exist"
+            fi
+            
             # Generate the helm documentation
             go run github.com/norwoodj/helm-docs/cmd/helm-docs@v1.14.2 \
               --chart-search-root "$GITHUB_WORKSPACE/kagent/helm/kagent" \
               --dry-run > "src/app/docs/kagent/resources/helm/temp.mdx"
+            
+            # Go back to website directory
+            cd "$GITHUB_WORKSPACE/website"
+
+            echo "Generated helm-docs output (first 50 lines):"
+            head -50 "src/app/docs/kagent/resources/helm/temp.mdx"
+            
+            echo "Generated helm-docs output (last 50 lines):"
+            tail -50 "src/app/docs/kagent/resources/helm/temp.mdx"
+            
+            echo "Total lines generated:"
+            wc -l "src/app/docs/kagent/resources/helm/temp.mdx"
 
             # Remove badge line and following empty line 
             # (might be replaced by helm docs template in the future)
             sed -i '/!\[Version:/,/^$/d' "src/app/docs/kagent/resources/helm/temp.mdx"
 
-            # Remove backticks from the Default column in the table
-            sed -i 's/| `\([^`]*\)` |/| \1 |/g' "src/app/docs/kagent/resources/helm/temp.mdx"
+            # Wrap the KMCP version placeholder in inline code so it shows literally in MDX
+            python - <<'PY'
+            from pathlib import Path
+            
+            path = Path("src/app/docs/kagent/resources/helm/temp.mdx")
+            text = path.read_text()
+            text = text.replace("${KMCP_VERSION}", "`" + "${KMCP_VERSION}" + "`")
+            path.write_text(text)
+            PY
 
             # Add frontmatter
             echo '---' > "src/app/docs/kagent/resources/helm/page.mdx"
             echo 'title: "Helm Chart Configuration"' >> "src/app/docs/kagent/resources/helm/page.mdx"
-            echo 'sectionOrder: 2' >> "src/app/docs/kagent/resources/helm/page.mdx"
+            echo 'pageOrder: 2' >> "src/app/docs/kagent/resources/helm/page.mdx"
             echo 'description: "kagent Helm chart configuration reference"' >> "src/app/docs/kagent/resources/helm/page.mdx"
             echo '---' >> "src/app/docs/kagent/resources/helm/page.mdx"
             echo '' >> "src/app/docs/kagent/resources/helm/page.mdx"
@@ -170,6 +257,9 @@ jobs:
             echo "=== Debug: After creating index file ==="
             echo "Content directory structure:"
             ls -la src/app/docs/kagent/resources/helm/
+            
+            echo "Final generated file contents (first 50 lines):"
+            head -50 "src/app/docs/kagent/resources/helm/page.mdx"
 
       - name: Create Pull Request
         uses: peter-evans/create-pull-request@v6
@@ -182,7 +272,7 @@ jobs:
           body: |
             Automated API and kagent Helm chart documentation update based on the latest commit [`${{ env.KAGENT_COMMIT }}`](https://github.com/${{ github.repository_owner }}/kagent/commit/${{ env.KAGENT_COMMIT }}) to `main` in the **kagent** repository.
             
-            This PR was automatically generated by the [**Update Reference documentation** workflow](https://github.com/kagent-dev/website/actions/workflows/update-ref-docs.yaml).
+            This PR was automatically generated by the [**Update Reference documentation** workflow](https://github.com/${{ github.repository_owner }}/website/actions/workflows/update-ref-docs.yaml).
           branch: api-gen-update
           branch-suffix: timestamp
           delete-branch: true

CONTRIBUTION.md

@@ -9,6 +9,7 @@ Thank you for your interest in contributing to Kagent! This document provides gu
 - [Style Guide](#style-guide)
 - [Documentation](#documentation)
 - [Testing](#testing)
+- [Contributing Blog Posts](#contributing-blog-posts)
 - [Community](#community)
 - [License](#license)
 - [Questions and Help](#questions-and-help)
@@ -74,7 +75,18 @@ By participating in this project, you agree to abide by our [Code of Conduct](CO
 
 7. Once approved, a maintainer will merge your PR
 
-## Adding a new blog post
+## Contributing Blog Posts
+
+The kagent website includes a blog section where we post about kagent. If you'd like to submit a blog post to [kagent.dev](https://kagent.dev), make sure your article meets the guidelines below. If you have any questions or you'd like to discuss your ideas, please send us a meessage on our [Discord server](https://bit.ly/kagentdiscord).
+
+### Blog post guidelines
+
+- Posts should be about the kagent project and valuable to our community
+- Posts should focus on the open source kagent project and not vendor specific projects or products
+- Any submitted blog posts must be original content and not a copy of existing blog posts
+
+### Writing a new blog post on kagent
+
 1. Create your blog post in `src/blogContent` folder. You can copy an existing blog post and modify it.
 2. Make sure you add the following metadata at the top of your blog post - update the title, published date, description, author, and authorIds accordingly.
 
@@ -112,6 +124,10 @@ If you need to add a new author, you can do that in the [authors.ts file](https:
 
 4. All images can be added to the public/images folder. 
 
+### Adding an existing blog post
+
+To add an existing blog post, you can add a new entry into the `external-blog-posts.yaml` file. Same guidelines as above apply.
+
 ## Style Guide
 
 - Follow the existing code style

open-next.config.ts

@@ -9,15 +9,19 @@ const config = {
       converter: "edge",
       tagCache: "dummy",
       queue: "dummy",
+      proxyExternalRequest: "fetch",
     },
   },
-
+  edgeExternals: ["node:crypto"],
   middleware: {
     external: true,
     override: {
       wrapper: "cloudflare-edge",
       converter: "edge",
       proxyExternalRequest: "fetch",
+      incrementalCache: "dummy",
+      tagCache: "dummy",
+      queue: "dummy",
     },
   },
 };