diff --git a/backend/app/api/agent.py b/backend/app/api/agent.py index e5ddb84f..a060c079 100644 --- a/backend/app/api/agent.py +++ b/backend/app/api/agent.py @@ -1644,7 +1644,9 @@ async def read_agent_file( summary="Update agent file", description=( "Write content to an agent markdown file and persist it for reprovisioning.\n\n" - "Use this when agent configuration files need updates." + "Use this when agent configuration files need updates. While this endpoint can " + "handle SOUL.md, prefer the dedicated SOUL endpoint for better semantic clarity " + "and specialized SOUL operations." ), operation_id="agent_lead_update_file", responses={ @@ -1669,11 +1671,11 @@ async def read_agent_file( openapi_extra={ "x-llm-intent": "agent_file_authoring", "x-when-to-use": [ - "Update agent configuration files like IDENTITY.md or BOOTSTRAP.md", + "Update agent configuration files like IDENTITY.md, BOOTSTRAP.md, or AGENTS.md", "Import existing agent files into mission control", ], "x-when-not-to-use": [ - "Use dedicated SOUL endpoint for SOUL.md updates", + "Prefer dedicated SOUL endpoint for SOUL.md (though this endpoint can handle it)", "Use task comments for transient guidance", ], "x-required-actor": "board_lead", diff --git a/backend/app/schemas/agent_files.py b/backend/app/schemas/agent_files.py index 438b65f8..928e27e4 100644 --- a/backend/app/schemas/agent_files.py +++ b/backend/app/schemas/agent_files.py @@ -54,34 +54,6 @@ class AgentFileUpdate(SQLModel): ) -class AgentFileImport(SQLModel): - """Request model for importing an agent file.""" - - model_config = SQLModelConfig( - json_schema_extra={ - "x-llm-intent": "agent_file_import", - "x-when-to-use": [ - "Import existing agent markdown file into mission control", - "Upload IDENTITY.md, SOUL.md, or other agent files", - ], - }, - ) - - name: str = Field( - description="File name (e.g., IDENTITY.md, SOUL.md, BOOTSTRAP.md)", - examples=["IDENTITY.md", "SOUL.md"], - ) - content: str = Field( - description="File content to import", - examples=["# IDENTITY.md\n\n## Core\n- Name: Agent Name"], - ) - reason: str | None = Field( - default=None, - description="Optional reason for the import", - examples=["Importing existing agent configuration"], - ) - - class AgentFileListItem(SQLModel): """Agent file list item."""