@wardby/cli 0.5.3 → 0.7.0

package/docs/viewer-api.openapi.yml

@@ -0,0 +1,1404 @@
+# Generated by npm run build:viewer-schemas from src/viewer/api-schema.ts and src/viewer/openapi.ts. Do not edit.
+openapi: 3.1.0
+info:
+  title: wardby admin viewer API
+  version: 0.7.0
+  description: "Read-only admin API behind the wardby viewer: graph, run detail, infrastructure info and a live event stream. Response objects may gain new fields in later releases; clients should ignore unknown fields. See docs/viewer-api.md for the prose contract."
+servers:
+  - url: https://{host}
+    variables:
+      host:
+        default: wardby.example.com
+paths:
+  /admin/api/graph:
+    get:
+      operationId: getGraph
+      summary: Graph snapshot
+      description: |-
+        Agents, runs, coding-run services and outcomes for a time window, as a graph.
+
+        Requires a bearer token with the `admin:view` scope, held by a caller with the admin role.
+      security:
+        - bearer: []
+      parameters:
+        - name: since
+          in: query
+          required: false
+          description: "Window start: `15m`, `1h`, `6h`, `24h`, `7d`, or an ISO-8601 timestamp. Default `1h`."
+          schema:
+            type: string
+            default: 1h
+        - name: limit
+          in: query
+          required: false
+          description: Maximum number of runs, 1 to 2000. Default 500.
+          schema:
+            type: integer
+            minimum: 1
+            maximum: 2000
+            default: 500
+      responses:
+        "200":
+          description: The graph snapshot.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/graph-snapshot"
+        "400":
+          description: A query parameter is invalid.
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: "#/components/schemas/ViewerError"
+                  - properties:
+                      error:
+                        enum:
+                          - invalid_since
+                          - invalid_limit
+          x-error-codes:
+            - invalid_since
+            - invalid_limit
+        "401":
+          description: No valid bearer token.
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: "#/components/schemas/ViewerError"
+                  - properties:
+                      error:
+                        enum:
+                          - invalid_token
+          x-error-codes:
+            - invalid_token
+          headers:
+            WWW-Authenticate:
+              $ref: "#/components/headers/WWWAuthenticate"
+        "403":
+          description: Token lacks the `admin:view` scope (the `WWW-Authenticate` header is present), or the caller lacks the admin role (no `WWW-Authenticate` header).
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: "#/components/schemas/ViewerError"
+                  - properties:
+                      error:
+                        enum:
+                          - invalid_token
+          x-error-codes:
+            - invalid_token
+          headers:
+            WWW-Authenticate:
+              $ref: "#/components/headers/WWWAuthenticate"
+        "405":
+          description: Only GET is allowed.
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: "#/components/schemas/ViewerError"
+                  - properties:
+                      error:
+                        enum:
+                          - method_not_allowed
+          x-error-codes:
+            - method_not_allowed
+          headers:
+            Allow:
+              description: "Allowed methods: GET."
+              schema:
+                type: string
+                enum:
+                  - GET
+        default:
+          description: Unexpected server error (HTTP 500). `id` identifies the failure in the server log.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ViewerInternalError"
+  /admin/api/runs/{id}:
+    get:
+      operationId: getRun
+      summary: Run detail
+      description: |-
+        Full detail for one run, including final text.
+
+        Requires a bearer token with the `admin:view` scope, held by a caller with the admin role.
+      security:
+        - bearer: []
+      parameters:
+        - name: id
+          in: path
+          required: true
+          description: Run id.
+          schema:
+            type: string
+      responses:
+        "200":
+          description: The run.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/run-detail"
+        "401":
+          description: No valid bearer token.
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: "#/components/schemas/ViewerError"
+                  - properties:
+                      error:
+                        enum:
+                          - invalid_token
+          x-error-codes:
+            - invalid_token
+          headers:
+            WWW-Authenticate:
+              $ref: "#/components/headers/WWWAuthenticate"
+        "403":
+          description: Token lacks the `admin:view` scope (the `WWW-Authenticate` header is present), or the caller lacks the admin role (no `WWW-Authenticate` header).
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: "#/components/schemas/ViewerError"
+                  - properties:
+                      error:
+                        enum:
+                          - invalid_token
+          x-error-codes:
+            - invalid_token
+          headers:
+            WWW-Authenticate:
+              $ref: "#/components/headers/WWWAuthenticate"
+        "404":
+          description: No run with that id.
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: "#/components/schemas/ViewerError"
+                  - properties:
+                      error:
+                        enum:
+                          - not_found
+          x-error-codes:
+            - not_found
+        "405":
+          description: Only GET is allowed.
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: "#/components/schemas/ViewerError"
+                  - properties:
+                      error:
+                        enum:
+                          - method_not_allowed
+          x-error-codes:
+            - method_not_allowed
+          headers:
+            Allow:
+              description: "Allowed methods: GET."
+              schema:
+                type: string
+                enum:
+                  - GET
+        default:
+          description: Unexpected server error (HTTP 500). `id` identifies the failure in the server log.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ViewerInternalError"
+  /admin/api/infra:
+    get:
+      operationId: getInfra
+      summary: Infrastructure info
+      description: |-
+        Where and how this wardby deployment runs its workloads.
+
+        Requires a bearer token with the `admin:view` scope, held by a caller with the admin role.
+      security:
+        - bearer: []
+      responses:
+        "200":
+          description: Infrastructure info.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/infra-info"
+        "401":
+          description: No valid bearer token.
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: "#/components/schemas/ViewerError"
+                  - properties:
+                      error:
+                        enum:
+                          - invalid_token
+          x-error-codes:
+            - invalid_token
+          headers:
+            WWW-Authenticate:
+              $ref: "#/components/headers/WWWAuthenticate"
+        "403":
+          description: Token lacks the `admin:view` scope (the `WWW-Authenticate` header is present), or the caller lacks the admin role (no `WWW-Authenticate` header).
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: "#/components/schemas/ViewerError"
+                  - properties:
+                      error:
+                        enum:
+                          - invalid_token
+          x-error-codes:
+            - invalid_token
+          headers:
+            WWW-Authenticate:
+              $ref: "#/components/headers/WWWAuthenticate"
+        "405":
+          description: Only GET is allowed.
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: "#/components/schemas/ViewerError"
+                  - properties:
+                      error:
+                        enum:
+                          - method_not_allowed
+          x-error-codes:
+            - method_not_allowed
+          headers:
+            Allow:
+              description: "Allowed methods: GET."
+              schema:
+                type: string
+                enum:
+                  - GET
+        default:
+          description: Unexpected server error (HTTP 500). `id` identifies the failure in the server log.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ViewerInternalError"
+  /admin/api/events:
+    get:
+      operationId: getEvents
+      summary: Live event stream
+      description: |-
+        A Server-Sent Events stream (`text/event-stream`) of live changes. Frames:
+
+        - `retry: 3000`: suggested client reconnect delay in milliseconds.
+        - `event: hello`: sent first. Data is `{"connected": <bool>}`, whether the server's live-event connection is up.
+        - `event: run`, `event: service`, `event: outcome`: a run, coding-run service, or outcome changed. Each carries an `id:` line. Payloads match the `viewer-event` schema (see `x-event-schema`).
+        - `event: status`: the server's live-event connection changed. Data is `{"connected": <bool>}`.
+        - `event: resync`: the live-event connection is up (again). Events may have been missed: refetch the graph.
+        - `: ping`: comment sent every 15 seconds to keep the connection open.
+
+        There is no replay. Open the event stream first, then load `/admin/api/graph` and apply events on top of it. Refetch the graph on every `resync` and after every reconnect rather than trying to resume.
+
+        Requires a bearer token with the `admin:view` scope, held by a caller with the admin role.
+      security:
+        - bearer: []
+      responses:
+        "200":
+          description: The event stream.
+          content:
+            text/event-stream:
+              schema:
+                type: string
+          x-event-schema:
+            $ref: "#/components/schemas/viewer-event"
+        "401":
+          description: No valid bearer token.
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: "#/components/schemas/ViewerError"
+                  - properties:
+                      error:
+                        enum:
+                          - invalid_token
+          x-error-codes:
+            - invalid_token
+          headers:
+            WWW-Authenticate:
+              $ref: "#/components/headers/WWWAuthenticate"
+        "403":
+          description: Token lacks the `admin:view` scope (the `WWW-Authenticate` header is present), or the caller lacks the admin role (no `WWW-Authenticate` header).
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: "#/components/schemas/ViewerError"
+                  - properties:
+                      error:
+                        enum:
+                          - invalid_token
+          x-error-codes:
+            - invalid_token
+          headers:
+            WWW-Authenticate:
+              $ref: "#/components/headers/WWWAuthenticate"
+        "405":
+          description: Only GET is allowed.
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: "#/components/schemas/ViewerError"
+                  - properties:
+                      error:
+                        enum:
+                          - method_not_allowed
+          x-error-codes:
+            - method_not_allowed
+          headers:
+            Allow:
+              description: "Allowed methods: GET."
+              schema:
+                type: string
+                enum:
+                  - GET
+        default:
+          description: Unexpected server error (HTTP 500). `id` identifies the failure in the server log.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ViewerInternalError"
+components:
+  securitySchemes:
+    bearer:
+      type: http
+      scheme: bearer
+  headers:
+    WWWAuthenticate:
+      description: Bearer challenge.
+      schema:
+        type: string
+  schemas:
+    graph-snapshot:
+      type: object
+      properties:
+        generatedAt:
+          type: string
+        since:
+          type: string
+        limit:
+          type: integer
+        truncated:
+          type: boolean
+        runs:
+          type: array
+          items:
+            type: object
+            properties:
+              id:
+                type: string
+              parentRunId:
+                type:
+                  - string
+                  - "null"
+              agentId:
+                type: string
+              agentName:
+                type: string
+              agentKind:
+                type: string
+                enum:
+                  - native
+                  - coding
+              model:
+                type: string
+              codingProvider:
+                type:
+                  - string
+                  - "null"
+              nativeExecutionMode:
+                anyOf:
+                  - type: string
+                    enum:
+                      - control-plane
+                      - sandbox
+                  - type: "null"
+              warmWorkerName:
+                type:
+                  - string
+                  - "null"
+              status:
+                type: string
+                enum:
+                  - pending
+                  - running
+                  - succeeded
+                  - failed
+                  - refused
+                  - lost
+                  - budget_exhausted
+                  - cancelled
+              trigger:
+                anyOf:
+                  - type: object
+                    properties:
+                      kind:
+                        type: string
+                        const: manual
+                    required:
+                      - kind
+                    additionalProperties: false
+                  - type: object
+                    properties:
+                      kind:
+                        type: string
+                        const: scheduled
+                      schedule:
+                        type:
+                          - string
+                          - "null"
+                    required:
+                      - kind
+                      - schedule
+                    additionalProperties: false
+                  - type: object
+                    properties:
+                      kind:
+                        type: string
+                        const: webhook
+                    required:
+                      - kind
+                    additionalProperties: false
+                  - type: object
+                    properties:
+                      kind:
+                        type: string
+                        const: subagent
+                    required:
+                      - kind
+                    additionalProperties: false
+                  - type: object
+                    properties:
+                      kind:
+                        type: string
+                        const: code_host
+                      provider:
+                        type: string
+                      repository:
+                        type: string
+                      number:
+                        anyOf:
+                          - type: integer
+                          - type: "null"
+                      event:
+                        type: string
+                        enum:
+                          - review
+                          - mention
+                    required:
+                      - kind
+                      - provider
+                      - repository
+                      - number
+                      - event
+                    additionalProperties: false
+                  - type: object
+                    properties:
+                      kind:
+                        type: string
+                        const: issue
+                      provider:
+                        type: string
+                      issueKey:
+                        type: string
+                      url:
+                        type:
+                          - string
+                          - "null"
+                    required:
+                      - kind
+                      - provider
+                      - issueKey
+                      - url
+                    additionalProperties: false
+                  - type: object
+                    properties:
+                      kind:
+                        type: string
+                        const: host_event
+                    required:
+                      - kind
+                    additionalProperties: false
+              turns:
+                type: integer
+              tokensIn:
+                type: integer
+              tokensOut:
+                type: integer
+              costUsd:
+                type: number
+              budgetUsd:
+                type: number
+              startedAt:
+                type: string
+              finishedAt:
+                type:
+                  - string
+                  - "null"
+              heartbeatAt:
+                type:
+                  - string
+                  - "null"
+              outcomes:
+                type: array
+                items:
+                  anyOf:
+                    - type: object
+                      properties:
+                        kind:
+                          type: string
+                          const: pull_request
+                        provider:
+                          type: string
+                        repository:
+                          type: string
+                        number:
+                          type: integer
+                        url:
+                          type: string
+                        state:
+                          type:
+                            - string
+                            - "null"
+                        at:
+                          type:
+                            - string
+                            - "null"
+                      required:
+                        - kind
+                        - provider
+                        - repository
+                        - number
+                        - url
+                        - state
+                        - at
+                      additionalProperties: false
+                    - type: object
+                      properties:
+                        kind:
+                          type: string
+                          const: code_host_comment
+                        provider:
+                          type: string
+                        repository:
+                          type: string
+                        number:
+                          type: integer
+                        at:
+                          type:
+                            - string
+                            - "null"
+                      required:
+                        - kind
+                        - provider
+                        - repository
+                        - number
+                        - at
+                      additionalProperties: false
+                    - type: object
+                      properties:
+                        kind:
+                          type: string
+                          const: issue_comment
+                        provider:
+                          type: string
+                        issueKey:
+                          type: string
+                        url:
+                          type:
+                            - string
+                            - "null"
+                        at:
+                          type:
+                            - string
+                            - "null"
+                      required:
+                        - kind
+                        - provider
+                        - issueKey
+                        - url
+                        - at
+                      additionalProperties: false
+                    - type: object
+                      properties:
+                        kind:
+                          type: string
+                          const: check
+                        provider:
+                          type: string
+                        repository:
+                          type: string
+                        number:
+                          anyOf:
+                            - type: integer
+                            - type: "null"
+                        completed:
+                          type: boolean
+                        at:
+                          type:
+                            - string
+                            - "null"
+                      required:
+                        - kind
+                        - provider
+                        - repository
+                        - number
+                        - completed
+                        - at
+                      additionalProperties: false
+              declaredServices:
+                type: array
+                items:
+                  type: object
+                  properties:
+                    name:
+                      type: string
+                    version:
+                      type: string
+                  required:
+                    - name
+                    - version
+                  additionalProperties: false
+              services:
+                type: array
+                items:
+                  type: object
+                  properties:
+                    name:
+                      type: string
+                    state:
+                      type: string
+                      enum:
+                        - pending
+                        - probing
+                        - ready
+                        - failed
+                    attempts:
+                      anyOf:
+                        - type: integer
+                        - type: "null"
+                    reason:
+                      type:
+                        - string
+                        - "null"
+                    readyAt:
+                      type:
+                        - string
+                        - "null"
+                    failedAt:
+                      type:
+                        - string
+                        - "null"
+                    createdAt:
+                      type: string
+                  required:
+                    - name
+                    - state
+                    - attempts
+                    - reason
+                    - readyAt
+                    - failedAt
+                    - createdAt
+                  additionalProperties: false
+            required:
+              - id
+              - parentRunId
+              - agentId
+              - agentName
+              - agentKind
+              - model
+              - codingProvider
+              - nativeExecutionMode
+              - warmWorkerName
+              - status
+              - trigger
+              - turns
+              - tokensIn
+              - tokensOut
+              - costUsd
+              - budgetUsd
+              - startedAt
+              - finishedAt
+              - heartbeatAt
+              - outcomes
+              - declaredServices
+              - services
+            additionalProperties: false
+        spend:
+          type: object
+          properties:
+            todayUsd:
+              type: number
+            groups:
+              type: array
+              items:
+                type: object
+                properties:
+                  id:
+                    type: string
+                  name:
+                    type: string
+                  dailyBudgetUsd:
+                    type:
+                      - number
+                      - "null"
+                  spentTodayUsd:
+                    type: number
+                required:
+                  - id
+                  - name
+                  - dailyBudgetUsd
+                  - spentTodayUsd
+                additionalProperties: false
+          required:
+            - todayUsd
+            - groups
+          additionalProperties: false
+      required:
+        - generatedAt
+        - since
+        - limit
+        - truncated
+        - runs
+        - spend
+      additionalProperties: false
+    run-detail:
+      type: object
+      properties:
+        id:
+          type: string
+        parentRunId:
+          type:
+            - string
+            - "null"
+        agentId:
+          type: string
+        agentName:
+          type: string
+        agentKind:
+          type: string
+          enum:
+            - native
+            - coding
+        model:
+          type: string
+        codingProvider:
+          type:
+            - string
+            - "null"
+        nativeExecutionMode:
+          anyOf:
+            - type: string
+              enum:
+                - control-plane
+                - sandbox
+            - type: "null"
+        warmWorkerName:
+          type:
+            - string
+            - "null"
+        status:
+          type: string
+          enum:
+            - pending
+            - running
+            - succeeded
+            - failed
+            - refused
+            - lost
+            - budget_exhausted
+            - cancelled
+        trigger:
+          anyOf:
+            - type: object
+              properties:
+                kind:
+                  type: string
+                  const: manual
+              required:
+                - kind
+              additionalProperties: false
+            - type: object
+              properties:
+                kind:
+                  type: string
+                  const: scheduled
+                schedule:
+                  type:
+                    - string
+                    - "null"
+              required:
+                - kind
+                - schedule
+              additionalProperties: false
+            - type: object
+              properties:
+                kind:
+                  type: string
+                  const: webhook
+              required:
+                - kind
+              additionalProperties: false
+            - type: object
+              properties:
+                kind:
+                  type: string
+                  const: subagent
+              required:
+                - kind
+              additionalProperties: false
+            - type: object
+              properties:
+                kind:
+                  type: string
+                  const: code_host
+                provider:
+                  type: string
+                repository:
+                  type: string
+                number:
+                  anyOf:
+                    - type: integer
+                    - type: "null"
+                event:
+                  type: string
+                  enum:
+                    - review
+                    - mention
+              required:
+                - kind
+                - provider
+                - repository
+                - number
+                - event
+              additionalProperties: false
+            - type: object
+              properties:
+                kind:
+                  type: string
+                  const: issue
+                provider:
+                  type: string
+                issueKey:
+                  type: string
+                url:
+                  type:
+                    - string
+                    - "null"
+              required:
+                - kind
+                - provider
+                - issueKey
+                - url
+              additionalProperties: false
+            - type: object
+              properties:
+                kind:
+                  type: string
+                  const: host_event
+              required:
+                - kind
+              additionalProperties: false
+        turns:
+          type: integer
+        tokensIn:
+          type: integer
+        tokensOut:
+          type: integer
+        costUsd:
+          type: number
+        budgetUsd:
+          type: number
+        startedAt:
+          type: string
+        finishedAt:
+          type:
+            - string
+            - "null"
+        heartbeatAt:
+          type:
+            - string
+            - "null"
+        outcomes:
+          type: array
+          items:
+            anyOf:
+              - type: object
+                properties:
+                  kind:
+                    type: string
+                    const: pull_request
+                  provider:
+                    type: string
+                  repository:
+                    type: string
+                  number:
+                    type: integer
+                  url:
+                    type: string
+                  state:
+                    type:
+                      - string
+                      - "null"
+                  at:
+                    type:
+                      - string
+                      - "null"
+                required:
+                  - kind
+                  - provider
+                  - repository
+                  - number
+                  - url
+                  - state
+                  - at
+                additionalProperties: false
+              - type: object
+                properties:
+                  kind:
+                    type: string
+                    const: code_host_comment
+                  provider:
+                    type: string
+                  repository:
+                    type: string
+                  number:
+                    type: integer
+                  at:
+                    type:
+                      - string
+                      - "null"
+                required:
+                  - kind
+                  - provider
+                  - repository
+                  - number
+                  - at
+                additionalProperties: false
+              - type: object
+                properties:
+                  kind:
+                    type: string
+                    const: issue_comment
+                  provider:
+                    type: string
+                  issueKey:
+                    type: string
+                  url:
+                    type:
+                      - string
+                      - "null"
+                  at:
+                    type:
+                      - string
+                      - "null"
+                required:
+                  - kind
+                  - provider
+                  - issueKey
+                  - url
+                  - at
+                additionalProperties: false
+              - type: object
+                properties:
+                  kind:
+                    type: string
+                    const: check
+                  provider:
+                    type: string
+                  repository:
+                    type: string
+                  number:
+                    anyOf:
+                      - type: integer
+                      - type: "null"
+                  completed:
+                    type: boolean
+                  at:
+                    type:
+                      - string
+                      - "null"
+                required:
+                  - kind
+                  - provider
+                  - repository
+                  - number
+                  - completed
+                  - at
+                additionalProperties: false
+        declaredServices:
+          type: array
+          items:
+            type: object
+            properties:
+              name:
+                type: string
+              version:
+                type: string
+            required:
+              - name
+              - version
+            additionalProperties: false
+        services:
+          type: array
+          items:
+            type: object
+            properties:
+              name:
+                type: string
+              state:
+                type: string
+                enum:
+                  - pending
+                  - probing
+                  - ready
+                  - failed
+              attempts:
+                anyOf:
+                  - type: integer
+                  - type: "null"
+              reason:
+                type:
+                  - string
+                  - "null"
+              readyAt:
+                type:
+                  - string
+                  - "null"
+              failedAt:
+                type:
+                  - string
+                  - "null"
+              createdAt:
+                type: string
+            required:
+              - name
+              - state
+              - attempts
+              - reason
+              - readyAt
+              - failedAt
+              - createdAt
+            additionalProperties: false
+        error:
+          type:
+            - string
+            - "null"
+        finalText:
+          type:
+            - string
+            - "null"
+        childRunIds:
+          type: array
+          items:
+            type: string
+        coding:
+          anyOf:
+            - type: object
+              properties:
+                provider:
+                  type: string
+                repository:
+                  type: string
+                baseRef:
+                  type: string
+                headRef:
+                  type: string
+                queuedAt:
+                  type:
+                    - string
+                    - "null"
+                failureCategory:
+                  type:
+                    - string
+                    - "null"
+                services:
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      name:
+                        type: string
+                      version:
+                        type: string
+                      image:
+                        type: string
+                      envNames:
+                        type: array
+                        items:
+                          type: string
+                    required:
+                      - name
+                      - version
+                      - image
+                      - envNames
+                    additionalProperties: false
+              required:
+                - provider
+                - repository
+                - baseRef
+                - headRef
+                - queuedAt
+                - failureCategory
+                - services
+              additionalProperties: false
+            - type: "null"
+      required:
+        - id
+        - parentRunId
+        - agentId
+        - agentName
+        - agentKind
+        - model
+        - codingProvider
+        - nativeExecutionMode
+        - warmWorkerName
+        - status
+        - trigger
+        - turns
+        - tokensIn
+        - tokensOut
+        - costUsd
+        - budgetUsd
+        - startedAt
+        - finishedAt
+        - heartbeatAt
+        - outcomes
+        - declaredServices
+        - services
+        - error
+        - finalText
+        - childRunIds
+        - coding
+      additionalProperties: false
+    viewer-event:
+      anyOf:
+        - type: object
+          properties:
+            kind:
+              type: string
+              const: run
+            runId:
+              type: string
+            parentRunId:
+              type:
+                - string
+                - "null"
+            agentId:
+              type: string
+            status:
+              type: string
+              enum:
+                - pending
+                - running
+                - succeeded
+                - failed
+                - refused
+                - lost
+                - budget_exhausted
+                - cancelled
+            turns:
+              type: integer
+            tokensIn:
+              type: integer
+            tokensOut:
+              type: integer
+            costUsd:
+              type: number
+            finishedAt:
+              type:
+                - string
+                - "null"
+          required:
+            - kind
+            - runId
+            - parentRunId
+            - agentId
+            - status
+            - turns
+            - tokensIn
+            - tokensOut
+            - costUsd
+            - finishedAt
+          additionalProperties: false
+        - type: object
+          properties:
+            kind:
+              type: string
+              const: service
+            runId:
+              type: string
+            name:
+              type: string
+            state:
+              type: string
+              enum:
+                - pending
+                - probing
+                - ready
+                - failed
+            attempts:
+              anyOf:
+                - type: integer
+                - type: "null"
+          required:
+            - kind
+            - runId
+            - name
+            - state
+            - attempts
+          additionalProperties: false
+        - type: object
+          properties:
+            kind:
+              type: string
+              const: outcome
+            runId:
+              type: string
+            source:
+              type: string
+              enum:
+                - pull_request
+                - host_status
+                - issue_status
+                - host_check
+          required:
+            - kind
+            - runId
+            - source
+          additionalProperties: false
+    infra-info:
+      type: object
+      properties:
+        launcher:
+          type: string
+          enum:
+            - local
+            - docker
+            - kubernetes
+        kubernetes:
+          anyOf:
+            - type: object
+              properties:
+                namespace:
+                  type: string
+                platform:
+                  type: string
+                runtimeClass:
+                  type:
+                    - string
+                    - "null"
+                proxyService:
+                  type: string
+                runLabel:
+                  type: string
+                runLabelHashChars:
+                  type: integer
+                componentLabel:
+                  type: object
+                  additionalProperties:
+                    type: string
+                managedByLabel:
+                  type: object
+                  additionalProperties:
+                    type: string
+              required:
+                - namespace
+                - platform
+                - runtimeClass
+                - proxyService
+                - runLabel
+                - runLabelHashChars
+                - componentLabel
+                - managedByLabel
+              additionalProperties: false
+            - type: "null"
+        native:
+          anyOf:
+            - type: object
+              properties:
+                launcher:
+                  type: string
+                  enum:
+                    - docker
+                    - kubernetes
+                warmPoolSize:
+                  type: integer
+                kubernetes:
+                  anyOf:
+                    - type: object
+                      properties:
+                        namespace:
+                          type: string
+                        runtimeClass:
+                          type:
+                            - string
+                            - "null"
+                        runLabel:
+                          type: string
+                        componentLabel:
+                          type: object
+                          additionalProperties:
+                            type: string
+                        warmPoolLabel:
+                          type: object
+                          additionalProperties:
+                            type: string
+                        warmWorkerLabel:
+                          type: string
+                      required:
+                        - namespace
+                        - runtimeClass
+                        - runLabel
+                        - componentLabel
+                        - warmPoolLabel
+                        - warmWorkerLabel
+                      additionalProperties: false
+                    - type: "null"
+              required:
+                - launcher
+                - warmPoolSize
+                - kubernetes
+              additionalProperties: false
+            - type: "null"
+      required:
+        - launcher
+        - kubernetes
+        - native
+      additionalProperties: false
+    ViewerError:
+      type: object
+      required:
+        - error
+      properties:
+        error:
+          type: string
+      additionalProperties: false
+    ViewerInternalError:
+      type: object
+      required:
+        - error
+        - id
+      properties:
+        error:
+          type: string
+          enum:
+            - internal_error
+        id:
+          type: string
+      additionalProperties: false