Skip to content

ahstn/oceans-llm / .agents/skills/verify-oceans-admin

verify-oceans-admin

Verified

Verify the Oceans LLM admin control plane and backend gateway against the real local stack, seeded demo data, and bounded live providers when required. Use for user-path checks of sign-in, models, API keys, observability, usage costs, spend controls, batches, agent sessions, request logs, Anthropic Messages thinking and effort compatibility, MCP registry and tool access, OpenRouter routing, guardrails, and Skills storage.

FileKindSize
SKILL.mdskill md29.0 KB
examples/mcp-candidates.jsonconfig3.0 KB
features/README.mdmarkdown10.0 KB
features/account-onboarding.mdmarkdown4.3 KB
features/agent-harnesses.mdmarkdown4.3 KB
features/agent-plugins.mdmarkdown1005 B
features/agent-sessions.mdmarkdown3.9 KB
features/anthropic-messages.mdmarkdown20.7 KB
features/api-keys.mdmarkdown6.5 KB
features/attribution.mdmarkdown13.9 KB
features/audit-log.mdmarkdown4.9 KB
features/backend-gateway.mdmarkdown5.2 KB
features/batch-requests.mdmarkdown4.2 KB
features/design-system.mdmarkdown4.6 KB
features/guardrails.mdmarkdown7.0 KB
features/harness-integration.mdmarkdown7.8 KB
features/identity.mdmarkdown4.2 KB
features/image-generation.mdmarkdown7.3 KB
features/leaderboard.mdmarkdown3.3 KB
features/live-llm-requests.mdmarkdown12.6 KB
features/mcp-client-oauth.mdmarkdown9.9 KB
features/mcp-ownership.mdmarkdown7.4 KB
features/mcp.mdmarkdown19.6 KB
features/models.mdmarkdown8.2 KB
features/password-sign-in.mdmarkdown8.3 KB
features/profile.mdmarkdown2.5 KB
features/rate-limits.mdmarkdown6.0 KB
features/request-logs.mdmarkdown8.6 KB
features/review-agent.mdmarkdown3.7 KB
features/routing.jsonconfig33.6 KB
features/service-tiers.mdmarkdown6.3 KB
features/skills.mdmarkdown9.8 KB
features/spend-controls.mdmarkdown7.3 KB
features/usage-costs.mdmarkdown3.7 KB
features/workspace-connections.mdmarkdown6.1 KB
scripts/check-messages.mjsexecutablescript2.4 KB
scripts/check-messages.test.mjsscript3.0 KB
scripts/control-oceans-adminexecutablescript25.3 KB
scripts/control-oceans-admin.test.mjsscript7.6 KB
scripts/drive-backend-gateway.mjsexecutablescript12.5 KB
scripts/drive-harness-integration.mjsscript6.6 KB
scripts/drive-mcp.mjsscript13.0 KB
scripts/drive-models.mjsscript12.9 KB
scripts/drive-observability.mjsscript16.8 KB
scripts/drive-profile.mjsscript8.2 KB
scripts/drive-service-tiers.mjsexecutablescript20.1 KB
scripts/drive-skills.mjsscript27.2 KB
scripts/mcp-browser.mjsscript26.5 KB
scripts/mcp-canary.mjsscript18.8 KB
scripts/mcp-candidates.mjsscript3.5 KB
scripts/mcp-verification.test.mjsscript10.2 KB
scripts/messages-regressions.mjsscript15.8 KB
scripts/plan-verification.mjsscript5.2 KB
scripts/plan-verification.test.mjsscript6.1 KB
scripts/proof-cli.mjsscript11.1 KB
scripts/proof.mjsscript9.2 KB
scripts/proof.test.mjsscript10.4 KB

features/workspace-connections.md

View on GitHub
# Workspace connections

Workspace connections lets any signed-in user link or unlink their own account on OAuth-backed MCP servers that a platform administrator has registered. These include Google Drive and Google Docs, servers that use a configured `oauth2` provider, and servers registered by URL through OAuth discovery. When no such server is configured, the page explains that an administrator must register one first.

## Sub-features

