feat(maf): add secure roundtable workflow runtime
This commit is contained in:
1 parent
e690475e6e
commit
bd4131b4e2
52 files changed
+10315
-96
No files matched your search
+89
@@ -175,6 +175,13 @@ class MafRoundtableEventRow(Base):
|
||||
__tablename__ = "maf_roundtable_events"
|
||||
__table_args__ = (
|
||||
UniqueConstraint("run_id", "seq", name="uq_maf_events_run_seq"),
|
||||
# Dedup key for at-most-once event persistence. The authoritative
|
||||
# dedup is this DB constraint (survives process restarts) — not the
|
||||
# in-process ``_seen_source_ids`` set, which is only a fast-path cache.
|
||||
# ``source_event_id`` is nullable; rows with NULL are not deduped
|
||||
# (SQL treats NULLs as distinct in a UNIQUE constraint on sqlite /
|
||||
# postgres / mysql), so events without a source id stay append-only.
|
||||
UniqueConstraint("run_id", "source_event_id", name="uq_maf_events_run_source"),
|
||||
)
|
||||
|
||||
id: Mapped[str] = mapped_column(String(64), primary_key=True)
|
||||
@@ -194,6 +201,10 @@ class MafRoundtableEventRow(Base):
|
||||
event_type: Mapped[str] = mapped_column(String(64), nullable=False, index=True)
|
||||
agent_id: Mapped[str | None] = mapped_column(String(64), nullable=True, index=True)
|
||||
turn_index: Mapped[int | None] = mapped_column(Integer, nullable=True)
|
||||
# Upstream identity of the source runtime event (e.g. LangGraph message id
|
||||
# / tool_call id). Used by the ``(run_id, source_event_id)`` unique
|
||||
# constraint for durable at-most-once dedup across restarts.
|
||||
source_event_id: Mapped[str | None] = mapped_column(String(191), nullable=True, index=True)
|
||||
payload_json: Mapped[dict | None] = mapped_column(PortableJSON(), nullable=True)
|
||||
created_at: Mapped[datetime] = mapped_column(BeijingDateTime(), nullable=False, default=_now, index=True)
|
||||
|
||||
@@ -227,6 +238,11 @@ class MafRoundtableActionRow(Base):
|
||||
agent_id: Mapped[str | None] = mapped_column(String(64), nullable=True, index=True)
|
||||
tool_name: Mapped[str] = mapped_column(String(128), nullable=False, index=True)
|
||||
logical_action_id: Mapped[str | None] = mapped_column(String(128), nullable=True)
|
||||
# The seat turn that produced this action. Persisted (not only embedded in
|
||||
# the idempotency_key) so pending-approval matching can key on
|
||||
# run_id + agent_id + turn_index + logical_action_id precisely — never
|
||||
# mixing a seat's earlier-turn waiting actions into the current approval.
|
||||
turn_index: Mapped[int | None] = mapped_column(Integer, nullable=True)
|
||||
idempotency_key: Mapped[str] = mapped_column(String(191), nullable=False, unique=True)
|
||||
target_key: Mapped[str | None] = mapped_column(String(255), nullable=True, index=True)
|
||||
# R0 | R1 | R2 | R3 | R4
|
||||
@@ -280,11 +296,84 @@ class MafRoundtableApprovalRow(Base):
|
||||
)
|
||||
|
||||
|
||||
# ── 7. seat runs (Phase 2: MAF↔DeerFlow run mapping) ─────────────────────
|
||||
|
||||
|
||||
class MafRoundtableSeatRunRow(Base):
|
||||
"""Persistent mapping between a MAF workflow seat turn and its DeerFlow run.
|
||||
|
||||
Replaces the in-memory ``_active_runs`` dict so that after a service restart
|
||||
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.
|
||||
"""
|
||||
|
||||
__tablename__ = "maf_roundtable_seat_runs"
|
||||
__table_args__ = (
|
||||
UniqueConstraint("maf_run_id", "agent_id", "turn_index", name="uq_maf_seat_runs_run_agent_turn"),
|
||||
)
|
||||
|
||||
id: Mapped[str] = mapped_column(String(64), primary_key=True)
|
||||
maf_run_id: Mapped[str] = mapped_column(
|
||||
String(64), ForeignKey("maf_roundtable_runs.id", ondelete="CASCADE"), nullable=False, index=True
|
||||
)
|
||||
agent_id: Mapped[str] = mapped_column(String(64), nullable=False, index=True)
|
||||
turn_index: Mapped[int] = mapped_column(Integer, nullable=False)
|
||||
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)
|
||||
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)
|
||||
created_at: Mapped[datetime] = mapped_column(BeijingDateTime(), nullable=False, default=_now)
|
||||
updated_at: Mapped[datetime] = mapped_column(
|
||||
BeijingDateTime(), nullable=False, default=_now, onupdate=_now
|
||||
)
|
||||
|
||||
|
||||
# ── 8. action secrets (encrypted actual execution params, server-only) ────
|
||||
|
||||
|
||||
class MafRoundtableActionSecretRow(Base):
|
||||
"""Encrypted actual execution parameters for a protected action.
|
||||
|
||||
Stores the **real** (un-redacted) tool-call arguments so that after
|
||||
approval or a service restart the system can recover and execute the
|
||||
approved action with the original parameters. This table is **never**
|
||||
joined in any read query exposed to the API, events, logs, or frontend —
|
||||
it is server-only. The ActionCoordinator encrypts the payload before
|
||||
writing and decrypts only at execution time.
|
||||
|
||||
One row per action (unique ``action_id``). The encryption key is derived
|
||||
from the deployment's secret key; the ciphertext is opaque to the store.
|
||||
"""
|
||||
|
||||
__tablename__ = "maf_roundtable_action_secrets"
|
||||
__table_args__ = (
|
||||
UniqueConstraint("action_id", name="uq_maf_action_secrets_action"),
|
||||
)
|
||||
|
||||
id: Mapped[str] = mapped_column(String(64), primary_key=True)
|
||||
action_id: Mapped[str] = mapped_column(
|
||||
String(64), ForeignKey("maf_roundtable_actions.id", ondelete="CASCADE"),
|
||||
nullable=False, index=True,
|
||||
)
|
||||
arguments_encrypted: Mapped[str] = mapped_column(PortableLongText, nullable=False)
|
||||
created_at: Mapped[datetime] = mapped_column(BeijingDateTime(), nullable=False, default=_now)
|
||||
|
||||
|
||||
__all__ = [
|
||||
"MafRoundtableActionRow",
|
||||
"MafRoundtableActionSecretRow",
|
||||
"MafRoundtableApprovalRow",
|
||||
"MafRoundtableEventRow",
|
||||
"MafRoundtableParticipantRow",
|
||||
"MafRoundtableRunRow",
|
||||
"MafRoundtableSeatRunRow",
|
||||
"MafRoundtableSessionRow",
|
||||
]
|
||||
Reference in new issue
Block a user