feat(maf): complete resilient roundtable workflow
This commit is contained in:
1 parent
bd4131b4e2
commit
21c4c898e7
23 files changed
+4810
-312
No files matched your search
+37
-3
@@ -30,6 +30,7 @@ from __future__ import annotations
|
||||
from datetime import UTC, datetime
|
||||
|
||||
from sqlalchemy import (
|
||||
CheckConstraint,
|
||||
ForeignKey,
|
||||
Integer,
|
||||
String,
|
||||
@@ -306,13 +307,34 @@ class MafRoundtableSeatRunRow(Base):
|
||||
the system can still locate and cancel outstanding DeerFlow runs, and the
|
||||
MAF checkpoint can reference which seat turns completed.
|
||||
|
||||
Unique constraint: ``(maf_run_id, agent_id, turn_index)`` — one DeerFlow run
|
||||
per seat per turn.
|
||||
Phase-3 unique constraint: ``(maf_run_id, agent_id, turn_index,
|
||||
execution_stage)``. ``turn_index`` is the business round (kept stable for
|
||||
frontend display / approval matching / event tracing); ``execution_stage``
|
||||
disambiguates the distinct DeerFlow executions that happen within one
|
||||
business round (planner / expert / format_repair / cross_review /
|
||||
finalizer / group_chat). The business turn_index is NEVER mutated to dodge
|
||||
a collision.
|
||||
"""
|
||||
|
||||
__tablename__ = "maf_roundtable_seat_runs"
|
||||
__table_args__ = (
|
||||
UniqueConstraint("maf_run_id", "agent_id", "turn_index", name="uq_maf_seat_runs_run_agent_turn"),
|
||||
UniqueConstraint(
|
||||
"maf_run_id",
|
||||
"agent_id",
|
||||
"turn_index",
|
||||
"execution_stage",
|
||||
name="uq_maf_seat_runs_run_agent_turn_stage",
|
||||
),
|
||||
# Phase-3 P1-2: enforce the closed execution_stage enum at the DB layer.
|
||||
# Mirrors seat_runs.VALID_EXECUTION_STAGES — a typo (e.g. "exprt") would
|
||||
# otherwise silently bypass the four-column idempotency key by creating
|
||||
# a brand-new stage. This CHECK keeps both fresh creates and any raw
|
||||
# migration / manual SQL honest. Keep in sync with VALID_EXECUTION_STAGES.
|
||||
CheckConstraint(
|
||||
"execution_stage IN ('legacy','planner','expert','format_repair',"
|
||||
"'cross_review','cross_review_repair','finalizer','group_chat')",
|
||||
name="ck_maf_seat_runs_execution_stage",
|
||||
),
|
||||
)
|
||||
|
||||
id: Mapped[str] = mapped_column(String(64), primary_key=True)
|
||||
@@ -321,12 +343,24 @@ class MafRoundtableSeatRunRow(Base):
|
||||
)
|
||||
agent_id: Mapped[str] = mapped_column(String(64), nullable=False, index=True)
|
||||
turn_index: Mapped[int] = mapped_column(Integer, nullable=False)
|
||||
# Phase-3: which kind of DeerFlow execution this row represents. Pre-Phase-3
|
||||
# rows are migrated to ``legacy``. Closed enum (see seat_runs.VALID_EXECUTION_STAGES):
|
||||
# planner | expert | format_repair | cross_review | cross_review_repair |
|
||||
# finalizer | group_chat | legacy.
|
||||
execution_stage: Mapped[str] = mapped_column(
|
||||
String(32), nullable=False, default="legacy", server_default="legacy"
|
||||
)
|
||||
deerflow_run_id: Mapped[str | None] = mapped_column(String(64), nullable=True, index=True)
|
||||
deerflow_thread_id: Mapped[str | None] = mapped_column(String(64), nullable=True)
|
||||
sandbox_id: Mapped[str | None] = mapped_column(String(64), nullable=True)
|
||||
workflow_checkpoint_id: Mapped[str | None] = mapped_column(String(128), nullable=True)
|
||||
# pending | running | completed | failed | cancelled
|
||||
status: Mapped[str] = mapped_column(String(32), default="pending", index=True)
|
||||
# Phase-3 P0-1: a sanitized, replayable snapshot of the SeatResponse written
|
||||
# atomically with the completed transition. Survives a crash that happens
|
||||
# after the seat run is marked completed but before the workflow checkpoint
|
||||
# is persisted, so recovery never needs to re-call DeerFlow.
|
||||
result_snapshot: Mapped[dict | None] = mapped_column(PortableJSON, nullable=True)
|
||||
started_at: Mapped[datetime | None] = mapped_column(BeijingDateTime(), nullable=True)
|
||||
finished_at: Mapped[datetime | None] = mapped_column(BeijingDateTime(), nullable=True)
|
||||
error: Mapped[str | None] = mapped_column(PortableLongText, nullable=True)
|
||||
|
||||
Reference in new issue
Block a user