Skip to content

feat: add agent readiness discovery files and WebMCP support - #190

Merged
ayoub3bidi merged 2 commits into
developfrom
feat/agent-readiness
Jun 27, 2026
Merged

feat: add agent readiness discovery files and WebMCP support#190
ayoub3bidi merged 2 commits into
developfrom
feat/agent-readiness

Conversation

@ayoub3bidi

@ayoub3bidi ayoub3bidi commented Jun 27, 2026

Copy link
Copy Markdown
Owner

Description

Add AI agent readiness infrastructure following isitagentready.com standards. New agent-discovery files, WebMCP tool registration, and Link headers help AI agents discover and interact with Bayan Flow's algorithm catalog.

Type of Change

  • ✨ New feature (non-breaking change which adds functionality)

Changes Made

  • Create .well-known/ agent-discovery files: MCP Server Card, A2A Agent Card, Agent Skills index, API catalog
  • Add auth.md for agent authentication documentation
  • Add Link header pointing to sitemap.xml in Cloudflare _headers
  • Register WebMCP tool via navigator.modelContext.registerTool() exposing algorithm inventory
  • Enables 8/9 checks on isitagentready.com (Level 2 → near Level 3)

Testing

  • All existing tests pass (pnpm test:run)
  • pnpm lint passes
  • pnpm format:check passes
  • pnpm build succeeds

Code Quality

  • Code follows the project's coding standards
  • ESLint passes (pnpm lint)
  • Prettier formatting applied (pnpm format)
  • No console errors or warnings

Performance Impact

  • No performance impact

Breaking Changes

  • None

Summary by CodeRabbit

  • New Features
    • Added machine-readable agent metadata, skills registry, and an API catalog for easier discovery.
    • Enabled an in-browser “WebMCP” site info tool (with optional category filtering) for supporting assistants.
    • Published an MCP server manifest describing the available tool.
  • Documentation
    • Added an auth/privacy/usage page clarifying the app is fully client-side, requires no sign-in, and collects no personal data.
  • Bug Fixes
    • Added/updated public headers for sitemap discovery and correct JSON content typing for the API catalog.

- Create .well-known/ agent-discovery files (MCP, A2A, Agent Skills, API catalog)
- Add auth.md for agent authentication documentation
- Add Link header pointing to sitemap.xml in _headers
- Register WebMCP tool via navigator.modelContext.registerTool()
- Enable 8 of 9 isitagentready.com checks to pass
@netlify

netlify Bot commented Jun 27, 2026

Copy link
Copy Markdown

Deploy Preview for dev-bayanflow ready!

Name Link
🔨 Latest commit 5eb7849
🔍 Latest deploy log https://app.netlify.com/projects/dev-bayanflow/deploys/6a3fbf7aef1aa900088b2005
😎 Deploy Preview https://deploy-preview-190--dev-bayanflow.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Jun 27, 2026
@coderabbitai

coderabbitai Bot commented Jun 27, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 7529b018-0cc3-4651-b8d6-bb07a8f93cd5

📥 Commits

Reviewing files that changed from the base of the PR and between 8a6030b and 5eb7849.

📒 Files selected for processing (4)
  • index.html
  • public/.well-known/agent-skills/index.json
  • public/.well-known/mcp.json
  • public/_headers
✅ Files skipped from review due to trivial changes (1)
  • public/.well-known/agent-skills/index.json
🚧 Files skipped from review as they are similar to previous changes (2)
  • public/_headers
  • index.html

📝 Walkthrough

Walkthrough

The PR adds a WebMCP tool registration on the main page and introduces several public .well-known discovery files, plus authentication and sitemap metadata documents.

Changes

AI discovery and public metadata

Layer / File(s) Summary
Discovery manifests
public/.well-known/agent-card.json, public/.well-known/agent-skills/index.json, public/.well-known/mcp.json, public/.well-known/api-catalog
Adds machine-readable agent, skills, MCP, and API catalog metadata for the site.
WebMCP registration
index.html
Adds an inline check for navigator.modelContext and registers the bayan_flow_info tool with an async metadata response.
Site metadata documents
public/_headers, public/auth.md
Adds a sitemap Link header and a public document covering access, data collection, analytics, and contact details.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

