hermes_state_worker_context.py 4.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889
  1. """Closed constructor-context operations inside the worker receipt transaction.
  2. Identity and lineage remain owner-reserved. This is not arbitrary SessionDB RPC.
  3. """
  4. import json
  5. from hermes_state_runtime import RuntimeStoreError
  6. # model_config sidecars a worker may patch: every key the agent persists via
  7. # ``patch_session_model_config`` (``_anthropic_rejected_thinking``: main's rejected-signature
  8. # fingerprints, agent/anthropic_thinking_replay.py) or a compaction ``model_config_patch``.
  9. SIDECAR_KEYS = frozenset({'_usage_anchor', '_proactive_prune_rearm_tokens', '_anthropic_rejected_thinking'})
  10. def worker_context(db, conn, session_id, payload):
  11. if payload:
  12. raise RuntimeStoreError('invalid_params')
  13. row = conn.execute(
  14. 'SELECT s.*, COALESCE(sp.prompt, s.system_prompt) AS _system_prompt_resolved, '
  15. 'COALESCE(tp.prompt, s.tool_names) AS _tool_names_resolved '
  16. 'FROM sessions s LEFT JOIN system_prompts sp ON sp.hash=s.system_prompt_hash '
  17. 'LEFT JOIN system_prompts tp ON tp.hash=s.tool_names WHERE s.id=?',
  18. (session_id,),
  19. ).fetchone()
  20. return {'session': db._session_row_dict(row)}
  21. def worker_prompt(db, conn, session_id, payload):
  22. if set(payload) != {'system_prompt'} or not (
  23. payload['system_prompt'] is None or isinstance(payload['system_prompt'], str)):
  24. raise RuntimeStoreError('invalid_params')
  25. conn.execute('UPDATE sessions SET system_prompt_hash=?, system_prompt=NULL WHERE id=?',
  26. (db._store_system_prompt(conn, payload['system_prompt']), session_id))
  27. db._delete_unreferenced_system_prompts(conn)
  28. return {'value': None}
  29. def worker_sidecars(db, conn, session_id, payload):
  30. if set(payload) != {'patch'} or not isinstance(payload['patch'], dict) or set(payload['patch']) - SIDECAR_KEYS:
  31. raise RuntimeStoreError('invalid_params')
  32. merged = db._merge_model_config_json(conn, session_id, payload['patch'], on_missing='raise')
  33. conn.execute('UPDATE sessions SET model_config=? WHERE id=?', (merged, session_id))
  34. return {'value': None}
  35. def worker_tool_names(db, conn, session_id, payload):
  36. """The tools[] pin, same contract as ``SessionDB.update_session_tool_names``: any JSON pin
  37. (``{"version", "tools"[, "delegation_backend"]}`` today; a legacy name list) content-addressed through ``system_prompts``,
  38. ``None`` clears. Bounded so a worker cannot write an unbounded blob into the shared table."""
  39. if set(payload) != {'tool_names'}:
  40. raise RuntimeStoreError('invalid_params')
  41. pin = payload['tool_names']
  42. if pin is not None:
  43. if not isinstance(pin, (list, dict)):
  44. raise RuntimeStoreError('invalid_params')
  45. if isinstance(pin, list) and not all(isinstance(n, str) and 0 < len(n) <= 256 for n in pin):
  46. raise RuntimeStoreError('invalid_params')
  47. # ``delegation_backend``: the backend the pinned delegate_task was built from (agent/delegation_backends.py).
  48. backend = pin.get('delegation_backend', '') if isinstance(pin, dict) else ''
  49. if isinstance(pin, dict) and (not {'version', 'tools'} <= set(pin) <= {'version', 'tools', 'delegation_backend'}
  50. or not isinstance(pin['version'], str) or not isinstance(pin['tools'], list)
  51. or not isinstance(backend, str) or len(backend) > 64):
  52. raise RuntimeStoreError('invalid_params')
  53. encoded = None if pin is None else json.dumps(pin)
  54. if encoded is not None and len(encoded) > 4 * 1024 * 1024:
  55. raise RuntimeStoreError('invalid_params')
  56. conn.execute('UPDATE sessions SET tool_names=? WHERE id=?',
  57. (db._store_system_prompt(conn, encoded), session_id))
  58. db._delete_unreferenced_system_prompts(conn)
  59. return {'value': None}
  60. def worker_tail_role(db, conn, session_id, payload):
  61. """``SessionDB.latest_conversation_role`` on the receipt connection (failed-turn boundary)."""
  62. if payload:
  63. raise RuntimeStoreError('invalid_params')
  64. row = conn.execute("SELECT role FROM messages WHERE session_id=? AND active=1 "
  65. "AND role NOT IN ('session_meta','system') ORDER BY id DESC LIMIT 1", (session_id,)).fetchone()
  66. return {'value': row[0] if row else None}
  67. def worker_row_role(db, conn, session_id, payload):
  68. """``SessionDB.get_message_role``: the role of an active row of THIS transcript, else None."""
  69. if set(payload) != {'row_id'} or type(payload['row_id']) is not int:
  70. raise RuntimeStoreError('invalid_params')
  71. row = conn.execute('SELECT role FROM messages WHERE id=? AND session_id=? AND active=1',
  72. (payload['row_id'], session_id)).fetchone()
  73. return {'value': row[0] if row else None}