Totoro b0bca9dcb4
feat(mcp): bind HTTP tool credentials to approved custom agents (#8242)
* feat(mcp): bind agent credentials to approved definitions

* fix(mcp): enforce live auth policy and pin task destinations

---------

Co-authored-by: Totoro-qaq <279883115+Totoro-qaq@users.noreply.github.com>
2026-11-14 22:10:33 +08:00

35 lines
1.6 KiB
Python

"""Private runtime context keys shared across DeerFlow runtime components."""
from collections.abc import Mapping
from typing import Final
CURRENT_RUN_PRE_EXISTING_MESSAGE_IDS_KEY: Final[str] = "__deerflow_pre_run_message_ids"
# Server-authored checkpoint metadata that binds materialized state to the
# agent policy which produced it. The sentinel is intentionally not a valid
# custom-agent name, so a missing/invalid legacy value cannot be confused with
# the default agent and accidentally authorize a memory write.
CHECKPOINT_AGENT_NAME_METADATA_KEY: Final[str] = "deerflow_agent_name"
DEFAULT_AGENT_NAME_METADATA_VALUE: Final[str] = "__default__"
# Server-owned pinned project snapshot for a run, resolved once at admission
# (spec §7.1). Holds ``{project_id, name, instructions, shelf, shelf_hash}``.
# Clients can never supply it: it is popped from both run-config sections at
# Gateway admission and refused by the run worker's runtime-context merge.
PROJECT_CONTEXT_KEY: Final[str] = "__deerflow_project_context"
AGENT_AUTH_CONTEXT_KEY: Final[str] = "__deerflow_mcp_agent_authority"
def checkpoint_agent_binding_metadata(metadata: object) -> dict[str, str]:
"""Copy a checkpoint's server-authored agent binding for a state rewrite.
Callers must pass persisted checkpoint metadata, never request metadata.
Missing or malformed values remain unbound so memory writes fail closed.
"""
if not isinstance(metadata, Mapping):
return {}
value = metadata.get(CHECKPOINT_AGENT_NAME_METADATA_KEY)
if not isinstance(value, str) or not value:
return {}
return {CHECKPOINT_AGENT_NAME_METADATA_KEY: value}