Documentation
¶
Overview ¶
Package delegate implements the thane_delegate meta-tool for split-model execution. A calling model delegates subtasks to cheaper/local models that run with minimal context and a filtered tool set.
Index ¶
- Constants
- Variables
- func ExtractToolsCalled(messages []llm.Message) map[string]int
- func ToolDefinition() map[string]any
- func ToolHandler(exec *Executor) func(ctx context.Context, args map[string]any) (string, error)
- type Executor
- func (e *Executor) Execute(ctx context.Context, task, profileName, guidance string, tags []string) (*Result, error)
- func (e *Executor) ProfileNames() []string
- func (e *Executor) SetAlwaysActiveTags(tags []string)
- func (e *Executor) SetArchiver(a *memory.ArchiveStore)
- func (e *Executor) SetForgeContext(ctx string)
- func (e *Executor) SetTempFileStore(tfs interface{ ... })
- func (e *Executor) SetTimezone(tz string)
- func (e *Executor) SetUsageRecorder(store *usage.Store, pricing map[string]config.PricingEntry)
- type Profile
- type Result
- type ToolCallOutcome
Constants ¶
const ( ExhaustMaxIterations = "max_iterations" ExhaustTokenBudget = "token_budget" ExhaustWallClock = "wall_clock" ExhaustNoOutput = "no_output" ExhaustIllegalTool = "illegal_tool" )
Exhaustion reason constants.
Variables ¶
var ToolDescription = prompts.DelegateToolDescription
ToolDescription is the LLM-facing description for the thane_delegate tool.
Functions ¶
func ExtractToolsCalled ¶ added in v0.5.2
ExtractToolsCalled scans a message history and returns a map of tool names to invocation counts.
func ToolDefinition ¶
ToolDefinition returns the JSON schema parameters for the thane_delegate tool.
func ToolHandler ¶
ToolHandler returns a tool handler function bound to the given executor. Errors from the delegate are returned as tool result strings (not Go errors) so the calling model can decide what to do.
Types ¶
type Executor ¶
type Executor struct {
// contains filtered or unexported fields
}
Executor runs delegated tasks using a lightweight iteration loop.
func NewExecutor ¶
func NewExecutor(logger *slog.Logger, llmClient llm.Client, rtr *router.Router, parentReg *tools.Registry, defaultModel string) *Executor
NewExecutor creates a delegate executor.
func (*Executor) Execute ¶
func (e *Executor) Execute(ctx context.Context, task, profileName, guidance string, tags []string) (*Result, error)
Execute runs a delegated task with the given profile and guidance. When tags is non-empty, the delegate's tool registry is scoped to only tools belonging to the given capability tags (plus any always-active tags). When tags is nil, the profile's AllowedTools controls tool selection (existing behavior).
func (*Executor) ProfileNames ¶
ProfileNames returns the names of all registered profiles.
func (*Executor) SetAlwaysActiveTags ¶ added in v0.8.0
SetAlwaysActiveTags configures the capability tags that are automatically included in every tag-scoped delegation, regardless of which tags the caller requests. This mirrors the agent loop's always_active tag behavior.
func (*Executor) SetArchiver ¶ added in v0.8.0
func (e *Executor) SetArchiver(a *memory.ArchiveStore)
SetArchiver configures the archive store for session lifecycle tracking. When set, each Executor.Execute call creates a first-class archive session with parent linkage, and archives its messages and tool calls for inspection in the web dashboard.
func (*Executor) SetForgeContext ¶ added in v0.8.0
SetForgeContext configures the forge account context block that is appended to delegate system prompts. This gives delegates immediate knowledge of configured forge accounts so they don't waste iterations guessing account names.
func (*Executor) SetTempFileStore ¶ added in v0.7.1
SetTempFileStore configures temp file label expansion for delegate task descriptions. When set, occurrences of "temp:LABEL" in the task and guidance strings are replaced with actual file paths before the delegate LLM sees the message.
func (*Executor) SetTimezone ¶
SetTimezone configures the IANA timezone for Current Conditions in the delegate system prompt.
func (*Executor) SetUsageRecorder ¶ added in v0.7.1
SetUsageRecorder configures persistent token usage recording for delegate executions. When set, every delegate completion is persisted for cost attribution.
type Profile ¶
type Profile struct {
// Name is the profile identifier (e.g., "general", "ha").
Name string
// Description is a human-readable summary for logging.
Description string
// AllowedTools lists the tool names available to the delegate.
// An empty list means all tools (minus thane_delegate).
AllowedTools []string
// SystemPrompt is the profile-specific system prompt for the delegate.
SystemPrompt string
// RouterHints are passed to the router for model selection.
RouterHints map[string]string
// MaxIter is the maximum number of tool-calling iterations.
MaxIter int
// MaxTokens is the maximum cumulative output tokens before budget exhaustion.
MaxTokens int
// MaxDuration is the maximum wall clock time for the delegation loop.
MaxDuration time.Duration
// ToolTimeout is the maximum time a single tool call may run before
// being cancelled. Zero means defaultToolTimeout.
ToolTimeout time.Duration
}
Profile defines the configuration for a delegation context.
type Result ¶
type Result struct {
Content string `json:"content"`
Model string `json:"model"`
Iterations int `json:"iterations"`
InputTokens int `json:"input_tokens"`
OutputTokens int `json:"output_tokens"`
Exhausted bool `json:"exhausted"`
ExhaustReason string `json:"exhaust_reason,omitempty"`
ToolCalls []ToolCallOutcome `json:"tool_calls,omitempty"`
Duration time.Duration `json:"duration"`
}
Result is the outcome of a delegated task execution.
type ToolCallOutcome ¶ added in v0.7.0
ToolCallOutcome records the name and success/failure of a single tool invocation during delegate execution.
Source Files