Manifest Reference

Plugin Manifest Reference

Full reference at: docs/plugins/manifest-reference.md

Required Fields

Field	Type	Description
name	string	Unique kebab-case identifier
version	string	Semantic version (e.g. 1.0.0)
description	string	Short description
kind	"esm" | "mcp" | "wasm"	Plugin runtime kind
entryPoint	string	Path to module, URL, or WASM binary
runtime	"deno" | "wasm"	Execution target
capabilities	string[]	Declared permissions and extension points

Optional Fields

Field	Type	Description
author	string	Author name
homepage	string	Homepage URL
license	string	SPDX identifier
repository	string	Source repository URL
hash	string	SHA-256 for integrity verification
tools	ToolDeclaration[]	Tool definitions
cliCommands	CliCommandDeclaration[]	CLI subcommand specs
ui	UiContribution	UI panels, widgets, settings
config	ConfigContribution	Config schema + defaults
events	string[]	Event type subscriptions

Plugin Kinds

ESM (kind: "esm")

TypeScript modules loaded via import(). Entry point exports tools, hooks, providers, CLI commands.

MCP (kind: "mcp")

Model Context Protocol servers. Creates a synthetic tool mcp_<pluginName> wrapping JSON-RPC 2.0.

WASM (kind: "wasm")

WebAssembly modules. Expects plugin_init() and plugin_get_capabilities() exports. Currently under active development.

Capabilities

Extension Points

tools, cli:commands, ui:panel, ui:widget, config:schema, config:provider, memory:store, memory:embedder, events:listener, middleware:pre, middleware:post

Permissions

fs:read, fs:write, fs:list, fs:edit, fs:delete, fs:search, shell:run, network:fetch, net:outbound, net:inbound, db:read, db:write

PluginContext API

interface PluginContext {
  pluginId: string;
  pluginDir: string;
  state: PluginStateStore;    // get/set/delete/list
  config: PluginConfigStore;  // get/set/getAll
  logger: PluginLogger;       // info/warn/error/debug
  host: HostApi;              // registerTool/unregisterTool
}

Events

session:start, session:end, tool:pre-execute, tool:post-execute, llm:pre-call, llm:post-call, agent:turn-start, agent:turn-end, config:change, daemon:status

See Also

• Developing Plugins — Full development guide
• Plugin System — System overview