AgentContext

@dataclass
class AgentContext:
    env: dict[str, str] = field(default_factory=dict)
    config: dict = field(default_factory=dict)
    session: SessionData | None = None
    output_schema: dict | None = None
    tools: Tools = field(default_factory=_uninitialized_tools)
    llm: Llm = field(default_factory=_uninitialized_llm)
    http: Http = field(default_factory=_uninitialized_http)
    stream: StreamEmitter = field(default_factory=_uninitialized_stream)

api_key = ctx.env["ANTHROPIC_API_KEY"]  # Raises KeyError if not set
debug = ctx.env.get("DEBUG", "false")   # Safe access with default

platform_url = ctx.config.get("platformUrl", "http://localhost:18080")
skills = ctx.config.get("skills", [])

@dataclass
class SessionData:
    id: str            # Session identifier
    workspace_id: str  # Space identifier
    user_id: str       # User identifier
    datetime: str      # ISO format timestamp

if ctx.output_schema:
    # Use structured generation
    result = ctx.llm.generate_object(..., schema=ctx.output_schema)
else:
    # Standard text generation
    result = ctx.llm.generate(...)

from friday_agent_sdk import agent, ok

@agent(id="safe", version="1.0.0", description="Handles missing capabilities")
def execute(prompt, ctx):
    # Safe access with fallbacks
    api_key = ctx.env.get("OPTIONAL_KEY")  # Returns None if missing

    # Required access with check
    if "REQUIRED_KEY" not in ctx.env:
        return err("REQUIRED_KEY not set. Connect in Friday Link.")

    # Capability availability - capabilities are always present
    # They raise RuntimeError if called outside the host environment
    if ctx.output_schema:
        # Structured path
        result = ctx.llm.generate_object(...)
    else:
        # Standard path
        result = ctx.llm.generate(...)

    # Progress emission - always safe to call
    ctx.stream.progress("Working...")

    return ok({"result": result.text})