+ WjWbRt^RIHt^RIHt^RIHt^RIHtH t Rt Rt RRlt R R lt R #) z&``hermes sessions`` subcommand parser.) annotations)Path)Callable) add_json_flag add_yes_flagc2VP!VRRRV/VBR#)action store_truehelpN) add_argument)parserr nameskws&$*,SC:\Users\johnn\AppData\Local\hermes\hermes-agent\hermes_cli\subcommands\sessions.py_flagr s E|E$E"Ec  ^RIHpV!V3/VB#)zP``hermes sessions`` handler; sessions_cmd imports only when the subcommand runs.) cmd_sessions)hermes_cli.sessions_cmdr)argskwargsrs&, rcmd_sessions_lazyrs4  ' ''rcV^8dQhRR/#)returnNone)formats"r __annotate__rs,,D,rcVPRRR7pVPRRR7VPRRRR7^R IHpV!V4R #) renamezSet or change a session's titler session_idzSession ID to renametitle+zNew title for the sessionnargsr )add_discard_parserN) add_parserr hermes_cli.sessions_discardr')sessions_subparserssessions_renamer's& r_add_rename_and_discardr,sS)4485:O  4J K  :U V>*+rc V^8dQhRRRR/#)rrrrrr)rs"rrrsr:r:xr:Dr:rcaaVPRRRR7pVPRR7pVPRRR 7pVPR R R 7VPR \^R R7VPRRRR7R\ RRR73R\ RRR73R\ RRR73R \ RR 73R\ RR 73R\ RR 73R \ R!R 73R"\ \R#R$73R%\ \R&R$73R'\ R(R 73R)\ R*R 73R+\ R,R 73R-\ R.R 73R/\ R0R 73R1\ R2R 73R3\ \R4R$73R5\ \R6R$73R7\ \ R8R$73R9\ \ R:R$73R;\ \RR$73R?\ R@RARB733oV3RClpVPRDRER 7pVPRFRGRHRIRJ7VPRK.RORLRMRN7\ VRORPR 7\ VRQRRR 7\ VRSRTR 7VPRURV.RWRX7VPRYRZR 7V!VR[4\ VR\R]R 7VPR^R_R`.R_RaRN7\ VRbRcR 7\ VRdReR 7VPRfRgR 7pVPRhRiR 7\VRj4VPRkRlR 7pV!VRm4\ VRnRoR 7\ VRpRqR 7\ VRrRsR 7\ VRdRtR 7VPRuRvR 7p V!V Rw4\ V RxRyR 7VPRzR{R 7p \ V RdR|R 7VPR}R~RR7p \ V R?RRR7\ V RRRR7VPRRRR7p \ V RRRR7\ V RRRRR7\ V RdR|R 7VPRRRR7p \ V RRR 7\ V RRR 7VPRRRR7pVPRRRRX7VPRRRRR7\ VRdRR 7VPRRRR7p\ VRRR 7VPR\ RRR7VPRRRR7p\ VRRR 7\ VRRR 7\ VRRRRR7VPRRRRRN7VPRRRR7p\ VRRR 7\ VRRR 7VPRhRGRRR7VPRRRR7pVPR \RRR7VPR\RR$7\ VRRR 7VPR\RR$7VPR\RRR7\ VRRR 7VPR\RR$7VPRRR 7\V4VPRRRR7pVPRRRR7VPRRR 7pVPRRRR7VPRRR 7p\VR4VPRRRR7p\ VRRR 7VPR \^RR7VPRRR 7pVPR R R 7VPR \RRR7VPRRRR7pVPRRRR.RR7VPRRGRR7RV/V3RllpVPVR7R#)z5Attach the ``sessions`` subcommand to ``subparsers``.sessionszOnly match sessions whose working directory is under this pathz--min-messagesz&Only match sessions with >= N messages)r4r z--max-messagesz&Only match sessions with <= N messagesz--modelz_Only match sessions whose model name contains this substring (e.g. 'sonnet', 'gpt-5', 'hermes')z --providerzSOnly match sessions billed through this provider (e.g. openrouter, anthropic, nous)z--userz%Only match sessions from this user IDz --chat-idz-Only match sessions from this chat/channel IDz --chat-typez8Only match sessions with this chat type (e.g. dm, group)z--branchz= N total tokens (input+output)z --max-tokensz9Only match sessions with <= N total tokens (input+output)z --min-costz:Only match sessions costing >= N USD (actual or estimated)z --max-costz:Only match sessions costing <= N USD (actual or estimated)z--min-tool-callsz(Only match sessions with >= N tool callsz--max-tool-callsz(Only match sessions with <= N tool callsz --dry-runr z0List matching sessions without changing anything)rr c<VPRRVR7SFwr#VP!V3/VBK \VR4R#)z --older-thanr9r7Skip confirmationN)r r)pdefault_older_helpflagr _filter_argss&& r_add_session_filter_args7build_sessions_parser.._add_session_filter_argsOs> ~u;MN$HD NN4 &2 &%Q+,rexportz*Export sessions to JSONL, Markdown, or QMDoutput?OUTPUTaWhere to write. jsonl/html/trace: a file path, or a directory (existing, or ending in /) to write a default-named file into; - for stdout (jsonl/trace only; jsonl requires OUTPUT). md/qmd: a directory, one file per session (default: /session-exports))r&r8r z--formatjsonlzgExport format (default: jsonl). 'trace' emits Claude Code JSONL for the Hugging Face Agent Trace Viewer)choicesr5r z--uploadzgtrace only: upload to your Hugging Face traces dataset instead of writing a local file (needs HF_TOKEN)z--publiczFtrace --upload only: create/update a public dataset instead of privatez --no-redactzJtrace only: skip the forced secret redaction; only use after manual reviewz--onlyz user-promptszhExport only a filtered view (user-prompts: one prompt record per line for jsonl, headed sections for md))rHr z --session-idz%Session ID or unique prefix to exportzOnly export sessions older than AGE (duration like '5h'/'2d', bare number of days, or an ISO timestamp). Filtered exports include pinned and archived sessions, so they back up everything a matching prune could deletez--redactzDRedact secrets (API keys, tokens, credentials) from exported contentz --lineagesinglelogicalz6md/qmd only: export one row or its compression lineagez--delete-after-verifiedzTmd/qmd only: after verified single-session export, delete that session (needs --yes)z--forcez.md/qmd only: overwrite an existing export filedeletezDelete a specific sessionr"zSession ID to deleter<prunezCDelete old sessions (filterable by time window, source, title, ...)uDelete sessions older than AGE — days if bare number, or a duration like '5h'/'2d'/'1w', or an ISO timestamp (bare prune with no filters defaults to 90 days; any filter matches all ages)z--include-archivedz3Also delete archived sessions (excluded by default)z--include-pinneduHAlso delete pinned sessions (excluded by default — pin is a keep flag)z--never-activeuInstead of ended sessions, delete keyed gateway rows that were opened and never used (no messages, tokens, tool calls or title) and are older than AGE (default 30 days). Ordinary prune can never reach these — it only ever selects ended sessionsuWith no gateway running: run even while another Hermes process (Desktop, dashboard, cron) holds state.db — rewriting the store under a live writer can leave every agent refusing turns until all writers are stopped. With the gateway running, prune always goes through itarchiveuBBulk-archive (soft-hide) sessions matching filters — no deletionzeOnly archive sessions older than AGE (duration like '5h'/'2d', bare number of days, or ISO timestamp)z--include-openz5Also archive never-ended sessions, e.g. Desktop chatsoptimizezAReclaim disk space: merge FTS5 segments + VACUUM (no data change)uRun even while another Hermes process (gateway, Desktop, dashboard, cron) holds state.db — rewriting the store under a live writer can leave every agent refusing turns until all writers are stoppedz clean-markerszTPermanently clear stale tool-call marker content left by sessions from before #78148uBefore the #78148 fix, a local tool-call template could persist a bare bracketed marker (e.g. "[memory]") as an assistant turn's content instead of real text. This is already repaired in memory on every session load, so running this is optional — it rewrites the affected rows once, in place, so long-lived sessions stop re-scanning/re-repairing the same rows on every resume. Only the content column is touched; tool_calls and every other column on the row are left untouched.Fz-Report the affected row count without writing)r5r z --no-backupzKSkip the timestamped state.db backup taken before writing (not recommended)zoptimize-storagezOMigrate the search index to the compact v23 layout (reclaims disk on large DBs)uRebuild the full-text search index in the compact v23 external-content layout. On large databases this reclaims a large fraction of state.db (the old layout stored duplicate copies of every message and indexed tool output). Runs foreground with a progress bar, throttles so a running gateway stays responsive, and VACUUMs at the end. Safe to interrupt and re-run — it resumes where it left off. No conversation data is changed; only the search index is rebuilt.z --no-vacuumzgSkip the final VACUUM (index is rebuilt but freed pages aren't returned to the OS until a later VACUUM)z--yesz-yz'Skip the disk-space confirmation promptrepairz>Repair a malformed state.db schema so hidden sessions reappearzRecover a state.db whose schema is malformed (e.g. 'table messages_fts already exists'), which makes Desktop/Dashboard show no sessions. A backup is made first; sessions and messages are preserved and the FTS search index is rebuilt if needed.z --check-onlyz@Only report whether the database opens cleanly; do not modify itz2Skip the timestamped backup copy (not recommended)zset-journal-modezSConvert state.db between journal_mode=WAL and DELETE offline (every holder stopped)aSwitch the on-disk journal mode of the session store. Hermes never live-downgrades a WAL database at startup (other processes may hold uncheckpointed commits), so `database.journal_mode: delete` cannot self-apply to an existing WAL store. Run this with the gateway, dashboard and every CLI stopped: it refuses while any process holds the file, switches the mode, and verifies the file header.modezTarget journal modez--dbNPATHzVConvert another Hermes SQLite store (e.g. kanban.db) instead of the profile's state.db)r5r8r zProceed when the holder scan itself fails (cannot prove the store is quiet) after stopping every Hermes process yourself; a process the scan does find is still refusedzrepair-routingz:Re-stamp gateway sessions that lost their routing identityuFind gateway conversations stranded in session rows whose routing identity (session_key/chat_id/origin) was never written — the damage a corrupt state.db write path leaves behind (#82616). Such a row is invisible to restart recovery, so the chat resumes an older session instead. Re-stamps each orphan from the keyed predecessor it continues, and only when that predecessor is unambiguous. Reports without touching the database unless --apply is given.z--applyz,Perform the adoptions (default: report only)z--max-gap-secondszWindow between a keyed predecessor's last activity and an orphan's start for them to count as the same conversation (default: 900)zrepair-profilesz@Settle session/routing state that landed under the wrong profilea2Scan every profile's state.db (and the gateway's voice-mode / sessions.json files) for durable state crossed between profiles: rows whose profile_name disagrees with their session key, rows sitting in another profile's store, parent links crossing namespaces, routing rows outside the default store or for a profile that no longer exists, and Telegram topic / voice-mode entries missing their bot's profile. Reports without touching anything unless --apply is given; --apply refuses while a gateway is running, snapshots every store first, and is safe to re-run.z*Perform the repairs (default: report only)z--jsonzMachine-readable reportzSkip the confirmation promptz --legacy-mainreportuAWhat to do with agent:main rows found inside a named profile's store: 'rekey' them to that profile (a standalone gateway's own history, e.g. after multiplexing was switched on), 'move' them to the default store (a default chat that leaked in), or 'report' (default) — the rows themselves cannot tell the two cases apartzrepair-promptszIReport or clear stored system prompts degraded to a reduced-toolset buildaRepair session rows degraded by the pre-#122822 gateway hygiene/compress bug. Automatic repair requires positive tools[] evidence; rows without a readable pin are reported as unverifiable and never changed by a scan. Clearing a prompt makes the next turn rebuild and persist healthy bytes. Reports without touching anything unless --apply is given; a session_id is an explicit destructive override and can clear even a healthy prompt.z1Clear the verified prompts (default: report only)zPMachine-readable output; with --apply, apply without an interactive confirmationzODestructive override: clear this session even when its stored prompt is healthy)r&r5r recoverz=Rebuild canonical session data into a separate clean databasea5Offline, non-destructive recovery for a damaged state.db. The source database and its WAL/SHM/rollback-journal sidecars are copied before SQLite opens anything. Canonical rows are rebuilt into a new output database; derived search indexes are recreated and the active database is never replaced automatically.Tz6Source state.db or preserved backup to inspect/recover)r4requiredr z--outputz;New recovery database path (required unless --inspect-only)z--inspect-onlyzIOnly report canonical table readability; do not create an output databasez --work-dirzNExisting directory for the disposable source copy (defaults beside the output)z --chunk-sizeiz1Rows committed per recovery batch (default: 1000)z--allow-partialznBest-effort salvage across damaged row ranges; the output remains separate and every skipped range is recordedz--reportz5JSON report path (defaults to .recovery.json)statszShow session store statisticspinu>Pin session(s) — durable keep flag, exempt from auto-archiveuSet the durable 'keep' flag on one or more sessions. Pinned sessions are exempt from the sessions.auto_archive stale sweep and always appear in listings. The same flag drives the Desktop sidebar's Pinned section — pin from either surface, both see it. session_idsr$z)Session ID(s) or unique prefix(es) to pinr%unpinz2Remove the pin (durable keep flag) from session(s)z+Session ID(s) or unique prefix(es) to unpinpinnedzList pinned sessionsz9Emit machine-readable JSON (for backup/restore scripting)zretitle-skillsz@Re-title sessions whose auto-title came from a /skill's own textuSessions opened with a /skill were auto-titled from the expanded message, which embeds the whole skill body — so the title describes the SKILL, not the request. This regenerates those titles from what the user actually typed. Lists what it would change unless --apply is passed.z'Write the new titles (default: dry run)z*Maximum sessions to examine (default: 200)browseuBInteractive session picker — browse, search, and resume sessionsiz#Max sessions to load (default: 500)importz5Import a Claude Code or Codex CLI session into HermeszPull a conversation started in Claude Code (~/.claude/projects) or Codex CLI (~/.codex/sessions) into the Hermes session store so it can be resumed with 'hermes --resume '. The foreign files are only read, never modified.z--from from_sourceclaudecodexz5Which tool to import from (default: pick across both))r2rHr pathz8Path to a specific session JSONL file (skips the picker)sessions_parserc<S!WR7#))r`r)_argsr`rs&$r_dispatch_sessions1build_sessions_parser.._dispatch_sessionsNsECCr)func)rGmdqmdhtmltrace)rKwal)rRrekeymove) r(add_subparsersr intdictfloatrrrr,r set_defaults) subparsersrr`r* sessions_listrAsessions_exportsessions_deletesessions_prunesessions_archivesessions_optimizesessions_clean_markerssessions_optimize_storagesessions_repairsessions_set_journal_modesessions_repair_routingsessions_repair_profilessessions_repair_promptssessions_recover sessions_pinsessions_unpinsessions_pinnedsessions_retitlesessions_browsesessions_importrcr@s&d @rbuild_sessions_parserrs  ++W>,@O*88>O8P'226@V2WMz0abysBE[\}h34 e3:; < T&0QR S D/9: ; TEFG DWXY #MNO $\]^ 4S/WXY 4S/WXY D12 3 t"12 3 4DEF d OPQ "\]^ T]^_ 3LN O 3LN O tMO P tMO P Ts1[\] Ts1[\] d,CE F? GLD- *44C5EO  ha!b  CW6!7 /:78 /: UW /=Z]  N3C:!;  6] ^MN /: SU  x6KU] E!G /4 ce /9+[\)44XD_4`O  4J K"56(33[4]N<= .. BD ., WY .*HI  .)_`+55\6^-0FG ,3jk+66\7^ YWX1;;O c*< + +u <> - Z\!4 > >?Q ^9!? !: #]E vx #WdE 68 #YWX*44WG5HO  /> OQ /=/cd 3 > >!vI!?!J**6;LSh*i**64 e+g #YUV2<<[0= 1 !93ab(()<5RV) 3== b >  "I4`a "H3LM "GT5Gef))!rs*,"FF(,r:r