Zos/Skills/@be/be/menu/PROVIDERS.md

Menu providers (drop-in menu customization)

Providers let you add/override menu entries without editing the core menu patch.

Default entries directory (on robot):

• /opt/jibo/Jibo/Skills/@be/menu-entries.d/

Legacy fallback (yea ik its the same stop talking):

• /opt/jibo/Jibo/Skills/@be/menu-providers.d/

Provider file types

JSON provider (*.json)

Supported shapes:

• An array of entries: [ { ... }, { ... } ]
• Or { "entries": [ ... ] }

Entry schema (same as menuEntry.json scan output):

• id (string, required)
• type (skill or submenu)
• title
• icon
• color
• description
• order (number)
• skillId (for type skill)
• submenuTitle (for type submenu)
• children (array of skill entries, for type submenu)
• childrenDir (for type submenu, optional):
  • Absolute path (starts with /) or relative to skillsRoot
  • If provided and children is missing/empty, the patch will scan this directory for child skills (subfolders containing menuEntry.json).

Example submenu that lists a directory:

[
	{
		"id": "fun_stuff",
		"type": "submenu",
		"title": "Fun Stuff",
		"icon": "resources/icons/fun-stuff.png",
		"order": 20,
		"childrenDir": "FunStuff"
	}
]

JS provider (*.js)

Exports one of:

• module.exports = function(ctx) { return [ ...entries... ]; }
• exports.getEntries = function(ctx) { return [ ...entries... ]; }
• exports.entries = [ ...entries... ]

ctx includes:

• skillsRoot
• providersDir
• log (function)

Conflict rules

• If a provider entry has the same id as a scanned entry, the provider entry wins.
• Sorting: by order then by title.