digraph quickstart {
    rankdir=LR;
    node [shape=box];

    start [label="What data?" shape=diamond];

    customer_list [label="Multiple\ncustomers"];
    customer_single [label="Single\ncustomer"];
    analytics [label="Custom\nanalytics"];
    discover [label="Schema\ndiscovery"];

    list_tool [label="outlit_list_customers" shape=ellipse style=filled fillcolor=lightblue];
    detail_tool [label="outlit_get_customer" shape=ellipse style=filled fillcolor=lightblue];
    query_tool [label="outlit_query" shape=ellipse style=filled fillcolor=lightyellow];
    schema_tool [label="outlit_schema" shape=ellipse style=filled fillcolor=lightgray];

    start -> customer_list -> list_tool;
    start -> customer_single -> detail_tool;
    start -> analytics -> query_tool;
    start -> discover -> schema_tool;
}

// Discover SQL tables and columns
{ "tool": "outlit_schema" }

// Discover available data entities
{ "tool": "outlit_list_entities" }

{
  "tool": "outlit_list_customers",
  "billingStatus": "PAYING",
  "noActivityInLast": "30d",
  "orderBy": "currentMrr",
  "orderDirection": "desc"
}

{
  "tool": "outlit_query",
  "sql": "SELECT billing_status, count(*) as customers, sum(mrr_cents)/100 as mrr_dollars FROM customer_dimensions GROUP BY 1 ORDER BY 3 DESC"
}

{
  "tool": "outlit_query",
  "sql": "SELECT event_type, count(*) FROM events WHERE occurred_at >= now() - INTERVAL 30 DAY GROUP BY 1 ORDER BY 2 DESC LIMIT 10"
}

digraph tool_selection {
    rankdir=TB;
    node [shape=box fontsize=10];
    edge [fontsize=9];

    start [label="What do you need?" shape=diamond];

    // First level decisions
    list [label="Browse/filter customers"];
    single [label="Single customer deep dive"];
    aggregate [label="Aggregated metrics"];
    discover [label="Explore schema"];

    // Tool outcomes
    list_customers [label="outlit_list_customers" shape=ellipse style=filled fillcolor=lightblue];
    get_customer [label="outlit_get_customer" shape=ellipse style=filled fillcolor=lightblue];
    get_timeline [label="outlit_get_timeline" shape=ellipse style=filled fillcolor=lightblue];
    get_revenue [label="outlit_get_customer_revenue" shape=ellipse style=filled fillcolor=lightblue];
    query [label="outlit_query (SQL)" shape=ellipse style=filled fillcolor=lightyellow];
    schema [label="outlit_schema" shape=ellipse style=filled fillcolor=lightgray];
    list_entities [label="outlit_list_entities" shape=ellipse style=filled fillcolor=lightgray];

    start -> list [label="segments, at-risk lists"];
    start -> single [label="specific customer"];
    start -> aggregate [label="reports, dashboards, SQL"];
    start -> discover [label="what's available?"];

    list -> list_customers;

    single -> get_customer [label="overview + contacts"];
    single -> get_timeline [label="activity history"];
    single -> get_revenue [label="billing data"];

    aggregate -> query [label="write SQL"];
    aggregate -> schema [label="see columns first"];

    discover -> list_entities;
    discover -> schema;
}

{
  "billingStatus": "PAYING",
  "noActivityInLast": "30d",
  "mrrAbove": 50000,
  "orderBy": "currentMrr",
  "orderDirection": "desc",
  "limit": 25
}

{
  "customer": "acme.com",
  "include": ["contacts", "revenue", "recentTimeline", "behaviorMetrics"],
  "timeframe": "30d"
}

{
  "customer": "cust_123",
  "channels": ["EMAIL", "CALENDAR"],
  "limit": 50
}

{
  "customer": "acme.com",
  "includeAttribution": true,
  "includeBillingHistory": true
}

{
  "tool": "outlit_query",
  "sql": "SELECT billing_status, count(*) as customers, sum(mrr_cents)/100 as mrr FROM customer_dimensions GROUP BY 1"
}

{
  "tool": "outlit_query",
  "sql": "SELECT toDate(occurred_at) as day, count(*) as events FROM events WHERE occurred_at >= now() - INTERVAL 30 DAY GROUP BY 1 ORDER BY 1"
}

{
  "tool": "outlit_query",
  "sql": "SELECT customer_id, customer_domain, count(*) as events FROM events WHERE occurred_at >= now() - INTERVAL 30 DAY GROUP BY 1, 2 ORDER BY 3 DESC LIMIT 25"
}

// All tables
{ "tool": "outlit_schema" }

// Specific table with columns
{ "tool": "outlit_schema", "table": "events" }

{ "tool": "outlit_list_entities" }

{ "tool": "outlit_get_entity_schema", "entity": "customer" }

DISCOVERED → SIGNED_UP → ACTIVATED → ENGAGED → INACTIVE

// First request
{ "tool": "outlit_list_customers", "limit": 25 }

// Response
{
  "items": [...],
  "pagination": {
    "hasMore": true,
    "nextCursor": "eyJsYXN0QWN0aXZpdHlBdCI6Li4ufQ==",
    "total": 156
  }
}

// Next page
{ "tool": "outlit_list_customers", "limit": 25, "cursor": "eyJsYXN0QWN0aXZpdHlBdCI6Li4ufQ==" }