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. |
