arazzo: 1.0.1
info:
  title: We > Ultrarich — wealth inequality briefing
  version: 1.0.0
  summary: >-
    Discover the available wealth expressions, run a direction-aware them-vs-you comparison, then add a
    purchasing-power lens on the ultrarich side — the three calls behind a quotable inequality briefing.
sourceDescriptions:
  - name: weUltrarich
    url: ../openapi/wegtultrarich-openapi-original.yml
    type: openapi
workflows:
  - workflowId: wealthInequalityBriefing
    summary: Build a quotable them-vs-you briefing from one user wealth and one ultrarich wealth.
    description: >-
      No authentication is required. Step 1 discovers the expression routes at runtime. Step 2 is the
      single call that carries the story — it returns both results plus the direction-aware ratio. Step 3
      adds a second lens on the ultrarich figure alone. Quote the `sentence` fields; branch on `scale`,
      which is null by design when a result is too small to anchor; append the attribution string.
    inputs:
      type: object
      required: [wealthYours, wealthTheirs]
      properties:
        wealthYours:
          type: string
          description: The user's wealth. Plain, formatted or shorthand — words are not valid.
          default: '100000'
        wealthTheirs:
          type: string
          description: The ultrarich wealth to compare against.
          default: '1T'
        spend:
          type: string
          description: Daily spend used by the durationOfDailySpend expression.
          default: '1000'
        typeOfItem:
          type: string
          description: Purchasing-power slug for the third step.
          default: year_of_salary_65k
    steps:
      - stepId: discoverExpressions
        description: List the available wealth-expression routes.
        operationId: expressions
        successCriteria:
          - condition: $statusCode == 200
        outputs:
          routes: $response.body#/data
      - stepId: compareWealths
        description: Compare both wealths through the duration-of-daily-spend lens and get the ratio.
        operationId: comparison
        parameters:
          - name: expression
            in: query
            value: durationOfDailySpend
          - name: wealthYours
            in: query
            value: $inputs.wealthYours
          - name: wealthTheirs
            in: query
            value: $inputs.wealthTheirs
          - name: spend
            in: query
            value: $inputs.spend
        successCriteria:
          - condition: $statusCode == 200
          - context: $response.body
            condition: $.status == "success"
            type: jsonpath
        outputs:
          ratioSentence: $response.body#/data/ratio/sentence
          ratioScale: $response.body#/data/ratio/scale
          theirsSentence: $response.body#/data/resultTheirs/sentence
          yoursSentence: $response.body#/data/resultYours/sentence
      - stepId: purchasingPowerLens
        description: Add a purchasing-power line for the ultrarich wealth.
        operationId: numberOfItems
        parameters:
          - name: wealth
            in: query
            value: $inputs.wealthTheirs
          - name: typeOfItem
            in: query
            value: $inputs.typeOfItem
        successCriteria:
          - condition: $statusCode == 200
        outputs:
          itemsSentence: $response.body#/data/sentence
          itemsScale: $response.body#/data/scale
    outputs:
      ratio: $steps.compareWealths.outputs.ratioSentence
      ratioScale: $steps.compareWealths.outputs.ratioScale
      theirs: $steps.compareWealths.outputs.theirsSentence
      yours: $steps.compareWealths.outputs.yoursSentence
      purchasingPower: $steps.purchasingPowerLens.outputs.itemsSentence
x-attribution: 'Source: We > Ultrarich (wegtultrarich.org).'
x-generated: '2026-08-09'
x-method: generated
x-rate-limit: 100 requests/minute per IP across all of /v1 — this workflow makes 3 calls.