session.py 3.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394
  1. """Session management — conversation history with JSONL persistence."""
  2. from __future__ import annotations
  3. import json
  4. from dataclasses import dataclass, field
  5. from datetime import datetime
  6. from pathlib import Path
  7. from typing import Any
  8. @dataclass
  9. class Session:
  10. """A single conversation session."""
  11. key: str
  12. messages: list[dict[str, Any]] = field(default_factory=list)
  13. created_at: datetime = field(default_factory=datetime.now)
  14. updated_at: datetime = field(default_factory=datetime.now)
  15. def get_history(self, max_messages: int = 100) -> list[dict[str, Any]]:
  16. """Return recent messages, aligned to start on a user turn."""
  17. sliced = self.messages[-max_messages:]
  18. # Drop leading non-user messages to avoid orphaned tool results
  19. for i, m in enumerate(sliced):
  20. if m.get("role") == "user":
  21. sliced = sliced[i:]
  22. break
  23. out: list[dict[str, Any]] = []
  24. for m in sliced:
  25. entry: dict[str, Any] = {"role": m["role"], "content": m.get("content", "")}
  26. for k in ("tool_calls", "tool_call_id", "name"):
  27. if k in m:
  28. entry[k] = m[k]
  29. out.append(entry)
  30. return out
  31. def clear(self) -> None:
  32. self.messages.clear()
  33. self.updated_at = datetime.now()
  34. class SessionManager:
  35. """Manages sessions persisted as JSONL files."""
  36. def __init__(self, workspace: Path):
  37. self._dir = workspace / "sessions"
  38. self._dir.mkdir(parents=True, exist_ok=True)
  39. self._cache: dict[str, Session] = {}
  40. def get_or_create(self, key: str) -> Session:
  41. if key in self._cache:
  42. return self._cache[key]
  43. session = self._load(key) or Session(key=key)
  44. self._cache[key] = session
  45. return session
  46. def save(self, session: Session) -> None:
  47. path = self._path(session.key)
  48. with open(path, "w", encoding="utf-8") as f:
  49. meta = {
  50. "_type": "metadata",
  51. "key": session.key,
  52. "created_at": session.created_at.isoformat(),
  53. "updated_at": session.updated_at.isoformat(),
  54. }
  55. f.write(json.dumps(meta, ensure_ascii=False) + "\n")
  56. for msg in session.messages:
  57. f.write(json.dumps(msg, ensure_ascii=False) + "\n")
  58. self._cache[session.key] = session
  59. # ------------------------------------------------------------------
  60. def _path(self, key: str) -> Path:
  61. safe = key.replace(":", "_").replace("/", "_")
  62. return self._dir / f"{safe}.jsonl"
  63. def _load(self, key: str) -> Session | None:
  64. path = self._path(key)
  65. if not path.exists():
  66. return None
  67. try:
  68. messages, created = [], None
  69. for line in path.read_text(encoding="utf-8").splitlines():
  70. if not line.strip():
  71. continue
  72. data = json.loads(line)
  73. if data.get("_type") == "metadata":
  74. created = datetime.fromisoformat(data["created_at"]) if data.get("created_at") else None
  75. else:
  76. messages.append(data)
  77. return Session(key=key, messages=messages, created_at=created or datetime.now())
  78. except Exception:
  79. return None