manifest_schema.json

{
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "required": [
        "bot_name",
        "accent_color",
        "title1",
        "title2",
        "author",
        "occupation",
        "typical_group",
        "github_repo",
        "integrations",
        "featured_actions",
        "intro_message",
        "preferred_model_default",
        "daily_budget_default",
        "default_inbox_default",
        "tags"
    ],
    "additionalProperties": false,
    "properties": {
        "bot_name": {
            "type": "string",
            "title": "Bot Name",
            "pattern": "^[a-z][a-z0-9_]*$",
            "description": "Unique bot identifier used internally and in API calls. Lowercase letters, digits, and underscores only, must start with a letter. Example: 'productman', 'owl_strategist'."
        },
        "accent_color": {
            "type": "string",
            "title": "Accent Color",
            "pattern": "^#[0-9a-fA-F]{6}$",
            "description": "Hex color code for the bot's UI theme in the marketplace and chat interface. Example: '#4A90E2'."
        },
        "title1": {
            "type": "string",
            "title": "Display Name",
            "description": "Bot's display name shown in the marketplace and UI. Example: 'Productman', 'Ad Monster'."
        },
        "title2": {
            "type": "string",
            "title": "Tagline",
            "description": "Short tagline describing what the bot does, shown below title1 in the marketplace. Example: 'Discovery Agent. Understand what to sell and to whom, validated by market logic.'."
        },
        "author": {
            "type": "string",
            "title": "Author",
            "description": "Name of the bot's author or organization."
        },
        "occupation": {
            "type": "string",
            "title": "Occupation",
            "description": "Bot's role or job title displayed in the marketplace. Example: 'Product Manager', 'Advertising Campaign Manager', 'Secretary Assistant'."
        },
        "typical_group": {
            "type": "string",
            "title": "Typical Group",
            "description": "Default group or category path where the bot appears when installed into a workspace. Use '/' for root. Example: 'Marketing', 'Product / Research', 'Admin Tools'."
        },
        "github_repo": {
            "type": "string",
            "title": "GitHub Repository",
            "description": "Git repository URL where the bot's source code lives. Example: 'https://github.com/smallcloudai/flexus-client-kit.git'."
        },
        "featured_actions": {
            "type": "array",
            "title": "Featured Actions",
            "items": {
                "type": "object",
                "required": ["feat_question", "feat_expert"],
                "additionalProperties": false,
                "properties": {
                    "feat_question": {
                        "type": "string",
                        "title": "Question",
                        "description": "Suggested action text shown as a quick-start button in the UI."
                    },
                    "feat_expert": {
                        "type": "string",
                        "title": "Expert",
                        "description": "Name of the expert that handles this action. Use 'default' for the main expert."
                    }
                }
            },
            "description": "Quick-start actions shown in the chat UI as clickable suggestions. Each action sends feat_question to the specified expert."
        },
        "intro_message": {
            "type": "string",
            "title": "Intro Message",
            "description": "First message the bot sends when a user opens a new chat. Should briefly introduce the bot and its capabilities."
        },
        "preferred_model_default": {
            "type": "string",
            "title": "Preferred Model",
            "description": "Default LLM model used for this bot's chat completions. Example: 'grok-4-1-fast-non-reasoning', 'grok-4-1-fast-reasoning'."
        },
        "daily_budget_default": {
            "type": "integer",
            "title": "Daily Budget",
            "minimum": 1,
            "description": "Default daily token budget for the bot in tokens. Admin can override in workspace settings. Example: 200000, 1000000."
        },
        "default_inbox_default": {
            "type": "integer",
            "title": "Default Inbox Size",
            "minimum": 1,
            "description": "Default maximum number of kanban inbox items the bot will accept. Controls backpressure on incoming tasks. Example: 20000, 100000."
        },
        "tags": {
            "type": "array",
            "title": "Tags",
            "items": { "type": "string" },
            "description": "Marketplace tags for discovery and filtering. Example: ['Marketing', 'Strategy', 'Hypothesis Validation']."
        },
        "integrations": {
            "type": "array",
            "title": "Tools and Integrations",
            "items": { "type": "string" },
            "description": "List of tools and integrations the bot uses. Accepts built-in integrations (flexus_policy_document, print_widget, gmail, google_calendar, jira, skills, mongo_store) and cloud tool names. Each provides tools and optionally OAuth. Example: ['flexus_policy_document', 'gmail', 'google_calendar']."
        },
        "shared_skills_allowlist": {
            "type": "string",
            "title": "Allow These Shared Skills",
            "default": "",
            "description": "Take skills in shared_skills/ that match any of the patterns in this comma-separated list, example: 'strategy-*,report-*'. Empty string means none, '*' means all."
        }
    }
}