Skip to main content

NodeStorageSummary

Per-node storage breakdown for the local node.

Sizes are computed on demand by walking the relevant directories; staged models include last-use times and whether a live instance (or its companion repos) currently depends on them.

nodeIdNodeid (string)required
stagingRoot objectrequired

Resolved staging directory for this node, or None when the model store / staging is not configured.

anyOf
string
stagedModels object[]required
  • Array [
    • modelIdModelid (string)required

    Model ID in repo form (org/name), reconstructed from the directory name.

    directoryDirectory (string)required

    Absolute path of the staged copy.

    sizeBytesSizebytes (integer)required

    Total size of all files in the staged copy.

    lastUsedEpochSecondsLastusedepochseconds (number)required

    Best-known last-use time: the .last_used marker when present, else the directory mtime.

    inUseInuse (boolean)

    True when a live runner currently uses this model (directly or as a companion). In-use models are never eviction candidates.

    Default value: false
  • ]
    • stagedTotalBytesStagedtotalbytes (integer)required
    eventLogBytesEventlogbytes (integer)required

    Total size of this node's event-log directory (active + archives).

    diskTotalBytesDisktotalbytes (integer)required
    diskFreeBytesDiskfreebytes (integer)required

    Capacity and free space of the volume holding the staging directory (falls back to the models directory when staging is not configured).

    NodeStorageSummary
    {
      "nodeId": "string",
      "stagingRoot": "string",
      "stagedModels": [
        {
          "modelId": "string",
          "directory": "string",
          "sizeBytes": 0,
          "lastUsedEpochSeconds": 0,
          "inUse": false
        }
      ],
      "stagedTotalBytes": 0,
      "eventLogBytes": 0,
      "diskTotalBytes": 0,
      "diskFreeBytes": 0
    }