search_invtypes

Instructions

Implementation Reference

• index.ts:431-455 (handler)

  Handler for search_invtypes tool (shared fall-through cases with other search_* tools). Validates input, derives 'invtypes.txt' filename, checks existence, performs paginated search using searchFile helper, and returns results.

  case "search_varptypes":
  case "search_varbittypes":
  case "search_iftypes":
  case "search_invtypes":
  case "search_loctypes":
  case "search_npctypes":
  case "search_objtypes":
  case "search_rowtypes":
  case "search_seqtypes":
  case "search_soundtypes":
  case "search_spottypes":
  case "search_spritetypes":
  case "search_tabletypes":
      const fileSearchArgs = getSchemaForTool(name).parse(args) as { query: string; page?: number; pageSize?: number };
      const { query, page: filePage = 1, pageSize: filePageSize = 10 } = fileSearchArgs;
      const filename = `${name.replace('search_', '')}.txt`;
      const filePath = path.join(getDataDir(), filename);
      
      if (!fileExists(filename)) {
          return responseToString({ error: `${filename} not found in data directory` });
      }
      
      const fileResults = await searchFile(filePath, query, filePage, filePageSize);
      return responseToString(fileResults);

• index.ts:52-56 (schema)

  Input schema (FileSearchSchema) applied to search_invtypes via getSchemaForTool when name.startsWith('search_'). Defines query, pagination parameters.

  const FileSearchSchema = z.object({
      query: z.string().describe("The term to search for in the file"),
      page: z.number().int().min(1).optional().default(1).describe("Page number for pagination"),
      pageSize: z.number().int().min(1).max(100).optional().default(10).describe("Number of results per page")
  });

• index.ts:326-329 (registration)

  Tool registration/definition for search_invtypes in getToolDefinitions(), returned by listTools handler.

      name: "search_invtypes",
      description: "Search the invtypes.txt file for inventory type definitions in the game.",
  },
  {

• index.ts:102-168 (helper)

  searchFile helper function: core implementation that reads invtypes.txt line-by-line, finds case-insensitive matches (spaces normalized to _), formats ID-value pairs, applies pagination, used by search_invtypes handler.

  async function searchFile(filePath: string, searchTerm: string, page: number = 1, pageSize: number = 10): Promise<any> {
      //replace spaces with underscores
      searchTerm = searchTerm.replace(" ", "_");
      return new Promise((resolve, reject) => {
          if (!fs.existsSync(filePath)) {
              reject(new Error(`File not found: ${filePath}`));
              return;
          }
  
          const results: {line: string, lineNumber: number}[] = [];
          const fileStream = fs.createReadStream(filePath);
          const rl = readline.createInterface({
              input: fileStream,
              crlfDelay: Infinity
          });
  
          let lineNumber = 0;
          
          rl.on('line', (line) => {
              lineNumber++;
              if (line.toLowerCase().includes(searchTerm.toLowerCase())) {
                  results.push({ line, lineNumber });
              }
          });
  
          rl.on('close', () => {
              const totalResults = results.length;
              const totalPages = Math.ceil(totalResults / pageSize);
              const startIndex = (page - 1) * pageSize;
              const endIndex = startIndex + pageSize;
              const paginatedResults = results.slice(startIndex, endIndex);
  
              // Process the results to extract key-value pairs if possible
              const formattedResults = paginatedResults.map(result => {
                  // Try to format as key-value pair (common for ID data files)
                  const parts = result.line.split(/\s+/);
                  if (parts.length >= 2) {
                      const id = parts[0];
                      const value = parts.slice(1).join(' ');
                      return {
                          ...result,
                          id,
                          value,
                          formatted: `${id}\t${value}`
                      };
                  }
                  return result;
              });
  
              resolve({
                  results: formattedResults,
                  pagination: {
                      page,
                      pageSize,
                      totalResults,
                      totalPages,
                      hasNextPage: page < totalPages,
                      hasPreviousPage: page > 1
                  }
              });
          });
  
          rl.on('error', (err) => {
              reject(err);
          });
      });
  }

• index.ts:175-183 (helper)

  fileExists helper: checks if invtypes.txt exists in data directory before searching, called by search_invtypes handler.

  async function fileExists(filename: string): Promise<boolean> {
      const filePath = path.join(getDataDir(), filename);
      try {
          await fs.promises.access(filePath);
          return true;
      } catch {
          return false;
      }
  }