Skip to content

docs(fleet-manager): document approving agent step-up requests - #48

Merged
Bugs5382 merged 2 commits into
mainfrom
docs/125-approvals-page
Sep 30, 2026
Merged

Bugs5382 merged 2 commits into
mainfrom
docs/125-approvals-page

Conversation

@Bugs5382

Copy link
Copy Markdown
Contributor

What and why

Adds a page for the web UI's new Approvals page (CryptOS-PKI/cryptos-web#126): the step-up approvals the Fleet Manager raises before an MCP tool that changes the fleet runs, and how a person decides them. The page is one task under Fleet Manager, next to The web UI.

  • What a step-up approval is: what the agent gets back (approval ID, summary, approve link, expiry), and that only a browser with an operator certificate can decide one.
  • Opening a request: the ?id= link from the agent's approve_url, the pending badge, the status filter and the columns.
  • Approving and denying: the confirmation with the summary and request digest, the expected result, and the inline refusal. A danger callout sits before the step.
  • Who can decide: the level gating in the page and in the manager, and the live level check on the agent's second call.
  • Expiry and single use: the 15-minute window (caution callout), one call per approval, same key, tool and arguments, and the audit trail.
  • The web UI page's nav list and its Agent keys section link to the new page, and the sidebar lists it.

There are no commands on the page, so it has no OS tabs. Examples use fleetos.example.org.

Refs CryptOS-PKI/cryptos-web#125

Merge order: merge together with CryptOS-PKI/cryptos-web#126. The manager side is already on manager main.

Verification

  • Build succeeds
  • Documentation updated (if behavior or API changed)

How this was verified

  • npm ci --ignore-scripts && npm run build: the site builds with no broken links or warnings.
  • Checked against manager main (docs/mcp.md, internal/approval, the store's decide and use checks) and the web#126 page and dialog, for the 15-minute expiry, the single use, the level rules, the refusals and the labels quoted.

Before merging: add a closing comment summarizing what was actually done in this PR
(not just the checked boxes).

Signed-off-by: Bugs5382 <12115015+Bugs5382@users.noreply.github.com>
@Bugs5382 Bugs5382 self-assigned this Sep 30, 2026
@Bugs5382
Bugs5382 marked this pull request as ready for review September 30, 2026 13:41
@github-actions github-actions Bot added the documentation Documentation only (docs). label Sep 30, 2026
Signed-off-by: Bugs5382 <12115015+Bugs5382@users.noreply.github.com>
@Bugs5382

Copy link
Copy Markdown
Contributor Author

Closing summary: adds the Approving agent requests page (what a step-up approval is, opening it from the agent's link, approve and deny, who can decide, 15-minute expiry and single use), linked from the sidebar and the web UI page. Companion to CryptOS-PKI/cryptos-web#126.

@Bugs5382
Bugs5382 merged commit ebb1d60 into main Sep 30, 2026
8 checks passed
@Bugs5382
Bugs5382 deleted the docs/125-approvals-page branch September 30, 2026 14:07
@Bugs5382 Bugs5382 added this to the v0.1.0 milestone Oct 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Documentation only (docs).

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant