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.
    Tool
    llmling_agent.tools.base
    Information about a registered tool.

      🛈 DocStrings

      Resource provider for agent capabilities.

      CapabilitiesResourceProvider

      Bases: ResourceProvider

      Provides tools based on agent capabilities.

      Source code in src/llmling_agent/resource_providers/capability_provider.py
       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
      176
      177
      178
      179
      180
      181
      182
      183
      184
      185
      186
      187
      188
      189
      190
      191
      192
      193
      194
      195
      196
      197
      198
      199
      200
      201
      202
      203
      204
      205
      206
      207
      208
      209
      210
      211
      212
      213
      214
      215
      216
      217
      218
      219
      220
      221
      222
      223
      224
      225
      226
      227
      228
      229
      230
      231
      232
      233
      234
      235
      236
      237
      238
      239
      240
      241
      242
      243
      244
      245
      246
      247
      248
      249
      250
      251
      252
      253
      254
      255
      256
      257
      258
      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",
          ):
              super().__init__(name)
              self.capabilities = capabilities
              self.runtime = runtime
      
          async def get_tools(self) -> list[Tool]:  # noqa: PLR0915
              """Get all tools enabled by current capabilities."""
              tools: list[Tool] = []
      
              # Resource tools (require runtime)
              if self.runtime:
                  if self.capabilities.can_load_resources:
                      tool = Tool.from_callable(
                          self.runtime.load_resource,
                          source="builtin",
                          requires_capability="can_load_resources",
                          category="read",
                      )
                      tools.append(tool)
                  if self.capabilities.can_list_resources:
                      tool = Tool.from_callable(
                          self.runtime.get_resources,
                          source="builtin",
                          requires_capability="can_list_resources",
                          category="search",
                      )
                      tools.append(tool)
                  if self.capabilities.can_register_tools:
                      tool = Tool.from_callable(
                          self.runtime.register_tool,
                          source="builtin",
                          requires_capability="can_register_tools",
                          category="other",
                      )
                      tools.append(tool)
                  if self.capabilities.can_register_code:
                      tool = Tool.from_callable(
                          self.runtime.register_code_tool,
                          source="builtin",
                          requires_capability="can_register_code",
                          category="other",
                      )
                      tools.append(tool)
                  if self.capabilities.can_install_packages:
                      tool = Tool.from_callable(
                          self.runtime.install_package,
                          source="builtin",
                          requires_capability="can_install_packages",
                          category="execute",
                      )
                      tools.append(tool)
      
              # Agent/team tools
              from llmling_agent_tools import capability_tools
      
              if self.capabilities.can_create_workers:
                  tool = Tool.from_callable(
                      capability_tools.create_worker_agent,
                      source="builtin",
                      requires_capability="can_create_workers",
                      category="other",
                  )
                  tools.append(tool)
              if self.capabilities.can_create_delegates:
                  tool = Tool.from_callable(
                      capability_tools.spawn_delegate,
                      source="builtin",
                      requires_capability="can_create_delegates",
                      category="other",
                  )
                  tools.append(tool)
              if self.capabilities.can_list_agents:
                  tool = Tool.from_callable(
                      capability_tools.list_available_agents,
                      source="builtin",
                      requires_capability="can_list_agents",
                      category="search",
                  )
                  tools.append(tool)
              if self.capabilities.can_list_teams:
                  tool = Tool.from_callable(
                      capability_tools.list_available_teams,
                      source="builtin",
                      requires_capability="can_list_teams",
                      category="search",
                  )
                  tools.append(tool)
              if self.capabilities.can_delegate_tasks:
                  tool = Tool.from_callable(
                      capability_tools.delegate_to,
                      source="builtin",
                      requires_capability="can_delegate_tasks",
                      category="other",
                  )
                  tools.append(tool)
      
              # History and stats tools
              if self.capabilities.history_access != "none":
                  tool = Tool.from_callable(
                      capability_tools.search_history,
                      source="builtin",
                      requires_capability="history_access",
                      category="search",
                  )
                  tools.append(tool)
                  tool = Tool.from_callable(
                      capability_tools.show_statistics,
                      source="builtin",
                      requires_capability="history_access",
                      category="read",
                  )
                  tools.append(tool)
      
              # Agent/team management
              if self.capabilities.can_add_agents:
                  tool = Tool.from_callable(
                      capability_tools.add_agent,
                      source="builtin",
                      requires_capability="can_add_agents",
                      category="other",
                  )
                  tools.append(tool)
              if self.capabilities.can_add_teams:
                  tool = Tool.from_callable(
                      capability_tools.add_team,
                      source="builtin",
                      requires_capability="can_add_teams",
                      category="other",
                  )
                  tools.append(tool)
      
              if self.capabilities.can_connect_nodes:
                  tool = Tool.from_callable(
                      capability_tools.connect_nodes,
                      source="builtin",
                      requires_capability="can_can_connect_nodes",
                      category="other",
                  )
                  tools.append(tool)
      
              if self.capabilities.can_ask_agents:
                  tool = Tool.from_callable(
                      capability_tools.ask_agent,
                      source="builtin",
                      requires_capability="can_ask_agents",
                      category="other",
                  )
                  tools.append(tool)
              if self.capabilities.can_read_files:
                  tool = Tool.from_callable(
                      capability_tools.read_file,
                      source="builtin",
                      requires_capability="can_read_files",
                      category="read",
                  )
                  tools.append(tool)
              if self.capabilities.can_list_directories:
                  tool = Tool.from_callable(
                      capability_tools.list_directory,
                      source="builtin",
                      requires_capability="can_list_directories",
                      category="search",
                  )
                  tools.append(tool)
      
              # Execution tools
              if self.capabilities.can_execute_code:
                  tool = Tool.from_callable(
                      capability_tools.execute_python,
                      source="builtin",
                      requires_capability="can_execute_code",
                      category="execute",
                  )
                  tools.append(tool)
              if self.capabilities.can_execute_commands:
                  tool = Tool.from_callable(
                      capability_tools.execute_command,
                      source="builtin",
                      requires_capability="can_execute_commands",
                      category="execute",
                  )
                  tools.append(tool)
      
              # Process management tools
              if self.capabilities.can_manage_processes:
                  process_tools: list[Callable] = [
                      capability_tools.start_process,
                      capability_tools.get_process_output,
                      capability_tools.wait_for_process,
                      capability_tools.kill_process,
                      capability_tools.release_process,
                      capability_tools.list_processes,
                  ]
                  for tool_func in process_tools:
                      tool = Tool.from_callable(
                          tool_func,
                          source="builtin",
                          requires_capability="can_manage_processes",
                          category="execute",
                      )
                      tools.append(tool)
      
              # User interaction tools
              if self.capabilities.can_ask_user:
                  tool = Tool.from_callable(
                      capability_tools.ask_user,
                      source="builtin",
                      requires_capability="can_ask_user",
                      category="other",
                  )
                  tools.append(tool)
      
              # MCP server management tools
              if self.capabilities.can_add_mcp_servers:
                  tool = Tool.from_callable(
                      capability_tools.add_local_mcp_server,
                      source="builtin",
                      requires_capability="can_add_mcp_servers",
                      category="other",
                  )
                  tools.append(tool)
                  tool = Tool.from_callable(
                      capability_tools.add_remote_mcp_server,
                      source="builtin",
                      requires_capability="can_add_mcp_servers",
                      category="other",
                  )
                  tools.append(tool)
      
              return tools
      

      get_tools async

      get_tools() -> list[Tool]
      

      Get all tools enabled by current capabilities.

      Source code in src/llmling_agent/resource_providers/capability_provider.py
       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
      176
      177
      178
      179
      180
      181
      182
      183
      184
      185
      186
      187
      188
      189
      190
      191
      192
      193
      194
      195
      196
      197
      198
      199
      200
      201
      202
      203
      204
      205
      206
      207
      208
      209
      210
      211
      212
      213
      214
      215
      216
      217
      218
      219
      220
      221
      222
      223
      224
      225
      226
      227
      228
      229
      230
      231
      232
      233
      234
      235
      236
      237
      238
      239
      240
      241
      242
      243
      244
      245
      246
      247
      248
      249
      250
      251
      252
      253
      254
      255
      256
      257
      258
      async def get_tools(self) -> list[Tool]:  # noqa: PLR0915
          """Get all tools enabled by current capabilities."""
          tools: list[Tool] = []
      
          # Resource tools (require runtime)
          if self.runtime:
              if self.capabilities.can_load_resources:
                  tool = Tool.from_callable(
                      self.runtime.load_resource,
                      source="builtin",
                      requires_capability="can_load_resources",
                      category="read",
                  )
                  tools.append(tool)
              if self.capabilities.can_list_resources:
                  tool = Tool.from_callable(
                      self.runtime.get_resources,
                      source="builtin",
                      requires_capability="can_list_resources",
                      category="search",
                  )
                  tools.append(tool)
              if self.capabilities.can_register_tools:
                  tool = Tool.from_callable(
                      self.runtime.register_tool,
                      source="builtin",
                      requires_capability="can_register_tools",
                      category="other",
                  )
                  tools.append(tool)
              if self.capabilities.can_register_code:
                  tool = Tool.from_callable(
                      self.runtime.register_code_tool,
                      source="builtin",
                      requires_capability="can_register_code",
                      category="other",
                  )
                  tools.append(tool)
              if self.capabilities.can_install_packages:
                  tool = Tool.from_callable(
                      self.runtime.install_package,
                      source="builtin",
                      requires_capability="can_install_packages",
                      category="execute",
                  )
                  tools.append(tool)
      
          # Agent/team tools
          from llmling_agent_tools import capability_tools
      
          if self.capabilities.can_create_workers:
              tool = Tool.from_callable(
                  capability_tools.create_worker_agent,
                  source="builtin",
                  requires_capability="can_create_workers",
                  category="other",
              )
              tools.append(tool)
          if self.capabilities.can_create_delegates:
              tool = Tool.from_callable(
                  capability_tools.spawn_delegate,
                  source="builtin",
                  requires_capability="can_create_delegates",
                  category="other",
              )
              tools.append(tool)
          if self.capabilities.can_list_agents:
              tool = Tool.from_callable(
                  capability_tools.list_available_agents,
                  source="builtin",
                  requires_capability="can_list_agents",
                  category="search",
              )
              tools.append(tool)
          if self.capabilities.can_list_teams:
              tool = Tool.from_callable(
                  capability_tools.list_available_teams,
                  source="builtin",
                  requires_capability="can_list_teams",
                  category="search",
              )
              tools.append(tool)
          if self.capabilities.can_delegate_tasks:
              tool = Tool.from_callable(
                  capability_tools.delegate_to,
                  source="builtin",
                  requires_capability="can_delegate_tasks",
                  category="other",
              )
              tools.append(tool)
      
          # History and stats tools
          if self.capabilities.history_access != "none":
              tool = Tool.from_callable(
                  capability_tools.search_history,
                  source="builtin",
                  requires_capability="history_access",
                  category="search",
              )
              tools.append(tool)
              tool = Tool.from_callable(
                  capability_tools.show_statistics,
                  source="builtin",
                  requires_capability="history_access",
                  category="read",
              )
              tools.append(tool)
      
          # Agent/team management
          if self.capabilities.can_add_agents:
              tool = Tool.from_callable(
                  capability_tools.add_agent,
                  source="builtin",
                  requires_capability="can_add_agents",
                  category="other",
              )
              tools.append(tool)
          if self.capabilities.can_add_teams:
              tool = Tool.from_callable(
                  capability_tools.add_team,
                  source="builtin",
                  requires_capability="can_add_teams",
                  category="other",
              )
              tools.append(tool)
      
          if self.capabilities.can_connect_nodes:
              tool = Tool.from_callable(
                  capability_tools.connect_nodes,
                  source="builtin",
                  requires_capability="can_can_connect_nodes",
                  category="other",
              )
              tools.append(tool)
      
          if self.capabilities.can_ask_agents:
              tool = Tool.from_callable(
                  capability_tools.ask_agent,
                  source="builtin",
                  requires_capability="can_ask_agents",
                  category="other",
              )
              tools.append(tool)
          if self.capabilities.can_read_files:
              tool = Tool.from_callable(
                  capability_tools.read_file,
                  source="builtin",
                  requires_capability="can_read_files",
                  category="read",
              )
              tools.append(tool)
          if self.capabilities.can_list_directories:
              tool = Tool.from_callable(
                  capability_tools.list_directory,
                  source="builtin",
                  requires_capability="can_list_directories",
                  category="search",
              )
              tools.append(tool)
      
          # Execution tools
          if self.capabilities.can_execute_code:
              tool = Tool.from_callable(
                  capability_tools.execute_python,
                  source="builtin",
                  requires_capability="can_execute_code",
                  category="execute",
              )
              tools.append(tool)
          if self.capabilities.can_execute_commands:
              tool = Tool.from_callable(
                  capability_tools.execute_command,
                  source="builtin",
                  requires_capability="can_execute_commands",
                  category="execute",
              )
              tools.append(tool)
      
          # Process management tools
          if self.capabilities.can_manage_processes:
              process_tools: list[Callable] = [
                  capability_tools.start_process,
                  capability_tools.get_process_output,
                  capability_tools.wait_for_process,
                  capability_tools.kill_process,
                  capability_tools.release_process,
                  capability_tools.list_processes,
              ]
              for tool_func in process_tools:
                  tool = Tool.from_callable(
                      tool_func,
                      source="builtin",
                      requires_capability="can_manage_processes",
                      category="execute",
                  )
                  tools.append(tool)
      
          # User interaction tools
          if self.capabilities.can_ask_user:
              tool = Tool.from_callable(
                  capability_tools.ask_user,
                  source="builtin",
                  requires_capability="can_ask_user",
                  category="other",
              )
              tools.append(tool)
      
          # MCP server management tools
          if self.capabilities.can_add_mcp_servers:
              tool = Tool.from_callable(
                  capability_tools.add_local_mcp_server,
                  source="builtin",
                  requires_capability="can_add_mcp_servers",
                  category="other",
              )
              tools.append(tool)
              tool = Tool.from_callable(
                  capability_tools.add_remote_mcp_server,
                  source="builtin",
                  requires_capability="can_add_mcp_servers",
                  category="other",
              )
              tools.append(tool)
      
          return tools