A rabbit hopped through JSON bright,
and found new tools in WebMCP light.
With carrots, sitemaps, and a speedy thump,
Bayan Flow now gives my whiskers a jump. 🐇

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the main change: adding agent-readiness discovery files and WebMCP support.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/agent-readiness

Comment @coderabbitai help to get the list of available commands.

@codecov

codecov Bot commented Jun 27, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@github-actions

github-actions Bot commented Jun 27, 2026

Copy link
Copy Markdown

Preview for Bayan Flow Staging ready!

Name Link
🔨 Latest commit 5eb7849
🔍 Latest deploy log https://github.com/ayoub3bidi/bayan-flow/actions/runs/28288959590
😎 Deploy Preview https://pr-190-bayan-flow-staging.ayoub3bidi.workers.dev
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

Preview alias pr-190 on the staging worker. Updates automatically with new commits.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 4

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@index.html`:
- Around line 177-225: The `category` field declared in `inputSchema` is
currently ignored by `execute`, so the tool contract does not match behavior.
Update the `execute` function to accept the provided arguments and use the
`category` value to filter the returned catalog data in the Bayan Flow tool, or
remove `category` from `inputSchema` if filtering is not intended. Make sure the
fix is applied in the same tool definition where `inputSchema` and `execute` are
defined.

In `@public/.well-known/agent-skills/index.json`:
- Around line 8-27: The skill index is advertising tool entries that are not
actually implemented, so update the agent-skills manifest to only list real
callable tools. In the index.json entry for bayan-flow and complexity-analysis,
either remove browse_categories, view_algorithm, and view_complexity or add
matching registrations in the code that serves these skills, and keep only
symbols that are exposed by index.html/bayan_flow_info. If these are meant to be
navigation links, reword them as non-tool affordances instead of tools.

In `@public/.well-known/api-catalog`:
- Around line 1-5: The /.well-known/api-catalog asset is being served through
the SPA fallback, so it returns the homepage HTML instead of JSON. Update the
app’s static hosting/fallback handling so this path is excluded from the HTML
fallback and is served directly from the existing api-catalog asset with
application/json content type; use the api-catalog route/static-file
configuration to locate the fix.

In `@public/.well-known/mcp.json`:
- Around line 6-20: The MCP manifest and registered tools are out of sync: the
manifest under the capabilities/tools section advertises
get_algorithm_categories, get_algorithm_info, and search_algorithms, but the
actual page only exposes bayan_flow_info. Update the manifest to match the tool
registration in the MCP setup so the advertised tool names correspond exactly to
the tools returned by the server, using the existing tool registration and
manifest generation points as the source of truth.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 9949be0f-315f-4edc-ada0-e94b29257df7

📥 Commits

Reviewing files that changed from the base of the PR and between 3d008c0 and 8a6030b.

📒 Files selected for processing (7)
  • index.html
  • public/.well-known/agent-card.json
  • public/.well-known/agent-skills/index.json
  • public/.well-known/api-catalog
  • public/.well-known/mcp.json
  • public/_headers
  • public/auth.md

Comment thread index.html
Comment thread public/.well-known/agent-skills/index.json Outdated
Comment thread public/.well-known/api-catalog
Comment thread public/.well-known/mcp.json
- Make execute() accept category arg and filter catalog data accordingly
- Remove phantom tool entries from agent-skills manifest
- Add Content-Type: application/json override for api-catalog in _headers
- Sync MCP manifest tool list with sole bayan_flow_info tool
@ayoub3bidi ayoub3bidi self-assigned this Jun 27, 2026
@ayoub3bidi
ayoub3bidi merged commit 8fadbdd into develop Jun 27, 2026
16 checks passed
@ayoub3bidi
ayoub3bidi deleted the feat/agent-readiness branch June 27, 2026 12:24
@coderabbitai coderabbitai Bot mentioned this pull request Jun 27, 2026
33 tasks
@ayoub3bidi ayoub3bidi mentioned this pull request Jul 16, 2026
35 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant