Skip to content

✨ Discover and call the public review API - #364

Open
Robdel12 wants to merge 3 commits into
mainfrom
rd/schema-review-api
Open

Robdel12 wants to merge 3 commits into
mainfrom
rd/schema-review-api

Conversation

@Robdel12

@Robdel12 Robdel12 commented Sep 23, 2026

Copy link
Copy Markdown
Contributor

Agents can use the existing API command to query Vizzly, but discovering endpoints requires outside documentation, POST is limited to comments, and responses are always parsed as JSON. Those restrictions prevent a complete schema-driven visual review.

Add operation discovery through vizzly api schema, with compact request instructions and optional fields/response/full schema views. Extend generic requests with JSON file/stdin bodies and explicit file output for images. Preserve the existing JSON envelope and prefer a user login over an implicit linked upload token, while honoring explicit credentials. Schema discovery works before login. Requests reject redirects, downloads do not overwrite files and remove partial output even when a stream fails before its first byte, and generic writes are not automatically replayed; existing idempotent review-command retries remain intact.

The CLI regression suite, lint/format, type checks, and production build pass. Real subprocess/HTTP tests cover discovery, bodies, interrupted downloads, empty/error responses, redirects, login versus explicit credential precedence, read refresh, and suppression of mutation replays. The packed candidate also completed a schema-discovered review against a real API: paged captures/comparisons, image downloads, decisions, and persisted-state verification.

Schema lookup requires a server exposing the new discovery endpoints. The existing raw API invocation and JSON wrapping remain supported. No endpoint-specific capability flags, offline schema cache, or new query language are introduced.

Expose compact schema discovery and generic JSON bodies and file downloads so agents can complete reviews using server contracts. Preserve JSON output and dedicated review retry behavior.
Open the exclusive destination before transferring bytes so early stream failures cannot leave an empty file behind. Exercise credential precedence, refresh/replay behavior, binary errors and cleanup through real CLI subprocesses and HTTP.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant