Find the failure.
Prove the recovery.

from agentic_chaos.chaos import chaos_call, chaos_session

# Outside a session, this is a transparent pass-through
result = llm.complete("What is AI?")

# Inside a session, faults inject
with chaos_session(["token_timeout", "silent_degradation"]):
    try:
        result = chaos_call(llm.complete, "What is AI?", faults=["token_timeout"])
    except TokenTimeoutError:
        # Handle timeout, then retry without the fault
        result = llm.complete("What is AI?")

# That's it. No instrumentation. No framework lock-in.

from agenticlens import profile, step
from agentic_chaos.chaos import chaos_call, chaos_session

with chaos_session(["token_timeout"]) as session:
    with profile("Support Agent") as workflow:
        with step("Retriever"):
            chunks = chaos_call(retriever.search, query, faults=["token_timeout"])

# Merge chaos events into workflow
attach_events(session, workflow)

# agenticlens analyze workflow.json
# → Shows cost/latency + chaos impact together

pip install agentic-chaos

from agentic_chaos.chaos import chaos_call, chaos_session, TokenTimeoutError

with chaos_session(["token_timeout"]):
    try:
        result = chaos_call(
            llm.complete,
            "What is the weather?",
            faults=["token_timeout"]
        )
    except TokenTimeoutError:
        print("LLM timed out—handled gracefully")

agentic-chaos chaos run my_app.py \
  --inject token_timeout,rate_limit_storm,silent_degradation \
  --save chaos_report.json

# Output:
# Chaos Events
# Step         Fault                 Outcome    Message
# ────────────────────────────────────────────────────────
# Retriever    token_timeout         errored    call hung for 2.0s then timed out
# LLMCall      silent_degradation    degraded   output silently degraded

# Saved chaos report to chaos_report.json

{
  "chaos_events": [
    {
      "fault_type": "token_timeout",
      "step_name": "Retriever",
      "outcome": "errored",
      "message": "call hung for 2.0s then timed out"
    }
  ]
}