Skip to main content

StagedModelInfo

One staged model directory, as seen by eviction and the storage API.

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
StagedModelInfo
{
  "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"
}