| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233 |
- """Closed action handlers inside the runtime mutation receipt transaction."""
- import time
- from hermes_state_runtime import RuntimeStoreError
- METADATA_FIELDS = {'title': str, 'archived': bool, 'hidden': bool, 'pinned': bool, 'unread': bool}
- def validate_action(operation, payload):
- if not isinstance(payload, dict) or not isinstance(operation, str):
- raise RuntimeStoreError('invalid_params')
- # ``confirm``: the owner's selection-guard token for this exact resolved target (session_mutation_model).
- # ``reasoning``: a level picked with the model, committed in the same selection.
- if (operation == 'model' and 'model' in payload and not set(payload) - {'model', 'provider', 'confirm', 'reasoning'}
- and all(isinstance(v, str) and v.strip() for v in payload.values())):
- from hermes_constants import parse_reasoning_effort
- if 'reasoning' not in payload or parse_reasoning_effort(payload['reasoning']) is not None:
- return
- if operation == 'branch' and _valid_branch_payload(payload):
- return
- # Session-scope ``/reasoning <level>`` and Desktop's Move to project: revision-fenced edits of
- # the frozen policy (gateway/session_mutation_policy.py).
- if operation == 'reasoning' and set(payload) == {'effort'} and payload['effort'] is None:
- return # ``/reasoning reset``: the session's level goes back to the profile
- if operation == 'reasoning' and set(payload) == {'effort'} and isinstance(payload['effort'], str):
- from hermes_constants import parse_reasoning_effort
- if parse_reasoning_effort(payload['effort']) is not None:
- return
- if operation == 'workspace' and set(payload) == {'cwd'} and isinstance(payload['cwd'], str) and payload['cwd'].strip():
- return
- # The editor's MCP servers (gateway/session_local_mcp.py): the owner keeps the list in memory and
- # hands the store only its fingerprint, so no transport credential reaches a receipt.
- if operation == 'editor_mcp' and set(payload) == {'mcp_servers'} and _valid_editor_fingerprint(payload):
- return
- # An ACP session's edit approval policy (gateway/session_mutation_policy.py prepare_edit_policy).
- if (operation == 'edit_policy' and set(payload) == {'policy'} and isinstance(payload['policy'], str)
- and payload['policy'] in {'ask', 'workspace_session', 'session'}):
- return
- if operation == 'compress' and _valid_compress_payload(payload):
- return
- if operation in {'delete', 'reset'} and not payload:
- return
- if operation == 'import' and set(payload) == {'sessions'} and isinstance(payload['sessions'], list):
- return
- if (operation == 'rewind' and 'target_message_id' in payload
- and not set(payload) - {'target_message_id', 'preserve_compaction_handoff'}
- and type(payload['target_message_id']) is int and payload['target_message_id'] > 0
- and type(payload.get('preserve_compaction_handoff', False)) is bool):
- return
- required = {'rename': {'title'}, 'archive': {'archived'}}
- if operation == 'sidebar':
- valid = bool(payload) and not set(payload) - METADATA_FIELDS.keys()
- else:
- valid = operation in required and set(payload) == required[operation]
- if not valid or any(type(value) is not METADATA_FIELDS[key] for key, value in payload.items()):
- raise RuntimeStoreError('invalid_params')
- def _valid_branch_payload(payload):
- # ``through_message_id``: the physical row id of the last message the branch keeps (a stable
- # boundary, never a visible-message count); absent means the whole active transcript.
- if set(payload) - {'title', 'through_message_id', 'mcp_servers'}:
- return False
- if 'mcp_servers' in payload and not _valid_editor_fingerprint(payload):
- return False
- if 'title' in payload and not isinstance(payload['title'], str):
- return False
- return 'through_message_id' not in payload or (
- type(payload['through_message_id']) is int and payload['through_message_id'] > 0)
- def _valid_editor_fingerprint(payload):
- servers = payload['mcp_servers']
- return isinstance(servers, dict) and set(servers) == {'fingerprint'} and isinstance(servers['fingerprint'], str)
- _COMPRESS_FIELDS = {'focus': str, 'preview': bool, 'partial': bool, 'keep_last': int}
- def _valid_compress_payload(payload):
- # ``focus`` alone may still be the raw ``/compress`` argument string (Ink/Desktop
- # clients); the structured flags come from the shared parser on the native CLI/ACP path.
- if set(payload) - _COMPRESS_FIELDS.keys():
- return False
- if any(type(value) is not _COMPRESS_FIELDS[key] for key, value in payload.items()):
- return False
- return 'keep_last' not in payload or (payload.get('partial') is True and payload['keep_last'] >= 1)
- def apply_action(db, conn, session_id, operation, payload, *, prepared=None):
- if operation == 'compress':
- from hermes_state_mutation_compress import compress_in_transaction
- return compress_in_transaction(db, conn, session_id, payload, prepared)
- if operation in {'model', 'reasoning', 'workspace', 'editor_mcp', 'edit_policy'}:
- from hermes_state_mutation_prepared import POLICY_HANDLERS
- return POLICY_HANDLERS[operation](db, conn, session_id, payload, prepared)
- if operation == 'branch':
- from hermes_state_mutation_branch import branch_in_transaction
- return branch_in_transaction(db, conn, session_id, payload, prepared)
- from hermes_state_mutation_reset import reset_in_transaction
- handlers = {'delete': _delete, 'import': _import, 'rewind': _rewind, 'reset': reset_in_transaction}
- if operation in handlers:
- return handlers[operation](db, conn, session_id, payload)
- affected = set()
- result = {}
- for key, value in payload.items():
- if key == 'title':
- affected.update(db._set_session_title_in_transaction(
- conn, session_id, value, source=db.TITLE_SOURCE_USER))
- result[key] = conn.execute('SELECT title FROM sessions WHERE id=?', (session_id,)).fetchone()[0]
- else:
- column = 'last_read_at' if key == 'unread' else key
- stored = (0.0 if value else time.time()) if key == 'unread' else int(value)
- affected.update(db._set_lineage_column_in_transaction(conn, column, session_id, stored))
- result[key] = value
- return affected, result
- def _delete(db, conn, session_id, payload):
- # Terminal admission/worker rows become digest tombstones so exact retries and
- # adoption checks still resolve after the transcript is gone.
- from hermes_state_mutation_retirement import delete_in_transaction
- return delete_in_transaction(db, conn, session_id, payload)
- def _rewind(db, conn, session_id, payload):
- from hermes_state_mutation_guards import require_idle
- from hermes_state_mutation_transcript import rewind_in_transaction
- from hermes_state_local_lineage import local_physical_target
- physical = local_physical_target(conn, session_id)
- require_idle(db, conn, list({session_id, physical}))
- # The client names the row: like a branch boundary it must be an active row of the physical
- # target. A row compaction archived (still shown, still carrying its id) would deactivate the
- # summary and every later turn, since both have larger ids. That refusal says so (``compacted:``
- # detail); a row a rewind or undo already took back, an assistant row or an unknown id does not.
- row = conn.execute('SELECT role FROM messages WHERE id=? AND session_id=? AND active=1',
- (payload['target_message_id'], physical)).fetchone()
- if row is None or row['role'] != 'user':
- if _summarized_by_compaction(conn, physical, payload['target_message_id']):
- raise RuntimeStoreError('invalid_params', field='target_message_id', detail=COMPACTED_TARGET_DETAIL)
- raise RuntimeStoreError('invalid_params', field='target_message_id',
- detail='target user message is no longer in session history')
- # A composite compaction carrier (summary + the next ask in one row) keeps its handoff, as
- # main's rewind does; the receipt reports the live ask, so /retry resubmits it, not the summary.
- live = _carrier_live_view(db, conn, physical, payload['target_message_id'])
- target, ids, head, replacement = rewind_in_transaction(db, conn, physical, payload['target_message_id'],
- preserve_compaction_handoff=live is not None or payload.get('preserve_compaction_handoff', False))
- # Receipts are JSON: publish the same public message shape get_messages() returns (decoded
- # content/tool_calls, no internal display_identity BLOB / display_order).
- target = db._row_to_message_dict(target, warn_context='rewind receipt', summary_flag=True)
- if live is not None:
- target['content'] = live.get('content')
- from agent.message_metadata import typed_prompt_content # /retry, /undo: the typed ask, not the placeholder
- target['content'] = typed_prompt_content(target.get('content'), target)
- conn.execute('UPDATE sessions SET runtime_generation=runtime_generation+1 WHERE id=?', (session_id,))
- return {session_id, physical}, {'rewound_count': len(ids), 'target_message': target,
- 'new_head_id': head, 'replacement_message_id': replacement}
- # The refusal's ``detail`` for a target compaction summarized: ``compacted:`` is the machine-readable
- # prefix clients match (Desktop's restore/edit toast); the rest is the log line.
- COMPACTED_TARGET_DETAIL = 'compacted: target user message was summarized when the session was compressed'
- def _summarized_by_compaction(conn, physical, message_id):
- """Whether *message_id* is a user turn compaction took out of *physical*'s live transcript, as
- opposed to one a rewind/undo deactivated, an assistant row, or no row at all. In-place compaction
- archives with ``active=0, compacted=1`` (``_ARCHIVE_ACTIVE_SQL``) while rewind, undo and replace
- mark ``active=0, compacted=0``; a rotating compaction leaves the turn on a compression ancestor of
- *physical*, still displayed (``active=1 OR compacted=1``)."""
- row = conn.execute('SELECT session_id, role, active, compacted FROM messages WHERE id=?',
- (message_id,)).fetchone()
- if row is None or row['role'] != 'user':
- return False
- if row['session_id'] == physical:
- return row['active'] == 0 and row['compacted'] == 1
- if not (row['active'] == 1 or row['compacted'] == 1):
- return False
- from hermes_state_sessions import _expand_compression_lineage_ids
- from hermes_state_compression import _CHAIN_CAP
- lineage, frontier = {physical}, [physical]
- for _ in range(_CHAIN_CAP):
- frontier = [sid for sid in _expand_compression_lineage_ids(conn, frontier) if sid not in lineage]
- if not frontier:
- break
- lineage.update(frontier)
- return row['session_id'] in lineage
- def _carrier_live_view(db, conn, session_id, message_id):
- from agent.context_compressor import split_user_originated_turn
- row = conn.execute('SELECT * FROM messages WHERE id=? AND session_id=? AND active=1',
- (message_id, session_id)).fetchone()
- message = row and db._row_to_message_dict(row, warn_context='rewind target', summary_flag=True)
- handoff, live = split_user_originated_turn(message) if message else (None, None)
- return live if handoff is not None else None
- def _import(db, conn, session_id, payload):
- rows = payload['sessions']
- if len(rows) > db._IMPORT_MAX_SESSIONS:
- raise RuntimeStoreError('invalid_params')
- normalized, errors = db._validate_import_payload(rows)
- if errors or not normalized or session_id != normalized[0]['session']['id']:
- raise RuntimeStoreError('invalid_params')
- imported, skipped, parents = [], [], []
- for item in normalized:
- raw = item['session']
- sid = raw['id']
- from hermes_state_mutation_retirement import RETIRED_PREFIX
- if conn.execute('SELECT 1 FROM state_meta WHERE key=?', (RETIRED_PREFIX + sid,)).fetchone():
- # Refused by name at import time: a row restored beside the fence would refuse every turn.
- raise RuntimeStoreError('admission_conflict', field='sessions',
- detail=f'session {sid} was deleted here; a deleted session is not restored')
- if conn.execute('SELECT 1 FROM sessions WHERE id=?', (sid,)).fetchone():
- skipped.append(sid)
- continue
- db._import_session_row(conn, raw, item['messages'], sid)
- if raw.get('parent_session_id'):
- parents.append((sid, raw['parent_session_id']))
- imported.append(sid)
- # A parent outside this payload is kept only when it is history this importer already
- # controls: its import binding equals the child's (written by import_history_control in this
- # transaction). Linking under any other row would graft the import onto a foreign chain,
- # which a later chain-aware delete of the import would then remove.
- from hermes_state_mutation_binding import history_binding
- # Rows imported now, not payload ids: a payload naming an existing foreign id skips that row.
- fresh = set(imported)
- foreign = [(sid, parent) for sid, parent in parents if parent not in fresh and (
- history_binding(conn, parent) is None or history_binding(conn, parent) != history_binding(conn, sid))]
- parents = [link for link in parents if link not in foreign]
- detached = db._attach_import_parents(conn, parents) + len(foreign)
- return set(imported), {'ok': True, 'imported': len(imported), 'skipped': len(skipped),
- 'imported_ids': imported, 'skipped_ids': skipped, 'detached': detached, 'errors': []}
|