stargate_info

Instructions

Implementation Reference

• src/system-info-tools.ts:324-372 (handler)

  The main handler function for the 'stargate_info' tool. It processes an array of stargate IDs, fetches data from both ESI and SDE clients, combines the data using combineStargateData, and returns formatted JSON results.

  execute: async (args: { stargateIds: number[] }) => {
    try {
      const results: CombinedStargateInfo[] = [];
  
      for (const stargateId of args.stargateIds) {
        let esiData: ESIStargateInfo | undefined;
        let sdeData: SDEStargateInfo | undefined;
  
        // Fetch from ESI
        try {
          esiData = await esiClient.getStargateInfo(stargateId);
        } catch (error) {
          console.warn(`Failed to fetch ESI data for stargate ${stargateId}:`, error);
        }
  
        // Fetch from SDE
        try {
          sdeData = await sdeClient.getStargateInfo(stargateId);
        } catch (error) {
          console.warn(`Failed to fetch SDE data for stargate ${stargateId}:`, error);
        }
  
        const combined = await combineStargateData(esiData, sdeData);
        if (combined) {
          results.push(combined);
        }
      }
  
      if (results.length === 0) {
        return JSON.stringify({
          success: false,
          message: "No stargate information found for the provided IDs",
          results: []
        });
      }
  
      return JSON.stringify({
        success: true,
        message: `Found information for ${results.length} stargate(s)`,
        results: results
      });
    } catch (error) {
      return JSON.stringify({
        success: false,
        message: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`,
        results: []
      });
    }
  },

• src/system-info-tools.ts:373-376 (schema)

  Input schema definition using Zod, specifying the stargateIds parameter as an array of numbers (1-50 items).

  name: "stargate_info",
  parameters: z.object({
    stargateIds: z.array(z.number()).min(1).max(50).describe("Array of stargate IDs to get information for (max 50). Use numeric IDs only, not names.")
  }),

• src/server.ts:52-52 (registration)

  Registration of the stargateInfoTool object into the FastMCP server instance.

  server.addTool(stargateInfoTool);

• src/system-info-tools.ts:193-247 (helper)

  Helper function that combines ESI and SDE stargate data, resolves names using ESI idsToNames, and formats into CombinedStargateInfo.

  async function combineStargateData(
    esiData?: ESIStargateInfo,
    sdeData?: SDEStargateInfo
  ): Promise<CombinedStargateInfo | null> {
    if (!esiData && !sdeData) return null;
  
    const stargateId = esiData?.stargate_id || sdeData?.stargateID;
    if (!stargateId) return null;
  
    // Collect IDs that need names
    const idsToResolve: number[] = [];
    const systemId = esiData?.system_id || sdeData?.solarSystemID || 0;
    const destStargateId = esiData?.destination?.stargate_id || sdeData?.destinationStargateID || 0;
    const destSystemId = esiData?.destination?.system_id || sdeData?.destinationSolarSystemID || 0;
  
    if (systemId) idsToResolve.push(systemId);
    if (destStargateId) idsToResolve.push(destStargateId);
    if (destSystemId) idsToResolve.push(destSystemId);
  
    // Resolve names
    let nameMap = new Map<number, string>();
    if (idsToResolve.length > 0) {
      try {
        const nameResults = await esiClient.idsToNames(idsToResolve);
        nameMap = new Map(nameResults.map(result => [result.id, result.name]));
      } catch (error) {
        console.warn('Failed to fetch names for stargate data:', error);
      }
    }
  
    return {
      stargate_id: stargateId,
      name: esiData?.name,
      system_id: systemId,
      system_name: nameMap.get(systemId),
      type_id: esiData?.type_id || sdeData?.typeID,
      position: {
        x: esiData?.position?.x || (sdeData?.position ? sdeData.position[0] : 0),
        y: esiData?.position?.y || (sdeData?.position ? sdeData.position[1] : 0),
        z: esiData?.position?.z || (sdeData?.position ? sdeData.position[2] : 0),
      },
      destination: {
        stargate_id: destStargateId,
        stargate_name: nameMap.get(destStargateId),
        system_id: destSystemId,
        system_name: nameMap.get(destSystemId),
      },
      source: {
        esi: !!esiData,
        sde: !!sdeData,
      },
      esi_data: esiData,
      sde_data: sdeData,
    };
  }

• src/system-info-tools.ts:66-89 (schema)

  TypeScript interface defining the structure of the combined stargate information returned by the tool.

  export interface CombinedStargateInfo {
    stargate_id: number;
    name?: string;
    system_id: number;
    system_name?: string;
    type_id?: number;
    position: {
      x: number;
      y: number;
      z: number;
    };
    destination: {
      stargate_id: number;
      stargate_name?: string;
      system_id: number;
      system_name?: string;
    };
    source: {
      esi: boolean;
      sde: boolean;
    };
    esi_data?: ESIStargateInfo;
    sde_data?: SDEStargateInfo;
  }