planning

package

Go to main page

Versions in this module

v0

v0.17.0

Sep 10, 2026

Changes in this version

type Condition

+ func (Condition) JSONSchemaAlias() any

type WorldState

+ func (WorldState) JSONSchemaAlias() any

v0.16.0

Sep 9, 2026

Changes in this version

type DispatcherConfig

+ Sensor Sensor

+ type SenseRequest struct

+ EffectID agent.EffectID

+ Input agent.Input

+ type Sensor interface

+ Sense func(ctx context.Context, request SenseRequest) (WorldState, error)

+ type SensorFunc func(ctx context.Context, request SenseRequest) (WorldState, error)

+ func (s SensorFunc) Sense(ctx context.Context, request SenseRequest) (WorldState, error)

v0.15.0

Sep 7, 2026

v0.14.0

Sep 1, 2026

v0.13.0

Aug 31, 2026

v0.12.0

Aug 30, 2026

v0.11.0

Aug 30, 2026

v0.10.0

Aug 30, 2026

v0.2.1

Aug 30, 2026

Changes in this version

+ var ErrInvalidAction = errors.New("planning: invalid action")

+ var ErrInvalidActionCost = errors.New("planning: invalid action cost")

+ var ErrInvalidCondition = errors.New("planning: invalid condition")

+ var ErrInvalidDefinitionConfig = errors.New("planning: invalid definition configuration")

+ var ErrInvalidDispatcherConfig = errors.New("planning: invalid dispatcher configuration")

+ var ErrInvalidExecutionState = errors.New("planning: invalid execution state")

+ var ErrInvalidGoal = errors.New("planning: invalid goal")

+ var ErrInvalidPlan = errors.New("planning: invalid plan")

+ var ErrInvalidProblem = errors.New("planning: invalid problem")

+ var ErrInvalidProtocol = errors.New("planning: invalid protocol payload")

+ var ErrInvalidWorldState = errors.New("planning: invalid world state")

+ func NewActionSettlement(effectID agent.EffectID, result ActionResult) (agent.Settlement, error)

+ type Action struct

+ func NewAction(config ActionConfig) (Action, error)

+ func (a Action) Applicable(state WorldState) bool

+ func (a Action) Apply(source WorldState) (WorldState, error)

+ func (a Action) Cost(source WorldState) (cost float64, err error)

+ func (a Action) Description() string

+ func (a Action) Effects() []Condition

+ func (a Action) Name() string

+ func (a Action) Preconditions() []Condition

+ func (a Action) Valid() bool

+ type ActionBinding struct

+ func NewChildBinding(config ChildBindingConfig) (ActionBinding, error)

+ func NewDispatcherBinding(config DispatcherBindingConfig) (ActionBinding, error)

+ func (a ActionBinding) Action() Action

+ func (a ActionBinding) Valid() bool

+ type ActionConfig struct

+ Cost CostFunc

+ Description string

+ Effects []Condition

+ Name string

+ Preconditions []Condition

+ type ActionExecutor interface

+ Execute func(ctx context.Context, request ActionRequest) (ActionResult, error)

+ type ActionExecutorFunc func(ctx context.Context, request ActionRequest) (ActionResult, error)

+ func (a ActionExecutorFunc) Execute(ctx context.Context, request ActionRequest) (ActionResult, error)

+ type ActionRequest struct

+ ActionDescription string

+ ActionName string

+ EffectID agent.EffectID

+ Input agent.Input

+ WorldState WorldState

+ type ActionResult struct

+ func ActionFailed(diagnostic string) (ActionResult, error)

+ func ActionSucceeded() ActionResult

+ func (a ActionResult) Diagnostic() string

+ func (a ActionResult) Succeeded() bool

+ func (a ActionResult) Valid() bool

+ type Attempt struct

+ ActionName string

+ Diagnostic string

+ Status AttemptStatus

+ func (a Attempt) Validate() error

+ type AttemptStatus string

+ const AttemptFailed

+ const AttemptSucceeded

+ const AttemptUnconfirmed

+ func (a AttemptStatus) Valid() bool

+ type ChildBindingConfig struct

+ Action Action

+ Budget agent.Budget

+ Capabilities agent.CapabilitySet

+ DeploymentRef agent.DeploymentRef

+ Input ChildInputFunc

+ type ChildInputFunc func(processInput agent.Input, worldState WorldState) (agent.Input, error)

+ type Condition struct

+ func NewCondition(key string, truth Truth) (Condition, error)

+ func (Condition) JSONSchemaModel() any

+ func (c *Condition) UnmarshalJSON(data []byte) error

+ func (c Condition) Key() string

+ func (c Condition) MarshalJSON() ([]byte, error)

+ func (c Condition) Truth() Truth

+ func (c Condition) Valid() bool

+ type CostFunc func(source WorldState) (float64, error)

