Skip to content

Extension manifest 0.1

Schema reference / Extension manifest / 0.1

Process extension entrypoint, contributions, requested grants and mandatory sandbox profile.

Status
Latest
Published
2026-10-07
Title
“Hyprune v0 extension”
Dialect
JSON Schema 2020-12 · unknown fields rejected unless marked
Raw schemaextension.schema.json · 121 lines · 2.5 KB
DownloadOpen rawsha256 b5a73bb9f0a6…
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://hyprune.com/schema/v0/extension.schema.json",
"title": "Hyprune v0 extension",
"type": "object",
"properties": {
"manifestVersion": {
"const": "0.1"
},
"id": {
"$ref": "common.schema.json#/$defs/id"
},
"version": {
"$ref": "common.schema.json#/$defs/version"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"description": {
"type": "string",
"minLength": 0,
"maxLength": 4096
},
"license": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"apiVersion": {
"const": "0.1"
},
"runtime": {
"const": "process"
},
"entrypoint": {
"$ref": "common.schema.json#/$defs/path"
},
"capabilities": {
"type": "array",
"items": {
"$ref": "common.schema.json#/$defs/capability"
},
"minItems": 0,
"uniqueItems": true
},
"contributes": {
"type": "object",
"properties": {
"screenTypes": {
"type": "array",
"items": {
"$ref": "common.schema.json#/$defs/path"
},
"minItems": 0,
"uniqueItems": true
},
"widgets": {
"type": "array",
"items": {
"$ref": "common.schema.json#/$defs/id"
},
"minItems": 0,
"uniqueItems": true
},
"movementModes": {
"type": "array",
"items": {
"$ref": "common.schema.json#/$defs/id"
},
"minItems": 0,
"uniqueItems": true
},
"integrations": {
"type": "array",
"items": {
"$ref": "common.schema.json#/$defs/id"
},
"minItems": 0,
"uniqueItems": true
}
},
"required": [],
"additionalProperties": false
},
"sandbox": {
"type": "object",
"properties": {
"required": {
"const": true
},
"network": {
"const": false
}
},
"required": [
"required",
"network"
],
"additionalProperties": false
},
"extensions": {
"$ref": "common.schema.json#/$defs/extensions"
}
},
"required": [
"manifestVersion",
"id",
"version",
"name",
"license",
"apiVersion",
"runtime",
"entrypoint",
"capabilities",
"contributes",
"sandbox"
],
"additionalProperties": false
}

This is the first published version of this contract.

Fields

FieldTypeConstraints
manifestVersionrequired"0.1"
idrequiredid
versionrequiredversion
namerequiredstringlength 1–256
descriptionstringlength 0–4096
licenserequiredstringlength 1–256
apiVersionrequired"0.1"
runtimerequired"process"
entrypointrequiredpath
capabilitiesrequiredcapability[]items ≥ 0 · unique items
contributesrequiredobject
screenTypespath[]items ≥ 0 · unique items
widgetsid[]items ≥ 0 · unique items
movementModesid[]items ≥ 0 · unique items
integrationsid[]items ≥ 0 · unique items
sandboxrequiredobject
requiredrequiredtrue
networkrequiredfalse
extensionsextensions

Examples

Offline fixtures from the schema repository, validated by its test suite. They show shape, not a real session or package.

extension.jsonextension.json · 22 lines · 388 B
{
"manifestVersion": "0.1",
"id": "com.hyprune.clock",
"version": "0.1.0",
"name": "World clock",
"license": "MIT",
"apiVersion": "0.1",
"runtime": "process",
"entrypoint": "bin/clock",
"capabilities": [
"state.read"
],
"contributes": {
"widgets": [
"com.hyprune.clock.widget"
]
},
"sandbox": {
"required": true,
"network": false
}
}

Mirrored byte-for-byte from hyprune/schema at 34849da45183 (2026-10-15). SHA-256 b5a73bb9f0a6d2b6c12e1ff32c0a39463e08eaa5af245c397cf55aa97613704b.