> ## Documentation Index > Fetch the complete documentation index at: https://www.runmirrors.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Service verbs Every action the product offers is one verb in the registry; the web app calls it over tRPC, the CLI as its dotted words, and the hosted MCP server as a tool named with underscores. Inputs and outputs are the schemas named here, from the contracts package. Verbs marked as spending compute run models or start tasks; long-running ones answer with an id to poll. Generated by `pnpm docs:generate`; do not edit by hand. ## identity | Verb | Kind | Input | Output | MCP tool | CLI | Notes | | ------------------------------- | --------------------------------------------------------------------------------------- | ---------------------- | ---------------------- | -------------------- | ------------------------------- | ----- | | `identity.access.status` | read | `empty` | `accessStatus` | | `identity access status` | | | | The caller's access state, email, workspace and admin flag. | | | | | | | `identity.keys.list` | read | `empty` | `apiKey[]` | | `identity keys list` | | | | The workspace's live API keys: id, hint, label, created and last used. | | | | | | | `identity.keys.mint` | write | `mintKeyRequest` | `mintedKey` | `identity_keys_mint` | `identity keys mint` | | | | Mint a workspace API key; the plaintext is returned once and never stored. | | | | | | | `identity.keys.revoke` | delete | `keyRef` | `empty` | | `identity keys revoke` | | | | Revoke one of the workspace's API keys by id. | | | | | | | `identity.keys.revokeAll` | delete | `empty` | `empty` | | `identity keys revokeAll` | | | | Revoke every API key of the workspace at once. | | | | | | | `identity.oauth.consentRead` | read | `oauthConsentRequest` | `oauthConsentRequest` | | | | | | What a pending MCP sign-in asks for: the client, scope and where it returns. | | | | | | | `identity.oauth.consentDecide` | write | `oauthConsentDecision` | `oauthConsentResult` | | | | | | Approve or deny a pending MCP sign-in; approval binds the workspace and returns a code. | | | | | | | `identity.github.connectUrl` | read | `empty` | `githubConnectUrl` | | `identity github connectUrl` | | | | Where to send the browser to install the GitHub App for this workspace. | | | | | | | `identity.github.installations` | read | `empty` | `githubInstallation[]` | | `identity github installations` | | | | The workspace's GitHub installations with the repositories each can read. | | | | | | | `identity.whoami` | read | `empty` | `whoami` | `identity_whoami` | `identity whoami` | | | | The caller's workspace, credential kind, admin flag, access state and mirror count. | | | | | | ## admin | Verb | Kind | Input | Output | MCP tool | CLI | Notes | | ------------------------------- | --------------------------------------------------------------------------------------------------- | --------------------- | ---------------------- | -------- | ------------------------------- | ----- | | `admin.accounts.search` | read | `accountSearch` | `accountPage` | | `admin accounts search` | admin | | | Search accounts by email or workspace substring with access and plan filters, paged. | | | | | | | `admin.accounts.lookup` | read | `emailRef` | `account` | | `admin accounts lookup` | admin | | | One account in full, found by a member's email. | | | | | | | `admin.accounts.get` | read | `workspaceRef` | `account` | | `admin accounts get` | admin | | | One account in full: members, mirrors, plan, subscription, trial, offer, usage, cycle day. | | | | | | | `admin.plans.catalog` | read | `empty` | `adminPlanCatalog` | | `admin plans catalog` | admin | | | Which plans are assignable, offerable, purchasable and available (priced). | | | | | | | `admin.access.users` | read | `empty` | `accessStatus[]` | | `admin access users` | admin | | | Every account's access state, for the access console. | | | | | | | `admin.access.grant` | write (idempotent) | `emailRef` | `accessStatus` | | `admin access grant` | admin | | | Grant access to the account with this email; the access email goes out. | | | | | | | `admin.access.revoke` | write (idempotent) | `emailRef` | `accessStatus` | | `admin access revoke` | admin | | | Revoke access from the account with this email. | | | | | | | `admin.accounts.edit` | write | `accountEdit` | `account` | | `admin accounts edit` | admin | | | Change an account's plan, status, ceilings or cycle day; refused on a live Stripe subscription. | | | | | | | `admin.accounts.grantTrial` | write | `trialGrant` | `account` | | `admin accounts grantTrial` | admin | | | Grant a dated trial (21 days by default); refuses to overwrite a paying plan. | | | | | | | `admin.accounts.endTrial` | write | `workspaceRef` | `account` | | `admin accounts endTrial` | admin | | | End an account's trial now. | | | | | | | `admin.accounts.offer` | write | `planOfferRequest` | `account` | | `admin accounts offer` | admin | | | Offer a plan for a window (30 days by default, open-ended with 0), optionally ending a manual plan. | | | | | | | `admin.accounts.withdrawOffer` | write | `workspaceRef` | `account` | | `admin accounts withdrawOffer` | admin | | | Withdraw an account's plan offer. | | | | | | | `admin.email.activity` | read | `emailActivityQuery` | `emailPage` | | `admin email activity` | admin | | | Every email the product sent, filtered by kind, status or workspace, paged. | | | | | | | `admin.email.health` | read | `emailHealthQuery` | `emailHealth` | | `admin email health` | admin | | | Failure and delivery rates over a window of hours. | | | | | | | `admin.email.message` | read | `messageRef` | `emailMessage` | | `admin email message` | admin | | | One message with its rendered body and delivery events. | | | | | | | `admin.email.templates.list` | read | `empty` | `emailTemplateEntry[]` | | `admin email templates list` | admin | | | The catalogue of every message kind with its kill switch and word overrides. | | | | | | | `admin.email.templates.save` | write (idempotent) | `emailTemplateSave` | `emailTemplateEntry` | | `admin email templates save` | admin | | | Switch a kind on or off and override its words; never markup. | | | | | | | `admin.email.templates.reset` | write (idempotent) | `emailKindRef` | `emailTemplateEntry` | | `admin email templates reset` | admin | | | Back to the code's copy, switched on. | | | | | | | `admin.email.templates.preview` | read | `emailPreviewRequest` | `emailRendered` | | `admin email templates preview` | admin | | | The kind rendered with its overrides over a context or the sample. | | | | | | | `admin.email.resend` | write | `messageRef` | `emailSummary` | | `admin email resend` | admin | | | The stored body sent again verbatim. | | | | | | | `admin.email.manual.preview` | read | `manualEmail` | `emailRendered` | | `admin email manual preview` | admin | | | A hand-written message rendered, not sent. | | | | | | | `admin.email.manual.send` | write | `manualEmail` | `emailSummary` | | `admin email manual send` | admin | | | A hand-written message sent through the logged funnel as kind manual. | | | | | | | `admin.twins.live` | read | `empty` | `liveTwin[]` | | `admin twins live` | admin | | | Every twin booting or running, with its task, endpoint and last touch. | | | | | | ## billing | Verb | Kind | Input | Output | MCP tool | CLI | Notes | | ------------------ | -------------------------------------------------------------------------------------------- | ----------------- | ------------------ | ---------------- | ------------------ | ----- | | `billing.status` | read | `empty` | `billingStatus` | `billing_status` | `billing status` | | | | The workspace's plan, whether it is active, its ceilings, offer and period. | | | | | | | `billing.usage` | read | `empty` | `usage` | `billing_usage` | `billing usage` | | | | This billing period's replay minutes, credits and model spend, with the over flags. | | | | | | | `billing.checkout` | write | `checkoutRequest` | `checkoutResponse` | | `billing checkout` | | | | A Stripe checkout for a purchasable or offered plan; returns the URL to send the browser to. | | | | | | | `billing.cancel` | write (idempotent) | `empty` | `billingStatus` | | `billing cancel` | | | | Cancel the Stripe subscription at the end of the period. | | | | | | | `billing.resume` | write (idempotent) | `empty` | `billingStatus` | | `billing resume` | | | | Undo a pending cancellation before the period ends. | | | | | | ## mirrors | Verb | Kind | Input | Output | MCP tool | CLI | Notes | | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | ---------------------- | ----------------------------- | ----------------------------- | --------------------------------------------- | | `mirrors.list` | read | `empty` | `mirrorSummary[]` | `mirrors_list` | `mirrors list` | | | | List the workspace's mirrors with their derived status and active build headline. | | | | | | | `mirrors.get` | read | `mirrorRef` | `mirrorDetail` | `mirrors_get` | `mirrors get` | mirror required | | | One mirror in full: status, config version, builds and transpilers counts, the pin. | | | | | | | `mirrors.create` | write | `mirrorCreate` | `mirrorSummary` | `mirrors_create` | `mirrors create` | | | | Create an empty mirror by name; traces and uploads attach to it afterwards. | | | | | | | `mirrors.delete` | delete | `mirrorRef` | `purgeReport` | `mirrors_delete` | `mirrors delete` | mirror required | | | Delete a mirror and everything it owns; the report lists what could not be removed. | | | | | | | `mirrors.tools.get` | read | `mirrorRef` | `toolPage` | `mirrors_tools_get` | `mirrors tools get` | mirror required | | | One tool's page: profile, operation, drift, levers, overrides and recorded examples. | | | | | | | `mirrors.world.get` | read | `mirrorRef` | `worldView` | `mirrors_world_get` | `mirrors world get` | mirror required | | | The active build's world model and its summary. | | | | | | | `mirrors.traces.list` | read | `mirrorRef` | `traceSummary[]` | `mirrors_traces_list` | `mirrors traces list` | mirror required | | | The recorded conversations the active build was built from, with their tools. | | | | | | | `mirrors.builds.request` | write | `buildRequest` | `build` | `mirrors_builds_request` | `mirrors builds request` | spends compute, long-running, mirror required | | | Snapshot the mirror's inputs and start a build; returns the build to poll. | | | | | | | `mirrors.builds.list` | read | `mirrorRef` | `build[]` | `mirrors_builds_list` | `mirrors builds list` | mirror required | | | The mirror's builds, newest first. | | | | | | | `mirrors.builds.get` | read | `mirrorRef` | `build` | `mirrors_builds_get` | `mirrors builds get` | mirror required | | | One build: status, headline or error. | | | | | | | `mirrors.builds.log` | read | `mirrorRef` | `buildLogLine[]` | `mirrors_builds_log` | `mirrors builds log` | mirror required | | | The build log after a line number, for tailing. | | | | | | | `mirrors.builds.report` | read | `mirrorRef` | `buildReport` | `mirrors_builds_report` | `mirrors builds report` | mirror required | | | A build's report: fidelity, coverage, evidence, projections. | | | | | | | `mirrors.builds.drift` | read | `mirrorRef` | `driftReport` | `mirrors_builds_drift` | `mirrors builds drift` | mirror required | | | A build's drift report. | | | | | | | `mirrors.builds.diff` | read | `mirrorRef` | `buildDiff` | `mirrors_builds_diff` | `mirrors builds diff` | mirror required | | | What changed between two builds: world, bindings, scores, drift. | | | | | | | `mirrors.builds.activate` | write (idempotent) | `activateRequest` | `build` | `mirrors_builds_activate` | `mirrors builds activate` | mirror required | | | Serve this build; a running twin restarts onto it. | | | | | | | `mirrors.builds.pin` | write (idempotent) | `pinRequest` | `mirrorDetail` | `mirrors_builds_pin` | `mirrors builds pin` | mirror required | | | Pin the mirror to a build (null unpins and activates the newest). | | | | | | | `mirrors.config.get` | read | `mirrorRef` | `configVersion` | `mirrors_config_get` | `mirrors config get` | mirror required | | | The current config version: knobs, overrides, scenarios, review. | | | | | | | `mirrors.config.history` | read | `mirrorRef` | `configHistoryEntry[]` | `mirrors_config_history` | `mirrors config history` | mirror required | | | Every config version with who applied it, why, and its review state. | | | | | | | `mirrors.config.change` | write | `configChange` | `configVersion` | `mirrors_config_change` | `mirrors config change` | mirror required | | | Apply a config change as a new version (a person's is approved at once). | | | | | | | `mirrors.config.revert` | write | `mirrorRef` | `configVersion` | `mirrors_config_revert` | `mirrors config revert` | mirror required | | | A new version copied from an older one. | | | | | | | `mirrors.config.approve` | write (idempotent) | `mirrorRef` | `configVersion` | `mirrors_config_approve` | `mirrors config approve` | mirror required | | | Approve an agent-applied config version. | | | | | | | `mirrors.transpilers.list` | read | `mirrorRef` | `transpilerVersion[]` | `mirrors_transpilers_list` | `mirrors transpilers list` | mirror required | | | The mirror's agent-written transpiler versions with their previews. | | | | | | | `mirrors.transpilers.revert` | write | `mirrorRef` | `transpilerVersion` | `mirrors_transpilers_revert` | `mirrors transpilers revert` | mirror required | | | Revert a transpiler version; the stream is re-read without it. | | | | | | | `mirrors.transpilers.approve` | write (idempotent) | `mirrorRef` | `transpilerVersion` | `mirrors_transpilers_approve` | `mirrors transpilers approve` | mirror required | | | Approve an agent-written transpiler version. | | | | | | | `mirrors.context.list` | read | `mirrorRef` | `contextSource[]` | `mirrors_context_list` | `mirrors context list` | mirror required | | | The mirror's context sources. | | | | | | | `mirrors.context.add` | write | `contextAdd` | `contextSource` | `mirrors_context_add` | `mirrors context add` | mirror required | | | Add a note, chat or summary as a context source. | | | | | | | `mirrors.context.update` | write | `contextUpdate` | `contextSource` | `mirrors_context_update` | `mirrors context update` | mirror required | | | Change a context source's text or enable and disable it. | | | | | | | `mirrors.uploads.reserve` | write | `uploadReserveRequest` | `uploadSlot` | `mirrors_uploads_reserve` | `mirrors uploads reserve` | | | | Reserve an upload slot by kind, file name and size; returns where to PUT the bytes. | | | | | | | `mirrors.uploads.consume` | write | `uploadRecord` | `uploadRecord` | `mirrors_uploads_consume` | `mirrors uploads consume` | mirror required | | | Attach a received upload to a mirror as the next version of its kind; documents become context. | | | | | | | `mirrors.assets.get` | read | `mirrorRef` | `assetGraph` | `mirrors_assets_get` | `mirrors assets get` | mirror required | | | The asset graph of the active build: agent, database, API and simulator nodes with per-tool fidelity. | | | | | | | `mirrors.tools.list` | read | `mirrorRef` | `toolProfile[]` | `mirrors_tools_list` | `mirrors tools list` | mirror required | | | Every tool of the active build with its binding, evidence, scores, drift and overrides. | | | | | | | `mirrors.traces.add` | write | `traceAdd` | `collectResponse` | `mirrors_traces_add` | `mirrors traces add` | mirror required | | | Add traces to a mirror directly, under the collect endpoint's rules (supersession, caps, pending shapes). | | | | | | | `mirrors.context.remove` | delete | `contextRemove` | `empty` | `mirrors_context_remove` | `mirrors context remove` | mirror required | | | Remove a context source for good; builds that read it keep their snapshot. | | | | | | | `mirrors.builds.intake` | write | `buildIntakeRequest` | `ingestJob` | `mirrors_builds_intake` | `mirrors builds intake` | spends compute | | | Build a mirror from files given inline, by URL or by upload id (traces, agent, tools, schema, openapi, toolDefs, docs); answers with the job to poll. | | | | | | | `mirrors.search` | read | `searchQuery` | `searchResult` | `mirrors_search` | `mirrors search` | | | | Full text over the workspace's mirrors and the tools of their active builds. | | | | | | | `mirrors.fetch` | read | `fetchRequest` | `fetchResult` | `mirrors_fetch` | `mirrors fetch` | | | | One search hit in full: a mirror's detail or a tool's profile page. | | | | | | | `mirrors.overview` | read | `empty` | `overview` | `mirrors_overview` | `mirrors overview` | | | | The dashboard: headline stats over the workspace's mirrors and their summaries. | | | | | | ## runtime | Verb | Kind | Input | Output | MCP tool | CLI | Notes | | ---------------------------- | ------------------------------------------------------------------------------------------ | -------------------- | ------------------- | ---------------------------- | ---------------------------- | ------------------------------- | | `runtime.twin.status` | read | `mirrorRef` | `twinStatus` | `runtime_twin_status` | `runtime twin status` | mirror required | | | The twin's state, the build it serves, its endpoint and downgraded tools. | | | | | | | `runtime.twin.start` | write | `mirrorRef` | `twinStatus` | `runtime_twin_start` | `runtime twin start` | spends compute, mirror required | | | Wake the twin from the active build and wait until it answers healthy. | | | | | | | `runtime.twin.stop` | write (idempotent) | `mirrorRef` | `twinStatus` | `runtime_twin_stop` | `runtime twin stop` | mirror required | | | Stop the twin's task, close its sessions and meter the minutes. | | | | | | | `runtime.twin.logs` | read | `twinLogsQuery` | `taskLogs` | `runtime_twin_logs` | `runtime twin logs` | mirror required | | | The twin task's log lines, paged by a cursor. | | | | | | | `runtime.console.open` | write | `consoleOpen` | `consoleSession` | `runtime_console_open` | `runtime console open` | spends compute, mirror required | | | Open a console session on the twin (woken if needed) with seed instructions or a scenario. | | | | | | | `runtime.console.invoke` | write | `consoleCall` | `callResult` | `runtime_console_invoke` | `runtime console invoke` | spends compute | | | Call one tool in a console session and get the twin's answer. | | | | | | | `runtime.console.info` | read | `consoleSessionRef` | `sessionInfo` | `runtime_console_info` | `runtime console info` | | | | A console session's counts, fidelity mix and state hash. | | | | | | | `runtime.console.transcript` | read | `consoleSessionRef` | `transcript` | `runtime_console_transcript` | `runtime console transcript` | | | | The call ledger of a console session in order. | | | | | | | `runtime.console.close` | delete | `consoleSessionRef` | `deleteResponse` | `runtime_console_close` | `runtime console close` | | | | End a console session and free its workspace on the twin. | | | | | | | `runtime.replay.accuracy` | write | `accuracyRequest` | `replayReport` | `runtime_replay_accuracy` | `runtime replay accuracy` | spends compute, mirror required | | | Replay a seeded sample of recordings on the running twin and report conformance. | | | | | | | `runtime.replay.trace` | write | `traceReplayRequest` | `traceReplayResult` | `runtime_replay_trace` | `runtime replay trace` | spends compute, mirror required | | | Replay one production trace through the running twin and diff each call. | | | | | | ## improve | Verb | Kind | Input | Output | MCP tool | CLI | Notes | | -------------------------- | ------------------------------------------------------------------------------------------------------- | ---------------------- | ------------------ | -------------------------- | -------------------------- | ------------------------------- | | `improve.summary.get` | read | `mirrorRef` | `summaryView` | `improve_summary_get` | `improve summary get` | mirror required | | | The mirror's business summary and whether it is empty, distilled or edited. | | | | | | | `improve.summary.set` | write (idempotent) | `summarySet` | `summaryView` | `improve_summary_set` | `improve summary set` | mirror required | | | Write the business summary by hand; every build folds it in first. | | | | | | | `improve.summary.distil` | write | `distillRequest` | `summaryView` | `improve_summary_distil` | `improve summary distil` | spends compute, mirror required | | | Distil the summary from every enabled context source with the model; force overwrites an edited one. | | | | | | | `improve.context.preview` | read | `mirrorRef` | `contextBlock` | `improve_context_preview` | `improve context preview` | mirror required | | | The budgeted context block a build-time model call receives, with what was folded in. | | | | | | | `improve.proposals.draft` | write | `proposalDraftRequest` | `proposal` | `improve_proposals_draft` | `improve proposals draft` | spends compute, mirror required | | | Draft a proposal from a build's drift report: overrides where a lever is mechanical, actions otherwise. | | | | | | | `improve.proposals.list` | read | `mirrorRef` | `proposal[]` | `improve_proposals_list` | `improve proposals list` | mirror required | | | The mirror's proposals, newest first, with their decisions and verifications. | | | | | | | `improve.proposals.get` | read | `proposalRef` | `proposal` | `improve_proposals_get` | `improve proposals get` | mirror required | | | One proposal in full: rationale, changeset, prediction and verification. | | | | | | | `improve.proposals.decide` | write | `proposalDecide` | `proposalAccepted` | `improve_proposals_decide` | `improve proposals decide` | spends compute, mirror required | | | Accept a proposal (a config version and a build) or reject it with a note. | | | | | | | `improve.review.list` | read | `mirrorRef` | `reviewItem[]` | `improve_review_list` | `improve review list` | mirror required | | | What agents applied and nobody has reviewed: config versions, transpilers, draft proposals. | | | | | | | `improve.review.decide` | write | `reviewDecide` | `reviewItem` | `improve_review_decide` | `improve review decide` | mirror required | | | Approve, revert or correct one review item; the queue no longer lists it. | | | | | | | `improve.assistant.state` | read | `mirrorRef` | `assistantState` | `improve_assistant_state` | `improve assistant state` | mirror required | | | The setup assistant's recent turns, the scenarios and hints in config, pending reviews. | | | | | | | `improve.assistant.turn` | write | `assistantTurn` | `assistantState` | `improve_assistant_turn` | `improve assistant turn` | spends compute, mirror required | | | One turn to the setup assistant: a seed, a hint or a question, answered in state. | | | | | | ## agents | Verb | Kind | Input | Output | MCP tool | CLI | Notes | | -------------------------- | ---------------------------------------------------------------------------------------------------------- | --------------------- | ------------------- | -------------------------- | -------------------------- | --------------------------------------------- | | `agents.setup.start` | write | `setupStart` | `setupSession` | `agents_setup_start` | `agents setup start` | spends compute, long-running | | | Start an onboarding session: the agent greets, asks for a name, and takes it from there. | | | | | | | `agents.setup.get` | read | `setupRef` | `setupSession` | `agents_setup_get` | `agents setup get` | | | | The session's state, messages and thinking flag; reading advances server work (a GitHub install noticed). | | | | | | | `agents.setup.reply` | write | `setupReplyRequest` | `setupSession` | `agents_setup_reply` | `agents setup reply` | spends compute, long-running | | | Answer the agent with text, a choice from a picker, or attachments (upload ids); wakes the loop. | | | | | | | `agents.setup.attach` | write | `setupAttach` | `setupSession` | `agents_setup_attach` | `agents setup attach` | | | | Attach uploaded files to the session's mirror by upload id (traces, tools, documents). | | | | | | | `agents.setup.reset` | write | `setupRef` | `setupSession` | `agents_setup_reset` | `agents setup reset` | | | | Start the session over: the transcript is cleared, the mirror kept. | | | | | | | `agents.discovery.correct` | write | `discoveryCorrection` | `empty` | `agents_discovery_correct` | `agents discovery correct` | spends compute, mirror required | | | Tell the discovery agent, in words, what its transpiler got wrong; a new version replaces the active one. | | | | | | | `agents.build.run` | write | `buildAgentRequest` | `buildAgentOutcome` | `agents_build_run` | `agents build run` | spends compute, long-running, mirror required | | | Ask the build agent for a verified build: it builds, repairs failures within three attempts, and verifies. | | | | | | | `agents.build.outcome` | read | `mirrorRef` | `buildAgentOutcome` | `agents_build_outcome` | `agents build outcome` | mirror required | | | The build agent's latest outcome for a mirror: verified, unverified or escalated, with the repair ledger. | | | | | | | `agents.runs.list` | read | `agentRunQuery` | `agentRun[]` | `agents_runs_list` | `agents runs list` | | | | The agents' run records for the workspace: agent, trigger, steps, spend, outcome. | | | | | |