golem-undo-agent-state

To roll back agent state after a failed invocation, you revert the agent by undoing its recorded operations. You can specify either an oplog index or the number of invocations to reverse, deterministically restoring the prior state.

Undoing agent side effects involves reverting recorded operations using oplog indices or invocation counts. This approach applies deterministic reversal to the operation history, removing the need to manually repair the state.

You can revert an agent to a specific oplog index, or you can choose to undo the last N invocations. These two selection methods are mutually exclusive, allowing flexible control over state restoration.

To undo an agent's most recent invocation, run the revert command with the agent identifier and set the number-of-invocations parameter to 1. This immediately reverses the side effects of that specific run.

Invocation rollback is needed when an agent makes incorrect changes during a run and you want to immediately undo the impact. It provides controlled state restoration by applying deterministic reversal to the operation history.

Restoring agent state requires a valid agent identifier and uses either a last-oplog-index or number-of-invocations parameter. These two selection methods are mutually exclusive, meaning you cannot combine them in a single rollback operation.