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
123
124
125
126
127
128
    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."""

    can_read_files: bool = False
    """Whether the agent can read local and remote files."""

    can_list_directories: bool = False
    """Whether the agent can list directories and their contents."""

    # 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_directories class-attribute instance-attribute 

    can_list_directories: bool = False

    Whether the agent can list directories and their contents.

    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_read_files class-attribute instance-attribute 

    can_read_files: bool = False

    Whether the agent can read local and remote files.

    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 
     92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
    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 
    114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
    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)