mirror of
https://github.com/Sea-Haven-Industries/open-swe.git
synced 2026-09-30 08:03:15 +00:00
c03a6be7a8
Co-authored-by: Ramon Nogueira <270434257+ramon-langchain@users.noreply.github.com> Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
69 lines
2.6 KiB
Python
69 lines
2.6 KiB
Python
"""Tool: ``save_plan``. Record the implementation plan for review.
|
|
|
|
Writes the plan as a real ``plan.md`` file in the sandbox (the artifact the
|
|
agent produces and can re-read) and publishes it to the plan-review page, where
|
|
the user and collaborators read it, comment inline, and approve or request
|
|
changes. Available in plan mode (it does not modify the repository under review).
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import logging
|
|
from typing import Any
|
|
|
|
from langgraph.config import get_config
|
|
|
|
from ..dashboard.plan_store import (
|
|
PLAN_STATUS_READY,
|
|
save_plan_content,
|
|
write_plan_to_sandbox,
|
|
)
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
async def save_plan(plan_markdown: str) -> dict[str, Any]:
|
|
"""Write your implementation plan as a markdown file and publish it for review.
|
|
|
|
Use this in plan mode once your plan is ready. The plan is saved as
|
|
``plan.md`` in the sandbox and published to the plan-review page linked in
|
|
the conversation, where the user (the owner) and any collaborators can read
|
|
it, leave inline comments, and then approve it or request changes. Call it
|
|
again to overwrite the plan with a revised version when addressing feedback.
|
|
|
|
Write the plan in standard Markdown — headings, bullet/numbered lists, and
|
|
fenced code blocks all render. Keep it concise and high level, focusing on
|
|
approach, decisions/tradeoffs, risks, and verification; avoid file/function
|
|
details unless they are unusually tricky or controversial.
|
|
|
|
Args:
|
|
plan_markdown: The full plan, as a Markdown document.
|
|
|
|
Returns:
|
|
``{success: True, path}`` on success, or ``{success: False, error}``.
|
|
"""
|
|
content = plan_markdown.strip()
|
|
if not content:
|
|
return {"success": False, "error": "plan_markdown cannot be empty"}
|
|
|
|
try:
|
|
config = get_config()
|
|
except Exception:
|
|
config = {}
|
|
configurable = config.get("configurable", {}) if isinstance(config, dict) else {}
|
|
thread_id = configurable.get("thread_id") if isinstance(configurable, dict) else None
|
|
if not thread_id:
|
|
return {"success": False, "error": "no thread_id in run config"}
|
|
|
|
try:
|
|
path = await _save(str(thread_id), content)
|
|
except Exception as exc: # noqa: BLE001
|
|
logger.exception("save_plan failed for thread %s", thread_id)
|
|
return {"success": False, "error": f"failed to save plan: {exc}"}
|
|
return {"success": True, "path": path}
|
|
|
|
|
|
async def _save(thread_id: str, content: str) -> str:
|
|
sandbox_path = await write_plan_to_sandbox(thread_id, content)
|
|
await save_plan_content(thread_id, markdown=content, status=PLAN_STATUS_READY)
|
|
return sandbox_path
|