NetscriptDefinitions.d.ts

/**
 * @public
 */
export type _ValueOf<T> = T[keyof T];

/** @public */
type SuccessResult<T extends object> = { success: true; message?: string } & T;
/** @public */
type FailureResult = { success: false; message: string };
/** @public */
type Result<T extends object = object> = SuccessResult<T> | FailureResult;

/** All netscript definitions */

/**
 * Metadata of a file
 * @public
 */
interface FileMetadata {
  /** Time of Access */
  atime: number;
  /** Time of Modification */
  mtime: number;
  /** Time of Birth (creation) */
  btime: number;
}

/** @public */
interface HP {
  current: number;
  max: number;
}

/** @public */
interface Skills {
  hacking: number;
  strength: number;
  defense: number;
  dexterity: number;
  agility: number;
  charisma: number;
  intelligence: number;
}

/** @public */
type ScriptArg = string | number | boolean;

/** @public */
type FilenameOrPID = number | string;

/** @public */
interface Person {
  hp: HP;
  skills: Skills;
  exp: Skills;
  mults: Multipliers;
  city: CityName;
}

/** @public */
interface Player extends Person {
  money: number;
  numPeopleKilled: number;
  entropy: number;
  jobs: Partial<Record<CompanyName, JobName>>;
  factions: FactionName[];
  totalPlaytime: number;
  location: LocationName;
  karma: number;
}

/** @public */
interface SleevePerson extends Person {
  /** Number 0-100 Experience earned and shared is multiplied with shock% before sync% */
  shock: number;
  /** Number 1-100 Experience earned by this sleeve and shared with the player is multiplied with sync% after shock% */
  sync: number;
  /** Number 1-100 initial Value of sync on BN start */
  memory: number;
  /** Number of 200ms cycles which are stored as bonus time */
  storedCycles: number;
}

/** Various info about resets
 * @public */
interface ResetInfo {
  /** Numeric timestamp (from Date.now()) of last augmentation reset */
  lastAugReset: number;
  /** Numeric timestamp (from Date.now()) of last BitNode reset */
  lastNodeReset: number;
  /** The current BitNode */
  currentNode: number;
  /** A map of owned augmentations to their levels. Keyed by the augmentation name. Map values are the augmentation level (e.g. for NeuroFlux governor). */
  ownedAugs: Map<string, number>;
  /**
   * A map of owned source files. Its keys are the SF numbers. Its values are the active SF levels. This map takes
   * BitNode options into account.
   *
   * For example, let's say you have SF 1.3, but you overrode the active level of SF1 and set it to level 1. In this
   * case, this map contains this entry: Key: 1 =\> Value: 1.
   *
   * If the active level of a source file is 0, that source file won't be included in the result.
   */
  ownedSF: Map<number, number>;
  /** Current BitNode options */
  bitNodeOptions: BitNodeOptions;
}

/** @public */
interface MoneySource {
  bladeburner: number;
  casino: number;
  class: number;
  codingcontract: number;
  corporation: number;
  crime: number;
  gang: number;
  gang_expenses: number;
  hacking: number;
  hacknet: number;
  hacknet_expenses: number;
  hospitalization: number;
  infiltration: number;
  sleeves: number;
  stock: number;
  total: number;
  work: number;
  servers: number;
  other: number;
  augmentations: number;
}

/** @public */
interface MoneySources {
  sinceInstall: MoneySource;
  sinceStart: MoneySource;
}

/** @public */
interface Multipliers {
  /** Multiplier to hacking skill */
  hacking: number;
  /** Multiplier to strength skill */
  strength: number;
  /** Multiplier to defense skill */
  defense: number;
  /** Multiplier to dexterity skill */
  dexterity: number;
  /** Multiplier to agility skill */
  agility: number;
  /** Multiplier to charisma skill */
  charisma: number;
  /** Multiplier to hacking experience gain rate */
  hacking_exp: number;
  /** Multiplier to strength experience gain rate */
  strength_exp: number;
  /** Multiplier to defense experience gain rate */
  defense_exp: number;
  /** Multiplier to dexterity experience gain rate */
  dexterity_exp: number;
  /** Multiplier to agility experience gain rate */
  agility_exp: number;
  /** Multiplier to charisma experience gain rate */
  charisma_exp: number;
  /** Multiplier to chance of successfully performing a hack */
  hacking_chance: number;
  /** Multiplier to hacking speed */
  hacking_speed: number;
  /** Multiplier to amount of money the player gains from hacking */
  hacking_money: number;
  /** Multiplier to amount of money injected into servers using grow */
  hacking_grow: number;
  /** Multiplier to amount of reputation gained when working */
  company_rep: number;
  /** Multiplier to amount of reputation gained when working */
  faction_rep: number;
  /** Multiplier to amount of money gained from crimes */
  crime_money: number;
  /** Multiplier to crime success rate */
  crime_success: number;
  /** Multiplier to amount of money gained from phishing and caches on darknet servers */
  dnet_money: number;
  /** Multiplier to amount of money gained from working */
  work_money: number;
  /** Multiplier to amount of money produced by Hacknet Nodes */
  hacknet_node_money: number;
  /** Multiplier to cost of purchasing a Hacknet Node */
  hacknet_node_purchase_cost: number;
  /** Multiplier to cost of ram for a Hacknet Node */
  hacknet_node_ram_cost: number;
  /** Multiplier to cost of core for a Hacknet Node */
  hacknet_node_core_cost: number;
  /** Multiplier to cost of leveling up a Hacknet Node */
  hacknet_node_level_cost: number;
  /** Multiplier to Bladeburner max stamina */
  bladeburner_max_stamina: number;
  /** Multiplier to Bladeburner stamina gain rate */
  bladeburner_stamina_gain: number;
  /** Multiplier to effectiveness in Bladeburner Field Analysis */
  bladeburner_analysis: number;
  /** Multiplier to success chance in Bladeburner contracts/operations */
  bladeburner_success_chance: number;
}

/** @public */
interface TailProperties {
  /** X-coordinate of the log window */
  x: number;
  /** Y-coordinate of the log window */
  y: number;
  /** Width of the log window content area */
  width: number;
  /** Height of the log window content area */
  height: number;
  /** The font size of the log window. Defaults to the font size set in the style editor. */
  fontSize: number;
  /** Whether the log window is minimized. */
  minimized: boolean;
}

/**
 * @public
 * A stand-in for the real React.ReactNode.
 * A {@link ReactElement} is rendered dynamically with React.
 * number and string are displayed directly.
 * boolean, null, and undefined are ignored and not rendered.
 * An array of ReactNodes will display all members of that array sequentially.
 *
 * Use React.createElement to make the ReactElement type, see {@link https://react.dev/reference/react/createElement#creating-an-element-without-jsx | creating an element without jsx} from the official React documentation.
 */
type ReactNode = ReactElement | string | number | null | undefined | boolean | ReactNode[];

/**
 * @public
 * A stand-in for the real React.ReactElement.
 * Use React.createElement to make these.
 * See {@link https://react.dev/reference/react/createElement#creating-an-element-without-jsx | creating an element without jsx} from the official React documentation.
 */
interface ReactElement {
  type: string | ((props: any) => ReactElement | null) | (new (props: any) => object);
  props: any;
  key: string | number | null;
}

/** @public */
interface RunningScript {
  /** Arguments the script was called with */
  args: ScriptArg[];
  /**
   * The dynamic RAM usage of (one thread of) this script instance.
   * Does not affect overall RAM consumption (ramUsage is for that), but
   * rather shows how much of the reserved RAM is currently in use via all the
   * ns functions the script has called. Initially 1.6GB, this increases as
   * new functions are called.
   *
   * Only set for scripts that are still running.
   */
  dynamicRamUsage: number | undefined;
  /** Filename of the script */
  filename: string;
  /**
   * Script logs as an array. The newest log entries are at the bottom.
   * Timestamps, if enabled, are placed inside `[brackets]` at the start of each line.
   **/
  logs: string[];
  /** Total amount of hacking experience earned from this script when offline */
  offlineExpGained: number;
  /** Total amount of money made by this script when offline */
  offlineMoneyMade: number;
  /** Number of seconds that the script has been running offline */
  offlineRunningTime: number;
  /** Total amount of hacking experience earned from this script when online */
  onlineExpGained: number;
  /** Total amount of money made by this script when online */
  onlineMoneyMade: number;
  /** Number of seconds that this script has been running online */
  onlineRunningTime: number;
  /** A Process ID unique to this script across all hosts. Must be an integer starting
   * from 1 for the first process spawned at game launch and incrementing from there.
   * Note that PIDs are not saved in the savegame and are regenerated at launch.
   */
  pid: number;
  /**
   * Process ID of the parent process.
   *
   * If this script was started by another script, this will be the PID of that script.
   * If this script was started directly through the terminal, the value will be 0.
   */
  parent: number;
  /**
   * How much RAM this script uses for ONE thread.
   * Also known as "static RAM usage," this value does not change once the
   * script is started, unless you call ns.ramOverride().
   */
  ramUsage: number;
  /** Hostname of the server on which this script runs */
  server: string;
  /** Properties of the tail window, or null if it is not shown */
  tailProperties: TailProperties | null;
  /**
   * The title, as shown in the script's log box. Defaults to the name + args,
   * but can be changed by the user. If it is set to a React element (only by
   * the user), that will not be persisted, and will be restored to default on
   * load.
   */
  title: string | ReactElement;
  /** Number of threads that this script runs with */
  threads: number;
  /** Whether this RunningScript is excluded from saves */
  temporary: boolean;
}

/** @public */
interface RunOptions {
  /** Number of threads that the script will run with, defaults to 1 */
  threads?: number;
  /** Whether this script is excluded from saves and the "Recently Killed" tab in Active Scripts, defaults to false */
  temporary?: boolean;
  /**
   * The RAM allocation to launch each thread of the script with.
   *
   * Lowering this will <i>not</i> automatically let you get away with using less RAM:
   * the dynamic RAM check enforces that all {@link NS} functions actually called incur their cost.
   * However, if you know that certain functions that are statically present (and thus included
   * in the static RAM cost) will never be called in a particular circumstance, you can use
   * this to avoid paying for them.
   *
   * You can also use this to <i>increase</i> the RAM if the static RAM checker has missed functions
   * that you need to call.
   *
   * Must be greater-or-equal to the base RAM cost. Will be rounded to the nearest hundredth-of-a-GB,
   * which is the granularity of all RAM calculations. Defaults to the statically calculated cost.
   */
  ramOverride?: number;
  /**
   * Should we fail to run if another instance is running with the exact same arguments?
   * This used to be the default behavior, now defaults to false.
   */
  preventDuplicates?: boolean;
}

/** @public */
interface SpawnOptions extends RunOptions {
  /**
   * Number of milliseconds to delay before spawning script, defaults to 10000 (10s).
   * Must be a non-negative integer. If 0, the script will be spawned synchronously.
   */
  spawnDelay?: number;
}

/** @public */
interface RecentScript extends RunningScript {
  /** Timestamp of when the script was killed */
  timeOfDeath: Date;
}

/**
 * Data representing the internal values of a crime.
 * @public
 */
interface CrimeStats {
  /** Number representing the difficulty of the crime. Used for success chance calculations */
  difficulty: number;
  /** Amount of karma lost for successfully committing this crime */
  karma: number;
  /** How many people die as a result of this crime */
  kills: number;
  /** How much money is given */
  money: number;
  /** Milliseconds it takes to attempt the crime */
  time: number;
  /** Description of the crime activity */
  type: string;
  /** Impact of hacking level on success chance of the crime */
  hacking_success_weight: number;
  /** Impact of strength level on success chance of the crime */
  strength_success_weight: number;
  /** Impact of defense level on success chance of the crime */
  defense_success_weight: number;
  /** Impact of dexterity level on success chance of the crime */
  dexterity_success_weight: number;
  /** Impact of agility level on success chance of the crime */
  agility_success_weight: number;
  /** Impact of charisma level on success chance of the crime */
  charisma_success_weight: number;
  /** hacking exp gained from crime */
  hacking_exp: number;
  /** strength exp gained from crime */
  strength_exp: number;
  /** defense exp gained from crime */
  defense_exp: number;
  /** dexterity exp gained from crime */
  dexterity_exp: number;
  /** agility exp gained from crime */
  agility_exp: number;
  /** charisma exp gained from crime */
  charisma_exp: number;
  /** intelligence exp gained from crime */
  intelligence_exp: number;
}

/**
 * Options to affect the behavior of {@link NS.hack | hack}, {@link NS.grow | grow}, and {@link NS.weaken | weaken}.
 * @public
 */
interface BasicHGWOptions {
  /**
   * Number of threads to use for this function.
   * Must be less than or equal to the number of threads the script is running with.
   * Accepts positive non integer values.
   * Defaults to the number of threads the script is running with.
   */
  threads?: number;
  /** Whether to make this action affect the stock market. Defaults to false. */
  stock?: boolean;
  /**
   * Number of additional milliseconds that will be spent waiting between the start of the function and when it
   * completes. Defaults to 0.
   */
  additionalMsec?: number;
}

/**
 * Options to control how a server identifier (hostname or IP address) is returned.
 * Affects the behavior of {@link NS.scan | scan}, {@link Cloud.getServerNames | getServerNames}, and {@link Singularity.getCurrentServer | getCurrentServer}
 * @public
 */
interface HostReturnOptions {
  /** If set to `true`, returns IP addresses instead of hostnames. Defaults to `false`. */
  returnByIP?: boolean;
}

/**
 * Return value of {@link Sleeve.getSleevePurchasableAugs | getSleevePurchasableAugs}
 * @public
 */
interface AugmentPair {
  /** augmentation name */
  name: string;
  /** augmentation cost */
  cost: number;
}

/** @public */
type PositionEnumType = {
  Long: "L";
  Short: "S";
};

/** @public */
type PositionType = _ValueOf<PositionEnumType>;

/** @public */
type OrderEnumType = {
  LimitBuy: "Limit Buy Order";
  LimitSell: "Limit Sell Order";
  StopBuy: "Stop Buy Order";
  StopSell: "Stop Sell Order";
};

/** @public */
type OrderType = _ValueOf<OrderEnumType>;

/**
 * @public
 */
interface StockOrder {
  /** Number of shares */
  shares: number;
  /** Price per share */
  price: number;
  /** Order type */
  type: OrderType;
  /** Order position */
  position: PositionType;
}

/** Constants used for the stock market game mechanic.
 * @public */
interface StockMarketConstants {
  /** Normal time in ms between stock market updates */
  msPerStockUpdate: number;
  /** Minimum time in ms between stock market updates if there is stored offline/bonus time */
  msPerStockUpdateMin: number;
  /** An internal constant used while determining when to flip a stock's forecast */
  TicksPerCycle: number;
  /** Cost of the WSE account */
  WseAccountCost: number;
  /** Cost of the TIX API */
  TixApiCost: number;
  /** Cost of the 4S Market Data */
  MarketData4SCost: number;
  /** Cost of the 4S Market Data TIX API integration */
  MarketDataTixApi4SCost: number;
  /** Commission fee for transactions */
  StockMarketCommission: number;
}

/**
 * A single process on a server.
 * @public
 */
interface ProcessInfo {
  /** Script name. */
  filename: string;
  /** Number of threads script is running with */
  threads: number;
  /** Script's arguments */
  args: ScriptArg[];
  /** Process ID */
  pid: number;
  /** Whether this process is excluded from saves */
  temporary: boolean;
}

/**
 * Hack related multipliers.
 * @public
 */
interface HackingMultipliers {
  /** Player's hacking chance multiplier. */
  chance: number;
  /** Player's hacking speed multiplier. */
  speed: number;
  /** Player's hacking money stolen multiplier. */
  money: number;
  /** Player's hacking growth multiplier */
  growth: number;
}

/**
 * Hacknet related multipliers.
 * @public
 */
interface HacknetMultipliers {
  /** Player's hacknet production multiplier */
  production: number;
  /** Player's hacknet purchase cost multiplier */
  purchaseCost: number;
  /** Player's hacknet ram cost multiplier */
  ramCost: number;
  /** Player's hacknet core cost multiplier */
  coreCost: number;
  /** Player's hacknet level cost multiplier */
  levelCost: number;
}

/**
 * Hacknet node related constants
 * @public
 */
interface HacknetNodeConstants {
  /** Amount of money gained per level */
  MoneyGainPerLevel: number;
  /** Base cost for a new node */
  BaseCost: number;
  /** Base cost per level */
  LevelBaseCost: number;
  /** Base cost to increase RAM */
  RamBaseCost: number;
  /** Base cost to increase cores */
  CoreBaseCost: number;
  /** Multiplier to purchase new node */
  PurchaseNextMult: number;
  /** Multiplier to increase node level */
  UpgradeLevelMult: number;
  /** Multiplier to increase RAM */
  UpgradeRamMult: number;
  /** Multiplier to increase cores */
  UpgradeCoreMult: number;
  /** Max node level */
  MaxLevel: number;
  /** Max amount of RAM in GB */
  MaxRam: number;
  /** Max number of cores */
  MaxCores: number;
}

/**
 * Hacknet server related constants
 * @public
 */
interface HacknetServerConstants {
  /** Number of hashes calculated per level */
  HashesPerLevel: number;
  /** Base cost for a new server */
  BaseCost: number;
  /** Base cost to increase RAM */
  RamBaseCost: number;
  /** Base cost to increase cores */
  CoreBaseCost: number;
  /** Base cost to upgrade cache */
  CacheBaseCost: number;
  /** Multiplier to purchase a new server */
  PurchaseMult: number;
  /** Multiplier to increase server level */
  UpgradeLevelMult: number;
  /** Multiplier to increase RAM */
  UpgradeRamMult: number;
  /** Multiplier to increase cores */
  UpgradeCoreMult: number;
  /** Multiplier to upgrade cache */
  UpgradeCacheMult: number;
  /** Max number of servers */
  MaxServers: number;
  /** Max level for a server */
  MaxLevel: number;
  /** Max amount of RAM in GB */
  MaxRam: number;
  /** Max number of cores */
  MaxCores: number;
  /** Max cache size */
  MaxCache: number;
}

/**
 * A server. Not all servers have all of these properties - optional properties are missing on certain servers.
 * @public
 */
export interface Server {
  /** Hostname. Must be unique */
  hostname: string;
  /** IP Address. Must be unique */
  ip: string;

  /** Whether or not the SSH Port is open */
  sshPortOpen: boolean;
  /** Whether or not the FTP port is open */
  ftpPortOpen: boolean;
  /** Whether or not the SMTP Port is open */
  smtpPortOpen: boolean;
  /** Whether or not the HTTP Port is open */
  httpPortOpen: boolean;
  /** Whether or not the SQL Port is open */
  sqlPortOpen: boolean;

  /** Flag indicating whether player has admin/root access to this server */
  hasAdminRights: boolean;

  /** How many CPU cores this server has. Affects magnitude of grow and weaken ran from this server. */
  cpuCores: number;

  /** Flag indicating whether player is currently connected to this server */
  isConnectedTo: boolean;

  /** RAM (GB) used. i.e. unavailable RAM */
  ramUsed: number;
  /** RAM (GB) available on this server */
  maxRam: number;

  /** Name of company/faction/etc. that this server belongs to, not applicable to all Servers */
  organizationName: string;

  /** Flag indicating whether this is a server owned by the player (e.g., home, cloud servers, hacknet servers) */
  purchasedByPlayer: boolean;

  /** Flag indicating whether this server has a backdoor installed by a player */
  backdoorInstalled?: boolean;

  /** Server's initial server security level at creation. */
  baseDifficulty?: number;

  /** Server Security Level */
  hackDifficulty?: number;

  /** Minimum server security level that this server can be weakened to */
  minDifficulty?: number;

  /** How much money currently resides on the server and can be hacked */
  moneyAvailable?: number;

  /** Maximum amount of money that this server can hold */
  moneyMax?: number;

  /** Number of open ports required in order to gain admin/root access */
  numOpenPortsRequired?: number;

  /** How many ports are currently opened on the server */
  openPortCount?: number;

  /** Hacking level required to hack this server */
  requiredHackingSkill?: number;

  /** Growth effectiveness statistic. Higher values produce more growth with ns.grow() */
  serverGrowth?: number;
}

/**
 * All multipliers affecting the difficulty of the current challenge.
 * @public
 */
interface BitNodeMultipliers {
  /** Influences how quickly the player's agility level (not exp) scales */
  AgilityLevelMultiplier: number;
  /** Influences the base cost to purchase an augmentation. */
  AugmentationMoneyCost: number;
  /** Influences the base rep the player must have with a faction to purchase an augmentation. */
  AugmentationRepCost: number;
  /** Influences how quickly the player can gain rank within Bladeburner. */
  BladeburnerRank: number;
  /** Influences the cost of skill levels from Bladeburner. */
  BladeburnerSkillCost: number;
  /** Influences how quickly the player's charisma level (not exp) scales */
  CharismaLevelMultiplier: number;
  /** Influences the experience gained for each ability when a player completes a class. */
  ClassGymExpGain: number;
  /** Influences the amount of money gained from completing Coding Contracts. */
  CodingContractMoney: number;
  /** Influences the experience gained for each ability when the player completes working their job. */
  CompanyWorkExpGain: number;
  /** Influences how much money the player earns when completing working their job. */
  CompanyWorkMoney: number;
  /** Influences how much rep the player gains when performing work for a company. */
  CompanyWorkRepGain: number;
  /** Influences the amount of divisions a corporation can have at the same time. */
  CorporationDivisions: number;
  /** Influences profits from corporation dividends and selling shares. */
  CorporationSoftcap: number;
  /** Influences the valuation of corporations created by the player. */
  CorporationValuation: number;
  /** Influences the base experience gained for each ability when the player commits a crime. */
  CrimeExpGain: number;
  /** Influences the base money gained when the player commits a crime. */
  CrimeMoney: number;
  /** Influences the success chance of committing crimes */
  CrimeSuccessRate: number;
  /** Influences how many Augmentations you need in order to get invited to the Daedalus faction */
  DaedalusAugsRequirement: number;
  /** Influences how quickly the player's defense level (not exp) scales */
  DefenseLevelMultiplier: number;
  /** Influences how quickly the player's dexterity level (not exp) scales */
  DexterityLevelMultiplier: number;
  /** Influences how much rep the player gains in each faction simply by being a member. */
  FactionPassiveRepGain: number;
  /** Influences the experience gained for each ability when the player completes work for a Faction. */
  FactionWorkExpGain: number;
  /** Influences how much rep the player gains when performing work for a faction or donating to it. */
  FactionWorkRepGain: number;
  /** Influences how much it costs to unlock the stock market's 4S Market Data API */
  FourSigmaMarketDataApiCost: number;
  /** Influences how much it costs to unlock the stock market's 4S Market Data (NOT API) */
  FourSigmaMarketDataCost: number;
  /** Influences the respect gain and money gain of your gang. */
  GangSoftcap: number;
  /** Percentage of unique augs that the gang has. */
  GangUniqueAugs: number;
  /** Percentage multiplier on the effect of the IPvGO rewards  **/
  GoPower: number;
  /** Influences the experienced gained when hacking a server. */
  HackExpGain: number;
  /** Influences how quickly the player's hacking level (not experience) scales */
  HackingLevelMultiplier: number;
  /** Influences how quickly the player's hack(), grow() and weaken() calls run */
  HackingSpeedMultiplier: number;
  /**
   * Influences how much money is produced by Hacknet Nodes.
   * Influences the hash rate of Hacknet Servers (unlocked in BitNode-9)
   */
  HacknetNodeMoney: number;
  /** Influences how much money it costs to upgrade your home computer's RAM */
  HomeComputerRamCost: number;
  /** Influences how much money is gained when the player infiltrates a company. */
  InfiltrationMoney: number;
  /** Influences how much rep the player can gain from factions when selling stolen documents and secrets */
  InfiltrationRep: number;
  /**
   * Influences how much money the player actually gains when they hack a server via the terminal. This is different
   * from ScriptHackMoney. When the player hacks a server via the terminal, the amount of money in that server is
   * reduced, but they do not gain that same amount.
   */
  ManualHackMoney: number;
  /** Influence how much it costs to purchase a cloud server */
  CloudServerCost: number;
  /** Influence how much it costs to purchase a cloud server */
  CloudServerSoftcap: number;
  /** Influences the maximum number of cloud servers you can have */
  CloudServerLimit: number;
  /** Influences the maximum allowed RAM for a cloud server */
  CloudServerMaxRam: number;
  /** Influences the minimum favor the player must have with a faction before they can donate to gain rep. */
  FavorToDonateToFaction: number;
  /** Influences how much money is stolen from a server when the player performs a hack against it. */
  ScriptHackMoney: number;
  /**
   * Influences how much money the player actually gains when a script hacks a server. This is different from
   * ScriptHackMoney. When a script hacks a server, the amount of money in that server is reduced, but the player does
   * not gain that same amount.
   */
  ScriptHackMoneyGain: number;
  /** Influences the growth percentage per cycle against a server. */
  ServerGrowthRate: number;
  /** Influences the maximum money that a server can grow to. */
  ServerMaxMoney: number;
  /** Influences the initial money that a server starts with. */
  ServerStartingMoney: number;
  /** Influences the initial security level (hackDifficulty) of a server. */
  ServerStartingSecurity: number;
  /** Influences the weaken amount per invocation against a server. */
  ServerWeakenRate: number;
  /** Influences how quickly the player's strength level (not exp) scales */
  StrengthLevelMultiplier: number;
  /** Influences the power of the gift. */
  StaneksGiftPowerMultiplier: number;
  /** Influences the size of the gift. */
  StaneksGiftExtraSize: number;
  /** Influences the hacking skill required to backdoor the world daemon. */
  WorldDaemonDifficulty: number;
}

/**
 * Object representing all the values related to a hacknet node.
 * @public
 */
interface NodeStats {
  /** Node's name */
  name: string;
  /** Node's level */
  level: number;
  /** Node's RAM (GB) */
  ram: number;
  /** Node's used RAM (GB) */
  ramUsed?: number;
  /** Node's number of cores */
  cores: number;
  /** Cache level. Only applicable for Hacknet Servers */
  cache?: number;
  /** Hash Capacity provided by this Node. Only applicable for Hacknet Servers */
  hashCapacity?: number;
  /** Node's production per second */
  production: number;
  /** Number of seconds since Node has been purchased */
  timeOnline: number;
  /** Total number of money Node has produced */
  totalProduction: number;
}

/** @public */
interface SourceFileLvl {
  /** The number of the source file */
  n: number;
  /** The level of the source file */
  lvl: number;
}

/**
 * Bladeburner current action.
 * @public
 */
interface BladeburnerCurAction {
  /** Type of Action */
  type: BladeburnerActionType;
  /** Name of Action */
  name: BladeburnerActionName;
}

/** @public */
export type GangTaskNameEnumType = {
  Unassigned: "Unassigned";

  Ransomware: "Ransomware";
  Phishing: "Phishing";
  IdentityTheft: "Identity Theft";
  DDoSAttacks: "DDoS Attacks";
  PlantVirus: "Plant Virus";
  FraudAndCounterfeiting: "Fraud & Counterfeiting";
  MoneyLaundering: "Money Laundering";
  Cyberterrorism: "Cyberterrorism";
  EthicalHacking: "Ethical Hacking";

  MugPeople: "Mug People";
  DealDrugs: "Deal Drugs";
  StrongarmCivilians: "Strongarm Civilians";
  RunACon: "Run a Con";
  ArmedRobbery: "Armed Robbery";
  TraffickIllegalArms: "Traffick Illegal Arms";
  ThreatenAndBlackmail: "Threaten & Blackmail";
  HumanTrafficking: "Human Trafficking";
  Terrorism: "Terrorism";
  VigilanteJustice: "Vigilante Justice";

  TrainCombat: "Train Combat";
  TrainHacking: "Train Hacking";
  TrainCharisma: "Train Charisma";
  TerritoryWarfare: "Territory Warfare";
};

/** @public */
type GangTaskName = _ValueOf<GangTaskNameEnumType>;

/**
 * Gang general info.
 * @public
 */
interface GangGenInfo {
  /** Name of faction that the gang belongs to ("Slum Snakes", etc.) */
  faction: FactionName;
  /** Indicating whether or not it's a hacking gang */
  isHacking: boolean;
  /** Money earned per game cycle */
  moneyGainRate: number;
  /** Gang's power for territory warfare */
  power: number;
  /** Gang's respect */
  respect: number;
  /** Respect earned per game cycle */
  respectGainRate: number;
  /** Amount of Respect needed for next gang recruit, if possible */
  respectForNextRecruit: number;
  /** Amount of territory held, in the range 0-1 */
  territory: number;
  /** Clash chance */
  territoryClashChance: number;
  /** Gang's wanted level */
  wantedLevel: number;
  /** Wanted level gained/lost per game cycle (negative for losses) */
  wantedLevelGainRate: number;
  /** Indicating if territory clashes are enabled */
  territoryWarfareEngaged: boolean;
  /** Number indicating the current wanted penalty */
  wantedPenalty: number;
  /** Gang gives a discount on all equipment. This multiplier is applied to the equipment cost. */
  equipmentCostMult: number;
}

/** @public */
interface GangOtherInfoObject {
  /** Gang power */
  power: number;
  /** Gang territory, in the range 0-1 */
  territory: number;
}

/**
 * Object representing data representing a gang member task.
 * @public
 */
interface GangTaskStats {
  /** Task name */
  name: string;
  /** Task Description */
  desc: string;
  /** Is a task of a hacking gang */
  isHacking: boolean;
  /** Is a task of a combat gang */
  isCombat: boolean;
  /** Base respect earned */
  baseRespect: number;
  /** Base wanted earned */
  baseWanted: number;
  /** Base money earned */
  baseMoney: number;
  /** Hacking skill impact on task scaling */
  hackWeight: number;
  /** Strength skill impact on task scaling */
  strWeight: number;
  /** Defense skill impact on task scaling */
  defWeight: number;
  /** Dexterity skill impact on task scaling */
  dexWeight: number;
  /** Agility skill impact on task scaling */
  agiWeight: number;
  /** Charisma skill impact on task scaling */
  chaWeight: number;
  /** Number representing the difficulty of the task */
  difficulty: number;
  /** Territory impact on task scaling */
  territory: GangTerritory;
}

/**
 * Object representing data representing a gang member equipment.
 * @public
 */
interface EquipmentStats {
  /** Strength multiplier */
  str?: number;
  /** Defense multiplier */
  def?: number;
  /** Dexterity multiplier */
  dex?: number;
  /** Agility multiplier */
  agi?: number;
  /** Charisma multiplier */
  cha?: number;
  /** Hacking multiplier */
  hack?: number;
}

/** @public */
interface GangTerritory {
  /** Money gain impact on task scaling */
  money: number;
  /** Respect gain impact on task scaling */
  respect: number;
  /** Wanted gain impact on task scaling */
  wanted: number;
}
/** @public */
interface GangMemberExpGain {
  /** Hack EXP gain for a member after a given task*/
  hack_exp: number;
  /** Str EXP gain for a member after a given task*/
  str_exp: number;
  /** Def EXP gain for a member after a given task*/
  def_exp: number;
  /** Dex EXP gain for a member after a given task*/
  dex_exp: number;
  /** Agi EXP gain for a member after a given task*/
  agi_exp: number;
  /** Cha EXP gain for a member after a given task*/
  cha_exp: number;
}

/** @public */
interface GangMemberInfo {
  /** Name of the gang member */
  name: string;
  /** Currently assigned task */
  task: string;
  /** Amount of Respect earned by member since they last Ascended */
  earnedRespect: number;

  /** Hack skill level */
  hack: number;
  /** Strength skill level */
  str: number;
  /** Defense skill level */
  def: number;
  /** Dexterity skill level */
  dex: number;
  /** Agility skill level */
  agi: number;
  /** Charisma skill level */
  cha: number;

  /** Current hack experience */
  hack_exp: number;
  /** Current strength experience */
  str_exp: number;
  /** Current defense experience */
  def_exp: number;
  /** Current dexterity experience */
  dex_exp: number;
  /** Current agility experience */
  agi_exp: number;
  /** Current charisma experience */
  cha_exp: number;

  /** Hack multiplier from equipment */
  hack_mult: number;
  /** Strength multiplier from equipment */
  str_mult: number;
  /** Defense multiplier from equipment */
  def_mult: number;
  /** Dexterity multiplier from equipment */
  dex_mult: number;
  /** Agility multiplier from equipment */
  agi_mult: number;
  /** Charisma multiplier from equipment */
  cha_mult: number;

  /** Hack multiplier from ascensions */
  hack_asc_mult: number;
  /** Strength multiplier from ascensions */
  str_asc_mult: number;
  /** Defense multiplier from ascensions */
  def_asc_mult: number;
  /** Dexterity multiplier from ascensions */
  dex_asc_mult: number;
  /** Agility multiplier from ascensions */
  agi_asc_mult: number;
  /** Charisma multiplier from ascensions */
  cha_asc_mult: number;

  /** Total Hack Ascension points accumulated */
  hack_asc_points: number;
  /** Total Strength Ascension points accumulated */
  str_asc_points: number;
  /** Total Defense Ascension points accumulated */
  def_asc_points: number;
  /** Total Dexterity Ascension points accumulated */
  dex_asc_points: number;
  /** Total Agility Ascension points accumulated */
  agi_asc_points: number;
  /** Total Charisma Ascension points accumulated */
  cha_asc_points: number;

  /** List of all non-Augmentation Equipment owned by gang member */
  upgrades: string[];
  /** List of all Augmentations currently installed on gang member */
  augmentations: string[];

  /** Per Cycle Rate this member is currently gaining Respect */
  respectGain: number;
  /** Per Cycle Rate by which this member is affecting your gang's Wanted Level */
  wantedLevelGain: number;
  /** Per Cycle Income for this gang member */
  moneyGain: number;
  /** Per Cycle Exp object for each stat for this gang member.
   *
   * null in the event that the member does not have a given task.
   */
  expGain: GangMemberExpGain | null;
}

/** @public */
interface GangMemberInstall {
  /** Factor by which the hacking ascension multiplier was decreased (newMult / oldMult) */
  hack: number;
  /** Factor by which the strength ascension multiplier was decreased (newMult / oldMult) */
  str: number;
  /** Factor by which the defense ascension multiplier was decreased (newMult / oldMult) */
  def: number;
  /** Factor by which the dexterity ascension multiplier was decreased (newMult / oldMult) */
  dex: number;
  /** Factor by which the agility ascension multiplier was decreased (newMult / oldMult) */
  agi: number;
  /** Factor by which the charisma ascension multiplier was decreased (newMult / oldMult) */
  cha: number;
}

/** @public */
interface GangMemberAscension {
  /** Amount of respect lost from ascending */
  respect: number;
  /** Factor by which the hacking ascension multiplier was increased (newMult / oldMult) */
  hack: number;
  /** Factor by which the strength ascension multiplier was increased (newMult / oldMult) */
  str: number;
  /** Factor by which the defense ascension multiplier was increased (newMult / oldMult) */
  def: number;
  /** Factor by which the dexterity ascension multiplier was increased (newMult / oldMult) */
  dex: number;
  /** Factor by which the agility ascension multiplier was increased (newMult / oldMult) */
  agi: number;
  /** Factor by which the charisma ascension multiplier was increased (newMult / oldMult) */
  cha: number;
}

/** @public */
interface SleeveBladeburnerTask extends BaseTask {
  type: "BLADEBURNER";
  actionType: "General" | "Contracts";
  actionName: string;
  cyclesWorked: number;
  cyclesNeeded: number;
  tasksCompleted: number;
}

/** @public */
interface SleeveClassTask extends BaseTask {
  type: "CLASS";
  classType: UniversityClassType | GymType;
  location: LocationName;
}

/** @public */
interface SleeveCompanyTask extends BaseTask {
  type: "COMPANY";
  companyName: CompanyName;
}

/** @public */
interface SleeveCrimeTask extends BaseTask {
  type: "CRIME";
  crimeType: CrimeType;
  cyclesWorked: number;
  cyclesNeeded: number;
  tasksCompleted: number;
}

/** @public */
interface SleeveFactionTask extends BaseTask {
  type: "FACTION";
  factionWorkType: FactionWorkType;
  factionName: FactionName;
}

/** @public */
interface SleeveInfiltrateTask extends BaseTask {
  type: "INFILTRATE";
  cyclesWorked: number;
  cyclesNeeded: number;
}

/** @public */
interface SleeveRecoveryTask extends BaseTask {
  type: "RECOVERY";
}

/** @public */
interface SleeveSupportTask extends BaseTask {
  type: "SUPPORT";
}

/** @public */
interface SleeveSynchroTask extends BaseTask {
  type: "SYNCHRO";
}

/** Object representing a sleeve current task.
 * @public */
export type SleeveTask =
  | SleeveBladeburnerTask
  | SleeveClassTask
  | SleeveCompanyTask
  | SleeveCrimeTask
  | SleeveFactionTask
  | SleeveInfiltrateTask
  | SleeveRecoveryTask
  | SleeveSupportTask
  | SleeveSynchroTask;

/**
 * Object representing a port. A port is a serialized queue.
 *
 * All methods in this interface can be used while the ns instance is "busy" (they avoid the concurrency check), or even
 * when it is dead.
 * @public
 */
export interface NetscriptPort {
  /** Write data to a port.
   * @remarks
   * RAM cost: 0 GB
   *
   * @param value - Data to write, it's cloned with structuredClone().
   * @returns The data popped off the queue if it was full.
   */
  write(value: any): any;

  /**
   * Attempt to write data to the port.
   * @remarks
   * RAM cost: 0 GB
   *
   * @param value - Data to write, it's cloned with structuredClone().
   * @returns True if the data was added to the port, false if the port was full
   */
  tryWrite(value: any): boolean;

  /**
   * Waits until the port is written to.
   * @remarks
   * RAM cost: 0 GB
   */
  nextWrite(): Promise<void>;

  /**
   * Shift an element out of the port.
   * @remarks
   * RAM cost: 0 GB
   *
   * This function will remove the first element from the port and return it.
   * If the port is empty, then the string “NULL PORT DATA” will be returned.
   * @returns the data read.
   */
  read(): any;

  /**
   * Retrieve the first element from the port without removing it.
   * @remarks
   * RAM cost: 0 GB
   *
   * This function is used to peek at the data from a port. It returns the
   * first element in the specified port without removing that element. If
   * the port is empty, the string “NULL PORT DATA” will be returned.
   * @returns the data read
   */
  peek(): any;

  /**
   * Check if the port is full.
   * @remarks
   * RAM cost: 0 GB
   *
   * @returns true if the port is full, otherwise false
   */
  full(): boolean;

  /**
   * Check if the port is empty.
   * @remarks
   * RAM cost: 0 GB
   *
   * @returns true if the port is empty, otherwise false
   */
  empty(): boolean;

  /**
   * Empties all data from the port.
   * @remarks
   * RAM cost: 0 GB
   */
  clear(): void;
}

/**
 * Stock market API
 * @public
 */
export interface Stock {
  /**
   * Get game constants for the stock market mechanic.
   *
   * @remarks RAM cost: 0 GB
   */
  getConstants(): StockMarketConstants;
  /**
   * Returns true if the player has access to a WSE Account
   * @remarks RAM cost: 0.05 GB
   */
  hasWseAccount(): boolean;
  /**
   * Returns true if the player has access to the TIX API
   * @remarks RAM cost: 0.05 GB
   */
  hasTixApiAccess(): boolean;
  /**
   * Returns true if the player has access to the 4S Data
   * @remarks RAM cost: 0.05 GB
   */
  has4SData(): boolean;
  /**
   * Returns true if the player has access to the 4SData TIX API
   * @remarks RAM cost: 0.05 GB
   */
  has4SDataTixApi(): boolean;
  /**
   * Returns an array of the symbols of the tradable stocks
   *
   * @remarks RAM cost: 2 GB
   * @returns Array of the symbols of the tradable stocks.
   */
  getSymbols(): string[];

  /**
   * Returns the price of a stock.
   *
   * @remarks
   * RAM cost: 2 GB
   *
   * The stock’s price is the average of its bid and ask prices. This function requires
   * that you have the following:
   *
   * - WSE Account
   *
   * - TIX API Access
   *
   * @example
   * ```js
   * const fourSigmaStockPrice = ns.stock.getPrice("FSIG");
   *
   * // Choose the first stock symbol from the array of stock symbols.  Get the price
   * // of the corresponding stock.
   * const sym = ns.stock.getSymbols()[0];
   * ns.tprint("Stock symbol: " + sym);
   * ns.tprint("Stock price: " + ns.stock.getPrice(sym));
   * ```
   * @param sym - Stock symbol.
   * @returns The price of a stock.
   */
  getPrice(sym: string): number;

  /**
   * Returns the organization associated with a stock symbol.
   *
   * @remarks
   * RAM cost: 2 GB
   *
   * The organization associated with the corresponding stock symbol. This function
   * requires that you have the following:
   *
   * - WSE Account
   *
   * - TIX API Access
   *
   * @example
   * ```js
   * ns.stock.getOrganization("FSIG");
   *
   * // Choose the first stock symbol from the array of stock symbols. Get the
   * // organization associated with the corresponding stock symbol.
   * const sym = ns.stock.getSymbols()[0];
   * ns.tprint("Stock symbol: " + sym);
   * ns.tprint("Stock organization: " + ns.stock.getOrganization(sym));
   * ```
   * @param sym - Stock symbol.
   * @returns The organization associated with the stock symbol.
   */
  getOrganization(sym: string): string;

  /**
   * Returns the ask price of that stock.
   * @remarks RAM cost: 2 GB
   *
   * @param sym - Stock symbol.
   * @returns The ask price of a stock.
   */
  getAskPrice(sym: string): number;

  /**
   * Returns the bid price of that stock.
   * @remarks RAM cost: 2 GB
   *
   * @param sym - Stock symbol.
   * @returns The bid price of a stock.
   */
  getBidPrice(sym: string): number;

  /**
   * Returns the player’s position in a stock.
   * @remarks
   * RAM cost: 2 GB
   *
   * Returns an array of four elements that represents the player’s position in a stock.
   *
   * The first element in the returned array is the number of shares the player owns of
   * the stock in the Long position. The second element in the array is the average price
   * of the player’s shares in the Long position.
   *
   * The third element in the array is the number of shares the player owns of the stock
   * in the Short position. The fourth element in the array is the average price of the
   * player’s Short position.
   *
   * All elements in the returned array are numeric.
   *
   * @example
   * ```js
   * const [sharesLong, avgLongPrice, sharesShort, avgShortPrice] = ns.stock.getPosition("ECP");
   * ```
   * @param sym - Stock symbol.
   * @returns Array of four elements that represents the player’s position in a stock.
   */
  getPosition(sym: string): [number, number, number, number];

  /**
   * Returns the maximum number of shares of a stock.
   * @remarks
   * RAM cost: 2 GB
   *
   * This is the maximum amount of the stock that can be purchased
   * in both the Long and Short positions combined.
   *
   * @param sym - Stock symbol.
   * @returns Maximum number of shares that the stock has.
   */
  getMaxShares(sym: string): number;

  /**
   * Calculates cost of buying stocks.
   * @remarks
   * RAM cost: 2 GB
   *
   * Calculates and returns how much it would cost to buy a given number of shares of a stock.
   * This takes into account spread, large transactions influencing the price of the stock and commission fees.
   *
   * @param sym - Stock symbol.
   * @param shares - Number of shares to purchase.
   * @param positionType - Specifies whether the order is a Long ("L") or Short ("S") position.
   * @returns Cost to buy a given number of shares of a stock.
   */
  getPurchaseCost(sym: string, shares: number, positionType: PositionType): number;

  /**
   * Calculate profit of selling stocks.
   * @remarks
   * RAM cost: 2 GB
   *
   * Calculates and returns how much you would gain from selling a given number of shares of a stock.
   * This takes into account spread, large transactions influencing the price of the stock and commission fees.
   *
   * @param sym - Stock symbol.
   * @param shares - Number of shares to sell.
   * @param positionType - Specifies whether the order is a Long ("L") or Short ("S") position.
   * @returns Gain from selling a given number of shares of a stock.
   */
  getSaleGain(sym: string, shares: number, positionType: PositionType): number;

  /**
   * Buy stocks.
   * @remarks
   * RAM cost: 2.5 GB
   *
   * Attempts to purchase shares of a stock using a Market Order.
   *
   * If the player does not have enough money to purchase the specified number of shares,
   * then no shares will be purchased. Remember that every transaction on the stock exchange
   * costs a certain commission fee.
   *
   * If this function successfully purchases the shares, it will return the stock price at which
   * each share was purchased. Otherwise, it will return 0.
   *
   * @param sym - Stock symbol.
   * @param shares - Number of shares to purchase. Must be positive. Will be rounded to the nearest integer.
   * @returns The stock price at which each share was purchased, otherwise 0 if the shares weren't purchased.
   */
  buyStock(sym: string, shares: number): number;

  /**
   * Sell stocks.
   * @remarks
   * RAM cost: 2.5 GB
   *
   * Attempts to sell shares of a stock using a Market Order.
   *
   * If the specified number of shares in the function exceeds the amount that the player
   * actually owns, then this function will sell all owned shares. Remember that every
   * transaction on the stock exchange costs a certain commission fee.
   *
   * The net profit made from selling stocks with this function is reflected in the script’s
   * statistics. This net profit is calculated as:
   *
   *    shares * (sell_price - average_price_of_purchased_shares)
   *
   * If the sale is successful, this function will return the stock price at
   * which each share was sold. Otherwise, it will return 0.
   *
   * @param sym - Stock symbol.
   * @param shares - Number of shares to sell. Must be positive. Will be rounded to the nearest integer.
   * @returns The stock price at which each share was sold, otherwise 0 if the shares weren't sold.
   */
  sellStock(sym: string, shares: number): number;

  /**
   * Short stocks.
   * @remarks
   * RAM cost: 2.5 GB
   *
   * Attempts to purchase a short position of a stock using a Market Order.
   *
   * The ability to short a stock is **not** immediately available to the player and
   * must be unlocked later on in the game.
   *
   * If the player does not have enough money to purchase the specified number of shares,
   * then no shares will be purchased. Remember that every transaction on the stock exchange
   * costs a certain commission fee.
   *
   * If the purchase is successful, this function will return the stock price at which each
   * share was purchased. Otherwise, it will return 0.
   *
   * @param sym - Stock symbol.
   * @param shares - Number of shares to short. Must be positive. Will be rounded to the nearest integer.
   * @returns The stock price at which each share was purchased, otherwise 0 if the shares weren't purchased.
   */
  buyShort(sym: string, shares: number): number;

  /**
   * Sell short stock.
   * @remarks
   * RAM cost: 2.5 GB
   *
   * Attempts to sell a short position of a stock using a Market Order.
   *
   * The ability to short a stock is **not** immediately available to the player and
   * must be unlocked later on in the game.
   *
   * If the specified number of shares exceeds the amount that the player actually owns,
   * then this function will sell all owned shares. Remember that every transaction on
   * the stock exchange costs a certain commission fee.
   *
   * If the sale is successful, this function will return the stock price at which each
   * share was sold. Otherwise, it will return 0.
   *
   * @param sym - Stock symbol.
   * @param shares - Number of shares to sell. Must be positive. Will be rounded to the nearest integer.
   * @returns The stock price at which each share was sold, otherwise 0 if the shares weren't sold.
   */
  sellShort(sym: string, shares: number): number;

  /**
   * Place order for stocks.
   * @remarks
   * RAM cost: 2.5 GB
   *
   * Places an order on the stock market. This function only works for Limit and Stop Orders.
   *
   * The ability to place limit and stop orders is **not** immediately available to the player and
   * must be unlocked later on in the game.
   *
   * Returns true if the order is successfully placed, and false otherwise.
   *
   * @param sym - Stock symbol.
   * @param shares - Number of shares for order. Must be positive. Will be rounded to the nearest integer.
   * @param price - Execution price for the order.
   * @param orderType - Type of order.
   * @param positionType - Specifies whether the order is a Long ("L") or Short ("S") position.
   * @returns True if the order is successfully placed, and false otherwise.
   */
  placeOrder(sym: string, shares: number, price: number, orderType: OrderType, positionType: PositionType): boolean;

  /**
   * Cancel order for stocks.
   * @remarks
   * RAM cost: 2.5 GB
   *
   * Cancels an outstanding Limit or Stop order on the stock market.
   *
   * The ability to use limit and stop orders is **not** immediately available to the player and
   * must be unlocked later on in the game.
   *
   * @param sym - Stock symbol.
   * @param shares - Number of shares for order. Must be positive. Will be rounded to the nearest integer.
   * @param price - Execution price for the order.
   * @param orderType - Type of order.
   * @param positionType - Specifies whether the order is a Long ("L") or Short ("S") position.
   */
  cancelOrder(sym: string, shares: number, price: number, orderType: OrderType, positionType: PositionType): void;

  /**
   * Returns your order book for the stock market.
   * @remarks
   * RAM cost: 2.5 GB
   *
   * This is an object containing information for all the Limit and Stop Orders you have in the stock market.
   * For each symbol you have a position in, the returned object will have a key with that symbol's name.
   * The object's properties are each an array of {@link StockOrder}
   * The object has the following structure:
   *
   * ```js
   * {
   *  string1: [ // Array of orders for this stock
   *      {
   *          shares: Order quantity
   *          price: Order price
   *          type: Order type
   *          position: Either "L" or "S" for Long or Short position
   *      },
   *      {
   *          ...
   *      },
   *      ...
   *  ],
   *  string2: [ // Array of orders for this stock
   *      ...
   *  ],
   *  ...
   * }
   * ```
   * The “Order type” property can have one of the following four values: "Limit Buy Order", "Limit Sell Order",
   * "Stop Buy Order", "Stop Sell Order".
   * Note that the order book will only contain information for stocks that you actually have orders in.
   *
   * @example
   * ```js
   * "If you do not have orders in Nova Medical (NVMD), then the returned object will not have a “NVMD” property."
   * {
   *  ECP: [
   *      {
   *          shares: 5,
   *          price: 100,000
   *          type: "Stop Buy Order",
   *          position: "S",
   *      },
   *      {
   *          shares: 25,
   *          price: 125,000
   *          type: "Limit Sell Order",
   *          position: "L",
   *      },
   *  ],
   *  SYSC: [
   *      {
   *          shares: 100,
   *          price: 10,000
   *          type: "Limit Buy Order",
   *          position: "L",
   *      },
   *  ],
   * }
   * ```
   * @returns Object containing information for all the Limit and Stop Orders you have in the stock market. Keys are
   * stock symbols, and properties are arrays of {@link StockOrder}
   */
  getOrders(): Record<string, StockOrder[]>;

  /**
   * Returns the volatility of the specified stock.
   * @remarks
   * RAM cost: 2.5 GB
   *
   * Volatility represents the maximum percentage by which a stock’s price can change every tick.
   * The volatility is returned in the range 0-1.
   * (e.g. if a stock has a volatility of 3%, then this function will return 0.03, NOT 3).
   *
   * In order to use this function, you must first purchase access to the Four Sigma (4S) Market Data TIX API.
   *
   * @param sym - Stock symbol.
   * @returns Volatility of the specified stock.
   */
  getVolatility(sym: string): number;

  /**
   * Returns the probability that the specified stock’s price will increase (as opposed to decrease) during the next
   * tick.
   * @remarks
   * RAM cost: 2.5 GB
   *
   * The probability is returned in the range 0-1.
   * (e.g. if a stock has a 60% chance of increasing, then this function will return 0.6, NOT 60).
   *
   * In other words, if this function returned 0.30 for a stock, then this means that the stock’s price has a
   * 30% chance of increasing and a 70% chance of decreasing during the next tick.
   *
   * In order to use this function, you must first purchase access to the Four Sigma (4S) Market Data TIX API.
   *
   * @param sym - Stock symbol.
   * @returns Probability that the specified stock’s price will increase (as opposed to decrease) during the next tick.
   */
  getForecast(sym: string): number;

  /**
   * Purchase 4S Market Data UI access (UI only).
   *
   * You need to have a WSE account. Note that this feature only unlocks access to 4S Market Data in the Stock Market
   * UI. If you want to access 4S Market Data via NS APIs, you have to unlock "4S Market Data TIX API access" via
   * {@link Stock.purchase4SMarketDataTixApi | purchase4SMarketDataTixApi}, which is unrelated to this feature.
   *
   * @remarks RAM cost: 2.5 GB
   * @returns True if you successfully purchased it or if you already have access, false otherwise.
   */
  purchase4SMarketData(): boolean;

  /**
   * Purchase 4S Market Data TIX API access (NS APIs only).
   *
   * You need to have TIX API access. Note that this feature only unlocks access to 4S Market Data via NS APIs.
   *
   * @remarks RAM cost: 2.5 GB
   * @returns True if you successfully purchased it or if you already have access, false otherwise.
   */
  purchase4SMarketDataTixApi(): boolean;

  /**
   * Purchase a WSE account.
   *
   * You need to have this account to perform actions via the Stock Market UI. Note that if you want to perform actions
   * via NS APIs, you need to have TIX API access, not this account.
   *
   * @remarks RAM cost: 2.5 GB
   * @returns True if you successfully purchased it or if you already have access, false otherwise.
   */
  purchaseWseAccount(): boolean;

  /**
   * Purchase TIX API access.
   *
   * You need to have TIX API access to perform actions via NS APIs. Note that you can buy TIX API access without a WSE
   * account.
   *
   * @remarks RAM cost: 2.5 GB
   * @returns True if you successfully purchased it or if you already have access, false otherwise.
   */
  purchaseTixApi(): boolean;

  /**
   * Get Stock Market bonus time.
   * @remarks
   * RAM cost: 0 GB
   *
   * “Bonus time” is accumulated when the game is offline or if the game is inactive in the browser.
   *
   * Stock Market prices update more frequently during “bonus time”.
   *
   * @returns Amount of accumulated “bonus time” (milliseconds) for the Stock Market mechanic.
   */
  getBonusTime(): number;

  /**
   * Sleep until the next Stock Market price update has happened.
   * @remarks
   * RAM cost: 0 GB
   *
   * The amount of real time spent asleep between updates can vary due to "bonus time"
   * (usually 4 seconds - 6 seconds).
   *
   * @returns Promise that resolves to the number of milliseconds of Stock Market time
   * that were processed in the previous update (always 6000 ms).
   *
   * @example
   * ```js
   * while (true) {
   *   await ns.stock.nextUpdate();
   *   // Manage your stock portfolio
   * }
   * ```
   */
  nextUpdate(): Promise<number>;
}

/**
 * Base interface of all tasks.
 *
 * @public
 */
interface BaseTask {
  /**
   * This promise resolves when the task completes or is canceled.
   *
   * Tasks that do not track progress, such as studying or working for a company, are non-completable, i.e., they
   * continue indefinitely until canceled. The `nextCompletion` promise of these tasks resolves only when they are
   * canceled.
   *
   * Among completable tasks, some are repeatable, i.e., they automatically restart after completion. The
   * `nextCompletion` promise of these tasks resolves on the next completion or when they are canceled.
   */
  nextCompletion: Promise<void>;
}

/**
 * Base interface of all player tasks.
 *
 * @public
 */
interface PlayerBaseTask extends BaseTask {
  /**
   * The number of game engine cycles has passed since this task started. 1 engine cycle = 200ms.
   */
  cyclesWorked: number;
}

/**
 * Study
 *
 * @remarks
 * An object representing the current study task
 *
 * @public
 */
interface StudyTask extends PlayerBaseTask {
  type: "CLASS";
  classType: string;
  location: LocationName;
}

/**
 * Company Work
 *
 * @remarks
 * An object representing the current work for a company
 *
 * @public
 */
interface CompanyWorkTask extends PlayerBaseTask {
  type: "COMPANY";
  companyName: CompanyName;
}

/**
 * Create Program
 *
 * @remarks
 * An object representing the status of the program being created
 *
 * @public
 */
interface CreateProgramWorkTask extends PlayerBaseTask {
  type: "CREATE_PROGRAM";
  programName: ProgramName;
}

/**
 * Crime
 *
 * @remarks
 * An object representing the crime being committed
 *
 * @public
 */
interface CrimeTask extends PlayerBaseTask {
  type: "CRIME";
  crimeType: CrimeType;
}

/**
 * Faction Work
 *
 * @remarks
 * An object representing the current work for a faction
 *
 * @public
 */
interface FactionWorkTask extends PlayerBaseTask {
  type: "FACTION";
  factionWorkType: FactionWorkType;
  factionName: FactionName;
}

/**
 * Grafting Work
 *
 * @remarks
 * An object representing the current grafting task
 *
 * @public
 */
interface GraftingTask extends PlayerBaseTask {
  type: "GRAFTING";
  augmentation: string;
}

/**
 * Task
 *
 * @remarks
 * Represents any task, such as studying, working for a faction etc.
 *
 * @public
 */
export type Task = StudyTask | CompanyWorkTask | CreateProgramWorkTask | CrimeTask | FactionWorkTask | GraftingTask;

/**
 * Default value:
 *
 * - sourceFileOverrides: an empty Map
 *
 * - intelligenceOverride: undefined
 *
 * - All boolean options: false
 *
 * If you specify intelligenceOverride, it must be a positive integer.
 *
 * @public
 */
export interface BitNodeOptions extends BitNodeBooleanOptions {
  sourceFileOverrides: Map<number, number>;
  intelligenceOverride: number | undefined;
}

/**
 * Note:
 *
 * - restrictHomePCUpgrade: The home computer's maximum RAM and number of cores are lower than normal. Max RAM: 128GB. Max
 * core: 1.
 *
 * - disableSleeveExpAndAugmentation: Your Sleeves do not gain experience when they perform action. You also cannot buy
 * augmentations for them.
 *
 * @public
 */
export interface BitNodeBooleanOptions {
  restrictHomePCUpgrade: boolean;
  disableGang: boolean;
  disableCorporation: boolean;
  disableBladeburner: boolean;
  disable4SData: boolean;
  disableHacknetServer: boolean;
  disableSleeveExpAndAugmentation: boolean;
}

/**
 * Singularity API
 * @remarks
 * This API requires Source-File 4 to use outside of BitNode 4. Additionally, outside of BitNode 4 the RAM cost of all these functions is multiplied by 16/4/1 based on
 * Source-File 4 levels.
 * @public
 */
export interface Singularity {
  /**
   * This function returns the save data.
   *
   * @remarks
   * RAM cost: 1 GB * 16/4/1
   */
  getSaveData(): Promise<Uint8Array<ArrayBuffer>>;

  /**
   * Backup game save.
   * @remarks
   * RAM cost: 1 GB * 16/4/1
   *
   *
   * This function will automatically open the backup save prompt and claim the free faction favour if available.
   *
   */
  exportGame(): Promise<void>;

  /**
   * Returns whether the Export Game bonus is available.
   *
   * This function is deprecated and will be removed in a later version.
   *
   * @deprecated
   * Use {@link Singularity.hasExportGameBonus | hasExportGameBonus} instead.
   *
   * @remarks
   * RAM cost: 0.5 GB * 16/4/1
   */
  exportGameBonus(): boolean;

  /**
   * Returns whether the Export Game bonus is available.
   *
   * @remarks
   * RAM cost: 0.5 GB * 16/4/1
   */
  hasExportGameBonus(): boolean;

  /**
   * Take university class.
   *
   * @remarks
   * RAM cost: 2 GB * 16/4/1
   *
   *
   * This function will automatically set you to start taking a course at a university.
   * If you are already in the middle of some “working” action (such as working at a
   * company, for a faction, or on a program), then running this function will automatically
   * cancel that action and give you your earnings.
   *
   * The cost and experience gains for all of these universities and classes are the same as
   * if you were to manually visit and take these classes.
   *
   * @param universityName - Name of university. You must be in the correct city for whatever university you specify.
   * @param courseName - Name of course.
   * @param focus - Acquire player focus on this class. Optional. Defaults to true.
   * @returns True if action is successfully started, false otherwise.
   */
  universityCourse(universityName: UniversityLocationName, courseName: UniversityClassType, focus?: boolean): boolean;

  /**
   * Workout at the gym.
   *
   * @remarks
   * RAM cost: 2 GB * 16/4/1
   *

   * This function will automatically set you to start working out at a gym to train
   * a particular stat. If you are already in the middle of some “working” action
   * (such as working at a company, for a faction, or on a program), then running
   * this function will automatically cancel that action and give you your earnings.
   *
   * The cost and experience gains for all of these gyms are the same as if you were
   * to manually visit these gyms and train
   *
   * @param gymName - Name of gym. You must be in the correct city for whatever gym you specify.
   * @param stat - The stat you want to train.
   * @param focus - Acquire player focus on this gym workout. Optional. Defaults to true.
   * @returns True if action is successfully started, false otherwise.
   */
  gymWorkout(gymName: GymLocationName, stat: GymType, focus?: boolean): boolean;

  /**
   * Travel to another city.
   * @remarks
   * RAM cost: 2 GB * 16/4/1
   *
   *
   * This function allows the player to travel to any city. The cost for using this
   * function is the same as the cost for traveling through the Travel Agency.
   *
   * @param city - City to travel to.
   * @returns True if action is successful, false otherwise.
   */
  travelToCity(city: CityName): boolean;

  /**
   * Purchase the TOR router.
   * @remarks
   * RAM cost: 2 GB * 16/4/1
   *
   *
   * This function allows you to automatically purchase a TOR router. The cost for
   * purchasing a TOR router using this function is the same as if you were to
   * manually purchase one.
   *
   * @returns True if action is successful or if you already own TOR router, false otherwise.
   */
  purchaseTor(): boolean;

  /**
   * Purchase a program from the dark web.
   * @remarks
   * RAM cost: 2 GB * 16/4/1
   *
   *
   * This function allows you to automatically purchase programs. You MUST have a
   * TOR router in order to use this function. The cost of purchasing programs
   * using this function is the same as if you were purchasing them through the Dark
   * Web using the Terminal buy command.
   *
   * @example
   * ```js
   * const programName = ns.enums.ProgramName.bruteSsh;
   * const success = ns.singularity.purchaseProgram(programName);
   * if (!success) ns.tprint(`ERROR: Failed to purchase ${programName}`);
   * ```
   * @param programName - Name of program to purchase.
   * @returns True if the specified program is purchased or if you already own it, and false otherwise.
   */
  purchaseProgram(programName: ProgramName): boolean;

  /**
   * Check if the player is busy.
   *
   * @remarks
   * RAM cost: 0.5 GB * 16/4/1
   *
   * Returns a boolean indicating if the player is currently performing an action. These actions include:
   *
   * - Studying at a university
   *
   * - Working out at a gym
   *
   * - Working for a company/faction
   *
   * - Creating a program
   *
   * - Committing a crime
   *
   * - Grafting an augmentation
   *
   * Note:
   *
   * - This function returns true when the UI is showing the infiltration UI or the BitVerse.
   *
   * - This function does not take Bladeburner actions into account. You can use {@link Bladeburner.getCurrentAction | getCurrentAction}
   *  to check if you are performing a Bladeburner action.
   *
   * @returns True if the player is currently performing an action, false otherwise.
   */
  isBusy(): boolean;

  /**
   * Stop the current action.
   *
   * @remarks
   * RAM cost: 1 GB * 16/4/1
   *
   * This function stops the action the player is currently performing. The player will receive rewards (money,
   * experience, etc.) they have earned from that action.
   *
   * The actions that can be stopped with this function are:
   *
   * - Studying at a university
   *
   * - Working out at a gym
   *
   * - Working for a company/faction
   *
   * - Creating a program
   *
   * - Committing a crime
   *
   * - Grafting an augmentation
   *
   * This function will return true if the player's action is stopped. It will return false if the player is not
   * performing an action when this function is called.
   *
   * @returns True if the player’s action is stopped, false if the player is not performing an action.
   */
  stopAction(): boolean;

  /**
   * Upgrade home computer RAM.
   * @remarks
   * RAM cost: 3 GB * 16/4/1
   *
   *
   * This function will upgrade amount of RAM on the player’s home computer. The cost is
   * the same as if you were to do it manually.
   *
   * This function will return true if the player’s home computer RAM is successfully upgraded, and false otherwise.
   *
   * @returns True if the player’s home computer RAM is successfully upgraded, and false otherwise.
   */
  upgradeHomeRam(): boolean;

  /**
   * Upgrade home computer cores.
   * @remarks
   * RAM cost: 3 GB * 16/4/1
   *
   *
   * This function will upgrade amount of cores on the player’s home computer. The cost is
   * the same as if you were to do it manually.
   *
   * This function will return true if the player’s home computer cores is successfully upgraded, and false otherwise.
   *
   * @returns True if the player’s home computer cores is successfully upgraded, and false otherwise.
   */
  upgradeHomeCores(): boolean;

  /**
   * Get the price of upgrading home RAM.
   * @remarks
   * RAM cost: 1.5 GB * 16/4/1
   *
   *
   * Returns the cost of upgrading the player’s home computer RAM.
   *
   * @returns Cost of upgrading the player’s home computer RAM.
   */
  getUpgradeHomeRamCost(): number;

  /**
   * Get the price of upgrading home cores.
   * @remarks
   * RAM cost: 1.5 GB * 16/4/1
   *
   *
   * Returns the cost of upgrading the player’s home computer cores.
   *
   * @returns Cost of upgrading the player’s home computer cores.
   */
  getUpgradeHomeCoresCost(): number;

  /**
   * Get Requirements for Company Position.
   * @remarks
   * RAM cost: 2 GB * 16/4/1
   *
   *
   * This function will return an object that contains the requirements for
   * a specific position at a specific country.
   *
   * @example
   * ```js
   * const companyName = "ECorp";
   * const position = "Chief Executive Officer";
   *
   * let requirements = ns.singularity.getCompanyPositionInfo(companyName, position);
   * ```
   * @param companyName - Name of company to get the requirements for. Must be an exact match.
   * @param positionName - Name of position to get the requirements for. Must be an exact match.
   * @returns CompanyPositionInfo object.
   */
  getCompanyPositionInfo(companyName: CompanyName, positionName: JobName): CompanyPositionInfo;

  /**
   * Get List of Company Positions.
   * @remarks
   * RAM cost: 2 GB * 16/4/1
   *
   *
   * This function will return a list of positions at a specific company.
   *
   * This function will return the position list if the company name is valid.
   *
   * @example
   * ```js
   * const companyName = "Noodle Bar";
   * const jobList = ns.singularity.getCompanyPositions(companyName);
   * ```
   * @param companyName - Name of company to get the position list for. Must be an exact match.
   * @returns The position list if the company name is valid.
   */
  getCompanyPositions(companyName: CompanyName): JobName[];

  /**
   * Work for a company.
   * @remarks
   * RAM cost: 3 GB * 16/4/1
   *
   *
   * This function will set you to start working at your current job at a specified company at which you are employed.
   * If you are already in the middle of some “working” action (such as working for a faction, training at a gym, or
   * creating a program), then running this function will cancel that action.
   *
   * This function will return true if the player starts working, and false otherwise.
   *
   * @example
   * ```js
   * const companyName = "Noodle Bar";
   * const success = ns.singularity.workForCompany(companyName);
   * if (!success) ns.tprint(`ERROR: Failed to start work at ${companyName}.`);
   * ```
   * @param companyName - Name of company to work for. Must be an exact match.
   * @param focus - Acquire player focus on this work operation. Optional. Defaults to true.
   * @returns True if the player starts working, and false otherwise.
   */
  workForCompany(companyName: CompanyName, focus?: boolean): boolean;

  /**
   * Quit jobs by company.
   * @remarks
   * RAM cost: 3 GB * 16/4/1
   *
   * This function quits the current work if it's from the provided company.
   *
   * This function affects you and all sleeves. If a sleeve is working for this company, it will stop working and be
   * idle.
   *
   * @param companyName - Name of the company.
   */
  quitJob(companyName: CompanyName): void;

  /**
   * Apply for a job at a company.
   * @remarks
   * RAM cost: 3 GB * 16/4/1
   *
   *
   * This function will automatically try to apply to the specified company
   * for a position in the specified field. This function can also be used to
   * apply for promotions by specifying the company and field you are already
   * employed at.
   *
   * This function will return the job name if you successfully get a job/promotion,
   * and null otherwise. Note that if you are trying to use this function to
   * apply for a promotion and don’t get one, the function will return null.
   *
   * @param companyName - Name of company to apply to.
   * @param field - Field to which you want to apply.
   * @returns Job name if the player successfully get a job/promotion, and null otherwise.
   */
  applyToCompany(companyName: CompanyName, field: JobField): JobName | null;

  /**
   * Get company reputation.
   * @remarks
   * RAM cost: 1 GB * 16/4/1
   *
   *
   * This function will return the amount of reputation you have at the specified company.
   * If the company passed in as an argument is invalid, -1 will be returned.
   *
   * @param companyName - Name of the company.
   * @returns Amount of reputation you have at the specified company.
   */
  getCompanyRep(companyName: CompanyName): number;

  /**
   * Get company favor.
   * @remarks
   * RAM cost: 1 GB * 16/4/1
   *
   *
   * This function will return the amount of favor you have at the specified company.
   * If the company passed in as an argument is invalid, -1 will be returned.
   *
   * @param companyName - Name of the company.
   * @returns Amount of favor you have at the specified company.
   */
  getCompanyFavor(companyName: CompanyName): number;

  /**
   * Get company favor gain.
   * @remarks
   * RAM cost: 0.75 GB * 16/4/1
   *
   *
   * This function will return the amount of favor you will gain for the specified
   * company when you reset by installing Augmentations.
   *
   * @param companyName - Name of the company.
   * @returns Amount of favor you gain at the specified company when you reset by installing Augmentations.
   */
  getCompanyFavorGain(companyName: CompanyName): number;

  /**
   * List conditions for being invited to a faction.
   * @remarks
   * RAM cost: 3 GB * 16/4/1
   *
   * @param faction - Name of the faction
   * @returns Array of PlayerRequirement objects which must all be fulfilled to receive an invitation.
   *
   * @example
   * ```js
   * ns.singularity.getFactionInviteRequirements("The Syndicate");
   *
   * [
   *   { "type": "someCondition", "conditions": [
   *       { "type": "city", "city": "Aevum" },
   *       { "type": "city", "city": "Sector-12" }
   *     ]
   *   },
   *   { "type": "not", "condition": {
   *       "type": "employedBy", "company": "Central Intelligence Agency"
   *     }
   *   },
   *   { "type": "not", "condition": {
   *       "type": "employedBy", "company": "National Security Agency"
   *     }
   *   },
   *   { "type": "money", "money": 10000000 },
   *   { "type": "skills", "skills": { "hacking": 200 } },
   *   { "type": "skills", "skills": { "strength": 200 } },
   *   { "type": "skills", "skills": { "defense": 200 } },
   *   { "type": "skills", "skills": { "dexterity": 200 } },
   *   { "type": "skills", "skills": { "agility": 200 } },
   *   { "type": "karma", "karma": -90 }
   * ]
   * ```
   */
  getFactionInviteRequirements(faction: FactionName): PlayerRequirement[];

  /**
   * Get a list of enemies of a faction.
   * @remarks
   * RAM cost: 3 GB * 16/4/1
   *
   *
   * Returns an array containing the names (as strings) of all factions
   * that are enemies of the specified faction.
   *
   * @param faction - Name of faction.
   * @returns Array containing the names of all enemies of the faction.
   */
  getFactionEnemies(faction: FactionName): string[];

  /**
   * List all current faction invitations.
   * @remarks
   * RAM cost: 3 GB * 16/4/1
   *
   *
   * Performs an immediate check for which factions you qualify for invites from, then returns an array with the name
   * of all Factions you have outstanding invitations from.
   *
   * @returns Array with the name of all Factions you currently have outstanding invitations from.
   */
  checkFactionInvitations(): FactionName[];

  /**
   * Join a faction.
   * @remarks
   * RAM cost: 3 GB * 16/4/1
   *
   *
   * This function will automatically accept an invitation from a faction and join it.
   *
   * Note that this function returns false if you are already a member of the specified faction.
   *
   * @param faction - Name of faction to join.
   * @returns True if the player successfully accepts an invitation, and false otherwise.
   */
  joinFaction(faction: FactionName): boolean;

  /**
   * Work for a faction.
   * @remarks
   * RAM cost: 3 GB * 16/4/1
   *
   *
   * This function will set you to start working for the specified faction. You must be a member of the faction and
   * that faction must have the specified work type, or else this function will fail. If you are already in the
   * middle of some “working” action (such as working for a company, training at a gym, or creating a program), then
   * running this function will cancel that action.
   *
   * This function will return true if you successfully start working for the specified faction, and false otherwise.
   *
   * @example
   * ```js
   * const factionName = "CyberSec";
   * const workType = "hacking";
   *
   * let success = ns.singularity.workForFaction(factionName, workType);
   * if (!success) ns.tprint(`ERROR: Failed to start work for ${factionName} with work type ${workType}.`);
   * ```
   * @param faction - Name of faction to work for.
   * @param workType - Type of work to perform for the faction.
   * @param focus - Acquire player focus on this work operation. Optional. Defaults to true.
   * @returns True if the player starts working, and false otherwise.
   */
  workForFaction(faction: FactionName, workType: FactionWorkType, focus?: boolean): boolean;

  /**
   * Get the work types of a faction.
   * @remarks
   * RAM cost: 1 GB * 16/4/1
   *
   * This function returns an array containing the work types of the specified faction.
   *
   * @param faction - Name of the faction.
   * @returns The work types of the faction.
   */
  getFactionWorkTypes(faction: FactionName): FactionWorkType[];

  /**
   * Get faction reputation.
   * @remarks
   * RAM cost: 1 GB * 16/4/1
   *
   *
   * This function returns the amount of reputation you have for the specified faction.
   *
   * @param faction - Name of faction to work for.
   * @returns Amount of reputation you have for the specified faction.
   */
  getFactionRep(faction: FactionName): number;

  /**
   * Get faction favor.
   * @remarks
   * RAM cost: 1 GB * 16/4/1
   *
   *
   * This function returns the amount of favor you have for the specified faction.
   *
   * @param faction - Name of faction.
   * @returns Amount of favor you have for the specified faction.
   */
  getFactionFavor(faction: FactionName): number;

  /**
   * Get faction favor gain.
   * @remarks
   * RAM cost: 0.75 GB * 16/4/1
   *
   *
   * This function returns the amount of favor you will gain for the specified
   * faction when you reset by installing Augmentations.
   *
   * @param faction - Name of faction.
   * @returns Amount of favor you will gain for the specified faction when you reset by installing Augmentations.
   */
  getFactionFavorGain(faction: FactionName): number;

  /**
   * Donate to a faction.
   * @remarks
   * RAM cost: 5 GB * 16/4/1
   *
   *
   * Attempts to donate money to the specified faction in exchange for reputation.
   * Returns true if you successfully donate the money, and false otherwise.
   *
   * You cannot donate to your gang's faction.
   *
   * The specified faction must offer at least 1 type of work. You can use {@link Singularity.getFactionWorkTypes | getFactionWorkTypes} to get the list of work types of a faction.
   *
   * @param faction - Name of faction to donate to.
   * @param amount - Amount of money to donate.
   * @returns True if the money was donated, and false otherwise.
   */
  donateToFaction(faction: FactionName, amount: number): boolean;

  /**
   * Create a program.
   * @remarks
   * RAM cost: 5 GB * 16/4/1
   *
   *
   * This function will automatically set you to start working on creating the
   * specified program. If you are already in the middle of some “working” action
   * (such as working for a company, training at a gym, or taking a course), then
   * running this function will automatically cancel that action and give you your
   * earnings.
   *
   * This function returns true if you successfully start working on the specified program, and false otherwise.
   *
   * Note that creating a program using this function has the same hacking level requirements as it normally would. You
   * can call {@link Singularity.getHackingLevelRequirementOfProgram | getHackingLevelRequirementOfProgram} to get that
   * value.
   *
   * @example
   * ```js
   * const programName = "BruteSSH.exe";
   * const success = ns.singularity.createProgram(programName);
   * if (!success) ns.tprint(`ERROR: Failed to start working on ${programName}`);
   * ```
   * @param programName - Name of program to create.
   * @param focus - Acquire player focus on this program creation. Optional. Defaults to true.
   * @returns True if you successfully start working on the specified program, and false otherwise.
   */
  createProgram(programName: ProgramName, focus?: boolean): boolean;

  /**
   * Get the hacking level requirement of a program.
   * @remarks
   * RAM cost: 5 GB * 16/4/1
   *
   * In order to create a program via UI or {@link Singularity.createProgram | createProgram}, your hacking level must
   * meet the requirement of that program. This API returns that value.
   *
   * @param programName - Name of program to create.
   * @returns Hacking level requirement. Return Infinity if the specified program cannot be created.
   */
  getHackingLevelRequirementOfProgram(programName: ProgramName): number;

  /**
   * Commit a crime.
   * @remarks
   * RAM cost: 5 GB * 16/4/1
   *
   *
   * This function is used to automatically attempt to commit crimes.
   * If you are already in the middle of some ‘working’ action (such
   * as working for a company or training at a gym), then running this
   * function will automatically cancel that action and give you your
   * earnings.
   *
   * This function returns the number of milliseconds it takes to attempt the
   * specified crime (e.g. It takes 60 seconds to attempt the ‘Rob Store’ crime,
   * so running `commitCrime('Rob Store')` will return 60,000).
   *
   * @param crime - Name of crime to attempt.
   * @param focus - Acquire player focus on this crime. Optional. Defaults to true.
   * @returns The number of milliseconds it takes to attempt the specified crime.
   */
  commitCrime(crime: CrimeType, focus?: boolean): number;

  /**
   * Get chance to successfully commit a crime.
   * @remarks
   * RAM cost: 5 GB * 16/4/1
   *
   *
   * This function returns your chance of success at committing the specified crime.
   *
   * @param crime - Name of crime.
   * @returns Chance of success at committing the specified crime.
   */
  getCrimeChance(crime: CrimeType): number;

  /**
   * Get stats related to a crime.
   * @remarks
   * RAM cost: 5 GB * 16/4/1
   *
   *
   * Returns the stats of the crime.
   *
   * @param crime - Name of crime.
   * @returns The stats of the crime.
   */
  getCrimeStats(crime: CrimeType): CrimeStats;

  /**
   * Get a list of owned augmentation.
   * @remarks
   * RAM cost: 5 GB * 16/4/1
   *
   *
   * This function returns an array containing the names (as strings) of all Augmentations you have.
   *
   * @param purchased - Specifies whether the returned array should include Augmentations you have purchased but not
   *   yet installed. By default, this argument is false which means that the return value will NOT have the purchased
   *   Augmentations.
   * @returns Array containing the names (as strings) of all Augmentations you have.
   */
  getOwnedAugmentations(purchased?: boolean): string[];

  /**
   * Get a list of acquired Source-Files.
   * @remarks
   * RAM cost: 5 GB
   *
   *
   * Returns an array of source files. This function takes BitNode options into account.
   *
   * For example, let's say you have SF 1.3, but you overrode the active level of SF1 and set it to level 1. In this
   * case, this function returns \{"n":1,"lvl":1\}.
   *
   * If the active level of a source file is 0, that source file won't be included in the result.
   *
   * This function does not require owning Source-File 4 or being in BitNode 4. You can also use
   * {@link ResetInfo.ownedSF | ResetInfo.ownedSF} as a lower-RAM alternative.
   *
   * @returns Array containing an object with number and level of the source file.
   */
  getOwnedSourceFiles(): SourceFileLvl[];

  /**
   * Get a list of faction(s) that have a specific Augmentation.
   * @remarks
   * RAM cost: 5 GB * 16/4/1
   *
   *
   * Returns an array containing the names (as strings) of all factions
   * that offer the specified Augmentation.
   * If no factions offer the Augmentation, a blank array is returned.
   *
   * @param augName - Name of Augmentation.
   * @returns Array containing the names of all factions.
   */
  getAugmentationFactions(augName: string): FactionName[];

  /**
   * Get a list of augmentation available from a faction.
   * @remarks
   * RAM cost: 5 GB * 16/4/1
   *
   *
   * Returns an array containing the names (as strings) of all Augmentations
   * that are available from the specified faction.
   *
   * @param faction - Name of faction.
   * @returns Array containing the names of all Augmentations.
   */
  getAugmentationsFromFaction(faction: FactionName): string[];

  /**
   * Get the pre-requisite of an augmentation.
   * @remarks
   * RAM cost: 5 GB * 16/4/1
   *
   *
   * This function returns an array with the names of the prerequisite Augmentation(s) for the specified Augmentation.
   * If there are no prerequisites, a blank array is returned.
   *
   * @param augName - Name of Augmentation.
   * @returns Array with the names of the prerequisite Augmentation(s) for the specified Augmentation.
   */
  getAugmentationPrereq(augName: string): string[];

  /**
   * Get price of an augmentation.
   * @remarks
   * RAM cost: 2.5 GB * 16/4/1
   *
   *
   * @param augName - Name of Augmentation.
   * @returns Price of the augmentation.
   */
  getAugmentationPrice(augName: string): number;

  /**
   * Get base price of an augmentation.
   * @remarks
   * RAM cost: 2.5 GB * 16/4/1
   *
   * This excludes the player's price multiplier, but does include the relevant BitNode multiplier (for all augs that aren't part of Shadows of Anarchy, which doesn't use BitNode multipliers).
   *
   * @param augName - Name of Augmentation.
   * @returns Base price of the augmentation, before the player's price multiplier.
   */
  getAugmentationBasePrice(augName: string): number;

  /**
   * Get reputation requirement of an augmentation.
   * @remarks
   * RAM cost: 2.5 GB * 16/4/1
   *
   *
   * @param augName - Name of Augmentation.
   * @returns Reputation requirement of the augmentation.
   */
  getAugmentationRepReq(augName: string): number;

  /**
   * Purchase an augmentation
   * @remarks
   * RAM cost: 5 GB * 16/4/1
   *
   *
   * This function will try to purchase the specified Augmentation through the given Faction.
   *
   * This function will return true if the Augmentation is successfully purchased, and false otherwise.
   *
   * @param faction - Name of faction to purchase Augmentation from.
   * @param augmentation - Name of Augmentation to purchase.
   * @returns True if the Augmentation is successfully purchased, and false otherwise.
   */
  purchaseAugmentation(faction: FactionName, augmentation: string): boolean;

  /**
   * Get the stats of an augmentation.
   * @remarks
   * RAM cost: 5 GB * 16/4/1
   *
   *
   * This function returns augmentation stats.
   *
   * @param name - Name of Augmentation. CASE-SENSITIVE.
   * @returns Augmentation stats.
   */
  getAugmentationStats(name: string): Multipliers;

  /**
   * Install your purchased augmentations.
   * @remarks
   * RAM cost: 5 GB * 16/4/1
   *
   *
   * This function will automatically install your Augmentations, resetting the game as usual. If you do not own any queued Augmentations then the game will not reset.
   *
   * @param cbScript - This is a script that will automatically be run after Augmentations are installed (after the reset). This script will be run with no arguments and 1 thread. It must be located on your home computer.
   */
  installAugmentations(cbScript?: string): void;

  /**
   * Hospitalize the player.
   * @remarks
   * RAM cost: 0.5 GB * 16/4/1
   */
  hospitalize(): void;

  /**
   * Soft reset the game.
   * @remarks
   * RAM cost: 5 GB * 16/4/1
   *
   *
   * Performs the same reset as when you install Augmentations. This can be used even when no Augmentations are queued. Installs any queued Augmentations.
   *
   * @param cbScript - This is a script that will automatically be run after the reset. This script will be run with no arguments and 1 thread. It must be located on your home computer.
   */
  softReset(cbScript?: string): void;

  /**
   * Go to a location.
   * @remarks
   * RAM cost: 5 GB * 16/4/1
   *
   *
   * Move the player to a specific location.
   *
   * @param locationName - Name of the location.
   * @returns True if the player was moved there, false otherwise.
   */
  goToLocation(locationName: LocationName): boolean;

  /**
   * Get the current server.
   * Returns the hostname by default.
   * @remarks
   * RAM cost: 2 GB * 16/4/1
   *
   * @param returnOpts - Optional. Controls whether the function returns an IP.
   * @returns Hostname or IP address of the current server.
   */
  getCurrentServer(returnOpts?: HostReturnOptions): string;

  /**
   * Displays the content of a file on the currently connected server.
   * @remarks
   * RAM cost: 0.5 * 16/4/1
   *
   * @param filename - Name of the file to display, including its extension.
   */
  cat(filename: string): void;

  /**
   * Connect to a server.
   * @remarks
   * RAM cost: 2 GB * 16/4/1
   *
   *
   * Run the connect HOSTNAME/IP command in the terminal. Can only connect to neighbors.
   *
   * @returns True if the connect command was successful, false otherwise.
   */
  connect(host: string): boolean;

  /**
   * Run the hack command in the terminal.
   * @remarks
   * RAM cost: 2 GB * 16/4/1
   *
   *
   * @returns Amount of money stolen by manual hacking.
   */
  manualHack(): Promise<number>;

  /**
   * Run the backdoor command in the terminal.
   * @remarks
   * RAM cost: 2 GB * 16/4/1
   *
   *
   * @returns Promise waiting for the installation to finish.
   */
  installBackdoor(): Promise<void>;

  /**
   * Check if the player is focused.
   * @remarks
   * RAM cost: 0.1 GB * 16/4/1
   *
   *
   * @returns True if the player is focused.
   */
  isFocused(): boolean;

  /**
   * Set the players focus.
   * @remarks
   * RAM cost: 0.1 GB * 16/4/1
   *
   * @returns True if the focus was changed.
   */
  setFocus(focus: boolean): boolean;

  /**
   * Get a list of programs offered on the dark web.
   * @remarks
   * RAM cost: 0.5 GB * 16/4/1
   *
   *
   * This function allows the player to get a list of programs available for purchase
   * on the dark web. Players MUST have purchased Tor to get the list of programs
   * available. If Tor has not been purchased yet, this function will return an
   * empty list.
   *
   * @example
   * ```js
   * const programs = ns.singularity.getDarkwebPrograms();
   * ns.tprint(`Available programs are: ${programs}`);
   * ```
   * @returns - a list of programs available for purchase on the dark web, or [] if Tor has not
   * been purchased
   */
  getDarkwebPrograms(): ProgramName[];

  /**
   * Check the price of an exploit on the dark web
   * @remarks
   * RAM cost: 0.5 GB * 16/4/1
   *
   *
   * This function allows you to check the price of a darkweb exploit/program.
   * You MUST have a TOR router in order to use this function. The price returned
   * by this function is the same price you would see with buy -l from the terminal.
   * Returns the cost of the program if it has not been purchased yet, 0 if it
   * has already been purchased, or -1 if Tor has not been purchased (and thus
   * the program/exploit is not available for purchase).
   *
   * If the program does not exist, an error is thrown.
   *
   *
   * @example
   * ```js
   * const programName = "BruteSSH.exe";
   * const cost = ns.singularity.getDarkwebProgramCost(programName);
   * if (cost > 0) ns.tprint(`${programName} costs $${ns.format.number(cost)}`);
   * ```
   * @param programName - Name of program to check the price of
   * @returns Price of the specified darkweb program
   * (if not yet purchased), 0 if it has already been purchased, or -1 if Tor has not been
   * purchased. Throws an error if the specified program/exploit does not exist
   */
  getDarkwebProgramCost(programName: ProgramName): number;

  /**
   * b1t_flum3 into a different BN.
   * @remarks
   * RAM cost: 16 GB * 16/4/1
   *
   * @param nextBN - BN number to jump to
   * @param callbackScript - Name of the script to launch in the next BN.
   * @param bitNodeOptions - BitNode options for the next BN.
   */
  b1tflum3(nextBN: number, callbackScript?: string, bitNodeOptions?: BitNodeOptions): void;

  /**
   * Destroy the w0r1d_d43m0n and move on to the next BN.
   * @remarks
   * RAM cost: 32 GB * 16/4/1
   *
   * You must have the special augment installed and the required hacking level
   *   OR
   * Completed the final black op.
   *
   * If you do not want to move on to the next BN and instead stay on the BitVerse screen, you can set nextBN
   * to undefined. Note that with the hacking route, using {@link Singularity.installBackdoor | installBackdoor} is a
   * cheaper way to do this.
   *
   * @param nextBN - BN number to jump to. Passing undefined leaves you on the BitVerse screen.
   * @param callbackScript - Name of the script to launch in the next BN.
   * @param bitNodeOptions - BitNode options for the next BN.
   */
  destroyW0r1dD43m0n(nextBN?: number, callbackScript?: string, bitNodeOptions?: BitNodeOptions): void;

  /**
   * Get the current work the player is doing.
   * @remarks
   * RAM cost: 0.5 GB * 16/4/1
   *
   * @returns - An object representing the current work. Fields depend on the kind of work.
   */
  getCurrentWork(): Task | null;

  /**
   * Get a list of all unlocked achievements.
   * @remarks
   * Ram cost: 5 GB * 16/4/1
   *
   * @returns - A list containing all of the IDs of achievements that the player has unlocked.
   */
  getUnlockedAchievements(): string[];
}

/**
 * Company position requirements and salary.
 * @public
 * @returns - An object representing the requirements and salary for a company/position combination.
 */
export interface CompanyPositionInfo {
  name: JobName;
  field: JobField;
  nextPosition: JobName | null;
  salary: number;
  requiredReputation: number;
  requiredSkills: Skills;
}

/** @public */
type HacknetServerHashUpgrade =
  | "Sell for Money"
  | "Sell for Corporation Funds"
  | "Reduce Minimum Security"
  | "Increase Maximum Money"
  | "Improve Studying"
  | "Improve Gym Training"
  | "Exchange for Corporation Research"
  | "Exchange for Bladeburner Rank"
  | "Exchange for Bladeburner SP"
  | "Generate Coding Contract"
  | "Company Favor";

/**
 * Hacknet API
 * @remarks
 * Not all these functions are immediately available.
 * @public
 */
export interface Hacknet {
  /**
   * Get the number of hacknet nodes you own.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * Returns the number of Hacknet Nodes you own.
   *
   * @returns Number of hacknet nodes.
   */
  numNodes(): number;

  /**
   * Get the maximum number of hacknet nodes.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * @returns Maximum number of hacknet nodes.
   */
  maxNumNodes(): number;

  /**
   * Purchase a new hacknet node.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * Purchases a new Hacknet Node. Returns a number with the index of the
   * Hacknet Node. This index is equivalent to the number at the end of
   * the Hacknet Node’s name (e.g. The Hacknet Node named `hacknet-node-4`
   * will have an index of 4).
   *
   * If the player cannot afford to purchase a new Hacknet Node then the function will return -1.
   *
   * @returns The index of the Hacknet Node or if the player cannot afford to purchase a new Hacknet Node the function will return -1.
   */
  purchaseNode(): number;

  /**
   * Get the price of the next hacknet node.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * Returns the cost of purchasing a new Hacknet Node.
   *
   * @returns Cost of purchasing a new Hacknet Node.
   */
  getPurchaseNodeCost(): number;

  /**
   * Get the stats of a hacknet node.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * Returns an object containing a variety of stats about the specified Hacknet Node.
   *
   * Note that for Hacknet Nodes, production refers to the amount of money the node generates.
   * For Hacknet Servers (the upgraded version of Hacknet Nodes), production refers to the
   * amount of hashes the node generates.
   *
   * @param index - Index/Identifier of Hacknet Node
   * @returns Object containing a variety of stats about the specified Hacknet Node.
   */
  getNodeStats(index: number): NodeStats;

  /**
   * Upgrade the level of a hacknet node.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * Tries to upgrade the level of the specified Hacknet Node by n.
   *
   * Returns true if the Hacknet Node’s level is successfully upgraded by n
   * or if it is upgraded by some positive amount and the Node reaches its max level.
   *
   * Returns false otherwise.
   *
   * @param index - Index/Identifier of Hacknet Node.
   * @param n - Number of levels to purchase. Must be positive. Will be rounded to the nearest integer. Defaults to 1 if not specified.
   * @returns True if the Hacknet Node’s level is successfully upgraded, false otherwise.
   */
  upgradeLevel(index: number, n?: number): boolean;

  /**
   * Upgrade the RAM of a hacknet node.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * Tries to upgrade the specified Hacknet Node’s RAM n times.
   * Note that each upgrade doubles the Node’s RAM.
   * So this is equivalent to multiplying the Node’s RAM by 2 n.
   *
   * Returns true if the Hacknet Node’s RAM is successfully upgraded n times
   * or if it is upgraded some positive number of times and the Node reaches its max RAM.
   *
   * Returns false otherwise.
   *
   * @param index - Index/Identifier of Hacknet Node.
   * @param n - Number of times to upgrade RAM. Must be positive. Will be rounded to the nearest integer. Defaults to 1 if not specified.
   * @returns True if the Hacknet Node’s RAM is successfully upgraded, false otherwise.
   */
  upgradeRam(index: number, n?: number): boolean;

  /**
   * Upgrade the core of a hacknet node.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * Tries to purchase n cores for the specified Hacknet Node.
   *
   * Returns true if it successfully purchases n cores for the Hacknet Node
   * or if it purchases some positive amount and the Node reaches its max number of cores.
   *
   * Returns false otherwise.
   *
   * @param index - Index/Identifier of Hacknet Node.
   * @param n - Number of cores to purchase. Must be positive. Will be rounded to the nearest integer. Defaults to 1 if not specified.
   * @returns True if the Hacknet Node’s cores are successfully purchased, false otherwise.
   */
  upgradeCore(index: number, n?: number): boolean;

  /**
   * Upgrade the cache of a hacknet node.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * This function is only applicable for Hacknet Servers (the upgraded version of a Hacknet Node).
   *
   * Tries to upgrade the specified Hacknet Server’s cache n times.
   *
   * Returns true if it successfully upgrades the Server’s cache n times,
   * or if it purchases some positive amount and the Server reaches its max cache level.
   *
   * Returns false otherwise.
   *
   * @param index - Index/Identifier of Hacknet Node.
   * @param n - Number of cache levels to purchase. Must be positive. Will be rounded to the nearest integer. Defaults to 1 if not specified.
   * @returns True if the Hacknet Node’s cache level is successfully upgraded, false otherwise.
   */
  upgradeCache(index: number, n?: number): boolean;

  /**
   * Calculate the cost of upgrading hacknet node levels.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * Returns the cost of upgrading the specified Hacknet Node by n levels.
   *
   * If an invalid value for n is provided, then this function returns 0.
   * If the specified Hacknet Node is already at max level, then Infinity is returned.
   *
   * @param index - Index/Identifier of Hacknet Node.
   * @param n - Number of levels to upgrade. Must be positive. Will be rounded to the nearest integer. Defaults to 1 if not specified.
   * @returns Cost of upgrading the specified Hacknet Node.
   */
  getLevelUpgradeCost(index: number, n?: number): number;

  /**
   * Calculate the cost of upgrading hacknet node RAM.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * Returns the cost of upgrading the RAM of the specified Hacknet Node n times.
   *
   * If an invalid value for n is provided, then this function returns 0.
   * If the specified Hacknet Node already has max RAM, then Infinity is returned.
   *
   * @param index - Index/Identifier of Hacknet Node.
   * @param n - Number of times to upgrade RAM. Must be positive. Will be rounded to the nearest integer. Defaults to 1 if not specified.
   * @returns Cost of upgrading the specified Hacknet Node's RAM.
   */
  getRamUpgradeCost(index: number, n?: number): number;

  /**
   * Calculate the cost of upgrading hacknet node cores.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * Returns the cost of upgrading the number of cores of the specified Hacknet Node by n.
   *
   * If an invalid value for n is provided, then this function returns 0.
   * If the specified Hacknet Node is already at max level, then Infinity is returned.
   *
   * @param index - Index/Identifier of Hacknet Node.
   * @param n - Number of times to upgrade cores. Must be positive. Will be rounded to the nearest integer. Defaults to 1 if not specified.
   * @returns Cost of upgrading the specified Hacknet Node's number of cores.
   */
  getCoreUpgradeCost(index: number, n?: number): number;

  /**
   * Calculate the cost of upgrading hacknet node cache.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * This function is only applicable for Hacknet Servers (the upgraded version of a Hacknet Node).
   *
   * Returns the cost of upgrading the cache level of the specified Hacknet Server by n.
   *
   * If an invalid value for n is provided, then this function returns 0.
   * If the specified Hacknet Node is already at max level, then Infinity is returned.
   *
   * @param index - Index/Identifier of Hacknet Node.
   * @param n - Number of times to upgrade cache. Must be positive. Will be rounded to the nearest integer. Defaults to 1 if not specified.
   * @returns Cost of upgrading the specified Hacknet Node's cache.
   */
  getCacheUpgradeCost(index: number, n?: number): number;

  /**
   * Get the total number of hashes stored.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * This function is only applicable for Hacknet Servers (the upgraded version of a Hacknet Node).
   *
   * Returns the number of hashes you have.
   *
   * @returns Number of hashes you have.
   */
  numHashes(): number;

  /**
   * Get the maximum number of hashes you can store.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * This function is only applicable for Hacknet Servers (the upgraded version of a Hacknet Node).
   *
   * Returns the number of hashes you can store.
   *
   * @returns Number of hashes you can store.
   */
  hashCapacity(): number;

  /**
   * Get the cost of a hash upgrade.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * This function is only applicable for Hacknet Servers (the upgraded version of a Hacknet Node).
   *
   * Returns the number of hashes required for the specified upgrade. The name of the upgrade must be an exact match.
   *
   * @example
   * ```js
   * const upgradeName = "Sell for Corporation Funds";
   * if (ns.hacknet.numHashes() > ns.hacknet.hashCost(upgradeName)) {
   *   ns.hacknet.spendHashes(upgradeName);
   * }
   * ```
   * @param upgName - Name of the upgrade using hash of Hacknet Server.
   * @param count - Number of upgrades to buy at once. Defaults to 1 if not specified.
   * @returns Number of hashes required for the specified upgrade.
   */
  hashCost(upgName: HacknetServerHashUpgrade, count?: number): number;

  /**
   * Purchase a hash upgrade.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * This function is only applicable for Hacknet Servers (the upgraded version of a Hacknet Node).
   *
   * Spend the hashes generated by your Hacknet Servers on an upgrade.
   * Returns a boolean value - true if the upgrade is successfully purchased, and false otherwise.
   *
   * The name of the upgrade must be an exact match.
   * The `upgTarget` argument is used for upgrades such as `Reduce Minimum Security`, which applies to a specific server.
   * In this case, the `upgTarget` argument must be the hostname or IP of the server.
   *
   * @example
   * ```js
   * // For upgrades where no target is required
   * ns.hacknet.spendHashes("Sell for Corporation Funds");
   * // For upgrades requiring a target
   * ns.hacknet.spendHashes("Increase Maximum Money", "foodnstuff");
   * ```
   * @param upgName - Name of the upgrade using hash of Hacknet Server.
   * @param upgTarget - Object to which upgrade applies. Required for certain upgrades.
   * @param count - Number of upgrades to buy at once. Must be a non-negative integer. Defaults to 1 if not specified.
   * For compatibility reasons, upgTarget must be specified, even if it is not used, in order to specify count.
   * @returns True if the upgrade is successfully purchased, and false otherwise.
   */
  spendHashes(upgName: HacknetServerHashUpgrade, upgTarget?: string, count?: number): boolean;

  /**
   * Get the list of hash upgrades
   * @remarks
   * RAM cost: 0.5 GB
   *
   * This function is only applicable for Hacknet Servers (the upgraded version of a Hacknet Node).
   *
   * Returns the list of all available hash upgrades that can be used in the spendHashes function.
   * @example
   * ```js
   * const upgrades = ns.hacknet.getHashUpgrades(); // ["Sell for Money","Sell for Corporation Funds",...]
   * ```
   * @returns An array containing the available upgrades
   */
  getHashUpgrades(): HacknetServerHashUpgrade[];

  /**
   * Get the level of a hash upgrade.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * This function is only applicable for Hacknet Servers (the upgraded version of a Hacknet Node).
   *
   * @returns Level of the upgrade.
   */
  getHashUpgradeLevel(upgName: HacknetServerHashUpgrade): number;

  /**
   * Get the multiplier to study.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * This function is only applicable for Hacknet Servers (the upgraded version of a Hacknet Node).
   *
   * @returns Multiplier.
   */
  getStudyMult(): number;

  /**
   * Get the multiplier to training.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * This function is only applicable for Hacknet Servers (the upgraded version of a Hacknet Node).
   *
   * @returns Multiplier.
   */
  getTrainingMult(): number;
}

/**
 * Action types of Bladeburner
 *
 * @public
 */
type BladeburnerActionEnumType = {
  General: "General";
  Contract: "Contracts";
  Operation: "Operations";
  BlackOp: "Black Operations";
};

/** @public */
type BladeburnerActionType = _ValueOf<BladeburnerActionEnumType>;

/**
 * General action names of Bladeburner
 *
 * @public
 */
type BladeburnerGeneralActionNameEnumType = {
  Training: "Training";
  FieldAnalysis: "Field Analysis";
  Recruitment: "Recruitment";
  Diplomacy: "Diplomacy";
  HyperbolicRegen: "Hyperbolic Regeneration Chamber";
  InciteViolence: "Incite Violence";
};

/** @public */
type BladeburnerGeneralActionName = _ValueOf<BladeburnerGeneralActionNameEnumType>;

/**
 * Contract names of Bladeburner
 *
 * @public
 */
type BladeburnerContractNameEnumType = {
  Tracking: "Tracking";
  BountyHunter: "Bounty Hunter";
  Retirement: "Retirement";
};

/** @public */
type BladeburnerContractName = _ValueOf<BladeburnerContractNameEnumType>;

/**
 * Operation names of Bladeburner
 *
 * @public
 */
type BladeburnerOperationNameEnumType = {
  Investigation: "Investigation";
  Undercover: "Undercover Operation";
  Sting: "Sting Operation";
  Raid: "Raid";
  StealthRetirement: "Stealth Retirement Operation";
  Assassination: "Assassination";
};

/** @public */
type BladeburnerOperationName = _ValueOf<BladeburnerOperationNameEnumType>;

/**
 * Black Operation names of Bladeburner
 *
 * @public
 */
type BladeburnerBlackOpNameEnumType = {
  OperationTyphoon: "Operation Typhoon";
  OperationZero: "Operation Zero";
  OperationX: "Operation X";
  OperationTitan: "Operation Titan";
  OperationAres: "Operation Ares";
  OperationArchangel: "Operation Archangel";
  OperationJuggernaut: "Operation Juggernaut";
  OperationRedDragon: "Operation Red Dragon";
  OperationK: "Operation K";
  OperationDeckard: "Operation Deckard";
  OperationTyrell: "Operation Tyrell";
  OperationWallace: "Operation Wallace";
  OperationShoulderOfOrion: "Operation Shoulder of Orion";
  OperationHyron: "Operation Hyron";
  OperationMorpheus: "Operation Morpheus";
  OperationIonStorm: "Operation Ion Storm";
  OperationAnnihilus: "Operation Annihilus";
  OperationUltron: "Operation Ultron";
  OperationCenturion: "Operation Centurion";
  OperationVindictus: "Operation Vindictus";
  OperationDaedalus: "Operation Daedalus";
};

/** @public */
type BladeburnerBlackOpName = _ValueOf<BladeburnerBlackOpNameEnumType>;

/**
 * Skill names type of Bladeburner
 *
 * @public
 */
type BladeburnerSkillNameEnumType = {
  BladesIntuition: "Blade's Intuition";
  Cloak: "Cloak";
  ShortCircuit: "Short-Circuit";
  DigitalObserver: "Digital Observer";
  Tracer: "Tracer";
  Overclock: "Overclock";
  Reaper: "Reaper";
  EvasiveSystem: "Evasive System";
  Datamancer: "Datamancer";
  CybersEdge: "Cyber's Edge";
  HandsOfMidas: "Hands of Midas";
  Hyperdrive: "Hyperdrive";
};

/** @public */
type BladeburnerSkillName = _ValueOf<BladeburnerSkillNameEnumType>;

/**
 * @public
 */
export type BladeburnerActionName =
  | BladeburnerGeneralActionName
  | BladeburnerContractName
  | BladeburnerOperationName
  | BladeburnerBlackOpName;

/**
 * These special Bladeburner action types are only for Sleeve
 *
 * @public
 */
type SpecialBladeburnerActionEnumTypeForSleeve = {
  InfiltrateSynthoids: "Infiltrate Synthoids";
  SupportMainSleeve: "Support main sleeve";
  TakeOnContracts: "Take on contracts";
};

/** @public */
type SpecialBladeburnerActionTypeForSleeve = _ValueOf<SpecialBladeburnerActionEnumTypeForSleeve>;

/**
 * @public
 */
export type BladeburnerActionTypeForSleeve =
  | Exclude<BladeburnerGeneralActionName, BladeburnerGeneralActionNameEnumType["InciteViolence"]>
  | SpecialBladeburnerActionTypeForSleeve;

/**
 * Bladeburner API
 * @remarks
 * You have to be employed in the Bladeburner division and be in BitNode 6/7 or have Source-File 6/7 in order to use
 * this API.
 * @public
 */
export interface Bladeburner {
  /**
   * List all contracts.
   * @remarks
   * RAM cost: 0 GB
   *
   * Returns an array of strings containing the names of all Bladeburner contracts.
   *
   * @returns Array of strings containing the names of all Bladeburner contracts.
   */
  getContractNames(): BladeburnerContractName[];

  /**
   * List all operations.
   * @remarks
   * RAM cost: 0 GB
   *
   * Returns an array of strings containing the names of all Bladeburner operations.
   *
   * @returns Array of strings containing the names of all Bladeburner operations.
   */
  getOperationNames(): BladeburnerOperationName[];

  /**
   * List all black ops.
   * @remarks
   * RAM cost: 0 GB
   *
   * Returns an array of strings containing the names of all Bladeburner Black Ops.
   *
   * @returns Array of strings containing the names of all Bladeburner Black Ops.
   */
  getBlackOpNames(): BladeburnerBlackOpName[];

  /**
   * Get an object with the name and rank requirement of the next BlackOp that can be completed.
   * @remarks
   * RAM cost: 2 GB
   *
   * Returns the name and rank requirement for the available BlackOp.
   * Returns `null` if no BlackOps remain in the BitNode.
   *
   * @returns An object with the `.name` and `.rank` properties of the available BlackOp, or `null`.
   */
  getNextBlackOp(): { name: BladeburnerBlackOpName; rank: number } | null;

  /**
   * List all general actions.
   * @remarks
   * RAM cost: 0 GB
   *
   * Returns an array of strings containing the names of all general Bladeburner actions.
   *
   * @returns Array of strings containing the names of all general Bladeburner actions.
   */
  getGeneralActionNames(): BladeburnerGeneralActionName[];

  /**
   * List all skills.
   * @remarks
   * RAM cost: 0 GB
   *
   * Returns an array of strings containing the names of all general Bladeburner skills.
   *
   * @returns Array of strings containing the names of all general Bladeburner skills.
   */
  getSkillNames(): BladeburnerSkillName[];

  /**
   * Start an action.
   * @remarks
   * RAM cost: 4 GB
   *
   * Attempts to start the specified Bladeburner action.
   * Returns true if the action was started successfully, and false otherwise.
   *@example
   * ```js
   * ns.bladeburner.startAction("Contracts", "Tracking")
   *
   * // This will start the Bladeburner Contracts action of Tracking
   * ```
   *
   * @param type - Type of action.
   * @param name - Name of action. Must be an exact match
   * @returns True if the action was started successfully, and false otherwise.
   */
  startAction(type: BladeburnerActionType, name: BladeburnerActionName): boolean;

  /**
   * Stop current action.
   * @remarks
   * RAM cost: 2 GB
   *
   * Stops the current Bladeburner action.
   *
   */
  stopBladeburnerAction(): void;

  /**
   * Get current action.
   * @remarks
   * RAM cost: 1 GB
   *
   * @returns Object that represents the player’s current Bladeburner action, or null if no action is being performed.
   */
  getCurrentAction(): BladeburnerCurAction | null;

  /**
   * Get the time to complete an action.
   * @remarks
   * RAM cost: 4 GB
   *
   * Returns the number of milliseconds it takes to complete the specified action
   *
   * @param type - Type of action.
   * @param name - Name of action. Must be an exact match.
   * @returns Number of milliseconds it takes to complete the specified action.
   */
  getActionTime(type: BladeburnerActionType, name: BladeburnerActionName): number;

  /**
   * Get the time elapsed on current action.
   * @remarks
   * RAM cost: 4 GB
   *
   * Returns the number of milliseconds already spent on the current action.
   *
   * @returns Number of milliseconds already spent on the current action.
   */
  getActionCurrentTime(): number;

  /**
   * Get estimate success chance of an action.
   * @remarks
   * RAM cost: 4 GB
   *
   * Returns the estimated success chance for the specified action.
   * This chance is returned in the range 0-1.
   * (e.g. if you have an estimated success chance of 80%, then this function will return 0.8, NOT 80).
   * Returns 2 values, value[0] - MIN Chance, value[1] - MAX Chance
   *
   * @param type - Type of action.
   * @param name - Name of action. Must be an exact match.
   * @param sleeveNumber - Optional. Index of the sleeve to retrieve information.
   * @returns Estimated success chance for the specified action.
   */
  getActionEstimatedSuccessChance(
    type: BladeburnerActionType,
    name: BladeburnerActionName,
    sleeveNumber?: number,
  ): [number, number];

  /**
   * Get the reputation gain of an action.
   * @remarks
   * RAM cost: 4 GB
   *
   * Returns the average reputation gain for successfully completing the specified action.
   * Note that this value is an "average" and the actual reputation gain may vary slightly from this value.
   *
   * @param type - Type of action.
   * @param name - Name of action. Must be an exact match.
   * @param level - Optional. Action level at which to calculate the gain. Defaults to the action's current level if not specified.
   * @returns Average reputation gain for successfully completing the specified action.
   */
  getActionRepGain(type: BladeburnerActionType, name: BladeburnerActionName, level?: number): number;

  /**
   * Get the rank gain of an action.
   * @remarks
   * RAM cost: 4 GB
   *
   * Returns the average rank gain for successfully completing the specified action.
   * Note that this value is an "average" and the actual rank gain may vary slightly from this value.
   *
   * @param type - Type of action.
   * @param name - Name of action. Must be an exact match.
   * @param level - Optional. Action level at which to calculate the gain. Defaults to the action's current level if not specified.
   * @returns Average rank gain for successfully completing the specified action.
   */
  getActionRankGain(type: BladeburnerActionType, name: BladeburnerActionName, level?: number): number;

  /**
   * Get the rank loss of an action.
   * @remarks
   * RAM cost: 4 GB
   *
   * Returns the average rank loss for failing to complete the specified action.
   * Note that this value is an "average" and the actual rank loss may vary slightly from this value.
   *
   * @param type - Type of action.
   * @param name - Name of action. Must be an exact match.
   * @param level - Optional. Action level at which to calculate the loss. Defaults to the action's current level if not specified.
   * @returns Average rank loss for failing to complete the specified action.
   */
  getActionRankLoss(type: BladeburnerActionType, name: BladeburnerActionName, level?: number): number;

  /**
   * Get action count remaining.
   * @remarks
   * RAM cost: 4 GB
   *
   * Returns the remaining count of the specified action.
   *
   * Note:
   *
   * - This function is meant to be used for Contracts and Operations. It returns Infinity for General actions
   * (Training, Field Analysis, etc.). It returns 1 for BlackOps not yet completed, regardless of whether the player has
   * the required rank to attempt the mission.
   *
   * - With Contracts and Operations, the returned value is a floating-point number. The UI shows the rounded-down
   * value.
   *
   * @param type - Type of action.
   * @param name - Name of action. Must be an exact match.
   * @returns Remaining count of the specified action.
   */
  getActionCountRemaining(type: BladeburnerActionType, name: BladeburnerActionName): number;

  /**
   * Get the maximum level of an action.
   * @remarks
   * RAM cost: 4 GB
   *
   * Returns the maximum level for this action.
   *
   * Returns -1 if an invalid action is specified.
   *
   * @param type - Type of action.
   * @param name - Name of action. Must be an exact match.
   * @returns Maximum level of the specified action.
   */
  getActionMaxLevel(type: BladeburnerActionType, name: BladeburnerActionName): number;

  /**
   * Get the current level of an action.
   * @remarks
   * RAM cost: 4 GB
   *
   * Returns the current level of this action.
   *
   * Returns -1 if an invalid action is specified.
   *
   * @param type - Type of action.
   * @param name - Name of action. Must be an exact match.
   * @returns Current level of the specified action.
   */
  getActionCurrentLevel(type: BladeburnerActionType, name: BladeburnerActionName): number;

  /**
   * Get whether an action is set to autolevel.
   * @remarks
   * RAM cost: 4 GB
   *
   * Return a boolean indicating whether or not this action is currently set to autolevel.
   *
   * Returns false if an invalid action is specified.
   *
   * @param type - Type of action.
   * @param name - Name of action. Must be an exact match.
   * @returns True if the action is set to autolevel, and false otherwise.
   */
  getActionAutolevel(type: BladeburnerActionType, name: BladeburnerActionName): boolean;

  /**
   * Get action successes.
   * @remarks
   * RAM cost: 4 GB
   *
   * Return a number with how many successes you have with action.
   *
   * @param type - Type of action.
   * @param name - Name of action. Must be an exact match.
   * @returns a number with how many successes you have with action.
   */
  getActionSuccesses(type: BladeburnerActionType, name: BladeburnerActionName): number;

  /**
   * Set an action autolevel.
   * @remarks
   * RAM cost: 4 GB
   *
   * Enable/disable autoleveling for the specified action.
   *
   * @param type - Type of action.
   * @param name - Name of action. Must be an exact match.
   * @param autoLevel - Whether or not to autolevel this action
   */
  setActionAutolevel(type: BladeburnerActionType, name: BladeburnerActionName, autoLevel: boolean): void;

  /**
   * Set the level of an action.
   * @remarks
   * RAM cost: 4 GB
   *
   * Set the level for the specified action.
   *
   * @param type - Type of action.
   * @param name - Name of action. Must be an exact match.
   * @param level - Level to set this action to.
   */
  setActionLevel(type: BladeburnerActionType, name: BladeburnerActionName, level: number): void;

  /**
   * Get player bladeburner rank.
   * @remarks
   * RAM cost: 4 GB
   *
   * Returns the player’s Bladeburner Rank.
   *
   * @returns Player’s Bladeburner Rank.
   */
  getRank(): number;

  /**
   * Get black op required rank.
   * @remarks
   * RAM cost: 2 GB
   *
   * Returns the rank required to complete this BlackOp.
   *
   * Returns -1 if an invalid action is specified.
   *
   * @param name - Name of BlackOp. Must be an exact match.
   * @returns Rank required to complete this BlackOp.
   */
  getBlackOpRank(name: BladeburnerBlackOpName): number;

  /**
   * Get bladeburner skill points.
   * @remarks
   * RAM cost: 4 GB
   *
   * Returns the number of Bladeburner skill points you have.
   *
   * @returns Number of Bladeburner skill points you have.
   */
  getSkillPoints(): number;

  /**
   * Get skill level.
   * @remarks
   * RAM cost: 4 GB
   *
   * This function returns your level in the specified skill.
   *
   * The function returns -1 if an invalid skill name is passed in.
   *
   * @param skillName - Name of skill. Case-sensitive and must be an exact match.
   * @returns Level in the specified skill.
   */
  getSkillLevel(skillName: BladeburnerSkillName): number;

  /**
   * Get cost to upgrade skill.
   * @remarks
   * RAM cost: 4 GB
   *
   * This function returns the number of skill points needed to upgrade the specified skill the specified number of times.
   *
   * The function may return 0 or Infinity in special cases:
   *
   * - Return 0 if the current skill level is too high and the specified count is too small. In normal situations, you
   * don't need to worry about this case. It only happens when involved numbers surpass Number.MAX_SAFE_INTEGER and be
   * affected by the floating-point inaccuracy.
   *
   * - Return Infinity if the sum of the current level and count exceeds the maximum level.
   *
   * {@link BladeburnerFormulas.skillMaxUpgradeCount | skillMaxUpgradeCount} is the inverse function of this one.
   *
   * @param skillName - Name of skill. Case-sensitive and must be an exact match.
   * @param count - Number of times to upgrade the skill. Defaults to 1 if not specified.
   * @returns Number of skill points needed to upgrade the specified skill.
   */
  getSkillUpgradeCost(skillName: BladeburnerSkillName, count?: number): number;

  /**
   * Upgrade skill.
   * @remarks
   * RAM cost: 4 GB
   *
   * Attempts to upgrade the specified Bladeburner skill the specified number of times.
   *
   * Returns true if the skill is successfully upgraded, and false otherwise.
   *
   * @param skillName - Name of skill to be upgraded. Case-sensitive and must be an exact match.
   * @param count - Number of times to upgrade the skill. Defaults to 1 if not specified.
   * @returns true if the skill is successfully upgraded, and false otherwise.
   */
  upgradeSkill(skillName: BladeburnerSkillName, count?: number): boolean;

  /**
   * Get team size.
   * @remarks
   * RAM cost: 4 GB
   *
   * Returns the number of available Bladeburner team members.
   * You can also pass the type and name of an action to get the number of
   * Bladeburner team members you have assigned to the specified action.
   *
   * Setting a team is only applicable for Operations and BlackOps. This function will return 0 for other action types.
   *
   * @param type - Type of action.
   * @param name - Name of action. Must be an exact match.
   * @returns Number of Bladeburner team members that were assigned to the specified action.
   */
  getTeamSize(type?: BladeburnerActionType, name?: BladeburnerActionName): number;

  /**
   * Set team size.
   * @remarks
   * RAM cost: 4 GB
   *
   * Set the team size for the specified Bladeburner action.
   *
   * Returns the team size that was set, or -1 if the function failed.
   *
   * @param type - Type of action.
   * @param name - Name of action. Must be an exact match.
   * @param size - Number of team members to set. Must be a non-negative integer.
   * @returns Number of Bladeburner team members you assigned to the specified action.
   */
  setTeamSize(type: BladeburnerActionType, name: BladeburnerActionName, size: number): number;

  /**
   * Get estimated population in city.
   * @remarks
   * RAM cost: 4 GB
   *
   * Returns the estimated number of Synthoids in the specified city,
   * or -1 if an invalid city was specified.
   *
   * @param city - Name of city. Case-sensitive
   * @returns Estimated number of Synthoids in the specified city.
   */
  getCityEstimatedPopulation(city: CityName): number;

  /**
   * Get number of communities in a city.
   * @remarks
   * RAM cost: 4 GB
   *
   * Returns the estimated number of Synthoid communities in the specified city,
   * or -1 if an invalid city was specified.
   *
   * @param city - Name of city. Case-sensitive
   * @returns Number of Synthoids communities in the specified city.
   */
  getCityCommunities(city: CityName): number;

  /**
   * Get chaos of a city.
   * @remarks
   * RAM cost: 4 GB
   *
   * Returns the chaos in the specified city,
   * or -1 if an invalid city was specified.
   *
   * @param city - Name of city. Case-sensitive
   * @returns Chaos in the specified city.
   */
  getCityChaos(city: CityName): number;

  /**
   * Get current city.
   * @remarks
   * RAM cost: 4 GB
   *
   * Returns the city that the player is currently in (for Bladeburner).
   *
   * @returns City that the player is currently in (for Bladeburner).
   */
  getCity(): CityName;

  /**
   * Travel to another city in Bladeburner.
   * @remarks
   * RAM cost: 4 GB
   *
   * Attempts to switch to the specified city (for Bladeburner only).
   *
   * Returns true if successful, and false otherwise
   *
   * @param city - Name of city. Case-sensitive
   * @returns true if successful, and false otherwise
   */
  switchCity(city: CityName): boolean;

  /**
   * Get Bladeburner stamina.
   * @remarks
   * RAM cost: 4 GB
   *
   * Returns an array with two elements: [Current stamina, Max stamina]
   * @example
   * ```js
   * function getStaminaPercentage() {
   *    const [current, max] = ns.bladeburner.getStamina();
   *    return current / max;
   * }
   * ```
   * @returns Array containing current stamina and max stamina.
   */
  getStamina(): [number, number];

  /**
   * Join the Bladeburner faction.
   * @remarks
   * RAM cost: 4 GB
   *
   * Attempts to join the Bladeburner faction.
   *
   * Returns true if you successfully join the Bladeburner faction, or if you are already a member.
   *
   * Returns false otherwise.
   *
   * @returns True if you successfully join the Bladeburner faction, or if you are already a member, false otherwise.
   */
  joinBladeburnerFaction(): boolean;

  /**
   * Join the Bladeburner division.
   * @remarks
   * RAM cost: 4 GB
   *
   * Attempts to join the Bladeburner division.
   *
   * Requirements: All combat stats must be at least level 100.
   *
   * If you have SF 7.3, you will immediately receive "The Blade's Simulacrum" augmentation and won't be able to accept
   * Stanek's Gift after joining. If you want to accept Stanek's Gift, you must do that before calling this API.
   *
   * Returns true if you successfully join the Bladeburner division, or if you are already a member.
   *
   * Returns false otherwise.
   *
   * @returns True if you successfully join the Bladeburner division, or if you are already a member, false otherwise.
   */
  joinBladeburnerDivision(): boolean;

  /**
   * Get Bladeburner bonus time.
   * @remarks
   * RAM cost: 0 GB
   *
   * Returns the amount of accumulated “bonus time” (milliseconds) for the Bladeburner mechanic.
   *
   * “Bonus time” is accumulated when the game is offline or if the game is inactive in the browser.
   *
   * “Bonus time” makes the game progress faster, up to 5x the normal speed.
   * For example, if an action takes 30 seconds to complete, but you’ve accumulated over
   * 30 seconds in bonus time, then the action will only take 6 seconds in real life to complete.
   *
   * @returns Amount of accumulated “bonus time” (milliseconds) for the Bladeburner mechanic.
   */
  getBonusTime(): number;

  /**
   * Sleep until the next Bladeburner update has happened.
   * @remarks
   * RAM cost: 0 GB
   *
   * The amount of real time spent asleep between updates can vary due to "bonus time"
   * (usually 1 second).
   *
   * @returns Promise that resolves to the number of milliseconds of Bladeburner time
   * that were processed in the previous update (1000 - 5000 ms).
   *
   * @example
   * ```js
   * while (true) {
   *   const duration = await ns.bladeburner.nextUpdate();
   *   ns.print(`Bladeburner Division completed ${ns.format.time(duration)} of actions.`);
   *   ns.print(`Bonus time remaining: ${ns.format.time(ns.bladeburner.getBonusTime())}`);
   *   // Manage the Bladeburner division
   * }
   * ```
   */
  nextUpdate(): Promise<number>;

  /**
   * Returns whether player is a member of Bladeburner division. Does not require API access.
   * @remarks
   * RAM cost: 0 GB
   *
   * @returns whether player is a member of Bladeburner division. */
  inBladeburner(): boolean;
}

/**
 * Coding Contract API
 * @public
 */
export interface CodingContract {
  /**
   * Attempts a coding contract, returning a reward string on success or empty string on failure.
   * @remarks
   * RAM cost: 10 GB
   *
   * Attempts to solve the Coding Contract with the provided solution.
   *
   * @example
   * ```js
   * const reward = ns.codingcontract.attempt("[solution, as, a, string]", filename, hostname);
   * // or
   * const reward = ns.codingcontract.attempt(["answer", "as", "an", "array"], filename, hostname);
   * if (reward) {
   *   ns.tprint(`Contract solved successfully! Reward: ${reward}`);
   * } else {
   *   ns.tprint("Failed to solve contract.");
   * }
   * ```
   *
   * @param answer - Attempted solution for the contract. This can be a string formatted like submitting manually, or the answer in the format of the specific contract type.
   * @param filename - Filename of the contract.
   * @param host - Hostname/IP of the server containing the contract. Optional. Defaults to current server if not
   *   provided.
   * @returns A reward description string on success, or an empty string on failure.
   */
  attempt(answer: any, filename: string, host?: string): string;

  /**
   * Get the type of a coding contract.
   * @remarks
   * RAM cost: 5 GB
   *
   * Returns a name describing the type of problem posed by the Coding Contract.
   * (e.g. Find Largest Prime Factor, Total Ways to Sum, etc.)
   *
   * @param filename - Filename of the contract.
   * @param host - Hostname/IP of the server containing the contract. Optional. Defaults to current server if not provided.
   * @returns Name describing the type of problem posed by the Coding Contract.
   */
  getContractType(filename: string, host?: string): CodingContractName;

  /**
   * Get the description.
   * @remarks
   * RAM cost: 5 GB
   *
   * Get the full text description for the problem posed by the Coding Contract.
   *
   * @param filename - Filename of the contract.
   * @param host - Hostname/IP of the server containing the contract. Optional. Defaults to current server if not provided.
   * @returns Contract’s text description.
   */
  getDescription(filename: string, host?: string): string;

  /**
   * Get the input data.
   * @remarks
   * RAM cost: 5 GB
   *
   * Get the data associated with the specific Coding Contract.
   * Note that this is not the same as the contract’s description.
   * This is just the data that the contract wants you to act on in order to solve the contract.
   *
   * @param filename - Filename of the contract.
   * @param host - Hostname/IP of the server containing the contract. Optional. Defaults to current server if not provided.
   * @returns The specified contract’s data, data type depends on contract type.
   */
  getData(filename: string, host?: string): any;

  /**
   * Get various data about a specific contract.
   * @remarks
   * RAM cost: 15 GB
   *
   * The returned object includes the type, data, description as well as methods for getting the number of tries remaining and submitting your answer.
   * Depending on the type of the contract, the data is typed differently.
   * Using type-narrowing, you can get the correct type of the data:
   *
   * @example
   * ```js
   * const contract = ns.codingcontract.getContract(fileName, hostName);
   * if (contract.type === ns.enums.CodingContractName.FindLargestPrimeFactor) {
   *   const data = contract.data;
   *   // ^? data: number
   * }
   * ```
   *
   * @param filename - Filename of the contract.
   * @param host - Hostname/IP of the server containing the contract. Optional. Default to the current server if not provided.
   * @returns An object containing various data about the contract specified.
   */
  getContract(filename: string, host?: string): CodingContractObject;

  /**
   * Get the number of attempts remaining.
   * @remarks
   * RAM cost: 2 GB
   *
   * Get the number of tries remaining on the contract before it self-destructs.
   *
   * @param filename - Filename of the contract.
   * @param host - Hostname/IP of the server containing the contract. Optional. Defaults to current server if not provided.
   * @returns How many attempts are remaining for the contract.
   */
  getNumTriesRemaining(filename: string, host?: string): number;

  /**
   * Generate a dummy contract.
   * @remarks
   * RAM cost: 2 GB
   *
   * Generate a dummy contract on the current server with no reward. Used to test various algorithms.
   *
   * This function will return null and not generate a contract if the randomized contract name is the same as another
   * contract's name or the host is offline.
   *
   * @param type - Type of contract to generate
   * @param host - Hostname/IP of the server containing the contract. Optional. Defaults to the server the calling script is running on.
   * @returns Filename of the contract.
   */
  createDummyContract(type: CodingContractName, host?: string): string | null;

  /**
   * List all contract types.
   * @remarks
   * RAM cost: 0 GB
   */
  getContractTypes(): CodingContractName[];
}

/**
 * Cloud API
 * @public
 */
export interface Cloud {
  /**
   * Get cost of purchasing a cloud server.
   * @remarks
   * RAM cost: 0.25 GB
   *
   * Returns the cost to purchase a cloud server with the specified amount of ram.
   *
   * @example
   * ```js
   * const ram = 2 ** 20;
   * const cost = ns.cloud.getServerCost(ram);
   * ns.tprint(`A cloud server with ${ns.format.ram(ram)} costs $${ns.format.number(cost)}`);
   * ```
   * @param ram - Amount of RAM of a potential cloud server, in GB. Must be a power of 2 (2, 4, 8, 16, etc.). Maximum value of 1048576 (2^20).
   * @returns The cost to purchase a cloud server with the specified amount of ram, or returns Infinity if ram is not a valid amount.
   */
  getServerCost(ram: number): number;

  /**
   * Purchase a cloud server.
   * @remarks
   * RAM cost: 2.25 GB
   *
   * Purchase a cloud server with the specified hostname and amount of RAM.
   *
   * The hostname argument can be any data type, but it will be converted to a string
   * and have whitespace removed. Anything that resolves to an empty string or IP address
   * will cause the function to fail. If there is already a cloud server with the specified
   * hostname, then the function will automatically append a number at the end of the hostname
   * argument value until it finds a unique hostname. For example, if the script calls
   * `purchaseServer(“foo”, 4)` but a server named “foo” already exists, then it will
   * automatically change the hostname to `foo-0`. If there is already a server with the
   * hostname `foo-0`, then it will change the hostname to `foo-1`, and so on.
   *
   * Note that there is a maximum limit to the amount of cloud servers you can purchase.
   *
   * Returns the hostname of the new cloud server as a string. If the function
   * fails to purchase a cloud server, then it will return an empty string. The function will
   * fail if the arguments passed in are invalid, if the player does not have enough
   * money to purchase the specified cloud server, or if the player has exceeded the maximum
   * amount of cloud servers.
   *
   * @example
   * ```js
   * // Attempt to purchase 5 cloud servers with 64GB of ram each
   * const ram = 64;
   * const prefix = "cloud-server-";
   * for (let i = 0; i < 5; ++i) {
   *    ns.cloud.purchaseServer(prefix + i, ram);
   * }
   * ```
   * @param hostname - Hostname of the cloud server.
   * @param ram - Amount of RAM of the cloud server, in GB. Must be a power of 2 (2, 4, 8, 16, etc.). Maximum value of 1048576 (2^20).
   * @returns The hostname of the new cloud server.
   */
  purchaseServer(hostname: string, ram: number): string;

  /**
   * Get cost of upgrading a cloud server to the given RAM.
   * @remarks
   * RAM cost: 0.1 GB
   *
   * @param host - Hostname/IP of the cloud server to upgrade.
   * @param ram - Amount of RAM of the cloud server, in GB. Must be a power of 2 (2, 4, 8, 16, etc.). Maximum value of 1048576 (2^20).
   * @returns The price to upgrade or -1 if either input is not valid, i.e. host is not the name of a cloud server or ram is not a valid amount.
   */
  getServerUpgradeCost(host: string, ram: number): number;

  /**
   * Upgrade a cloud server's RAM.
   * @remarks
   * RAM cost: 0.25 GB
   *
   * @param host - Hostname/IP of the cloud server to upgrade.
   * @param ram - Amount of RAM of the cloud server, in GB. Must be a power of 2 (2, 4, 8, 16, etc.). Maximum value of 1048576 (2^20).
   * @returns True if the upgrade succeeded, and false otherwise.
   */
  upgradeServer(host: string, ram: number): boolean;

  /**
   * Rename a cloud server.
   * @remarks
   * RAM cost: 0 GB
   *
   * @param hostname - Current cloud server hostname.
   * @param newName - New cloud server hostname.
   * @returns True if successful, and false otherwise.
   */
  renameServer(hostname: string, newName: string): boolean;

  /**
   * Delete a cloud server.
   * @remarks
   * RAM cost: 2.25 GB
   *
   * Deletes one of your cloud servers, which is specified by its hostname/ip.
   *
   * The host argument can be any data type, but it will be converted to a string.
   * Whitespace is automatically removed from the string. This function will not delete a
   * cloud server that still has scripts running on it.
   *
   * @param host - Hostname/IP of the cloud server to delete.
   * @returns True if successful, and false otherwise.
   */
  deleteServer(host: string): boolean;

  /**
   * Returns an array with the hostnames or IP addresses of all of the cloud servers you have purchased.
   * Returns hostnames by default.
   *
   * @remarks
   * RAM cost: 1.05 GB
   *
   * @param returnOpts - Optional. Controls whether the function returns IPs
   * @returns Returns an array with the hostnames or IP addresses of all of the cloud servers you have purchased.
   */
  getServerNames(returnOpts?: HostReturnOptions): string[];

  /**
   * Returns the maximum number of cloud servers you can purchase.
   *
   * @remarks RAM cost: 0.05 GB
   * @returns Returns the maximum number of cloud servers you can purchase.
   */
  getServerLimit(): number;

  /**
   * Returns the maximum RAM that a cloud server can have.
   *
   * @remarks RAM cost: 0.05 GB
   * @returns Returns the maximum RAM (in GB) that a cloud server can have.
   */
  getRamLimit(): number;
}

/**
 * Format API
 * @public
 */
export interface Format {
  /**
   * Format a number.
   * @remarks
   * RAM cost: 0 GB
   *
   * Converts a number into a numeric string with the specified format options.
   * This is the same function that the game itself uses to display numbers. The format also depends on the Numeric
   * Display settings (all options on the "Numeric Display" options page)
   * To format ram or percentages, see {@link Format.ram | format.ram} and {@link Format.percent | format.percent}
   *
   * This function has some quirky undocumented behaviors. This is a non-exhaustive list of those behaviors:
   *
   * - "Infinity" and "-Infinity" are returned as "∞" and "-∞", respectively.
   *
   * - If you disable the suffix form in the settings page or the absolute value is greater than or equal to 1e33, this
   * function will use the exponential form. This means that, if Math.abs(n) \>= 1e33, the returned value is always in
   * the exponential form, regardless of the setting.
   *
   * Note that the behaviors listed above are "undocumented", in the sense that we don't make any guarantee about
   * backward compatibility. You must not rely on those behaviors.
   *
   * @param n - Number to format.
   * @param fractionalDigits - Number of digits to show in the fractional part of the decimal number. Optional, defaults to 3.
   * @param suffixStart - How high a number must be before a suffix will be added. Optional, defaults to 1000.
   * @param isInteger - Whether the number represents an integer. Integers do not display fractional digits until a suffix is present. Optional, defaults to false.
   * @returns Formatted number.
   */
  number(n: number, fractionalDigits?: number, suffixStart?: number, isInteger?: boolean): string;

  /**
   * Format a number as an amount of ram.
   * @remarks
   * RAM cost: 0 GB
   *
   * Converts a number into a ram string with the specified number of fractional digits.
   * This is the same function that the game itself uses to display ram. The format also depends on the Numeric Display
   * settings (all options on the "Numeric Display" options page)
   * To format plain numbers or percentages, see {@link Format.number | format.number} and {@link Format.percent | format.percent}
   *
   * @param n - Number to format as an amount of ram, in base units of GB (or GiB if that Numeric Display option is set).
   * @param fractionalDigits - Number of digits to show in the fractional part of the decimal number. Optional, defaults to 2.
   * @returns Formatted ram amount.
   */
  ram(n: number, fractionalDigits?: number): string;

  /**
   * Format a number as a percentage.
   * @remarks
   * RAM cost: 0 GB
   *
   * Converts a number into a percentage string with the specified number of fractional digits.
   * This is the same function that the game itself uses to display percentages. The format also depends on the Numeric
   * Display settings (all options on the "Numeric Display" options page)
   * To format plain numbers or ram, see {@link Format.number | format.number} and {@link Format.ram | format.ram}
   *
   * @param n - Number to format as a percentage.
   * @param fractionalDigits - Number of digits to show in the fractional part of the decimal number. Optional, defaults to 2.
   * @param suffixStart - When to switch the percentage to a multiplier. Default is 1e6 or x1.00m.
   * @returns Formatted percentage.
   */
  percent(n: number, fractionalDigits?: number, suffixStart?: number): string;

  /**
   * Format time to a readable string.
   * @remarks
   * RAM cost: 0 GB
   *
   * @param milliseconds - Number of millisecond to format.
   * @param milliPrecision - Format time with subsecond precision. Defaults to false.
   * @returns The formatted time.
   */
  time(milliseconds: number, milliPrecision?: boolean): string;

  /**
   * Format a number as an amount of money.
   * @remarks
   * RAM cost: 0 GB
   *
   * Converts a number into a numeric string, using the user-defined currency prefix/suffix.
   *
   * @param n - Amount of money to format.
   * @param exponential - Whether or not to use exponential form for small numbers (between 0 and 0.001). Defaults to false.
   * @returns Formatted amount of money.
   */
  money(n: number, exponential?: boolean): string;
}

/**
 * Errors:
 *
 * - DirectConnectionRequired: The target server is not directly connected to the current server. This may be caused
 * by a user error (specifying the wrong neighbor host's hostname) or a network change (the target server was moved).
 *
 * - AuthFailure: Authentication failed. The password is incorrect.
 *
 * - NotFound: The API requires a specific resource (e.g., an exe file), but it does not exist on the server.
 *
 * - RequestTimeOut: The request failed (though the password may or may not have been correct). Caused by network instability.
 *
 * - ServiceUnavailable: The server is offline.
 *
 * @public
 */
type DarknetResponseCodeType = {
  Success: 200;
  DirectConnectionRequired: 351;
  AuthFailure: 401;
  Forbidden: 403;
  NotFound: 404;
  RequestTimeOut: 408;
  NotEnoughCharisma: 451;
  StasisLinkLimitReached: 453;
  NoBlockRAM: 454;
  PhishingFailed: 455;
  ServiceUnavailable: 503;
};

/** @public */
type DarknetResponseCode = _ValueOf<DarknetResponseCodeType>;

/** @public */
export type DarknetResult = { success: boolean; code: DarknetResponseCode; message: string };

/** @public */
export type CacheResult = {
  success: boolean;
  message: string;
} & CacheReward;

/** @public */
export type CacheReward = {
  karmaLoss: number;
  wseAccount: boolean;
  tixApiAccess: boolean;
  fourSigmaData: boolean;

  money?: number;
  programName?: ProgramName;
  stockSymbol?: string;
  stockShares?: number;
  dataFilePaths?: string[];
  contractFilePaths?: string[];
  augmentationName?: string;
};

/**
 * Details about a darknet server
 * @public
 */
interface DarknetServerDetails {
  /** True if the server is directly connected to the current server */
  isConnectedToCurrentServer: boolean;
  /** True if the current script has authenticated to this server with the right password using authenticate() or connectToSesssion() */
  hasSession: boolean;
  /**
   * The model of the server. Similar models have similar vulnerabilities. The model list is intentionally undocumented.
   * You are supposed to experiment and discover the models.
   */
  modelId: string;
  /** Static password reminder text set for this server. */
  passwordHint: string;
  /** Data from the passwordHint, if any. */
  data: string;
  /** The frequency (in seconds) of the server adding its own messages to its logs, visible with heartBleed(). */
  logTrafficInterval: number;
  /** The number of characters in the password */
  passwordLength: number;
  /** The character set used in the password */
  passwordFormat: "numeric" | "alphabetic" | "alphanumeric" | "ASCII" | "unicode";
  /** The amount of ram blocked by the server owner */
  blockedRam: number;
  /** The difficulty rating of the server, associated with its original depth in the net */
  difficulty: number;
  /** The current depth in the darknet of the server */
  depth: number;
  /** The charisma skill required to authenticate on the server */
  requiredCharismaSkill: number;
  /** If this darknet server cannot be moved. True for fixed/story servers. */
  isStationary: boolean;
}

/**
 * Options to change the behavior of {@link Darknet.heartbleed | heartbleed} API.
 * @public
 */
interface HeartbleedOptions {
  /** If true, looks at the most recent log lines but does not remove them. Default is false. */
  peek?: boolean;
  /** The number of log lines to remove from the server. Default is 1. Must be a positive integer. */
  logsToCapture?: number;
  /** The number of additional milliseconds to add to the run time of the heartbleed request. Default is 0. Must be a non-negative integer. */
  additionalMsec?: number;
}

/**
 * Instability of the darknet caused by excessive backdoor-ing of servers.
 * @public
 */
interface DarknetInstability {
  /** The increase in time that authentication takes, as a decimal */
  authenticationDurationMultiplier: number;
  /** The chance that authentication will time out instead of resolving, as a decimal */
  authenticationTimeoutChance: number;
}

/**
 * Darknet API
 * @public
 */
export interface Darknet {
  /**
   * Sends a network request to try to authenticate on a darkweb server. The target server must be directly connected
   * to the server that the script is running on. The speed of authentication scales with the number of threads used.
   *
   * If successful, grants the current script a session, allowing it to exec() scripts on that server, or scp() files to it. (scp() *from* the server is always allowed.)
   *
   * Note that the charisma level on a server is not a requirement for authentication, but authentication takes longer
   * if the player's charisma is below the server's charisma level.
   *
   * Note that the session granted is only for the current script instance (by PID) - other running scripts will need to
   * use connectToSession with the correct password to also get a session with the target server.
   *
   * @remarks
   * RAM cost: 0.4 GB
   *
   * @param host - Hostname/IP of the target server (connected to the current server) to try a password.
   * @param password - Password to attempt to authenticate with.
   * @param additionalMsec - Optional. The number of additional milliseconds to add to the run time of the authentication request. Default is 0.
   * @returns A promise that resolves to a {@link DarknetResult} object. The resolved object may contain an optional
   * property. The type of this property is intentionaly undocumented. You are supposed to experiment and discover the
   * content of this property.
   */
  authenticate(host: string, password: string, additionalMsec?: number): Promise<DarknetResult & { data?: any }>;

  /**
   * Attempts to connect to a target darkweb server that you have previously authenticated on. Unlike `authenticate`,
   * connectToSession can be used to get a session on servers at any distance.
   *
   * If successful, grants the script a session, allowing it to scp() files to that target. It also allows starting scripts
   * with exec() on that target, if the target is directly connected to the server that the script is running on,
   * or has a backdoor or stasis link.
   *
   * If unsuccessful, more detail may be able to be gathered by using heartbleed() to look at the resulting logs on the server.
   *
   * Note that the session granted is only for the current script instance (by PID) - other running scripts will need to
   * use connectToSession with the correct password to also get a session with the target server.
   *
   * @remarks
   * RAM cost: 0.05 GB
   *
   * @param host - Hostname/IP of the target server to connect to existing session
   * @param password - The server's password, to verify the session
   * @returns A {@link DarknetResult} object
   */
  connectToSession(host: string, password: string): DarknetResult;

  /**
   * Overloads a darknet server with feedback to lock it down. Similar to status link, it will no longer move
   * or go offline, although servers connected to it may still move. However, it also loses all of its max ram,
   * and no longer gives experience.
   *
   * This technique is sometimes used to sacrifice a new device that appears on the network to make
   * it easier to probe it for weaknesses and develop scripts against it.
   *
   * @remarks
   * RAM cost: 2 GB
   *
   * @param host - Hostname/IP of the target server.
   */
  freezeServer(host: string): DarknetResult;

  /**
   * Uses an exploit to extract log data from a server by sending a malformed heartbeat request.
   * Retrieves the most recent logs on the server. This can be used to get more feedback on authentication attempts.
   * The retrieved logs are removed from the server, unless the "peek" flag is set to true in the provided HeartbleedOptions.
   *
   * Servers will periodically produce logs themselves, as well, which sometimes are useful, but most times are not.
   *
   * The speed of capture scales with the number of threads used. See formulas.dnet.getHeartbleedTime for more information.
   * Note that you cannot scrape logs from servers whose required charisma is higher than your charisma level.
   *
   * @remarks
   * RAM cost: 0.6 GB
   *
   * @param host - Hostname/IP of the target server. Must be directly connected to the current server.
   * @param options - Optional {@link HeartbleedOptions} to modify how the exploit works.
   * @returns A promise that resolves to a {@link DarknetResult} object, plus the scraped logs.
   *
   */
  heartbleed(host: string, options?: HeartbleedOptions): Promise<DarknetResult & { logs: string[] }>;

  /**
   * Opens a .cache file on the current server to acquire its valuable contents.
   *
   * @remarks
   * RAM cost: 2 GB
   *
   * @param filename - Name of the cache file to open.
   * @param suppressToast - Optional. If true, suppresses the toast notification that appears when opening a cache file. Defaults to false.
   * @returns An object containing the contents of the cache, and the karma lost.
   */
  openCache(filename: string, suppressToast?: boolean): CacheResult;

  /**
   * Returns a list of all darknet servers connected to the script's current server.
   * For example, if called from a script running on `home`, it will return `["darkweb"]`.
   * It will return an empty list if there are no darknet servers connected to the current server.
   *
   * Note that there is no guarantee about the order of servers in the returned list.
   *
   * @remarks
   * RAM cost: 0.2 GB
   *
   * @param returnByIP - Optional. Controls whether the function returns IPs instead of hostnames. Defaults to false.
   * @returns An array of strings containing the hostnames/IPs of all servers connected to the current server.
   */
  probe(returnByIP?: boolean): string[];

  /**
   * Applies or removes a stasis link to the script's current server. This will allow you to connectToSession() or exec() to the server remotely, even if it is
   * not directly connected to the server a script is running on. It also allows direct connection to the server via the terminal.
   *
   * Stasis links also prevent the server from going offline or moving. It does not prevent other servers from moving or
   * going offline, though, so it does not guarantee that the stasis link server will never lose connections to other servers.
   *
   * There is a maximum of stasis links that can be applied globally, which can be seen using getStasisLinkLimit().
   * This limit can be increased by finding special augmentations in the deep darknet.
   *
   * @remarks
   * RAM cost: 12 GB
   *
   * @param shouldLink - true to apply a stasis link, false to remove it. Optional. Defaults to true.
   * @returns A promise that resolves to a {@link DarknetResult} object.
   */
  setStasisLink(shouldLink?: boolean): Promise<DarknetResult>;

  /**
   * Returns the maximum number of stasis links that can be applied globally, based on the player's current status.
   * Stasis link limit can be increased by finding special augmentations in the deep darknet.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * @returns Maximum number of stasis links.
   */
  getStasisLinkLimit(): number;

  /**
   * Returns the hostnames/IPs of servers that have a stasis link applied.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * @param returnByIP - Optional. If true, returns IPs instead of hostnames. Defaults to false.
   * @returns Hostnames/IPs
   */
  getStasisLinkedServers(returnByIP?: boolean): string[];

  /**
   * Returns the darknet-specific details of the server.
   *
   * If the darknet server has recently gone offline, the returned object will be a dummy server object with
   * `isOnline: false`.
   *
   * @remarks
   * RAM cost: 0.1 GB
   *
   * @param host - Hostname/IP of the server to analyze. Defaults to the running script's server if not specified.
   * @returns An object containing the server's darknet-specific details.
   */
  getServerDetails(host?: string): DarknetServerDetails & { isOnline: boolean };

  /**
   * Increases the chance that the target server will move to other parts of the darknet, by overloading the connections between it and the current server.
   * The target must be a connected, non-stationary, darknet server - scripts cannot target the server they are running on.
   *
   * Effect scales with threads and charisma level.
   *
   * @remarks
   * RAM cost: 4 GB
   *
   * @param host - Hostname/IP of the connected server to migrate.
   * @returns A promise that resolves to a {@link DarknetResult} object with a `progress` field indicating the total migration progress in the range [0, 1].
   */
  induceServerMigration(host: string): Promise<DarknetResult & { progress: number }>;

  /**
   * Executes STORM_SEED.exe, if it is present on the server the script is running on.
   *
   * Warning: That exe file creates a webstorm that can cause catastrophic damage to the darknet. Run at your own risk.
   *
   * @remarks
   * RAM cost: 0.1 GB
   *
   * @returns A {@link DarknetResult} object.
   */
  unleashStormSeed(): DarknetResult;

  /**
   * Returns whether the server is a darknet server.
   *
   * Returns false if the server does not exist or has gone offline recently. This function does not require DarkscapeNavigator.exe.
   *
   * @remarks
   * RAM cost: 0.1 GB
   *
   * @param host - Optional. Hostname/IP for the requested server object. Defaults to the running script's server.
   * @returns true if the server is a darknet server, false otherwise.
   */
  isDarknetServer(host?: string): boolean;

  /**
   * Spends some time freeing some of the RAM currently blocked by the server owner. Must target an authenticated and
   * directly connected server.
   *
   * The amount of ram recovered scales with charisma and the number of threads used.
   *
   * @remarks
   * RAM cost: 1 GB
   *
   * @param host - Optional. Hostname/IP of the authenticated and directly connected server to free ram from. Defaults to the running script's server.
   * @returns A promise that resolves to a {@link DarknetResult} object.
   */
  memoryReallocation(host?: string): Promise<DarknetResult>;

  /**
   * Gets the amount of RAM blocked by the server owner's processes. This ram can be freed for use using dnet.memoryReallocation() .
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * @param host - Optional. Hostname/IP of the server to check. Defaults to the running script's server.
   * @returns The amount of RAM blocked by the server owner's processes.
   */
  getBlockedRam(host?: string): number;

  /**
   * Gets the current depth of the specified server into the darknet. Servers immediately below Darkweb are depth 0, and
   * each visual row in the UI below that increases the depth of the server.
   *
   * Returns -1 if the server is offline, not found, or not a darkweb server.
   *
   * @remarks
   * RAM cost: 0.1 GB
   *
   * @param host - Optional. Hostname/IP of the server to check. Defaults to the running script's server.
   * @returns The current depth of the server into the darknet.
   */
  getDepth(host?: string): number;

  /**
   * Spends some time spreading propaganda about a stock to increase its volatility. This does not actually change the
   * stock's forecasts, but a savvy investor can take advantage of the chaos. The effect scales with charisma and the
   * number of threads used, but degrades over time if left alone.
   *
   * This function requires TIX API access. You can use {@link Stock.purchaseTixApi | purchaseTixApi} to purchase it.
   *
   * @remarks
   * RAM cost: 2 GB
   *
   * @param sym - Stock symbol.
   * @returns A promise that resolves to a {@link DarknetResult} object.
   */
  promoteStock(sym: string): Promise<DarknetResult>;

  /**
   * Spends time sending out phishing emails, attempting to find some non-technical middle manager to fall for the scam. Builds charisma.
   * Often the attempt will fail, but success can be increased with crime success rate and charisma stats.
   *
   * The amount of money lifted scales with the number of threads used, if successful. Very occasionally you can retrieve a cache file from the attempt.
   *
   * Phishing attacks can only be run from scripts on darknet servers.
   *
   * @remarks
   * RAM cost: 2 GB
   *
   * @returns A promise that resolves to a {@link DarknetResult} object.
   */
  phishingAttack(): Promise<DarknetResult>;

  /**
   * Gets the current instability of the darknet caused by excessive backdoor-ing of servers.
   * @remarks
   * Ram cost: 0 GB
   *
   * @returns An object containing the current instability values.
   */
  getDarknetInstability(): DarknetInstability;

  /**
   * Sleep until the next mutation of the network of darknet servers (which occur frequently).
   * Note that in the majority of cases, whatever changed out on the net (if anything) will not be nearby to,
   * or visible from, the current server.
   *
   * Some possible mutations that can occur somewhere on the darknet each cycle:
   *
   * - Nothing changes.
   *
   * - Some servers move to other locations on the net, breaking existing connections and forming new ones.
   *
   * - Some servers go offline, which in many cases is permanent - they are effectively deleted.
   *
   * - Some servers restart, which kills all running scripts on the server.
   *
   * - New servers appear on the net (which may be previously offline servers, but cleaned and with a new password).
   *
   * @remarks
   * RAM cost: 0 GB
   */
  nextMutation(): Promise<void>;

  /**
   * Gets the required charisma level to target the server with dnet.heartbleed().
   *
   * Insufficient charisma will also cause authentication to take much longer - or, in certain servers deep
   * in the darknet, be impossible.
   *
   * @remarks
   * RAM cost: 0.1 GB
   *
   * @param host - Hostname/IP of the server to check.
   * @returns Required charisma level of the host.
   */
  getServerRequiredCharismaLevel(host: string): number;

  /**
   * Not all who wander are lost.
   *
   * @remarks
   * RAM cost: 0 GB
   */
  labreport(): Promise<Result<any>>;

  /**
   * There is more than meets the eye.
   *
   * @remarks
   * RAM cost: 0 GB
   */
  labradar(): Promise<Result<any>>;
}

/**
 * Gang API
 * @remarks
 * If you are not in BitNode-2, then you must have Source-File 2 in order to use this API.
 * @public
 */
export interface Gang {
  /**
   * Create a gang.
   * @remarks
   * RAM cost: 1GB
   *
   * Create a gang with the specified faction.
   *
   * Outside BitNode 2, your karma must be less than or equal to 54000.
   *
   * @param faction - Name of the faction that you want to create a gang with. This faction must allow this action, and you must be its member.
   * @returns True if the gang was created, false otherwise.
   */
  createGang(faction: FactionName): boolean;

  /**
   * Check if you're in a gang. Does not require API access.
   * @remarks
   * RAM cost: 0GB
   *
   * @returns True if you're in a gang, false otherwise.
   */
  inGang(): boolean;

  /**
   * List all gang members.
   * @remarks
   * RAM cost: 1 GB
   *
   * Get the names of all Gang members
   *
   * @returns Names of all Gang members.
   */
  getMemberNames(): string[];

  /**
   * Rename a Gang member to a new unique name.
   * @remarks
   * RAM cost: 0 GB
   *
   * Rename a Gang Member if none already has the new name.
   * @param memberName - Name of the member to change.
   * @param newName - New name for that gang member.
   * @returns True if successful, and false if not.
   */
  renameMember(memberName: string, newName: string): boolean;

  /**
   * Get information about your gang.
   * @remarks
   * RAM cost: 2 GB
   *
   * Get general information about the gang.
   *
   * @returns Object containing general information about the gang.
   */
  getGangInformation(): GangGenInfo;

  /**
   * Get information about all gangs.
   * @remarks
   * RAM cost: 2 GB
   *
   * Get territory and power information about all gangs.
   *
   * @returns Object containing territory and power information about all gangs, including the player's gang, if any.
   */
  getAllGangInformation(): Record<string, GangOtherInfoObject>;

  /**
   * Get information about a specific gang member.
   * @remarks
   * RAM cost: 2 GB
   *
   * Get stat and equipment-related information about a Gang Member
   *
   * @param name - Name of member.
   * @returns Object containing stat and equipment-related information about a Gang Member.
   */
  getMemberInformation(name: string): GangMemberInfo;

  /**
   * Check if you can recruit a new gang member.
   * @remarks
   * RAM cost: 1 GB
   *
   * Returns a boolean indicating whether a member can currently be recruited.
   *
   * Once you have successfully created a gang by using the function
   * {@link Gang.createGang | createGang}, you can immediately recruit a small
   * number of members to your gang. After you have recruited the founding
   * members, to recruit another member you must increase your respect. The
   * more members you want to recruit, the more respect you require. If your
   * gang has the maximum number of members, then this function would return
   * false.
   *
   * @returns True if a member can currently be recruited, false otherwise.
   */
  canRecruitMember(): boolean;

  /**
   * Check how many gang members you can currently recruit.
   * @remarks
   * RAM cost: 1 GB
   *
   * @returns Number indicating how many members can be recruited,
   * considering current reputation and gang size.
   */
  getRecruitsAvailable(): number;

  /**
   * Check the amount of Respect needed for your next gang recruit.
   * @remarks
   * RAM cost: 1 GB
   *
   * @returns The static number value of Respect needed for the next
   * recruit, with consideration to your current gang size.
   * Returns `Infinity` if you have reached the gang size limit.
   */
  respectForNextRecruit(): number;
  /**
   * Recruit a new gang member.
   * @remarks
   * RAM cost: 2 GB
   *
   * Attempt to recruit a new gang member.
   *
   * Possible reasons for failure:
   * * Cannot currently recruit a new member
   * * There already exists a member with the specified name
   *
   * @param name - Name of member to recruit.
   * @returns True if the member was successfully recruited, false otherwise.
   */
  recruitMember(name: string): boolean;

  /**
   * List member task names.
   * @remarks
   * RAM cost: 0 GB
   *
   * Get the name of all valid tasks that Gang members can be assigned to.
   *
   * @returns All valid tasks that Gang members can be assigned to.
   */
  getTaskNames(): string[];

  /**
   * Set gang member to task.
   * @remarks
   * RAM cost: 2 GB
   *
   * Attempts to assign the specified Gang Member to the specified task.
   * If an invalid task is specified, the Gang member will be set to idle (“Unassigned”).
   *
   * @param memberName - Name of Gang member to assign.
   * @param taskName - Task to assign.
   * @returns True if the Gang Member was successfully assigned to the task, false otherwise.
   */
  setMemberTask(memberName: string, taskName: string): boolean;

  /**
   * Get stats of a task.
   * @remarks
   * RAM cost: 1 GB
   *
   * Get the stats of a gang task stats. This is typically used to evaluate which action should be executed next.
   *
   * @param name -  Name of the task.
   * @returns Detailed stats of a task.
   */
  getTaskStats(name: string): GangTaskStats;

  /**
   * List equipment names.
   * @remarks
   * RAM cost: 0 GB
   *
   * Get the name of all possible equipment/upgrades you can purchase for your Gang Members.
   * This includes Augmentations.
   *
   * @returns Names of all Equipments/Augmentations.
   */
  getEquipmentNames(): string[];

  /**
   * Get cost of equipment.
   * @remarks
   * RAM cost: 2 GB
   *
   * Get the amount of money it takes to purchase a piece of Equipment or an Augmentation.
   * If an invalid Equipment/Augmentation is specified, this function will return Infinity.
   *
   * This function already takes equipmentCostMult from {@link GangGenInfo | GangGenInfo} into account.
   *
   * @param equipName - Name of equipment.
   * @returns Cost to purchase the specified Equipment/Augmentation (number). Infinity for invalid arguments
   */
  getEquipmentCost(equipName: string): number;

  /**
   * Get type of an equipment.
   * @remarks
   * RAM cost: 2 GB
   *
   * Get the specified equipment type.
   *
   * @param equipName - Name of equipment.
   * @returns Type of the equipment.
   */
  getEquipmentType(equipName: string): string;

  /**
   * Get stats of an equipment.
   * @remarks
   * RAM cost: 2 GB
   *
   * Get the specified equipment stats.
   *
   * @param equipName - Name of equipment.
   * @returns A dictionary containing the stats of the equipment.
   */
  getEquipmentStats(equipName: string): EquipmentStats;

  /**
   * Purchase an equipment for a gang member.
   * @remarks
   * RAM cost: 4 GB
   *
   * Attempt to purchase the specified Equipment/Augmentation for the specified Gang member.
   *
   * @param memberName - Name of Gang member to purchase the equipment for.
   * @param equipName - Name of Equipment/Augmentation to purchase.
   * @returns True if the equipment was successfully purchased. False otherwise
   */
  purchaseEquipment(memberName: string, equipName: string): boolean;

  /**
   * Ascend a gang member.
   * @remarks
   * RAM cost: 4 GB
   *
   * Ascend the specified Gang Member.
   *
   * @param memberName - Name of member to ascend.
   * @returns Object with info about the ascension results, or undefined if ascension did not occur.
   */
  ascendMember(memberName: string): GangMemberAscension | undefined;

  /**
   * Get the result of an ascension without ascending.
   * @remarks
   * RAM cost: 2 GB
   *
   * Get a {@link GangMemberAscension} result for ascending a gang member without performing the ascension.
   *
   * @param memberName - Name of member.
   * @returns Object with info about the ascension results, or undefined if ascension is not possible.
   */
  getAscensionResult(memberName: string): GangMemberAscension | undefined;

  /**
   * Get the effect of an install on ascension multipliers without installing.
   * @remarks
   * RAM cost: 2 GB
   *
   * Get {@link GangMemberInstall} effects on ascension multipliers for a gang member after installing without performing the install.
   *
   * @param memberName - Name of member.
   * @returns Object with info about the install results on ascension multipliers, or undefined if ascension is not possible.
   */
  getInstallResult(memberName: string): GangMemberInstall | undefined;

  /**
   * Enable/Disable territory clashes.
   * @remarks
   * RAM cost: 2 GB
   *
   * Set whether or not the gang should engage in territory clashes
   *
   * @param engage - Whether or not to engage in territory clashes.
   */
  setTerritoryWarfare(engage: boolean): void;

  /**
   * Get chance to win clash with other gang.
   * @remarks
   * RAM cost: 4 GB
   *
   * Returns the chance you have to win a clash with the specified gang. The chance is returned in the range 0-1.
   *
   * @param gangName - Target gang
   * @returns Chance you have to win a clash with the specified gang.
   */
  getChanceToWinClash(gangName: string): number;

  /**
   * Get bonus time.
   * @remarks
   * RAM cost: 0 GB
   *
   * Returns the amount of accumulated “bonus time” (milliseconds) for the Gang mechanic.
   *
   * “Bonus time” is accumulated when the game is offline or if the game is inactive in the browser.
   *
   * “Bonus time” makes the game progress faster, up to 25x the normal speed.
   *
   * @returns Bonus time for the Gang mechanic in milliseconds.
   */
  getBonusTime(): number;

  /**
   * Sleeps until the next Gang update has happened.
   * @remarks
   * RAM cost: 0 GB
   *
   * The amount of real time spent asleep between updates can vary due to "bonus time".
   *
   * @returns Promise that resolves to the number of milliseconds of Gang time
   * that were processed in the previous update (2000 - 5000 ms).
   *
   * @example
   * ```js
   * while (true) {
   *   const duration = await ns.gang.nextUpdate();
   *   ns.print(`Gang completed ${ns.format.time(duration)} of activity.`);
   *   ns.print(`Bonus time remaining: ${ns.format.time(ns.gang.getBonusTime())}`);
   *   // Manage the Gang
   * }
   * ```
   */
  nextUpdate(): Promise<number>;
}

/** @public */
type GoOpponent =
  | "No AI"
  | "Netburners"
  | "Slum Snakes"
  | "The Black Hand"
  | "Tetrads"
  | "Daedalus"
  | "Illuminati"
  | "????????????";

/** @public */
interface SimpleOpponentStats {
  /** Number of wins since last reset */
  wins: number;
  /** Number of losses since last reset*/
  losses: number;
  /** Current winstreak */
  winStreak: number;
  /** Highest winstreak since last reset*/
  highestWinStreak: number;
  /** Favor gain from winstreaks, calculated as converted rep */
  rep: number;
  /** Stat boost*/
  bonusPercent: number;
  /** Description of stat boost */
  bonusDescription: string;
}

/**
 * Tools to analyze the IPvGO subnet.
 *
 * @public
 */
export interface GoAnalysis {
  /**
   * Shows if each point on the board is a valid move for the player.
   * By default, analyzes the current board state.
   * Takes an optional boardState (and an optional prior-move boardState, if desired) to analyze a custom board.
   *
   * The true/false validity of each move can be retrieved via the X and Y coordinates of the move.
   *
   * ```js
   * const validMoves = ns.go.analysis.getValidMoves();
   * const moveIsValid = validMoves[x][y];
   * ```
   *
   * Note that the [0][0] point is shown on the bottom-left on the visual board (as is traditional), and each
   * string represents a vertical column on the board. In other words, the printed example above can be understood to
   * be rotated 90 degrees clockwise compared to the board UI as shown in the IPvGO subnet tab.
   *
   * Also note that, when given a custom board state, only one prior move can be analyzed. This means that the superko rules
   * (no duplicate board states in the full game history) is not supported; you will have to implement your own analysis for that.
   *
   * The current valid moves for white can also be seen by simply calling `ns.go.analysis.getValidMoves(true)`.
   *
   * @remarks
   * RAM cost: 8 GB
   *
   * (This is intentionally expensive; you can derive this info from just getBoardState() and getMoveHistory() )
   *
   *  @param boardState - Optional. The board state to analyze, in the string[] format used by getBoardState(). Defaults to the current board state. Alternatively can be simply "true" to get current valid moves for white.
   *  @param priorBoardState - Optional. The move before the board state to analyze, in the format used by getBoardState(). Defaults to the current board's prior move state.
   *  @param playAsWhite - Optional. Whether to analyze the board state as if the white player is the current player. Defaults to false. Intended to be used when playing as white when the opponent is set to "No AI".
   *  @returns A 2D array of booleans indicating the validity of each move.
   */
  getValidMoves(boardState?: string[] | boolean, priorBoardState?: string[], playAsWhite?: boolean): boolean[][];

  /**
   * Returns an ID for each point. All points that share an ID are part of the same network (or "chain"). Empty points
   * are also given chain IDs to represent continuous empty space. Dead nodes are given the value `null`.
   *
   * Takes an optional boardState argument; by default uses the current board state.
   *
   * The data from getChains() can be used with the data from getBoardState() to see which player (or empty) each chain is
   *
   * For example, a 5x5 board might look like this. There is a large chain #1 on the left side, smaller chains
   * 2 and 3 on the right, and a large chain 0 taking up the center of the board.
   *
   * ```
   * [
   *   [   0,0,0,3,4],
   *   [   1,0,0,3,3],
   *   [   1,1,0,0,0],
   *   [null,1,0,2,2],
   *   [null,1,0,2,5],
   * ]
   * ```
   *
   * @remarks
   * RAM cost: 16 GB
   *
   * (This is intentionally expensive; you can derive this info from just getBoardState() )
   *
   * @param boardState - Optional. The current board state, as an array of strings. Defaults to the current board state.
   * @returns A 2D array of numbers identifying the chain ID of each point.
   *
   */
  getChains(boardState?: string[]): (number | null)[][];

  /**
   * Returns a number for each point, representing how many open nodes its network/chain is connected to.
   * Empty nodes and dead nodes are shown as -1 liberties.
   *
   * Takes an optional boardState argument; by default uses the current board state.
   *
   * For example, a 5x5 board might look like this. The chain in the top-left touches 5 total empty nodes, and the one
   * in the center touches four. The group in the bottom-right only has one liberty; it is in danger of being captured!
   *
   * ```
   * [
   *   [-1, 5,-1,-1, 2],
   *   [ 5, 5,-1,-1,-1],
   *   [-1,-1, 4,-1,-1],
   *   [ 3,-1,-1, 3, 1],
   *   [ 3,-1,-1, 3, 1],
   * ]
   * ```
   *
   * @remarks
   * RAM cost: 16 GB
   *
   * (This is intentionally expensive; you can derive this info from just getBoardState() )
   *
   * @param boardState - Optional. The current board state, as an array of strings. Defaults to the current board state.
   * @returns A 2D array of numbers counting the liberties of each point.
   */
  getLiberties(boardState?: string[]): number[][];

  /**
   * Returns 'X' for black, 'O' for white, or '?' for each empty point to indicate which player controls that empty point.
   * If no single player fully encircles the empty space, it is shown as contested with '?'.
   * "#" are dead nodes that are not part of the subnet.
   *
   * Takes an optional boardState argument; by default uses the current board state.
   *
   * Filled points of any color are indicated with '.'
   *
   * In this example, white encircles some space in the top-left, black encircles some in the top-right, and between their routers is contested space in the center:
   *
   * ```
   * [
   *   "OO..?",
   *   "OO.?.",
   *   "O.?.X",
   *   ".?.XX",
   *   "?..X#",
   * ]
   * ```
   *
   * @remarks
   * RAM cost: 16 GB
   *
   * (This is intentionally expensive; you can derive this info from just getBoardState() )
   *
   * @param boardState - Optional. The current board state, as an array of strings. Defaults to the current board state.
   * @returns A 2D array of characters indicating the player who controls each empty point.
   */
  getControlledEmptyNodes(boardState?: string[]): string[];

  /**
   * Displays the game history, captured nodes, and gained bonuses for each opponent you have played against.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * @returns A dictionary of opponent stats keyed by opponent name.
   */
  getStats(): Partial<Record<GoOpponent, SimpleOpponentStats>>;

  /**
   * Reset all win/loss and winstreak records for the No AI opponent.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * @param resetAll - Optional. if true, reset win/loss records for all opponents. Leaves node power and bonuses unchanged. Defaults to false.
   */
  resetStats(resetAll?: boolean): void;

  /**
   * Starts a new game against the "No AI" opponent, and sets the initial board size, pieces, and offline nodes to the given board state.
   * "X" represent black pieces, "O" white, and "." empty points. "#" are dead nodes that are not part of the subnet.
   *
   * @remarks
   * RAM cost: 4 GB
   *
   * @param boardState - The initial board state to use for the new game, in the format used by getBoardState().
   * @param komi - Optional komi value to set for the game. Defaults to 5.5.
   * @param nextPlayerIsWhite - Optional. Whether or not the next player to play is the white player. Defaults to false.
   */
  setTestingBoardState(boardState: string[], komi?: number, nextPlayerIsWhite?: boolean): void;

  /**
   * Adds a colored circle indicator to the specified point. These indicators are removed once a move is played.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * @param x - The x coordinate to highlight
   * @param y -  The y coordinate to highlight
   * @param color -  The color to use for the circle. It can be any value accepted by
   * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/outline-color | outline-color CSS property} (e.g., an RGB
   * string like "#FFF000"). You can also use "none" to clear it or one of 5 special values: "hack", "hp", "money",
   * "int", "cha". The corresponding colors of 5 special values depend on your theme.
   * @param text - Text to add to the node (replaces the default A.1 or B5 seen on hover). Should be kept short to fit well.
   */
  highlightPoint(x: number, y: number, color?: string, text?: string): void;

  /**
   * Removes the highlight color and text from the specified node.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * @param x - the x coordinate to remove highlight from
   * @param y - the y coordinate to remove highlight from
   */
  clearPointHighlight(x: number, y: number): void;

  /**
   * Removes all highlights from the board.
   *
   * @remarks
   * RAM cost: 0 GB
   */
  clearAllPointHighlights(): void;
}

/**
 * Illicit and dangerous IPvGO tools. Not for the faint of heart. Requires Source-File 14.2 to use.
 *
 * @public
 */
export interface GoCheat {
  /**
   * Returns your chance of successfully playing one of the special moves in the ns.go.cheat API.
   * Scales up with your crime success rate stat.
   * Scales down with the number of times you've attempted to cheat in the current game.
   *
   * Warning: if you fail to play a cheat move, your turn will be skipped. After your first cheat attempt, if you fail, there is a
   * small (~10%) chance you will instantly be ejected from the subnet.
   *
   * @remarks
   * RAM cost: 1 GB
   *
   * Requires Source-File 14.2 to use
   *
   * @param cheatCount - Optional override for the number of cheats already attempted. Defaults to the number of cheats attempted in the current game.
   * @param playAsWhite - Optional override for playing as white. Can only be used when playing on a 'No AI' board.
   * @returns Your chance of successfully playing a cheat move.
   */
  getCheatSuccessChance(cheatCount?: number, playAsWhite?: boolean): number;
  /**
   * Returns the number of times you've attempted to cheat in the current game.
   *
   * @remarks
   * RAM cost: 1 GB
   *
   * Requires Source-File 14.2 to use
   *
   * @param playAsWhite - Optional override for playing as white. Can only be used when playing on a 'No AI' board.
   * @returns The number of times you've attempted to cheat in the current game.
   */
  getCheatCount(playAsWhite?: boolean): number;
  /**
   * Attempts to remove an existing router, leaving an empty node behind.
   *
   * Success chance can be seen via ns.go.cheat.getCheatSuccessChance()
   *
   * Warning: if you fail to play a cheat move, your turn will be skipped. After your first cheat attempt, if you fail, there is a
   * small (~10%) chance you will instantly be ejected from the subnet.
   *
   * @remarks
   * RAM cost: 8 GB
   *
   * Requires Source-File 14.2 to use
   *
   * @param x - x coordinate of router to remove
   * @param y - y coordinate of router to remove
   * @param playAsWhite - Optional override for playing as white. Can only be used when playing on a 'No AI' board.
   * @returns a promise that contains the opponent move's x and y coordinates (or pass) in response, or an indication if the game has ended
   */
  removeRouter(
    x: number,
    y: number,
    playAsWhite?: boolean,
  ): Promise<{
    type: "move" | "pass" | "gameOver";
    x: number | null;
    y: number | null;
  }>;
  /**
   * Attempts to place two routers at once on empty nodes. Note that this ignores other move restrictions, so you can
   * suicide your own routers if they have no access to empty ports and do not capture any enemy routers.
   *
   * Success chance can be seen via ns.go.cheat.getCheatSuccessChance()
   *
   * Warning: if you fail to play a cheat move, your turn will be skipped. After your first cheat attempt, if you fail, there is a
   * small (~10%) chance you will instantly be ejected from the subnet.
   *
   * @remarks
   * RAM cost: 8 GB
   *
   * Requires Source-File 14.2 to use
   *
   * @param x1 - x coordinate of first move to make
   * @param y1 - y coordinate of first move to make
   * @param x2 - x coordinate of second move to make
   * @param y2 - y coordinate of second move to make
   * @param playAsWhite - Optional override for playing as white. Can only be used when playing on a 'No AI' board.
   * @returns a promise that contains the opponent move's x and y coordinates (or pass) in response, or an indication if the game has ended
   */
  playTwoMoves(
    x1: number,
    y1: number,
    x2: number,
    y2: number,
    playAsWhite?: boolean,
  ): Promise<{
    type: "move" | "pass" | "gameOver";
    x: number | null;
    y: number | null;
  }>;

  /**
   * Attempts to repair an offline node, leaving an empty playable node behind.
   *
   * Success chance can be seen via ns.go.cheat.getCheatSuccessChance()
   *
   * Warning: if you fail to play a cheat move, your turn will be skipped. After your first cheat attempt, if you fail, there is a
   * small (~10%) chance you will instantly be ejected from the subnet.
   *
   * @remarks
   * RAM cost: 8 GB
   *
   * Requires Source-File 14.2 to use
   *
   * @param x - x coordinate of offline node to repair
   * @param y - y coordinate of offline node to repair
   * @param playAsWhite - Optional override for playing as white. Can only be used when playing on a 'No AI' board.
   * @returns a promise that contains the opponent move's x and y coordinates (or pass) in response, or an indication if the game has ended
   */
  repairOfflineNode(
    x: number,
    y: number,
    playAsWhite?: boolean,
  ): Promise<{
    type: "move" | "pass" | "gameOver";
    x: number | null;
    y: number | null;
  }>;

  /**
   * Attempts to destroy an empty node, leaving an offline dead space that does not count as territory or
   * provide open node access to adjacent routers.
   *
   * Success chance can be seen via ns.go.cheat.getCheatSuccessChance()
   *
   * Warning: if you fail to play a cheat move, your turn will be skipped. After your first cheat attempt, if you fail, there is a
   * small (~10%) chance you will instantly be ejected from the subnet.
   *
   * @remarks
   * RAM cost: 8 GB
   *
   * Requires Source-File 14.2 to use
   *
   * @param x - x coordinate of empty node to destroy
   * @param y - y coordinate of empty node to destroy
   * @param playAsWhite - Optional override for playing as white. Can only be used when playing on a 'No AI' board.
   * @returns a promise that contains the opponent move's x and y coordinates (or pass) in response, or an indication if the game has ended
   */
  destroyNode(
    x: number,
    y: number,
    playAsWhite?: boolean,
  ): Promise<{
    type: "move" | "pass" | "gameOver";
    x: number | null;
    y: number | null;
  }>;
}

/**
 * IPvGO api
 * @public
 */
export interface Go {
  /**
   *  Make a move on the IPvGO subnet game board, and await the opponent's response.
   *  x:0 y:0 represents the bottom-left corner of the board in the UI.
   *
   * @remarks
   * RAM cost: 4 GB
   *
   * @param x - x coordinate of move to make
   * @param y - y coordinate of move to make
   * @param playAsWhite - optional. If true, attempts to play as white and then wait for black's move. Can only be used when playing as white when the opponent is set to "No AI"
   * @returns a promise that contains the opponent move's x and y coordinates (or pass) in response, or an indication if the game has ended
   */
  makeMove(
    x: number,
    y: number,
    playAsWhite?: boolean,
  ): Promise<{
    type: "move" | "pass" | "gameOver";
    x: number | null;
    y: number | null;
  }>;

  /**
   * Pass the player's turn rather than making a move, and await the opponent's response. This ends the game if the opponent
   *   passed on the previous turn, or if the opponent passes on their following turn.
   *
   * This can also be used if you pick up the game in a state where the opponent needs to play next. For example: if BitBurner was
   * closed while waiting for the opponent to make a move, you may need to call passTurn() to get them to play their move on game start.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * @param passAsWhite - optional. If true, attempts to pass as white and then wait for black's move. Only can be used when playing against "No AI".
   * @returns a promise that contains the opponent move's x and y coordinates (or pass) in response, or an indication if the game has ended
   *
   */
  passTurn(passAsWhite?: boolean): Promise<{
    type: "move" | "pass" | "gameOver";
    x: number | null;
    y: number | null;
  }>;

  /**
   *  Returns a promise that resolves with the success or failure state of your last move, and the AI's response, if applicable.
   *  x:0 y:0 represents the bottom-left corner of the board in the UI.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * @param logOpponentMove - optional, defaults to true. if false prevents logging opponent move
   * @param playAsWhite - optional. If true, waits to get the next move the black player makes. Intended to be used when playing as white when the opponent is set to "No AI"
   * @returns a promise that contains if your last move was valid and successful, the opponent move's x and y coordinates (or pass) in response, or an indication if the game has ended
   */
  opponentNextTurn(
    logOpponentMove?: boolean,
    playAsWhite?: boolean,
  ): Promise<{
    type: "move" | "pass" | "gameOver";
    x: number | null;
    y: number | null;
  }>;

  /**
   * Retrieves a simplified version of the board state. "X" represents black pieces, "O" white, and "." empty points.
   * "#" are dead nodes that are not part of the subnet. (They are not territory nor open nodes.)
   *
   * For example, a 5x5 board might look like this:
   *
   * ```
   * [
   *   "XX.O.",
   *   "X..OO",
   *   ".XO..",
   *   "XXO.#",
   *   ".XO.#",
   * ]
   * ```
   *
   * Each string represents a vertical column on the board, and each character in the string represents a point.
   *
   * Traditional notation for Go is e.g. "B,1" referring to second ("B") column, first rank. This is the equivalent of index [1][0].
   *
   * Note that the [0][0] point is shown on the bottom-left on the visual board (as is traditional), and each
   * string represents a vertical column on the board. In other words, the printed example above can be understood to
   * be rotated 90 degrees clockwise compared to the board UI as shown in the IPvGO subnet tab.
   *
   * @remarks
   * RAM cost: 4 GB
   */
  getBoardState(): string[];

  /**
   * Returns all the prior moves in the current game, as an array of simple board states.
   *
   * For example, a single 5x5 prior move board might look like this:
   *
   * ```
   * [
   *   "XX.O.",
   *   "X..OO",
   *   ".XO..",
   *   "XXO.#",
   *   ".XO.#",
   * ]
   * ```
   *
   * @remarks
   * RAM cost: 0 GB
   */
  getMoveHistory(): string[][];

  /**
   * Returns the color of the current player, or 'None' if the game is over.
   * @returns "White" | "Black" | "None"
   *
   * @remarks
   * RAM cost: 0 GB
   */
  getCurrentPlayer(): "White" | "Black" | "None";

  /**
   * Gets the status of the current game.
   * Shows the current player, current score, and the previous move coordinates.
   * Previous move will be null for a pass, or if there are no prior moves.
   *
   * @remarks
   * RAM cost: 0 GB
   */
  getGameState(): {
    currentPlayer: "White" | "Black" | "None";
    whiteScore: number;
    blackScore: number;
    previousMove: [number, number] | null;
    komi: number;
    bonusCycles: number;
  };

  /**
   * Returns the name of the opponent faction in the current subnet.
   *
   * @remarks
   * RAM cost: 0 GB
   */
  getOpponent(): GoOpponent;

  /**
   * Gets new IPvGO subnet with the specified size owned by the listed faction, ready for the player to make a move.
   * This will reset your win streak if the current game is not complete and you have already made moves.
   *
   * Note that some factions will have a few routers already on the subnet after a reset.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * @param opponent - The opponent faction to play against. "Netburners" | "Slum Snakes" | "The Black Hand" | "Tetrads" | "Daedalus" | "Illuminati" | "????????????" | "No AI"
   * @param boardSize - The size of the board to play on. Must be 5, 7, 9, or 13.
   * @returns a simplified version of the board state as an array of strings representing the board columns. See ns.Go.getBoardState() for full details
   */
  resetBoardState(opponent: GoOpponent, boardSize: 5 | 7 | 9 | 13): string[] | undefined;

  /**
   * Tools to analyze the IPvGO subnet.
   */
  analysis: GoAnalysis;

  /**
   * Illicit and dangerous IPvGO tools. Not for the faint of heart. Requires Source-File 14.2 to use.
   */
  cheat: GoCheat;
}

/**
 * Sleeve API
 * @remarks
 * If you are not in BitNode-10, then you must have Source-File 10 in order to use this API.
 * @public
 */
export interface Sleeve {
  /**
   * Get the number of sleeves you own.
   * @remarks
   * RAM cost: 4 GB
   *
   * Return the number of duplicate sleeves the player has.
   *
   * @returns Number of duplicate sleeves the player has.
   */
  getNumSleeves(): number;

  /**
   * Get information about a sleeve.
   * @remarks
   * RAM cost: 4 GB
   *
   * Return a person object for this sleeve
   *
   * storedCycles is the amount of Bonus Time in cycles, each translates to 200ms
   *
   * @param sleeveNumber - Index of the sleeve to retrieve information.
   * @returns Object containing information about this sleeve.
   */
  getSleeve(sleeveNumber: number): SleevePerson;

  /**
   * Get task of a sleeve.
   * @remarks
   * RAM cost: 4 GB
   *
   * Return the current task that the sleeve is performing, or null if the sleeve is idle. All tasks have a "type"
   * property, and other available properties depend on the type of task.
   *
   * @param sleeveNumber - Index of the sleeve to retrieve task from.
   * @returns Object containing information for the current task that the sleeve is performing.
   */
  getTask(sleeveNumber: number): SleeveTask | null;

  /**
   * Set a sleeve to idle.
   * @remarks
   * RAM cost: 4 GB
   *
   * @param sleeveNumber - Index of the sleeve to idle.
   */
  setToIdle(sleeveNumber: number): void;

  /**
   * Set a sleeve to shock recovery.
   * @remarks
   * RAM cost: 4 GB
   *
   * Return a boolean indicating whether or not this action was set successfully.
   *
   * @param sleeveNumber - Index of the sleeve to start recovery.
   * @returns True if this action was set successfully, false otherwise.
   */
  setToShockRecovery(sleeveNumber: number): boolean;

  /**
   * Set a sleeve to synchronize.
   * @remarks
   * RAM cost: 4 GB
   *
   * Return a boolean indicating whether or not this action was set successfully.
   *
   * @param sleeveNumber - Index of the sleeve to start synchronizing.
   * @returns True if this action was set successfully, false otherwise.
   */
  setToSynchronize(sleeveNumber: number): boolean;

  /**
   * Set a sleeve to commit crime.
   * @remarks
   * RAM cost: 4 GB
   *
   * Return a boolean indicating whether or not this action was set successfully (false if an invalid action is specified).
   *
   * @example
   * ```js
   * // Assigns the first sleeve to Homicide.
   * ns.sleeve.setToCommitCrime(0, "Homicide");
   *
   * // Assigns the second sleeve to Grand Theft Auto, using enum
   * const crimes = ns.enums.CrimeType;
   * ns.sleeve.setToCommitCrime(1, crimes.grandTheftAuto);
   * ```
   *
   * @param sleeveNumber - Index of the sleeve to start committing crime. Sleeves are numbered starting from 0.
   * @param crimeType - Name of the crime.
   * @returns True if this action was set successfully, false otherwise.
   */
  setToCommitCrime(sleeveNumber: number, crimeType: CrimeType): boolean;

  /**
   * Set a sleeve to work for a faction.
   * @remarks
   * RAM cost: 4 GB
   *
   * Return a boolean indicating whether or not the sleeve started working for a faction.
   *
   * @param sleeveNumber - Index of the sleeve to work for the faction.
   * @param factionName - Name of the faction to work for.
   * @param factionWorkType - Name of the action to perform for this faction.
   * @returns True if the sleeve started working for this faction, false otherwise. Can also throw on errors.
   */
  setToFactionWork(
    sleeveNumber: number,
    factionName: FactionName,
    factionWorkType: FactionWorkType,
  ): boolean | undefined;

  /**
   * Set a sleeve to work for a company.
   * @remarks
   * RAM cost: 4 GB
   *
   * Return a boolean indicating whether or not the sleeve started working for a company.
   *
   * @param sleeveNumber - Index of the sleeve to work for the company.
   * @param companyName - Name of the company to work for.
   * @returns True if the sleeve started working for this company, false otherwise.
   */
  setToCompanyWork(sleeveNumber: number, companyName: CompanyName): boolean;

  /**
   * Set a sleeve to take a class at a university.
   * @remarks
   * RAM cost: 4 GB
   *
   * Return a boolean indicating whether or not this action was set successfully.
   *
   * @param sleeveNumber - Index of the sleeve to start taking class.
   * @param universityName - Name of the university to attend.
   * @param courseName - Name of the course to follow.
   * @returns True if this action was set successfully, false otherwise.
   */
  setToUniversityCourse(
    sleeveNumber: number,
    universityName: UniversityLocationName,
    courseName: UniversityClassType,
  ): boolean;

  /**
   * Set a sleeve to workout at the gym.
   * @remarks
   * RAM cost: 4 GB
   *
   * Return a boolean indicating whether or not the sleeve started working out.
   *
   * @param sleeveNumber - Index of the sleeve to workout at the gym.
   * @param gymName - Name of the gym.
   * @param stat - Name of the stat to train.
   * @returns True if the sleeve started working out, false otherwise.
   */
  setToGymWorkout(sleeveNumber: number, gymName: GymLocationName, stat: GymType): boolean;

  /**
   * Make a sleeve travel to another city. The cost for using this function is the same as for a player.
   * @remarks
   * RAM cost: 4 GB
   *
   * Return a boolean indicating whether or not the sleeve reached destination.
   *
   * @param sleeveNumber - Index of the sleeve to travel.
   * @param city - Name of the destination city.
   * @returns True if the sleeve reached destination, false otherwise.
   */
  travel(sleeveNumber: number, city: CityName): boolean;

  /**
   * Get augmentations installed on a sleeve.
   * @remarks
   * RAM cost: 4 GB
   *
   * Return a list of augmentation names that this sleeve has installed.
   *
   * @param sleeveNumber - Index of the sleeve to retrieve augmentations from.
   * @returns List of augmentation names that this sleeve has installed.
   */
  getSleeveAugmentations(sleeveNumber: number): string[];

  /**
   * Get price of an augmentation.
   * @remarks
   * RAM cost: 4 GB
   *
   *
   * @param augName - Name of Augmentation.
   * @returns Price of the augmentation.
   */
  getSleeveAugmentationPrice(augName: string): number;

  /**
   * Get reputation requirement of an augmentation.
   * @remarks
   * RAM cost: 4 GB
   *
   *
   * @param augName - Name of Augmentation.
   * @returns Reputation requirement of the augmentation.
   */
  getSleeveAugmentationRepReq(augName: string): number;

  /**
   * List purchasable augs for a sleeve.
   * @remarks
   * RAM cost: 4 GB
   *
   * Return a list of augmentations that the player can buy for this sleeve.
   *
   * @param sleeveNumber - Index of the sleeve to retrieve purchasable augmentations from.
   * @returns List of augmentations that the player can buy for this sleeve.
   */
  getSleevePurchasableAugs(sleeveNumber: number): AugmentPair[];

  /**
   * Purchase an aug for a sleeve.
   * @remarks
   * RAM cost: 4 GB
   *
   * Return true if the aug was purchased and installed on the sleeve.
   *
   * @param sleeveNumber - Index of the sleeve to buy an aug for.
   * @param augName - Name of the aug to buy. Must be an exact match.
   * @returns True if the aug was purchased and installed on the sleeve, false otherwise.
   */
  purchaseSleeveAug(sleeveNumber: number, augName: string): boolean;

  /**
   * Set a sleeve to perform Bladeburner actions.
   * @remarks
   * RAM cost: 4 GB
   *
   * Return a boolean indicating whether or not the sleeve started a Bladeburner action.
   *
   * @param sleeveNumber - Index of the sleeve to perform a Bladeburner action.
   * @param action - Name of the action to be performed.
   * @param contract - Name of the contract if applicable.
   * @returns True if the sleeve started the given Bladeburner action, false otherwise.
   */
  setToBladeburnerAction(
    sleeveNumber: number,
    action: BladeburnerActionTypeForSleeve,
    contract?: BladeburnerContractName,
  ): boolean;

  /**
   * Purchase a sleeve. You must be in BitNode 10 to use this API.
   *
   * @remarks
   * RAM cost: 4 GB
   *
   * @returns Action result
   */
  purchaseSleeve(): Result;

  /**
   * Upgrade memory of a sleeve. You must be in BitNode 10 to use this API.
   *
   * @remarks
   * RAM cost: 4 GB
   *
   * @param sleeveNumber - Index of the sleeve.
   * @param amount - Number of upgrades. Must be a positive integer.
   * @returns Action result
   */
  upgradeMemory(sleeveNumber: number, amount: number): Result;

  /**
   * Get the cost of the next sleeve.
   *
   * @remarks
   * RAM cost: 4 GB
   *
   * @returns Cost of the next sleeve. Return Infinity if you reach the maximum number of purchasable sleeves.
   */
  getSleeveCost(): number;

  /**
   * Get the cost of memory upgrades.
   *
   * @remarks
   * RAM cost: 4 GB
   *
   * @param sleeveNumber - Index of the sleeve.
   * @param amount - Number of upgrades. Must be a positive integer.
   * @returns Cost of the upgrades. Return Infinity if the current memory plus the amount of upgrades is greater than
   * 100.
   */
  getMemoryUpgradeCost(sleeveNumber: number, amount: number): number;
}

/**
 * Grafting API
 * @remarks
 * This API requires Source-File 10 to use.
 * @public
 */
export interface Grafting {
  /**
   * Retrieve the grafting cost of an aug.
   * @remarks
   * RAM cost: 3.75 GB
   *
   * @param augName - Name of the aug to check the price of. Must be an exact match.
   * @returns The cost required to graft the named augmentation.
   * @throws Will error if an invalid Augmentation name is provided.
   */
  getAugmentationGraftPrice(augName: string): number;

  /**
   * Retrieves the time required to graft an aug. Do not use this value to determine when the ongoing grafting finishes.
   * The ongoing grafting is affected by current intelligence level and focus bonus. You should use
   * {@link Grafting.waitForOngoingGrafting | waitForOngoingGrafting} for that purpose.
   *
   * @remarks
   * RAM cost: 3.75 GB
   *
   * @param augName - Name of the aug to check the grafting time of. Must be an exact match.
   * @returns The time required, in milliseconds, to graft the named augmentation.
   * @throws Will error if an invalid Augmentation name is provided.
   */
  getAugmentationGraftTime(augName: string): number;

  /**
   * Retrieves a list of augmentations that can be grafted.
   *
   * @remarks
   * RAM cost: 5 GB
   *
   * Note:
   *
   * - This function returns a list of currently graftable augmentations, based on the augmentations that you already
   * own.
   *
   * - This function does not check your current money and prerequisite augmentations. For example, it returns
   * "Augmented Targeting II" even when you don't have enough money to graft that augmentation or don't have the
   * prerequisite augmentation ("Augmented Targeting I").
   *
   * @returns An array of graftable augmentations.
   */
  getGraftableAugmentations(): string[];

  /**
   * Begins grafting the named aug. You must be in New Tokyo to use this. When you call this API, the current work
   * (grafting or other actions) will be canceled.
   *
   * @remarks
   * RAM cost: 7.5 GB
   *
   * @param augName - The name of the aug to begin grafting. Must be an exact match.
   * @param focus - Acquire player focus on this Augmentation grafting. Optional. Defaults to true.
   * @returns True if the aug successfully began grafting, false otherwise (e.g. not enough money, or
   * invalid Augmentation name provided).
   * @throws Will error if called while you are not in New Tokyo.
   */
  graftAugmentation(augName: string, focus?: boolean): boolean;

  /**
   * Wait until the ongoing grafting finishes or is canceled.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * @returns A promise that resolves when the current grafting finishes or is canceled. If there is no current work,
   * the promise resolves immediately. If the current work is not a grafting work, the promise rejects immediately.
   */
  waitForOngoingGrafting(): Promise<void>;
}

/**
 * Skills formulas
 * @public
 */
interface SkillsFormulas {
  /**
   * Calculate skill level.
   * @param exp - experience for that skill
   * @param skillMult - Multiplier for that skill, defaults to 1.
   * @returns The calculated skill level.
   */
  calculateSkill(exp: number, skillMult?: number): number;
  /**
   * Calculate exp for skill level.
   * @param skill - target skill level
   * @param skillMult - Multiplier for that skill, defaults to 1.
   * @returns The calculated exp required.
   */
  calculateExp(skill: number, skillMult?: number): number;
}

/** @public */
interface WorkStats {
  money: number;
  reputation: number;
  hackExp: number;
  strExp: number;
  defExp: number;
  dexExp: number;
  agiExp: number;
  chaExp: number;
  intExp: number;
}

/**
 * Work formulas
 * @public
 */
interface WorkFormulas {
  crimeSuccessChance(person: Person, crimeType: CrimeType): number;
  /** @returns The WorkStats gained when completing one instance of the specified crime. */
  crimeGains(person: Person, crimeType: CrimeType): WorkStats;
  /** @returns The WorkStats applied every game cycle (200ms) by taking the specified gym class. */
  gymGains(person: Person, gymType: GymType, locationName: LocationName): WorkStats;
  /** @returns The WorkStats applied every game cycle (200ms) by taking the specified university class. */
  universityGains(person: Person, classType: UniversityClassType, locationName: LocationName): WorkStats;
  /** @returns The WorkStats applied every game cycle (200ms) by performing the specified faction work. */
  factionGains(person: Person, workType: FactionWorkType, favor: number): WorkStats;
  /** @returns The WorkStats applied every game cycle (200ms) by performing the specified company work. */
  companyGains(person: Person, companyName: CompanyName, workType: JobName, favor: number): WorkStats;
}

/**
 * Reputation formulas
 * @public
 */
interface ReputationFormulas {
  /**
   * Calculate the total required amount of faction reputation to reach a target favor.
   * @param favor - target faction favor.
   * @returns The calculated faction reputation required.
   */
  calculateFavorToRep(favor: number): number;
  /**
   * Calculate the resulting faction favor of a total amount of reputation.
   * (Faction favor is gained whenever you install an Augmentation.)
   * @param rep - amount of reputation.
   * @returns The calculated faction favor.
   */
  calculateRepToFavor(rep: number): number;

  /**
   * Calculate how much rep would be gained.
   * @param amount - Amount of money donated
   * @param player - Player info, typically from {@link NS.getPlayer | getPlayer}
   */
  repFromDonation(amount: number, player: Person): number;

  /**
   * Calculate the donation needed to gain an amount of reputation.
   * @param reputation - Amount of reputation
   * @param player - Player info, typically from {@link NS.getPlayer | getPlayer}
   */
  donationForRep(reputation: number, player: Person): number;

  /**
   * Calculate the share power if you call {@link NS.share | ns.share} with the specified number of threads on a server
   * having the specified number of CPU cores.
   * @param threads - Number of threads. Must be a positive integer.
   * @param cpuCores - Number of CPU cores. Must be a positive integer. The default value is 1.
   * @returns The calculated share power.
   */
  sharePower(threads: number, cpuCores?: number): number;
}

/**
 * Hacking formulas
 * @public
 */
interface HackingFormulas {
  /**
   * Calculate hack chance.
   * (Ex: 0.25 would indicate a 25% chance of success.)
   * @param server - Server info, typically from {@link NS.getServer | getServer}
   * @param player - Player info, typically from {@link NS.getPlayer | getPlayer}
   * @returns The calculated hack chance.
   */
  hackChance(server: Server, player: Person): number;
  /**
   * Calculate hack exp for one thread.
   * @remarks
   * Multiply by thread to get total exp
   * @param server - Server info, typically from {@link NS.getServer | getServer}
   * @param player - Player info, typically from {@link NS.getPlayer | getPlayer}
   * @returns The calculated hack exp.
   */
  hackExp(server: Server, player: Person): number;
  /**
   * Calculate hack percent for one thread.
   * (Ex: 0.25 would steal 25% of the server's current value.)
   * @remarks
   * Multiply by thread to get total percent hacked.
   * @param server - Server info, typically from {@link NS.getServer | getServer}
   * @param player - Player info, typically from {@link NS.getPlayer | getPlayer}
   * @returns The calculated hack percent.
   */
  hackPercent(server: Server, player: Person): number;
  /**
   * Calculate the growth multiplier constant for a given server and threads.
   *
   * The actual amount of money grown depends both linearly *and* exponentially on threads;
   * this is only giving the exponential part that is used for the multiplier.
   * See {@link NS.grow | grow} for more details.
   *
   * As a result of the above, this multiplier does *not* depend on the amount of money on the server.
   * Changing server.moneyAvailable and server.moneyMax will have no effect.
   *
   * For the most common use-cases, you probably want
   * either {@link HackingFormulas.growThreads | formulas.hacking.growThreads}
   * or {@link HackingFormulas.growAmount | formulas.hacking.growAmount} instead.
   * @param server - Server info, typically from {@link NS.getServer | getServer}
   * @param threads - Amount of threads. Can be fractional.
   * @param player - Player info, typically from {@link NS.getPlayer | getPlayer}
   * @param cores - Number of cores on the computer that will execute grow.
   * @returns The calculated grow percent.
   */
  growPercent(server: Server, threads: number, player: Person, cores?: number): number;
  /**
   * Calculate how many threads it will take to grow server to targetMoney. Starting money is server.moneyAvailable.
   * Note that when simulating the effect of {@link NS.grow | grow}, what matters is the state of the server and player
   * when the grow *finishes*, not when it is started.
   *
   * The growth amount depends both linearly *and* exponentially on threads; see {@link NS.grow | grow} for more details.
   *
   * The inverse of this function is {@link HackingFormulas.growAmount | formulas.hacking.growAmount},
   * although it can work with fractional threads.
   * @param server - Server info, typically from {@link NS.getServer | getServer}
   * @param player - Player info, typically from {@link NS.getPlayer | getPlayer}
   * @param targetMoney - Desired final money, capped to server's moneyMax
   * @param cores - Number of cores on the computer that will execute grow.
   * @returns The calculated grow threads as an integer, rounded up.
   */
  growThreads(server: Server, player: Person, targetMoney: number, cores?: number): number;
  /**
   * Calculate the amount of money a grow action will leave a server with. Starting money is server.moneyAvailable.
   * Note that when simulating the effect of {@link NS.grow | grow}, what matters is the state of the server and player
   * when the grow *finishes*, not when it is started.
   *
   * The growth amount depends both linearly *and* exponentially on threads; see {@link NS.grow | grow} for more details.
   *
   * The inverse of this function is {@link HackingFormulas.growThreads | formulas.hacking.growThreads},
   * although it rounds up to integer threads.
   * @param server - Server info, typically from {@link NS.getServer | getServer}
   * @param player - Player info, typically from {@link NS.getPlayer | getPlayer}
   * @param threads - Number of threads to grow with. Can be fractional.
   * @param cores - Number of cores on the computer that will execute grow.
   * @returns The amount of money after the calculated grow.
   */
  growAmount(server: Server, player: Person, threads: number, cores?: number): number;
  /**
   * Calculate hack time.
   * @param server - Server info, typically from {@link NS.getServer | getServer}
   * @param player - Player info, typically from {@link NS.getPlayer | getPlayer}
   * @returns The calculated hack time, in milliseconds.
   */
  hackTime(server: Server, player: Person): number;
  /**
   * Calculate grow time.
   * @param server - Server info, typically from {@link NS.getServer | getServer}
   * @param player - Player info, typically from {@link NS.getPlayer | getPlayer}
   * @returns The calculated grow time, in milliseconds.
   */
  growTime(server: Server, player: Person): number;
  /**
   * Calculate weaken time.
   * @param server - Server info, typically from {@link NS.getServer | getServer}
   * @param player - Player info, typically from {@link NS.getPlayer | getPlayer}
   * @returns The calculated weaken time, in milliseconds.
   */
  weakenTime(server: Server, player: Person): number;
  /**
   * Calculate the security decrease from a weaken operation.
   * Unlike other hacking formulas, weaken effect depends only on thread count and
   * core count, not on server or player properties. The core bonus formula is
   * `1 + (cores - 1) / 16`.
   * @param threads - Number of threads running weaken.
   * @param cores - Number of cores on the host server. Default 1.
   * @returns The security decrease amount.
   */
  weakenEffect(threads: number, cores?: number): number;
}

/**
 * Hacknet Node formulas
 * @public
 */
interface HacknetNodesFormulas {
  /**
   * Calculate money gain rate.
   * @param level - level of the node.
   * @param ram - ram of the node.
   * @param cores - cores of the node.
   * @param mult - player production mult (default to 1)
   * @returns The calculated money gain rate.
   */
  moneyGainRate(level: number, ram: number, cores: number, mult?: number): number;
  /**
   * Calculate cost of upgrading hacknet node level.
   * @param startingLevel - starting level
   * @param extraLevels - amount of level to purchase (defaults to 1)
   * @param costMult - player cost reduction (default to 1)
   * @returns The calculated cost.
   */
  levelUpgradeCost(startingLevel: number, extraLevels?: number, costMult?: number): number;
  /**
   * Calculate cost of upgrading hacknet node ram.
   * @param startingRam - starting ram
   * @param extraLevels - amount of level of ram to purchase (defaults to 1)
   * @param costMult - player cost reduction (default to 1)
   * @returns The calculated cost.
   */
  ramUpgradeCost(startingRam: number, extraLevels?: number, costMult?: number): number;
  /**
   * Calculate cost of upgrading hacknet node cores.
   * @param startingCore - starting cores
   * @param extraCores - amount of cores to purchase (defaults to 1)
   * @param costMult - player cost reduction (default to 1)
   * @returns The calculated cost.
   */
  coreUpgradeCost(startingCore: number, extraCores?: number, costMult?: number): number;
  /**
   * Calculate the cost of a hacknet node.
   * @param n - number of the hacknet node
   * @param mult - player cost reduction (defaults to 1)
   * @returns The calculated cost.
   */
  hacknetNodeCost(n: number, mult?: number): number;
  /**
   * All constants used by the game.
   * @returns An object with all hacknet node constants used by the game.
   */
  constants(): HacknetNodeConstants;
}

/**
 * Hacknet Server formulas
 * @public
 */
interface HacknetServersFormulas {
  /**
   * Calculate hash gain rate.
   * @param level - level of the server.
   * @param ramUsed - ramUsed of the server.
   * @param maxRam - maxRam of the server.
   * @param cores - cores of the server.
   * @param mult - player production mult (default to 1)
   * @returns The calculated hash gain rate.
   */
  hashGainRate(level: number, ramUsed: number, maxRam: number, cores: number, mult?: number): number;
  /**
   * Calculate cost of upgrading hacknet server level.
   * @param startingLevel - starting level
   * @param extraLevels - amount of level to purchase (defaults to 1)
   * @param costMult - player cost reduction (default to 1)
   * @returns The calculated cost.
   */
  levelUpgradeCost(startingLevel: number, extraLevels?: number, costMult?: number): number;
  /**
   * Calculate cost of upgrading hacknet server ram.
   * @param startingRam - starting ram
   * @param extraLevels - amount of level of ram to purchase (defaults to 1)
   * @param costMult - player cost reduction (default to 1)
   * @returns The calculated cost.
   */
  ramUpgradeCost(startingRam: number, extraLevels?: number, costMult?: number): number;
  /**
   * Calculate cost of upgrading hacknet server cores.
   * @param startingCore - starting cores
   * @param extraCores - amount of cores to purchase (defaults to 1)
   * @param costMult - player cost reduction (default to 1)
   * @returns The calculated cost.
   */
  coreUpgradeCost(startingCore: number, extraCores?: number, costMult?: number): number;
  /**
   * Calculate cost of upgrading hacknet server cache.
   * @param startingCache - starting cache level
   * @param extraCache - amount of levels of cache to purchase (defaults to 1)
   * @returns The calculated cost.
   */
  cacheUpgradeCost(startingCache: number, extraCache?: number): number;
  /**
   * Calculate hash cost of an upgrade.
   * @param upgName - name of the upgrade
   * @param level - level of the upgrade
   * @returns The calculated hash cost.
   */
  hashUpgradeCost(upgName: HacknetServerHashUpgrade, level: number): number;
  /**
   * Calculate the cost of a hacknet server.
   * @param n - number of the hacknet server
   * @param mult - player cost reduction (defaults to 1)
   * @returns The calculated cost.
   */
  hacknetServerCost(n: number, mult?: number): number;
  /**
   * All constants used by the game.
   * @returns An object with all hacknet server constants used by the game.
   */
  constants(): HacknetServerConstants;
}

/**
 * Gang formulas
 * @public
 */
interface GangFormulas {
  /**
   * Calculate the wanted penalty.
   * @param gang - Gang info from {@link Gang.getGangInformation | getGangInformation}
   * @returns The calculated wanted penalty.
   */
  wantedPenalty(gang: GangGenInfo): number;
  /**
   * Calculate respect gain per tick.
   * @param gang - Gang info from {@link Gang.getGangInformation | getGangInformation}
   * @param member - Gang info from {@link Gang.getMemberInformation | getMemberInformation}
   * @param task - Gang info from {@link Gang.getTaskStats | getTaskStats}
   * @returns The calculated respect gain.
   */
  respectGain(gang: GangGenInfo, member: GangMemberInfo, task: GangTaskStats): number;
  /**
   * Calculate wanted gain per tick.
   * @param gang - Gang info from {@link Gang.getGangInformation | getGangInformation}
   * @param member - Member info from {@link Gang.getMemberInformation | getMemberInformation}
   * @param task - Task info from {@link Gang.getTaskStats | getTaskStats}
   * @returns The calculated wanted gain.
   */
  wantedLevelGain(gang: GangGenInfo, member: GangMemberInfo, task: GangTaskStats): number;
  /**
   * Calculate money gain per tick.
   * @param gang - Gang info from {@link Gang.getGangInformation | getGangInformation}
   * @param member - Member info from {@link Gang.getMemberInformation | getMemberInformation}
   * @param task - Task info from {@link Gang.getTaskStats | getTaskStats}
   * @returns The calculated money gain.
   */
  moneyGain(gang: GangGenInfo, member: GangMemberInfo, task: GangTaskStats): number;

  /**
   * Calculate ascension point gain.
   * @param exp - Experience point before ascension.
   * @returns The calculated ascension point gain.
   */
  ascensionPointsGain(exp: number): number;

  /**
   * Calculate ascension mult.
   * @param points - Amount of ascension points.
   * @returns The calculated ascension mult.
   */
  ascensionMultiplier(points: number): number;
}

/**
 * Bladeburner formulas
 * @public
 */
interface BladeburnerFormulas {
  /**
   * Calculate the number of times that you can upgrade a skill.
   *
   * @param name - Skill name. It's case-sensitive and must be an exact match.
   * @param level - Skill level. It must be a non-negative number.
   * @param skillPoints - Number of skill points to upgrade the skill. It must be a non-negative number.
   * @returns Number of times that you can upgrade the skill.
   */
  skillMaxUpgradeCount(name: BladeburnerSkillName, level: number, skillPoints: number): number;
}

/**
 * Darknet formulas
 * @public
 */
interface DarknetFormulas {
  /**
   * Gets the time it will take to authenticate a server.
   * @param serverDetails - The server to check authentication time on.
   * @param threads - The number of threads to use for the authentication. Optional, defaults to 1
   * @param player - The player object. Optional, defaults to the current player status
   * @param correctCharactersInPassword - only used for 2G_cellular model servers. The number of correct characters in the attempted password. Optional, defaults to 0
   */
  getAuthenticateTime(
    serverDetails: DarknetServerDetails,
    threads?: number,
    player?: Person,
    correctCharactersInPassword?: number,
  ): number;
  /**
   * Gets the time it will take to scrape logs from a server.
   * @param serverDetails - The server to check heartbleed log scraping time on.
   * @param threads - The number of threads to use for log scraping. Optional, defaults to 1
   * @param player - The player object. Optional, defaults to the current player status
   */
  getHeartbleedTime(serverDetails: DarknetServerDetails, threads?: number, player?: Person): number;

  /**
   * Gets the expected amount off ram that will be freed by a call to dnet.memoryReallocation
   * @param serverDetails - The server to check ram freed on.
   * @param threads - The number of threads used in the memoryReallocation call. Optional, defaults to 1
   * @param player - The player object. Optional, defaults to the current player status
   */
  getExpectedRamBlockRemoved(serverDetails: DarknetServerDetails, threads?: number, player?: Person): number;
}

/**
 * Formulas API
 * @remarks
 * You need Formulas.exe on your home computer to use this API.
 * @public
 */
export interface Formulas {
  mockServer(): Server;
  mockPlayer(): Player;
  mockPerson(): Person;
  /** Reputation formulas */
  reputation: ReputationFormulas;
  /** Skills formulas */
  skills: SkillsFormulas;
  /** Hacking formulas */
  hacking: HackingFormulas;
  /** Hacknet Nodes formulas */
  hacknetNodes: HacknetNodesFormulas;
  /** Hacknet Servers formulas */
  hacknetServers: HacknetServersFormulas;
  /** Gang formulas */
  gang: GangFormulas;
  /** Work formulas */
  work: WorkFormulas;
  /** Bladeburner formulas */
  bladeburner: BladeburnerFormulas;
  /** Darknet formulas */
  dnet: DarknetFormulas;
}

/** @public */
type FragmentEnumType = {
  HackingSpeed: 3;
  HackingMoney: 4;
  HackingGrow: 5;
  Hacking: 6;
  Strength: 7;
  Defense: 8;
  Dexterity: 9;
  Agility: 10;
  Charisma: 11;
  HacknetMoney: 12;
  HacknetCost: 13;
  Rep: 14;
  WorkMoney: 15;
  Crime: 16;
  Bladeburner: 17;
  Booster: 18;
};

/** @public */
type FragmentType = _ValueOf<FragmentEnumType>;

/** @public */
interface Fragment {
  id: number;
  shape: boolean[][];
  type: FragmentType;
  power: number;
  limit: number;
  effect: string;
}

/** @public */
interface ActiveFragment extends Fragment {
  highestCharge: number;
  numCharge: number;
  rotation: number;
  x: number;
  y: number;
  /**
   * This is the raw value of the modifier used to calculate the effect on your multipliers. It may not be a multiplier.
   *
   * With fragments that increase a multiplier, this value is a multiplier. For example, with "+x% hacknet production"
   * fragment, a value of 1.25 will multiply the "hacknet_node_money" multiplier by 1.25. The UI will show "+25% hacknet
   * production".
   *
   * With fragments that decrease a multiplier, you need to invert this value. For example, with "-x% cheaper hacknet
   * costs" fragment, a value of 1.25 means the "hacknet_node_purchase_cost" (and other relevant cost multipliers) will
   * be multiplied by 0.8 (1 / 1.25). The UI will show "20% cheaper hacknet costs".
   *
   * With booster fragments, this value is always 1. Booster fragments only boost non-booster fragments. They don't
   * directly boost your multipliers.
   */
  chargedEffect: number;
}

/**
 * Stanek's Gift API.
 * @public
 */
interface Stanek {
  /**
   * Stanek's Gift width.
   * @remarks
   * RAM cost: 0.4 GB
   * @returns The width of the gift.
   */
  giftWidth(): number;
  /**
   * Stanek's Gift height.
   * @remarks
   * RAM cost: 0.4 GB
   * @returns The height of the gift.
   */
  giftHeight(): number;

  /**
   * Charge a fragment, increasing its power.
   * @remarks
   * RAM cost: 0.4 GB
   * @param rootX - Root X against which to align the top left of the fragment.
   * @param rootY - Root Y against which to align the top left of the fragment.
   * @returns Promise that lasts until the charge action is over.
   */
  chargeFragment(rootX: number, rootY: number): Promise<void>;

  /**
   * List possible fragments.
   * @remarks
   * RAM cost: 0 GB
   *
   * @returns List of possible fragments.
   */
  fragmentDefinitions(): Fragment[];

  /**
   * List of fragments in Stanek's Gift.
   * @remarks
   * RAM cost: 5 GB
   *
   * @returns List of active fragments placed on Stanek's Gift.
   */
  activeFragments(): ActiveFragment[];

  /**
   * Clear the board of all fragments.
   * @remarks
   * RAM cost: 0 GB
   */
  clearGift(): void;

  /**
   * Check if fragment can be placed at specified location.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * @param rootX - Root X against which to align the top left of the fragment.
   * @param rootY - Root Y against which to align the top left of the fragment.
   * @param rotation - A number from 0 to 3, the amount of 90-degree turns to take.
   * @param fragmentId - ID of the fragment to place.
   * @returns true if the fragment can be placed at that position. false otherwise.
   */
  canPlaceFragment(rootX: number, rootY: number, rotation: number, fragmentId: number): boolean;
  /**
   * Place fragment on Stanek's Gift.
   * @remarks
   * RAM cost: 5 GB
   *
   * @param rootX - X against which to align the top left of the fragment.
   * @param rootY - Y against which to align the top left of the fragment.
   * @param rotation - A number from 0 to 3, the mount of 90 degree turn to take.
   * @param fragmentId - ID of the fragment to place.
   * @returns true if the fragment can be placed at that position. false otherwise.
   */
  placeFragment(rootX: number, rootY: number, rotation: number, fragmentId: number): boolean;
  /**
   * Get placed fragment at location.
   * @remarks
   * RAM cost: 2 GB
   *
   * @param rootX - X against which to align the top left of the fragment.
   * @param rootY - Y against which to align the top left of the fragment.
   * @returns The fragment at [rootX, rootY], if any.
   */
  getFragment(rootX: number, rootY: number): ActiveFragment | undefined;

  /**
   * Remove fragment at location.
   * @remarks
   * RAM cost: 0.15 GB
   *
   * @param rootX - X against which to align the top left of the fragment.
   * @param rootY - Y against which to align the top left of the fragment.
   * @returns The fragment at [rootX, rootY], if any.
   */
  removeFragment(rootX: number, rootY: number): boolean;

  /**
   * Accept Stanek's Gift by joining the Church of the Machine God
   * @remarks
   * RAM cost: 2 GB
   *
   * The church only accepts those who have not purchased or installed any augmentations. "NeuroFlux Governor"
   * augmentation is the only exception.
   *
   * @returns true if the player is a member of the church and has the gift installed,
   * false otherwise.
   */
  acceptGift(): boolean;
}

/** @public */
interface InfiltrationReward {
  tradeRep: number;
  sellCash: number;
  SoARep: number;
}

/** @public */
interface ILocation {
  city: CityName;
  name: LocationName;
}

/** @public */
interface InfiltrationLocation {
  location: ILocation;
  reward: InfiltrationReward;
  difficulty: number;
  maxClearanceLevel: number;
  startingSecurityLevel: number;
}

/**
 * Infiltration API.
 * @public
 */
interface Infiltration {
  /**
   * Get all locations that can be infiltrated.
   * @remarks
   * RAM cost: 0 GB
   *
   * @returns all locations that can be infiltrated.
   */
  getPossibleLocations(): ILocation[];
  /**
   * Get all infiltrations with difficulty, location and rewards.
   * @remarks
   * RAM cost: 15 GB
   *
   * @returns Infiltration data for given location.
   */
  getInfiltration(location: LocationName): InfiltrationLocation;
}

/**
 * User Interface API.
 * @public
 */
interface UserInterface {
  /**
   * Open the tail window of a script.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * Opens a script’s logs. This is functionally the same as the tail Terminal command.
   *
   * If the function is called with no arguments, it will open the current script’s logs.
   *
   * Otherwise, the PID or filename, hostname/ip, and args… arguments can be used to get the logs from another script.
   * Remember that scripts are uniquely identified by both their names and arguments.
   *
   * @example
   * ```js
   * //Open logs from foo.js on the current server that was run with no args
   * ns.ui.openTail("foo.js");
   *
   * //Get logs from foo.js on the foodnstuff server that was run with no args
   * ns.ui.openTail("foo.js", "foodnstuff");
   *
   * //Get logs from foo.js on the foodnstuff server that was run with the arguments [1, "test"]
   * ns.ui.openTail("foo.js", "foodnstuff", 1, "test");
   * ```
   * @param fn - Optional. Filename or PID of the script being tailed. If omitted, the current script is tailed.
   * @param host - Optional. Hostname/IP of the script being tailed. Defaults to the server this script is running on. If args are specified, this is not optional.
   * @param args - Arguments for the script being tailed.
   */
  openTail(fn?: FilenameOrPID, host?: string, ...args: ScriptArg[]): void;

  /**
   * Render a tail window.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * Tail windows are rendered at an interval defined in game settings. This function renders the tail window of the
   * specified script immediately.
   *
   * @param pid - Optional. PID of the script having its tail rendered. If omitted, the current script is used.
   */
  renderTail(pid?: number): void;

  /**
   * Move a tail window.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * Moves a tail window. Coordinates are in screen space pixels (top left is 0,0).
   *
   * @param x - x coordinate.
   * @param y - y coordinate.
   * @param pid - Optional. PID of the script having its tail moved. If omitted, the current script is used.
   */
  moveTail(x: number, y: number, pid?: number): void;

  /**
   * Resize a tail window.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * Resize a tail window. Size are in pixel.
   *
   * @param width - Width of the window. The minimum value is 150.
   * @param height - Height of the window. The minimum value is 30.
   * @param pid - Optional. PID of the script having its tail resized. If omitted, the current script is used.
   */
  resizeTail(width: number, height: number, pid?: number): void;

  /**
   * Close the tail window of a script.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * Closes a script’s logs. This is functionally the same as pressing the "Close" button on the tail window.
   *
   * If the function is called with no arguments, it will close the current script’s logs.
   *
   * Otherwise, the pid argument can be used to close the logs from another script. Tail windows can remain open
   * after a script finishes, and can still be closed using that script's PID. If the script is rerun from its tail
   * window, use the PID of the new process.
   *
   * If no tail window exists for the given PID, this function has no effect.
   *
   * @param pid - Optional. PID of the script having its tail closed. If omitted, the current script is used.
   */
  closeTail(pid?: number): void;

  /**
   * Set the title of the tail window of a script.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * This sets the title to the given string, and also forces an update of the
   * tail window's contents.
   *
   * The title is saved across restarts, but only if it is a simple string.
   *
   * If the pid is unspecified, it will modify the current script’s logs.
   *
   * Otherwise, the pid argument can be used to change the logs from another script.
   *
   * It is possible to pass any React Node instead of a string.
   * See {@link ReactElement} and {@link ReactNode} types for additional info.
   *
   * @param title - The new title for the tail window.
   * @param pid - Optional. PID of the script having its tail closed. If omitted, the current script is used.
   */
  setTailTitle(title: string | ReactNode, pid?: number): void;

  /**
   * Set the font size of the tail window of a script.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * This overwrites the tail font size and forces an update of the tail window's contents.
   *
   * If ran without a filename or pid, this will affect the current script's tail window.
   *
   * Otherwise, the PID or filename, hostname/ip, and args… arguments can be used to target the tail window from another script.
   * Remember that scripts are uniquely identified by both their names and arguments.
   *
   * @param pixel - Optional. The new font size in pixels. If omitted, the default tail font size is used.
   * @param fn - Optional. Filename or PID of the target script. If omitted, the current script is used.
   * @param host - Optional. Hostname/IP of the target script. Defaults to the server this script is running on. If args are specified, this is not optional.
   * @param args - Arguments for the target script.
   */
  setTailFontSize(pixel?: number, fn?: FilenameOrPID, host?: string, ...args: ScriptArg[]): void;

  /**
   * Minimize or expand the tail window of a script.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * Equivalent to pressing the "Minimize"/"Expand" button on the tail window.
   *
   * If called without arguments, this function minimizes/expands the tail window of the current script. If a PID is
   * provided, it minimizes/expands the tail window of the specified script instead.
   *
   * @param pid - Optional. The PID of the script. If omitted, the current script is used.
   */
  setTailMinimized(minimized: boolean, pid?: number): void;

  /**
   * Get the current window size
   * @remarks
   * RAM cost: 0 GB
   *
   * @returns An array of 2 value containing the window width and height.
   */
  windowSize(): [number, number];

  /**
   * Get the current theme
   * @remarks
   * RAM cost: 0 GB
   *
   * @returns An object containing the theme's colors
   */
  getTheme(): UserInterfaceTheme;

  /**
   * Sets the current theme
   * @remarks
   * RAM cost: 0 GB
   * @example
   * ```js
   * const theme = ns.ui.getTheme();
   * theme.primary = '#ff5500';
   * ns.ui.setTheme(theme);
   * ```
   */
  setTheme(newTheme: UserInterfaceTheme): void;

  /**
   * Resets the player's theme to the default values
   * @remarks
   * RAM cost: 0 GB
   */
  resetTheme(): void;

  /**
   * Get the current styles
   * @remarks
   * RAM cost: 0 GB
   *
   * @returns An object containing the player's styles
   */
  getStyles(): IStyleSettings;

  /**
   * Sets the current styles
   * @remarks
   * RAM cost: 0 GB
   * @example
   * ```js
   * const styles = ns.ui.getStyles();
   * styles.fontFamily = 'Comic Sans Ms';
   * ns.ui.setStyles(styles);
   * ```
   */
  setStyles(newStyles: IStyleSettings): void;

  /**
   * Resets the player's styles to the default values
   * @remarks
   * RAM cost: 0 GB
   */
  resetStyles(): void;

  /**
   * Gets the current game information (version, commit, ...)
   * @remarks
   * RAM cost: 0 GB
   */
  getGameInfo(): GameInfo;

  /**
   * Clear the Terminal window, as if the player ran `clear` in the terminal
   * @remarks
   * RAM cost: 0 GB
   */
  clearTerminal(): void;

  /**
   * Opens the specified file(s) in the code editor.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * This opens files from the server the script is running on, which may be different than the server the terminal is connected to.
   *
   * @example
   * ```js
   *   ns.ui.openCodeEditor("foo.js");
   *   ns.ui.openCodeEditor(["bar.js", "data.json"], { vim: true });
   * ```
   *
   * @param files - Optional. The file(s) to open in the editor. If not provided, opens the editor to the last edited file, if any.
   * @param editorOptions - Optional. Settings for opening the editor, such as `vim` mode
   */
  openCodeEditor(files?: string | string[], editorOptions?: EditorOptions): void;

  /**
   * Programmatically sets an alias.
   * @remarks
   * RAM cost: 0 GB
   *
   * This is functionally equivalent to typing `alias ${alias}=${substitution}` in the terminal.
   *
   * This function throws an error if `alias` is an empty string or contains any invalid characters (only alphanumeric
   * characters and `_|!%,@-` are allowed).
   *
   * Only one alias may be defined for a given context. Setting a global alias will silently overwrite an existing
   * non-global alias with the same name, and vice versa.
   *
   * @example
   * ```js
   * export async function main(ns) {
   *   ns.ui.alias("nuke", "run NUKE.exe"); // Equivalent to typing `alias nuke="run NUKE.exe"`
   *   ns.ui.alias("worm", "HTTPWorm.exe", true); // Equivalent to typing `alias -g worm="HTTPWorm.exe"`
   * }
   *
   * ```
   * @param alias - The alias name to set.
   * @param substitution - The substitution to run.
   * @param isGlobal - Whether the alias should be set as a global alias. Global aliases replace all occurrences of the
   * alias with the substitution string.
   */
  alias(alias: string, substitution: string, isGlobal?: boolean): void;

  /**
   * Clears an existing alias.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * @param alias - The alias to clear.
   * @returns - True if there was a previous alias set.
   */
  unalias(alias: string): boolean;

  /**
   * Returns a list of every alias that's been set.
   * @remarks
   * RAM cost: 0 GB
   *
   * @returns A map of alias names to an object containing the substitution string and if the alias was set to global.
   */
  getAllAliases(): Map<string, { substitution: string; isGlobal: boolean }>;

  /**
   * Renders a ReactNode in the main content area.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * On the left side of the UI, the sidebar contains shortcuts to game features (Terminal, Script Editor, City, etc.).
   * When clicking a sidebar item, the feature is rendered on the right side of the UI. This space is the main content
   * area.
   *
   * For example, when you click the "City" button in the sidebar, the locations in that city are rendered in the main
   * content area.
   *
   * This function effectively switches to a new custom "page", as if you had navigated via the sidebar. Calling it
   * again replaces the contents of the page.
   *
   * @param node - The node to be rendered.
   */
  renderPage(node: ReactNode): void;

  /**
   * Allows programmatic use of AutoLink.exe.
   *
   * @remarks
   * RAM cost: 5 GB
   *
   * This function uses AutoLink.exe to create a clickable link. Clicking on the link is
   * equivalent to typing a sequence of "connect" commands into the terminal.
   *
   * @example
   * ```js
   * export async function main(ns) {
   *   // Prints a link to the terminal. Clicking on it is equivalent
   *   // to typing `connect joesguns; connect zer0; connect silver-helix`.
   *   ns.tprintRaw(ns.ui.createConnectLink(['joesguns', 'zer0', 'silver-helix']));
   * }
   * ```
   *
   * @param connectPath - Hostnames or IP addresses of servers to connect to.
   * @param linkText - The text to display on the link. Defaults to the last hostname or IP in connectPath. If
   * connectPath is an empty array and linkText is nullish, linkText is set to `"do nothing"`.
   * @returns A ReactElement that can be used with APIs such as {@link NS.tprintRaw | tprintRaw} and
   * {@link NS.printRaw | printRaw}.
   */
  createConnectLink(connectPath: string[], linkText?: string): ReactElement;
}

/**
 * Collection of all functions passed to scripts
 * @public
 * @example
 * ```js
 * export async function main(ns) {
 *  // Basic ns functions can be accessed on the ns object
 *  ns.getHostname();
 *  // Some related functions are gathered under a sub-property of the ns object
 *  ns.stock.getPrice();
 *  // Most functions that return a promise need to be awaited.
 *  await ns.hack('n00dles');
 * }
 * ```
 */
export interface NS {
  /**
   * Namespace for {@link Hacknet | hacknet} functions. Some of this API contains spoilers.
   */
  readonly hacknet: Hacknet;

  /**
   * Namespace for {@link Bladeburner | Bladeburner} functions. Contains spoilers.
   */
  readonly bladeburner: Bladeburner;

  /**
   * Namespace for {@link CodingContract | coding contract} functions.
   */
  readonly codingcontract: CodingContract;

  /**
   * Namespace for {@link Cloud | cloud} functions.
   */
  readonly cloud: Cloud;

  /**
   * Namespace for darknet functions. Contains spoilers.
   */
  readonly dnet: Darknet;

  /**
   * Namespace for {@link Format | formatting} functions.
   */
  readonly format: Format;

  /**
   * Namespace for {@link Gang | gang} functions. Contains spoilers.
   */
  readonly gang: Gang;

  /**
   * Namespace for {@link Go | Go} functions.
   */
  readonly go: Go;

  /**
   * Namespace for {@link Sleeve | sleeve} functions. Contains spoilers.
   */
  readonly sleeve: Sleeve;

  /**
   * Namespace for {@link Stock | stock} functions.
   */
  readonly stock: Stock;

  /**
   * Namespace for {@link Formulas | formulas} functions.
   */
  readonly formulas: Formulas;

  /**
   * Namespace for {@link Stanek | Stanek} functions. Contains spoilers.
   */
  readonly stanek: Stanek;

  /**
   * Namespace for {@link Infiltration | infiltration} functions.
   */
  readonly infiltration: Infiltration;

  /**
   * Namespace for {@link Corporation | corporation} functions. Contains spoilers.
   */
  readonly corporation: Corporation;

  /**
   * Namespace for {@link UserInterface | user interface} functions.
   */
  readonly ui: UserInterface;

  /**
   * Namespace for {@link Singularity | singularity} functions. Contains spoilers.
   */
  readonly singularity: Singularity;

  /**
   * Namespace for {@link Grafting | grafting} functions. Contains spoilers.
   */
  readonly grafting: Grafting;

  /**
   * Arguments passed into the script.
   *
   * These arguments can be accessed as a normal array by using the `[]` operator
   * (`args[0]`, `args[1]`, etc...).
   * Arguments can be string, number, or boolean.
   * Use `args.length` to get the number of arguments that were passed into a script.
   *
   * @example
   * `run example.js 7 text true`
   *
   * ```js
   * // example.js
   * export async function main(ns) {
   *   ns.tprint(ns.args.length) // 3
   *   ns.tprint(ns.args[0]); // 7 (number)
   *   ns.tprint(ns.args[1]); // "text" (string)
   *   ns.tprint(ns.args[2]); // true (boolean)
   *   ns.tprint(ns.args[3]); // undefined, because only 3 arguments were provided
   * }
   * ```
   */
  readonly args: ScriptArg[];

  /** The current script's PID */
  readonly pid: number;

  /**
   * Steal a server's money.
   * @remarks
   * RAM cost: 0.1 GB
   *
   * Function that is used to try and hack servers to steal money and gain hacking experience.
   * The runtime for this command depends on your hacking level and the target server’s
   * security level when this function is called. In order to hack a server you must first gain root access to that server
   * and also have the required hacking level.
   *
   * A script can hack a server from anywhere. It does not need to be running on the same
   * server to hack that server. For example, you can create a script that hacks the `foodnstuff`
   * server and run that script on any server in the game.
   *
   * A successful `hack()` on a server will raise that server’s security level by 0.002 per thread. You can use
   * {@link NS.hackAnalyzeSecurity | hackAnalyzeSecurity} to calculate the security increase for a number of threads.
   *
   * @example
   * ```js
   * let earnedMoney = await ns.hack("foodnstuff");
   * ```
   * @param host - Hostname/IP of the target server to hack. Optional. Defaults to current server if not provided.
   * @param opts - Optional parameters for configuring function behavior.
   * @returns A promise that resolves to the amount of money stolen (which is zero if the hack is unsuccessful).
   */
  hack(host?: string, opts?: BasicHGWOptions): Promise<number>;

  /**
   * Spoof money in a server's bank account, increasing the amount available.
   * @remarks
   * RAM cost: 0.15 GB
   *
   * Use your hacking skills to increase the amount of money available on a server.
   *
   * Once the grow is complete, $1 is added to the server's available money for every script thread. This additive
   * growth allows for rescuing a server even after it is emptied.
   *
   * After this addition, the thread count is also used to determine a multiplier, which the server's money is then
   * multiplied by.
   *
   * The multiplier scales exponentially with thread count, and its base depends on the server's security
   * level and in inherent "growth" statistic that varies between different servers.
   *
   * {@link NS.getServerGrowth | getServerGrowth} can be used to check the inherent growth statistic of a server.
   *
   * {@link NS.growthAnalyze | growthAnalyze} can be used to determine the number of threads needed for a specified
   * multiplicative portion of server growth.
   *
   * To determine the effect of a single grow, obtain access to the Formulas API and use
   * {@link HackingFormulas.growAmount | formulas.hacking.growPercent}, or invert {@link NS.growthAnalyze | growthAnalyze}.
   *
   * To determine how many threads are needed to return a server to max money, obtain access to the Formulas API and use
   * {@link HackingFormulas.growThreads | formulas.hacking.growThreads}, or {@link NS.growthAnalyze} *if* the server will
   * be at the same security in the future.
   *
   * Like {@link NS.hack | hack}, `grow` can be called on any hackable server, regardless of where the script is
   * running. Hackable servers are any servers not owned by the player.
   *
   * The grow() command requires root access to the target server, but there is no required hacking
   * level to run the command. It also raises the security level of the target server based on the number of threads.
   * The security increase can be determined using {@link NS.growthAnalyzeSecurity | growthAnalyzeSecurity}.
   *
   * @example
   * ```js
   * let currentMoney = ns.getServerMoneyAvailable("n00dles");
   * currentMoney *= await ns.grow("n00dles");
   * ```
   * @param host - Hostname/IP of the target server to grow. Optional. Defaults to current server if not provided.
   * @param opts - Optional parameters for configuring function behavior.
   * @returns The total effective multiplier that was applied to the server's money (after both additive and multiplicative growth).
   */
  grow(host?: string, opts?: BasicHGWOptions): Promise<number>;

  /**
   * Reduce a server's security level.
   * @remarks
   * RAM cost: 0.15 GB
   *
   * Use your hacking skills to attack a server’s security, lowering the server’s security level.
   * The runtime for this function depends on your hacking level and the target server’s security
   * level when this function is called.
   *
   * This function usually lowers the security level of the target server by 0.05 per thread, and only in unusual
   * situations does it do less. Use {@link NS.weakenAnalyze | weakenAnalyze} to determine the exact value.
   *
   * Like {@link NS.hack | hack} and {@link NS.grow| grow}, `weaken` can be called on any server, regardless of
   * where the script is running. This function requires root access to the target server, but
   * there is no required hacking level to run the function.
   *
   * @example
   * ```js
   * let currentSecurity = ns.getServerSecurityLevel("foodnstuff");
   * currentSecurity -= await ns.weaken("foodnstuff");
   * ```
   * @param host - Hostname/IP of the target server to weaken. Optional. Defaults to current server if not provided.
   * @param opts - Optional parameters for configuring function behavior.
   * @returns A promise that resolves to the value by which security was reduced.
   */
  weaken(host?: string, opts?: BasicHGWOptions): Promise<number>;

  /**
   * Predict the effect of weaken.
   * @remarks
   * RAM cost: 1 GB
   *
   * Returns the security decrease that would occur if a weaken with this many threads happened.
   *
   * @param threads - Amount of threads that will be used.
   * @param cores - Optional. The number of cores of the server that would run weaken.
   * @returns The security decrease.
   */
  weakenAnalyze(threads: number, cores?: number): number;

  /**
   * Calculate the decimal number of threads needed to hack a specified amount of money from a target host.
   * @remarks
   * RAM cost: 1 GB
   *
   * This function returns the decimal number of script threads you need when running the hack command
   * to steal the specified amount of money from the target server.
   * If hackAmount is less than zero, greater than the amount of money available on the server,
   * or your hacking level is below the required level for the target server,
   * then this function returns -1.
   *
   *
   * @example
   * ```js
   * // Calculate the thread count of a single hack that would take $100k from n00dles
   * const hackThreads = ns.hackAnalyzeThreads("n00dles", 1e5);
   *
   * // Launching a script requires an integer thread count. The below would take less than the targeted $100k.
   * ns.run("noodleHack.js", Math.floor(hackThreads));
   *
   * ```
   * @param host - Hostname/IP of the target server to analyze.
   * @param hackAmount - Amount of money you want to hack from the server.
   * @returns The number of threads needed to hack the server for hackAmount money.
   */
  hackAnalyzeThreads(host: string, hackAmount: number): number;

  /**
   * Get the part of money stolen with a single thread.
   * @remarks
   * RAM cost: 1 GB
   *
   * Returns the part of the specified server’s money you will steal with a single thread hack.
   *
   * Like other basic hacking analysis functions, this calculation uses the current status of the player and server.
   * To calculate using hypothetical server or player status, obtain access to the Formulas API and use {@link HackingFormulas.hackPercent | formulas.hacking.hackPercent}.
   *
   * @example
   * ```js
   * //For example, assume the following returns 0.01:
   * const hackAmount = ns.hackAnalyze("foodnstuff");
   * //This means that if hack the foodnstuff server using a single thread, then you will steal 1%, or 0.01 of its total money. If you hack using N threads, then you will steal N*0.01 times its total money.
   * ```
   * @param host - Hostname/IP of the target server.
   * @returns The part of money you will steal from the target server with a single thread hack.
   */
  hackAnalyze(host: string): number;

  /**
   * Get the security increase for a number of threads.
   * @remarks
   * RAM cost: 1 GB
   *
   * Returns the security increase that would occur if a hack with this many threads happened.
   * The number of threads is limited to the number needed to hack the server's maximum amount of money.
   *
   * @param threads - Amount of threads that will be used.
   * @param host - Hostname/IP of the target server. Optional. If unspecified, the threads are not capped.
   * @returns The security increase.
   */
  hackAnalyzeSecurity(threads: number, host?: string): number;

  /**
   * Get the chance of successfully hacking a server.
   * @remarks
   * RAM cost: 1 GB
   *
   * Returns the chance you have of successfully hacking the specified server.
   *
   * This returned value is in the range 0-1.
   *
   * Like other basic hacking analysis functions, this calculation uses the current status of the player and server.
   * To calculate using hypothetical server or player status, obtain access to the Formulas API and use {@link HackingFormulas.hackChance | formulas.hacking.hackChance}.
   *
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns The chance you have of successfully hacking the target server.
   */
  hackAnalyzeChance(host?: string): number;

  /**
   * Calculate the number of grow threads needed for a given multiplicative growth factor.
   * @remarks
   * RAM cost: 1 GB
   *
   * This function returns the total decimal number of {@link NS.grow | grow} threads needed in order to multiply the
   * money available on the specified server by a given multiplier, if all threads are executed at the server's current
   * security level, regardless of how many threads are assigned to each call.
   *
   * Note that there is also an additive factor that is applied before the multiplier. Each {@link NS.grow | grow} call
   * will add $1 to the host's money for each thread before applying the multiplier for its thread count. This means
   * that at extremely low starting money, fewer threads would be needed to apply the same effective multiplier than
   * what is calculated by growthAnalyze.
   *
   * Like other basic hacking analysis functions, this calculation uses the current status of the player and server.
   * To calculate using hypothetical server or player status, obtain access to the Formulas API and use {@link HackingFormulas.growThreads | formulas.hacking.growThreads}.
   *
   * @example
   * ```js
   * // calculate number of grow threads to apply 2x growth multiplier on n00dles (does not include the additive growth).
   * const growThreads = ns.growthAnalyze("n00dles", 2);
   *
   * // When using the thread count to launch a script, it needs to be converted to an integer.
   * ns.run("noodleGrow.js", Math.ceil(growThreads));
   * ```
   * @param host - Hostname/IP of the target server.
   * @param multiplier - Multiplier that will be applied to a server's money after applying additive growth. Decimal form.
   * @param cores - Number of cores on the host running the grow function. Optional, defaults to 1.
   * @returns Decimal number of grow threads needed for the specified multiplicative growth factor (does not include additive growth).
   */
  growthAnalyze(host: string, multiplier: number, cores?: number): number;

  /**
   * Calculate the security increase for a number of grow threads.
   * @remarks
   * RAM cost: 1 GB
   *
   * Returns the security increase that would occur if a grow with this many threads happened.
   *
   * @param threads - Amount of threads that will be used.
   * @param host - Optional. Hostname/IP of the target server. If provided, security increase is limited by the number of threads needed to reach maximum money.
   * @param cores - Optional. The number of cores of the server that would run grow.
   * @returns The security increase.
   */
  growthAnalyzeSecurity(threads: number, host?: string, cores?: number): number;

  readonly heart: {
    /**
     * Get your current karma.
     * @remarks
     * RAM cost: 0 GB
     */
    break(): number;
  };

  /**
   * Suspends the script for n milliseconds.
   * @remarks
   * RAM cost: 0 GB
   *
   * Note that the actual delay may be longer than intended. For more information, please check
   * {@link https://developer.mozilla.org/en-US/docs/Web/API/Window/setTimeout#delay}.
   *
   * @param millis - Number of milliseconds to sleep. Default to 0.
   * @example
   * ```js
   * // This will count from 1 to 10 in your terminal, with one number every 5 seconds
   * for (let i = 1; i <= 10; ++i) {
   *   ns.tprint(i);
   *   await ns.sleep(5000);
   * }
   * ```
   * @returns A promise that resolves to true when the sleep is completed.
   */
  sleep(millis?: number): Promise<true>;

  /**
   * Suspends the script for n milliseconds. Doesn't block with concurrent calls.
   * @remarks
   * RAM cost: 0 GB
   *
   * Note that the actual delay may be longer than intended. For more information, please check
   * {@link https://developer.mozilla.org/en-US/docs/Web/API/Window/setTimeout#delay}.
   *
   * @param millis - Number of milliseconds to sleep. Default to 0.
   * @returns A promise that resolves to true when the sleep is completed.
   */
  asleep(millis?: number): Promise<true>;

  /**
   * Prints one or more values or variables to the script’s logs.
   * @remarks
   * RAM cost: 0 GB
   *
   * If the argument is a string, you can color code your message by prefixing your
   * string with one of these strings:
   *
   * - `"ERROR"`: The whole string will be printed in red. Use this prefix to indicate
   *   that an error has occurred.
   *
   * - `"SUCCESS"`: The whole string will be printed in green, similar to the default
   *   theme of the Terminal. Use this prefix to indicate that something is correct.
   *
   * - `"WARN"`: The whole string will be printed in yellow. Use this prefix to
   *   indicate that you or a user of your script should be careful of something.
   *
   * - `"INFO"`: The whole string will be printed in purplish blue. Use this prefix to
   *   remind yourself or a user of your script of something. Think of this prefix as
   *   indicating an FYI (for your information).
   *
   * For custom coloring, use ANSI escape sequences. The examples below use the Unicode
   * escape code `\u001b`. The color coding also works if `\u001b` is replaced with
   * the hexadecimal escape code `\x1b`. The Bash escape code `\e` is not supported.
   * The octal escape code `\033` is not allowed because the game runs JavaScript in
   * strict mode.
   *
   * @example
   * ```js
   * // Default color coding.
   * ns.print("ERROR means something's wrong.");
   * ns.print("SUCCESS means everything's OK.");
   * ns.print("WARN Tread with caution!");
   * ns.print("WARNING, warning, danger, danger!");
   * ns.print("WARNing! Here be dragons.");
   * ns.print("INFO for your I's only (FYI).");
   * ns.print("INFOrmation overload!");
   * // Custom color coding.
   * const cyan = "\u001b[36m";
   * const green = "\u001b[32m";
   * const red = "\u001b[31m";
   * const reset = "\u001b[0m";
   * ns.print(`${red}Ugh! What a mess.${reset}`);
   * ns.print(`${green}Well done!${reset}`);
   * ns.print(`${cyan}ERROR Should this be in red?${reset}`);
   * ns.ui.openTail();
   * ```
   *
   * @param args - Value(s) to be printed.
   */
  print(...args: any[]): void;

  /** Prints a ReactNode to the script logs.
   * @remarks
   * RAM cost: 0 GB
   *
   * See {@link ReactNode} type for the acceptable values.
   *
   * @param node - The React node to be printed. */
  printRaw(node: ReactNode): void;

  /**
   * Prints a formatted string to the script’s logs.
   * @remarks
   * RAM cost: 0 GB
   *
   * - See {@link NS.print | print} for how to add color to your printed strings.
   *
   * - For more detail, see: https://github.com/alexei/sprintf.js
   *
   * @example
   * ```js
   * const name = "Bit";
   * const age = 4;
   * ns.printf("My name is %s.", name);
   * ns.printf("I'm %d seconds old.", age);
   * ns.printf("My age in binary is %b.", age);
   * ns.printf("My age in scientific notation is %e.", age);
   * ns.printf("In %d seconds, I'll be %s.", 6, "Byte");
   * ns.printf("Am I a nibble? %t", (4 === age));
   * ns.ui.openTail();
   * ```
   *
   * @param format - Format of the message.
   * @param args - Value(s) to be printed.
   */
  printf(format: string, ...args: any[]): void;

  /**
   * Prints one or more values or variables to the Terminal.
   * @remarks
   * RAM cost: 0 GB
   *
   * See {@link NS.print | print} for how to add color to your printed strings.
   *
   * @param args - Value(s) to be printed.
   */
  tprint(...args: any[]): void;

  /** Prints a ReactNode to the terminal.
   * @remarks
   * RAM cost: 0 GB
   *
   * See {@link ReactNode} type for the acceptable values.
   *
   * @param node - The React node to be printed. */
  tprintRaw(node: ReactNode): void;

  /**
   * Prints a raw value or a variable to the Terminal.
   * @remarks
   * RAM cost: 0 GB
   *
   * - See {@link NS.print | print} for how to add color to your printed strings.
   *
   * - See {@link NS.printf | printf} for examples on formatted strings.
   *
   * - For more detail, see: https://github.com/alexei/sprintf.js
   *
   * @param format - Format of the message.
   * @param values - Value(s) to be printed.
   */
  tprintf(format: string, ...values: any[]): void;

  /**
   * Clears the script’s logs.
   * @remarks
   * RAM cost: 0 GB
   */
  clearLog(): void;

  /**
   * Disables logging for the given NS function.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * Logging can be disabled for all functions by passing `ALL` as the argument.
   *
   * For specific interfaces, use the form "namespace.functionName". (e.g. "ui.setTheme")
   *
   * @example
   * ```js
   * ns.disableLog("hack"); // Disable logging for `ns.hack()`
   *
   * ```
   *
   * @param fn - Name of the NS function for which to disable logging.
   */
  disableLog(fn: string): void;

  /**
   * Enables logging for the given NS function.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * Logging can be enabled for all functions by passing `ALL` as the argument.
   *
   * For specific interfaces, use the form "namespace.functionName". (e.g. "ui.setTheme")
   *
   * @example
   * ```js
   * ns.enableLog("hack"); // Enable logging for `ns.hack()`
   *
   * ```
   *
   * @param fn - Name of the NS function for which to enable logging.
   */
  enableLog(fn: string): void;

  /**
   * Checks the status of the logging for the given NS function.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * @example
   * ```js
   * ns.print(ns.isLogEnabled("hack")); // Check if logging is enabled for `ns.hack()`
   *
   * ```
   *
   * @param fn - Name of function to check.
   * @returns Returns a boolean indicating whether or not logging is enabled for that NS function (or `ALL`).
   */
  isLogEnabled(fn: string): boolean;

  /**
   * Get all the logs of a script.
   * @remarks
   * RAM cost: 0 GB
   *
   * Returns a running script’s logs. The logs are returned as an array, where each line is an element in the array.
   * The most recently logged line is at the end of the array.
   * Note that there is a maximum number of lines that a script stores in its logs. This is configurable in the game’s options.
   * If the function is called with no arguments, it will return the current script’s logs.
   *
   * This function only works for currently running scripts. Use {@link NS.getRecentScripts | getRecentScripts} to access logs from recently finished scripts.
   *
   * Otherwise, the PID or filename, hostname/ip, and args… arguments can be used to get logs from another script.
   * Remember that scripts are uniquely identified by both their names and arguments.
   *
   * @example
   * ```js
   * //Get logs from foo.js on the current server that was run with no args
   * ns.getScriptLogs("foo.js");
   *
   * //Open logs from foo.js on the foodnstuff server that was run with no args
   * ns.getScriptLogs("foo.js", "foodnstuff");
   *
   * //Open logs from foo.js on the foodnstuff server that was run with the arguments [1, "test"]
   * ns.getScriptLogs("foo.js", "foodnstuff", 1, "test");
   * ```
   * @param fn - Optional. Filename or PID of script to get logs from.
   * @param host - Optional. Hostname/IP of the server that the script is on.
   * @param args - Arguments to identify which scripts to get logs for.
   * @returns Returns a string array, where each line is an element in the array. The most recently logged line is at the end of the array.
   */
  getScriptLogs(fn?: FilenameOrPID, host?: string, ...args: ScriptArg[]): string[];

  /**
   * Get an array of recently killed scripts across all servers.
   * @remarks
   * RAM cost: 0.2 GB
   *
   * The most recently killed script is the first element in the array.
   * Note that there is a maximum number of recently killed scripts which are tracked.
   * This is configurable in the game's options as `Recently killed scripts size`.
   *
   * @example
   * ```js
   * let recentScripts = ns.getRecentScripts();
   * let mostRecent = recentScripts.shift();
   * if (mostRecent)
   *   ns.tprint(mostRecent.logs.join('\n'));
   * ```
   *
   * @returns Array with information about previously killed scripts.
   */
  getRecentScripts(): RecentScript[];

  /**
   * Get the list of hostnames or IP addresses connected to a server. This function does not return darknet servers
   * (e.g., darkweb). Use {@link Darknet.probe | probe} if you want to list darknet servers.
   * @remarks
   * RAM cost: 0.2 GB
   *
   * Returns an array containing the hostnames or IP addresses of all servers that are one
   * node way from the specified target server. The hostnames/IPs in the returned
   * array are strings. Returns hostnames by default.
   *
   * The server network is a tree graph with the home server at the root. The parent node is always the first item of
   * the returned array.
   *
   * For example, let's say the network looks like this:
   *
   * ```
   * home
   * --n00dles
   * --joesguns
   * ----CSEC
   * ------omega-net
   * ```
   *
   * ns.scan("home"): ["n00dles", "joesguns"]: "home" is the root, so it does not have a parent node.
   *
   * ns.scan("n00dles"): ["home"]: "home" is the parent node of "n00dles".
   *
   * ns.scan("joesguns"): ["home", "CSEC"]: "home" is the parent node of "joesguns".
   *
   * ns.scan("CSEC"): ["joesguns", "omega-net"]: "joesguns" is the parent node of "CSEC".
   *
   * ns.scan("omega-net"): ["CSEC"]: "CSEC" is the parent node of "omega-net".
   *
   * If you run the "scan-analyze" command at home, it won't show all servers due to its limited maximum depth. You can
   * use this function with BFS (Breadth-first search) or DFS (Depth-first search) to traverse the network and discover
   * all servers.
   *
   * @example
   * ```js
   * // All servers that are one hop from the current server.
   * ns.tprint("Neighbors of current server.");
   * let neighbor = ns.scan();
   * for (let i = 0; i < neighbor.length; i++) {
   *     ns.tprint(neighbor[i]);
   * }
   * // All servers that are one hop from the current server, but by IP address.
   * ns.tprint("IPs of current server's neighbors.");
   * let neighbor = ns.scan(null, { returnByIP: true });
   * for (let i = 0; i < neighbor.length; i++) {
   *     ns.tprint(neighbor[i]);
   * }
   * // All neighbors of n00dles.
   * const target = "n00dles";
   * neighbor = ns.scan(target);
   * ns.tprintf("Neighbors of %s.", target);
   * for (let i = 0; i < neighbor.length; i++) {
   *     ns.tprint(neighbor[i]);
   * }
   * ```
   *
   * @param host - Optional. Hostname/IP of the server to scan, default to current server.
   * @param returnOpts - Optional. Controls whether the function returns IPs.
   * @returns Returns an array of hostnames.
   */
  scan(host?: string | null, returnOpts?: HostReturnOptions): string[];

  /** Returns whether the player has access to the darkweb.
   * @remarks
   * RAM cost: 0.05GB
   *
   * @example
   * ```js
   * if (ns.hasTorRouter()) ns.tprint("TOR router detected.");
   * ```
   *
   * @returns Whether player has access to the dark web. */
  hasTorRouter(): boolean;

  /**
   * Runs NUKE.exe on a server.
   * @remarks
   * RAM cost: 0.05 GB
   *
   * Running NUKE.exe on a target server gives you root access which means you can execute scripts on said server.
   * NUKE.exe must exist on your home computer.
   *
   * Each server has a different number of required open ports. If that number is greater than 0, you have to open its
   * ports before nuking it.
   * You can check the requirement with {@link NS.getServerNumPortsRequired | getServerNumPortsRequired} or
   * {@link Server.numOpenPortsRequired | getServer().numOpenPortsRequired}.
   *
   * Note that the server's required hacking level is not a requirement of nuking. You can nuke a server as long as you
   * open enough ports, regardless of your hacking level.
   *
   * @example
   * ```js
   * ns.nuke("foodnstuff");
   * ```
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns True if the player runs the program successfully, and false otherwise.
   */
  nuke(host?: string): boolean;

  /**
   * Runs BruteSSH.exe on a server.
   * @remarks
   * RAM cost: 0.05 GB
   *
   * Runs the BruteSSH.exe program on the target server. BruteSSH.exe must exist on your home computer.
   *
   * @example
   * ```js
   * ns.brutessh("foodnstuff");
   * ```
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns True if the player runs the program successfully, and false otherwise.
   */
  brutessh(host?: string): boolean;

  /**
   * Runs FTPCrack.exe on a server.
   * @remarks
   * RAM cost: 0.05 GB
   *
   * Runs the FTPCrack.exe program on the target server. FTPCrack.exe must exist on your home computer.
   *
   * @example
   * ```js
   * ns.ftpcrack("foodnstuff");
   * ```
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns True if the player runs the program successfully, and false otherwise.
   */
  ftpcrack(host?: string): boolean;

  /**
   * Runs relaySMTP.exe on a server.
   * @remarks
   * RAM cost: 0.05 GB
   *
   * Runs the relaySMTP.exe program on the target server. relaySMTP.exe must exist on your home computer.
   *
   * @example
   * ```js
   * ns.relaysmtp("foodnstuff");
   * ```
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns True if the player runs the program successfully, and false otherwise.
   */
  relaysmtp(host?: string): boolean;

  /**
   * Runs HTTPWorm.exe on a server.
   * @remarks
   * RAM cost: 0.05 GB
   *
   * Runs the HTTPWorm.exe program on the target server. HTTPWorm.exe must exist on your home computer.
   *
   * @example
   * ```js
   * ns.httpworm("foodnstuff");
   * ```
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns True if the player runs the program successfully, and false otherwise.
   */
  httpworm(host?: string): boolean;

  /**
   * Runs SQLInject.exe on a server.
   * @remarks
   * RAM cost: 0.05 GB
   *
   * Runs the SQLInject.exe program on the target server. SQLInject.exe must exist on your home computer.
   *
   * @example
   * ```js
   * ns.sqlinject("foodnstuff");
   * ```
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns True if the player runs the program successfully, and false otherwise.
   */
  sqlinject(host?: string): boolean;

  /**
   * Start another script on the current server.
   * @remarks
   * RAM cost: 1 GB
   *
   * Run a script as a separate process. This function can only be used to run scripts located on the
   * current server (the server running the script that calls this function). Requires a significant
   * amount of RAM to run this command.
   *
   * The second argument is either a thread count, or a {@link RunOptions} object that can also
   * specify the number of threads (among other things).
   *
   * If the script was successfully started, then this functions returns the PID of that script.
   * Otherwise, it returns 0.
   *
   * PID stands for Process ID. The PID is a unique identifier for each script across all hosts.
   * The PID will always be a positive integer.
   *
   * Running this function with 0 or fewer threads will cause a runtime error.
   *
   * @example
   * ```js
   * //The simplest way to use the run command is to call it with just the script name. The following example will run ‘foo.js’ single-threaded with no arguments:
   * ns.run("foo.js");
   *
   * //The following example will run ‘foo.js’ but with 5 threads instead of single-threaded:
   * ns.run("foo.js", {threads: 5});
   *
   * //This next example will run ‘foo.js’ single-threaded, and will pass the string ‘foodnstuff’ into the script as an argument:
   * ns.run("foo.js", 1, "foodnstuff");
   * ```
   * @param script - Filename of script to run.
   * @param threadOrOptions - Either an integer number of threads for new script, or a {@link RunOptions} object. Threads defaults to 1.
   * @param args - Additional arguments to pass into the new script that is being run. Note that if any arguments are being passed into the new script, then the second argument threadOrOptions must be filled in with a value.
   * @returns Returns the PID of a successfully started script, and 0 otherwise.
   */
  run(script: string, threadOrOptions?: number | RunOptions, ...args: ScriptArg[]): number;

  /**
   * Start another script on any server.
   * @remarks
   * RAM cost: 1.3 GB
   *
   * Run a script as a separate process on a specified server. This is similar to the function {@link NS.run | run},
   * except that it can be used to run a script that already exists on any server, instead of just the current server.
   *
   * If the script was successfully started, then this function returns the PID of that script.
   * Otherwise, it returns 0.
   *
   * PID stands for Process ID. The PID is a unique identifier for each script across all hosts.
   * The PID will always be a positive integer.
   *
   * Running this function with 0 or fewer threads will cause a runtime error.
   *
   * @example
   * ```js
   * // The simplest way to use the exec command is to call it with just the script name
   * // and the target server. The following example will try to run generic-hack.js
   * // on the foodnstuff server.
   * ns.exec("generic-hack.js", "foodnstuff");
   *
   * // The following example will try to run the script generic-hack.js on the
   * // joesguns server with 10 threads.
   * ns.exec("generic-hack.js", "joesguns", {threads: 10});
   *
   * // This last example will try to run the script foo.js on the foodnstuff server
   * // with 5 threads. It will also pass the number 1 and the string “test” in as
   * // arguments to the script.
   * ns.exec("foo.js", "foodnstuff", 5, 1, "test");
   * ```
   *
   * For darknet servers: A session must be established with the target server, and the script must be
   * running on a server that is directly connected to the target, or the target must have a backdoor or
   * stasis link installed.
   *
   * @param script - Filename of script to execute. This file must already exist on the target server.
   * @param host - Hostname/IP of the target server on which to execute the script.
   * @param threadOrOptions - Either an integer number of threads for new script, or a {@link RunOptions} object. Threads defaults to 1.
   * @param args - Additional arguments to pass into the new script that is being run. Note that if any arguments are being passed into the new script, then the third argument threadOrOptions must be filled in with a value.
   * @returns Returns the PID of a successfully started script, and 0 otherwise.
   */
  exec(script: string, host: string, threadOrOptions?: number | RunOptions, ...args: ScriptArg[]): number;

  /**
   * Terminate current script and start another in a defined number of milliseconds.
   * @remarks
   * RAM cost: 2 GB
   *
   * Terminates the current script, and then after a defined delay it will execute the
   * newly-specified script. The purpose of this function is to execute a new script without being
   * constrained by the RAM usage of the current one. This function can only be used to run scripts
   * on the local server.
   *
   * The delay specified can be 0; in this case the new script will synchronously replace
   * the old one. (There will not be any opportunity for other scripts to use up the RAM in-between.)
   *
   * Because this function immediately terminates the script, it does not have a return value.
   *
   * Running this function with 0 or fewer threads will cause a runtime error.
   *
   * @example
   * ```js
   * //The following example will execute the script ‘foo.js’ with 10 threads, in 500 milliseconds and the arguments ‘foodnstuff’ and 90:
   * ns.spawn("foo.js", {threads: 10, spawnDelay: 500}, "foodnstuff", 90);
   * ```
   * @param script - Filename of script to execute.
   * @param threadOrOptions - Either an integer number of threads for new script, or a {@link SpawnOptions} object. Threads defaults to 1 and spawnDelay defaults to 10,000 ms.
   * @param args - Additional arguments to pass into the new script that is being run.
   */
  spawn(script: string, threadOrOptions?: number | SpawnOptions, ...args: ScriptArg[]): never;

  /**
   * Returns the currently running script.
   * @remarks
   * RAM cost: 0 GB
   */
  self(): RunningScript;

  /**
   * Terminate the script with the provided PID.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * Kills the script with the provided PID. PIDs are unique across all hosts.
   * To instead kill a script using its filename, host, and args, see {@link NS.(kill:2) | the other ns.kill entry}.
   *
   * @example
   * ```js
   * // kills the script with PID 20:
   * ns.kill(20);
   * ```
   *
   * @param pid - The PID of the script to kill.
   * @returns True if the script is successfully killed, and false otherwise.
   */
  kill(pid: number): boolean;

  /**
   * Terminate the script(s) with the provided filename, host, and script arguments.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * Kills the script(s) with the provided filename, running on the specified host with the specified args.
   * To instead kill a script using its PID, see {@link NS.(kill:1) | the other ns.kill entry}.
   *
   * @example
   * ```js
   * // kill the script "foo.js" on the same server the current script is running from, with no arguments
   * ns.kill("foo.js");
   *
   * // kill the script "foo.js" on the "n00dles" server with no arguments.
   * ns.kill("foo.js", "n00dles");
   *
   * // kill the script foo.js on the current server that was run with the arguments [1, “foodnstuff”, false]:
   * ns.kill("foo.js", ns.getHostname(), 1, "foodnstuff", false);
   * ```
   * @param filename - Filename of the script to kill.
   * @param host - Hostname/IP where the script to kill is running. Defaults to the current server.
   * @param args - Arguments of the script to kill.
   * @returns True if the scripts were successfully killed, and false otherwise.
   */
  kill(filename: string, host?: string, ...args: ScriptArg[]): boolean;

  /**
   * Terminate all scripts on a server.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * Kills all running scripts on the specified server. This function returns true
   * if any scripts were killed, and false otherwise. In other words, it will return
   * true if there are any scripts running on the target server.
   * If no host is defined, it will kill all scripts, where the script is running.
   *
   * @param host - Hostname/IP of the server on which to kill all scripts. Optional. Defaults to current server if not provided.
   * @param safetyGuard - Skips the script that calls this function
   * @returns True if any scripts were killed, and false otherwise.
   */
  killall(host?: string, safetyGuard?: boolean): boolean;

  /**
   * Terminates the current script immediately.
   * @remarks
   * RAM cost: 0 GB
   */
  exit(): never;

  /**
   * Copy file between servers.
   * @remarks
   * RAM cost: 0.6 GB
   *
   * Copies text, script or literature (.lit) file(s) to another server. The files argument can be either a string
   * specifying a single file to copy, or an array of strings specifying multiple files to copy.
   *
   * @example
   * ```js
   * //Copies foo.lit from the helios server to the home computer:
   * ns.scp("foo.lit", "home", "helios" );
   *
   * //Tries to copy three files from rothman-uni to home computer:
   * const files = ["foo1.lit", "foo2.txt", "foo3.js"];
   * ns.scp(files, "home", "rothman-uni");
   * ```
   * @example
   * ```js
   * const server = ns.args[0];
   * const files = ["hack.js", "weaken.js", "grow.js"];
   * ns.scp(files, server, "home");
   * ```
   *
   * For darknet servers: The destination requires a session, but unlike {@link NS.exec | exec}, does not
   * require a direct connection — scp works at any distance. The source server has no darknet requirements
   * (no session or connection needed). Use {@link Darknet.authenticate | dnet.authenticate} (requires direct
   * connection) or {@link Darknet.connectToSession | dnet.connectToSession} (at any distance) to
   * establish a session.
   *
   * @param files - Filename or an array of filenames of text/script/literature files to copy. Note that if a file is located in a subdirectory, the filename must include the leading `/`.
   * @param destination - Hostname/IP of the destination server, which is the server to which the file will be copied.
   * @param source - Hostname/IP of the source server, which is the server from which the file will be copied. This argument is optional and if it’s omitted the source will be the current server.
   * @returns True if the file is successfully copied over and false otherwise. If the files argument is an array then this function will return false if any of the operations failed.
   */
  scp(files: string | string[], destination: string, source?: string): boolean;

  /**
   * List files on a server.
   * @remarks
   * RAM cost: 0.2 GB
   *
   * Returns an array with the filenames of all files on the specified server
   * (as strings). The returned array is sorted in alphabetic order.
   *
   * @param host - Hostname/IP of the target server. Defaults to current server if not provided.
   * @param substring - A substring to search for in the filename.
   * @returns Array with the filenames of all files on the specified server.
   */
  ls(host?: string, substring?: string): string[];

  /**
   * List running scripts on a server.
   * @remarks
   * RAM cost: 0.2 GB
   *
   * Returns an array with general information about all scripts running on the specified target server.
   *
   * @example
   * ```js
   * const ps = ns.ps("home");
   * for (const script of ps) {
   *   ns.tprint(`${script.filename} ${script.threads}`);
   *   ns.tprint(script.args);
   * }
   * ```
   * @param host - Hostname/IP of the target server. If not specified, it will be the current server’s IP by default.
   * @returns Array with general information about all scripts running on the specified target server.
   */
  ps(host?: string): ProcessInfo[];

  /**
   * Check if you have root access on a server.
   * @remarks
   * RAM cost: 0.05 GB
   *
   * Returns a boolean indicating whether or not the player has root access to the specified target server.
   *
   * @example
   * ```js
   * if (!ns.hasRootAccess("foodnstuff")) {
   *   ns.nuke("foodnstuff");
   * }
   * ```
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns True if player has root access to the specified target server, and false otherwise.
   */
  hasRootAccess(host?: string): boolean;

  /**
   * Returns a string with the hostname of the server that the script is running on.
   *
   * @remarks
   * RAM cost: 0.05 GB
   * @returns Hostname of the server that the script runs on.
   */
  getHostname(): string;

  /**
   * Returns a string with the IP address of the server that the script is running on.
   *
   * @remarks
   * RAM cost: 0.05 GB
   * @returns IP address of the server that the script runs on.
   */
  getIP(): string;

  /**
   * Returns the player’s current hacking level.
   *
   * @remarks
   * RAM cost: 0.05 GB
   * @returns Player’s current hacking level
   */
  getHackingLevel(): number;

  /**
   * Get hacking related multipliers.
   * @remarks
   * RAM cost: 0.25 GB
   *
   * Returns an object containing the Player’s hacking related multipliers.
   * These multipliers are returned in fractional forms, not percentages
   * (e.g. 1.5 instead of 150%).
   *
   * @example
   * ```js
   * const mults = ns.getHackingMultipliers();
   * ns.tprint(`chance: ${mults.chance}`);
   * ns.tprint(`growth: ${mults.growth}`);
   * ```
   * @returns Object containing the Player’s hacking related multipliers.
   */
  getHackingMultipliers(): HackingMultipliers;

  /**
   * Get hacknet related multipliers.
   * @remarks
   * RAM cost: 0.25 GB
   *
   * Returns an object containing the Player’s hacknet related multipliers.
   * These multipliers are returned in fractional forms, not percentages
   * (e.g. 1.5 instead of 150%).
   *
   * @example
   * ```js
   * const mults = ns.getHacknetMultipliers();
   * ns.tprint(`production: ${mults.production}`);
   * ns.tprint(`purchaseCost: ${mults.purchaseCost}`);
   * ```
   * @returns Object containing the Player’s hacknet related multipliers.
   */
  getHacknetMultipliers(): HacknetMultipliers;

  /**
   * Returns data of a server.
   *
   * If the server is a darknet server, it will also contain the "isOnline" field. If the darknet server has recently
   * gone offline, the returned object will be a dummy server object with `isOnline: false`.
   *
   * @remarks
   * RAM cost: 2 GB
   *
   * @param host - Optional. Hostname/IP of the server. Defaults to the hostname of the running script's server.
   * @returns Data of the server.
   */
  getServer(host?: string): Server & { isOnline?: boolean };

  /**
   * Get money available on a server.
   * @remarks
   * RAM cost: 0.1 GB
   *
   * Returns the amount of money available on a server.
   * Running this function on the home computer will return the player’s money.
   *
   * @example
   * ```js
   * ns.getServerMoneyAvailable("foodnstuff");
   * ns.getServerMoneyAvailable("home"); // Returns player's money
   * ```
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns Amount of money available on the server.
   */
  getServerMoneyAvailable(host?: string): number;

  /**
   * Get the maximum money available on a server.
   * @remarks
   * RAM cost: 0.1 GB
   *
   * Returns the maximum amount of money that can be available on a server.
   *
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns Maximum amount of money available on the server.
   */
  getServerMaxMoney(host?: string): number;

  /**
   * Get a server growth parameter.
   * @remarks
   * RAM cost: 0.1 GB
   *
   * Returns the server’s intrinsic “growth parameter”. This growth
   * parameter is a number typically between 0 and 100 that represents
   * how quickly the server’s money grows. This parameter affects the
   * percentage by which the server’s money is increased when using the
   * grow function. A higher growth parameter will result in a
   * higher percentage increase from grow.
   *
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns Parameter that affects the percentage by which the server’s money is increased when using the grow function.
   */
  getServerGrowth(host?: string): number;

  /**
   * Get server security level.
   * @remarks
   * RAM cost: 0.1 GB
   *
   * Returns the security level of the target server. A server’s security
   * level is denoted by a number, typically between 1 and 100
   * (but it can go above 100).
   *
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns Security level of the target server.
   */
  getServerSecurityLevel(host?: string): number;

  /**
   * Returns the minimum security level of the target server.
   *
   * @remarks RAM cost: 0.1 GB
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns Minimum security level of the target server.
   */
  getServerMinSecurityLevel(host?: string): number;

  /**
   * Get the base security level of a server.
   * @remarks
   * RAM cost: 0.1 GB
   *
   * Returns the base security level of the target server.
   * For the server's actual security level, use {@link NS.getServerSecurityLevel | ns.getServerSecurityLevel}.
   *
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns Base security level of the target server.
   */
  getServerBaseSecurityLevel(host?: string): number;

  /**
   * Get the maximum amount of RAM on a server.
   * @remarks
   * RAM cost: 0.05 GB
   *
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns The maximum amount of RAM (GB) a server can have.
   */
  getServerMaxRam(host?: string): number;
  /**
   * Get the used RAM on a server. This includes ram used by running scripts as well as blocked ram on darknet servers.
   * @remarks
   * RAM cost: 0.05 GB
   *
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns The amount of used RAM (GB) on the specified server.
   */
  getServerUsedRam(host?: string): number;

  /**
   * Returns the required hacking level of the target server.
   *
   * @remarks RAM cost: 0.1 GB
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns The required hacking level of the target server.
   */
  getServerRequiredHackingLevel(host?: string): number;

  /**
   * Returns the number of open ports required to successfully run NUKE.exe on the specified server.
   *
   * @remarks RAM cost: 0.1 GB
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns The number of open ports required to successfully run NUKE.exe on the specified server.
   */
  getServerNumPortsRequired(host?: string): number;

  /**
   * Given a hostname, returns its IP address; or given an IP address, returns its hostname.
   *
   * @remarks RAM cost: 0.05 GB
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   */
  dnsLookup(host?: string): string;

  /**
   * Returns a boolean denoting whether or not the specified server exists.
   *
   * @remarks RAM cost: 0.1 GB
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns True if the specified server exists, and false otherwise.
   */
  serverExists(host?: string): boolean;

  /**
   * Check if a file exists.
   * @remarks
   * RAM cost: 0.1 GB
   *
   * Returns a boolean indicating whether the specified file exists on the target server.
   * The filename for programs is case-insensitive, other file types are case-sensitive.
   * For example, fileExists(“brutessh.exe”) will work fine, even though the actual program
   * is named 'BruteSSH.exe'.
   *
   * @example
   * ```js
   * // The function call will return true if the script named foo.js exists on the foodnstuff server, and false otherwise.
   * ns.fileExists("foo.js", "foodnstuff");
   *
   * // The function call will return true if the current server contains the FTPCrack.exe program, and false otherwise.
   * ns.fileExists("ftpcrack.exe");
   * ```
   * @param filename - Filename of file to check.
   * @param host - Hostname/IP of target server. Optional, defaults to the server the script is running on.
   * @returns True if specified file exists, and false otherwise.
   */
  fileExists(filename: string, host?: string): boolean;

  /**
   * Check if a script is running.
   * @remarks
   * RAM cost: 0.1 GB
   *
   * Returns a boolean indicating whether the specified script is running on the target server.
   * If you use a PID instead of a filename, the host and args parameters are unnecessary.
   * If host is omitted while filename is used as the first parameter, host defaults to the server the calling script is running on.
   * Remember that a script is semi-uniquely identified by both its name and its arguments.
   * (You can run multiple copies of scripts with the same arguments, but for the purposes of
   * functions like this that check based on filename, the filename plus arguments forms the key.)
   *
   * @example
   * ```js
   * //The function call will return true if there is a script named foo.js with no arguments running on the foodnstuff server, and false otherwise:
   * ns.isRunning("foo.js", "foodnstuff");
   *
   * //The function call will return true if there is a script named foo.js with no arguments running on the current server, and false otherwise:
   * ns.isRunning("foo.js", ns.getHostname());
   *
   * //The function call will return true if there is a script named foo.js running with the arguments 1, 5, and “test” (in that order) on the joesguns server, and false otherwise:
   * ns.isRunning("foo.js", "joesguns", 1, 5, "test");
   * ```
   * @param script - Filename (case-sensitive) or PID of script to check. Optional, default to the current script's pid.
   * @param host - Hostname/IP of target server. Optional, defaults to the server the calling script is running on.
   * @param args - Arguments to specify/identify the script. Optional, when looking for scripts run without arguments.
   * @returns True if the specified script is running on the target server, and false otherwise.
   */
  isRunning(script?: FilenameOrPID, host?: string, ...args: ScriptArg[]): boolean;

  /**
   * Get general info about a running script.
   * @remarks
   * RAM cost: 0.3 GB
   *
   * Running with no args returns current script.
   * If you use a PID as the first parameter, the host and args parameters are unnecessary.
   * If host is omitted while filename is used as the first parameter, host defaults to the server the calling script is running on.
   * Remember that a script is semi-uniquely identified by both its name and its arguments.
   * (You can run multiple copies of scripts with the same arguments, but for the purposes of
   * functions like this that check based on filename, the filename plus arguments forms the key.)
   *
   * @param filename - Optional. Filename or PID of the script.
   * @param host - Hostname/IP of target server. Optional, defaults to the server the calling script is running on.
   * @param args  - Arguments to specify/identify the script. Optional, when looking for scripts run without arguments.
   * @returns The info about the running script if found, and null otherwise.
   */
  getRunningScript(filename?: FilenameOrPID, host?: string, ...args: ScriptArg[]): RunningScript | null;

  /**
   * Change the current static RAM allocation of the script.
   * @remarks
   * RAM cost: 0 GB
   *
   * This acts analogously to the ramOverride parameter in runOptions, but for changing RAM in
   * the current running script. The static RAM allocation (the amount of RAM used by ONE thread)
   * will be adjusted to the given value, if possible. This can fail if the number is less than the
   * current dynamic RAM limit, or if adjusting upward would require more RAM than is available on
   * the server.
   *
   * RAM usage will be rounded to the nearest hundredth of a GB, which is the granularity of all RAM calculations.
   *
   * @param ram - The new RAM limit to set.
   * @returns The new static RAM limit, which will be the old one if it wasn't changed.
   * This means you can use no parameters to check the current ram limit.
   */
  ramOverride(ram?: number): number;

  /**
   * Write data to a file.
   * @remarks
   * RAM cost: 0 GB
   *
   * This function can be used to write data to a text file (.txt, .json, .css) or a script (.js, .jsx, .ts, .tsx).
   *
   * This function will write data to that file. If the specified file does not exist,
   * then it will be created. The third argument mode defines how the data will be written to
   * the file. If mode is set to “w”, then the data is written in “write” mode which means
   * that it will overwrite all existing data on the file. If mode is set to any other value
   * then the data will be written in “append” mode which means that the data will be added at the
   * end of the file.
   *
   * @param filename - Name of the file to be written to.
   * @param data - Data to write.
   * @param mode - Defines the write mode.
   */
  write(filename: string, data?: string, mode?: "w" | "a"): void;

  /**
   * Attempt to write to a port.
   * @remarks
   * RAM cost: 0 GB
   *
   * Attempts to write data to the specified Netscript port.
   * If the port is full, the data will not be written.
   * Otherwise, the data will be written normally.
   * Ports are shared across all hosts and contents are reset on game restart.
   *
   * @param portNumber - Port to attempt to write to. Must be a positive integer.
   * @param data - Data to write, it's cloned with structuredClone().
   * @returns True if the data is successfully written to the port, and false otherwise.
   */
  tryWritePort(portNumber: number, data: any): boolean;

  /**
   * Listen for a port write.
   * @remarks
   * RAM cost: 0 GB
   *
   * Sleeps until the port is written to.
   * Ports are shared across all hosts and contents are reset on game restart.
   *
   * @param port - Port to listen for a write on. Must be a positive integer.
   */
  nextPortWrite(port: number): Promise<void>;

  /**
   * Read content of a file.
   * @remarks
   * RAM cost: 0 GB
   *
   * This function is used to read data from a text file (.txt, .json, .css), a script (.js, .jsx, .ts, .tsx), a
   * literature file (.lit), or a message (.msg).
   *
   * This function will return the data in the specified file. If the file does not exist, an empty string will be
   * returned.
   *
   * With literature files, the returned data is a raw HTML string.
   *
   * @param filename - Name of the file to be read.
   * @returns Data in the specified text file.
   */
  read(filename: string): string;

  /**
   * Get the metadata of a file.
   * @remarks
   * RAM cost: 0 GB
   *
   * This function returns the metadata associated with the specified file.
   * If the file does not exist or the server is offline, returns null. It will throw if the path or host is malformed.
   *
   * @param filename - Name of the file to read the metadata from. It must be a text file (.txt, .json, .css) or a script
   * (.js, .jsx, .ts, .tsx).
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @Returns The metadata of the file.
   */
  getFileMetadata(filename: string, host?: string): FileMetadata | null;

  /**
   * Get a copy of the data from a port without popping it.
   * @remarks
   * RAM cost: 0 GB
   *
   * This function is used to peek at the data from a port. It returns the
   * first element in the specified port without removing that element. If
   * the port is empty, the string “NULL PORT DATA” will be returned.
   * Ports are shared across all hosts and contents are reset on game restart.
   *
   * @param portNumber - Port to peek. Must be a positive integer.
   * @returns Data in the specified port.
   */
  peek(portNumber: number): any;

  /**
   * Clear data from a file.
   * @remarks
   * RAM cost: 0 GB
   *
   * Delete all data from that text file.
   *
   * @param handle - Text file to clear.
   */
  clear(handle: string): void;

  /**
   * Clear data from a port.
   * @remarks
   * RAM cost: 0 GB
   *
   * Delete all data from the underlying queue.
   *
   * @param portNumber - Port to clear data from. Must be a positive integer.
   */
  clearPort(portNumber: number): void;

  /**
   * Write data to a port.
   * @remarks
   * RAM cost: 0 GB
   *
   * Write data to the given Netscript port.
   *
   * There is a limit on the maximum number of ports, but you won't reach that limit in normal situations. If you do, it
   * usually means that there is a bug in your script that leaks port data. A port is freed when it does not have any
   * data in its underlying queue. `ns.clearPort` deletes all data on a port. `ns.readPort` reads the first element in
   * the port's queue, then removes it from the queue.
   * Ports are shared across all hosts and contents are reset on game restart.
   *
   * @param portNumber - Port to write to. Must be a positive integer.
   * @param data - Data to write, it's cloned with structuredClone().
   * @returns The data popped off the queue if it was full, or null if it was not full.
   */
  writePort(portNumber: number, data: any): any;

  /**
   * Read data from a port.
   * @remarks
   * RAM cost: 0 GB
   *
   * Read data from that port. A port is a serialized queue.
   * This function will remove the first element from that queue and return it.
   * If the queue is empty, then the string “NULL PORT DATA” will be returned.
   * Ports are shared across all hosts and contents are reset on game restart.
   *
   * @param portNumber - Port to read from. Must be a positive integer.
   * @returns The data read.
   */
  readPort(portNumber: number): any;

  /**
   * Get all data on a port.
   * @remarks
   * RAM cost: 0 GB
   *
   * Get a handle to a Netscript Port.
   *
   * All methods of the port handle can be used while the ns instance is "busy" (they avoid the concurrency check), or
   * even when it is dead.
   *
   * Ports are shared across all hosts and contents are reset on game restart.
   *
   * @param portNumber - Port number. Must be a positive integer.
   */
  getPortHandle(portNumber: number): NetscriptPort;

  /**
   * Check if a port is full.
   * @remarks
   * RAM cost: 0 GB
   *
   * Returns true if the port's data queue is full, and false otherwise.
   * Ports are shared across all hosts and contents are reset on game restart.
   *
   * @param portNumber - Port number. Must be a positive integer.
   */
  isFullPort(portNumber: number): boolean;

  /**
   * Check if a port is empty.
   * @remarks
   * RAM cost: 0 GB
   *
   * Returns true if the port's data queue is empty, and false otherwise.
   * Ports are shared across all hosts and contents are reset on game restart.
   *
   * @param portNumber - Port number. Must be a positive integer.
   */
  isEmptyPort(portNumber: number): boolean;

  /**
   * Delete a file.
   * @remarks
   * RAM cost: 0.6 GB
   *
   * Removes the specified file from the current server. This function works for every file
   * type except message (.msg) files.
   *
   * @param name - Filename of file to remove. Must include the extension.
   * @param host - Hostname/IP of the server on which to delete the file. Optional. Defaults to current server.
   * @returns True if it successfully deletes the file, and false otherwise.
   */
  rm(name: string, host?: string): boolean;

  /**
   * Check if any script with a filename is running.
   * @remarks
   * RAM cost: 1 GB
   *
   * Returns a boolean indicating whether any instance of the specified script is running
   * on the target server, regardless of its arguments.
   *
   * This is different than the {@link NS.isRunning | isRunning} function because it does not try to
   * identify a specific instance of a running script by its arguments.
   *
   * @example
   * ```js
   * //The function call will return true if there is any script named foo.js running on the foodnstuff server, and false otherwise:
   * ns.scriptRunning("foo.js", "foodnstuff");
   *
   * //The function call will return true if there is any script named “foo.js” running on the current server, and false otherwise:
   * ns.scriptRunning("foo.js", ns.getHostname());
   * ```
   * @param script - Filename of script to check. This is case-sensitive.
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns True if the specified script is running, and false otherwise.
   */
  scriptRunning(script: string, host?: string): boolean;

  /**
   * Kill all scripts with a filename.
   * @remarks
   * RAM cost: 1 GB
   *
   * Kills all scripts with the specified filename on the target server specified by hostname,
   * regardless of arguments.
   *
   * @param script - Filename of script to kill. This is case-sensitive.
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns True if one or more scripts were successfully killed, and false if none were.
   */
  scriptKill(script: string, host?: string): boolean;

  /**
   * Returns the current script name.
   *
   * @remarks RAM cost: 0 GB
   * @returns Current script name.
   */
  getScriptName(): string;

  /**
   * Get the ram cost of a script.
   * @remarks
   * RAM cost: 0.1 GB
   *
   * Returns the amount of RAM required to run the specified script on the target server.
   * Returns 0 if the script does not exist.
   *
   * @param script - Filename of script. This is case-sensitive.
   * @param host - Hostname/IP of the server the target script is located on. Optional. Defaults to the server the calling script is running on.
   * @returns Amount of RAM (in GB) required to run the specified script, and 0 if the script does not exist.
   */
  getScriptRam(script: string, host?: string): number;

  /**
   * Get the execution time of a hack() call.
   * @remarks
   * RAM cost: 0.05 GB
   *
   * When `hack` completes an amount of money is stolen depending on the player's skills.
   * Returns the amount of time in milliseconds it takes to execute the {@link NS.hack | hack} Netscript function on the target server.
   * The required time is increased by the security level of the target server and decreased by the player's hacking level.
   *
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns Returns the amount of time in milliseconds it takes to execute the {@link NS.hack | hack} Netscript function.
   */
  getHackTime(host?: string): number;

  /**
   * Get the execution time of a grow() call.
   * @remarks
   * RAM cost: 0.05 GB
   *
   * Returns the amount of time in milliseconds it takes to execute the grow Netscript function on the target server.
   * The required time is increased by the security level of the target server and decreased by the player's hacking level.
   *
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns Returns the amount of time in milliseconds it takes to execute the grow Netscript function.
   */
  getGrowTime(host?: string): number;

  /**
   * Get the execution time of a weaken() call.
   * @remarks
   * RAM cost: 0.05 GB
   *
   * Returns the amount of time in milliseconds it takes to execute the {@link NS.weaken | weaken} Netscript function on the target server.
   * The required time is increased by the security level of the target server and decreased by the player's hacking level.
   *
   * @param host - Hostname/IP of the target server. Optional. Defaults to current server if not provided.
   * @returns Returns the amount of time in milliseconds it takes to execute the {@link NS.weaken | weaken} Netscript function.
   */
  getWeakenTime(host?: string): number;

  /**
   * Get the income of all scripts.
   * @remarks
   * RAM cost: 0.1 GB
   *
   * @returns An array of two values.
   * The first value is the total income (dollar / second) of all of your active scripts
   * (scripts that are currently running on any server).
   * The second value is the total income (dollar / second) that you’ve earned from scripts
   * since you last installed Augmentations.
   */
  getTotalScriptIncome(): [number, number];

  /**
   * Get the income of a script.
   * @remarks
   * RAM cost: 0.1 GB
   *
   * Returns the amount of income the specified script generates while online
   * (when the game is open, does not apply for offline income). Remember that
   * a script is uniquely identified by both its name and its arguments. So for
   * example if you ran a script with the arguments “foodnstuff” and “5” then
   * in order to use this function to get that script’s income you must specify
   * those same arguments in the same order in this function call.
   *
   * @param script - Filename of script.
   * @param host - Hostname/IP of the server on which the script is running. Optional. Defaults to current server if not provided.
   * @param args - Arguments that the script is running with.
   * @returns Amount of income the specified script generates while online.
   */
  getScriptIncome(script: string, host?: string, ...args: ScriptArg[]): number;

  /**
   * Get the exp gain of all scripts.
   * @remarks
   * RAM cost: 0.1 GB
   *
   * @returns Total experience gain rate of all of your active scripts.
   */
  getTotalScriptExpGain(): number;

  /**
   * Get the exp gain of a script.
   * @remarks
   * RAM cost: 0.1 GB
   *
   * Returns the amount of hacking experience the specified script generates while online
   * (when the game is open, does not apply for offline experience gains). Remember that a
   * script is uniquely identified by both its name and its arguments.
   *
   * This function can also return the total experience gain rate of all of your active
   * scripts by running the function with no arguments.
   *
   * @param script - Filename of script.
   * @param host - Hostname/IP of the server on which the script is running. Optional. Defaults to current server if not provided.
   * @param args - Arguments that the script is running with.
   * @returns Amount of hacking experience the specified script generates while online.
   */
  getScriptExpGain(script: string, host?: string, ...args: ScriptArg[]): number;

  /**
   * Format a string.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * see: https://github.com/alexei/sprintf.js
   * @param format - String to format.
   * @param args - Formatting arguments.
   * @returns Formatted text.
   */
  sprintf(format: string, ...args: any[]): string;

  /**
   * Format a string with an array of arguments.
   * @remarks
   * RAM cost: 0 GB
   *
   * see: https://github.com/alexei/sprintf.js
   * @param format - String to format.
   * @param args - Formatting arguments.
   * @returns Formatted text.
   */
  vsprintf(format: string, args: any[]): string;

  /**
   * Prompt the player with an input modal.
   * @remarks
   * RAM cost: 0 GB
   *
   * Prompts the player with a dialog box and returns a promise. If the player cancels this dialog box (press X button
   * or click outside the dialog box), the promise is resolved with a default value (empty string or "false"). If this
   * API is called again while the old dialog box still exists, the old dialog box will be replaced with a new one, and
   * the old promise will be resolved with the default value.
   *
   * Here is an explanation of the various options.
   *
   * - `options.type` is not provided to the function. If `options.type` is left out and
   *   only a string is passed to the function, then the default behavior is to create a
   *   boolean dialog box.
   *
   * - `options.type` has value `undefined` or `"boolean"`. A boolean dialog box is
   *   created. The player is shown "Yes" and "No" prompts, which return true and false
   *   respectively. The script's execution is halted until the player presses either the
   *   "Yes" or "No" button.
   *
   * - `options.type` has value `"text"`. The player is given a text field to enter
   *   free-form text. The script's execution is halted until the player enters some text
   *   and/or presses the "Confirm" button.
   *
   * - `options.type` has value `"select"`. The player is shown a drop-down field.
   *   Choosing type `"select"` will require an array to be passed via the
   *   `options.choices` property. The array can be an array of strings, an array of
   *   numbers (not BigInt numbers), or a mixture of both numbers and strings. Any other
   *   types of array elements will result in an error or an undefined/unexpected
   *   behavior. The `options.choices` property will be ignored if `options.type` has a
   *   value other than `"select"`. The script's execution is halted until the player
   *   chooses one of the provided options and presses the "Confirm" button.
   *
   * @example
   * ```js
   * // A Yes/No question. The default is to create a boolean dialog box.
   * const queryA = "Do you enjoy Bitburner?";
   * const resultA = await ns.prompt(queryA);
   * ns.tprint(`${queryA} ${resultA}`);
   *
   * // Another Yes/No question. Can also create a boolean dialog box by explicitly
   * // passing the option {"type": "boolean"}.
   * const queryB = "Is programming fun?";
   * const resultB = await ns.prompt(queryB, { type: "boolean" });
   * ns.tprint(`${queryB} ${resultB}`);
   *
   * // Free-form text box.
   * const resultC = await ns.prompt("Please enter your name.", { type: "text" });
   * ns.tprint(`Hello, ${resultC}.`);
   *
   * // A drop-down list.
   * const resultD = await ns.prompt("Please select your favorite fruit.", {
   *   type: "select",
   *   choices: ["Apple", "Banana", "Orange", "Pear", "Strawberry"]
   * });
   * ns.tprint(`Your favorite fruit is ${resultD.toLowerCase()}.`);
   * ```
   *
   * @param txt - Text to appear in the prompt dialog box.
   * @param options - Options to modify the prompt the player is shown.
   * @returns True if the player clicks “Yes”; false if the player clicks “No”; or the value entered by the player.
   */
  prompt(
    txt: string,
    options?: { type?: "boolean" | "text" | "select"; choices?: string[] },
  ): Promise<boolean | string>;

  /**
   * Open up a message box.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * @param args - Value(s) to be alerted.
   */
  alert(...args: any[]): void;

  /**
   * Queue a toast (bottom-right notification).
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * @param msg - Message in the toast.
   * @param variant - Type of toast. Must be one of success, info, warning, error. Defaults to success.
   * @param duration - Duration of toast in ms. Can also be `null` to create a persistent toast. Defaults to 2000.
   */
  toast(msg: string, variant?: ToastVariant, duration?: number | null): void;

  /**
   * Download a file from the internet.
   * @remarks
   * RAM cost: 0 GB
   *
   * Retrieves data from a URL and downloads it to a file on the specified server.
   * The data can only be downloaded to a script (.js, .jsx, .ts, .tsx) or a text file (.txt, .json, .css).
   * If the file already exists, it will be overwritten by this command.
   * Note that it will not be possible to download data from many websites because they
   * do not allow cross-origin resource sharing (CORS).
   *
   * @example
   * ```js
   * await ns.wget("https://raw.githubusercontent.com/bitburner-official/bitburner-src/master/README.md", "game_readme.txt");
   * ```
   * @param url - URL to pull data from.
   * @param target - Filename to write data to. Must be script or text file.
   * @param host - Optional hostname/ip of server for target file.
   * @returns True if the data was successfully retrieved from the URL, false otherwise.
   */
  wget(url: string, target: string, host?: string): Promise<boolean>;

  /**
   * Returns the amount of Faction favor required to be able to donate to a faction.
   *
   * @remarks RAM cost: 0.1 GB
   * @returns Amount of Faction favor required to be able to donate to a faction.
   */
  getFavorToDonate(): number;

  /**
   * Get the current BitNode multipliers.
   * @remarks
   * RAM cost: 4 GB
   *
   * Returns an object containing the current (or supplied) BitNode multipliers.
   * This function requires you to be in BitNode 5 or have Source-File 5 in order to run.
   * The multipliers are returned in decimal forms (e.g. 1.5 instead of 150%).
   * The multipliers represent the difference between the current BitNode and
   * the original BitNode (BitNode-1).
   *
   * For example, if the CrimeMoney multiplier has a value of 0.1, then that means
   * that committing crimes in the current BitNode will only give 10% of the money
   * you would have received in BitNode-1.
   *
   * @example
   * ```js
   * const mults = ns.getBitNodeMultipliers();
   * ns.tprint(`ServerMaxMoney: ${mults.ServerMaxMoney}`);
   * ns.tprint(`HackExpGain: ${mults.HackExpGain}`);
   * ```
   * @returns Object containing the current BitNode multipliers.
   */
  getBitNodeMultipliers(n?: number, lvl?: number): BitNodeMultipliers;

  /**
   * Get information about the player.
   * @remarks
   * RAM cost: 0.5 GB
   *
   * Returns an object with information on the current player.
   *
   * @returns Player info
   */
  getPlayer(): Player;

  /**
   * Get information about the sources of income for this run.
   * @remarks
   * RAM cost: 1.0 GB
   *
   * Returns an object with information on the income sources for this run
   *
   * @returns Money sources
   */
  getMoneySources(): MoneySources;

  /**
   * Add a callback to be executed when the script dies.
   * @remarks
   * RAM cost: 0 GB
   *
   * Each script can only register one callback per callback ID.
   * If another callback is registered with the same callback ID
   * the previous callback with that ID is forgotten and will not be executed when the script dies.
   *
   * @param f - A function to execute when the script dies.
   * @param id - Callback ID. Optional, defaults to `"default"`.
   */
  atExit(f: () => void, id?: string): void;

  /**
   * Move a file on the target server.
   * @remarks
   * RAM cost: 0 GB
   *
   * Move the source file to the specified destination on the target server.
   *
   * This command only works for scripts (.js, .jsx, .ts, .tsx) and text files (.txt, .json, .css).
   *
   * This function can also be used to rename files.
   *
   * This function is not able to remove running scripts from their original locations. Make sure to stop any scripts before using this function on them.
   *
   * @param host - Hostname/IP of target server.
   * @param source - Filename of the source file.
   * @param destination - Filename of the destination file.
   */
  mv(host: string, source: string, destination: string): void;

  /** Get information about resets.
   * @remarks
   * RAM cost: 1 GB
   *
   * @example
   * ```js
   * const resetInfo = ns.getResetInfo();
   * const lastAugReset = resetInfo.lastAugReset;
   * ns.tprint(`The last augmentation reset was: ${new Date(lastAugReset)}`);
   * ns.tprint(`It has been ${Date.now() - lastAugReset} ms since the last augmentation reset.`);
   * ```
   */
  getResetInfo(): ResetInfo;

  /**
   * Get the RAM cost of a netscript function.
   *
   * The base RAM cost per script thread can also be retrieved by using `"baseCost"` as argument to this function.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * @param name - The fully-qualified function name, without the leading `ns`.
   *
   * @example
   * ```js
   * const RAM_baseCost = ns.getFunctionRamCost('baseCost');
   * const RAM_for_hack = ns.getFunctionRamCost('hack');
   * const RAM_for_tprint = ns.getFunctionRamCost('tprint');
   * const RAM_for_stock_getPosition = ns.getFunctionRamCost('stock.getPosition');
   * ```
   */
  getFunctionRamCost(name: string): number;

  /**
   * Parse command line flags.
   * @remarks
   * RAM cost: 0 GB
   *
   * Allows Unix-like flag parsing.
   *
   * We support 2 forms:
   *
   * - Short form: the flag contains only 1 character, e.g. -v.
   *
   * - Long form: the flag contains more than 1 character, e.g. --version.
   *
   * Note that if an argument is given and its default value is nullish, the parsed value will be a string. This may
   * cause subtle issues if you are not careful with type coercion.
   *
   * @example
   * ```js
   * export async function main(ns) {
   *   const data = ns.flags([
   *     ['delay', 0], // a default number means this flag is a number
   *     ['server', 'foodnstuff'], //  a default string means this flag is a string
   *     ['exclude', []], // a default array means this flag is a default array of string
   *     ['help', false], // a default boolean means this flag is a boolean
   *     ['v', false], // short form
   *   ]);
   *   ns.tprint(data);
   * }
   *
   * // [home /]> run example.js
   * // {"_":[],"delay":0,"server":"foodnstuff","exclude":[],"help":false,"v":false}
   * // [home /]> run example.js --delay 3000
   * // {"_":[],"delay":3000,"server":"foodnstuff","exclude":[],"help":false,"v":false}
   * // [home /]> run example.js --delay 3000 --server harakiri-sushi
   * // {"_":[],"delay":3000,"server":"harakiri-sushi","exclude":[],"help":false,"v":false}
   * // [home /]> run example.js --delay 3000 --server harakiri-sushi hello world
   * // {"_":["hello","world"],"delay":3000,"server":"harakiri-sushi","exclude":[],"help":false,"v":false}
   * // [home /]> run example.js --delay 3000 --server harakiri-sushi hello world --exclude a --exclude b
   * // {"_":["hello","world"],"delay":3000,"server":"harakiri-sushi","exclude":["a","b"],"help":false,"v":false}
   * // [home /]> run example.js --help
   * // {"_":[],"delay":0,"server":"foodnstuff","exclude":[],"help":true,"v":false}
   * // [home /]> run example.js -v
   * // {"_":[],"delay":0,"server":"foodnstuff","exclude":[],"help":false,"v":true}
   * ```
   *
   * ```js
   * export async function main(ns) {
   *   const data = ns.flags([
   *     ["foo", null],
   *     ["bar", undefined],
   *   ]);
   *   console.log(data);
   * }
   *
   * // [home /]> run example.js
   * // { _: [], foo: null, bar: undefined }
   * // [home /]> run example.js --foo 1000
   * // { _: [], foo: "1000", bar: undefined }
   * // [home /]> run example.js --foo 1000 --bar false
   * // { _: [], foo: "1000", bar: "false" }
   * ```
   * `bar` in the last example is `"false"` (a string), not `false` (a boolean). `data.bar` is truthy, not falsy.
   */
  flags(schema: [string, any][]): {
    [key: string]: any;
    _: ScriptArg[];
  };

  /**
   * Share the server's ram with your factions to increase the reputation gain rate of faction work. This boost is
   * applied to all faction work of all factions.
   * @remarks
   * RAM cost: 2.4 GB
   *
   * Increases rep/second for all faction work while share is running. Each cycle of ns.share() is 10 seconds.
   * Scales with thread count, but at a sharply decreasing rate.
   */
  share(): Promise<void>;

  /**
   * Share power has a multiplicative effect on rep/second while doing hacking work for a faction. If you do non-hacking
   * work, share power still increases the reputation gain rate, but the effect is non-linear.
   *
   * Share power increases incrementally for every thread of share running on your server network, but at a sharply decreasing rate.
   * @remarks
   * RAM cost: 0.2 GB
   */
  getSharePower(): number;

  /**
   * Dynamically import a script.
   * Only scripts located on the same server can be imported.
   * A dynamic import will not adjust RAM usage. This must be done manually with {@link NS.ramOverride|ramOverride}.
   *
   * @example
   *
   * File: script.js
   * ```js
   * export async function main(ns){
   *    const script = await ns.dynamicImport("./scriptToImport.js");
   *    script.log(ns, "Message from an imported script!")
   * }
   *
   * ```
   *
   * File: scriptToImport.js
   * ```js
   * export async function log(ns, message){
   *    ns.tprint(message);
   * }
   * ```
   *
   * @remarks
   * RAM cost: 0 GB
   */
  dynamicImport(path: string): Promise<any>;

  enums: NSEnums;
}

// BASE ENUMS
/** @public */
type ToastVariantEnumType = {
  SUCCESS: "success";
  WARNING: "warning";
  ERROR: "error";
  INFO: "info";
};

/** @public */
type ToastVariant = _ValueOf<ToastVariantEnumType>;

/** @public */
type CrimeEnumType = {
  shoplift: "Shoplift";
  robStore: "Rob Store";
  mug: "Mug";
  larceny: "Larceny";
  dealDrugs: "Deal Drugs";
  bondForgery: "Bond Forgery";
  traffickArms: "Traffick Arms";
  homicide: "Homicide";
  grandTheftAuto: "Grand Theft Auto";
  kidnap: "Kidnap";
  assassination: "Assassination";
  heist: "Heist";
};

/** @public */
type CrimeType = _ValueOf<CrimeEnumType>;

/** @public */
type FactionWorkEnumType = {
  hacking: "hacking";
  field: "field";
  security: "security";
};

/** @public */
type FactionWorkType = _ValueOf<FactionWorkEnumType>;

/** @public */
type UniversityClassEnumType = {
  computerScience: "Computer Science";
  dataStructures: "Data Structures";
  networks: "Networks";
  algorithms: "Algorithms";
  management: "Management";
  leadership: "Leadership";
};

/** @public */
type UniversityClassType = _ValueOf<UniversityClassEnumType>;

/** @public */
type GymEnumType = {
  strength: "str";
  defense: "def";
  dexterity: "dex";
  agility: "agi";
};

/** @public */
type GymType = _ValueOf<GymEnumType>;

/** @public */
type JobNameEnumType = {
  software0: "Software Engineering Intern";
  software1: "Junior Software Engineer";
  software2: "Senior Software Engineer";
  software3: "Lead Software Developer";
  software4: "Head of Software";
  software5: "Head of Engineering";
  software6: "Vice President of Technology";
  software7: "Chief Technology Officer";
  IT0: "IT Intern";
  IT1: "IT Analyst";
  IT2: "IT Manager";
  IT3: "Systems Administrator";
  securityEng: "Security Engineer";
  networkEng0: "Network Engineer";
  networkEng1: "Network Administrator";
  business0: "Business Intern";
  business1: "Business Analyst";
  business2: "Business Manager";
  business3: "Operations Manager";
  business4: "Chief Financial Officer";
  business5: "Chief Executive Officer";
  security0: "Security Guard";
  security1: "Security Officer";
  security2: "Security Supervisor";
  security3: "Head of Security";
  agent0: "Field Agent";
  agent1: "Secret Agent";
  agent2: "Special Operative";
  waiter: "Waiter";
  employee: "Employee";
  softwareConsult0: "Software Consultant";
  softwareConsult1: "Senior Software Consultant";
  businessConsult0: "Business Consultant";
  businessConsult1: "Senior Business Consultant";
  waiterPT: "Part-time Waiter";
  employeePT: "Part-time Employee";
};

/** @public */
type JobName = _ValueOf<JobNameEnumType>;

/** @public */
type JobFieldEnumType = {
  software: "Software";
  softwareConsultant: "Software Consultant";
  it: "IT";
  securityEngineer: "Security Engineer";
  networkEngineer: "Network Engineer";
  business: "Business";
  businessConsultant: "Business Consultant";
  security: "Security";
  agent: "Agent";
  employee: "Employee";
  partTimeEmployee: "Part-time Employee";
  waiter: "Waiter";
  partTimeWaiter: "Part-time Waiter";
};

/** @public */
type JobField = _ValueOf<JobFieldEnumType>;

// CORP ENUMS - Changed to types
/** @public */
type CorpEmployeePosition =
  | "Operations"
  | "Engineer"
  | "Business"
  | "Management"
  | "Research & Development"
  | "Intern"
  | "Unassigned";

/** @public */
type CorpIndustryName =
  | "Water Utilities"
  | "Agriculture"
  | "Fishing"
  | "Mining"
  | "Refinery"
  | "Restaurant"
  | "Tobacco"
  | "Chemical"
  | "Pharmaceutical"
  | "Computer Hardware"
  | "Robotics"
  | "Software"
  | "Healthcare"
  | "Real Estate";

/** @public */
type CorpSmartSupplyOption = "leftovers" | "imports" | "none";

/**
 * Names of all cities
 *
 * @public
 */
type CityNameEnumType = {
  Aevum: "Aevum";
  Chongqing: "Chongqing";
  Sector12: "Sector-12";
  NewTokyo: "New Tokyo";
  Ishima: "Ishima";
  Volhaven: "Volhaven";
};

/** @public */
type CityName = _ValueOf<CityNameEnumType>;

/** Names of all locations
 * @public */
type LocationNameEnumType = {
  AevumAeroCorp: "AeroCorp";
  AevumBachmanAndAssociates: "Bachman & Associates";
  AevumClarkeIncorporated: "Clarke Incorporated";
  AevumCrushFitnessGym: "Crush Fitness Gym";
  AevumECorp: "ECorp";
  AevumFulcrumTechnologies: "Fulcrum Technologies";
  AevumGalacticCybersystems: "Galactic Cybersystems";
  AevumNetLinkTechnologies: "NetLink Technologies";
  AevumPolice: "Aevum Police Headquarters";
  AevumRhoConstruction: "Rho Construction";
  AevumSnapFitnessGym: "Snap Fitness Gym";
  AevumSummitUniversity: "Summit University";
  AevumWatchdogSecurity: "Watchdog Security";
  AevumCasino: "Iker Molina Casino";

  ChongqingKuaiGongInternational: "KuaiGong International";
  ChongqingSolarisSpaceSystems: "Solaris Space Systems";
  ChongqingChurchOfTheMachineGod: "Church of the Machine God";
  ChongqingShadowedWalkway: "Shadowed Walkway";

  Sector12AlphaEnterprises: "Alpha Enterprises";
  Sector12BladeIndustries: "Blade Industries";
  Sector12CIA: "Central Intelligence Agency";
  Sector12CarmichaelSecurity: "Carmichael Security";
  Sector12CityHall: "Sector-12 City Hall";
  Sector12DeltaOne: "DeltaOne";
  Sector12FoodNStuff: "FoodNStuff";
  Sector12FourSigma: "Four Sigma";
  Sector12IcarusMicrosystems: "Icarus Microsystems";
  Sector12IronGym: "Iron Gym";
  Sector12JoesGuns: "Joe's Guns";
  Sector12MegaCorp: "MegaCorp";
  Sector12NSA: "National Security Agency";
  Sector12PowerhouseGym: "Powerhouse Gym";
  Sector12RothmanUniversity: "Rothman University";
  Sector12UniversalEnergy: "Universal Energy";

  NewTokyoDefComm: "DefComm";
  NewTokyoGlobalPharmaceuticals: "Global Pharmaceuticals";
  NewTokyoNoodleBar: "Noodle Bar";
  NewTokyoVitaLife: "VitaLife";
  NewTokyoArcade: "Arcade";

  IshimaNovaMedical: "Nova Medical";
  IshimaOmegaSoftware: "Omega Software";
  IshimaStormTechnologies: "Storm Technologies";
  IshimaGlitch: "0x6C1";

  VolhavenCompuTek: "CompuTek";
  VolhavenHeliosLabs: "Helios Labs";
  VolhavenLexoCorp: "LexoCorp";
  VolhavenMilleniumFitnessGym: "Millenium Fitness Gym";
  VolhavenNWO: "NWO";
  VolhavenOmniTekIncorporated: "OmniTek Incorporated";
  VolhavenOmniaCybersystems: "Omnia Cybersystems";
  VolhavenSysCoreSecurities: "SysCore Securities";
  VolhavenZBInstituteOfTechnology: "ZB Institute of Technology";

  Hospital: "Hospital";
  Slums: "The Slums";
  TravelAgency: "Travel Agency";
  WorldStockExchange: "World Stock Exchange";

  Void: "The Void";
};

/** @public */
type LocationName = _ValueOf<LocationNameEnumType>;

/**
 * Locations of university
 *
 * @public
 */
type UniversityLocationNameEnumType = {
  AevumSummitUniversity: LocationNameEnumType["AevumSummitUniversity"];
  Sector12RothmanUniversity: LocationNameEnumType["Sector12RothmanUniversity"];
  VolhavenZBInstituteOfTechnology: LocationNameEnumType["VolhavenZBInstituteOfTechnology"];
};

/** @public */
type UniversityLocationName = _ValueOf<UniversityLocationNameEnumType>;

/**
 * Locations of gym
 *
 * @public
 */
type GymLocationNameEnumType = {
  AevumCrushFitnessGym: LocationNameEnumType["AevumCrushFitnessGym"];
  AevumSnapFitnessGym: LocationNameEnumType["AevumSnapFitnessGym"];
  Sector12IronGym: LocationNameEnumType["Sector12IronGym"];
  Sector12PowerhouseGym: LocationNameEnumType["Sector12PowerhouseGym"];
  VolhavenMilleniumFitnessGym: LocationNameEnumType["VolhavenMilleniumFitnessGym"];
};

/** @public */
type GymLocationName = _ValueOf<GymLocationNameEnumType>;

/** Names of all companies
 * @public */
type CompanyNameEnumType = {
  ECorp: "ECorp";
  MegaCorp: "MegaCorp";
  BachmanAndAssociates: "Bachman & Associates";
  BladeIndustries: "Blade Industries";
  NWO: "NWO";
  ClarkeIncorporated: "Clarke Incorporated";
  OmniTekIncorporated: "OmniTek Incorporated";
  FourSigma: "Four Sigma";
  KuaiGongInternational: "KuaiGong International";
  FulcrumTechnologies: "Fulcrum Technologies";
  StormTechnologies: "Storm Technologies";
  DefComm: "DefComm";
  HeliosLabs: "Helios Labs";
  VitaLife: "VitaLife";
  IcarusMicrosystems: "Icarus Microsystems";
  UniversalEnergy: "Universal Energy";
  GalacticCybersystems: "Galactic Cybersystems";
  AeroCorp: "AeroCorp";
  OmniaCybersystems: "Omnia Cybersystems";
  SolarisSpaceSystems: "Solaris Space Systems";
  DeltaOne: "DeltaOne";
  GlobalPharmaceuticals: "Global Pharmaceuticals";
  NovaMedical: "Nova Medical";
  CIA: "Central Intelligence Agency";
  NSA: "National Security Agency";
  WatchdogSecurity: "Watchdog Security";
  LexoCorp: "LexoCorp";
  RhoConstruction: "Rho Construction";
  AlphaEnterprises: "Alpha Enterprises";
  Police: "Aevum Police Headquarters";
  SysCoreSecurities: "SysCore Securities";
  CompuTek: "CompuTek";
  NetLinkTechnologies: "NetLink Technologies";
  CarmichaelSecurity: "Carmichael Security";
  FoodNStuff: "FoodNStuff";
  JoesGuns: "Joe's Guns";
  OmegaSoftware: "Omega Software";
  NoodleBar: "Noodle Bar";
};

/** @public */
type CompanyName = _ValueOf<CompanyNameEnumType>;

/**
 * Names of all factions.
 *
 * Warning: Spoiler ahead. This enum contains names of **all** factions. If you do not want to know what all the
 * factions are, you should not check this enum. Some factions are only accessible in the endgame.
 *
 * @public */
type FactionNameEnumType = {
  Illuminati: "Illuminati";
  Daedalus: "Daedalus";
  TheCovenant: "The Covenant";
  ECorp: "ECorp";
  MegaCorp: "MegaCorp";
  BachmanAndAssociates: "Bachman & Associates";
  BladeIndustries: "Blade Industries";
  NWO: "NWO";
  ClarkeIncorporated: "Clarke Incorporated";
  OmniTekIncorporated: "OmniTek Incorporated";
  FourSigma: "Four Sigma";
  KuaiGongInternational: "KuaiGong International";
  FulcrumSecretTechnologies: "Fulcrum Secret Technologies";
  BitRunners: "BitRunners";
  TheBlackHand: "The Black Hand";
  NiteSec: "NiteSec";
  Aevum: "Aevum";
  Chongqing: "Chongqing";
  Ishima: "Ishima";
  NewTokyo: "New Tokyo";
  Sector12: "Sector-12";
  Volhaven: "Volhaven";
  SpeakersForTheDead: "Speakers for the Dead";
  TheDarkArmy: "The Dark Army";
  TheSyndicate: "The Syndicate";
  Silhouette: "Silhouette";
  Tetrads: "Tetrads";
  SlumSnakes: "Slum Snakes";
  Netburners: "Netburners";
  TianDiHui: "Tian Di Hui";
  CyberSec: "CyberSec";
  Bladeburners: "Bladeburners";
  ChurchOfTheMachineGod: "Church of the Machine God";
  ShadowsOfAnarchy: "Shadows of Anarchy";
};

/** @public */
type FactionName = _ValueOf<FactionNameEnumType>;

/** @public */
type ProgramNameEnumType = {
  nuke: "NUKE.exe";
  bruteSsh: "BruteSSH.exe";
  ftpCrack: "FTPCrack.exe";
  relaySmtp: "relaySMTP.exe";
  httpWorm: "HTTPWorm.exe";
  sqlInject: "SQLInject.exe";
  deepScan1: "DeepscanV1.exe";
  deepScan2: "DeepscanV2.exe";
  serverProfiler: "ServerProfiler.exe";
  autoLink: "AutoLink.exe";
  formulas: "Formulas.exe";
  bitFlume: "b1t_flum3.exe";
  flight: "fl1ght.exe";
  darkscape: "DarkscapeNavigator.exe";
  stormSeed: "STORM_SEED.exe";
};

/** @public */
type ProgramName = _ValueOf<ProgramNameEnumType>;

/** @public */
type CodingContractNameEnumType = {
  FindLargestPrimeFactor: "Find Largest Prime Factor";
  SubarrayWithMaximumSum: "Subarray with Maximum Sum";
  TotalWaysToSum: "Total Ways to Sum";
  TotalWaysToSumII: "Total Ways to Sum II";
  SpiralizeMatrix: "Spiralize Matrix";
  ArrayJumpingGame: "Array Jumping Game";
  ArrayJumpingGameII: "Array Jumping Game II";
  MergeOverlappingIntervals: "Merge Overlapping Intervals";
  GenerateIPAddresses: "Generate IP Addresses";
  AlgorithmicStockTraderI: "Algorithmic Stock Trader I";
  AlgorithmicStockTraderII: "Algorithmic Stock Trader II";
  AlgorithmicStockTraderIII: "Algorithmic Stock Trader III";
  AlgorithmicStockTraderIV: "Algorithmic Stock Trader IV";
  MinimumPathSumInATriangle: "Minimum Path Sum in a Triangle";
  UniquePathsInAGridI: "Unique Paths in a Grid I";
  UniquePathsInAGridII: "Unique Paths in a Grid II";
  ShortestPathInAGrid: "Shortest Path in a Grid";
  SanitizeParenthesesInExpression: "Sanitize Parentheses in Expression";
  FindAllValidMathExpressions: "Find All Valid Math Expressions";
  HammingCodesIntegerToEncodedBinary: "HammingCodes: Integer to Encoded Binary";
  HammingCodesEncodedBinaryToInteger: "HammingCodes: Encoded Binary to Integer";
  Proper2ColoringOfAGraph: "Proper 2-Coloring of a Graph";
  CompressionIRLECompression: "Compression I: RLE Compression";
  CompressionIILZDecompression: "Compression II: LZ Decompression";
  CompressionIIILZCompression: "Compression III: LZ Compression";
  EncryptionICaesarCipher: "Encryption I: Caesar Cipher";
  EncryptionIIVigenereCipher: "Encryption II: Vigenère Cipher";
  SquareRoot: "Square Root";
  TotalPrimesInRange: "Total Number of Primes";
  LargestRectangleInAMatrix: "Largest Rectangle in a Matrix";
};

/** @public */
type CodingContractName = _ValueOf<CodingContractNameEnumType>;

/**
 * This is a map of contract types to their input and answer data types. The key is the contract type. The value is a
 * tuple containing the input and answer data types.
 *
 * @example
 * ```
 * "Subarray with Maximum Sum": [number[], number]
 * ```
 * For the "Subarray with Maximum Sum" contract, the input type is `number[]` and the answer type is `number`.
 *
 * @public
 */
export type CodingContractSignatures = {
  "Find Largest Prime Factor": [number, number];
  "Subarray with Maximum Sum": [number[], number];
  "Total Ways to Sum": [number, number];
  "Total Ways to Sum II": [[number, number[]], number];
  "Spiralize Matrix": [number[][], number[]];
  "Array Jumping Game": [number[], 1 | 0];
  "Array Jumping Game II": [number[], number];
  "Merge Overlapping Intervals": [[number, number][], [number, number][]];
  "Generate IP Addresses": [string, string[]];
  "Algorithmic Stock Trader I": [number[], number];
  "Algorithmic Stock Trader II": [number[], number];
  "Algorithmic Stock Trader III": [number[], number];
  "Algorithmic Stock Trader IV": [[number, number[]], number];
  "Minimum Path Sum in a Triangle": [number[][], number];
  "Unique Paths in a Grid I": [[number, number], number];
  "Unique Paths in a Grid II": [(1 | 0)[][], number];
  "Shortest Path in a Grid": [(1 | 0)[][], string];
  "Sanitize Parentheses in Expression": [string, string[]];
  "Find All Valid Math Expressions": [[string, number], string[]];
  "HammingCodes: Integer to Encoded Binary": [number, string];
  "HammingCodes: Encoded Binary to Integer": [string, number];
  "Proper 2-Coloring of a Graph": [[number, [number, number][]], (1 | 0)[]];
  "Compression I: RLE Compression": [string, string];
  "Compression II: LZ Decompression": [string, string];
  "Compression III: LZ Compression": [string, string];
  "Encryption I: Caesar Cipher": [[string, number], string];
  "Encryption II: Vigenère Cipher": [[string, string], string];
  "Square Root": [bigint, bigint];
  "Total Number of Primes": [[number, number], number];
  "Largest Rectangle in a Matrix": [(1 | 0)[][], [[number, number], [number, number]]];
};

/** @public */
export type CodingContractObject = {
  [T in keyof CodingContractSignatures]: {
    type: T;
    data: CodingContractSignatures[T][0];
    submit: (answer: CodingContractSignatures[T][1] | string) => string;
    description: string;
    difficulty: number;
    numTriesRemaining: () => number;
  };
}[keyof CodingContractSignatures];

/** @public */
type NSEnums = {
  CityName: CityNameEnumType;
  CrimeType: CrimeEnumType;
  FactionWorkType: FactionWorkEnumType;
  GymType: GymEnumType;
  JobName: JobNameEnumType;
  JobField: JobFieldEnumType;
  LocationName: LocationNameEnumType;
  ToastVariant: ToastVariantEnumType;
  UniversityClassType: UniversityClassEnumType;
  CompanyName: CompanyNameEnumType;
  FactionName: FactionNameEnumType;
  CodingContractName: CodingContractNameEnumType;
  PositionType: PositionEnumType;
  OrderType: OrderEnumType;
  BladeburnerActionType: BladeburnerActionEnumType;
  SpecialBladeburnerActionTypeForSleeve: SpecialBladeburnerActionEnumTypeForSleeve;
  FragmentType: FragmentEnumType;
  DarknetResponseCode: DarknetResponseCodeType;
  ProgramName: ProgramNameEnumType;
  GangTaskName: GangTaskNameEnumType;
};

/**
 * Corporation Office API
 *
 * @remarks
 * Requires the Office API upgrade from your corporation.
 *
 * @public
 */
export interface OfficeAPI {
  /**
   * Hire an employee.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division
   * @param city - Name of the city
   * @param employeePosition - Position to place into. Defaults to "Unassigned".
   * @returns True if an employee was hired, false otherwise
   */
  hireEmployee(divisionName: string, city: CityName, employeePosition?: CorpEmployeePosition): boolean;

  /**
   * Upgrade office size.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division
   * @param city - Name of the city
   * @param size - Amount of positions to open
   */
  upgradeOfficeSize(divisionName: string, city: CityName, size: number): void;

  /**
   * Throw a party for your employees.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division
   * @param city - Name of the city
   * @param costPerEmployee - Amount to spend per employee.
   * @returns Multiplier for morale, or zero on failure
   */
  throwParty(divisionName: string, city: CityName, costPerEmployee: number): number;

  /**
   * Buy tea for your employees.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division
   * @param city - Name of the city
   * @returns true if buying tea was successful, false otherwise
   */
  buyTea(divisionName: string, city: CityName): boolean;

  /**
   * Hire AdVert.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division
   */
  hireAdVert(divisionName: string): void;

  /**
   * Purchase a research.
   *
   * Some research is only available for product industries. This function does not do anything if you purchase that
   * research for a material industry.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division
   * @param researchName - Name of the research
   */
  research(divisionName: string, researchName: CorpResearchName): void;

  /**
   * Get data about an office.
   *
   * @remarks
   * RAM cost: 10 GB
   *
   * @param divisionName - Name of the division
   * @param city - Name of the city
   * @returns Office data
   */
  getOffice(divisionName: string, city: CityName): Office;

  /**
   * Get the cost to hire AdVert.
   *
   * @remarks
   * RAM cost: 10 GB
   *
   * @param divisionName - Name of the division.
   * @returns The cost to hire AdVert.
   */
  getHireAdVertCost(divisionName: string): number;

  /**
   * Get the number of times you have hired AdVert.
   *
   * @remarks
   * RAM cost: 10 GB
   *
   * @param divisionName - Name of the division.
   * @returns Number of times you have hired AdVert.
   */
  getHireAdVertCount(divisionName: string): number;

  /**
   * Get the cost to unlock a research.
   *
   * @remarks
   * RAM cost: 10 GB
   *
   * @param divisionName - Name of the division
   * @param researchName - Name of the research
   * @returns Cost
   */
  getResearchCost(divisionName: string, researchName: CorpResearchName): number;

  /**
   * Check if you unlocked a research.
   *
   * @remarks
   * RAM cost: 10 GB
   *
   * @param divisionName - Name of the division
   * @param researchName - Name of the research
   * @returns true is unlocked, false if not
   */
  hasResearched(divisionName: string, researchName: CorpResearchName): boolean;

  /**
   * Set the job assignment for a job.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division
   * @param city - Name of the city
   * @param job - Name of the job. Passing "Unassigned" will cause this API to not do anything and just return false.
   * @param amount - Number of employees to assign to that job
   * @returns true if the employee count reached the target amount, false if not
   */
  setJobAssignment(
    divisionName: string,
    city: CityName,
    job: Exclude<CorpEmployeePosition, "Unassigned">,
    amount: number,
  ): boolean;

  /**
   * Get the cost to upgrade an office.
   *
   * @remarks
   * RAM cost: 10 GB
   *
   * @param divisionName - Name of the division
   * @param city - Name of the city
   * @param size - Amount of positions to open
   * @returns Cost of upgrading the office
   */
  getOfficeSizeUpgradeCost(divisionName: string, city: CityName, size: number): number;
}

/**
 * Corporation Warehouse API
 *
 * @remarks
 * Requires the Warehouse API upgrade from your corporation.
 *
 * @public
 */
export interface WarehouseAPI {
  /**
   * Set material sell data.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division
   * @param city - Name of the city
   * @param materialName - Name of the material
   * @param amt - Amount to sell, can be "MAX"
   * @param price - Price to sell, can be "MP"
   */
  sellMaterial(divisionName: string, city: CityName, materialName: CorpMaterialName, amt: string, price: string): void;

  /**
   * Set product sell data.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division
   * @param city - Name of the city
   * @param productName - Name of the product
   * @param amt - Amount to sell, can be "MAX"
   * @param price - Price to sell, can be "MP"
   * @param all - Set sell amount and price in all cities
   */
  sellProduct(
    divisionName: string,
    city: CityName,
    productName: string,
    amt: string,
    price: string,
    all: boolean,
  ): void;

  /**
   * Discontinue a product.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division
   * @param productName - Name of the product
   */
  discontinueProduct(divisionName: string, productName: string): void;

  /**
   * Set smart supply.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division
   * @param city - Name of the city
   * @param enabled - Use true to enable, false otherwise.
   */
  setSmartSupply(divisionName: string, city: CityName, enabled: boolean): void;

  /**
   * Set whether smart supply uses leftovers before buying.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division
   * @param city - Name of the city
   * @param materialName - Name of the material
   * @param option - Smart supply option. Set "leftovers" to use leftovers, "imports" to use only imported materials, and "none" to not use stored materials.
   */
  setSmartSupplyOption(
    divisionName: string,
    city: CityName,
    materialName: CorpMaterialName,
    option: CorpSmartSupplyOption,
  ): void;

  /**
   * Set material buy data.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division
   * @param city - Name of the city
   * @param materialName - Name of the material
   * @param amt - Amount of material to buy
   */
  buyMaterial(divisionName: string, city: CityName, materialName: CorpMaterialName, amt: number): void;

  /**
   * Set material to bulk-buy.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division
   * @param city - Name of the city
   * @param materialName - Name of the material
   * @param amt - Amount of material to buy
   */
  bulkPurchase(divisionName: string, city: CityName, materialName: CorpMaterialName, amt: number): void;

  /**
   * Get warehouse data.
   *
   * @remarks
   * RAM cost: 10 GB
   *
   * @param divisionName - Name of the division
   * @param city - Name of the city
   * @returns Warehouse data
   */
  getWarehouse(divisionName: string, city: CityName): Warehouse;

  /**
   * Get product data.
   *
   * @remarks
   * RAM cost: 10 GB
   *
   * @param divisionName - Name of the division
   * @param cityName - Name of the city
   * @param productName - Name of the product
   * @returns Product data
   */
  getProduct(divisionName: string, cityName: CityName, productName: string): Product;

  /**
   * Get material data.
   *
   * @remarks
   * RAM cost: 10 GB
   *
   * @param divisionName - Name of the division
   * @param city - Name of the city
   * @param materialName - Name of the material
   * @returns Material data
   */
  getMaterial(divisionName: string, city: CityName, materialName: CorpMaterialName): Material;

  /**
   * Set Market-TA1 for a material.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division
   * @param city - Name of the city
   * @param materialName - Name of the material
   * @param on - Use true to enable, false otherwise.
   */
  setMaterialMarketTA1(divisionName: string, city: CityName, materialName: CorpMaterialName, on: boolean): void;

  /**
   * Set Market-TA2 for a material.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division
   * @param city - Name of the city
   * @param materialName - Name of the material
   * @param on - Use true to enable, false otherwise.
   */
  setMaterialMarketTA2(divisionName: string, city: CityName, materialName: CorpMaterialName, on: boolean): void;

  /**
   * Set Market-TA1 for a product.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division
   * @param productName - Name of the product
   * @param on - Use true to enable, false otherwise.
   */
  setProductMarketTA1(divisionName: string, productName: string, on: boolean): void;

  /**
   * Set Market-TA2 for a product.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division
   * @param productName - Name of the product
   * @param on - Use true to enable, false otherwise.
   */
  setProductMarketTA2(divisionName: string, productName: string, on: boolean): void;

  /**
   * Set material export data.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param sourceDivision - Source division
   * @param sourceCity - Source city
   * @param targetDivision - Target division
   * @param targetCity - Target city
   * @param materialName - Name of the material
   * @param amt - Amount of material to export.
   */
  exportMaterial(
    sourceDivision: string,
    sourceCity: CityName,
    targetDivision: string,
    targetCity: CityName,
    materialName: CorpMaterialName,
    amt: number | string,
  ): void;

  /**
   * Cancel material export.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param sourceDivision - Source division
   * @param sourceCity - Source city
   * @param targetDivision - Target division
   * @param targetCity - Target city
   * @param materialName - Name of the material
   */
  cancelExportMaterial(
    sourceDivision: string,
    sourceCity: CityName,
    targetDivision: string,
    targetCity: CityName,
    materialName: CorpMaterialName,
  ): void;

  /**
   * Purchase warehouse for a new city.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division
   * @param city - Name of the city
   */
  purchaseWarehouse(divisionName: string, city: CityName): void;

  /**
   * Upgrade warehouse.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division
   * @param city - Name of the city
   * @param amt - Amount of upgrades. Defaults to 1.
   */
  upgradeWarehouse(divisionName: string, city: CityName, amt?: number): void;

  /**
   * Create a new product.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division
   * @param city - Name of the city
   * @param productName - Name of the product
   * @param designInvest - Amount to invest for the design of the product.
   * @param marketingInvest - Amount to invest for the marketing of the product.
   */
  makeProduct(
    divisionName: string,
    city: CityName,
    productName: string,
    designInvest: number,
    marketingInvest: number,
  ): void;

  /**
   * Limit material production.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * This limit applies only to output. It does not reduce input consumption. The excess output is discarded after being
   * produced.
   *
   * For example: Assume the division's raw production is 1000 and the warehouse has enough input materials. In
   * Agriculture, for each unit of raw production, you need 0.045 units of free space (check corporation documentation
   * for further explanation). Therefore, with RawProduction = 1000, you need 45 units of free space to avoid being
   * bottlenecked by insufficient free space.
   *
   * Case 1: Enough free space (Free space = 45). You need to consume 500 Water and 200 Chemicals to produce 1000
   * Plants and 1000 Food.
   *
   * If you set the limits for Plants and Food to 200 and 100 respectively, you will still consume 500 Water and 200
   * Chemicals, but only produce 200 Plants and 100 Food (the excess 800 Plants and 900 Food are discarded after being
   * produced). The free space after production is 67 (800 Plants and 900 Food are discarded).
   *
   * Case 2: Insufficient free space (Free space = 22.5). The available free space is only 50% of the required free
   * space. Therefore, RawProduction is scaled down to 500.
   *
   * You need to consume 250 Water and 100 Chemicals to produce 500 Plants and 500 Food. If you set the Food limit to 0,
   * you will still consume 250 Water and 100 Chemicals, but only produce 500 Plants (the excess 500 Food are discarded
   * after being produced). The free space after production is 15 (500 Food are discarded).
   *
   * With industries that produce both materials and products, the material production limits do not affect product
   * production.
   *
   * You can set a limit on any material, but only limits on output materials are enforced. Limits on other materials
   * are stored but ignored during production calculations. For example, in Agriculture, only limits on Plants and Food
   * are enforced.
   *
   * @param divisionName - Name of the division.
   * @param city - Name of the city.
   * @param materialName - Name of the material.
   * @param qty - Amount to limit to. Pass a negative value to remove the limit instead.
   */
  limitMaterialProduction(divisionName: string, city: CityName, materialName: CorpMaterialName, qty: number): void;

  /**
   * Limit product production.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division.
   * @param city - Name of the city.
   * @param productName - Name of the product.
   * @param qty - Amount to limit to. Pass a negative value to remove the limit instead.
   */
  limitProductProduction(divisionName: string, city: CityName, productName: string, qty: number): void;

  /**
   * Get the cost to upgrade a warehouse to the next level.
   *
   * @remarks
   * RAM cost: 10 GB
   *
   * @param divisionName - Name of the division
   * @param city - Name of the city
   * @param amt - Amount of upgrades. Optional. Defaults to 1.
   * @returns Cost to upgrade
   */
  getUpgradeWarehouseCost(divisionName: string, city: CityName, amt?: number): number;

  /**
   * Check if you have a warehouse in city.
   *
   * @remarks
   * RAM cost: 10 GB
   *
   * @returns true if warehouse is present, false if not.
   */
  hasWarehouse(divisionName: string, city: CityName): boolean;
}

/**
 * @public
 */
type CreatingCorporationCheckResultEnumType = {
  Success: "Success";
  NoSf3OrDisabled: "NoSf3OrDisabled";
  CorporationExists: "CorporationExists";
  UseSeedMoneyOutsideBN3: "UseSeedMoneyOutsideBN3";
  DisabledBySoftCap: "DisabledBySoftCap";
};

/** @public */
type CreatingCorporationCheckResult = _ValueOf<CreatingCorporationCheckResultEnumType>;

/**
 * Corporation API
 * @public
 */
export interface Corporation extends WarehouseAPI, OfficeAPI {
  /**
   * Return whether the player has a corporation. Does not require API access.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * @returns Whether the player has a corporation
   */
  hasCorporation(): boolean;

  /**
   * Return whether the player can create a corporation. Does not require API access.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * @param selfFund - true if you want to self-fund, false otherwise
   * @returns Result of the check
   */
  canCreateCorporation(selfFund: boolean): CreatingCorporationCheckResult;

  /**
   * Create a Corporation. You should use {@link Corporation.canCreateCorporation | canCreateCorporation} to check if
   * you are unsure you can do it, because it throws an error in these cases:
   *
   * - Use seed money outside BitNode 3.
   *
   * - Be in a BitNode that has CorporationSoftcap (a BitNode modifier) less than 0.15.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param corporationName - Name of the corporation. It must be a non-empty string.
   * @param selfFund - If you want to self-fund. Defaults to true, false will only work in BitNode 3.
   * @returns true if created and false if not
   */
  createCorporation(corporationName: string, selfFund?: boolean): boolean;

  /**
   * Check if you have a one-time unlockable upgrade.
   *
   * @remarks
   * RAM cost: 10 GB
   *
   * @param upgradeName - Name of the upgrade
   * @returns true if unlocked and false if not
   */
  hasUnlock(upgradeName: CorpUnlockName): boolean;

  /**
   * Get the cost to unlock a one-time unlockable upgrade.
   *
   * @remarks
   * RAM cost: 10 GB
   *
   * @param upgradeName - Name of the upgrade
   * @returns Cost of the upgrade
   */
  getUnlockCost(upgradeName: CorpUnlockName): number;

  /**
   * Get the level of a levelable upgrade.
   *
   * @remarks
   * RAM cost: 10 GB
   *
   * @param upgradeName - Name of the upgrade
   * @returns The level of the upgrade
   */
  getUpgradeLevel(upgradeName: CorpUpgradeName): number;

  /**
   * Get the cost to unlock the next level of a levelable upgrade.
   *
   * @remarks
   * RAM cost: 10 GB
   *
   * @param upgradeName - Name of the upgrade
   * @returns Cost of the upgrade
   */
  getUpgradeLevelCost(upgradeName: CorpUpgradeName): number;

  /**
   * Get an offer for investment based on current corporation valuation.
   *
   * @remarks
   * RAM cost: 10 GB
   *
   * @returns An offer of investment
   */
  getInvestmentOffer(): InvestmentOffer;

  /**
   * Get corporation-related constants.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * @returns Corporation-related constants
   */
  getConstants(): CorpConstants;

  /**
   * Get constant data of an industry.
   *
   * @remarks
   * RAM cost: 10 GB
   *
   * @param industryName - Name of the industry
   * @returns Industry data
   */
  getIndustryData(industryName: CorpIndustryName): CorpIndustryData;

  /**
   * Get constant data of a material.
   *
   * @remarks
   * RAM cost: 10 GB
   *
   * @param materialName - Name of the material
   * @returns Material data
   */
  getMaterialData(materialName: CorpMaterialName): CorpMaterialConstantData;

  /**
   * Accept the investment offer. The value of offer is based on current corporation valuation.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @returns true if you successfully accept the offer, false if not
   */
  acceptInvestmentOffer(): boolean;

  /**
   * Go public.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param numShares - Number of shares you would like to issue for your IPO
   * @returns true if you successfully go public, false if not
   */
  goPublic(numShares: number): boolean;

  /**
   * Bribe a faction. You must satisfy these conditions:
   *
   * - The corporation valuation must be greater than or equal to a threshold. You can use
   * {@link Corporation.getCorporation | getCorporation} and {@link Corporation.getConstants | getConstants} to get this
   * information.
   *
   * - You must be a member of the specified faction.
   *
   * - The specified faction must offer at least 1 type of work. You can use
   * {@link Singularity.getFactionWorkTypes | getFactionWorkTypes} to get the list of work types of a faction.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param factionName - Faction name
   * @param amountCash - Amount of money to bribe
   * @returns true if successful, false if not
   */
  bribe(factionName: FactionName, amountCash: number): boolean;

  /**
   * Get corporation data.
   *
   * @remarks
   * RAM cost: 10 GB
   *
   * @returns Corporation data
   */
  getCorporation(): CorporationInfo;

  /**
   * Get division data.
   *
   * @remarks
   * RAM cost: 10 GB
   *
   * @param divisionName - Name of the division
   * @returns Division data
   */
  getDivision(divisionName: string): Division;

  /**
   * Expand to a new industry.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param industryType - Name of the industry
   * @param divisionName - Name of the division
   */
  expandIndustry(industryType: CorpIndustryName, divisionName: string): void;

  /**
   * Expand to a new city.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division
   * @param city - Name of the city
   */
  expandCity(divisionName: string, city: CityName): void;

  /**
   * Unlock an upgrade.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param upgradeName - Name of the upgrade
   */
  purchaseUnlock(upgradeName: CorpUnlockName): void;

  /**
   * Level up an upgrade.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param upgradeName - Name of the upgrade
   */
  levelUpgrade(upgradeName: CorpUpgradeName): void;

  /**
   * Issue dividends.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param rate - Fraction of profit to issue as dividends.
   */
  issueDividends(rate: number): void;

  /**
   * Issue new shares.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param amount - Number of new shares to issue. It will be rounded to nearest 10 million. Defaults to max amount.
   * @returns Amount of funds generated for the corporation.
   */
  issueNewShares(amount?: number): number;

  /**
   * Buyback shares. Spend money from the player's wallet to transfer shares from public traders to the CEO.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param amount - Amount of shares to buy back, must be integer and larger than 0
   */
  buyBackShares(amount: number): void;

  /**
   * Sell shares. Transfer shares from the CEO to public traders to receive money in the player's wallet.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param amount -  Amount of shares to sell, must be integer between 1 and 100t
   */
  sellShares(amount: number): void;

  /**
   * Get bonus time. Bonus time is accumulated when the game is offline or if the game is inactive in the browser. Bonus
   * time makes the corporation progress faster.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * @returns Bonus time for the Corporation mechanic in milliseconds.
   */
  getBonusTime(): number;

  /**
   * Sleep until the next Corporation update happens.
   *
   * @remarks
   * RAM cost: 0 GB
   *
   * The amount of real time spent asleep between updates can vary due to "bonus time"
   * (usually 200 milliseconds - 2 seconds).
   *
   * If the returned state is X, it means X just happened.
   *
   * Possible states are START, PURCHASE, PRODUCTION, EXPORT, SALE.
   *
   * @example
   * ```js
   * while (true) {
   *   const prevState = await ns.corporation.nextUpdate();
   *   const nextState = ns.corporation.getCorporation().nextState;
   *   ns.print(`Corporation finished with ${prevState}, next will be ${nextState}.`);
   *   // Manage the Corporation
   * }
   * ```
   *
   * @returns Promise that resolves to the name of the state that was just processed.
   */
  nextUpdate(): Promise<CorpStateName>;

  /**
   * Sell a division.
   *
   * @remarks
   * RAM cost: 20 GB
   *
   * @param divisionName - Name of the division
   */
  sellDivision(divisionName: string): void;
}

/** Product rating information
 *  @public */
interface CorpProductData {
  /** Name of the product */
  name: string;
  /** Verb used to describe creation of the product */
  verb: string;
  /** Description of product creation */
  desc: string;
  /** Weighting factors for product  */
  ratingWeights: {
    aesthetics?: number;
    durability?: number;
    features?: number;
    quality?: number;
    performance?: number;
    reliability?: number;
  };
}

/** Data for an individual industry
 *  @public */
interface CorpIndustryData {
  startingCost: number;
  description: string;
  product?: CorpProductData;
  recommendStarting: boolean;
  requiredMaterials: Partial<Record<CorpMaterialName, number>>;
  /** Real estate factor */
  realEstateFactor?: number;
  /** Scientific research factor (affects quality) */
  scienceFactor?: number;
  /** Hardware factor */
  hardwareFactor?: number;
  /** Robots factor */
  robotFactor?: number;
  /** AI Cores factor */
  aiCoreFactor?: number;
  /** Advertising factor (affects sales) */
  advertisingFactor?: number;
  /** Array of Materials produced */
  producedMaterials?: CorpMaterialName[];
  /** Whether the industry of this division is capable of producing materials */
  makesMaterials: boolean;
  /** Whether the industry of this division is capable of developing and producing products */
  makesProducts: boolean;
}

/**
 * General info about a corporation
 * @public
 */
interface CorporationInfo {
  /** Name of the corporation */
  name: string;
  /** Funds available */
  funds: number;
  /** Revenue per second this cycle */
  revenue: number;
  /** Expenses per second this cycle */
  expenses: number;
  /** Indicating if the company is public */
  public: boolean;
  /** Total number of shares issued by this corporation. */
  totalShares: number;
  /** Amount of shares owned by the CEO. */
  numShares: number;
  /** Cooldown until shares can be sold again */
  shareSaleCooldown: number;
  /** Amount of shares owned by private investors. Not available for public sale or CEO buyback. */
  investorShares: number;
  /** Amount of shares owned by public traders. Available for CEO buyback. */
  issuedShares: number;
  /** Cooldown until new shares can be issued */
  issueNewSharesCooldown: number;
  /** Price of the shares */
  sharePrice: number;
  /** Fraction of profits issued as dividends */
  dividendRate: number;
  /** Your income from dividend is negatively affected by this penalty modifier */
  tributeModifier: number;
  /** Your earnings as a shareholder per second this cycle */
  dividendEarnings: number;
  /** The next state to be processed.
   *
   *  I.e. when the state is PURCHASE, it means purchasing will occur during the next state transition.
   *
   *  Possible states are START, PURCHASE, PRODUCTION, EXPORT, SALE. */
  nextState: CorpStateName;
  /** The last state that got processed.
   *
   *  I.e. when that state is PURCHASE, it means purchasing just happened.
   *
   *  Possible states are START, PURCHASE, PRODUCTION, EXPORT, SALE. */
  prevState: CorpStateName;
  /** Array of all division names */
  divisions: string[];
  /** Corporation valuation */
  valuation: number;
}

/**
 * Corporation related constants
 * @public
 */
interface CorpConstants {
  /** Names of all corporation game states */
  stateNames: CorpStateName[];
  /** Names of all employee positions */
  employeePositions: CorpEmployeePosition[];
  /** Names of all industries */
  industryNames: CorpIndustryName[];
  /** Names of all materials */
  materialNames: CorpMaterialName[];
  /** Names of all one-time corporation-wide unlocks */
  unlockNames: CorpUnlockName[];
  /** Names of all corporation-wide upgrades */
  upgradeNames: CorpUpgradeName[];
  /** Names of all researches common to all industries */
  researchNamesBase: CorpResearchName[];
  /** Names of all researches only available to product industries */
  researchNamesProductOnly: CorpResearchName[];
  /** Names of all researches */
  researchNames: CorpResearchName[];
  initialShares: number;
  /** When selling large number of shares, price is dynamically updated for every batch of this amount */
  sharesPerPriceUpdate: number;
  /** Cooldown for issue new shares cooldown in game cycles (1 game cycle = 200ms) */
  issueNewSharesCooldown: number;
  /** Cooldown for selling shares in game cycles (1 game cycle = 200ms) */
  sellSharesCooldown: number;
  teaCostPerEmployee: number;
  gameCyclesPerMarketCycle: number;
  gameCyclesPerCorpStateCycle: number;
  secondsPerMarketCycle: number;
  warehouseInitialCost: number;
  warehouseInitialSize: number;
  warehouseSizeUpgradeCostBase: number;
  officeInitialCost: number;
  officeInitialSize: number;
  officeSizeUpgradeCostBase: number;
  bribeThreshold: number;
  bribeAmountPerReputation: number;
  baseProductProfitMult: number;
  dividendMaxRate: number;
  /** Conversion factor for employee stats to initial salary */
  employeeSalaryMultiplier: number;
  marketCyclesPerEmployeeRaise: number;
  employeeRaiseAmount: number;
  /** Max products for a division without upgrades */
  maxProductsBase: number;
  /** The minimum decay value for morale/energy */
  minEmployeeDecay: number;
  smartSupplyOptions: CorpSmartSupplyOption[];
}
/** @public */
type CorpStateName = "START" | "PURCHASE" | "PRODUCTION" | "EXPORT" | "SALE";

/** @public */
type CorpMaterialName =
  | "Minerals"
  | "Ore"
  | "Water"
  | "Food"
  | "Plants"
  | "Metal"
  | "Hardware"
  | "Chemicals"
  | "Drugs"
  | "Robots"
  | "AI Cores"
  | "Real Estate";

/** @public */
type CorpUnlockName =
  | "Export"
  | "Smart Supply"
  | "Market Research - Demand"
  | "Market Data - Competition"
  | "Shady Accounting"
  | "Government Partnership"
  | "Warehouse API"
  | "Office API";

/** @public */
type CorpUpgradeName =
  | "Smart Factories"
  | "Smart Storage"
  | "Wilson Analytics"
  | "Nuoptimal Nootropic Injector Implants"
  | "Speech Processor Implants"
  | "Neural Accelerators"
  | "FocusWires"
  | "ABC SalesBots"
  | "Project Insight";

/** @public */
type CorpResearchName =
  | "Hi-Tech R&D Laboratory"
  | "AutoBrew"
  | "AutoPartyManager"
  | "Automatic Drug Administration"
  | "CPH4 Injections"
  | "Drones"
  | "Drones - Assembly"
  | "Drones - Transport"
  | "Go-Juice"
  | "HRBuddy-Recruitment"
  | "HRBuddy-Training"
  | "Market-TA.I"
  | "Market-TA.II"
  | "Overclock"
  | "Self-Correcting Assemblers"
  | "Sti.mu"
  | "uPgrade: Capacity.I"
  | "uPgrade: Capacity.II"
  | "uPgrade: Dashboard"
  | "uPgrade: Fulcrum";

/**
 * Corporation material information
 * @public
 */
interface CorpMaterialConstantData {
  /** Name of the material */
  name: CorpMaterialName;
  /** Size of the material */
  size: number;
  demandBase: number;
  /** Min and max demand */
  demandRange: [min: number, max: number];
  competitionBase: number;
  competitionRange: [min: number, max: number];
  baseCost: number;
  maxVolatility: number;
  baseMarkup: number;
}

/**
 * Corporation industry information
 * @public
 */
interface IndustryData {
  /** Industry type */
  type: CorpIndustryName;
  /** Cost to make a new division of this industry type */
  cost: number;
  /** Materials required for production and their amounts */
  requiredMaterials: Record<string, number>;
  /** Materials produced */
  producedMaterials?: string[];
  /** Whether the division makes materials */
  makesMaterials: boolean;
  /** Whether the division makes products */
  makesProducts: boolean;
  /** Product type */
  productType?: string;
}

/**
 * Product in a warehouse
 * @public
 */
interface Product {
  /** Name of the product */
  name: string;
  /** Demand for the product, only present if "Market Research - Demand" unlocked */
  demand: number | undefined;
  /** Competition for the product, only present if "Market Research - Competition" unlocked */
  competition: number | undefined;
  /** Rating based on stats */
  rating: number;
  /** Effective rating in the specific city */
  effectiveRating: number;
  /** Product stats */
  stats: {
    quality: number;
    performance: number;
    durability: number;
    reliability: number;
    aesthetics: number;
    features: number;
  };
  /** Production cost */
  productionCost: number;
  /** Desired sell price, can be "MP+5" */
  desiredSellPrice: string | number;
  /** Desired sell amount, e.g. "PROD/2" */
  desiredSellAmount: string | number;
  /** Amount of product stored in warehouse*/
  stored: number;
  /** Amount of product produced last cycle */
  productionAmount: number;
  /** Amount of product sold last cycle */
  actualSellAmount: number;
  /** A number between 0-100 representing percentage completion */
  developmentProgress: number;
  /** Funds that were spent on advertising the product */
  advertisingInvestment: number;
  /** Funds that were spent on designing the product */
  designInvestment: number;
  /** How much warehouse space is occupied per unit of this product */
  size: number;
  /** A limit on the maximum amount to produce per second */
  productionLimit: number | null;
}

/**
 * Material in a warehouse
 * @public
 */
interface Material {
  /** Name of the material */
  name: CorpMaterialName;
  /** Amount of material  */
  stored: number;
  /** Quality of the material */
  quality: number;
  /** Demand for the material, only present if "Market Research - Demand" unlocked */
  demand: number | undefined;
  /** Competition for the material, only present if "Market Research - Competition" unlocked */
  competition: number | undefined;
  /** Amount of material purchased from the market last cycle */
  buyAmount: number;
  /** Amount of material sold last cycle */
  actualSellAmount: number;
  /** Amount of material produced last cycle */
  productionAmount: number;
  /** Amount of material imported from other divisions last cycle */
  importAmount: number;
  /** Cost to buy material */
  marketPrice: number;
  /** Sell cost, can be "MP+5" */
  desiredSellPrice: string | number;
  /** Sell amount, can be "PROD/2" */
  desiredSellAmount: string | number;
  /** Export orders */
  exports: Export[];
  /** A limit on the maximum amount to produce per second */
  productionLimit: number | null;
}

/**
 * Export order for a material
 * @public
 */
interface Export {
  /** Division the material is being exported to */
  division: string;
  /** City the material is being exported to */
  city: CityName;
  /** Amount of material exported */
  amount: string;
}

/**
 * Warehouse for a division in a city
 * @public
 */
interface Warehouse {
  /** Amount of size upgrade bought */
  level: number;
  /** City in which the warehouse is located */
  city: CityName;
  /** Total space in the warehouse */
  size: number;
  /** Used space in the warehouse */
  sizeUsed: number;
  /** Smart Supply status in the warehouse */
  smartSupplyEnabled: boolean;
}

/**
 * Office for a division in a city.
 * @public
 */
export interface Office {
  /** City of the office */
  city: CityName;
  /** Maximum number of employee */
  size: number;
  /** Maximum amount of energy of the employees */
  maxEnergy: number;
  /** Maximum morale of the employees */
  maxMorale: number;
  /** Amount of employees */
  numEmployees: number;
  /** Average energy of the employees */
  avgEnergy: number;
  /** Average morale of the employees */
  avgMorale: number;
  /** Total experience of all employees */
  totalExperience: number;
  /** Production of the employees */
  employeeProductionByJob: Record<CorpEmployeePosition, number>;
  /** Positions of the employees */
  employeeJobs: Record<CorpEmployeePosition, number>;
}

/**
 * Corporation division
 * @public
 */
interface Division {
  /** Name of the division */
  name: string;
  /** Industry of division, like Agriculture */
  industry: CorpIndustryName;
  /** Awareness of the division */
  awareness: number;
  /** Popularity of the division */
  popularity: number;
  /** Production multiplier */
  productionMult: number;
  /** Amount of research in that division */
  researchPoints: number;
  /** Revenue last cycle */
  lastCycleRevenue: number;
  /** Expenses last cycle */
  lastCycleExpenses: number;
  /** Revenue this cycle */
  thisCycleRevenue: number;
  /** Expenses this cycle */
  thisCycleExpenses: number;
  /** Number of times AdVert has been bought */
  numAdVerts: number;
  /** Cities in which this division has expanded */
  cities: CityName[];
  /** Names of Products developed by this division */
  products: string[];
  /** Whether the industry of this division is capable of developing and producing products */
  makesProducts: boolean;
  /** How many products this division can support */
  maxProducts: number;
}

/**
 * Corporation investment offer
 * @public
 */
interface InvestmentOffer {
  /** Amount of funds you will get from this investment */
  funds: number;
  /** Amount of share you will give in exchange for this investment */
  shares: number;
  /** Current round of funding (max 4) */
  round: number;
}

/**
 * Interface Theme
 * @public
 */
interface UserInterfaceTheme {
  primarylight: string;
  primary: string;
  primarydark: string;
  successlight: string;
  success: string;
  successdark: string;
  errorlight: string;
  error: string;
  errordark: string;
  secondarylight: string;
  secondary: string;
  secondarydark: string;
  warninglight: string;
  warning: string;
  warningdark: string;
  infolight: string;
  info: string;
  infodark: string;
  welllight: string;
  well: string;
  white: string;
  black: string;
  hp: string;
  money: string;
  hack: string;
  combat: string;
  cha: string;
  int: string;
  rep: string;
  disabled: string;
  backgroundprimary: string;
  backgroundsecondary: string;
  button: string;
  maplocation: string;
  bnlvl0: string;
  bnlvl1: string;
  bnlvl2: string;
  bnlvl3: string;
}

/**
 * Interface Styles
 * @public
 */
interface IStyleSettings {
  fontFamily: string;
  fontSize: number;
  tailFontSize: number;
  lineHeight: number;
}

/**
 * Game Information
 * @public
 */
interface GameInfo {
  /**
   * Version as shown in release notes and in the UI. E.g.: "2.8.1"
   *
   * Note that this property does not have the prefix "v". For example, with v2.8.1, this property is "2.8.1".
   */
  version: string;
  /** Internal version number that increments during releases. E.g.: 43 */
  versionNumber: number;
  /** Git commit hash that the release was built from. E.g.: "d0d776700" */
  commit: string;
  /** Platform that the game is running on */
  platform: "Browser" | "Steam";
}

/**
 * Options for opening the code editor
 * @public
 */
interface EditorOptions {
  /**
   * Optional. If true, opens the editor in vim mode. If false, opens the editor in nano mode.
   * If not provided, uses the user's default editor settings
   */
  vim?: boolean;
}

/**
 * Used for autocompletion
 * @public
 */
interface AutocompleteData {
  /**
   * All server hostnames.
   *
   * Some servers are hidden until you satisfy their requirements. This array does not contain those servers if you do
   * not satisfy their requirements.
   */
  servers: string[];
  /** All scripts on the current server */
  scripts: string[];
  /** All text files on the current server */
  txts: string[];
  /** Netscript Enums */
  enums: NSEnums;
  /** Parses the flags schema on the already inputted flags */
  flags(schema: [string, any][]): {
    [key: string]: any;
    _: ScriptArg[];
  };
  /** The hostname of the server the script would be running on */
  hostname: string;
  /** The filename of the script about to be run */
  filename: string;
  /** The processes running on the host */
  processes: ProcessInfo[];
  /**
   * The raw command string that you have typed until you press [Tab] to use the autocomplete feature.
   *
   * For example, if you type `[Space]run test.js[Space][Space][Space][Press tab to use autocomplete]`, "command" will
   * contain all space characters (1 space character before "run" and 3 space characters after ".js").
   */
  command: string;
}

/**
 * Player must have at least this much money.
 * @public
 */
interface MoneyRequirement {
  type: "money";
  money: number;
}
/**
 * Player must have each listed skill at least this level.
 * @public
 */
interface SkillRequirement {
  type: "skills";
  skills: Partial<Skills>;
}
/**
 * Player must have less than this much karma.
 * @public
 */
interface KarmaRequirement {
  type: "karma";
  karma: number;
}
/**
 * Player must have killed at least this many people.
 * @public
 */
interface PeopleKilledRequirement {
  type: "numPeopleKilled";
  numPeopleKilled: number;
}
/**
 * Player must have a specific Literature or Message file on their home computer.
 * @public
 */
interface FileRequirement {
  type: "file";
  file: string;
}
/**
 * Player must have at least this many augmentations installed (if positive).
 * Player must have no augmentations installed (if zero).
 * @public
 */
interface NumAugmentationsRequirement {
  type: "numAugmentations";
  numAugmentations: number;
}
/**
 * Player must be working for this company.
 * @public
 */
interface EmployedByRequirement {
  type: "employedBy";
  company: CompanyName;
}
/**
 * Player must have at least this much reputation with this company.
 * @public
 */
interface CompanyReputationRequirement {
  type: "companyReputation";
  company: CompanyName;
  reputation: number;
}
/**
 * Player must have this job title at some company.
 * @public
 */
interface JobTitleRequirement {
  type: "jobTitle";
  jobTitle: JobName;
}
/**
 * Player must be located in this city.
 * @public
 */
interface CityRequirement {
  type: "city";
  city: CityName;
}
/**
 * Player must be at this location within a city.
 * @public
 */
interface LocationRequirement {
  type: "location";
  location: LocationName;
}
/**
 * Player must have installed a backdoor on this server.
 * @public
 */
interface BackdoorRequirement {
  type: "backdoorInstalled";
  server: string;
}
/**
 * Player's Hacknet devices must have at least this much total RAM.
 * @public
 */
interface HacknetRAMRequirement {
  type: "hacknetRAM";
  hacknetRAM: number;
}
/**
 * Player's Hacknet devices must have at least this many total cores.
 * @public
 */
interface HacknetCoresRequirement {
  type: "hacknetCores";
  hacknetCores: number;
}
/**
 * Player's Hacknet devices must have at least this many total levels.
 * @public
 */
interface HacknetLevelsRequirement {
  type: "hacknetLevels";
  hacknetLevels: number;
}
/**
 * Player must be located in this BitNode.
 * @public
 */
interface BitNodeRequirement {
  type: "bitNodeN";
  bitNodeN: number;
}
/**
 * Player must have this Source File.
 * @public
 */
interface SourceFileRequirement {
  type: "sourceFile";
  sourceFile: number;
}
/**
 * Player must have at least this rank in the Bladeburner Division.
 * @public
 */
interface BladeburnerRankRequirement {
  type: "bladeburnerRank";
  bladeburnerRank: number;
}
/**
 * Player must have completed this many infiltrations.
 * @public
 */
interface NumInfiltrationsRequirement {
  type: "numInfiltrations";
  numInfiltrations: number;
}
/**
 * The sub-condition must not be satisfied.
 * @public
 */
interface NotRequirement {
  type: "not";
  condition: PlayerRequirement;
}
/**
 * At least one sub-condition must be satisfied.
 * @public
 */
interface SomeRequirement {
  type: "someCondition";
  conditions: PlayerRequirement[];
}
/**
 * All sub-conditions must be satisfied.
 * @public
 */
interface EveryRequirement {
  type: "everyCondition";
  conditions: PlayerRequirement[];
}

/**
 * Structured interface to requirements for joining a faction or company.
 * For fields with numerical value \> 0, the player must have at least this value.
 * For fields with numerical value \<= 0, the player must have at most this value.
 * For "not", the sub-condition must be failed instead of passed.
 * For "someCondition", at least one sub-condition must be passed.
 * @public
 * @returns - An object representing one requirement.
 */
export type PlayerRequirement =
  | MoneyRequirement
  | SkillRequirement
  | KarmaRequirement
  | PeopleKilledRequirement
  | FileRequirement
  | NumAugmentationsRequirement
  | EmployedByRequirement
  | CompanyReputationRequirement
  | JobTitleRequirement
  | CityRequirement
  | LocationRequirement
  | BackdoorRequirement
  | HacknetRAMRequirement
  | HacknetCoresRequirement
  | HacknetLevelsRequirement
  | BitNodeRequirement
  | SourceFileRequirement
  | BladeburnerRankRequirement
  | NumInfiltrationsRequirement
  | NotRequirement
  | SomeRequirement
  | EveryRequirement;