Skip to content

DependencyStatus

Defined in: core.ts:201

The resolved status of a single declared dependency (system or plugin).

Returned by lifecycle.getDependencyStatus() and lifecycle.recheckDependencies(). Matches the Swift DependencyStatus struct with custom Codable flattening of InstallationState.

name: string

Defined in: core.ts:203

Human-readable name of the dependency.


type: DependencyType

Defined in: core.ts:205

Whether this is a system binary or plugin dependency.


required: boolean

Defined in: core.ts:207

Whether this dependency is required for the plugin to function.


satisfied: boolean

Defined in: core.ts:209

Whether the dependency constraint is fully satisfied.


state: InstallationState

Defined in: core.ts:211

The resolved installation state.


optional installedVersion?: string

Defined in: core.ts:213

Detected version string. Present only when state === "installed".


optional requiredVersion?: string

Defined in: core.ts:215

Minimum version constraint from the manifest. Undefined when no minVersion declared.


optional installHint?: string

Defined in: core.ts:217

Human-readable install hint (e.g., “brew install yt-dlp”).


optional installUrl?: string

Defined in: core.ts:219

URL to installation instructions.


optional description?: string

Defined in: core.ts:221

Human-readable description of the dependency’s purpose.


optional unsatisfiedReason?: string

Defined in: core.ts:223

Reason why the dependency is unsatisfied. Present only when satisfied === false.


optional causalChain?: string[]

Defined in: core.ts:225

Causal chain for transitive dependencies. Present for required transitive deps (e.g., ["required by com.foo.bar"]).