+ func FixedCost(value float64) CostFunc

+ type Definition struct

+ func NewDefinition(config DefinitionConfig) (*Definition, error)

+ func (d *Definition) Descriptor() agent.Descriptor

+ func (d *Definition) Restore(state agent.ExecutionState) (agent.Execution, error)

+ func (d *Definition) Start(input agent.Input) (agent.Execution, error)

+ type DefinitionConfig struct

+ Actions []ActionBinding

+ Description string

+ Goal Goal

+ InputSchema agent.Schema

+ MaxActionAttempts uint32

+ Name string

+ Planner Planner

+ type Dispatcher struct

+ func NewDispatcher(definition *Definition, config DispatcherConfig) (*Dispatcher, error)

+ func (*Dispatcher) ReplayPolicy(effect agent.Effect) agent.ReplayPolicy

+ func (d *Dispatcher) Dispatch(ctx context.Context, request agent.EffectRequest, _ agent.DeltaEmitter) (agent.Settlement, error)

+ type DispatcherBindingConfig struct

+ Action Action

+ RequiredCapabilities []agent.Capability

+ type DispatcherConfig struct

+ ActionExecutors map[string]ActionExecutor

+ Observer Observer

+ type Goal struct

+ func NewGoal(config GoalConfig) (Goal, error)

+ func (g Goal) Conditions() []Condition

+ func (g Goal) Description() string

+ func (g Goal) Name() string

+ func (g Goal) SatisfiedBy(state WorldState) bool

+ func (g Goal) Valid() bool

+ type GoalConfig struct

+ Conditions []Condition

+ Description string

+ Name string

+ type ObservationRequest struct

+ EffectID agent.EffectID

+ Input agent.Input

+ type Observer interface

+ Observe func(ctx context.Context, request ObservationRequest) (WorldState, error)

+ type ObserverFunc func(ctx context.Context, request ObservationRequest) (WorldState, error)

+ func (o ObserverFunc) Observe(ctx context.Context, request ObservationRequest) (WorldState, error)

+ type Outcome string

+ const OutcomeAchieved

+ const OutcomeStuck

+ const OutcomeUnreachable

+ func (o Outcome) Valid() bool

+ type Output struct

+ Attempts []Attempt

+ Outcome Outcome

+ PlanningPasses uint32

+ WorldState WorldState

+ func (o Output) Validate() error

+ type Plan struct

+ func NewPlan(actions []PlannedAction, totalCost float64) (Plan, error)

+ func (p *Plan) UnmarshalJSON(data []byte) error

+ func (p Plan) Actions() []PlannedAction

+ func (p Plan) MarshalJSON() ([]byte, error)

+ func (p Plan) TotalCost() float64

+ func (p Plan) Valid() bool

+ type PlannedAction struct

+ func NewPlannedAction(name string) (PlannedAction, error)

+ func (p *PlannedAction) UnmarshalJSON(data []byte) error

+ func (p PlannedAction) MarshalJSON() ([]byte, error)

+ func (p PlannedAction) Name() string

+ func (p PlannedAction) Valid() bool

+ type Planner interface

+ Plan func(ctx context.Context, problem Problem) (plan Plan, found bool, err error)

+ type PlannerFunc func(ctx context.Context, problem Problem) (plan Plan, found bool, err error)

+ func (p PlannerFunc) Plan(ctx context.Context, problem Problem) (Plan, bool, error)

+ type Problem struct

+ func NewProblem(initial WorldState, goal Goal, actions ...Action) (Problem, error)

+ func (p Problem) Action(name string) (Action, bool)

+ func (p Problem) Actions() []Action

+ func (p Problem) Goal() Goal

+ func (p Problem) InitialState() WorldState

+ func (p Problem) Valid() bool

+ func (p Problem) ValidatePlan(plan Plan) error

+ type Truth string

+ const False

+ const True

+ const Unknown

+ func (t *Truth) UnmarshalJSON(data []byte) error

+ func (t Truth) MarshalJSON() ([]byte, error)

+ func (t Truth) String() string

+ func (t Truth) Valid() bool

+ type WorldState struct

+ func NewWorldState(conditions ...Condition) (WorldState, error)

+ func (WorldState) JSONSchemaModel() any

+ func (w *WorldState) UnmarshalJSON(data []byte) error

+ func (w WorldState) Apply(effects ...Condition) (WorldState, error)

+ func (w WorldState) Conditions() []Condition

+ func (w WorldState) Key() string

+ func (w WorldState) MarshalJSON() ([]byte, error)

+ func (w WorldState) Satisfies(requirements ...Condition) bool

+ func (w WorldState) Truth(key string) Truth

+ func (w WorldState) Valid() bool

v0.2.0

Aug 27, 2026

v0.1.0

Aug 27, 2026

v0.0.1

Aug 27, 2026

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL