Plugin manifest

The manifest is a strict JSON document; unrecognized fields are rejected.

{
  "schemaVersion": 1,
  "pluginId": "c6d3ccf8-c96c-46b6-a254-8fce86337c37",
  "sdkVersion": "0.1.0",
  "name": "Yerel Sayaç Örneği",
  "version": "1.0.0",
  "runtime": { "kind": "trusted-node", "entry": "runtime.mjs" },
  "hostCompatibility": { "minimumVersion": "0.2.0" },
  "permissions": [{ "name": "key.display" }],
  "settingsSchema": [],
  "actions": [{ "id": "counter", "name": "Sayaç", "controllers": ["Keypad"], "settingsSchema": [] }]
}

Identity

pluginId is the immutable identity.
The runtime action identity is the combination pluginId + local action id.
Action IDs are unique within the same manifest.
The runtime cannot change identity through a request payload.

Runtime

`runtime.kind`	Entry
`trusted-node`	`.js`, `.mjs` or `.cjs`
`sandbox-js`	Browser-compatible `.js` or `.mjs`
`wasm`	`.wasm`; the next language-neutral target

Setting keys use lower camelCase. secret and oauth fields cannot carry a default value; raw credentials are not written into normal settings or the manifest. The manifest should declare only the permission descriptors it needs. The runtime grant set is computed as declared ∩ user-granted.

Icon (`glyph`)

The plugin and each action can choose their own icon. If none is declared, both show the default code icon; an action without a glyph falls back to the plugin glyph.

{
  "glyph": "CommandLineIcon",
  "actions": [
    { "id": "prompt", "name": "Prompt gönder", "glyph": "AiChat01Icon" },
    { "id": "abort", "name": "Durdur", "glyph": "StopCircleIcon" }
  ]
}

The value is a Hugeicons name and is chosen from a fixed list. Free-form names are not accepted: the host statically imports glyphs one by one in both the desktop rasterizer and the interface, and bundling the whole icon set would exceed the renderer budget. A name that is not on the list gets the manifest rejected.

The full list of valid names is in PLUGIN_GLYPH_NAMES (@evox/plugin-protocol). Adding a name to the list is a host-side change; if the glyph you need is missing, open a request.

Conditional setting visibility (`visibleWhen`)

A setting can be shown only while another setting has a certain value.

{
  "settingsSchema": [
    {
      "key": "preset",
      "type": "select",
      "label": "Preset",
      "default": "tests",
      "options": [
        { "value": "tests", "label": "Testleri çalıştır" },
        { "value": "custom", "label": "Özel prompt" }
      ]
    },
    {
      "key": "prompt",
      "type": "text",
      "label": "Özel prompt",
      "visibleWhen": { "key": "preset", "in": ["custom"] }
    }
  ]
}

key must point to another setting in the same settingsSchema. A reference to a key that does not exist, or to the field itself, gets the manifest rejected — both would silently hide the field forever.
The comparison is case-insensitive.
If the referenced setting’s value is empty, that setting’s default is used; in the example above, on a key that was never touched preset defaults to tests, so the prompt field starts hidden.
The saved value of a hidden field is not deleted; when the user switches back to the option that satisfies the condition, they find the old value.

Getting started

Core concepts

Examples and distribution

Identity

Runtime

Icon (`glyph`)

Conditional setting visibility (`visibleWhen`)

​Identity

​Runtime

​Icon (glyph)

​Conditional setting visibility (visibleWhen)

Identity

Runtime

Icon (`glyph`)

Conditional setting visibility (`visibleWhen`)