Extension manifest 0.1
Schema reference / Extension manifest / 0.1
Process extension entrypoint, contributions, requested grants and mandatory sandbox profile.
Raw schema
{ "$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
| Field | Type | Constraints |
|---|---|---|
manifestVersionrequired | "0.1" | |
idrequired | id | |
versionrequired | version | |
namerequired | string | length 1–256 |
description | string | length 0–4096 |
licenserequired | string | length 1–256 |
apiVersionrequired | "0.1" | |
runtimerequired | "process" | |
entrypointrequired | path | |
capabilitiesrequired | capability[] | items ≥ 0 · unique items |
contributesrequired | object | |
screenTypes | path[] | items ≥ 0 · unique items |
widgets | id[] | items ≥ 0 · unique items |
movementModes | id[] | items ≥ 0 · unique items |
integrations | id[] | items ≥ 0 · unique items |
sandboxrequired | object | |
requiredrequired | true | |
networkrequired | false | |
extensions | extensions |
Examples
Offline fixtures from the schema repository, validated by its test suite. They show shape, not a real session or package.
extension.json
{ "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.