mirab 0.0.0 → 0.2.0

package/src/api/contract.ts

@@ -0,0 +1,2454 @@
+// Generated by gild-site/scripts/generate-api-client.mjs. Edit the site source.
+import { channelMessage, channelPage, channelInput, channelQuery, channelParticipants, channelCursor } from './channel-contract.ts'
+import { orchestratorList, orchestratorGrant, orchestratorInput, orchestratorRevoked, childInput, childAgent, spawnedChild, suspension } from './orchestrator-contract.ts'
+import { importInput, importSummary, importStatus, importAssignment, importCredentials, importProgress, importBatch } from './import-contract.ts'
+import {
+  runnerRegistration,
+  runnerGroup,
+  groupInput,
+} from './runner-contract.ts'
+import {
+  renameStatus,
+  profileSchema,
+  profileInput,
+} from './settings-contract.ts'
+import { sessionInput, receiptSchema } from './sessions-contract.ts'
+import {
+  hookInput,
+  hookPatch,
+  hookSchema,
+  deliverySchema,
+  eventPage,
+} from './events-contract.ts'
+// Canonical API contract. Runtime validation, wiring, docs, OpenAPI and the
+// generated CLI client consume these definitions; do not maintain route lists.
+import { z } from 'zod'
+import { SCOPES, type Scope } from './scopes.ts'
+const text = z.string(),
+  integer = z.number().int(),
+  sha = text.regex(/^[a-f0-9]{40}$/),
+  url = text
+const user = z.object({
+  login: text,
+  id: integer,
+  type: z.enum(['User', 'Organization', 'Bot']),
+  html_url: url,
+})
+const label = z.object({
+  id: integer,
+  name: text,
+  color: text,
+  description: text.nullable(),
+})
+const repository = z.object({
+  id: integer,
+  name: text,
+  full_name: text,
+  owner: user,
+  private: z.boolean(),
+  stargazers_count: integer.nonnegative(),
+  description: text.nullable(),
+  default_branch: text,
+  html_url: url,
+  url,
+  clone_url: url,
+  created_at: text,
+  updated_at: text,
+})
+const comment = z.object({
+  id: integer,
+  node_id: text,
+  user,
+  body: text,
+  created_at: text,
+  updated_at: text,
+  html_url: url,
+  url,
+})
+const issue = z.object({
+  id: integer,
+  number: integer,
+  title: text,
+  body: text,
+  user,
+  state: z.enum(['open', 'closed']),
+  labels: z.array(label),
+  comments: integer,
+  created_at: text,
+  updated_at: text,
+  closed_at: text.nullable(),
+  html_url: url,
+  url,
+  pull_request: z.object({ url, html_url: url }).optional(),
+})
+const branch = z.object({
+  name: text,
+  commit: z.object({ sha, url }),
+  protected: z.boolean(),
+})
+const ref = z.object({
+  ref: text,
+  node_id: text,
+  url,
+  object: z.object({ type: z.enum(['commit', 'tag']), sha, url }),
+})
+const gitAuthor = z.object({ name: text, email: text, date: text })
+const commit = z.object({
+  sha,
+  node_id: text,
+  url,
+  html_url: url,
+  commit: z.object({
+    message: text,
+    author: gitAuthor,
+    committer: gitAuthor,
+    tree: z.object({ sha, url }),
+    comment_count: integer,
+  }),
+  author: user.nullable(),
+  committer: user.nullable(),
+  parents: z.array(z.object({ sha, url, html_url: url })),
+})
+const fileDiff = z.object({
+  sha,
+  filename: text,
+  status: z.enum(['added', 'removed', 'modified', 'renamed']),
+  additions: integer,
+  deletions: integer,
+  changes: integer,
+  patch: text.optional(),
+  blob_url: url,
+  raw_url: url,
+  contents_url: url,
+})
+const pull = issue.extend({
+  head: z.object({ label: text, ref: text, sha, repo: repository }),
+  base: z.object({ label: text, ref: text, sha, repo: repository }),
+  merged: z.boolean(),
+  merged_at: text.nullable(),
+  merge_commit_sha: sha.nullable(),
+  mergeable: z.boolean().nullable(),
+  draft: z.boolean(),
+  diff_url: url,
+  patch_url: url,
+})
+const review = z.object({
+  id: integer,
+  user,
+  body: text,
+  state: z.enum(['APPROVED', 'CHANGES_REQUESTED', 'COMMENTED']),
+  submitted_at: text,
+  commit_id: sha.nullable(),
+  html_url: url,
+})
+const content = z.object({
+  type: z.enum(['file', 'dir', 'symlink', 'submodule']),
+  name: text,
+  path: text,
+  sha,
+  size: integer,
+  url,
+  html_url: url,
+  git_url: url,
+  download_url: url.nullable(),
+  encoding: text.optional(),
+  content: text.optional(),
+})
+const treeEntry = z.object({
+  path: text,
+  mode: text,
+  type: z.enum(['tree', 'blob', 'commit']),
+  sha,
+  size: integer.optional(),
+  url,
+})
+const changeFile = z.object({
+  path: text,
+  status: z.enum(['added', 'removed', 'modified']),
+  additions: integer,
+  deletions: integer,
+  hunks: z.array(
+    z.object({ oldStart: integer, newStart: integer, lines: z.array(text) }),
+  ),
+  note: text.optional(),
+})
+const change = z.object({
+  from: sha.nullable(),
+  to: sha,
+  files: z.array(changeFile),
+  truncated: z.boolean(),
+  total: integer,
+  sizes: z.array(z.object({ path: text, lines: integer })),
+})
+// cqx's report is extensible, but the measured fields are required.
+const health = z
+  .object({
+    lines: integer,
+    incomplete: z
+      .enum(['c-family-unavailable', 'c-family-too-large', 'unavailable'])
+      .optional(),
+    scores: z
+      .object({
+        quality: z.number(),
+        containment: z.number(),
+        legibility: z.number(),
+        security: z.number(),
+        modularity: z.number(),
+      })
+      .nullable(),
+    rules: z.array(
+      z.object({
+        rule: text,
+        category: text,
+        language: text,
+        describes: text,
+        remedy: text,
+        deducted: z.number(),
+        total_findings: integer,
+        findings: z.array(
+          z.object({
+            what: text,
+            file: text,
+            line: integer,
+            text: text.optional(),
+          }),
+        ),
+      }),
+    ),
+    calibrated: z.boolean(),
+  })
+  .nullable()
+const ok = z.object({ ok: z.boolean() })
+const token = z.object({
+  id: text,
+  label: text,
+  scopes: z.array(z.enum(SCOPES)),
+  repos: z.array(text).nullable(),
+  created_at: text,
+  expires_at: text,
+})
+const agent = z.object({
+  name: text,
+  sponsor: text,
+  label: text,
+  publicKey: text.nullable(),
+  createdAt: text,
+  revokedAt: text.nullable(),
+  approver: z.boolean(),
+  approvedBy: text.nullable(),
+})
+const join = z.object({
+  id: text,
+  sponsor: text,
+  label: text,
+  publicKey: text,
+  repo: text.nullable(),
+  grants: z.array(text),
+  note: text.nullable(),
+  status: z.enum(['pending', 'approved', 'denied']),
+  createdAt: text,
+  decidedAt: text.nullable(),
+  decidedBy: text.nullable(),
+  tokenIssued: z.boolean(),
+})
+const title = text.trim().min(1).max(200),
+  body = text.max(64000),
+  labels = z.array(text.min(1).max(31)).max(10)
+const empty = z.object({}).strict()
+const pagination = z.object({
+  per_page: z.coerce.number().int().min(1).max(100).default(30),
+  page: z.coerce.number().int().min(1).max(10000).default(1),
+  cursor: text.optional(),
+})
+const listing = pagination.extend({
+  state: z.enum(['open', 'closed', 'all']).default('open'),
+  sort: z.enum(['created', 'updated', 'comments']).default('created'),
+  direction: z.enum(['asc', 'desc']).default('desc'),
+  labels: text.optional(),
+})
+const reference = z.object({ ref: text.optional() })
+export const errorSchema = z.object({
+  message: text,
+  documentation_url: url,
+  errors: z
+    .array(
+      z.object({
+        resource: text.optional(),
+        field: text.optional(),
+        code: text.optional(),
+        message: text,
+      }),
+    )
+    .optional(),
+})
+export type CachePolicy =
+  'immutable' | 'resolved-hash' | 'index' | 'no-store' | 'static'
+function route<
+  const I extends string,
+  B extends z.ZodType,
+  O extends z.ZodType,
+  Q extends z.ZodType = typeof empty,
+>(
+  id: I,
+  method: 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE',
+  path: string,
+  scope: Scope | null,
+  output: O,
+  input: B,
+  cache: CachePolicy,
+  github = true,
+  query: Q = empty as unknown as Q,
+  status = 200,
+  phase: 'A' | 'B' | 'C' | 'D' = 'A',
+) {
+  const params = z.object(
+    Object.fromEntries(
+      [...path.matchAll(/\{(\w+)\}/g)].map((m) => [
+        m[1],
+        m[1] === 'owner' || m[1] === 'org'
+          ? text.regex(/^[a-z0-9][a-z0-9-]{0,38}$/i)
+          : m[1] === 'repo'
+            ? text.regex(/^[a-z0-9][a-z0-9._-]{0,99}$/i)
+            : ['number', 'run', 'job', 'hook', 'delivery'].includes(m[1])
+              ? text.regex(/^[1-9][0-9]{0,14}$/)
+              : text.min(1).max(4096),
+      ]),
+    ),
+  )
+  return {
+    id,
+    method,
+    path,
+    scope,
+    input,
+    output,
+    query,
+    params,
+    cache,
+    github,
+    status,
+    phase,
+  }
+}
+const actionStatus = z.enum(['queued', 'in_progress', 'completed'])
+const conclusion = z
+  .enum(['success', 'failure', 'cancelled', 'skipped'])
+  .nullable()
+const actionRun = z.object({
+  id: integer,
+  name: text,
+  head_branch: text,
+  head_sha: sha,
+  event: text,
+  status: actionStatus,
+  conclusion,
+  run_number: integer,
+  created_at: text,
+  updated_at: text,
+  html_url: url,
+  url,
+  workflow_id: integer,
+  started_at: text.nullable().optional(),
+  completed_at: text.nullable().optional(),
+  reason: text.nullable().optional(),
+  actor: user,
+})
+const actionJob = z.object({
+  id: integer,
+  run_id: integer,
+  name: text,
+  head_sha: sha,
+  status: actionStatus,
+  conclusion,
+  started_at: text.nullable(),
+  completed_at: text.nullable(),
+  runner_id: integer.nullable(),
+  runner_name: text.nullable(),
+  reason: text.nullable().optional(),
+  steps: z.array(
+    z.object({
+      name: text,
+      status: actionStatus,
+      conclusion,
+      number: integer,
+      exit_code: integer.nullable().optional(),
+      started_at: text.nullable(),
+      completed_at: text.nullable(),
+    }),
+  ),
+})
+const runner = z.object({
+  arch: text.optional(),
+  last_seen: integer.optional(),
+  group: text.optional(),
+  group_name: text.optional(),
+  inherited: z.boolean().optional(),
+  eligible: z.boolean().optional(),
+  ineligible_reason: text.nullable().optional(),
+  assignment: z
+    .object({ repository: text, job: integer, run: integer, lease: text })
+    .nullable()
+    .optional(),
+  id: integer,
+  gild_id: text,
+  name: text,
+  os: text,
+  status: z.enum(['online', 'offline']),
+  busy: z.boolean(),
+  labels: z.array(
+    z.object({ id: integer, name: text, type: z.literal('custom') }),
+  ),
+})
+const assignment = z.object({
+  schema: z.literal(1),
+  checkoutToken: text.optional(),
+  workspaceToken: text,
+  github: z.record(text, z.unknown()),
+  job: integer,
+  run: integer,
+  lease: text,
+  sha,
+  ref: text,
+  repository: text,
+  spec: z.object({ id: text }).passthrough(),
+  steps: z.array(
+    z
+      .object({
+        name: text,
+        when: z.object({
+          success: z.boolean(),
+          failure: z.boolean(),
+          cancelled: z.boolean(),
+        }),
+      })
+      .passthrough(),
+  ),
+  timeout: z.number(),
+})
+const R = '/repos/{owner}/{repo}'
+// IDs are stable client operation names; paths follow GitHub REST v3.
+const registration = z.object({ token: text, expires_at: text })
+const runnerJobs = z.object({
+  jobs: z.array(
+    z.object({
+      repository: text,
+      run: integer,
+      job: integer,
+      status: text,
+      name: text,
+    }),
+  ),
+})
+function poolRoutes<const P extends 'org' | 'user'>(prefix: P, path: string) {
+  return [
+    route(
+      `${prefix}PoolRecent`,
+      'GET',
+      path + '/runners/{runner}/jobs',
+      'actions',
+      runnerJobs,
+      empty,
+      'no-store',
+    ),
+    route(
+      `${prefix}PoolRunners`,
+      'GET',
+      path + '/runners',
+      'actions',
+      z.object({ total_count: integer, runners: z.array(runner) }),
+      empty,
+      'no-store',
+    ),
+    route(
+      `${prefix}PoolRegister`,
+      'POST',
+      path + '/runners',
+      'actions',
+      z.object({ id: text, token: text }),
+      runnerRegistration,
+      'no-store',
+      true,
+      empty,
+      201,
+    ),
+    route(
+      `${prefix}PoolRegistration`,
+      'POST',
+      path + '/runners/registration-token',
+      'actions',
+      registration,
+      z.object({ group: text.default('default') }),
+      'no-store',
+      true,
+      empty,
+      201,
+    ),
+    route(
+      `${prefix}PoolPoll`,
+      'POST',
+      path + '/runners/poll',
+      'actions',
+      z.object({ job: assignment.nullable() }),
+      z.object({ wait: integer.min(0).max(20000).default(20000) }),
+      'no-store',
+    ),
+    route(
+      `${prefix}PoolPatchRunner`,
+      'PATCH',
+      path + '/runners/{runner}',
+      'actions',
+      runner,
+      z.object({
+        group: text.optional(),
+        labels: runnerRegistration.shape.labels.optional(),
+      }),
+      'no-store',
+    ),
+    route(
+      `${prefix}PoolRemove`,
+      'DELETE',
+      path + '/runners/{runner}',
+      'actions',
+      ok,
+      empty,
+      'no-store',
+    ),
+    route(
+      `${prefix}PoolGroups`,
+      'GET',
+      path + '/runner-groups',
+      'actions',
+      z.object({ total_count: integer, runner_groups: z.array(runnerGroup) }),
+      empty,
+      'no-store',
+    ),
+    route(
+      `${prefix}PoolCreateGroup`,
+      'POST',
+      path + '/runner-groups',
+      'actions',
+      runnerGroup,
+      groupInput,
+      'no-store',
+      true,
+      empty,
+      201,
+    ),
+    route(
+      `${prefix}PoolGroup`,
+      'GET',
+      path + '/runner-groups/{group}',
+      'actions',
+      runnerGroup,
+      empty,
+      'no-store',
+    ),
+    route(
+      `${prefix}PoolPatchGroup`,
+      'PATCH',
+      path + '/runner-groups/{group}',
+      'actions',
+      runnerGroup,
+      groupInput.partial(),
+      'no-store',
+    ),
+    route(
+      `${prefix}PoolDeleteGroup`,
+      'DELETE',
+      path + '/runner-groups/{group}',
+      'actions',
+      ok,
+      empty,
+      'no-store',
+    ),
+    route(
+      `${prefix}PoolClearRepositories`,
+      'DELETE',
+      path + '/runner-groups/{group}/repositories',
+      'actions',
+      ok,
+      empty,
+      'no-store',
+    ),
+    route(
+      `${prefix}PoolRepositories`,
+      'GET',
+      path + '/runner-groups/{group}/repositories',
+      'actions',
+      z.object({ repositories: z.array(text) }),
+      empty,
+      'no-store',
+    ),
+    route(
+      `${prefix}PoolPutRepositories`,
+      'PUT',
+      path + '/runner-groups/{group}/repositories',
+      'actions',
+      ok,
+      z.object({
+        repositories: runnerGroup.shape.repositories,
+      }),
+      'no-store',
+    ),
+    route(
+      `${prefix}PoolAddRepository`,
+      'PUT',
+      path + '/runner-groups/{group}/repositories/{repo}',
+      'actions',
+      ok,
+      empty,
+      'no-store',
+    ),
+    route(
+      `${prefix}PoolRemoveRepository`,
+      'DELETE',
+      path + '/runner-groups/{group}/repositories/{repo}',
+      'actions',
+      ok,
+      empty,
+      'no-store',
+    ),
+  ] as const
+}
+export const routes = [
+  route('channelMessages','GET',R+'/channel/messages','repo:read',channelPage,empty,'no-store',false,channelQuery),
+  route('channelPost','POST',R+'/channel/messages',null,channelMessage,channelInput,'no-store',false,empty,201),
+  route('channelParticipants','GET',R+'/channel/participants','repo:read',channelParticipants,empty,'no-store',false),
+  route('channelStream','GET',R+'/channel/stream','repo:read',z.null(),empty,'no-store',false,z.object({after:channelCursor.optional()}),101),
+  // Orchestrators. Granting takes a person with the agents scope; the agent
+  // routes take no token scope because the orchestrator grant is the authority.
+  route('repoOrchestrators','GET',R+'/orchestrators','repo:read',orchestratorList,empty,'no-store',false),
+  route('setRepoOrchestrator','POST',R+'/orchestrators','agents',orchestratorGrant,orchestratorInput,'no-store',false),
+  route('deleteRepoOrchestrator','DELETE',R+'/orchestrators/{sponsor}/{label}','agents',orchestratorRevoked,empty,'no-store',false),
+  route('orgOrchestrators','GET','/orgs/{org}/orchestrators','agents',orchestratorList,empty,'no-store',false),
+  route('setOrgOrchestrator','POST','/orgs/{org}/orchestrators','agents',orchestratorGrant,orchestratorInput,'no-store',false),
+  route('deleteOrgOrchestrator','DELETE','/orgs/{org}/orchestrators/{sponsor}/{label}','agents',orchestratorRevoked,empty,'no-store',false),
+  route('childAgents','GET',R+'/agents/children',null,z.array(childAgent),empty,'no-store',false),
+  route('createChildAgent','POST',R+'/agents/children',null,spawnedChild,childInput,'no-store',false,empty,201),
+  route('suspendAgent','POST',R+'/agents/{sponsor}/{label}/suspend',null,suspension,empty,'no-store',false),
+  route('resumeAgent','POST',R+'/agents/{sponsor}/{label}/resume',null,suspension,empty,'no-store',false),
+  route('importCreate','POST','/user/imports','repo:write',importStatus,importInput,'no-store',false,empty,202,'D'),
+  route('importOrgCreate','POST','/orgs/{org}/imports','repo:write',importStatus,importInput,'no-store',false,empty,202,'D'),
+  route('importStatus','GET',R+'/import','repo:read',importStatus,empty,'no-store',false,empty,200,'D'),
+  route('importClaim','POST',R+'/import/claim','repo:write',importAssignment.nullable(),empty,'no-store',false,empty,200,'D'),
+  route('importUserPoll','POST','/users/{name}/imports/poll','actions',importAssignment.nullable(),empty,'no-store',false,empty,200,'D'),
+  route('importOrgPoll','POST','/orgs/{org}/imports/poll','actions',importAssignment.nullable(),empty,'no-store',false,empty,200,'D'),
+  route('importCredentials','POST',R+'/import/credentials','repo:write',importCredentials,empty,'no-store',false,empty,200,'D'),
+  route('importHeartbeat','POST',R+'/import/heartbeat','repo:write',importStatus,z.object({progress:importProgress.optional()}),'no-store',false,empty,200,'D'),
+  route('importBatch','POST',R+'/import/batch','repo:write',ok,importBatch,'no-store',false,empty,200,'D'),
+  route('importWorkflow','POST',R+'/import/workflow','repo:write',z.object({warnings:z.array(text)}),z.object({file:text.max(300),text:text.max(128*1024)}),'no-store',false,empty,200,'D'),
+  route('importFinish','POST',R+'/import/finish','repo:write',importStatus,z.object({warnings:z.array(text.max(500)).max(500),error:text.max(200).optional(),default_branch:text.max(300).optional(),summary:importSummary.optional()}),'no-store',false,empty,200,'D'),
+  route('importRetry','POST',R+'/import/retry','repo:write',importStatus,z.object({source_token:text.max(16384).optional()}),'no-store',false,empty,200,'D'),
+  route('importCutover','POST',R+'/import/cutover','repo:write',importStatus,empty,'no-store',false,empty,200,'D'),
+  route('importPatch','GET',R+'/import/pulls/{number}/patch','repo:read',z.null(),empty,'no-store',false,empty,200,'D'),
+
+  route(
+    'star',
+    'PUT',
+    '/user/starred/{owner}/{repo}',
+    'repo:read',
+    z.null(),
+    empty,
+    'no-store',
+    true,
+    empty,
+    204,
+  ),
+  route(
+    'unstar',
+    'DELETE',
+    '/user/starred/{owner}/{repo}',
+    'repo:read',
+    z.null(),
+    empty,
+    'no-store',
+    true,
+    empty,
+    204,
+  ),
+  route(
+    'stargazers',
+    'GET',
+    R + '/stargazers',
+    'repo:read',
+    z.array(user),
+    empty,
+    'no-store',
+    true,
+    pagination,
+  ),
+  ...poolRoutes('org', '/orgs/{org}/actions'),
+  ...poolRoutes('user', '/users/{name}/actions'),
+  route(
+    'actionRunnerJobs',
+    'GET',
+    R + '/actions/runners/{runner}/jobs',
+    'actions',
+    runnerJobs,
+    empty,
+    'no-store',
+  ),
+  route(
+    'actionRegistration',
+    'POST',
+    R + '/actions/runners/registration-token',
+    'actions',
+    registration,
+    empty,
+    'no-store',
+    true,
+    empty,
+    201,
+  ),
+  route(
+    'actionApprove',
+    'POST',
+    R + '/actions/runs/{run}/approve',
+    'actions',
+    ok,
+    empty,
+    'no-store',
+  ),
+  ...[
+    route(
+      'profile',
+      'GET',
+      '/user/profile',
+      'admin',
+      profileSchema,
+      empty,
+      'no-store',
+      false,
+    ),
+    route(
+      'updateProfile',
+      'PATCH',
+      '/user/profile',
+      'admin',
+      profileSchema,
+      profileInput,
+      'no-store',
+      false,
+    ),
+    route(
+      'updatePicture',
+      'PUT',
+      '/user/picture',
+      'admin',
+      profileSchema,
+      z.object({ data: text.max(90000) }),
+      'no-store',
+      false,
+    ),
+    route(
+      'deletePicture',
+      'DELETE',
+      '/user/picture',
+      'admin',
+      profileSchema,
+      empty,
+      'no-store',
+      false,
+    ),
+    route(
+      'orgProfile',
+      'GET',
+      '/orgs/{org}/profile',
+      'admin',
+      profileSchema,
+      empty,
+      'no-store',
+      false,
+    ),
+    route(
+      'updateOrgProfile',
+      'PATCH',
+      '/orgs/{org}/profile',
+      'admin',
+      profileSchema,
+      profileInput,
+      'no-store',
+      false,
+    ),
+    route(
+      'updateOrgPicture',
+      'PUT',
+      '/orgs/{org}/picture',
+      'admin',
+      profileSchema,
+      z.object({ data: text.max(90000) }),
+      'no-store',
+      false,
+    ),
+    route(
+      'deleteOrgPicture',
+      'DELETE',
+      '/orgs/{org}/picture',
+      'admin',
+      profileSchema,
+      empty,
+      'no-store',
+      false,
+    ),
+    route(
+      'putMembership',
+      'PUT',
+      '/orgs/{org}/memberships/{name}',
+      'admin',
+      z.object({
+        ok: z.literal(true),
+        org: text,
+        member: text,
+        role: z.enum(['owner', 'admin', 'member']),
+      }),
+      z.object({ role: z.enum(['owner', 'admin', 'member']) }),
+      'no-store',
+    ),
+    route(
+      'deleteMembership',
+      'DELETE',
+      '/orgs/{org}/memberships/{name}',
+      'admin',
+      z.object({
+        ok: z.literal(true),
+        org: text,
+        member: text,
+        role: z.null(),
+      }),
+      empty,
+      'no-store',
+    ),
+    route(
+      'leaveOrg',
+      'DELETE',
+      '/user/memberships/orgs/{org}',
+      'admin',
+      z.object({
+        ok: z.literal(true),
+        org: text,
+        member: text,
+        role: z.null(),
+      }),
+      empty,
+      'no-store',
+      false,
+    ),
+    route(
+      'renameStatusOrg',
+      'GET',
+      '/orgs/{org}/rename',
+      'admin',
+      renameStatus,
+      empty,
+      'no-store',
+      false,
+    ),
+    route(
+      'renameOrg',
+      'POST',
+      '/orgs/{org}/rename',
+      'admin',
+      z.object({ ok: z.literal(true), name: text }),
+      z.object({ name: text }),
+      'no-store',
+      false,
+    ),
+    route(
+      'archiveOrg',
+      'PUT',
+      '/orgs/{org}/archive',
+      'admin',
+      ok,
+      z.object({ archived: z.boolean() }),
+      'no-store',
+      false,
+    ),
+    route(
+      'deleteOrg',
+      'DELETE',
+      '/orgs/{org}',
+      'admin',
+      z.object({ ok: z.literal(true), restoreUntil: text }),
+      z.object({ confirm: text }),
+      'no-store',
+    ),
+    route(
+      'restoreOrg',
+      'POST',
+      '/orgs/{org}/restore',
+      'admin',
+      ok,
+      empty,
+      'no-store',
+      false,
+    ),
+    route(
+      'updateRepository',
+      'PATCH',
+      R,
+      'admin',
+      ok,
+      z
+        .object({
+          description: text.max(1000).optional(),
+          defaultBranch: text.max(255).optional(),
+        })
+        .strict()
+        .refine(
+          (b) => b.description !== undefined || b.defaultBranch !== undefined,
+        ),
+      'no-store',
+    ),
+    route(
+      'renameStatusRepo',
+      'GET',
+      R + '/rename',
+      'admin',
+      renameStatus,
+      empty,
+      'no-store',
+      false,
+    ),
+    route(
+      'renameRepo',
+      'POST',
+      R + '/rename',
+      'admin',
+      z.object({ ok: z.literal(true), name: text }),
+      z.object({ name: text }),
+      'no-store',
+      false,
+    ),
+    route(
+      'archiveRepo',
+      'PUT',
+      R + '/archive',
+      'admin',
+      ok,
+      z.object({ archived: z.boolean() }),
+      'no-store',
+      false,
+    ),
+    route(
+      'deleteRepo',
+      'DELETE',
+      R,
+      'admin',
+      z.object({ ok: z.literal(true), restoreUntil: text }),
+      z.object({ confirm: text }),
+      'no-store',
+    ),
+    route(
+      'restoreRepo',
+      'POST',
+      R + '/restore',
+      'admin',
+      ok,
+      empty,
+      'no-store',
+      false,
+    ),
+  ].map((r) => ({ ...r, phase: 'D' as const })),
+
+  route(
+    'pullSessions',
+    'GET',
+    R + '/pulls/{number}/sessions',
+    'repo:read',
+    z.array(receiptSchema),
+    empty,
+    'no-store',
+    false,
+    pagination,
+    200,
+    'C',
+  ),
+  route(
+    'createPullSession',
+    'POST',
+    R + '/pulls/{number}/sessions',
+    'pulls:write',
+    receiptSchema,
+    sessionInput,
+    'no-store',
+    false,
+    empty,
+    201,
+    'C',
+  ),
+  route(
+    'commitSessions',
+    'GET',
+    R + '/commits/{sha}/sessions',
+    'repo:read',
+    z.array(receiptSchema),
+    empty,
+    'no-store',
+    false,
+    pagination,
+    200,
+    'C',
+  ),
+  route(
+    'createCommitSession',
+    'POST',
+    R + '/commits/{sha}/sessions',
+    'repo:write',
+    receiptSchema,
+    sessionInput,
+    'no-store',
+    false,
+    empty,
+    201,
+    'C',
+  ),
+  route(
+    'events',
+    'GET',
+    '/events',
+    'repo:read',
+    eventPage,
+    empty,
+    'no-store',
+    false,
+    z.object({
+      repos: text.optional(),
+      since: text.optional(),
+      wait: z.coerce.number().int().min(0).max(20000).default(20000),
+    }),
+    200,
+    'B',
+  ),
+  route(
+    'repoHooks',
+    'GET',
+    R + '/hooks',
+    'hooks',
+    z.array(hookSchema),
+    empty,
+    'no-store',
+    true,
+    pagination,
+    200,
+    'B',
+  ),
+  route(
+    'repoCreateHook',
+    'POST',
+    R + '/hooks',
+    'hooks',
+    hookSchema,
+    hookInput,
+    'no-store',
+    true,
+    empty,
+    201,
+    'B',
+  ),
+  route(
+    'repoHook',
+    'GET',
+    R + '/hooks/{hook}',
+    'hooks',
+    hookSchema,
+    empty,
+    'no-store',
+    true,
+    empty,
+    200,
+    'B',
+  ),
+  route(
+    'repoUpdateHook',
+    'PATCH',
+    R + '/hooks/{hook}',
+    'hooks',
+    hookSchema,
+    hookPatch,
+    'no-store',
+    true,
+    empty,
+    200,
+    'B',
+  ),
+  route(
+    'repoDeleteHook',
+    'DELETE',
+    R + '/hooks/{hook}',
+    'hooks',
+    ok,
+    empty,
+    'no-store',
+    false,
+    empty,
+    200,
+    'B',
+  ),
+  route(
+    'repoHookDeliveries',
+    'GET',
+    R + '/hooks/{hook}/deliveries',
+    'hooks',
+    z.array(deliverySchema),
+    empty,
+    'no-store',
+    true,
+    pagination,
+    200,
+    'B',
+  ),
+  route(
+    'repoHookDelivery',
+    'GET',
+    R + '/hooks/{hook}/deliveries/{delivery}',
+    'hooks',
+    deliverySchema,
+    empty,
+    'no-store',
+    true,
+    empty,
+    200,
+    'B',
+  ),
+  route(
+    'repoRedeliverHook',
+    'POST',
+    R + '/hooks/{hook}/deliveries/{delivery}/attempts',
+    'hooks',
+    z.object({ id: integer, guid: text }),
+    empty,
+    'no-store',
+    false,
+    empty,
+    202,
+    'B',
+  ),
+  route(
+    'repoPingHook',
+    'POST',
+    R + '/hooks/{hook}/pings',
+    'hooks',
+    z.object({ id: integer, guid: text }),
+    empty,
+    'no-store',
+    false,
+    empty,
+    202,
+    'B',
+  ),
+  route(
+    'orgHooks',
+    'GET',
+    '/orgs/{org}' + '/hooks',
+    'hooks',
+    z.array(hookSchema),
+    empty,
+    'no-store',
+    true,
+    pagination,
+    200,
+    'B',
+  ),
+  route(
+    'orgCreateHook',
+    'POST',
+    '/orgs/{org}' + '/hooks',
+    'hooks',
+    hookSchema,
+    hookInput,
+    'no-store',
+    true,
+    empty,
+    201,
+    'B',
+  ),
+  route(
+    'orgHook',
+    'GET',
+    '/orgs/{org}' + '/hooks/{hook}',
+    'hooks',
+    hookSchema,
+    empty,
+    'no-store',
+    true,
+    empty,
+    200,
+    'B',
+  ),
+  route(
+    'orgUpdateHook',
+    'PATCH',
+    '/orgs/{org}' + '/hooks/{hook}',
+    'hooks',
+    hookSchema,
+    hookPatch,
+    'no-store',
+    true,
+    empty,
+    200,
+    'B',
+  ),
+  route(
+    'orgDeleteHook',
+    'DELETE',
+    '/orgs/{org}' + '/hooks/{hook}',
+    'hooks',
+    ok,
+    empty,
+    'no-store',
+    false,
+    empty,
+    200,
+    'B',
+  ),
+  route(
+    'orgHookDeliveries',
+    'GET',
+    '/orgs/{org}' + '/hooks/{hook}/deliveries',
+    'hooks',
+    z.array(deliverySchema),
+    empty,
+    'no-store',
+    true,
+    pagination,
+    200,
+    'B',
+  ),
+  route(
+    'orgHookDelivery',
+    'GET',
+    '/orgs/{org}' + '/hooks/{hook}/deliveries/{delivery}',
+    'hooks',
+    deliverySchema,
+    empty,
+    'no-store',
+    true,
+    empty,
+    200,
+    'B',
+  ),
+  route(
+    'orgRedeliverHook',
+    'POST',
+    '/orgs/{org}' + '/hooks/{hook}/deliveries/{delivery}/attempts',
+    'hooks',
+    z.object({ id: integer, guid: text }),
+    empty,
+    'no-store',
+    false,
+    empty,
+    202,
+    'B',
+  ),
+  route(
+    'orgPingHook',
+    'POST',
+    '/orgs/{org}' + '/hooks/{hook}/pings',
+    'hooks',
+    z.object({ id: integer, guid: text }),
+    empty,
+    'no-store',
+    false,
+    empty,
+    202,
+    'B',
+  ),
+
+  route(
+    'org',
+    'GET',
+    '/orgs/{org}',
+    'repo:read',
+    z.object({
+      login: text,
+      id: integer,
+      type: z.literal('Organization'),
+      html_url: url,
+      description: text.nullable(),
+      created_at: text,
+    }),
+    empty,
+    'index',
+  ),
+  route(
+    'orgMembers',
+    'GET',
+    '/orgs/{org}/members',
+    'repo:read',
+    z.array(user),
+    empty,
+    'index',
+    true,
+    pagination,
+  ),
+  route(
+    'updateAgent',
+    'PATCH',
+    '/agents/{label}',
+    'agents',
+    ok,
+    z.object({ approver: z.boolean() }),
+    'no-store',
+    false,
+  ),
+  route(
+    'agentRequest',
+    'GET',
+    '/agents/requests/{id}',
+    'agents',
+    join,
+    empty,
+    'no-store',
+    false,
+  ),
+  route(
+    'repoAgents',
+    'GET',
+    R + '/agents',
+    'repo:read',
+    z.object({
+      agents: z.record(text, z.array(z.enum(['pr', 'review', 'merge', 'coordinate', 'queue']))),
+    }),
+    empty,
+    'index',
+    false,
+  ),
+  route(
+    'setRepoAgent',
+    'POST',
+    R + '/agents',
+    'agents',
+    z.object({ ok: z.literal(true), agent: text, grants: z.array(text) }),
+    z.object({
+      agent: text,
+      grants: z.array(z.enum(['pr', 'review', 'merge', 'coordinate', 'queue'])),
+    }),
+    'no-store',
+    false,
+  ),
+  route(
+    'claimIssue',
+    'POST',
+    R + '/issues/{number}/claim',
+    'issues:write',
+    ok,
+    z.object({ action: z.enum(['claim', 'unclaim']) }),
+    'no-store',
+    false,
+  ),
+  route(
+    'dequeuePull',
+    'DELETE',
+    R + '/merge-queue/{number}',
+    'pulls:write',
+    ok,
+    empty,
+    'no-store',
+    false,
+  ),
+  route(
+    'actionOverview',
+    'GET',
+    R + '/actions',
+    'actions',
+    z.object({
+      workflow_runs: z.array(actionRun),
+      runners: z.array(runner),
+      required: z.array(text),
+    }),
+    empty,
+    'index',
+    false,
+  ),
+  route(
+    'actionCommitRuns',
+    'GET',
+    R + '/actions/commits/{sha}',
+    'actions',
+    z.array(actionRun),
+    empty,
+    'index',
+    false,
+  ),
+  route(
+    'actionSettings',
+    'PUT',
+    R + '/actions/settings',
+    'admin',
+    z.object({ required: z.array(text) }),
+    z.object({ required: z.array(text.regex(/^[\w.-]+\.ya?ml$/)).max(64) }),
+    'no-store',
+    false,
+  ),
+  route(
+    'actionSecrets',
+    'GET',
+    R + '/actions/settings/secrets',
+    'admin',
+    z.object({ secrets: z.array(z.object({ name: text, updated_at: text })) }),
+    empty,
+    'no-store',
+    false,
+  ),
+  route(
+    'actionPutSecret',
+    'PUT',
+    R + '/actions/settings/secrets/{secret}',
+    'admin',
+    ok,
+    z.object({ value: text.min(1).max(16384) }),
+    'no-store',
+    false,
+  ),
+  route(
+    'actionDeleteSecret',
+    'DELETE',
+    R + '/actions/settings/secrets/{secret}',
+    'admin',
+    ok,
+    empty,
+    'no-store',
+    false,
+  ),
+
+  route(
+    'openapi',
+    'GET',
+    '/openapi.json',
+    null,
+    z
+      .object({
+        openapi: text,
+        info: z.object({ title: text, version: text }),
+        paths: z.record(text, z.unknown()),
+      })
+      .passthrough(),
+    empty,
+    'static',
+    false,
+  ),
+  route(
+    'repoVisibility',
+    'GET',
+    R + '/visibility',
+    'repo:read',
+    z.object({ visibility: z.enum(['public', 'private']) }),
+    empty,
+    'no-store',
+    false,
+    empty,
+    200,
+    'D',
+  ),
+  route(
+    'setRepoVisibility',
+    'PATCH',
+    R + '/visibility',
+    'admin',
+    z.object({ visibility: z.enum(['public', 'private']) }),
+    z
+      .object({
+        visibility: z.enum(['public', 'private']),
+        confirm: text.optional(),
+      })
+      .strict(),
+    'no-store',
+    false,
+    empty,
+    200,
+    'D',
+  ),
+  route(
+    'collaborators',
+    'GET',
+    R + '/collaborators',
+    'repo:read',
+    z.object({
+      collaborators: z.array(
+        z.object({ login: text, permission: z.enum(['read', 'write']) }),
+      ),
+      invitations: z.array(
+        z.object({
+          id: text,
+          repo: text,
+          invitee: text,
+          permission: z.enum(['read', 'write']),
+          inviter: text,
+          created_at: text,
+        }),
+      ),
+    }),
+    empty,
+    'no-store',
+    true,
+    empty,
+    200,
+    'D',
+  ),
+  route(
+    'addCollaborator',
+    'PUT',
+    R + '/collaborators/{username}',
+    'admin',
+    ok,
+    z
+      .object({ permission: z.enum(['read', 'write']).default('read') })
+      .strict(),
+    'no-store',
+    true,
+    empty,
+    200,
+    'D',
+  ),
+  route(
+    'removeCollaborator',
+    'DELETE',
+    R + '/collaborators/{username}',
+    'admin',
+    ok,
+    empty,
+    'no-store',
+    true,
+    empty,
+    200,
+    'D',
+  ),
+  route(
+    'repositoryInvitations',
+    'GET',
+    '/user/repository_invitations',
+    'repo:read',
+    z.array(z.object({ id: text, permission: z.enum(['read', 'write']) })),
+    empty,
+    'no-store',
+    true,
+    empty,
+    200,
+    'D',
+  ),
+  route(
+    'acceptRepositoryInvitation',
+    'PATCH',
+    '/user/repository_invitations/{id}',
+    // Accepting can grant write, so a read-only token may not accept.
+    'repo:write',
+    ok,
+    empty,
+    'no-store',
+    true,
+    empty,
+    200,
+    'D',
+  ),
+  route(
+    'declineRepositoryInvitation',
+    'DELETE',
+    '/user/repository_invitations/{id}',
+    'repo:read',
+    ok,
+    empty,
+    'no-store',
+    true,
+    empty,
+    200,
+    'D',
+  ),
+  route(
+    'repos',
+    'GET',
+    '/user/repos',
+    'repo:read',
+    z.array(repository),
+    empty,
+    'index',
+    true,
+    pagination,
+  ),
+  route(
+    'createRepository',
+    'POST',
+    '/user/repos',
+    'repo:write',
+    repository,
+    z.object({
+      name: text.min(1),
+      description: text.max(1000).optional(),
+      private: z.boolean().optional(),
+    }),
+    'no-store',
+    true,
+    empty,
+    201,
+  ),
+  route(
+    'createOrgRepository',
+    'POST',
+    '/orgs/{org}/repos',
+    'repo:write',
+    repository,
+    z.object({
+      name: text.min(1),
+      description: text.max(1000).optional(),
+      private: z.boolean().optional(),
+    }),
+    'no-store',
+    true,
+    empty,
+    201,
+  ),
+  route(
+    'orgs',
+    'GET',
+    '/orgs',
+    'repo:read',
+    z.array(
+      z.object({
+        name: text,
+        description: text.nullable(),
+        createdBy: text,
+        createdAt: text,
+        role: z.enum(['owner', 'admin', 'member']),
+      }),
+    ),
+    empty,
+    'no-store',
+    false,
+  ),
+  route(
+    'createOrg',
+    'POST',
+    '/orgs',
+    'admin',
+    z.object({
+      name: text,
+      description: text.nullable(),
+      createdBy: text,
+      createdAt: text,
+    }),
+    z.object({
+      name: text.min(1),
+      description: text.max(1000).optional(),
+      private: z.boolean().optional(),
+    }),
+    'no-store',
+    false,
+    empty,
+    201,
+  ),
+  route(
+    'addOrgMember',
+    'POST',
+    '/orgs/{org}/members',
+    'admin',
+    z.object({
+      ok: z.literal(true),
+      org: text,
+      member: text,
+      role: z.enum(['owner', 'admin', 'member']),
+    }),
+    z.object({
+      member: text,
+      role: z.enum(['owner', 'admin', 'member']).default('member'),
+    }),
+    'no-store',
+    false,
+    empty,
+    201,
+  ),
+  route(
+    'ownerRepos',
+    'GET',
+    '/users/{owner}/repos',
+    'repo:read',
+    z.array(repository),
+    empty,
+    'index',
+    true,
+    pagination,
+  ),
+  route(
+    'orgRepos',
+    'GET',
+    '/orgs/{owner}/repos',
+    'repo:read',
+    z.array(repository),
+    empty,
+    'index',
+    true,
+    pagination,
+  ),
+  route('repo', 'GET', R, 'repo:read', repository, empty, 'index'),
+  route(
+    'branches',
+    'GET',
+    R + '/branches',
+    'repo:read',
+    z.array(branch),
+    empty,
+    'index',
+    true,
+    pagination,
+  ),
+  route(
+    'refs',
+    'GET',
+    R + '/git/refs',
+    'repo:read',
+    z.array(ref),
+    empty,
+    'index',
+    true,
+    pagination,
+  ),
+  route('ref', 'GET', R + '/git/ref/{ref}', 'repo:read', ref, empty, 'index'),
+  route(
+    'commits',
+    'GET',
+    R + '/commits',
+    'repo:read',
+    z.array(commit),
+    empty,
+    'resolved-hash',
+    true,
+    pagination.extend({ sha: text.optional() }),
+  ),
+  route(
+    'commit',
+    'GET',
+    R + '/commits/{sha}',
+    'repo:read',
+    commit.extend({
+      files: z.array(fileDiff),
+      stats: z.object({
+        additions: integer,
+        deletions: integer,
+        total: integer,
+      }),
+    }),
+    empty,
+    'resolved-hash',
+  ),
+  route(
+    'compare',
+    'GET',
+    R + '/compare/{base}...{head}',
+    'repo:read',
+    z.object({
+      url,
+      html_url: url,
+      status: z.enum(['ahead', 'behind', 'diverged', 'identical']),
+      ahead_by: integer,
+      behind_by: integer,
+      total_commits: integer,
+      base_commit: commit,
+      merge_base_commit: commit,
+      commits: z.array(commit),
+      files: z.array(fileDiff),
+    }),
+    empty,
+    'resolved-hash',
+    true,
+    pagination,
+  ),
+  route(
+    'contentsRoot',
+    'GET',
+    R + '/contents',
+    'repo:read',
+    z.union([content, z.array(content)]),
+    empty,
+    'resolved-hash',
+    true,
+    reference,
+  ),
+  route(
+    'contents',
+    'GET',
+    R + '/contents/{path}',
+    'repo:read',
+    z.union([content, z.array(content)]),
+    empty,
+    'resolved-hash',
+    true,
+    reference,
+  ),
+  route(
+    'tree',
+    'GET',
+    R + '/git/trees/{sha}',
+    'repo:read',
+    z.object({ sha, url, tree: z.array(treeEntry), truncated: z.boolean() }),
+    empty,
+    'resolved-hash',
+    true,
+    z.object({ recursive: text.optional() }),
+  ),
+  route(
+    'blob',
+    'GET',
+    R + '/git/blobs/{sha}',
+    'repo:read',
+    z.object({
+      sha,
+      url,
+      size: integer,
+      encoding: z.literal('base64'),
+      content: text,
+    }),
+    empty,
+    'immutable',
+  ),
+  route(
+    'issues',
+    'GET',
+    R + '/issues',
+    'repo:read',
+    z.array(issue),
+    empty,
+    'index',
+    true,
+    listing,
+  ),
+  route(
+    'issue',
+    'GET',
+    R + '/issues/{number}',
+    'repo:read',
+    issue,
+    empty,
+    'index',
+  ),
+  route(
+    'createIssue',
+    'POST',
+    R + '/issues',
+    'issues:write',
+    issue,
+    z.object({ title, body: body.default(''), labels: labels.default([]) }),
+    'no-store',
+    true,
+    empty,
+    201,
+  ),
+  route(
+    'updateIssue',
+    'PATCH',
+    R + '/issues/{number}',
+    'issues:write',
+    issue,
+    z.object({
+      title: title.optional(),
+      body: body.optional(),
+      state: z.enum(['open', 'closed']).optional(),
+      labels: labels.optional(),
+    }),
+    'no-store',
+  ),
+  route(
+    'issueComments',
+    'GET',
+    R + '/issues/{number}/comments',
+    'repo:read',
+    z.array(comment),
+    empty,
+    'index',
+    true,
+    pagination,
+  ),
+  route(
+    'createIssueComment',
+    'POST',
+    R + '/issues/{number}/comments',
+    'issues:write',
+    comment,
+    z.object({ body: body.min(1) }),
+    'no-store',
+    true,
+    empty,
+    201,
+  ),
+  route(
+    'labels',
+    'GET',
+    R + '/labels',
+    'repo:read',
+    z.array(label),
+    empty,
+    'index',
+    true,
+    pagination,
+  ),
+  route(
+    'pulls',
+    'GET',
+    R + '/pulls',
+    'repo:read',
+    z.array(pull),
+    empty,
+    'index',
+    true,
+    listing,
+  ),
+  route(
+    'pull',
+    'GET',
+    R + '/pulls/{number}',
+    'repo:read',
+    pull,
+    empty,
+    'index',
+  ),
+  route(
+    'createPull',
+    'POST',
+    R + '/pulls',
+    'pulls:write',
+    pull,
+    z.object({
+      title,
+      body: body.default(''),
+      head: text.min(1),
+      base: text.min(1),
+    }),
+    'no-store',
+    true,
+    empty,
+    201,
+  ),
+  route(
+    'updatePull',
+    'PATCH',
+    R + '/pulls/{number}',
+    'pulls:write',
+    pull,
+    z.object({
+      title: title.optional(),
+      body: body.optional(),
+      state: z.enum(['open', 'closed']).optional(),
+      base: text.optional(),
+    }),
+    'no-store',
+  ),
+  route(
+    'pullFiles',
+    'GET',
+    R + '/pulls/{number}/files',
+    'repo:read',
+    z.array(fileDiff),
+    empty,
+    'resolved-hash',
+    true,
+    pagination,
+  ),
+  route(
+    'pullReviews',
+    'GET',
+    R + '/pulls/{number}/reviews',
+    'repo:read',
+    z.array(review),
+    empty,
+    'index',
+    true,
+    pagination,
+  ),
+  route(
+    'createReview',
+    'POST',
+    R + '/pulls/{number}/reviews',
+    'pulls:write',
+    review,
+    z.object({
+      body: body.default(''),
+      event: z.enum(['APPROVE', 'REQUEST_CHANGES', 'COMMENT']),
+    }),
+    'no-store',
+    true,
+    empty,
+    201,
+  ),
+  route(
+    'pullComments',
+    'GET',
+    R + '/pulls/{number}/comments',
+    'repo:read',
+    z.array(
+      comment.extend({
+        path: text,
+        line: integer,
+        side: z.enum(['LEFT', 'RIGHT']),
+        commit_id: sha,
+      }),
+    ),
+    empty,
+    'index',
+    true,
+    pagination,
+  ),
+  route(
+    'createPullComment',
+    'POST',
+    R + '/pulls/{number}/comments',
+    'pulls:write',
+    comment.extend({
+      path: text,
+      line: integer,
+      side: z.enum(['LEFT', 'RIGHT']),
+      commit_id: sha,
+    }),
+    z.object({
+      body: body.min(1),
+      path: text.min(1),
+      line: integer.positive(),
+      side: z.enum(['LEFT', 'RIGHT']).default('RIGHT'),
+      commit_id: sha,
+    }),
+    'no-store',
+    true,
+    empty,
+    201,
+  ),
+  route(
+    'mergePull',
+    'PUT',
+    R + '/pulls/{number}/merge',
+    'pulls:write',
+    z.object({
+      sha: sha.nullable(),
+      merged: z.literal(false),
+      message: text,
+      queued: z.literal(true),
+    }),
+    z.object({
+      sha: sha.optional(),
+      merge_method: z.literal('merge').optional(),
+      commit_title: text.optional(),
+      commit_message: text.optional(),
+    }),
+    'no-store',
+    false,
+    empty,
+    202,
+  ),
+  route(
+    'mergeQueue',
+    'GET',
+    R + '/merge-queue',
+    'repo:read',
+    z.object({ queue: z.array(integer) }),
+    empty,
+    'index',
+    false,
+  ),
+  route(
+    'commitChanges',
+    'GET',
+    R + '/changes/{sha}',
+    'repo:read',
+    change,
+    empty,
+    'resolved-hash',
+    false,
+  ),
+  route(
+    'pullChanges',
+    'GET',
+    R + '/pulls/{number}/changes',
+    'repo:read',
+    change,
+    empty,
+    'resolved-hash',
+    false,
+  ),
+  route(
+    'health',
+    'GET',
+    R + '/health',
+    'repo:read',
+    health,
+    empty,
+    'resolved-hash',
+    false,
+    reference,
+  ),
+  route(
+    'healthAt',
+    'GET',
+    R + '/health/{sha}',
+    'repo:read',
+    health,
+    empty,
+    'immutable',
+    false,
+  ),
+  route(
+    'searchCode',
+    'GET',
+    '/search/code',
+    'repo:read',
+    z.object({
+      total_count: integer,
+      incomplete_results: z.boolean(),
+      items: z.array(
+        z.object({
+          name: text,
+          path: text,
+          sha,
+          text_matches: z.array(
+            z.object({
+              fragment: text,
+              matches: z.array(
+                z.object({ indices: z.tuple([integer, integer]), text }),
+              ),
+            }),
+          ),
+          repository,
+          url,
+          html_url: url,
+        }),
+      ),
+    }),
+    empty,
+    'index',
+    false,
+    pagination.extend({ q: text.min(1).max(2000) }),
+  ),
+  route(
+    'tokens',
+    'GET',
+    '/user/tokens',
+    'admin',
+    z.array(token),
+    empty,
+    'no-store',
+    false,
+  ),
+  route(
+    'createToken',
+    'POST',
+    '/user/tokens',
+    'admin',
+    token.extend({ token: text }),
+    z.object({
+      label: text.max(100).default(''),
+      scopes: z.array(z.enum(SCOPES)),
+      repos: z.array(text.regex(/^[a-z0-9-]+\/[a-z0-9._-]+$/i)).optional(),
+    }),
+    'no-store',
+    false,
+    empty,
+    201,
+  ),
+  route(
+    'deleteToken',
+    'DELETE',
+    '/user/tokens/{id}',
+    'admin',
+    ok,
+    empty,
+    'no-store',
+    false,
+  ),
+  route(
+    'agents',
+    'GET',
+    '/agents',
+    'agents',
+    z.array(agent),
+    empty,
+    'no-store',
+    false,
+  ),
+  route(
+    'deleteAgent',
+    'DELETE',
+    '/agents/{label}',
+    'agents',
+    ok,
+    empty,
+    'no-store',
+    false,
+  ),
+  route(
+    'agentRequests',
+    'GET',
+    '/agents/requests',
+    'agents',
+    z.array(join),
+    empty,
+    'no-store',
+    false,
+  ),
+  route(
+    'createAgentRequest',
+    'POST',
+    '/agents/requests',
+    'agents',
+    join,
+    z.object({
+      sponsor: text,
+      label: text,
+      publicKey: text,
+      repo: text.optional(),
+      grants: z.array(text).default([]),
+      note: text.optional(),
+    }),
+    'no-store',
+    false,
+    empty,
+    201,
+  ),
+  route(
+    'decideAgentRequest',
+    'PATCH',
+    '/agents/requests/{id}',
+    'agents',
+    z.object({
+      status: z.enum(['approved', 'denied']),
+      agent: text.optional(),
+      grants: z.array(text).optional(),
+    }),
+    z.object({
+      decision: z.enum(['approve', 'deny']),
+      grants: z.array(text).default([]),
+    }),
+    'no-store',
+    false,
+  ),
+  route(
+    'actionRuns',
+    'GET',
+    R + '/actions/runs',
+    'repo:read',
+    z.object({ total_count: integer, workflow_runs: z.array(actionRun) }),
+    empty,
+    'index',
+    true,
+    pagination,
+  ),
+  route(
+    'actionRun',
+    'GET',
+    R + '/actions/runs/{run}',
+    'repo:read',
+    actionRun,
+    empty,
+    'index',
+  ),
+  route(
+    'actionJobs',
+    'GET',
+    R + '/actions/runs/{run}/jobs',
+    'repo:read',
+    z.object({ total_count: integer, jobs: z.array(actionJob) }),
+    empty,
+    'index',
+    true,
+    pagination,
+  ),
+  route(
+    'actionJob',
+    'GET',
+    R + '/actions/jobs/{job}',
+    'repo:read',
+    actionJob,
+    empty,
+    'index',
+  ),
+  route(
+    'actionLogs',
+    'GET',
+    R + '/actions/runs/{run}/logs',
+    'repo:read',
+    z.object({
+      logs: z.array(
+        z.object({ job: integer, step: integer, seq: integer, text }),
+      ),
+    }),
+    empty,
+    'index',
+    false,
+    z.object({
+      job: z.coerce.number().int().positive().optional(),
+      step: z.coerce.number().int().min(0).optional(),
+      after: z.coerce.number().int().min(-1).default(-1),
+    }).refine(q => (q.job === undefined) === (q.step === undefined), 'Use job and step together'),
+  ),
+  route(
+    'actionRerun',
+    'POST',
+    R + '/actions/runs/{run}/rerun',
+    'actions',
+    z.object({ id: integer }),
+    empty,
+    'no-store',
+    false,
+    empty,
+    201,
+  ),
+  route(
+    'actionCancel',
+    'POST',
+    R + '/actions/runs/{run}/cancel',
+    'actions',
+    ok,
+    empty,
+    'no-store',
+  ),
+  route(
+    'actionRunners',
+    'GET',
+    R + '/actions/runners',
+    'actions',
+    z.object({ total_count: integer, runners: z.array(runner) }),
+    empty,
+    'no-store',
+    true,
+    pagination,
+  ),
+  route(
+    'actionRegister',
+    'POST',
+    R + '/actions/runners',
+    'actions',
+    z.object({ id: text, token: text }),
+    runnerRegistration
+      .omit({ group: true })
+      .extend({ registration_token: text.optional() }),
+    'no-store',
+    false,
+    empty,
+    201,
+  ),
+  route(
+    'actionPatch',
+    'PATCH',
+    R + '/actions/runners/{runner}',
+    'actions',
+    ok,
+    z.object({ labels: z.array(text.regex(/^[\w.-]{1,64}$/)).max(32) }),
+    'no-store',
+  ),
+  route(
+    'actionRemove',
+    'DELETE',
+    R + '/actions/runners/{runner}',
+    'actions',
+    ok,
+    empty,
+    'no-store',
+    false,
+  ),
+  route(
+    'actionDispatch',
+    'POST',
+    R + '/actions/workflows/{workflow}/dispatches',
+    'actions',
+    z.object({ id: integer }),
+    z.object({ ref: text.min(1) }),
+    'no-store',
+    false,
+    empty,
+    201,
+  ),
+  route(
+    'runnerPoll',
+    'POST',
+    R + '/actions/runners/poll',
+    'actions',
+    z.object({ job: assignment.nullable() }),
+    z.object({ wait: z.number().min(0).max(20000).default(20000) }),
+    'no-store',
+    false,
+  ),
+  route(
+    'runnerHeartbeat',
+    'POST',
+    R + '/actions/runners/heartbeat',
+    'actions',
+    z.object({ cancel: z.boolean() }),
+    z.object({ job: integer.nullable(), lease: text.nullable() }),
+    'no-store',
+    false,
+  ),
+  route(
+    'runnerLogs',
+    'POST',
+    R + '/actions/runners/logs',
+    'actions',
+    ok,
+    z
+      .object({
+        job: integer,
+        lease: text,
+        step: integer,
+        batch: integer,
+        lines: z.array(text),
+      })
+      .passthrough(),
+    'no-store',
+    false,
+  ),
+  route(
+    'runnerStep',
+    'POST',
+    R + '/actions/runners/step',
+    'actions',
+    ok,
+    z
+      .object({
+        job: integer,
+        lease: text,
+        step: integer,
+        status: z.enum([
+          'running',
+          'success',
+          'failure',
+          'cancelled',
+          'skipped',
+        ]),
+        exit: integer.nullable(),
+      })
+      .passthrough(),
+    'no-store',
+    false,
+  ),
+  route(
+    'runnerFinish',
+    'POST',
+    R + '/actions/runners/finish',
+    'actions',
+    ok,
+    z
+      .object({
+        job: integer,
+        lease: text,
+        status: z.enum(['success', 'failure', 'cancelled']),
+        reason: text.nullable(),
+      })
+      .passthrough(),
+    'no-store',
+    false,
+  ),
+] as const
+export type Route = (typeof routes)[number]
+export type Operation = Route['id']
+export type Input<I extends Operation> = z.input<
+  Extract<Route, { id: I }>['input']
+>
+export type Output<I extends Operation> = z.output<
+  Extract<Route, { id: I }>['output']
+>
+export type Query<I extends Operation> = z.input<
+  Extract<Route, { id: I }>['query']
+>
+export const schemas = {
+  repository,
+  comment,
+  issue,
+  pull,
+  review,
+  commit,
+  change,
+  health,
+  ok,
+}