Skip to content

capabilities

Class info

Classes

Name Children Inherits
Capabilities
llmling_agent.config.capabilities
Defines what operations an agent is allowed to perform.

    🛈 DocStrings

    Agent capabilities definition.

    Capabilities

    Bases: EventedModel

    Defines what operations an agent is allowed to perform.

    Source code in src/llmling_agent/config/capabilities.py 
     14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
    class Capabilities(EventedModel):
    """Defines what operations an agent is allowed to perform."""

    # Agent / Team discovery and delegation
    can_list_agents: bool = False
    """Whether the agent can discover other available agents."""

    can_delegate_tasks: bool = False
    """Whether the agent can delegate tasks to other agents."""

    can_observe_agents: bool = False
    """Whether the agent can monitor other agents' activities."""

    can_list_teams: bool = False
    """Whether the agent can discover available teams."""

    # History and statistics access
    history_access: AccessLevel = "none"
    """Level of access to conversation history."""

    stats_access: AccessLevel = "none"
    """Level of access to usage statistics."""

    # Resource capabilities
    can_load_resources: bool = False
    """Whether the agent can load and access resource content."""

    can_list_resources: bool = False
    """Whether the agent can discover available resources."""

    # Tool management
    can_register_tools: bool = False
    """Whether the agent can register importable functions as tools."""

    can_register_code: bool = False
    """Whether the agent can create new tools from provided code."""

    can_install_packages: bool = False
    """Whether the agent can install Python packages for tools."""

    can_chain_tools: bool = False
    """Whether the agent can chain multiple tool calls into one."""

    # Execution

    can_execute_code: bool = False
    """Whether the agent can execute Python code (WARNING: No sandbox)."""

    can_execute_commands: bool = False
    """Whether the agent can execute CLI commands (use at your own risk)."""

    # Agent creation
    can_create_workers: bool = False
    """Whether the agent can create worker agents (as tools)."""

    can_create_delegates: bool = False
    """Whether the agent can spawn temporary delegate agents."""

    can_add_agents: bool = False
    """Whether the agent can add aother agents to the pool."""

    can_ask_agents: bool = False
    """Whether the agent can ask other agents of the pool."""

    can_add_teams: bool = False
    """Whether the agent can add teams to the pool."""

    can_connect_nodes: bool = False
    """Whether the agent can add teams to the pool."""

    model_config = ConfigDict(frozen=True, use_attribute_docstrings=True, extra="forbid")

    def __contains__(self, required: Capabilities) -> bool:
        """Check if these capabilities contain all required capabilities.

        Example:
            required in agent.capabilities  # Can agent fulfill requirements?
        """
        # Check all boolean capabilities
        for field in self.__fields__:
            if isinstance(getattr(required, field), bool):  # noqa: SIM102
                if getattr(required, field) and not getattr(self, field):
                    return False

        # Check access levels (none < own < all)
        access_order = {"none": 0, "own": 1, "all": 2}
        for field in ("history_access", "stats_access"):
            required_level = access_order[getattr(required, field)]
            self_level = access_order[getattr(self, field)]
            if required_level > self_level:
                return False

        return True

    def has_capability(self, capability: str) -> bool:
        """Check if a specific capability is enabled.

        Args:
            capability: Name of capability to check.
                      Can be a boolean capability (e.g., "can_delegate_tasks")
                      or an access level (e.g., "history_access")
        """
        match capability:
            case str() if hasattr(self, capability):
                value = getattr(self, capability)
                return bool(value) if isinstance(value, bool) else value != "none"
            case _:
                msg = f"Unknown capability: {capability}"
                raise ValueError(msg)

    can_add_agents class-attribute instance-attribute 

    can_add_agents: bool = False

    Whether the agent can add aother agents to the pool.

    can_add_teams class-attribute instance-attribute 

    can_add_teams: bool = False

    Whether the agent can add teams to the pool.

    can_ask_agents class-attribute instance-attribute 

    can_ask_agents: bool = False

    Whether the agent can ask other agents of the pool.

    can_chain_tools class-attribute instance-attribute 

    can_chain_tools: bool = False

    Whether the agent can chain multiple tool calls into one.

    can_connect_nodes class-attribute instance-attribute 

    can_connect_nodes: bool = False

    Whether the agent can add teams to the pool.

    can_create_delegates class-attribute instance-attribute 

    can_create_delegates: bool = False

    Whether the agent can spawn temporary delegate agents.

    can_create_workers class-attribute instance-attribute 

    can_create_workers: bool = False

    Whether the agent can create worker agents (as tools).

    can_delegate_tasks class-attribute instance-attribute 

    can_delegate_tasks: bool = False

    Whether the agent can delegate tasks to other agents.

    can_execute_code class-attribute instance-attribute 

    can_execute_code: bool = False

    Whether the agent can execute Python code (WARNING: No sandbox).

    can_execute_commands class-attribute instance-attribute 

    can_execute_commands: bool = False

    Whether the agent can execute CLI commands (use at your own risk).

    can_install_packages class-attribute instance-attribute 

    can_install_packages: bool = False

    Whether the agent can install Python packages for tools.

    can_list_agents class-attribute instance-attribute 

    can_list_agents: bool = False

    Whether the agent can discover other available agents.

    can_list_resources class-attribute instance-attribute 

    can_list_resources: bool = False

    Whether the agent can discover available resources.

    can_list_teams class-attribute instance-attribute 

    can_list_teams: bool = False

    Whether the agent can discover available teams.

    can_load_resources class-attribute instance-attribute 

    can_load_resources: bool = False

    Whether the agent can load and access resource content.

    can_observe_agents class-attribute instance-attribute 

    can_observe_agents: bool = False

    Whether the agent can monitor other agents' activities.

    can_register_code class-attribute instance-attribute 

    can_register_code: bool = False

    Whether the agent can create new tools from provided code.

    can_register_tools class-attribute instance-attribute 

    can_register_tools: bool = False

    Whether the agent can register importable functions as tools.

    history_access class-attribute instance-attribute 

    history_access: AccessLevel = 'none'

    Level of access to conversation history.

    stats_access class-attribute instance-attribute 

    stats_access: AccessLevel = 'none'

    Level of access to usage statistics.

    __contains__ 

    __contains__(required: Capabilities) -> bool

    Check if these capabilities contain all required capabilities.

    Example

    required in agent.capabilities # Can agent fulfill requirements?

    Source code in src/llmling_agent/config/capabilities.py 
     86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
    def __contains__(self, required: Capabilities) -> bool:
    """Check if these capabilities contain all required capabilities.

    Example:
        required in agent.capabilities  # Can agent fulfill requirements?
    """
    # Check all boolean capabilities
    for field in self.__fields__:
        if isinstance(getattr(required, field), bool):  # noqa: SIM102
            if getattr(required, field) and not getattr(self, field):
                return False

    # Check access levels (none < own < all)
    access_order = {"none": 0, "own": 1, "all": 2}
    for field in ("history_access", "stats_access"):
        required_level = access_order[getattr(required, field)]
        self_level = access_order[getattr(self, field)]
        if required_level > self_level:
            return False

    return True

    has_capability 

    has_capability(capability: str) -> bool

    Check if a specific capability is enabled.

    Parameters:

    Name Type Description Default
    capability str

    Name of capability to check. Can be a boolean capability (e.g., "can_delegate_tasks") or an access level (e.g., "history_access")

    		 required
    Source code in src/llmling_agent/config/capabilities.py 
    108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
    def has_capability(self, capability: str) -> bool:
    """Check if a specific capability is enabled.

    Args:
        capability: Name of capability to check.
                  Can be a boolean capability (e.g., "can_delegate_tasks")
                  or an access level (e.g., "history_access")
    """
    match capability:
        case str() if hasattr(self, capability):
            value = getattr(self, capability)
            return bool(value) if isinstance(value, bool) else value != "none"
        case _:
            msg = f"Unknown capability: {capability}"
            raise ValueError(msg)