sync update from LAN repo (source dhk-1 @ 3e87be55)

This commit is contained in:
gozeros committed 2026-10-21 15:06:08 +08:00
1 parent ab6068a7c1
commit 42f2a26fa8
1482 files changed
+227759 -9584

No files matched your search

@@ -1,38 +1,52 @@
"""ORM model for user feedback on runs."""
"""ORM model for user feedback on assistant answers."""
from __future__ import annotations
from datetime import UTC, datetime
from sqlalchemy import Index, String, Text
from sqlalchemy.orm import Mapped, mapped_column
from deerflow.persistence.base import Base
from deerflow.persistence.types import BeijingDateTime
from sqlalchemy import Index, String, Text
from sqlalchemy.orm import Mapped, mapped_column
from deerflow.persistence.base import Base
from deerflow.persistence.types import BeijingDateTime, PortableJSON
class FeedbackRow(Base):
__tablename__ = "feedback"
# Prefix-unique instead of UniqueConstraint: a plain unique over three
# String(64) columns is (64+64+64)*4 = 768 bytes — one byte over MySQL's
# legacy 767-byte index limit (utf8mb4). Capping user_id's key part at 63
# chars (ids are 36-char UUIDs in practice) brings it to 764 bytes.
# mysql_length is ignored on SQLite/Postgres.
__table_args__ = (Index("uq_feedback_thread_run_user", "thread_id", "run_id", "user_id", unique=True, mysql_length={"user_id": 63}),)
class FeedbackRow(Base):
__tablename__ = "feedback"
# ``target_key`` is a SHA-256 digest of user/thread/message/agent. A
# digest keeps the idempotency index well below MySQL's legacy utf8mb4
# key-size limit; indexing all four source strings would exceed it.
__table_args__ = (
Index("uq_feedback_target_key", "target_key", unique=True),
Index("ix_feedback_agent_created", "agent_id", "created_at"),
)
feedback_id: Mapped[str] = mapped_column(String(64), primary_key=True)
run_id: Mapped[str] = mapped_column(String(64), nullable=False, index=True)
thread_id: Mapped[str] = mapped_column(String(64), nullable=False, index=True)
user_id: Mapped[str | None] = mapped_column(String(64), index=True)
message_id: Mapped[str | None] = mapped_column(String(64))
# message_id is an optional RunEventStore event identifier —
# allows feedback to target a specific message or the entire run
thread_id: Mapped[str] = mapped_column(String(64), nullable=False, index=True)
user_id: Mapped[str | None] = mapped_column(String(64), index=True)
message_id: Mapped[str | None] = mapped_column(String(64))
# ``message_id`` is the LangChain/checkpoint message id serialized inside
# a RunEventStore ``llm.ai.response`` event. It stays nullable solely for
# legacy run-level feedback rows created before answer-level feedback.
agent_id: Mapped[str] = mapped_column(String(128), nullable=False, default="lead_agent")
target_key: Mapped[str] = mapped_column(String(64), nullable=False)
rating: Mapped[int] = mapped_column(nullable=False)
# +1 (thumbs-up) or -1 (thumbs-down)
comment: Mapped[str | None] = mapped_column(Text)
# Optional text feedback from the user
created_at: Mapped[datetime] = mapped_column(BeijingDateTime(), default=lambda: datetime.now(UTC))
comment: Mapped[str | None] = mapped_column(Text)
# Optional user detail. The API exposes this as ``detail`` and retains
# ``comment`` as a compatibility alias for older clients.
reasons: Mapped[list[str]] = mapped_column(PortableJSON(), default=list)
# Stable machine-readable reason codes for negative feedback.
created_at: Mapped[datetime] = mapped_column(BeijingDateTime(), default=lambda: datetime.now(UTC))
updated_at: Mapped[datetime] = mapped_column(
BeijingDateTime(),
default=lambda: datetime.now(UTC),
onupdate=lambda: datetime.now(UTC),
)