Agent Team profile、runtime 与共享工作区 深度解析

48def resolve_reporter_enabled(
49    profile: dict[str, Any] | None,
50    *,
51    pipeline_id: str,
52    profile_name: str | None,
53) -> bool:
54    """Return the effective agent-team reporter switch.
55
56    Both agent-team specs use the profile flag.  The report-named pipeline and
57    profile retain their historical default-on behaviour only when the merged
58    profile does not explicitly contain ``agent.reporter``.
59    """
60    agent_cfg = (profile or {}).get("agent") or {}
61    reporter_default = (
62        pipeline_id in ("agent_team_report", "agent-team-report")
63        or profile_name == "agent_team_report"
64    )
65    return bool(agent_cfg.get("reporter", reporter_default))
66
67
68def resolve_reporter_backend(profile: dict[str, Any] | None) -> str:
69    """Resolve the backend name while keeping the future-backend seam stable.
70
71    Fast is the only shipped backend and remains the safe default. Compatibility
72    aliases resolve here so the dispatcher can return an actionable error.
73    """
74    agent_cfg = (profile or {}).get("agent") or {}
75    raw = str(agent_cfg.get("reporter_backend") or REPORTER_BACKEND_FAST)
76    normalized = raw.strip().lower().replace("-", "_")
77    backend = _REPORTER_BACKEND_ALIASES.get(normalized)
78    if backend is not None:
79        return backend
80    logger.warning(
81        "Unknown agent.reporter_backend=%r; using %s",
82        raw,
83        REPORTER_BACKEND_FAST,
84    )
85    return REPORTER_BACKEND_FAST

72def render_sandbox_fs_note(
73    *,
74    sandbox_mode: str,
75    inputs_available: bool,
76    audience: str,
77) -> str:
78    """Render truthful filesystem context for the active sandbox topology."""
79    shared = sandbox_mode in ("container", "native")
80    location = "this native workspace" if sandbox_mode == "native" else "this container"
81    workspace_path = (
82        os.environ.get("FRONTIER_AGENT_WORKSPACE_DIR", "the workspace")
83        if sandbox_mode == "native" else "/workspace"
84    )
85    inputs_path = (
86        os.environ.get("FRONTIER_AGENT_INPUTS_DIR", "the inputs directory")
87        if sandbox_mode == "native" else "/inputs"
88    )
89    outputs_path = (
90        os.environ.get("FRONTIER_AGENT_OUTPUTS_DIR", "the outputs directory")
91        if sandbox_mode == "native" else "/outputs"
92    )
93    project_path = os.environ.get("FRONTIER_AGENT_PROJECT_DIR", "").strip()
94    if audience == "sub":
95        workspace = (
96            f"{workspace_path} is shared by the coordinator and all sub-agents in "
97            f"{location}; use distinctive subdirectories and never assume "
98            "unlabelled files are yours."
99            if shared
100            else f"{workspace_path} is private to this sub-agent."
101        )
102    else:
103        workspace = (
104            f"{workspace_path} is shared by the coordinator and all sub-agents in "
105            f"{location}."
106            if shared
107            else f"{workspace_path} contains the coordinator worktree and the "
108            "sub-agents' private worktree directories."
109        )
110    inputs = (
111        f"Task input files are available under {inputs_path}."
112        if inputs_available

175_SUBAGENT_NO_TOOL_NUDGE = (
176    "Every turn must end with a tool call. When you have gathered enough "
177    "evidence, call `submit_report` with your Scope/Finding/Evidence report. "
178    "Otherwise call a data-gathering tool (web_search, web_fetch, read_file, "
179    "bash). Do not reply in plain text."
180)
181_SUBAGENT_FINALIZATION_MESSAGE = (
182    "Your assignment is entering its finalization reserve. Stop new "
183    "exploration. Finish and validate the best current artifact in /workspace; "
184    "if this assignment has publish permission, publish exactly its declared "
185    "/outputs manifest. Then call `submit_report` with concrete findings and "
186    "file paths. Submit a useful partial report even if some work remains."
187)
188_RECOVERY_NUDGE_PREFIXES = (
189    # This workflow's own sub-agent control messages, on top of the framework set.
190    _SUBAGENT_NO_TOOL_NUDGE,
191    _SUBAGENT_FINALIZATION_MESSAGE,
192    "[stop signal] The coordinator has asked you to STOP immediately.",
193    *COMMON_RECOVERY_NUDGE_PREFIXES,
194)