The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
"""``/rollback`` on the shared gateway session (``rollback.list`` / ``rollback.diff`` / ``rollback.restore``).
The gateway's tools take the checkpoints (its ``CheckpointManager``, keyed by the session's launch
cwd), so the CLI process has no manager of its own: it renders main's text over the owner's
answers. A whole-tree restore also rewinds the newest user turn on the owner (``history_removed``);
the CLI then re-reads the transcript so its warm history matches.
"""
from __future__ import annotations
import os
from agent.i18n import t
from hermes_cli.gateway_client import GatewayClientError
def _t(key, **kw):
return t(f"cli.commands.{key}", **kw)
def _checkpoint_rows(result):
"""``rollback.list`` rows as ``format_checkpoint_list`` reads them."""
return [{"hash": c.get("hash", ""), "short_hash": (c.get("hash") or "")[:7], "timestamp": c.get("timestamp", ""),
"reason": c.get("message", "")} for c in result.get("checkpoints") or []]
def rollback(cli, connection, command):
from tools.checkpoint_manager import format_checkpoint_list
words = command.split()[1:]
args = [a for a in words if a.lower() not in ("--all", "--force")]
restore_all = len(args) != len(words)
cwd = os.getenv("TERMINAL_CWD", os.getcwd())
sid = cli.session_id
try:
if not args:
listed = connection.call("rollback.list", session_id=sid)
if not listed.get("enabled"):
return print("\n".join(f" {line}" if line else "" for line in _t("rollback.not_enabled").splitlines()))
return print(format_checkpoint_list(_checkpoint_rows(listed), cwd))
if args[0].lower() == "diff":
if len(args) < 2:
return print(f" {_t('rollback.usage_diff')}")
return _diff(connection.call("rollback.diff", session_id=sid, hash=args[1]))
params = {"session_id": sid, "hash": args[0]}
if len(args) > 1:
params["file_path"] = args[1]
elif restore_all:
params["all"] = True # main's --all/--force: also revert the user's hand-edits
_restored(cli, connection, connection.call("rollback.restore", **params), params.get("file_path"))
except GatewayClientError as exc:
print(f" ❌ {exc}")
def _diff(result):
stat, diff = result.get("stat", ""), result.get("diff", "")
if not stat and not diff:
return print(f" {_t('rollback.no_changes_since')}")
if stat:
print(f"\n{stat}")
if diff:
lines = diff.splitlines()
if len(lines) > 80: # main's terminal-flood limit
print("\n".join(lines[:80]))
print(f"\n {_t('rollback.more_lines', count=len(lines) - 80)}")
else:
print(f"\n{diff}")
def _restored(cli, connection, result, file_path):
if not result.get("success"):
return print(f" ❌ {result.get('error')}")
restored = {"hash": result.get("restored_to", ""), "reason": result.get("reason", "")}
print(f" {_t('rollback.restored_file', file=file_path, **restored)}" if file_path
else f" {_t('rollback.restored_all', **restored)}")
from hermes_cli.cli_commands_session_tools import _rollback_kept
_rollback_kept(result) # the in-process CLI's own lines
print(f" {_t('rollback.snapshot_saved')}")
if result.get("history_removed"):
snapshot = connection.call("session.resume", session_id=cli.session_id)
connection.state(cli.session_id).adopt_snapshot(snapshot)
cli.conversation_history = [{k: v for k, v in m.items() if k != "row_id"}
for m in snapshot.get("messages") or [] if not m.get("archived")]
print(f" {_t('rollback.chat_turn_undone')}")