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/usage-costs.md

View on GitHub
# Usage costs

Usage Costs is a read-only spend dashboard for the signed-in user over a 7- or 30-day UTC window. It shows priced spend, request, pricing-coverage, and peak-day KPIs, a daily spend trend, model mix, top models and owners by spend, and cache efficiency by owner. Platform administrators see every owner and can narrow the report to user owners or service accounts; everyone else sees only their own spend. The page also offers a FOCUS CSV billing export for the window or for a single UTC day.

## Sub-features

- `usage-kpis` shows the `Priced spend`, `Requests`, `Pricing coverage`, and `Peak day` cards.
- `usage-trend` plots priced spend per UTC day in `Spend trend`, with uncached input, cache read, and cache write token totals.
- `usage-window` switches the report between the last 7 and the last 30 days.
- `usage-owner-filter` limits a platform-admin report to all owners, user owners, or service accounts.
- `usage-breakdowns` shows `Model mix`, `Spend by model`, `Spend by owner`, and `Cache efficiency by owner` (top 10 each), with warning badges for unpriced or usage-missing gaps.
- `usage-export` downloads a FOCUS CSV for the window or for one UTC day.

## How to get to it (user POV)

- Sign in and choose `Usage Costs` under `Budget & Spending`.
- Open `/admin/observability/usage-costs` directly.

## Driving it with control-oceans-admin

Preconditions:

- `control-oceans-admin doctor` passes.
- `mise run dev-stack` completed its local demo seed, which writes priced and usage-missing ledger rows 0-6 days back.
- You are signed in as the seeded `admin@local` platform administrator. `usage_costs` comes from the `users` page set, which platform administrators inherit.

- **Open.** Choose the `Usage Costs` link. The `Usage costs` heading appears under the `Budget & Spending` section label. The four KPI cards show values, and `Spend trend` shows a chart, not `No priced spend yet`.
- **Window.** In the `Report window` group, press the `Last 30 days` toggle (visible text `30d`). `Refresh` briefly reads `Refreshing...` and the controls are disabled. Once it settles, `30d` is pressed and `Priced spend` is at least the 7-day value.
- **Owner filter.** Open the `Owner filter` combobox and choose `Service accounts`. `Spend by owner` then lists only service accounts, such as `Local CI Runner`. Switch back to `All owners`.
- **Export menu.** Open `Export FOCUS CSV`. The menu shows the `Billing export` label, `Export last N days`, a `Single UTC day` date input, and an `Export` button. Unless a download was approved, close the menu with Escape.
- **API parity.** With the same session, fetch `GET /api/v1/admin/spend/report?days=7&owner_kind=all`. `data.totals.priced_cost_usd_10000 / 10000` must match `Priced spend`. The priced, unpriced, and usage-missing counts must sum to `Requests`. The first `data.models` entry ranked by `priced_cost_usd_10000` must match the top `Spend by model` row.
- **Proof.** Capture the 7-day default, the 30-day or service-account view, and the API totals.

## Gotchas

- The window and owner filter live in component state, not the URL. A reload resets them to `7d` and `All owners`.
- Non-platform-admin sessions don't get the `Owner filter` combobox. They see a self-only report and export through `/api/v1/me/spend/focus.csv`.
- The seed includes usage-missing requests, so `Pricing coverage` can fall below 100% and turn warning-styled under 95%. That is expected, not a fault.
- Days are UTC. Near UTC midnight, the seeded day-0 rows can land in a different chart bucket than local time suggests.
- The export is a browser navigation to the gateway origin, not the UI port. Prove it from the menu contents, or from a same-session fetch that returns HTTP 200, not from a saved file.
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