Skip to content

OSSS.ai.agents.base_agent

OSSS.ai.agents.base_agent

AgentRetryConfig

Configuration for agent retry behavior.

CircuitBreakerState

Simple circuit breaker state for agent execution.

record_success()

Record a successful execution.

record_failure()

Record a failed execution.

can_execute()

Check if execution is allowed.

NodeType

Bases: Enum

Types of nodes in a LangGraph DAG.

NodeInputSchema

Bases: BaseModel

Schema definition for node inputs.

NodeOutputSchema

Bases: BaseModel

Schema definition for node outputs.

LangGraphNodeDefinition

Bases: BaseModel

LangGraph node definition for an agent.

BaseAgent

Bases: ABC

Abstract base class for all agents in the OSSS system.

run_with_retry(context, step_id=None) async

Execute the agent with retry logic, timeout, and circuit breaker pattern.

Guarantees
  • Returns an AgentContext on success
  • Raises AgentExecutionError / AgentTimeoutError / LLMError on failure
  • Never returns None

run(context) abstractmethod async

Execute the agent asynchronously using the provided context.