{
  "format_version": "1",
  "case": "japan-geothermal",
  "title": "Japan's geothermal supply curve",
  "question": "How much heat input does the model assign to Japan's second hydrothermal grade?",
  "mode": "recorded",
  "simulation": false,
  "registry_revision": "2026-11-09",
  "generated_at": null,
  "replay_clock": "2026-11-09T00:00:00Z",
  "timestamp_note": "Envelope retrieval timestamps use a fixed replay clock, not publisher retrieval times. Actual fixture capture times appear in the manifest; null means unrecorded.",
  "fixtures": [
    {
      "file": "gcam-economy.json",
      "sha256": "e51120caad276d93a52d9dbf50ea2faa5c298c9ac88f17c3e5f1869be685bb78",
      "captured_at": "2026-11-10T04:46:58.414403+00:00"
    },
    {
      "file": "gcam-power.json",
      "sha256": "7485cdd26030b7c15f0812c534223aca205cba855c96bd61c767668207b9cbc8",
      "captured_at": "2026-11-10T04:46:58.079479+00:00"
    }
  ],
  "answer": "The second grade in GCAM's Japan curve supplies 0.56582 thermal EJ per year of heat input.",
  "limitations": [
    "The quantity is heat input. Electrical output would also require a conversion efficiency."
  ],
  "steps": [
    {
      "tool": "economy.country_regions",
      "args": {
        "filters": {
          "iso": "jpn"
        },
        "rows": 2
      },
      "envelope": {
        "data": {
          "table": "country_regions",
          "columns": [
            "iso",
            "country_name",
            "region_GCAM3",
            "GCAM_region_ID"
          ],
          "records": [
            {
              "row_number": 112,
              "values": {
                "iso": "jpn",
                "country_name": "Japan",
                "region_GCAM3": "Japan",
                "GCAM_region_ID": "19"
              },
              "evidence_ref": "evidence_01"
            }
          ],
          "file_url": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/common/iso_GCAM_regID.csv",
          "source_notes": [
            "File: iso_GCAM_regID.csv",
            "Title: ISO to GCAM region mapping",
            "Units: NA",
            "Description: Maps iso codes to GCAM regions (including composites as necessary)",
            "Column types: ccci",
            "----------"
          ],
          "filters": {
            "iso": "jpn"
          },
          "offset": 0,
          "record_count": 1,
          "total_matches": 1,
          "table_rows": 248,
          "release": "GCAM v9.1"
        },
        "provenance": [
          {
            "id": "source_01",
            "source_id": "gcam-economy",
            "steward": "Pacific Northwest National Laboratory",
            "system": "GCAM: Regional economics",
            "dataset": "iso_GCAM_regID.csv",
            "dataset_version": "GCAM v9.1",
            "authority_level": "primary",
            "access_path": "live",
            "source_updated_at": null,
            "retrieved_at": "2026-11-09T00:00:00Z",
            "cache_age_seconds": 0,
            "citation": {
              "doi": null,
              "recommended": "Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
              "required": true
            }
          }
        ],
        "evidence": [
          {
            "id": "evidence_01",
            "source_ref": "source_01",
            "record_id": "data row 112",
            "locator": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/common/iso_GCAM_regID.csv",
            "retrieved_at": "2026-11-09T00:00:00Z",
            "effective_at": null,
            "transformations": [
              "parse_csv",
              "empty_cell_to_null"
            ],
            "payload_hash": null,
            "raw_recovery": "available"
          }
        ],
        "coverage": {
          "registry": "covered",
          "execution": "complete",
          "pagination": "complete",
          "source_claim": "complete",
          "result": "hit",
          "sources_searched": [
            "gcam-economy"
          ],
          "known_limitations": [
            "Rows are model inputs, not scenario outputs or measurements of current conditions.",
            "GCAM3 region labels and numeric GCAM region IDs use different groupings."
          ]
        },
        "warnings": [
          {
            "code": "citation_required",
            "message": "This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
            "source_id": "gcam-economy"
          }
        ],
        "_execution": {
          "server": "doe-mcp",
          "server_version": "0.1.0.dev0",
          "tool": "economy.country_regions",
          "tool_contract_version": "1",
          "envelope_version": "1",
          "adapters": {
            "osti_family": "1",
            "opendatasoft": "1",
            "json_document": "1",
            "curated": "1",
            "eia_v2": "1",
            "fueleconomy": "1",
            "text_feed": "1",
            "postgrest": "1",
            "federal_register": "1",
            "vips": "1",
            "daymet": "1",
            "essdive": "1",
            "esgf": "1",
            "sage": "1",
            "optimade": "1",
            "basis_sets": "1",
            "facility_status": "1",
            "gcam_csv": "1",
            "nmdc": "1",
            "none": "1",
            "self_registry": "1"
          },
          "registry_revision": "2026-11-09",
          "request_id": "recorded-workflow"
        }
      }
    },
    {
      "tool": "power.geothermal_curves",
      "args": {
        "filters": {
          "grade": "grade 2",
          "region_GCAM3": "Japan"
        },
        "rows": 2
      },
      "envelope": {
        "data": {
          "table": "geothermal_curves",
          "columns": [
            "region_GCAM3",
            "resource",
            "subresource",
            "grade",
            "available",
            "extractioncost"
          ],
          "records": [
            {
              "row_number": 18,
              "values": {
                "region_GCAM3": "Japan",
                "resource": "geothermal",
                "subresource": "hydrothermal",
                "grade": "grade 2",
                "available": "0.56582",
                "extractioncost": "0.569"
              },
              "evidence_ref": "evidence_01"
            }
          ],
          "file_url": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/energy/A16.geo_curves.csv",
          "source_notes": [
            "File: A16.geo_curves.csv",
            "Title: Supply curves of hydrothermal geothermal resources, inherited from GCAM 3.0",
            "Units: available in Thermal EJ/yr (i.e. heat input to geothermal power plants); extractioncost in 1975$/GJ",
            "Description: available: quantity available; extractioncost: costs of production",
            "Reference: Hannam, P., P. Kyle, and S.J. Smith. 2009. Global Deployment of Geothermal Energy Using a New Characterization in GCAM 1.0. PNNL-19231, Pacitic Northwest National Laboratory. http://www.pnl.gov/main/publications/external/technical_reports/PNNL-19231.pdf",
            "Column types: ccccnn",
            "----------"
          ],
          "filters": {
            "grade": "grade 2",
            "region_GCAM3": "Japan"
          },
          "offset": 0,
          "record_count": 1,
          "total_matches": 1,
          "table_rows": 28,
          "release": "GCAM v9.1"
        },
        "provenance": [
          {
            "id": "source_01",
            "source_id": "gcam-power",
            "steward": "Pacific Northwest National Laboratory",
            "system": "GCAM: Power technology",
            "dataset": "A16.geo_curves.csv",
            "dataset_version": "GCAM v9.1",
            "authority_level": "primary",
            "access_path": "live",
            "source_updated_at": null,
            "retrieved_at": "2026-11-09T00:00:00Z",
            "cache_age_seconds": 0,
            "citation": {
              "doi": null,
              "recommended": "Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
              "required": true
            }
          }
        ],
        "evidence": [
          {
            "id": "evidence_01",
            "source_ref": "source_01",
            "record_id": "data row 18",
            "locator": "https://raw.githubusercontent.com/JGCRI/gcam-core/11e128fb7ce3e14e9c4daf3903ba73123046a7aa/input/gcamdata/inst/extdata/energy/A16.geo_curves.csv",
            "retrieved_at": "2026-11-09T00:00:00Z",
            "effective_at": null,
            "transformations": [
              "parse_csv",
              "empty_cell_to_null"
            ],
            "payload_hash": null,
            "raw_recovery": "available"
          }
        ],
        "coverage": {
          "registry": "covered",
          "execution": "complete",
          "pagination": "complete",
          "source_claim": "complete",
          "result": "hit",
          "sources_searched": [
            "gcam-power"
          ],
          "known_limitations": [
            "Rows are model inputs, not scenario outputs or measurements of current conditions.",
            "GCAM3 region labels and numeric GCAM region IDs use different groupings."
          ]
        },
        "warnings": [
          {
            "code": "citation_required",
            "message": "This publisher requires citation as a condition of use. Cite: Joint Global Change Research Institute, Pacific Northwest National Laboratory. GCAM v9.1, gcamdata. Cite the specific input file and retain its source notes.",
            "source_id": "gcam-power"
          }
        ],
        "_execution": {
          "server": "doe-mcp",
          "server_version": "0.1.0.dev0",
          "tool": "power.geothermal_curves",
          "tool_contract_version": "1",
          "envelope_version": "1",
          "adapters": {
            "osti_family": "1",
            "opendatasoft": "1",
            "json_document": "1",
            "curated": "1",
            "eia_v2": "1",
            "fueleconomy": "1",
            "text_feed": "1",
            "postgrest": "1",
            "federal_register": "1",
            "vips": "1",
            "daymet": "1",
            "essdive": "1",
            "esgf": "1",
            "sage": "1",
            "optimade": "1",
            "basis_sets": "1",
            "facility_status": "1",
            "gcam_csv": "1",
            "nmdc": "1",
            "none": "1",
            "self_registry": "1"
          },
          "registry_revision": "2026-11-09",
          "request_id": "recorded-workflow"
        }
      }
    }
  ]
}