SurfSense/surfsense_backend/app/automations/schemas/actions/agent_task.py
CREDO23 f0e00bd3ee chore(automation): trim docstrings to intent only
Cut the docstrings and Field(description=...) text across the entire
automations/ tree down to single-line intent statements, matching the
multi_agent_chat conciseness style:

- Module docstrings: one line stating what the file is.
- Class docstrings: deleted when the class name + module docstring
  already cover intent; kept only where they add a constraint or
  rationale not visible in the signature.
- Pydantic Field descriptions: short noun phrases / clauses, not
  full sentences. Reasoning that belonged in the design plan moved
  out of the code.
- Enum values: per-value docstrings replaced with terse inline
  comments where the meaning isn't obvious from the name.

Behaviour is unchanged. The same 33 files, same public surface, same
imports — verified by re-running the 10-point registry smoke test and
the 8-point schema round-trip / constraint suite from commits 9 and
10.

LOC: 1180 → 691 (-42%).
2026-05-26 23:01:22 +02:00

27 lines
886 B
Python

"""``AgentTaskActionConfig`` — config for the ``agent_task`` action type."""
from __future__ import annotations
from typing import Any
from pydantic import BaseModel, ConfigDict, Field
class AgentTaskActionConfig(BaseModel):
"""Run a LangGraph Deep Agent restricted to a scoped capability list."""
model_config = ConfigDict(extra="forbid")
prompt: str = Field(..., min_length=1, description="Task prompt; Jinja-rendered.")
tools: list[str] = Field(
default_factory=list,
description="Capability IDs the agent may call. Empty = no tool access.",
)
model: str | None = Field(
default=None,
description="LiteLLM model id. Defaults to the search space's agent_llm_id.",
)
output_schema: dict[str, Any] | None = Field(
default=None,
description="JSON Schema the agent must return. Recommended.",
)