Reference

runtime

Discovery, health and administration of the runtime itself. Index · shared schemas · errors.

runtime.version

Identify the server and its contract range. The only unauthenticated read; it says nothing about devices.

Input:

{}

Output:

{
  product: 'troupe'
  kind: 'runtime' | 'cloud' | …
  version: string
  contract: ContractInfo
  instanceId?: RuntimeInstanceId
}

Errors: U.

Named types: ContractInfo, RuntimeInstanceId.

runtime.capabilities

Report contract features, enabled platforms and their capabilities, and limits

Input:

{}

Output:

{
  contract: ContractInfo
  features: string[]
  platforms: PlatformCapabilities[]
  limits: { maxTimeoutMs: integer; mcpMaxTimeoutMs: integer }
}

Errors: U.

Named types: ContractInfo, PlatformCapabilities.

runtime.status

Report daemon health: sessions, the device inventory, supervisors and restart counts, governor level, leaks

Input:

{}

Output:

RuntimeStatus

Errors: U.

Named types: RuntimeStatus.

runtime.hostInfo

Report the host: OS, arch, RAM and disk, GUI session, profile, resolved toolchain paths and versions, limits

Input:

{}

Output:

HostInfo

Errors: U.

Named types: HostInfo.

runtime.doctor

Run read-only environment checks (troupe doctor --json). Failures come back as results; they are not thrown.

Input:

{
  platforms?: PlatformId[]  // ≤ 16 items
}

Output:

{ ok: boolean; checks: DoctorCheck[] }

Errors: U.

Named types: DoctorCheck, PlatformId.

runtime.shutdown

Stop the daemon. With live sessions and no force it refuses with CONFLICT.

Input:

{
  force?: boolean  // default false
}

Output:

{
  endedSessions: integer  // ≥ 0
}

Errors: U, CONFLICT.

runtime.sweep

Find leaked Troupe-owned devices and processes, and remove them when apply is set; anything not Troupe-owned is reported, never touched

Input:

{
  apply?: boolean  // default false
}

Output:

{
  found: LeakItem[]
  removed: integer  // ≥ 0
}

Errors: U.

Named types: LeakItem.