RongJie G 06c827903a
feat(persistence): add expand-phase thread incarnation storage (#5216)
* feat(persistence): expand thread incarnation storage

Add nullable thread and MCP task incarnation columns while preserving mixed-version writes. New thread records receive stable incarnation IDs, and new task rows copy the matching owned or shared thread incarnation without changing any read, claim, session, or deletion behavior.

* test(persistence): pin incarnation rollback compatibility

* test(api): pin internal thread response boundary

* fix(persistence): rebase incarnation rollout after projects

---------

Co-authored-by: CorgiBoyG <CorgiBoyG@users.noreply.github.com>
2026-09-09 15:52:09 +08:00

82 lines
4.8 KiB
Python

from __future__ import annotations
from datetime import UTC, datetime
from typing import Any
from sqlalchemy import JSON, Boolean, DateTime, Index, Integer, String, Text, UniqueConstraint, false
from sqlalchemy.orm import Mapped, mapped_column
from deerflow.constants import (
MCP_TASK_NAME_MAX_LENGTH,
MCP_TASK_REMOTE_ID_MAX_LENGTH,
MCP_TASK_SERVER_NAME_MAX_LENGTH,
)
from deerflow.persistence.base import Base
class McpTaskRow(Base):
__tablename__ = "mcp_tasks"
id: Mapped[str] = mapped_column(String(64), primary_key=True)
user_id: Mapped[str] = mapped_column(String(64), index=True)
thread_id: Mapped[str] = mapped_column(String(64), index=True)
thread_incarnation: Mapped[str | None] = mapped_column(String(32), nullable=True)
run_id: Mapped[str | None] = mapped_column(String(64), nullable=True)
tool_call_id: Mapped[str | None] = mapped_column(String(128), nullable=True)
server_name: Mapped[str] = mapped_column(String(MCP_TASK_SERVER_NAME_MAX_LENGTH))
driver_name: Mapped[str] = mapped_column(String(64))
remote_task_id: Mapped[str] = mapped_column(String(MCP_TASK_REMOTE_ID_MAX_LENGTH))
task_name: Mapped[str] = mapped_column(String(MCP_TASK_NAME_MAX_LENGTH))
status: Mapped[str] = mapped_column(String(32), index=True)
result: Mapped[Any | None] = mapped_column(JSON, nullable=True)
result_preview: Mapped[str | None] = mapped_column(Text, nullable=True)
result_truncated: Mapped[bool] = mapped_column(Boolean, default=False, server_default=false())
result_artifact: Mapped[dict[str, str] | None] = mapped_column(JSON, nullable=True)
error: Mapped[str | None] = mapped_column(Text, nullable=True)
input_required: Mapped[dict[str, Any] | None] = mapped_column(JSON, nullable=True)
driver_data: Mapped[dict[str, Any]] = mapped_column(JSON, default=dict)
notification_status: Mapped[str] = mapped_column(String(16), default="none", index=True)
event_fingerprint: Mapped[str | None] = mapped_column(String(64), nullable=True)
event_version: Mapped[int] = mapped_column(Integer, default=0, server_default="0")
notified_version: Mapped[int] = mapped_column(Integer, default=0, server_default="0")
dispatch_version: Mapped[int | None] = mapped_column(Integer, nullable=True)
dispatch_attempt: Mapped[int] = mapped_column(Integer, default=0, server_default="0")
dispatch_event: Mapped[dict[str, Any] | None] = mapped_column(JSON, nullable=True)
notification_run_id: Mapped[str | None] = mapped_column(String(64), nullable=True)
notification_error: Mapped[str | None] = mapped_column(Text, nullable=True)
notification_attempt_count: Mapped[int] = mapped_column(Integer, default=0, server_default="0")
next_notification_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
notification_lease_owner: Mapped[str | None] = mapped_column(String(128), nullable=True)
notification_lease_expires_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
next_poll_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), index=True, nullable=True)
last_polled_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
last_poll_error: Mapped[str | None] = mapped_column(Text, nullable=True)
poll_attempt_count: Mapped[int] = mapped_column(Integer, default=0)
consecutive_poll_error_count: Mapped[int] = mapped_column(Integer, default=0)
lease_owner: Mapped[str | None] = mapped_column(String(128), nullable=True)
lease_expires_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
cancel_requested_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
cancel_attempt_count: Mapped[int] = mapped_column(Integer, default=0, server_default="0")
next_cancel_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
last_cancel_error: Mapped[str | None] = mapped_column(Text, nullable=True)
completed_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=lambda: datetime.now(UTC))
updated_at: Mapped[datetime] = mapped_column(
DateTime(timezone=True),
default=lambda: datetime.now(UTC),
onupdate=lambda: datetime.now(UTC),
)
__table_args__ = (
UniqueConstraint(
"user_id",
"server_name",
"remote_task_id",
name="uq_mcp_tasks_user_server_remote",
),
Index("ix_mcp_tasks_thread_created", "thread_id", "created_at"),
Index("ix_mcp_tasks_due", "status", "next_poll_at"),
Index("ix_mcp_tasks_notification_due", "notification_status", "next_notification_at"),
Index("ix_mcp_tasks_cancel_due", "cancel_requested_at", "next_cancel_at"),
)