Documentation
¶
Overview ¶
Package workflow executes resolved Callee agent trees.
Index ¶
- func TreeRequiresInteraction(root *registry.ResolvedNode, overrides PolicyOverrides) (bool, error)
- func ValidateParallelPreflight(root *registry.ResolvedNode, values map[string]string, ...) error
- func ValidatePolicyOverrides(overrides PolicyOverrides) error
- func ValidateRuntimeParams(root *registry.ResolvedNode, values map[string]string) error
- type Interactor
- type PauseController
- type PolicyOverrides
- type RolePolicy
- type RunMetrics
- type Runner
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func TreeRequiresInteraction ¶ added in v0.20.0
func TreeRequiresInteraction(root *registry.ResolvedNode, overrides PolicyOverrides) (bool, error)
TreeRequiresInteraction reports whether effective tree policy needs an interactor.
func ValidateParallelPreflight ¶ added in v0.21.0
func ValidateParallelPreflight(root *registry.ResolvedNode, values map[string]string, overrides PolicyOverrides) error
ValidateParallelPreflight rejects interactive policy and missing parameters that would otherwise require terminal input from a concurrent subtree.
func ValidatePolicyOverrides ¶ added in v0.20.0
func ValidatePolicyOverrides(overrides PolicyOverrides) error
ValidatePolicyOverrides rejects unsupported programmatic permission modes.
func ValidateRuntimeParams ¶ added in v0.20.0
func ValidateRuntimeParams(root *registry.ResolvedNode, values map[string]string) error
ValidateRuntimeParams validates supplied qualified parameter values.
Types ¶
type Interactor ¶
type Interactor interface {
Prompt(ctx context.Context, label string) (string, error)
Display(text string) error
}
Interactor owns all controlling-TTY input and display for a workflow run.
type PauseController ¶
type PauseController struct {
// contains filtered or unexported fields
}
PauseController pauses and resumes the active provider-turn budget while Callee waits for an operator permission decision.
func NewPauseController ¶
func NewPauseController() *PauseController
NewPauseController creates a controller for one serial workflow run.
type PolicyOverrides ¶ added in v0.20.0
type PolicyOverrides struct {
Interactive *bool
Permissions *agent.PermissionMode
}
PolicyOverrides contains optional whole-run Role policy overrides.
type RolePolicy ¶ added in v0.20.0
type RolePolicy struct {
Interactive bool
Permissions agent.PermissionMode
}
RolePolicy is the effective protocol and ACP permission policy for one Role.
func ResolveNodeRolePolicy ¶ added in v0.21.0
func ResolveNodeRolePolicy(node *registry.ResolvedNode, overrides PolicyOverrides) (RolePolicy, error)
ResolveNodeRolePolicy resolves policy from a node's registry-projected defaults and then applies explicit whole-run overrides.
func ResolveRolePolicy ¶ added in v0.20.0
func ResolveRolePolicy(role agent.Resource, overrides PolicyOverrides) (RolePolicy, error)
ResolveRolePolicy resolves independent Role protocol and permission values.
type RunMetrics ¶ added in v0.16.0
type RunMetrics struct {
// contains filtered or unexported fields
}
RunMetrics accumulates provider usage for one resolved agent run.
func (*RunMetrics) Usage ¶ added in v0.16.0
func (m *RunMetrics) Usage() runtime.UsageMetrics
Usage returns a snapshot of the run's provider-reported token usage.
type Runner ¶
type Runner struct {
Root *registry.ResolvedNode
Factory runtime.ProcessFactory
Interactor Interactor
Params map[string]string
Pauses *PauseController
Metrics *RunMetrics
InteractiveOverride *bool
PermissionOverride *agent.PermissionMode
EvaluationEvaluator evaluationapi.Evaluator
}
Runner executes one resolved root using shared ephemeral state.