Skip to content

capability_provider

Class info

Classes

Name Children Inherits
CapabilitiesResourceProvider
llmling_agent.resource_providers.capability_provider
Provides tools based on agent capabilities.
    ResourceProvider
    llmling_agent.resource_providers.base
    Base class for resource providers.
    ToolInfo
    llmling_agent.tools.base
    Information about a registered tool.

      🛈 DocStrings

      CapabilitiesResourceProvider

      Bases: ResourceProvider

      Provides tools based on agent capabilities.

      Source code in src/llmling_agent/resource_providers/capability_provider.py
       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
      129
      130
      131
      132
      133
      134
      135
      136
      137
      138
      139
      140
      141
      142
      143
      144
      145
      146
      147
      148
      149
      150
      151
      152
      153
      154
      155
      156
      157
      158
      159
      160
      161
      162
      163
      164
      165
      166
      167
      168
      169
      170
      171
      172
      173
      174
      175
      class CapabilitiesResourceProvider(ResourceProvider):
          """Provides tools based on agent capabilities."""
      
          requires_async: bool = False
      
          def __init__(
              self,
              capabilities: Capabilities,
              runtime: RuntimeConfig | None = None,
              name: str = "capability_tools",
          ) -> None:
              super().__init__(name)
              self.capabilities = capabilities
              self.runtime = runtime
      
          async def get_tools(self) -> list[ToolInfo]:
              """Get all tools enabled by current capabilities."""
              tools: list[ToolInfo] = []
      
              # Resource tools (require runtime)
              if self.runtime:
                  if self.capabilities.can_load_resources:
                      tools.append(
                          ToolInfo.from_callable(
                              self.runtime.load_resource,
                              source="builtin",
                              requires_capability="can_load_resources",
                          )
                      )
                  if self.capabilities.can_list_resources:
                      tools.append(
                          ToolInfo.from_callable(
                              self.runtime.get_resources,
                              source="builtin",
                              requires_capability="can_list_resources",
                          )
                      )
                  if self.capabilities.can_register_tools:
                      tools.append(
                          ToolInfo.from_callable(
                              self.runtime.register_tool,
                              source="builtin",
                              requires_capability="can_register_tools",
                          )
                      )
                  if self.capabilities.can_register_code:
                      tools.append(
                          ToolInfo.from_callable(
                              self.runtime.register_code_tool,
                              source="builtin",
                              requires_capability="can_register_code",
                          )
                      )
                  if self.capabilities.can_install_packages:
                      tools.append(
                          ToolInfo.from_callable(
                              self.runtime.install_package,
                              source="builtin",
                              requires_capability="can_install_packages",
                          )
                      )
      
              # Agent/team tools
              from llmling_agent_tools import capability_tools
      
              if self.capabilities.can_create_workers:
                  tools.append(
                      ToolInfo.from_callable(
                          capability_tools.create_worker_agent,
                          source="builtin",
                          requires_capability="can_create_workers",
                      )
                  )
              if self.capabilities.can_create_delegates:
                  tools.append(
                      ToolInfo.from_callable(
                          capability_tools.spawn_delegate,
                          source="builtin",
                          requires_capability="can_create_delegates",
                      )
                  )
              if self.capabilities.can_list_agents:
                  tools.append(
                      ToolInfo.from_callable(
                          capability_tools.list_available_agents,
                          source="builtin",
                          requires_capability="can_list_agents",
                      )
                  )
              if self.capabilities.can_list_teams:
                  tools.append(
                      ToolInfo.from_callable(
                          capability_tools.list_available_teams,
                          source="builtin",
                          requires_capability="can_list_teams",
                      )
                  )
              if self.capabilities.can_delegate_tasks:
                  tools.append(
                      ToolInfo.from_callable(
                          capability_tools.delegate_to,
                          source="builtin",
                          requires_capability="can_delegate_tasks",
                      )
                  )
      
              # History and stats tools
              if self.capabilities.history_access != "none":
                  tools.append(
                      ToolInfo.from_callable(
                          capability_tools.search_history,
                          source="builtin",
                          requires_capability="history_access",
                      )
                  )
              if self.capabilities.stats_access != "none":
                  tools.append(
                      ToolInfo.from_callable(
                          capability_tools.show_statistics,
                          source="builtin",
                          requires_capability="stats_access",
                      )
                  )
      
              # Agent/team management
              if self.capabilities.can_add_agents:
                  tools.append(
                      ToolInfo.from_callable(
                          capability_tools.add_agent,
                          source="builtin",
                          requires_capability="can_add_agents",
                      )
                  )
              if self.capabilities.can_add_teams:
                  tools.append(
                      ToolInfo.from_callable(
                          capability_tools.add_team,
                          source="builtin",
                          requires_capability="can_add_teams",
                      )
                  )
      
              if self.capabilities.can_connect_nodes:
                  tools.append(
                      ToolInfo.from_callable(
                          capability_tools.connect_nodes,
                          source="builtin",
                          requires_capability="can_can_connect_nodes",
                      )
                  )
      
              if self.capabilities.can_ask_agents:
                  tools.append(
                      ToolInfo.from_callable(
                          capability_tools.ask_agent,
                          source="builtin",
                          requires_capability="can_ask_agents",
                      )
                  )
      
              return tools
      

      get_tools async

      get_tools() -> list[ToolInfo]
      

      Get all tools enabled by current capabilities.

      Source code in src/llmling_agent/resource_providers/capability_provider.py
       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
      129
      130
      131
      132
      133
      134
      135
      136
      137
      138
      139
      140
      141
      142
      143
      144
      145
      146
      147
      148
      149
      150
      151
      152
      153
      154
      155
      156
      157
      158
      159
      160
      161
      162
      163
      164
      165
      166
      167
      168
      169
      170
      171
      172
      173
      174
      175
      async def get_tools(self) -> list[ToolInfo]:
          """Get all tools enabled by current capabilities."""
          tools: list[ToolInfo] = []
      
          # Resource tools (require runtime)
          if self.runtime:
              if self.capabilities.can_load_resources:
                  tools.append(
                      ToolInfo.from_callable(
                          self.runtime.load_resource,
                          source="builtin",
                          requires_capability="can_load_resources",
                      )
                  )
              if self.capabilities.can_list_resources:
                  tools.append(
                      ToolInfo.from_callable(
                          self.runtime.get_resources,
                          source="builtin",
                          requires_capability="can_list_resources",
                      )
                  )
              if self.capabilities.can_register_tools:
                  tools.append(
                      ToolInfo.from_callable(
                          self.runtime.register_tool,
                          source="builtin",
                          requires_capability="can_register_tools",
                      )
                  )
              if self.capabilities.can_register_code:
                  tools.append(
                      ToolInfo.from_callable(
                          self.runtime.register_code_tool,
                          source="builtin",
                          requires_capability="can_register_code",
                      )
                  )
              if self.capabilities.can_install_packages:
                  tools.append(
                      ToolInfo.from_callable(
                          self.runtime.install_package,
                          source="builtin",
                          requires_capability="can_install_packages",
                      )
                  )
      
          # Agent/team tools
          from llmling_agent_tools import capability_tools
      
          if self.capabilities.can_create_workers:
              tools.append(
                  ToolInfo.from_callable(
                      capability_tools.create_worker_agent,
                      source="builtin",
                      requires_capability="can_create_workers",
                  )
              )
          if self.capabilities.can_create_delegates:
              tools.append(
                  ToolInfo.from_callable(
                      capability_tools.spawn_delegate,
                      source="builtin",
                      requires_capability="can_create_delegates",
                  )
              )
          if self.capabilities.can_list_agents:
              tools.append(
                  ToolInfo.from_callable(
                      capability_tools.list_available_agents,
                      source="builtin",
                      requires_capability="can_list_agents",
                  )
              )
          if self.capabilities.can_list_teams:
              tools.append(
                  ToolInfo.from_callable(
                      capability_tools.list_available_teams,
                      source="builtin",
                      requires_capability="can_list_teams",
                  )
              )
          if self.capabilities.can_delegate_tasks:
              tools.append(
                  ToolInfo.from_callable(
                      capability_tools.delegate_to,
                      source="builtin",
                      requires_capability="can_delegate_tasks",
                  )
              )
      
          # History and stats tools
          if self.capabilities.history_access != "none":
              tools.append(
                  ToolInfo.from_callable(
                      capability_tools.search_history,
                      source="builtin",
                      requires_capability="history_access",
                  )
              )
          if self.capabilities.stats_access != "none":
              tools.append(
                  ToolInfo.from_callable(
                      capability_tools.show_statistics,
                      source="builtin",
                      requires_capability="stats_access",
                  )
              )
      
          # Agent/team management
          if self.capabilities.can_add_agents:
              tools.append(
                  ToolInfo.from_callable(
                      capability_tools.add_agent,
                      source="builtin",
                      requires_capability="can_add_agents",
                  )
              )
          if self.capabilities.can_add_teams:
              tools.append(
                  ToolInfo.from_callable(
                      capability_tools.add_team,
                      source="builtin",
                      requires_capability="can_add_teams",
                  )
              )
      
          if self.capabilities.can_connect_nodes:
              tools.append(
                  ToolInfo.from_callable(
                      capability_tools.connect_nodes,
                      source="builtin",
                      requires_capability="can_can_connect_nodes",
                  )
              )
      
          if self.capabilities.can_ask_agents:
              tools.append(
                  ToolInfo.from_callable(
                      capability_tools.ask_agent,
                      source="builtin",
                      requires_capability="can_ask_agents",
                  )
              )
      
          return tools