Skip to content

docs(m102): reconcile credential seam + Models & Keys for #458#112

Merged
indykish merged 4 commits into
mainfrom
chore/m102-models-keys-credential-seam
Jun 28, 2026
Merged

docs(m102): reconcile credential seam + Models & Keys for #458#112
indykish merged 4 commits into
mainfrom
chore/m102-models-keys-credential-seam

Conversation

@indykish

@indykish indykish commented Jun 28, 2026

Copy link
Copy Markdown
Contributor

Documentation reconciliation for the M102_003 client credential seam landing on agentsfleet PR #458 (Models & Keys page + credential kind projection + key-only PATCH rotate).

Changed

  • changelog.mdx — new Jun 28 <Update>: Models & Keys consolidates to one page; credentials list projects kind + non-secret provider/model/base_url; key-only Replace-key (PATCH). Supersedes the Jun 24 "two destinations" entry (history append-only — Jun 24 left intact).
  • fleets/credentials.mdx — repoint the stale "Models → Custom — OpenAI-compatible" dashboard reference to the Models & Keys page; --json list now carries the classification fields; document in-place Replace-key rotation.
  • cli/agentsfleet.mdx — note credential list --json carries kind + non-secret descriptors (human table unchanged).

Argue-back (not changed, on purpose)

  • Telemetry (group analytics / person props / workspace_switched) — omitted; zero user-visible change, changelog is user-facing only.
  • CLI human output — unchanged; the new fields are --json passthrough only (the CLI renders name + created_at).
  • Other product/CLI/API pages swept (quickstart, concepts, api-reference, workspaces, fleets/*) → no credential/model/integration staleness.

🤖 Generated with Claude Code

Greptile Summary

This PR reconciles the credential and Models & Keys documentation.

  • Adds a Jun 28 changelog entry for the unified Models & Keys page.
  • Documents credential kind and non-secret descriptor fields in JSON output.
  • Documents key-only credential rotation with the workspace-scoped PATCH route.
  • Adds integration connect and token mint error codes.

Confidence Score: 5/5

This looks safe to merge.

  • No blocking issues found in the changed code.

Important Files Changed

Filename Overview
api-reference/error-codes.mdx Adds integration connect/token mint errors and documents UZ-VAULT-003 for scoped credential key rotation.
changelog.mdx Adds the Models & Keys update with credential classification and key-only rotation details.
cli/agentsfleet.mdx Notes that credential JSON output includes non-secret classification fields.
fleets/credentials.mdx Updates dashboard references and credential rotation guidance for Models & Keys.

Reviews (3): Last reviewed commit: "docs: scope credential not-found error r..." | Re-trigger Greptile

Document the M102_003 client credential seam landing on PR #458:

- changelog.mdx — new Jun 28 Update: Models & Keys consolidates to one
  page, the credentials list now projects `kind` + non-secret
  provider/model/base_url, and key-only PATCH rotate (Replace key).
  Supersedes the Jun 24 "two destinations" entry (history append-only,
  not rewritten).
- fleets/credentials.mdx — repoint the stale "Models -> Custom" dashboard
  reference to the Models & Keys page; note --json list now carries the
  classification fields; document the in-place Replace-key rotation.
- cli/agentsfleet.mdx — note `credential list --json` now carries kind +
  non-secret provider/model/base_url (human table output unchanged).

Telemetry changes intentionally omitted — zero user-visible change.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mintlify

mintlify Bot commented Jun 28, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
agentsfleet 🟢 Ready View Preview Jun 28, 2026, 7:21 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

The key-only rotate PATCH /credentials/{name} and other by-name
credential lookups return UZ-VAULT-003 (404) when the named credential
is absent. The public error-codes table listed UZ-VAULT-001/002 but
not 003 — add the row.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Comment thread api-reference/error-codes.mdx Outdated
Comment thread api-reference/error-codes.mdx Outdated
PR #458 (M102_001 agent identity proxy) registers user-facing codes the
public error table was missing. Reconciled error-codes.mdx against the
backend registry (error_entries*.zig): every documented code is real, and
these new ones were undocumented:

- UZ-CONN-001 (503) connector not configured
- UZ-CONN-002 (400) invalid connect state
- UZ-CRED-001 (404) integration not connected
- UZ-GH-1  (409) GitHub App reconnect required
- UZ-GH-2  (502) GitHub token mint failed

Added under a new "Integration connect & token mint" section. Only the
UZ-NONEXISTENT-999 / UZ-TEST-001 sentinels remain (deliberately) public-undocumented.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@indykish indykish merged commit 378ef29 into main Jun 28, 2026
4 checks passed
@indykish indykish deleted the chore/m102-models-keys-credential-seam branch June 28, 2026 16:20
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