cachibot-plugin

name	cachibot-plugin
description	Create new CachiBot agent plugins (tools) following the project's capability-gated plugin architecture. Use this skill when adding a new tool, capability, or plugin to the CachiBot agent system — e.g., "add a translate tool", "create a web scraping plugin", "add a new capability".
metadata	{"author":"cachibot","version":"1.0"}

CachiBot Plugin Creation

Create new plugins that expose tools to the CachiBot agent. Plugins are capability-gated, meaning they're only loaded when a bot has the corresponding capability enabled.

Architecture Overview

• Base class: CachibotPlugin extends Tukuy's TransformerPlugin
• Context: PluginContext carries config, sandbox, bot_id, tool_configs, bot_models
• Skills: Each plugin exposes tools via Tukuy's @skill decorator
• Registry: PluginManager bridges plugin skills to Prompture's ToolRegistry

Step-by-Step Process

1. Create the Plugin File

Create cachibot/plugins/<your_plugin>.py:

"""
<Description> plugin — <tool_name> tool.

<What it does and what external services it uses.>
"""

import logging

from tukuy.manifest import PluginManifest, PluginRequirements
from tukuy.skill import ConfigParam, RiskLevel, Skill, skill

 cachibot.plugins.base  CachibotPlugin, PluginContext

logger = logging.getLogger(__name__)


 ():
    

     () -> :
        ().__init__(, ctx)
        ._skills_map = ._build_skills()


     () -> PluginManifest:
         PluginManifest(
            name=,
            display_name=,
            icon=,
            group=,  
            requires=PluginRequirements(network=),  
        )

     () -> [, Skill]:
        ctx = .ctx


          () -> :
            
            
            tool_cfg = ctx.tool_configs.get(, {})
            effective_arg2 = arg2  tool_cfg.get(, )

            
            model = 
             ctx.bot_models:
                model = ctx.bot_models.get(, )  

            :
                
                result = 
                 result
             Exception  exc:
                logger.error(, exc, exc_info=)
                 

         {: your_tool.__skill__}


     () -> [, Skill]:
         ._skills_map