Skip to main content

Appendix A: aip.json Full Schema Reference

This document provides a comprehensive reference for all valid fields in the aip.json manifest file.

Full Example

{
"tenant": "my-corp",
"name": "example-pack",
"version": "1.2.0",
"display_name": "Example Pack",
"description": "An example pack that demonstrates key features.",
"author": "My Corp <dev@my-corp.com>",
"views": {
"home": { "title": "Dashboard" }
},
"capabilities": [
"net.access"
],
"dependencies": [
"worka/browser"
]
}

Root Fields

FieldTypeRequiredDescription
tenantstringYesA unique namespace for the pack author, like a GitHub username or company name.
namestringYesThe machine-readable name of the pack (e.g., my-cool-pack).
versionstringYesThe pack version, should follow SemVer (e.g., 1.0.0).
display_namestringYesThe human-readable name shown in the Worka UI.
descriptionstringYesA short description of the pack's purpose.
authorstringNoThe name and/or email of the pack author.
licensestringNoThe license for the pack (e.g., MIT, Apache-2.0).
viewsobjectNoOptional static views exposed by the pack (for default pages).
capabilitiesarrayNoAn array of strings declaring the permissions the pack requires. See details below.
dependenciesarrayNoAn array of strings (<tenant>/<name>) identifying other packs this pack depends on.

Notes on Backend Logic

Worka v2 packs expose a single MCP server inside the pack’s WASM. You do not declare Docker images or external servers in aip.json. The host discovers tools directly from the WASM module.