Skip to content

Plan items¶

Use this index to jump directly to an XML plan-item reference. Entries are grouped by how developers use them and are also available individually in the left menu. For the enclosing structures, see Goals and Plans and postplans.

Questions and assumed facts¶

Plan item	Use
`assume_issue`	Open an issue as if the user had asked it.
`assume_shared`	Add a proposition to shared commitments.
`assume_system_belief`	Add a proposition to private beliefs.
`findout`	Ask for or resolve an answer to a question.
`inform`	Share and communicate a proposition.
`raise`	Raise a question issue without making it a findout step.
`bind`	Accept relevant answers to an unasked question.

Plan item	Use
`forget`	Remove facts from beliefs and commitments.
`forget_all`	Reset dialogue state and restart the top goal.
`forget_shared`	Remove facts from shared commitments only.
`get_done`	Ask the user to perform an action.

Branching and sequencing¶

Plan item	Use
`change_ddd`	Change the active DDD.
`if`	Select a branch by evaluating a condition.
`jumpto`	Target another goal in the active DDD.
`once`	Run a wrapped plan sequence once for a marker.

Queries, iterators, and actions¶

Plan item	Use
`invoke_domain_query`	Resolve a question from a DDD domain query.
`invoke_service_action`	Invoke a Service Interface action.
`invoke_service_query`	Resolve a question using a Service Interface query.
`iterate`	Assume the next proposition from an iterator.
`reset_domain_query`	Restart a domain-query enumeration.

Turn-taking and diagnostics¶

Plan item	Use
`end_turn`	Explicitly hand the turn back to the client/user.
`greet`	Request a greeting move.
`log`	Write a diagnostic log message.
`signal_action_completion`	Complete a perform goal and stop its remaining plan.
`signal_action_failure`	Mark an action as failed.

Conditions are expressions used by if and goal completion; see Conditions and Downdate conditions.

DDD JSON¶

Each DDD JSON plan item uses a single-key object. For example, {"forget": {"predicate": "colour"}}. See DDD JSON for the bundle structure and examples.