Skip to content

docs: refresh Site tools form and frame discovery - #24

Open
TueJon wants to merge 1 commit into
mainfrom
docs/current-site-tools
Open

TueJon wants to merge 1 commit into
mainfrom
docs/current-site-tools

Conversation

@TueJon

@TueJon TueJon commented Nov 9, 2026

Copy link
Copy Markdown
Owner

The public docs still say ChatGPT Site tools exclude HTML forms and iframe registrations and repeat a model/workspace matrix removed from the current official guide.

Refresh the dated Site tools page, documentation index, bilingual skill overview and llms.txt from the official OpenAI documentation checked 2026-11-09. Keep account/workspace and provider-origin permissions explicit, distinguish agent discovery from in-page cross-origin gates, and record current scalar/outputSchema limitations without claiming account or WPT verification.

Validation: 53/53 dependency-free tests pass, including the updated public-copy consistency check. Homepage, generated pages, tool/discovery contracts, layout and deploy configuration are unchanged. This PR prepares the copy only; merging/deploying is outside the task's authorization. Source compatibility changes are tracked in TueJon/webmcpify#26.

@TueJon TueJon added documentation Improvements or additions to documentation webmcp WebMCP agent surface labels Nov 9, 2026
@TueJon TueJon self-assigned this Nov 9, 2026

@TueJon TueJon left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

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

Round 1 review of head 16c076e (docs-only, +28/−28 across 5 files). No prior reviews; judged on this diff.

Sweep: every changed surface traced — docs/site-tools/index.html (requirements, troubleshooting, FAQ, sources), docs/index.html (client-proof bullet, new probe paragraph), llms.txt, webmcp-agent-skill/index.html (en+de), tests/pages.test.mjs. No code, workflow, deploy, schema or secret changes; no external effects.

  • Product fit: the refresh removes a model/workspace matrix and a "no forms/iframes" claim the current official guide no longer carries, replacing both with dated, hedged copy ("documentation check, not a live account test"). Matches the repo's experimental-honesty bar.
  • Stale-claim sweep: no remaining GPT-5.6 Sol / GPT-6 Sol / Luna / Edu / not Declarative API strings in html/txt. Remaining 2026-10-12 refs are the separate Chrome origin-trial evidence paragraphs with their own dates — correctly untouched.
  • Bilingual parity: en+de spans updated together on both bilingual pages. docs/index.html has no German mirror for the touched bullets, so no parity gap.
  • Test guard: updated facts plus a doesNotMatch against the superseded matrix; node --test tests/*.test.mjs passes 53/53 locally and CI test is SUCCESS at this head.
  • Cited dates: WebMCP draft 2026-11-02 confirmed against the live spec page; OpenAI guide URL live. The exposedTo sentence correctly separates agent discovery from in-page cross-origin gates. The new Chrome 156 probe paragraph is dated, scoped, and states its non-claims explicitly.
  • Generated files: index.html/de/ and tool contracts untouched, so no regen owed.

No blocking or non-blocking findings. Ship it.

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 webmcp WebMCP agent surface

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant