Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Define accessibility requirements for WebMCP user-agent UI

Đang mở
  • Có gì không ổn?
#277 3 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
35/100
Loại issue
Tính năng
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
html
Lĩnh vực
accessibility

Hướng nghiên cứu

Start with the empty Accessibility considerations section in index.bs and read the linked declarative-api-explainer.md passages, plus the related issues and pull requests listed in the description. Resolve the open questions about conformance guidance, review policy, and agent-filled state before proposing requirements. Done means the draft addresses the listed accessibility needs and the FAST API checklist item.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

a11y-tracker

Summary

Define accessibility requirements for any user-agent or agent-frontend UI that exposes WebMCP tool
discovery or mediates tool execution. This is a focused follow-up to the APA WG review in
#65 and the FAST self-review in #272.

This does not propose adding WebMCP tool metadata to the page accessibility tree; #91 settled
that question. It concerns the accessibility of user-facing UI created by a user agent or agent
frontend from WebMCP data.

Current gap

The draft says a tool's title is used by the user agent in UI,
but its Accessibility considerations section is empty.

The declarative explainer also defines user-visible behavior:

Those hooks are useful, but author styling and script events are not a substitute for requirements
on the UI that people actually use. In particular, toolautosubmit skips the described review
state entirely.

Requirements to resolve

Any normative or recommended user-agent mediation should address at least:

  1. Discovery: a user can determine that agent capabilities are available and identify them by
    an accessible name and description.
  2. Review and approval: a user can inspect the exact tool, origin, arguments, target, and likely
    consequence before a consequential action is committed, then approve or reject it. A user-agent
    policy or user preference must be able to require review regardless of an author hint or
    toolautosubmit. This supports WCAG 2.2's review/confirm/correct model for consequential
    submissions    .
  3. Operation: the mediation UI is keyboard- and assistive-technology-accessible, with defined
    roles, names, states, values, focus behavior, and hardware-agnostic controls.
  4. Status and recovery: start, progress, completion, partial failure, cancellation, and any undo
    opportunity are perceivable without relying only on color, animation, or visual focus.
  5. Agent-filled state: users can tell which form values were supplied by an agent and review
    changes without requiring visual comparison. Whether this needs a WebMCP primitive, HTML work,
    or user-agent-only behavior remains an open layering question.
  6. Privacy and parity: the same mediation is available whether or not assistive technology is
    present; implementations must not detect or reveal AT usage to select behavior.
  7. Localization: accessible names, descriptions, status, and review UI follow the language and
    direction decisions tracked in #153 and #276.

Relationship to existing work

  • #165 / PR #204: user-input and human-in-the-loop flows.
  • #176 / PR #217 and #198: consequence/reversibility hints and review policy. Site-provided hints
    remain advisory; they are not authorization decisions.
  • #139: declarative validation feedback.
  • #66, #67, and #210: labels and input-schema synthesis.
  • #91: WebMCP and the page accessibility tree remain separate layers.

The outcome could be conformance requirements, non-normative implementation guidance, or both, but
the current empty accessibility section does not answer the FAST API checklist item.

Maintainers: please apply the a11y-tracker label so APA is notified. I cannot apply repository
labels with my current permissions.

Ngôn ngữ chính
Bikeshed
Star
4.7k
Fork
328
Merge trung bình
2 ngày 15 giờ
Pull request đã merge (30 ngày)
16

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của webmachinelearning/webmcp

Tất cả issue của webmachinelearning/webmcp

Issue tương tự

Thêm issue về Accessibility

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.