@burdenoff/mcp-libs 2026.627.4 → 2026.627.5

package/dist/modules/theglobalfuel/index.js

@@ -0,0 +1,1617 @@
+import { mcpToolName, errorResult, jsonResult, mcpResourceUri, mcpPromptName } from '../../chunk-H2OYWLOA.js';
+import { z } from 'zod';
+
+// src/modules/theglobalfuel/operations.ts
+var ASSET_FIELDS = `
+  id name code commodity kind status capacityPerDay capacityUnit
+  workingInterestPct operatorLeadId location latitude longitude
+  commissionedAt decommissionedAt tags workspaceId createdAt updatedAt
+`;
+var PRODUCTION_FIELDS = `
+  id assetId periodStart periodEnd volume unit grade downtimeHours notes
+  workspaceId createdAt updatedAt
+`;
+var RESERVE_FIELDS = `
+  id assetId category recoverable recoveryFactor unit methodology asOfDate
+  notes workspaceId createdAt updatedAt
+`;
+var CONTRACT_FIELDS = `
+  id reference counterparty side commodity status contractedVolume
+  deliveredVolume unit pricePerUnit currency priceIndex pricingBasis
+  deliveryLocation startDate endDate signedAt notes tags workspaceId
+  createdAt updatedAt
+`;
+var SHIPMENT_FIELDS = `
+  id contractId reference status mode volume unit origin destination carrier
+  scheduledAt departedAt deliveredAt notes document { id } workspaceId
+  createdAt updatedAt
+`;
+var INVENTORY_FIELDS = `
+  id lotCode commodity status quantity unit grade unitValue currency
+  location assetId producedAt notes workspaceId createdAt updatedAt
+`;
+var EMISSION_FIELDS = `
+  id assetId scope co2eTonnes periodStart periodEnd source methodology
+  verified verifiedAt notes workspaceId createdAt updatedAt
+`;
+var COMPLIANCE_FIELDS = `
+  id title category status authority certNumber assetId ownerId issuedAt
+  expiresAt notes tags evidence { id } workspaceId createdAt updatedAt
+`;
+var PAGE_INFO_FIELDS = `
+  pageInfo { cursor hasMore }
+`;
+var GET_ASSET = `
+  query TheglobalfuelGetAsset($id: ID!) {
+    theAsset(id: $id) {
+      ${ASSET_FIELDS}
+      productionRecords { id periodStart periodEnd volume unit }
+      reserveEstimates { id category recoverable unit asOfDate }
+    }
+  }
+`;
+var LIST_ASSETS = `
+  query TheglobalfuelListAssets(
+    $commodity: TheCommodityType
+    $kind: TheAssetKind
+    $status: TheAssetStatus
+    $pagination: PaginationInput
+  ) {
+    theListAssets(
+      commodity: $commodity
+      kind: $kind
+      status: $status
+      pagination: $pagination
+    ) {
+      items { ${ASSET_FIELDS} }
+      ${PAGE_INFO_FIELDS}
+    }
+  }
+`;
+var CREATE_ASSET = `
+  mutation TheglobalfuelCreateAsset($input: TheCreateAssetInput!) {
+    theCreateAsset(input: $input) {
+      ${ASSET_FIELDS}
+    }
+  }
+`;
+var UPDATE_ASSET = `
+  mutation TheglobalfuelUpdateAsset($id: ID!, $input: TheUpdateAssetInput!) {
+    theUpdateAsset(id: $id, input: $input) {
+      ${ASSET_FIELDS}
+    }
+  }
+`;
+var TRANSITION_ASSET = `
+  mutation TheglobalfuelTransitionAsset($id: ID!, $status: TheAssetStatus!) {
+    theTransitionAsset(id: $id, status: $status) {
+      ${ASSET_FIELDS}
+    }
+  }
+`;
+var RETIRE_ASSET = `
+  mutation TheglobalfuelRetireAsset($id: ID!) {
+    theRetireAsset(id: $id)
+  }
+`;
+var LIST_PRODUCTION_RECORDS = `
+  query TheglobalfuelListProductionRecords($assetId: ID, $pagination: PaginationInput) {
+    theListProductionRecords(assetId: $assetId, pagination: $pagination) {
+      items { ${PRODUCTION_FIELDS} }
+      ${PAGE_INFO_FIELDS}
+    }
+  }
+`;
+var RECORD_PRODUCTION = `
+  mutation TheglobalfuelRecordProduction($input: TheRecordProductionInput!) {
+    theRecordProduction(input: $input) {
+      ${PRODUCTION_FIELDS}
+    }
+  }
+`;
+var LIST_RESERVE_ESTIMATES = `
+  query TheglobalfuelListReserveEstimates($assetId: ID, $category: TheReserveCategory) {
+    theListReserveEstimates(assetId: $assetId, category: $category) {
+      ${RESERVE_FIELDS}
+    }
+  }
+`;
+var CREATE_RESERVE_ESTIMATE = `
+  mutation TheglobalfuelCreateReserveEstimate($input: TheCreateReserveEstimateInput!) {
+    theCreateReserveEstimate(input: $input) {
+      ${RESERVE_FIELDS}
+    }
+  }
+`;
+var GET_CONTRACT = `
+  query TheglobalfuelGetContract($id: ID!) {
+    theContract(id: $id) {
+      ${CONTRACT_FIELDS}
+      shipments { id reference status volume unit }
+    }
+  }
+`;
+var LIST_CONTRACTS = `
+  query TheglobalfuelListContracts(
+    $commodity: TheCommodityType
+    $side: TheContractSide
+    $status: TheContractStatus
+    $pagination: PaginationInput
+  ) {
+    theListContracts(
+      commodity: $commodity
+      side: $side
+      status: $status
+      pagination: $pagination
+    ) {
+      items { ${CONTRACT_FIELDS} }
+      ${PAGE_INFO_FIELDS}
+    }
+  }
+`;
+var CREATE_CONTRACT = `
+  mutation TheglobalfuelCreateContract($input: TheCreateOfftakeContractInput!) {
+    theCreateContract(input: $input) {
+      ${CONTRACT_FIELDS}
+    }
+  }
+`;
+var UPDATE_CONTRACT = `
+  mutation TheglobalfuelUpdateContract($id: ID!, $input: TheUpdateOfftakeContractInput!) {
+    theUpdateContract(id: $id, input: $input) {
+      ${CONTRACT_FIELDS}
+    }
+  }
+`;
+var TRANSITION_CONTRACT = `
+  mutation TheglobalfuelTransitionContract($id: ID!, $status: TheContractStatus!) {
+    theTransitionContract(id: $id, status: $status) {
+      ${CONTRACT_FIELDS}
+    }
+  }
+`;
+var LIST_SHIPMENTS = `
+  query TheglobalfuelListShipments($contractId: ID, $status: TheShipmentStatus) {
+    theListShipments(contractId: $contractId, status: $status) {
+      ${SHIPMENT_FIELDS}
+    }
+  }
+`;
+var SCHEDULE_SHIPMENT = `
+  mutation TheglobalfuelScheduleShipment($input: TheCreateShipmentInput!) {
+    theScheduleShipment(input: $input) {
+      ${SHIPMENT_FIELDS}
+    }
+  }
+`;
+var DELIVER_SHIPMENT = `
+  mutation TheglobalfuelDeliverShipment($id: ID!) {
+    theDeliverShipment(id: $id) {
+      ${SHIPMENT_FIELDS}
+    }
+  }
+`;
+var LIST_INVENTORY_LOTS = `
+  query TheglobalfuelListInventoryLots(
+    $commodity: TheCommodityType
+    $status: TheInventoryStatus
+    $pagination: PaginationInput
+  ) {
+    theListInventoryLots(commodity: $commodity, status: $status, pagination: $pagination) {
+      items { ${INVENTORY_FIELDS} }
+      ${PAGE_INFO_FIELDS}
+    }
+  }
+`;
+var CREATE_INVENTORY_LOT = `
+  mutation TheglobalfuelCreateInventoryLot($input: TheCreateInventoryLotInput!) {
+    theCreateInventoryLot(input: $input) {
+      ${INVENTORY_FIELDS}
+    }
+  }
+`;
+var SET_INVENTORY_LOT_STATUS = `
+  mutation TheglobalfuelSetInventoryLotStatus($id: ID!, $status: TheInventoryStatus!) {
+    theSetInventoryLotStatus(id: $id, status: $status) {
+      ${INVENTORY_FIELDS}
+    }
+  }
+`;
+var LIST_EMISSION_RECORDS = `
+  query TheglobalfuelListEmissionRecords(
+    $assetId: ID
+    $scope: TheEmissionScope
+    $pagination: PaginationInput
+  ) {
+    theListEmissionRecords(assetId: $assetId, scope: $scope, pagination: $pagination) {
+      items { ${EMISSION_FIELDS} }
+      ${PAGE_INFO_FIELDS}
+    }
+  }
+`;
+var RECORD_EMISSION = `
+  mutation TheglobalfuelRecordEmission($input: TheRecordEmissionInput!) {
+    theRecordEmission(input: $input) {
+      ${EMISSION_FIELDS}
+    }
+  }
+`;
+var VERIFY_EMISSION = `
+  mutation TheglobalfuelVerifyEmission($id: ID!) {
+    theVerifyEmission(id: $id) {
+      ${EMISSION_FIELDS}
+    }
+  }
+`;
+var GET_COMPLIANCE_CERT = `
+  query TheglobalfuelGetComplianceCert($id: ID!) {
+    theComplianceCert(id: $id) {
+      ${COMPLIANCE_FIELDS}
+    }
+  }
+`;
+var LIST_COMPLIANCE_CERTS = `
+  query TheglobalfuelListComplianceCerts(
+    $assetId: ID
+    $category: TheComplianceCategory
+    $status: TheComplianceStatus
+  ) {
+    theListComplianceCerts(assetId: $assetId, category: $category, status: $status) {
+      ${COMPLIANCE_FIELDS}
+    }
+  }
+`;
+var CREATE_COMPLIANCE_CERT = `
+  mutation TheglobalfuelCreateComplianceCert($input: TheCreateComplianceCertInput!) {
+    theCreateComplianceCert(input: $input) {
+      ${COMPLIANCE_FIELDS}
+    }
+  }
+`;
+var TRANSITION_COMPLIANCE_CERT = `
+  mutation TheglobalfuelTransitionComplianceCert($id: ID!, $status: TheComplianceStatus!) {
+    theTransitionComplianceCert(id: $id, status: $status) {
+      ${COMPLIANCE_FIELDS}
+    }
+  }
+`;
+var HEALTH = `
+  query TheglobalfuelHealth {
+    theHealth
+  }
+`;
+var CommodityTypeEnum = z.enum([
+  "BAUXITE",
+  "BIOFUEL",
+  "COAL",
+  "COPPER",
+  "CRUDE_OIL",
+  "ELECTRICITY",
+  "GOLD",
+  "HYDROGEN",
+  "IRON_ORE",
+  "LITHIUM",
+  "LNG",
+  "NATURAL_GAS",
+  "RARE_EARTH"
+]).describe("Energy / mineral / commodity resource type");
+var AssetKindEnum = z.enum([
+  "GAS_FIELD",
+  "MINE",
+  "OIL_FIELD",
+  "PIPELINE",
+  "POWER_PLANT",
+  "PROCESSING_PLANT",
+  "QUARRY",
+  "REFINERY",
+  "SOLAR_FARM",
+  "STORAGE_TERMINAL",
+  "WELL",
+  "WIND_FARM"
+]).describe("Physical kind of a resource asset");
+var AssetStatusEnum = z.enum([
+  "APPRAISAL",
+  "DECOMMISSIONING",
+  "DEVELOPMENT",
+  "EXPLORATION",
+  "PRODUCING",
+  "RETIRED",
+  "SUSPENDED"
+]).describe("Lifecycle status of a resource asset");
+var UnitEnum = z.enum(["BARRELS", "CUBIC_METERS", "GJ", "KILOGRAMS", "MCF", "MWH", "TONNES"]).describe("Unit of measure for volume / capacity / quantity");
+var ReserveCategoryEnum = z.enum(["CONTINGENT", "POSSIBLE", "PROBABLE", "PROSPECTIVE", "PROVED"]).describe("Reserve-estimate confidence category");
+var ContractSideEnum = z.enum(["BUY", "SELL"]).describe("Whether the offtake contract is a BUY or SELL position");
+var ContractStatusEnum = z.enum(["ACTIVE", "COMPLETED", "DRAFT", "NEGOTIATION", "SIGNED", "SUSPENDED", "TERMINATED"]).describe("Lifecycle status of an offtake contract");
+var PricingBasisEnum = z.enum(["FIXED", "FORMULA", "INDEX_LINKED", "SPOT"]).describe("Pricing basis for an offtake contract");
+var ShipmentStatusEnum = z.enum(["CANCELLED", "DELIVERED", "IN_TRANSIT", "LOADING", "SCHEDULED"]).describe("Lifecycle status of a commodity shipment");
+var TransportModeEnum = z.enum(["GRID", "PIPELINE", "RAIL", "TANKER", "TRUCK", "VESSEL_BULK"]).describe("Transport mode for a shipment");
+var InventoryStatusEnum = z.enum(["AVAILABLE", "CONSUMED", "IN_TRANSIT", "RESERVED", "WRITTEN_OFF"]).describe("Lifecycle status of an inventory lot");
+var EmissionScopeEnum = z.enum(["SCOPE_1", "SCOPE_2", "SCOPE_3"]).describe("GHG Protocol emission scope");
+var ComplianceCategoryEnum = z.enum([
+  "CARBON_CREDIT",
+  "CHAIN_OF_CUSTODY",
+  "EMISSIONS_REPORT",
+  "ENVIRONMENTAL_PERMIT",
+  "EXPORT_LICENSE",
+  "EXTRACTION_LICENSE",
+  "SAFETY_AUDIT"
+]).describe("Category of a compliance certification");
+var ComplianceStatusEnum = z.enum(["APPROVED", "EXPIRED", "PENDING", "REJECTED", "REVOKED", "SUBMITTED"]).describe("Lifecycle status of a compliance certification");
+var DateTimeString = z.string().describe("ISO-8601 DateTime, e.g. 2026-06-27T00:00:00Z");
+
+// src/modules/theglobalfuel/tools/assets.ts
+function registerAssetTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "assets_get")),
+    {
+      title: "Get Asset",
+      description: "Fetch a single resource asset by ID, including its recent production records and reserve estimates.",
+      inputSchema: { id: z.string().describe("Asset ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_ASSET, { id });
+        if (!data.theAsset) return errorResult(`Asset ${id} not found`);
+        return jsonResult(data.theAsset);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel assets_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get asset: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "assets_list")),
+    {
+      title: "List Assets",
+      description: "List resource assets in the bound workspace with optional commodity/kind/status filters and pagination. Returns a connection ({ items, pageInfo }).",
+      inputSchema: {
+        commodity: CommodityTypeEnum.optional().describe("Filter by commodity type"),
+        kind: AssetKindEnum.optional().describe("Filter by asset kind"),
+        status: AssetStatusEnum.optional().describe("Filter by lifecycle status"),
+        limit: z.number().int().optional().describe("Page size (default 50)"),
+        offset: z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ commodity, kind, status, limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_ASSETS, {
+          commodity,
+          kind,
+          status,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.theListAssets);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel assets_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list assets: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "assets_create")),
+    {
+      title: "Create Asset",
+      description: "Register a new resource asset (well, mine, field, plant, etc.). `name` and `commodity` are required; `kind` defaults to WELL and `status` to EXPLORATION.",
+      inputSchema: {
+        name: z.string().min(1).describe("Asset display name"),
+        commodity: CommodityTypeEnum.describe("Commodity produced by the asset"),
+        kind: AssetKindEnum.optional().describe("Asset kind (default WELL)"),
+        code: z.string().optional().describe("Operator asset code / short identifier"),
+        capacityPerDay: z.number().optional().describe("Nameplate capacity per day"),
+        capacityUnit: UnitEnum.optional().describe("Unit for capacityPerDay (default BARRELS)"),
+        workingInterestPct: z.number().optional().describe("Working interest percentage held (0\u2013100)"),
+        operatorLeadId: z.string().optional().describe("User ID of the operator lead"),
+        location: z.string().optional().describe("Free-text location / basin name"),
+        latitude: z.number().optional().describe("Latitude (decimal degrees)"),
+        longitude: z.number().optional().describe("Longitude (decimal degrees)"),
+        commissionedAt: DateTimeString.optional().describe("Commissioning date"),
+        status: AssetStatusEnum.optional().describe(
+          "Initial lifecycle status (default EXPLORATION)"
+        ),
+        tags: z.array(z.string()).optional().describe("Free-form tags")
+      }
+    },
+    async ({
+      name,
+      commodity,
+      kind,
+      code,
+      capacityPerDay,
+      capacityUnit,
+      workingInterestPct,
+      operatorLeadId,
+      location,
+      latitude,
+      longitude,
+      commissionedAt,
+      status,
+      tags
+    }) => {
+      try {
+        const input = { name, commodity };
+        if (kind !== void 0) input.kind = kind;
+        if (code !== void 0) input.code = code;
+        if (capacityPerDay !== void 0) input.capacityPerDay = capacityPerDay;
+        if (capacityUnit !== void 0) input.capacityUnit = capacityUnit;
+        if (workingInterestPct !== void 0) input.workingInterestPct = workingInterestPct;
+        if (operatorLeadId !== void 0) input.operatorLeadId = operatorLeadId;
+        if (location !== void 0) input.location = location;
+        if (latitude !== void 0) input.latitude = latitude;
+        if (longitude !== void 0) input.longitude = longitude;
+        if (commissionedAt !== void 0) input.commissionedAt = commissionedAt;
+        if (status !== void 0) input.status = status;
+        if (tags !== void 0) input.tags = tags;
+        const data = await ctx.gql.workspace.request(CREATE_ASSET, { input });
+        return jsonResult(data.theCreateAsset);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel assets_create failed", { error: String(error) });
+        return errorResult(
+          `Failed to create asset: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "assets_update")),
+    {
+      title: "Update Asset",
+      description: "Update a resource asset. At least one mutable field must be provided. Use `assets_transition` / `assets_retire` for lifecycle changes.",
+      inputSchema: {
+        id: z.string().describe("Asset ID"),
+        name: z.string().optional().describe("Updated name"),
+        commodity: CommodityTypeEnum.optional().describe("Updated commodity"),
+        kind: AssetKindEnum.optional().describe("Updated asset kind"),
+        code: z.string().optional().describe("Updated asset code"),
+        capacityPerDay: z.number().optional().describe("Updated capacity per day"),
+        capacityUnit: UnitEnum.optional().describe("Updated capacity unit"),
+        workingInterestPct: z.number().optional().describe("Updated working interest percentage"),
+        operatorLeadId: z.string().optional().describe("Updated operator lead user ID"),
+        location: z.string().optional().describe("Updated location"),
+        latitude: z.number().optional().describe("Updated latitude"),
+        longitude: z.number().optional().describe("Updated longitude"),
+        commissionedAt: DateTimeString.optional().describe("Updated commissioning date"),
+        decommissionedAt: DateTimeString.optional().describe("Decommissioning date"),
+        tags: z.array(z.string()).optional().describe("Updated tags")
+      }
+    },
+    async ({
+      id,
+      name,
+      commodity,
+      kind,
+      code,
+      capacityPerDay,
+      capacityUnit,
+      workingInterestPct,
+      operatorLeadId,
+      location,
+      latitude,
+      longitude,
+      commissionedAt,
+      decommissionedAt,
+      tags
+    }) => {
+      try {
+        const input = {};
+        if (name !== void 0) input.name = name;
+        if (commodity !== void 0) input.commodity = commodity;
+        if (kind !== void 0) input.kind = kind;
+        if (code !== void 0) input.code = code;
+        if (capacityPerDay !== void 0) input.capacityPerDay = capacityPerDay;
+        if (capacityUnit !== void 0) input.capacityUnit = capacityUnit;
+        if (workingInterestPct !== void 0) input.workingInterestPct = workingInterestPct;
+        if (operatorLeadId !== void 0) input.operatorLeadId = operatorLeadId;
+        if (location !== void 0) input.location = location;
+        if (latitude !== void 0) input.latitude = latitude;
+        if (longitude !== void 0) input.longitude = longitude;
+        if (commissionedAt !== void 0) input.commissionedAt = commissionedAt;
+        if (decommissionedAt !== void 0) input.decommissionedAt = decommissionedAt;
+        if (tags !== void 0) input.tags = tags;
+        if (Object.keys(input).length === 0) {
+          return errorResult("No updates specified \u2014 provide at least one mutable asset field");
+        }
+        const data = await ctx.gql.workspace.request(UPDATE_ASSET, { id, input });
+        return jsonResult(data.theUpdateAsset);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel assets_update failed", { error: String(error) });
+        return errorResult(
+          `Failed to update asset: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "assets_transition")),
+    {
+      title: "Transition Asset",
+      description: "Advance an asset through its lifecycle (validated transitions), e.g. EXPLORATION \u2192 APPRAISAL \u2192 DEVELOPMENT \u2192 PRODUCING.",
+      inputSchema: {
+        id: z.string().describe("Asset ID"),
+        status: AssetStatusEnum.describe("Target lifecycle status")
+      }
+    },
+    async ({ id, status }) => {
+      try {
+        const data = await ctx.gql.workspace.request(TRANSITION_ASSET, { id, status });
+        return jsonResult(data.theTransitionAsset);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel assets_transition failed", { error: String(error) });
+        return errorResult(
+          `Failed to transition asset: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "assets_retire")),
+    {
+      title: "Retire Asset",
+      description: "Retire (decommission) an asset. Returns true on success.",
+      inputSchema: { id: z.string().describe("Asset ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(
+          RETIRE_ASSET,
+          { id }
+        );
+        return jsonResult({ retired: data.theRetireAsset });
+      } catch (error) {
+        ctx.logger.error("theglobalfuel assets_retire failed", { error: String(error) });
+        return errorResult(
+          `Failed to retire asset: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerProductionTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "production_list")),
+    {
+      title: "List Production Records",
+      description: "List production records, optionally filtered by asset, with pagination. Returns a connection ({ items, pageInfo }).",
+      inputSchema: {
+        assetId: z.string().optional().describe("Filter by asset ID"),
+        limit: z.number().int().optional().describe("Page size (default 50)"),
+        offset: z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ assetId, limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_PRODUCTION_RECORDS, {
+          assetId,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.theListProductionRecords);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel production_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list production records: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "production_record")),
+    {
+      title: "Record Production",
+      description: "Record a production figure for an asset over a period. `assetId`, `periodStart`, `periodEnd`, and `volume` are required.",
+      inputSchema: {
+        assetId: z.string().min(1).describe("Asset the production is recorded against"),
+        periodStart: DateTimeString.describe("Production period start"),
+        periodEnd: DateTimeString.describe("Production period end"),
+        volume: z.number().describe("Produced volume in the given unit"),
+        unit: UnitEnum.optional().describe("Volume unit (default BARRELS)"),
+        grade: z.number().optional().describe("Average grade / quality factor"),
+        downtimeHours: z.number().optional().describe("Downtime hours during the period"),
+        notes: z.string().optional().describe("Free-text notes")
+      }
+    },
+    async ({ assetId, periodStart, periodEnd, volume, unit, grade, downtimeHours, notes }) => {
+      try {
+        const input = { assetId, periodStart, periodEnd, volume };
+        if (unit !== void 0) input.unit = unit;
+        if (grade !== void 0) input.grade = grade;
+        if (downtimeHours !== void 0) input.downtimeHours = downtimeHours;
+        if (notes !== void 0) input.notes = notes;
+        const data = await ctx.gql.workspace.request(RECORD_PRODUCTION, { input });
+        return jsonResult(data.theRecordProduction);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel production_record failed", { error: String(error) });
+        return errorResult(
+          `Failed to record production: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerReserveTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "reserves_list")),
+    {
+      title: "List Reserve Estimates",
+      description: "List reserve estimates, optionally filtered by asset and/or reserve category. Returns a plain array.",
+      inputSchema: {
+        assetId: z.string().optional().describe("Filter by asset ID"),
+        category: ReserveCategoryEnum.optional().describe("Filter by reserve category")
+      }
+    },
+    async ({ assetId, category }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_RESERVE_ESTIMATES, { assetId, category });
+        return jsonResult(data.theListReserveEstimates);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel reserves_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list reserve estimates: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "reserves_create")),
+    {
+      title: "Create Reserve Estimate",
+      description: "Create a reserve estimate for an asset. `assetId`, `asOfDate`, and `recoverable` are required; `category` defaults to PROVED.",
+      inputSchema: {
+        assetId: z.string().min(1).describe("Asset the estimate is for"),
+        asOfDate: DateTimeString.describe("As-of valuation date"),
+        recoverable: z.number().describe("Recoverable quantity in the given unit"),
+        category: ReserveCategoryEnum.optional().describe("Reserve category (default PROVED)"),
+        recoveryFactor: z.number().optional().describe("Recovery factor (0\u20131)"),
+        unit: UnitEnum.optional().describe("Unit for recoverable (default BARRELS)"),
+        methodology: z.string().optional().describe("Estimation methodology"),
+        notes: z.string().optional().describe("Free-text notes")
+      }
+    },
+    async ({
+      assetId,
+      asOfDate,
+      recoverable,
+      category,
+      recoveryFactor,
+      unit,
+      methodology,
+      notes
+    }) => {
+      try {
+        const input = { assetId, asOfDate, recoverable };
+        if (category !== void 0) input.category = category;
+        if (recoveryFactor !== void 0) input.recoveryFactor = recoveryFactor;
+        if (unit !== void 0) input.unit = unit;
+        if (methodology !== void 0) input.methodology = methodology;
+        if (notes !== void 0) input.notes = notes;
+        const data = await ctx.gql.workspace.request(CREATE_RESERVE_ESTIMATE, { input });
+        return jsonResult(data.theCreateReserveEstimate);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel reserves_create failed", { error: String(error) });
+        return errorResult(
+          `Failed to create reserve estimate: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerContractTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "contracts_get")),
+    {
+      title: "Get Offtake Contract",
+      description: "Fetch a single offtake contract by ID, including its shipments.",
+      inputSchema: { id: z.string().describe("Contract ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_CONTRACT, { id });
+        if (!data.theContract) return errorResult(`Contract ${id} not found`);
+        return jsonResult(data.theContract);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel contracts_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get contract: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "contracts_list")),
+    {
+      title: "List Offtake Contracts",
+      description: "List offtake contracts with optional commodity/side/status filters and pagination. Returns a connection ({ items, pageInfo }).",
+      inputSchema: {
+        commodity: CommodityTypeEnum.optional().describe("Filter by commodity"),
+        side: ContractSideEnum.optional().describe("Filter by BUY/SELL side"),
+        status: ContractStatusEnum.optional().describe("Filter by contract status"),
+        limit: z.number().int().optional().describe("Page size (default 50)"),
+        offset: z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ commodity, side, status, limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_CONTRACTS, {
+          commodity,
+          side,
+          status,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.theListContracts);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel contracts_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list contracts: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "contracts_create")),
+    {
+      title: "Create Offtake Contract",
+      description: "Create an offtake contract. `reference`, `counterparty`, and `commodity` are required; `side` defaults to SELL and `pricingBasis` to FIXED.",
+      inputSchema: {
+        reference: z.string().min(1).describe("Unique contract reference"),
+        counterparty: z.string().min(1).describe("Counterparty name"),
+        commodity: CommodityTypeEnum.describe("Contracted commodity"),
+        side: ContractSideEnum.optional().describe("BUY or SELL (default SELL)"),
+        contractedVolume: z.number().optional().describe("Total contracted volume"),
+        unit: UnitEnum.optional().describe("Volume unit (default BARRELS)"),
+        pricePerUnit: z.number().optional().describe("Fixed price per unit"),
+        currency: z.string().optional().describe("Pricing currency (e.g. USD)"),
+        priceIndex: z.string().optional().describe("Reference price index (for index-linked)"),
+        pricingBasis: PricingBasisEnum.optional().describe("Pricing basis (default FIXED)"),
+        deliveryLocation: z.string().optional().describe("Delivery location"),
+        startDate: DateTimeString.optional().describe("Contract start date"),
+        endDate: DateTimeString.optional().describe("Contract end date"),
+        notes: z.string().optional().describe("Free-text notes"),
+        tags: z.array(z.string()).optional().describe("Free-form tags")
+      }
+    },
+    async ({
+      reference,
+      counterparty,
+      commodity,
+      side,
+      contractedVolume,
+      unit,
+      pricePerUnit,
+      currency,
+      priceIndex,
+      pricingBasis,
+      deliveryLocation,
+      startDate,
+      endDate,
+      notes,
+      tags
+    }) => {
+      try {
+        const input = { reference, counterparty, commodity };
+        if (side !== void 0) input.side = side;
+        if (contractedVolume !== void 0) input.contractedVolume = contractedVolume;
+        if (unit !== void 0) input.unit = unit;
+        if (pricePerUnit !== void 0) input.pricePerUnit = pricePerUnit;
+        if (currency !== void 0) input.currency = currency;
+        if (priceIndex !== void 0) input.priceIndex = priceIndex;
+        if (pricingBasis !== void 0) input.pricingBasis = pricingBasis;
+        if (deliveryLocation !== void 0) input.deliveryLocation = deliveryLocation;
+        if (startDate !== void 0) input.startDate = startDate;
+        if (endDate !== void 0) input.endDate = endDate;
+        if (notes !== void 0) input.notes = notes;
+        if (tags !== void 0) input.tags = tags;
+        const data = await ctx.gql.workspace.request(CREATE_CONTRACT, { input });
+        return jsonResult(data.theCreateContract);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel contracts_create failed", { error: String(error) });
+        return errorResult(
+          `Failed to create contract: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "contracts_update")),
+    {
+      title: "Update Offtake Contract",
+      description: "Update an offtake contract. At least one mutable field must be provided. Use `contracts_transition` for lifecycle changes.",
+      inputSchema: {
+        id: z.string().describe("Contract ID"),
+        counterparty: z.string().optional().describe("Updated counterparty"),
+        contractedVolume: z.number().optional().describe("Updated contracted volume"),
+        unit: UnitEnum.optional().describe("Updated volume unit"),
+        pricePerUnit: z.number().optional().describe("Updated price per unit"),
+        currency: z.string().optional().describe("Updated currency"),
+        priceIndex: z.string().optional().describe("Updated price index"),
+        pricingBasis: PricingBasisEnum.optional().describe("Updated pricing basis"),
+        deliveryLocation: z.string().optional().describe("Updated delivery location"),
+        startDate: DateTimeString.optional().describe("Updated start date"),
+        endDate: DateTimeString.optional().describe("Updated end date"),
+        notes: z.string().optional().describe("Updated notes"),
+        tags: z.array(z.string()).optional().describe("Updated tags")
+      }
+    },
+    async ({
+      id,
+      counterparty,
+      contractedVolume,
+      unit,
+      pricePerUnit,
+      currency,
+      priceIndex,
+      pricingBasis,
+      deliveryLocation,
+      startDate,
+      endDate,
+      notes,
+      tags
+    }) => {
+      try {
+        const input = {};
+        if (counterparty !== void 0) input.counterparty = counterparty;
+        if (contractedVolume !== void 0) input.contractedVolume = contractedVolume;
+        if (unit !== void 0) input.unit = unit;
+        if (pricePerUnit !== void 0) input.pricePerUnit = pricePerUnit;
+        if (currency !== void 0) input.currency = currency;
+        if (priceIndex !== void 0) input.priceIndex = priceIndex;
+        if (pricingBasis !== void 0) input.pricingBasis = pricingBasis;
+        if (deliveryLocation !== void 0) input.deliveryLocation = deliveryLocation;
+        if (startDate !== void 0) input.startDate = startDate;
+        if (endDate !== void 0) input.endDate = endDate;
+        if (notes !== void 0) input.notes = notes;
+        if (tags !== void 0) input.tags = tags;
+        if (Object.keys(input).length === 0) {
+          return errorResult("No updates specified \u2014 provide at least one mutable contract field");
+        }
+        const data = await ctx.gql.workspace.request(UPDATE_CONTRACT, { id, input });
+        return jsonResult(data.theUpdateContract);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel contracts_update failed", { error: String(error) });
+        return errorResult(
+          `Failed to update contract: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "contracts_transition")),
+    {
+      title: "Transition Offtake Contract",
+      description: "Advance an offtake contract through its lifecycle (validated transitions), e.g. DRAFT \u2192 NEGOTIATION \u2192 SIGNED \u2192 ACTIVE \u2192 COMPLETED.",
+      inputSchema: {
+        id: z.string().describe("Contract ID"),
+        status: ContractStatusEnum.describe("Target contract status")
+      }
+    },
+    async ({ id, status }) => {
+      try {
+        const data = await ctx.gql.workspace.request(TRANSITION_CONTRACT, { id, status });
+        return jsonResult(data.theTransitionContract);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel contracts_transition failed", { error: String(error) });
+        return errorResult(
+          `Failed to transition contract: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerShipmentTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "shipments_list")),
+    {
+      title: "List Shipments",
+      description: "List commodity shipments, optionally filtered by contract and/or status. Returns a plain array.",
+      inputSchema: {
+        contractId: z.string().optional().describe("Filter by contract ID"),
+        status: ShipmentStatusEnum.optional().describe("Filter by shipment status")
+      }
+    },
+    async ({ contractId, status }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_SHIPMENTS, { contractId, status });
+        return jsonResult(data.theListShipments);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel shipments_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list shipments: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "shipments_schedule")),
+    {
+      title: "Schedule Shipment",
+      description: "Schedule a shipment against a contract. `contractId`, `reference`, and `volume` are required; `mode` defaults to PIPELINE.",
+      inputSchema: {
+        contractId: z.string().min(1).describe("Contract the shipment fulfils"),
+        reference: z.string().min(1).describe("Unique shipment reference"),
+        volume: z.number().describe("Shipment volume in the given unit"),
+        unit: UnitEnum.optional().describe("Volume unit (default BARRELS)"),
+        mode: TransportModeEnum.optional().describe("Transport mode (default PIPELINE)"),
+        origin: z.string().optional().describe("Origin location"),
+        destination: z.string().optional().describe("Destination location"),
+        carrier: z.string().optional().describe("Carrier / transporter name"),
+        scheduledAt: DateTimeString.optional().describe("Scheduled departure time"),
+        documentFileId: z.string().optional().describe("wspace-files-svc File ID (bill of lading / certificate)"),
+        notes: z.string().optional().describe("Free-text notes")
+      }
+    },
+    async ({
+      contractId,
+      reference,
+      volume,
+      unit,
+      mode,
+      origin,
+      destination,
+      carrier,
+      scheduledAt,
+      documentFileId,
+      notes
+    }) => {
+      try {
+        const input = { contractId, reference, volume };
+        if (unit !== void 0) input.unit = unit;
+        if (mode !== void 0) input.mode = mode;
+        if (origin !== void 0) input.origin = origin;
+        if (destination !== void 0) input.destination = destination;
+        if (carrier !== void 0) input.carrier = carrier;
+        if (scheduledAt !== void 0) input.scheduledAt = scheduledAt;
+        if (documentFileId !== void 0) input.documentFileId = documentFileId;
+        if (notes !== void 0) input.notes = notes;
+        const data = await ctx.gql.workspace.request(SCHEDULE_SHIPMENT, { input });
+        return jsonResult(data.theScheduleShipment);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel shipments_schedule failed", { error: String(error) });
+        return errorResult(
+          `Failed to schedule shipment: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "shipments_deliver")),
+    {
+      title: "Deliver Shipment",
+      description: "Mark a shipment delivered and roll its volume into the contract's delivered total.",
+      inputSchema: { id: z.string().describe("Shipment ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(DELIVER_SHIPMENT, { id });
+        return jsonResult(data.theDeliverShipment);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel shipments_deliver failed", { error: String(error) });
+        return errorResult(
+          `Failed to deliver shipment: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerInventoryTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "inventory_list")),
+    {
+      title: "List Inventory Lots",
+      description: "List inventory lots with optional commodity/status filters and pagination. Returns a connection ({ items, pageInfo }).",
+      inputSchema: {
+        commodity: CommodityTypeEnum.optional().describe("Filter by commodity"),
+        status: InventoryStatusEnum.optional().describe("Filter by inventory status"),
+        limit: z.number().int().optional().describe("Page size (default 50)"),
+        offset: z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ commodity, status, limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_INVENTORY_LOTS, {
+          commodity,
+          status,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.theListInventoryLots);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel inventory_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list inventory lots: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "inventory_create")),
+    {
+      title: "Create Inventory Lot",
+      description: "Create an inventory lot. `lotCode`, `commodity`, and `quantity` are required; `unit` defaults to BARRELS.",
+      inputSchema: {
+        lotCode: z.string().min(1).describe("Unique lot code"),
+        commodity: CommodityTypeEnum.describe("Commodity stored in the lot"),
+        quantity: z.number().describe("Quantity in the given unit"),
+        unit: UnitEnum.optional().describe("Quantity unit (default BARRELS)"),
+        grade: z.number().optional().describe("Average grade / quality factor"),
+        unitValue: z.number().optional().describe("Per-unit value"),
+        currency: z.string().optional().describe("Currency for unitValue"),
+        location: z.string().optional().describe("Storage location"),
+        assetId: z.string().optional().describe("Source asset ID"),
+        producedAt: DateTimeString.optional().describe("Production / acquisition date"),
+        notes: z.string().optional().describe("Free-text notes")
+      }
+    },
+    async ({
+      lotCode,
+      commodity,
+      quantity,
+      unit,
+      grade,
+      unitValue,
+      currency,
+      location,
+      assetId,
+      producedAt,
+      notes
+    }) => {
+      try {
+        const input = { lotCode, commodity, quantity };
+        if (unit !== void 0) input.unit = unit;
+        if (grade !== void 0) input.grade = grade;
+        if (unitValue !== void 0) input.unitValue = unitValue;
+        if (currency !== void 0) input.currency = currency;
+        if (location !== void 0) input.location = location;
+        if (assetId !== void 0) input.assetId = assetId;
+        if (producedAt !== void 0) input.producedAt = producedAt;
+        if (notes !== void 0) input.notes = notes;
+        const data = await ctx.gql.workspace.request(CREATE_INVENTORY_LOT, { input });
+        return jsonResult(data.theCreateInventoryLot);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel inventory_create failed", { error: String(error) });
+        return errorResult(
+          `Failed to create inventory lot: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "inventory_set_status")),
+    {
+      title: "Set Inventory Lot Status",
+      description: "Set the status of an inventory lot (AVAILABLE / RESERVED / IN_TRANSIT / CONSUMED / WRITTEN_OFF).",
+      inputSchema: {
+        id: z.string().describe("Inventory lot ID"),
+        status: InventoryStatusEnum.describe("New inventory status")
+      }
+    },
+    async ({ id, status }) => {
+      try {
+        const data = await ctx.gql.workspace.request(SET_INVENTORY_LOT_STATUS, { id, status });
+        return jsonResult(data.theSetInventoryLotStatus);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel inventory_set_status failed", { error: String(error) });
+        return errorResult(
+          `Failed to set inventory lot status: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerEmissionTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "emissions_list")),
+    {
+      title: "List Emission Records",
+      description: "List GHG emission records with optional asset/scope filters and pagination. Returns a connection ({ items, pageInfo }).",
+      inputSchema: {
+        assetId: z.string().optional().describe("Filter by asset ID"),
+        scope: EmissionScopeEnum.optional().describe("Filter by emission scope"),
+        limit: z.number().int().optional().describe("Page size (default 50)"),
+        offset: z.number().int().optional().describe("Pagination offset (default 0)")
+      }
+    },
+    async ({ assetId, scope, limit, offset }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_EMISSION_RECORDS, {
+          assetId,
+          scope,
+          pagination: { limit: limit ?? 50, offset: offset ?? 0 }
+        });
+        return jsonResult(data.theListEmissionRecords);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel emissions_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list emission records: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "emissions_record")),
+    {
+      title: "Record Emission",
+      description: "Record a GHG emission figure for a period. `co2eTonnes`, `periodStart`, and `periodEnd` are required; `scope` defaults to SCOPE_1.",
+      inputSchema: {
+        co2eTonnes: z.number().describe("CO2-equivalent tonnes emitted"),
+        periodStart: DateTimeString.describe("Reporting period start"),
+        periodEnd: DateTimeString.describe("Reporting period end"),
+        scope: EmissionScopeEnum.optional().describe("Emission scope (default SCOPE_1)"),
+        assetId: z.string().optional().describe("Asset the emission is attributed to"),
+        source: z.string().optional().describe("Emission source description"),
+        methodology: z.string().optional().describe("Calculation methodology"),
+        notes: z.string().optional().describe("Free-text notes")
+      }
+    },
+    async ({ co2eTonnes, periodStart, periodEnd, scope, assetId, source, methodology, notes }) => {
+      try {
+        const input = { co2eTonnes, periodStart, periodEnd };
+        if (scope !== void 0) input.scope = scope;
+        if (assetId !== void 0) input.assetId = assetId;
+        if (source !== void 0) input.source = source;
+        if (methodology !== void 0) input.methodology = methodology;
+        if (notes !== void 0) input.notes = notes;
+        const data = await ctx.gql.workspace.request(RECORD_EMISSION, { input });
+        return jsonResult(data.theRecordEmission);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel emissions_record failed", { error: String(error) });
+        return errorResult(
+          `Failed to record emission: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "emissions_verify")),
+    {
+      title: "Verify Emission",
+      description: "Mark an emission figure third-party verified.",
+      inputSchema: { id: z.string().describe("Emission record ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(VERIFY_EMISSION, { id });
+        return jsonResult(data.theVerifyEmission);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel emissions_verify failed", { error: String(error) });
+        return errorResult(
+          `Failed to verify emission: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+function registerComplianceTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "compliance_get")),
+    {
+      title: "Get Compliance Certification",
+      description: "Fetch a single compliance certification by ID, including its evidence file reference.",
+      inputSchema: { id: z.string().describe("Compliance certification ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_COMPLIANCE_CERT, { id });
+        if (!data.theComplianceCert) return errorResult(`Compliance certification ${id} not found`);
+        return jsonResult(data.theComplianceCert);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel compliance_get failed", { error: String(error) });
+        return errorResult(
+          `Failed to get compliance certification: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "compliance_list")),
+    {
+      title: "List Compliance Certifications",
+      description: "List compliance certifications with optional asset/category/status filters. Returns a plain array.",
+      inputSchema: {
+        assetId: z.string().optional().describe("Filter by asset ID"),
+        category: ComplianceCategoryEnum.optional().describe("Filter by category"),
+        status: ComplianceStatusEnum.optional().describe("Filter by status")
+      }
+    },
+    async ({ assetId, category, status }) => {
+      try {
+        const data = await ctx.gql.workspace.request(LIST_COMPLIANCE_CERTS, { assetId, category, status });
+        return jsonResult(data.theListComplianceCerts);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel compliance_list failed", { error: String(error) });
+        return errorResult(
+          `Failed to list compliance certifications: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "compliance_create")),
+    {
+      title: "Create Compliance Certification",
+      description: "Create a compliance certification (permit, license, audit, carbon credit, etc.). `title` is required; `category` defaults to ENVIRONMENTAL_PERMIT.",
+      inputSchema: {
+        title: z.string().min(1).describe("Certification title"),
+        category: ComplianceCategoryEnum.optional().describe(
+          "Category (default ENVIRONMENTAL_PERMIT)"
+        ),
+        assetId: z.string().optional().describe("Related asset ID"),
+        authority: z.string().optional().describe("Issuing authority"),
+        certNumber: z.string().optional().describe("Certificate / permit number"),
+        evidenceFileId: z.string().optional().describe("wspace-files-svc File ID for the certificate document"),
+        issuedAt: DateTimeString.optional().describe("Issue date"),
+        expiresAt: DateTimeString.optional().describe("Expiry date"),
+        ownerId: z.string().optional().describe("Owning user ID"),
+        notes: z.string().optional().describe("Free-text notes"),
+        tags: z.array(z.string()).optional().describe("Free-form tags")
+      }
+    },
+    async ({
+      title,
+      category,
+      assetId,
+      authority,
+      certNumber,
+      evidenceFileId,
+      issuedAt,
+      expiresAt,
+      ownerId,
+      notes,
+      tags
+    }) => {
+      try {
+        const input = { title };
+        if (category !== void 0) input.category = category;
+        if (assetId !== void 0) input.assetId = assetId;
+        if (authority !== void 0) input.authority = authority;
+        if (certNumber !== void 0) input.certNumber = certNumber;
+        if (evidenceFileId !== void 0) input.evidenceFileId = evidenceFileId;
+        if (issuedAt !== void 0) input.issuedAt = issuedAt;
+        if (expiresAt !== void 0) input.expiresAt = expiresAt;
+        if (ownerId !== void 0) input.ownerId = ownerId;
+        if (notes !== void 0) input.notes = notes;
+        if (tags !== void 0) input.tags = tags;
+        const data = await ctx.gql.workspace.request(CREATE_COMPLIANCE_CERT, { input });
+        return jsonResult(data.theCreateComplianceCert);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel compliance_create failed", { error: String(error) });
+        return errorResult(
+          `Failed to create compliance certification: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "compliance_transition")),
+    {
+      title: "Transition Compliance Certification",
+      description: "Advance a compliance certification through its lifecycle (validated transitions), e.g. PENDING \u2192 SUBMITTED \u2192 APPROVED.",
+      inputSchema: {
+        id: z.string().describe("Compliance certification ID"),
+        status: ComplianceStatusEnum.describe("Target status")
+      }
+    },
+    async ({ id, status }) => {
+      try {
+        const data = await ctx.gql.workspace.request(TRANSITION_COMPLIANCE_CERT, { id, status });
+        return jsonResult(data.theTransitionComplianceCert);
+      } catch (error) {
+        ctx.logger.error("theglobalfuel compliance_transition failed", { error: String(error) });
+        return errorResult(
+          `Failed to transition compliance certification: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+
+// src/modules/theglobalfuel/tools/health.ts
+function registerHealthTools(server, ctx, track) {
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "health")),
+    {
+      title: "Theglobalfuel Health Check",
+      description: "Public liveness/identity probe for the Theglobalfuel subgraph (theHealth). Requires no authentication.",
+      inputSchema: {}
+    },
+    async () => {
+      try {
+        const data = await ctx.gql.workspace.request(HEALTH, {});
+        return jsonResult({ ok: true, status: data.theHealth });
+      } catch (error) {
+        ctx.logger.error("theglobalfuel health failed", { error: String(error) });
+        return errorResult(
+          `Theglobalfuel health check failed: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+}
+
+// src/modules/theglobalfuel/resources.ts
+function registerTheglobalfuelResources(server, ctx, track) {
+  const schemaUri = track(mcpResourceUri(ctx.productName, "schema"));
+  const assetsUri = track(mcpResourceUri(ctx.productName, "assets"));
+  const contractsUri = track(mcpResourceUri(ctx.productName, "contracts"));
+  const inventoryUri = track(mcpResourceUri(ctx.productName, "inventory"));
+  server.registerResource(
+    "theglobalfuel-schema",
+    schemaUri,
+    {
+      title: "Theglobalfuel Domain Schema",
+      description: "Overview of the Theglobalfuel resource-operating-system domain \u2014 entities, enums, and the per-entity tool surface.",
+      mimeType: "text/plain"
+    },
+    async () => {
+      ctx.logger.debug(`Resource ${schemaUri} requested`);
+      const schema = `# Theglobalfuel Domain (Overview)
+
+Energy, Mineral & Commodity Resource Operating System \u2014 the federated system of
+record for resource assets, production, reserves, offtake contracts, shipments,
+inventory, and ESG (emissions & compliance).
+
+## Entities
+- TheAsset \u2014 a resource asset (well, mine, field, plant, pipeline, ...)
+- TheProductionRecord \u2014 periodic production captured against an asset
+- TheReserveEstimate \u2014 recoverable-reserve estimate for an asset
+- TheOfftakeContract \u2014 a BUY/SELL offtake contract (+ shipments)
+- TheShipment \u2014 a commodity shipment fulfilling a contract
+- TheInventoryLot \u2014 a stored commodity lot
+- TheEmissionRecord \u2014 a GHG emission figure (Scope 1/2/3)
+- TheComplianceCert \u2014 a regulatory / ESG certification (permit, license, audit)
+
+## Enums
+- TheCommodityType: BAUXITE, BIOFUEL, COAL, COPPER, CRUDE_OIL, ELECTRICITY, GOLD, HYDROGEN, IRON_ORE, LITHIUM, LNG, NATURAL_GAS, RARE_EARTH
+- TheAssetKind: GAS_FIELD, MINE, OIL_FIELD, PIPELINE, POWER_PLANT, PROCESSING_PLANT, QUARRY, REFINERY, SOLAR_FARM, STORAGE_TERMINAL, WELL, WIND_FARM
+- TheAssetStatus: APPRAISAL, DECOMMISSIONING, DEVELOPMENT, EXPLORATION, PRODUCING, RETIRED, SUSPENDED
+- TheContractSide: BUY, SELL
+- TheContractStatus: ACTIVE, COMPLETED, DRAFT, NEGOTIATION, SIGNED, SUSPENDED, TERMINATED
+- TheShipmentStatus: CANCELLED, DELIVERED, IN_TRANSIT, LOADING, SCHEDULED
+- TheInventoryStatus: AVAILABLE, CONSUMED, IN_TRANSIT, RESERVED, WRITTEN_OFF
+- TheEmissionScope: SCOPE_1, SCOPE_2, SCOPE_3
+- TheComplianceStatus: APPROVED, EXPIRED, PENDING, REJECTED, REVOKED, SUBMITTED
+- TheUnit: BARRELS, CUBIC_METERS, GJ, KILOGRAMS, MCF, MWH, TONNES
+
+## Tool groups
+assets, production, reserves, contracts, shipments, inventory, emissions, compliance, health.
+All run against the WORKSPACE gateway (workspace-scoped) except the public health probe.
+`;
+      return {
+        contents: [{ uri: schemaUri, text: schema, mimeType: "text/plain" }]
+      };
+    }
+  );
+  server.registerResource(
+    "theglobalfuel-assets",
+    assetsUri,
+    {
+      title: "Theglobalfuel Asset Registry",
+      description: "The first 50 resource assets in the bound workspace.",
+      mimeType: "application/json"
+    },
+    async () => {
+      ctx.logger.debug(`Resource ${assetsUri} requested`);
+      try {
+        const data = await ctx.gql.workspace.request(LIST_ASSETS, {
+          pagination: { limit: 50, offset: 0 }
+        });
+        return {
+          contents: [
+            {
+              uri: assetsUri,
+              text: JSON.stringify(data.theListAssets, null, 2),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      } catch (error) {
+        return {
+          contents: [
+            {
+              uri: assetsUri,
+              text: JSON.stringify({
+                error: error instanceof Error ? error.message : String(error)
+              }),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      }
+    }
+  );
+  server.registerResource(
+    "theglobalfuel-contracts",
+    contractsUri,
+    {
+      title: "Theglobalfuel Offtake Contracts",
+      description: "The first 50 offtake contracts in the bound workspace.",
+      mimeType: "application/json"
+    },
+    async () => {
+      ctx.logger.debug(`Resource ${contractsUri} requested`);
+      try {
+        const data = await ctx.gql.workspace.request(
+          LIST_CONTRACTS,
+          {
+            pagination: { limit: 50, offset: 0 }
+          }
+        );
+        return {
+          contents: [
+            {
+              uri: contractsUri,
+              text: JSON.stringify(data.theListContracts, null, 2),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      } catch (error) {
+        return {
+          contents: [
+            {
+              uri: contractsUri,
+              text: JSON.stringify({
+                error: error instanceof Error ? error.message : String(error)
+              }),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      }
+    }
+  );
+  server.registerResource(
+    "theglobalfuel-inventory",
+    inventoryUri,
+    {
+      title: "Theglobalfuel Inventory Lots",
+      description: "The first 50 inventory lots in the bound workspace.",
+      mimeType: "application/json"
+    },
+    async () => {
+      ctx.logger.debug(`Resource ${inventoryUri} requested`);
+      try {
+        const data = await ctx.gql.workspace.request(
+          LIST_INVENTORY_LOTS,
+          { pagination: { limit: 50, offset: 0 } }
+        );
+        return {
+          contents: [
+            {
+              uri: inventoryUri,
+              text: JSON.stringify(data.theListInventoryLots, null, 2),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      } catch (error) {
+        return {
+          contents: [
+            {
+              uri: inventoryUri,
+              text: JSON.stringify({
+                error: error instanceof Error ? error.message : String(error)
+              }),
+              mimeType: "application/json"
+            }
+          ]
+        };
+      }
+    }
+  );
+}
+function registerTheglobalfuelPrompts(server, ctx, track) {
+  const p = ctx.productName;
+  const onboardingName = track(mcpPromptName(p, "asset-onboarding"));
+  const opsName = track(mcpPromptName(p, "trade-ops"));
+  server.registerPrompt(
+    onboardingName,
+    {
+      title: "Asset Onboarding",
+      description: "Guide for bringing a new resource asset online: register the asset, capture an initial production record, log a reserve estimate, and transition it into production.",
+      argsSchema: {
+        name: z.string().optional().describe("Asset name"),
+        commodity: z.string().optional().describe("Commodity type")
+      }
+    },
+    ({ name, commodity }) => {
+      ctx.logger.debug(`Prompt ${onboardingName} called`, { name, commodity });
+      const nameNote = name ? `Use the asset name "${name}".` : "Ask the user for the asset name.";
+      const commodityNote = commodity ? `Use commodity ${commodity}.` : "Help the user pick a TheCommodityType.";
+      return {
+        messages: [
+          {
+            role: "user",
+            content: {
+              type: "text",
+              text: `Help me onboard a new Theglobalfuel resource asset.
+
+1. **Register Asset**: Use ${p}_assets_create. ${nameNote} ${commodityNote} Pick the asset kind (well, mine, field, plant, ...) and set capacityPerDay/capacityUnit and workingInterestPct if known.
+2. **Log Reserves**: Use ${p}_reserves_create with the new assetId, an asOfDate, a recoverable quantity, and a reserve category (PROVED/PROBABLE/...).
+3. **Capture Production**: Use ${p}_production_record for the first reporting period (periodStart, periodEnd, volume, unit).
+4. **Verify**: Use ${p}_assets_get to confirm the asset shows its production records and reserve estimates.
+5. **Go Live**: Use ${p}_assets_transition with status=DEVELOPMENT then PRODUCING when the asset is online.
+
+Show results at each step and confirm before transitioning to PRODUCING.`
+            }
+          }
+        ]
+      };
+    }
+  );
+  server.registerPrompt(
+    opsName,
+    {
+      title: "Trade & ESG Operations",
+      description: "Daily operations workflow: review offtake contracts, advance shipments, reconcile inventory, and keep emissions & compliance current.",
+      argsSchema: {
+        contractId: z.string().optional().describe("Contract ID to operate")
+      }
+    },
+    ({ contractId }) => {
+      ctx.logger.debug(`Prompt ${opsName} called`, { contractId });
+      const contractNote = contractId ? `Operate contract "${contractId}".` : `First list contracts with ${p}_contracts_list and pick one.`;
+      return {
+        messages: [
+          {
+            role: "user",
+            content: {
+              type: "text",
+              text: `Run daily Theglobalfuel trade & ESG operations. ${contractNote}
+
+1. **Contracts**: Use ${p}_contracts_list (filter by status=ACTIVE) and ${p}_contracts_get to review delivered vs contracted volume.
+2. **Shipments**: Use ${p}_shipments_list filtered by contractId. Schedule new shipments with ${p}_shipments_schedule and mark arrivals with ${p}_shipments_deliver (this rolls volume into the contract).
+3. **Inventory**: Use ${p}_inventory_list to check available lots; use ${p}_inventory_set_status to RESERVED/IN_TRANSIT/CONSUMED as lots move.
+4. **Emissions**: Use ${p}_emissions_list for the period; record new figures with ${p}_emissions_record and mark audited ones with ${p}_emissions_verify.
+5. **Compliance**: Use ${p}_compliance_list to find permits/licenses near expiry; advance pending ones with ${p}_compliance_transition.
+
+Summarize what needs attention after each step.`
+            }
+          }
+        ]
+      };
+    }
+  );
+}
+
+// src/modules/theglobalfuel/index.ts
+var theglobalfuelModule = {
+  id: "theglobalfuel",
+  version: "0.0.1",
+  displayName: "Theglobalfuel",
+  dependsOn: ["auth"],
+  capabilities: { tools: {}, resources: {}, prompts: {} },
+  register(server, ctx) {
+    const tools = [];
+    const resources = [];
+    const prompts = [];
+    const trackTool = (n) => {
+      tools.push(n);
+      return n;
+    };
+    const trackResource = (uri) => {
+      resources.push(uri);
+      return uri;
+    };
+    const trackPrompt = (n) => {
+      prompts.push(n);
+      return n;
+    };
+    registerAssetTools(server, ctx, trackTool);
+    registerProductionTools(server, ctx, trackTool);
+    registerReserveTools(server, ctx, trackTool);
+    registerContractTools(server, ctx, trackTool);
+    registerShipmentTools(server, ctx, trackTool);
+    registerInventoryTools(server, ctx, trackTool);
+    registerEmissionTools(server, ctx, trackTool);
+    registerComplianceTools(server, ctx, trackTool);
+    registerHealthTools(server, ctx, trackTool);
+    registerTheglobalfuelResources(server, ctx, trackResource);
+    registerTheglobalfuelPrompts(server, ctx, trackPrompt);
+    return { tools, resources, prompts };
+  }
+};
+var theglobalfuel_default = theglobalfuelModule;
+
+export { theglobalfuel_default as default };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map