- `connections-list` shows each available OAuth MCP server with its status and `Requested scopes`. A server that requests no specific scopes shows `Provider default`. The card description reads `<server_key> · via <provider>`. The provider is the configured key, such as `google`, or the authorization server's host for a server registered through discovery.
- `connections-empty` shows `No OAuth servers are available` when there is no active oauth_obo server.
- `connections-connect` starts the provider consent flow with `Connect` or `Reconnect`.
- `connections-disconnect` removes the user's binding with `Disconnect`.
- `connections-callback` shows a toast for `?oauth=connected` or `?oauth_error=<code>`. The callback also returns `?server=<server_id>`, and the success toast then names the server, such as `Google Drive connected`.
- `connections-client-metadata` is the public Client ID Metadata Document at `/api/v1/mcp/oauth/client-metadata.json`. Servers that use `metadata_document` registration send its URL as their client ID. It returns 404 when `mcp.oauth.public_base_url` is not set.
- `connections-connect-link` handles `?connect=<server_key>`, the `connect_url` that MCP clients receive with `credential_required` and `credential_expired`. It drops the parameter, then starts consent for that server. A connected server shows `<name> is already connected`. A connection that no longer matches the server's provider, resource, or required scopes lists as `Expired`, so the link starts consent again; an unknown server shows `No workspace connection is available for MCP server <key>.`; an unavailable server shows its availability error.

- `connections-authorized-clients` shows the `Authorized MCP clients` card when OAuth sign-in for MCP clients is enabled. It lists each client the user allowed, with its access, last token time, and expiry, and `Disconnect <client>` revokes it. With no clients it reads `No MCP clients are authorized.`

## How to get to it (user POV)

- Open `/admin/account/connections` directly; it has no sidebar link. It is a personal page and needs no page permission, and the OAuth callback also returns here.

## Driving it with control-oceans-admin

Preconditions:

- `control-oceans-admin doctor` passes, and you are signed in as `admin@local`.
- The default `gateway.yaml` has no `mcp.oauth` block and no oauth_obo MCP server, so only the empty state can be reached.

- **Open.** Open `/admin/account/connections`. The URL is `/admin/account/connections` and the `Workspace connections` card is visible.
- **Empty state.** The `No OAuth servers are available` alert is visible, and no `Connect` button renders.
- **API parity.** From the browser context, fetch `/api/v1/mcp/oauth/connections`. It returns an empty list, which matches the empty state.
- **Non-admin reach.** In a new browser context, sign in as `ben@platform.local` with `localdemo123` and open `/admin/account/connections`. The same empty state renders, so the page is not gated by permissions.
- **Error callback.** Open `/admin/account/connections?oauth_error=access_denied`. An error toast appears and the page stays on the empty state. `?oauth_error=issuer_mismatch` shows `The response came from a different authorization server than this connection uses.`
- **Metadata document.** Fetch `/api/v1/mcp/oauth/client-metadata.json` without a session. The default stack sets no `mcp.oauth.public_base_url`, so it returns 404.
- **Connect link, unknown server.** Open `/admin/account/connections?connect=google_drive`. The toast `No workspace connection is available for MCP server google_drive.` appears, the URL drops the `connect` parameter, and the browser does not leave the page.
- **Connect, connect link and disconnect (unreachable by default).** These need `mcp.oauth.public_base_url`, a registered oauth_obo server, and interactive consent at the upstream. A Google server also needs a Google entry under `mcp.oauth.providers`. Report them as skipped and name that unmet precondition.
- **Authorized clients, empty.** The `Authorized MCP clients` card reads `No MCP clients are authorized.`, which matches `/api/v1/me/authorized-mcp-clients` (`enabled: true`, empty `items`).
- **Authorized clients, disconnect.** Authorize a client through the [MCP client OAuth](./mcp-client-oauth.md) consent flow, then reload the page. The card lists the client by name. Choose `Disconnect <client>`. A `<client> disconnected` toast appears, the row disappears, and the client's access token now gets `401` on `/mcp`.
- **Proof.** Capture the card, the alert, and the API response.

## Gotchas

- `Connect` redirects to the upstream authorization server. For a server registered by discovery with `dynamic` registration, the first `Connect` also registers Oceans with that server. Never complete consent with a real account during verification.
- The code flow, refresh, dynamic registration, and metadata-document client for generic servers are proved against a mock authorization server by `http::mcp_oauth::tests::generic`.
- The list includes only active oauth_obo servers and the user's existing bindings. A registered MCP server without OAuth does not appear.
- `Disconnect` acts only on the signed-in user's own binding. It is not an admin view of other users.
- The status badge capitalizes the status from the API, so compare statuses case-insensitively.
- Do not record the OAuth `state`, codes, or tokens in evidence.
- The `connect_url` itself is built by the gateway. `http::mcp_gateway::credentials::tests` and `aggregate::tests::missing_oauth_credential_returns_the_connect_url` prove the URL, the message, and that no secrets appear. `src/test/routes/account-connections-route.test.tsx` proves the page side with a stubbed consent redirect.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall