runtime_session_lifecycle.py 4.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293
  1. """Explicit lifecycle methods for the assignment-bound worker store.
  2. The owner reserves identity before construction. Closing the local store remains
  3. separate from ending its session and settling execution (including deferred work).
  4. """
  5. class RuntimeSessionLifecycleMixin:
  6. def create_session(self, session_id, source, *, model=None, model_config=None,
  7. system_prompt=None, user_id=None, session_key=None, chat_id=None,
  8. chat_type=None, thread_id=None, parent_session_id=None, cwd=None,
  9. profile_name=None, git_repo_root=None, origin_json=None, display_name=None):
  10. self._session(session_id)
  11. payload = dict(source=source, model=model, model_config=model_config, system_prompt=system_prompt,
  12. user_id=user_id, session_key=session_key, chat_id=chat_id, chat_type=chat_type,
  13. thread_id=thread_id, parent_session_id=parent_session_id, cwd=cwd,
  14. profile_name=profile_name, git_repo_root=git_repo_root,
  15. origin_json=origin_json, display_name=display_name)
  16. return self._apply('session.create', payload)['value']
  17. def set_session_title(self, session_id, title):
  18. self._session(session_id)
  19. return self._title_result(self._apply('session.title', {'title': title, 'source': 'user'}))
  20. def set_auto_title(self, session_id, title, *, source):
  21. if source not in ('derived', 'llm'):
  22. raise ValueError(f'invalid automatic title source: {source!r}')
  23. self._session(session_id)
  24. return self._title_result(self._apply('session.title', {'title': title, 'source': source}))
  25. @staticmethod
  26. def _title_result(result):
  27. if result.get('error'):
  28. raise ValueError(result['error'])
  29. return result['value']
  30. def get_session_title_source(self, session_id):
  31. row = self.get_session(session_id)
  32. return row.get('title_source') if row.get('title') is not None else None
  33. def set_session_title_source(self, session_id, source):
  34. if source not in ('user', 'derived', 'llm'):
  35. raise ValueError(f'invalid title source: {source!r}')
  36. self._session(session_id)
  37. return self._apply('session.title_source', {'source': source})['value']
  38. def get_next_title_in_lineage(self, base_title):
  39. return self._apply('session.next_title', {'base_title': base_title})['value']
  40. def touch_session_activity(self, session_id, ts=None, *, description=None, provenance=None):
  41. self._session(session_id)
  42. self._apply('session.activity', {'ts': ts, 'description': description, 'provenance': provenance})
  43. def clear_session_activity_labels(self, session_id):
  44. self._session(session_id)
  45. self._apply('session.activity_clear', {})
  46. def update_session_billing_route(self, session_id, *, provider, base_url, billing_mode=None):
  47. self._session(session_id)
  48. # Every preceding usage call already owns a receipt. _apply refuses a
  49. # pending or failed delta, so a route switch cannot overtake accounting.
  50. self._apply('session.billing_route', {'provider': provider, 'base_url': base_url,
  51. 'billing_mode': billing_mode})
  52. def set_latest_user_api_content(self, session_id, content, api_content):
  53. self._session(session_id)
  54. return self._apply('session.api_content', {'content': content, 'api_content': api_content})['value']
  55. # The turn prologue's row-addressed backfills (agent/turn_context.py) for a user row another
  56. # writer materialized first (in-place preflight compaction, an early flush, a submit-time row).
  57. def set_message_api_content(self, session_id, row_id, content, api_content):
  58. self._session(session_id)
  59. return self._apply('session.message_api_content',
  60. {'row_id': row_id, 'content': content, 'api_content': api_content})['value']
  61. def set_user_message_content(self, session_id, row_id, content, display_metadata=None):
  62. self._session(session_id)
  63. payload = {'row_id': row_id, 'content': content}
  64. if display_metadata is not None:
  65. payload['display_metadata'] = display_metadata
  66. return self._apply('session.user_content', payload)['value']
  67. def end_session(self, session_id, end_reason):
  68. self._session(session_id)
  69. self._apply('session.end', {'end_reason': end_reason})
  70. def session_lifecycle_statuses(self, session_ids):
  71. ids = [sid for sid in (session_ids or []) if sid]
  72. for sid in ids:
  73. self._session(sid)
  74. if not ids:
  75. return {}
  76. return {self.scope['session_id']: self._apply('session.lifecycle', {})['value']}