Entropic 2.14.3
Local-first agentic inference engine
Loading...
Searching...
No Matches
entropic::DelegateTool Class Reference

Tool for delegating tasks to child inference loops. More...

Inheritance diagram for entropic::DelegateTool:
Collaboration diagram for entropic::DelegateTool:

Public Member Functions

 DelegateTool (ToolDefinition def, const std::vector< std::string > &tier_names, std::vector< std::string > require_context_tiers={})
 Construct and patch input schema with tier names.
 
ServerResponse execute (const std::string &args_json) override
 Execute delegation.
 
- Public Member Functions inherited from entropic::ToolBase
 ToolBase (ToolDefinition def)
 Construct with a pre-built definition.
 
const std::string & name () const
 Get the tool name.
 
const ToolDefinition & definition () const
 Get the full tool definition.
 
virtual std::string anchor_key (const std::string &args_json) const
 Generate anchor key for this tool result.
 
virtual MCPAccessLevel required_access_level () const
 Minimum access level required to execute this tool.
 

Additional Inherited Members

- Protected Attributes inherited from entropic::ToolBase
ToolDefinition definition_
 Tool definition.
 

Detailed Description

Tool for delegating tasks to child inference loops.

@dg_internal

Version
1.8.5

Definition at line 265 of file entropic_server.cpp.

Constructor & Destructor Documentation

◆ DelegateTool()

entropic::DelegateTool::DelegateTool ( ToolDefinition  def,
const std::vector< std::string > &  tier_names,
std::vector< std::string >  require_context_tiers = {} 
)

Construct and patch input schema with tier names.

Construct and patch enum in input schema.

Parameters
defTool definition loaded from entropic/delegate.json.
tier_namesAvailable tier names for enum patching. @dg_internal
Version
1.8.5

The target enum is patched at construction from the tier names the server was given — and those exclude source tiers, so a tier cannot delegate to itself.

Parameters
defTool definition.
tier_namesTier names for target enum.
require_context_tiersTiers that refuse a contextless delegation (gh#162). @req REQ-MCP-024 @req REQ-MCP-013 @req REQ-DELEG-006
Version
2.13.0

Definition at line 310 of file entropic_server.cpp.

Member Function Documentation

◆ execute()

ServerResponse entropic::DelegateTool::execute ( const std::string &  args_json)
overridevirtual

Execute delegation.

Parse delegation args and emit directives.

Parameters
args_jsonJSON with "target", "task", "max_turns", "context".
Returns
ServerResponse with delegate + stop directives, or a typed error with NO directives when the target tier declares requires_context and none was supplied (gh#162). @dg_internal
Version
2.13.0
Parameters
args_jsonJSON with "target", "task", optional "max_turns" (defaulting to -1 for "engine decides") and optional "context" file references (gh#162).
Returns
A ServerResponse whose result echoes the delegation and whose directives are delegate + stop_processing — the pair that hands the turn to the child loop; or, when the target tier declares requires_context and none was supplied, the declared requires_context error with NO directives (gh#162). @req REQ-MCP-024 @req REQ-DELEG-006
Version
2.14.0

Implements entropic::ToolBase.

Definition at line 372 of file entropic_server.cpp.


The documentation for this class was generated from the following file: