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
    installedIdentity object

    Durable installed generation identity, when a sidecar is present.

    anyOf
    string
    manifestSha256 object

    Canonical file-manifest digest used for replica deduplication.

    anyOf
    string
    verificationState object

    Evidence level binding this copy to its retained card.

    anyOf
    string
    manifestCompleteManifestcomplete (boolean)

    Whether every sidecar manifest path and size is present.

    Default value: false
    artifactRole object

    Base or companion role represented by this cache directory.

    anyOf
    string
    ownerModelId object

    Owning base model for companion artifacts.

    anyOf
    string
    ownerCardId object

    Immutable owning card identity for a companion artifact.

    anyOf
    string
    registryCardId object

    Registry identity retained by the artifact's full effective card.

    anyOf
    string
    locationKindLocationkind (string)

    Whether this directory is canonical-store-local or a node cache.

    Possible values: [store_local, node_cache]

    Default value: node_cache
  • ]
    • 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,
          "installedIdentity": "string",
          "manifestSha256": "string",
          "verificationState": "string",
          "manifestComplete": false,
          "artifactRole": "string",
          "ownerModelId": "string",
          "ownerCardId": "string",
          "registryCardId": "string",
          "locationKind": "node_cache"
        }
      ],
      "stagedTotalBytes": 0,
      "eventLogBytes": 0,
      "diskTotalBytes": 0,
      "diskFreeBytes": 0
    }