open-index/open-npm huggingface dataset:
npm package: @alex-ai/tools
Description: A modular collection of utility tools for Node.js and TypeScript, designed to power agent-based applications and automation workflows. Part of the [alex-ai](https://github.com/Alex-AI-Systems) ecosystem.
Latest version: 0.0.5

# @alex-ai/tools

A modular collection of utility tools for Node.js and TypeScript, designed to power agent-based applications and automation workflows. Part of the [alex-ai](https://github.com/Alex-AI-Systems) ecosystem.

## Features

- **Weather**: Fetch current weather data for any location.
- **Home Assistant**: Integrate with Home Assistant for smart home control.
- **Random Number**: Generate random numbers.
- **Fetch**: HTTP requests made simple.
- **Discord**: Utilities for Discord bots and integrations.
- **Delay**: Add delays/waits in your flows.
- **Date**: Date and time utilities.
- **Command Execution**: Run shell commands safely from Node.js.
- **Web Scraping**: Tools to scrape and parse web content.
- **File Utilities**: File system helpers.

All tools are built with strong typing using [zod](https://github.com/colinhacks/zod) schemas, making them safe and easy to use in TypeScript projects.

## Installation

```bash
npm install @alex-ai/tools
```

## Usage

```ts
import { weatherTool, fetchTool, delayTool } from '@alex-ai/tools';

// Example usage of the weather tool:
const getWeather = weatherTool({ weatherApiKey: 'YOUR_API_KEY' });
const result = await getWeather.execute({ location: 'London' });
console.log(result);
```

Each tool is exported as a factory function or utility. See individual tool documentation or source code for details on input/output schemas.

## Tools Overview

| Tool            | Description                                 |
|-----------------|---------------------------------------------|
| `weatherTool`   | Get current weather by location             |
| `homeAssistant` | Control Home Assistant devices              |
| `randomNumber`  | Generate random numbers                     |
| `fetchTool`     | Perform HTTP requests                       |
| `discordTool`   | Discord bot utilities                       |
| `delayTool`     | Delay execution                             |
| `dateTool`      | Date/time helpers                           |
| `cmdTool`       | Execute shell commands                      |
| `scrapingTools` | Web scraping utilities                      |
| `filesTools`    | File system operations                      |