InstallOperation

Durable staging progress; accepted work belongs to the independent manager.

attemptAttempt (integer)

Original attempt is zero; explicitly requested recovery attempts retain separate evidence.

Possible values: >= 0 and <= 8

Default value: 0

attempt_source_revision object

Owner-reviewed current source revision for a recovery attempt; original intent remains unchanged.

anyOf

• integer
• null

integer

Possible values: >= 1

request objectrequired

Exact reviewed release intent; no paths, executable, credential or activation.

operation_idOperation Id (string)required

Retained installation operation ID.

Possible values: Value must match regular expression ^[a-f0-9]{32}$

runtime_digestRuntime Digest (string)required

Exact reviewed signed runtime digest.

Possible values: Value must match regular expression ^[a-f0-9]{64}$

expected_source_revisionExpected Source Revision (integer)required

Reviewed source revision.

Possible values: >= 1

review objectrequired

Verified immutable release identity and permissions available before installation.

runtime_digestRuntime Digest (string)required

Digest of all signed runtime claims.

Possible values: Value must match regular expression ^[a-f0-9]{64}$

source_revisionSource Revision (integer)required

Reviewed owner source revision.

Possible values: >= 1

publisherPublisher (string)required

Trusted publisher identity.

bundle_idBundle Id (string)required

Signed stable plugin identity.

versionVersion (string)required

Signed plugin release version.

sequenceSequence (integer)required

Signed publisher release sequence.

Possible values: >= 1

platformPlatform (string)required

Verified compatible host platform.

Possible values: <= 64 characters, Value must match regular expression ^[a-z0-9]+(?:[.-][a-z0-9_]+)*$

python_requiresPython Requires (string)required

Signed supported Python version range.

skulk_build_sha256Skulk Build Sha256 (string)required

Exact qualified Skulk build.

Possible values: Value must match regular expression ^[a-f0-9]{64}$

permissionsstring[]required

Signed declared plugin permissions.

artifact_bytesArtifact Bytes (integer)required

Total signed bundle and wheel byte count.

Possible values: >= 1

expires_atExpires At (integer)required

Signed release expiry as Unix seconds.

stateState (string)required

Installation progress, separate from runtime activation.

Possible values: [accepted, downloading, staging, staged, recovery_required]

downloaded_bytesDownloaded Bytes (integer)

Verified downloaded artifact bytes.

Possible values: >= 0

Default value: 0

error_code object

Sanitized local failure class; no raw network or installer output.

anyOf

• string
• null

string

Possible values: [download_failed, installation_failed, installation_interrupted]

InstallOperation

{
  "attempt": 0,
  "attempt_source_revision": 0,
  "request": {
    "operation_id": "string",
    "runtime_digest": "string",
    "expected_source_revision": 0
  },
  "review": {
    "runtime_digest": "string",
    "source_revision": 0,
    "publisher": "string",
    "bundle_id": "string",
    "version": "string",
    "sequence": 0,
    "platform": "string",
    "python_requires": "string",
    "skulk_build_sha256": "string",
    "permissions": [
      "string"
    ],
    "artifact_bytes": 0,
    "expires_at": 0
  },
  "state": "accepted",
  "downloaded_bytes": 0,
  "error_code": "download_failed"
}