{
  "$id": "https://wrok.in/capabilities.json",
  "manifestVersion": 1,
  "updated": "2026-10-23",
  "product": {
    "name": "wrokin",
    "vendor": "BytesBrains",
    "summary": "GitHub App that runs an AI agent team on your repositories — code review, security audit, issue triage, project management (milestones + status), and a deterministic repo-posture audit. BYOK: reviews run on your own LLM API key and your chosen model, per agent.",
    "homepage": "https://wrok.in",
    "install": "https://github.com/apps/wrokin",
    "installDeepLink": "https://github.com/apps/wrokin/installations/new",
    "dashboard": "https://app.wrok.in"
  },
  "humanCheckpoints": [
    "GitHub App install consent and BYOK key custody",
    "payment"
  ],
  "docs": {
    "llmsTxt": "https://wrok.in/llms.txt",
    "integrationManual": "https://wrok.in/agents.md",
    "commandContract": "https://wrok.in/w-commands.md",
    "configSchema": "https://wrok.in/config.schema.json",
    "errorReference": "https://wrok.in/docs/errors",
    "cruiseGuide": "https://wrok.in/docs/cruise"
  },
  "providers": [
    "anthropic",
    "openai",
    "deepseek",
    "google",
    "mistral",
    "openrouter",
    "moonshot",
    "groq",
    "xai",
    "meta",
    "cruise"
  ],
  "customProviders": {
    "supported": true,
    "what": "an installation may define its own OpenAI-compatible endpoints (base URL + key + name + description) and select their models per agent",
    "idForm": "custom:<slug>",
    "maxPerInstallation": 10,
    "requirements": "https on port 443 only (wrokin runs on Cloudflare Workers, which silently discard any other port on an https subrequest), publicly resolvable; private, loopback and link-local addresses are refused",
    "modelListing": "pulled live from the endpoint's GET /models; fields it does not publish (context window, price) are reported as unknown, never as zero; a reported context window sizes reviews on that model, and one under ~17K tokens is refused; each model carries a key status (serving / refused on HTTP 404) from what real calls with the customer's key answered; an untried model can be checked with one user-initiated request, never in the background",
    "billing": "BYOK only — a custom endpoint is never used for managed runs, and its models are not priced in wrokin's cost ledger",
    "operations": "customProviders.list / .create / .configure / .delete (confirm) / .models / .checkModel; the key itself goes through keys.set under the custom:<slug> id",
    "repoint": "changing baseUrl on an endpoint that holds a key is refused outside the dashboard: the URL is where that key is sent"
  },
  "modelChoice": "any model id the customer's key can call, chosen per role",
  "roleStatusLegend": {
    "live": "runs in wrokin's Worker on your BYOK key; configure per repo in the dashboard or .wrokin/config.yml",
    "available": "customer-enableable on a qualifying plan, but runs on YOUR GitHub Actions runner via a workflow a one-click setup PR adds",
    "private-preview": "invite-only; not enableable by customers today — do not plan an integration around it",
    "inactive": "accepted by the config schema but has no registered runner — configuring it has no effect today"
  },
  "roles": [
    {
      "id": "code-review",
      "status": "live",
      "billing": "byok",
      "managedOptIn": "the owner can switch this role to managed billing in the dashboard: it then runs on wrokin's key/model for the role and debits agent credits per run; dark until credits are enabled",
      "freeOss": "on a public repo with no key set for this role, runs free on wrokin's key on a Cruise oss/* lane: one per account every 45 minutes, diffs up to 200 KB, global daily budget; counts toward monthlyRuns. See dataHandling.freeOssReview",
      "autoTrigger": [
        "pull_request"
      ],
      "onDemand": "/w review",
      "posts": "PR comment headed '🤖 wrokin — Code Review' with file:line findings"
    },
    {
      "id": "security-audit",
      "status": "live",
      "billing": "byok",
      "managedOptIn": "the owner can switch this role to managed billing in the dashboard: it then runs on wrokin's key/model for the role and debits agent credits per run; dark until credits are enabled",
      "autoTrigger": [
        "pull_request"
      ],
      "onDemand": "/w security audit",
      "posts": "PR comment headed '🤖 wrokin — Security Audit' with file:line findings"
    },
    {
      "id": "issue-triage",
      "status": "live",
      "billing": "byok",
      "managedOptIn": "the owner can switch this role to managed billing in the dashboard: it then runs on wrokin's key/model for the role and debits agent credits per run; dark until credits are enabled",
      "autoTrigger": [
        "issues"
      ],
      "onDemand": "/w triage",
      "posts": "structured triage comment (labels, priority, duplicate check)"
    },
    {
      "id": "repo-audit",
      "status": "live",
      "billing": "none",
      "deterministic": true,
      "autoTrigger": [],
      "onDemand": "/w audit",
      "posts": "repo-setup posture report",
      "note": "Warden. Deterministic checks, no model call, no API key needed — works from the install alone."
    },
    {
      "id": "project-management",
      "status": "live",
      "billing": "byok",
      "managedOptIn": "the owner can switch this role to managed billing in the dashboard: it then runs on wrokin's key/model for the role and debits agent credits per run; dark until credits are enabled",
      "autoTrigger": [
        "issues",
        "pull_request"
      ],
      "onDemand": null,
      "posts": "milestone assign/clear against existing open milestones + identity-signed status comment; optional Projects v2 Status sync when `.wrokin/config.yml` sets `project.number`",
      "note": "Milestones + status rollups always. Org boards need Organization → Projects write (#764) + `project.number` (#765). User-owned boards need a dashboard Projects PAT (#775); unreconsented / missing-PAT installs soft-skip board I/O."
    },
    {
      "id": "hunter",
      "status": "available",
      "customerEnableable": true,
      "billing": "managed",
      "onDemand": "/w hunter [level]",
      "levels": [
        "foray",
        "stakeout",
        "expedition"
      ],
      "defaultLevel": "stakeout",
      "requiresPlan": [
        "Pro",
        "Team",
        "Business"
      ],
      "enable": "one-click in the dashboard: opens a setup PR adding .github/workflows/wrokin-hunter.yml to your repo; disable opens a PR removing it",
      "operations": "hunter.status / .enable (confirm) / .disable (confirm) / .settings / .configure {reportAsIssues, surfaceUnverified, trigger} / .dispatch {prNumber, level} (spends a scan)",
      "note": "Proof-by-execution security scanning on wrokin's own model keys. Debits agent credits from the shared pool. Paid plans only (Free has a zero credit bundle)."
    },
    {
      "id": "builder",
      "status": "private-preview",
      "customerEnableable": false,
      "billing": "byok",
      "onDemand": "/w build",
      "requiresPlan": [],
      "enable": "on demand only — contact the wrokin team; customised for specific projects, use cases and guardrails",
      "operations": "builder.status (with plan entitlement) / .enable (confirm) / .disable (confirm) / .settings / .configure {autoMerge, model, readCapKb, baseBranch, compressToolOutput, thinking}",
      "autoMergeOn": "turning autoMerge on is refused outside the dashboard: it removes the human review of a green Builder PR; turning it off works anywhere",
      "note": "Verified issue→PR. On demand only — not included in catalog plans, and it debits no agent credits: pi runs on your runner and calls Cruise with YOUR Cruise key. The action re-runs your tests itself after pi finishes: a ready PR when they pass, a draft when they don't or there are none.",
      "agentRunner": {
        "status": "preview",
        "action": "actions/wrokin-agent",
        "note": "The Builder-family runner (#803): pi on your runner calls Cruise directly with YOUR Cruise key. wrok.in is called at job start for the key, lane, whole-file read cap, base branch, tool output compression and model thinking saved on the Builder card plus a short-lived wrokin App token for this one repository (contents, pull_requests, issues — never workflows), and never during the run. The action reads the issue, pushes, opens the PR and comments with that token as wrokin[bot], so no 'Allow GitHub Actions to create and approve pull requests' setting is needed and your CI runs on the PR; it revokes the token at job end, and pi never holds it. A cruise_api_key input skips wrok.in entirely and uses the job's GITHUB_TOKEN instead (that path needs the repo setting). A run that opens a ready PR also reports it (verifiedReport), the record auto-merge requires.",
        "checkin": {
          "endpoint": "POST https://api.wrok.in/agent/checkin",
          "auth": "GitHub Actions OIDC token; the workflow needs `id-token: write`",
          "oidcAudience": "wrokin-agent",
          "body": ["oidc", "role"],
          "returns": ["cruise_api_key", "model", "cruise_base_url", "read_cap_kb", "base_branch", "compress_tool_output", "thinking", "github_token", "github_token_expires_at"],
          "githubTokenPermissions": ["contents", "pull_requests", "issues"],
          "defaultModel": "bb/builder",
          "refusals": {
            "401": "OIDC token didn't verify",
            "402": "plan doesn't include the Builder",
            "403": "wrokin isn't installed on the repository, or its installation lacks Contents/Pull requests/Issues: write (named; re-authorize the app)",
            "409": "add a Cruise key on the Builder card",
            "502": "couldn't mint the run's GitHub token; re-run"
          }
        },
        "verifiedReport": {
          "endpoint": "POST https://api.wrok.in/agent/verified",
          "auth": "GitHub Actions OIDC token; same audience as check-in",
          "oidcAudience": "wrokin-agent",
          "body": ["oidc", "pr", "head_sha"],
          "when": "only after the run opens a ready PR (its proof-run passed)",
          "note": "Auto-merge requires this record for the PR's current head sha, so a hand-added verified marker or a push after the run doesn't merge (#893).",
          "refusals": {
            "401": "OIDC token didn't verify",
            "403": "wrokin isn't installed on the repository",
            "409": "not this run's ready wrokin Builder PR, or its head moved past the reported sha"
          }
        }
      }
    }
  ],
  "triggers": {
    "webhookEvents": [
      "pull_request",
      "issues",
      "issue_comment"
    ],
    "actorGate": [
      "OWNER",
      "MEMBER",
      "COLLABORATOR"
    ],
    "actorGateNote": "Auto and on-demand runs require the PR/issue/comment author to hold one of these associations; anything else is silently ignored, so a third party on a public repo cannot spend the installer's tokens or quota."
  },
  "config": {
    "path": ".wrokin/config.yml",
    "aliases": [
      ".wrokin/config.yaml",
      ".pi/config.yml"
    ],
    "schema": "https://wrok.in/config.schema.json",
    "semantics": "sparse override of dashboard-stored settings; invalid entries are ignored and the rest of the file still applies (fails open to stored settings)"
  },
  "setupToken": {
    "mint": "human action in the dashboard (checkpoint 1) — POST /api/installations/{id}/setup-token behind the dashboard session",
    "api": "https://api.wrok.in/api/setup/* with Authorization: Bearer wst_…",
    "ttlSeconds": 3600,
    "scopes": ["read", "agents:write", "keys:write"],
    "scope": "keys + role behavior (enabled, provider, modelName, events, paths, thinking, reviewGuide, reviewGuideMinCoreLines, claimCheck), custom providers included; identity (name, avatarUrl, customInstructions) and billing fields are refused by name with a 403",
    "docs": "https://wrok.in/agents.md"
  },
  "apiTokens": {
    "create": "human action in the dashboard (Keys → API tokens) behind the dashboard session; a token can never create another token",
    "api": "https://api.wrok.in/api/setup/* with Authorization: Bearer wrk_…",
    "scopes": ["read", "agents:write", "keys:write", "billing", "identity"],
    "scope": "exactly the scopes the human chose at creation; identity and billing start off. A field or operation needing a scope the token lacks is refused by name with a 403",
    "expiresInDays": [7, 30, 90, 365],
    "maxPerInstallation": 25,
    "storage": "SHA-256 hash only; the value is shown once, at creation. Listed and revoked in the dashboard; DELETE /api/setup/token self-revokes",
    "docs": "https://wrok.in/agents.md"
  },
  "auditLog": {
    "records": "every successful write operation, from any interface, plus key removal, API-token create/revoke and setup-token mint/revoke; reads and refused calls are not recorded",
    "fields": ["at", "actor", "surface", "credential", "action", "target", "changes"],
    "surfaces": ["dashboard", "api", "mcp", "cli", "chat"],
    "changes": "field-level from/to; text over 200 characters is shortened. Never key or token material: keys.set records the provider, set vs rotated, and the last-4 hint",
    "api": "GET https://api.wrok.in/api/setup/audit?limit=&before= (scope read), or the dashboard (Keys → Audit log)",
    "maxPage": 100,
    "retentionDays": 365
  },
  "apiV1": {
    "list": "GET https://api.wrok.in/api/v1/operations",
    "call": "POST https://api.wrok.in/api/v1/operations/{name} with the operation's input as the JSON body",
    "auth": "Authorization: Bearer wrk_… or wst_…; the token's scopes apply",
    "exposure": "every operation except human-only; confirm-tier operations are refused with a dashboard link",
    "docs": "https://wrok.in/agents.md"
  },
  "mcp": {
    "url": "https://api.wrok.in/mcp",
    "transport": "streamable-http (stateless JSON over POST; no event stream)",
    "protocolVersions": ["2026-07-28", "2025-11-25", "2025-06-18", "2025-03-26", "2024-11-05"],
    "auth": "OAuth 2.1 (the host's Connect flow) or an Authorization: Bearer wrk_… / wst_… header",
    "oauth": {
      "issuer": "https://api.wrok.in",
      "discovery": "https://api.wrok.in/.well-known/oauth-protected-resource/mcp, then https://api.wrok.in/.well-known/oauth-authorization-server",
      "clientRegistration": "client ID metadata document (a URL client_id); RFC 7591 /oauth/register for hosts without one",
      "pkce": "S256, required",
      "consent": "a human picks one installation and the scopes on https://app.wrok.in; keys:write is never grantable",
      "accessTokenSeconds": 3600,
      "refreshTokenDays": 30,
      "revoke": "POST https://api.wrok.in/oauth/revoke, or Keys → Connected apps in the dashboard",
      "approverRecheck": "every refresh checks the approving GitHub account can still reach the installation; if not, the grant ends (a GitHub outage never ends one)"
    },
    "toolNames": "the operation name with dots as underscores; stable",
    "tools": ["installation_state", "installation_forge", "keys_delete", "keys_claim", "keys_owner", "projectsToken_status", "projectsToken_delete", "customProviders_list", "customProviders_create", "customProviders_configure", "customProviders_delete", "customProviders_models", "customProviders_checkModel", "agents_list", "agents_catalog", "agents_configure", "agents_create", "agents_delete", "audit_list", "runs_list", "runs_summary", "runs_context", "findings_list", "reviews_diagnose", "reviews_settings", "reviews_configure", "learnings_list", "learnings_configure", "learnings_delete", "learnings_mergePreview", "learnings_merge", "posture_get", "posture_scans", "posture_scan", "posture_settings", "posture_configure", "hunter_status", "hunter_enable", "hunter_disable", "hunter_settings", "hunter_configure", "hunter_dispatch", "builder_status", "builder_enable", "builder_disable", "builder_settings", "builder_configure", "billing_status", "billing_cancel"],
    "neverOffered": "operations with secretInput (keys.set, projectsToken.set): key and token material never passes through a model transcript",
    "docs": "https://wrok.in/agents.md"
  },
  "operations": {
    "note": "Every user action, defined once and served by every interface (dashboard, API, MCP, CLI, chat; #947). tier: read runs anywhere; write needs the scope; confirm always ends in an explicit confirmation; human-only stays in the dashboard. secretInput operations are never offered as MCP or chat tools: key material must not pass through a model transcript.",
    "scopes": ["read", "agents:write", "keys:write", "billing", "identity"],
    "list": [
      { "name": "installation.state", "tier": "read", "scope": "read", "summary": "Which providers have a key configured on this installation (never the keys)." },
      { "name": "installation.forge", "tier": "read", "scope": "read", "summary": "Which git forge this installation is on (GitHub, GitLab, …), what it calls repos and changes, and which wrokin features are available there — each missing one with the reason." },
      { "name": "keys.set", "tier": "write", "scope": "keys:write", "secretInput": true, "summary": "Set or rotate a provider's BYOK key. Encrypted at rest, never returned or logged. A custom provider whose URL was set outside the dashboard needs that URL repeated as confirmBaseUrl." },
      { "name": "keys.delete", "tier": "confirm", "scope": "keys:write", "summary": "Remove a provider's BYOK key; agents on that provider stop until one is set again. Needs a human to confirm it." },
      { "name": "keys.claim", "tier": "write", "scope": "keys:write", "summary": "Move this tenant's legacy tenant-filed keys into the caller's account, and run on them. Nothing moves until this runs." },
      { "name": "keys.owner", "tier": "write", "scope": "keys:write", "summary": "Run this tenant on your own account keys. Tenant admins only, and only to themselves." },
      { "name": "projectsToken.status", "tier": "read", "scope": "read", "summary": "Whether a GitHub Projects token is saved for board sync on user-owned Projects (never the token)." },
      { "name": "projectsToken.set", "tier": "write", "scope": "keys:write", "secretInput": true, "summary": "Save or rotate the GitHub Projects token (a fine-grained PAT with Projects: Read and write). Encrypted at rest, never returned or logged." },
      { "name": "projectsToken.delete", "tier": "confirm", "scope": "keys:write", "summary": "Remove the GitHub Projects token; board sync on user-owned Projects stops. Needs a human to confirm it." },
      { "name": "customProviders.list", "tier": "read", "scope": "read", "summary": "This installation's own OpenAI-compatible endpoints, each with whether its key is set (never the key), and how many it may define." },
      { "name": "customProviders.create", "tier": "write", "scope": "keys:write", "summary": "Define an OpenAI-compatible endpoint (public https only) for agents to run on; its id is custom:<slug>. Add its key afterwards with keys.set." },
      { "name": "customProviders.configure", "tier": "write", "scope": "keys:write", "summary": "Rename, re-describe or re-point one of this installation's endpoints; its slug never changes. Changing baseUrl on an endpoint that holds a key needs a human, in the dashboard." },
      { "name": "customProviders.delete", "tier": "confirm", "scope": "keys:write", "summary": "Remove one of this installation's endpoints AND its stored key; agents on it stop. Needs a human to confirm it." },
      { "name": "customProviders.models", "tier": "read", "scope": "read", "summary": "What one of this installation's endpoints serves for its stored key: the 'did my URL and key work?' answer. An empty list with a reason says why." },
      { "name": "customProviders.checkModel", "tier": "write", "scope": "agents:write", "summary": "Ask one endpoint whether one model is serving for its key: a single minimal request that spends a few tokens on the customer's key. The outcome is recorded for the picker." },
      { "name": "agents.list", "tier": "read", "scope": "read", "summary": "The effective agents for a repo: stored agents with its .wrokin/config.yml applied." },
      { "name": "agents.catalog", "tier": "read", "scope": "read", "summary": "What agents.create can use: templates with their defaults, persona presets, events, providers, the models this installation can pick (live Cruise lanes and custom endpoints included) and each role's model sizing." },
      { "name": "agents.configure", "tier": "write", "scope": "agents:write", "summary": "Change one of a repo's agents: enable/disable, model, events, paths and run settings; identity and billing with their scopes." },
      { "name": "agents.create", "tier": "write", "scope": "agents:write", "summary": "Add an agent to a repo from a template, with its model, events, paths and run settings; identity and billing with their scopes." },
      { "name": "agents.delete", "tier": "confirm", "scope": "agents:write", "summary": "Remove one of a repo's agents. Needs a human to confirm it; agents.configure with enabled: false stops it reversibly." },
      { "name": "audit.list", "tier": "read", "scope": "read", "summary": "Every change to this installation, newest first: who, through which interface and credential, and what changed." },
      { "name": "runs.list", "tier": "read", "scope": "read", "summary": "Recent agent runs, newest first: which agent ran on which PR or issue, with which model, and how it ended." },
      { "name": "runs.summary", "tier": "read", "scope": "read", "summary": "Run counts over the last N days (total, ok, failed) with a day-by-day series; skipped runs are neither ok nor failed." },
      { "name": "runs.context", "tier": "read", "scope": "read", "summary": "What Scout read for a run (its deliveryId from runs.list): the ranked file excerpts, guidance docs and what it pruned. Kept 7 days." },
      { "name": "findings.list", "tier": "read", "scope": "read", "summary": "Recent Security Hunter findings, newest first, with severity, location, verification verdict and suggested fix." },
      { "name": "reviews.diagnose", "tier": "read", "scope": "read", "summary": "Why a PR did or did not get an automatic review: every gate it passes or fails (author, skip label, pause, quota, agents), what each review agent would do on the next push, and the PR's recent runs." },
      { "name": "reviews.settings", "tier": "read", "scope": "read", "summary": "A repo's review settings: the GitHub App bots whose PRs are reviewed automatically (trustedBotAuthors)." },
      { "name": "reviews.configure", "tier": "write", "scope": "agents:write", "summary": "Replace the bots whose PRs a repo reviews automatically. Bot PRs are skipped unless listed, since each review spends tokens." },
      { "name": "learnings.list", "tier": "read", "scope": "read", "summary": "A repo's review learnings, most recently confirmed first: the confirmed corrections its next reviews read as conventions. The first `promptLimit` are the ones the next review reads." },
      { "name": "learnings.configure", "tier": "write", "scope": "agents:write", "summary": "Reword a repo learning. Only the wording changes; where it came from (PR, comment, actor) stays as provenance." },
      { "name": "learnings.delete", "tier": "confirm", "scope": "agents:write", "summary": "Delete a repo learning; its next reviews stop reading it. Deleting what is already gone still answers ok." },
      { "name": "learnings.mergePreview", "tier": "write", "scope": "agents:write", "summary": "Propose a merge of a repo's stored learnings: duplicates folded into one, and wordings fixed to read as conventions. One model call on the repo's code-review agent; changes nothing. Pass the plan to learnings.merge to apply it." },
      { "name": "learnings.merge", "tier": "confirm", "scope": "agents:write", "summary": "Apply a plan from learnings.mergePreview exactly as previewed, no model call: folded learnings are deleted and their provenance kept as sources. Refused if any learning it touches changed since." },
      { "name": "posture.get", "tier": "read", "scope": "read", "summary": "A repo's latest Warden posture scan: every check with its tier, pass/fail, evidence and remediation. scan is null if never scanned." },
      { "name": "posture.scans", "tier": "read", "scope": "read", "summary": "A repo's Warden scans, newest first, with their counts per tier: how its posture drifted over time." },
      { "name": "posture.scan", "tier": "write", "scope": "agents:write", "summary": "Queue a Warden posture scan of a repo; read it with posture.get once it lands. A repeat within 90 seconds is debounced, not queued." },
      { "name": "posture.settings", "tier": "read", "scope": "read", "summary": "A repo's Warden settings: whether its posture report is filed as a tracked GitHub issue (reportAsIssues)." },
      { "name": "posture.configure", "tier": "write", "scope": "agents:write", "summary": "Turn on or off filing a repo's Warden posture report as a tracked GitHub issue." },
      { "name": "hunter.status", "tier": "read", "scope": "read", "summary": "Whether the Hunter is set up on a repo, read live from the forge: active (with disablePrNumber when its removal PR awaits merge), pr_open (its setup PR awaits merge, with the PR) or disabled." },
      { "name": "hunter.enable", "tier": "confirm", "scope": "agents:write", "summary": "Open the setup PR that adds the Hunter's workflow to a repo (or return the one already open), saving its trigger policy first. Needs a human to confirm it." },
      { "name": "hunter.disable", "tier": "confirm", "scope": "agents:write", "summary": "Open the PR that removes the Hunter's workflow from a repo (or return the one already open); if only its setup PR is open, close that instead. Its settings are kept. Needs a human to confirm it." },
      { "name": "hunter.settings", "tier": "read", "scope": "read", "summary": "A repo's Hunter settings: reportAsIssues (file confirmed findings as issues), surfaceUnverified (show the unverified tier) and trigger (when automatic hunts run)." },
      { "name": "hunter.configure", "tier": "write", "scope": "agents:write", "summary": "Change a repo's Hunter settings: reportAsIssues, surfaceUnverified and/or trigger. A field left out is left alone; trigger replaces the whole policy." },
      { "name": "hunter.dispatch", "tier": "write", "scope": "agents:write", "summary": "Run a hunt on one PR now, at a level (default stakeout), whatever the trigger policy says. Spends a scan; the repo must have the Hunter enabled." },
      { "name": "builder.status", "tier": "read", "scope": "read", "summary": "Whether the Verified Builder is set up on a repo, read live from the forge (active, with disablePrNumber when its removal PR awaits merge; pr_open or disabled), and whether this account's plan includes it (entitled, with the reason when not)." },
      { "name": "builder.enable", "tier": "confirm", "scope": "agents:write", "summary": "Open the setup PR that adds the Verified Builder's workflow to a repo (or return the one already open). Needs a human to confirm it." },
      { "name": "builder.disable", "tier": "confirm", "scope": "agents:write", "summary": "Open the PR that removes the Verified Builder's workflow from a repo (or return the one already open); if only its setup PR is open, close that instead. Its settings are kept. Needs a human to confirm it." },
      { "name": "builder.settings", "tier": "read", "scope": "read", "summary": "A repo's Verified Builder settings (autoMerge, model, readCapKb, baseBranch, compressToolOutput, thinking) and whether the plan allows auto-merge at all." },
      { "name": "builder.configure", "tier": "write", "scope": "agents:write", "summary": "Change a repo's Verified Builder settings: autoMerge, model (a Cruise lane or model id), readCapKb, baseBranch, compressToolOutput, thinking. A field left out is left alone. Turning autoMerge on needs a human, in the dashboard." },
      { "name": "billing.status", "tier": "read", "scope": "read", "summary": "The installation's plan, this month's run quota (used and limit, monthly and daily) and its managed-agent credit balance." },
      { "name": "billing.cancel", "tier": "confirm", "scope": "billing", "summary": "Cancel the installation's paid subscription at the end of the period already paid for; the plan stays until then. Needs a human to confirm it." }
    ]
  },
  "plans": [
    {
      "name": "Free",
      "monthlyRuns": 150
    },
    {
      "name": "Pro",
      "monthlyRuns": 1000
    },
    {
      "name": "Team",
      "monthlyRuns": 3000
    },
    {
      "name": "Business",
      "monthlyRuns": 20000
    }
  ],
  "quotaNotes": "monthlyRuns meters BYOK agent runs, counted once per delivery (a multi-agent run on one PR event is one run). Warden runs count (they are runs; they spend no tokens). A daily cap of max(50, monthlyRuns/10) bounds single-day runaways. Managed Hunter spend is metered separately and never draws down monthlyRuns. Free open-source reviews (public repos, no key set) count toward monthlyRuns too, with their own limits: one per account every 45 minutes, diffs up to 200 KB, and a global daily budget.",
  "pricing": "https://wrok.in/#pricing",
  "qualityFeedback": {
    "reactions": "👍/👎 on a wrokin review comment is recorded as an agree/disagree verdict against that comment's model when the PR closes; collaborators only",
    "command": "/w wrong [comment-link] <reason> records a false-claim verdict, with the reason — against the linked review comment, or the latest wrokin review comment when no target is given",
    "feeds": "per-provider×model quality metrics, attributed to the model that actually answered — for a request routed to a pool, the member that served it",
    "evidence": "https://api.wrok.in/quality"
  },
  "dataHandling": {
    "reviewCall": "the diff and bounded repo context go to the customer's chosen model provider under the customer's own key",
    "freeOssReview": "public repos only, when the reviewing agent has no customer key: the diff and bounded context go on wrokin's key to a Cruise oss/* lane, whose model may train on it (today: Meta's Muse Spark contributor tier); private repos and custom endpoints never take this path",
    "telemetry": "wrokin stores finding locations (file/line/severity) and outcomes — not the prose of findings, and not code",
    "workflowRunsCache": "the dashboard's Runs page caches GitHub Actions run metadata (repo, workflow, branch, status, actor, run title) for up to 5 minutes, then it expires; no logs, no code",
    "details": [
      "https://wrok.in/data-handling.html",
      "https://wrok.in/privacy.html",
      "https://wrok.in/dpa.html"
    ]
  }
}
