@robota-sdk/tools/README.md

⚠️ DEPRECATED: This package has been deprecated. Please use @robota-sdk/agents instead.

# @robota-sdk/tools

⚠️ **DEPRECATED - This package has been deprecated**

This package has been **deprecated** and is no longer maintained. All tool functionality has been integrated into `@robota-sdk/agents`.

## Migration Guide

Please migrate to `@robota-sdk/agents` for the latest tool management features:

### Before (deprecated)
```typescript
import { createZodFunctionToolProvider } from '@robota-sdk/tools';
import { Robota } from '@robota-sdk/core';

const toolProvider = createZodFunctionToolProvider({
  tools: {
    getWeather: {
      schema: weatherSchema,
      handler: weatherHandler
    }
  }
});

const robota = new Robota({ provider: toolProvider });
```

### After (recommended)
```typescript
import { createZodFunctionTool, Robota } from '@robota-sdk/agents';
import { OpenAIProvider } from '@robota-sdk/openai';

const weatherTool = createZodFunctionTool(
  'getWeather',
  'Get weather information',
  weatherSchema,
  weatherHandler
);

const robota = new Robota({
  name: 'MyAgent',
  aiProviders: [new OpenAIProvider({ apiKey: 'sk-...' })],
  defaultModel: {
    provider: 'openai',
    model: 'gpt-4'
  },
  tools: [weatherTool]
});
```

## What's Changed

- **Function Tools**: Now `createZodFunctionTool` in `@robota-sdk/agents`
- **Tool Registry**: Integrated into agent system
- **Tool Validation**: Enhanced with better error handling
- **Tool Execution**: Improved performance and reliability
- **MCP Tools**: Available through `@robota-sdk/agents`

## Installation

**⚠️ Do not install this package for new projects**

For existing projects, migrate to:
```bash
npm install @robota-sdk/agents
```

## Key Migration Changes

| Old (@robota-sdk/tools) | New (@robota-sdk/agents) |
|-------------------------|--------------------------|
| `createZodFunctionToolProvider` | `createZodFunctionTool` |
| `createMcpToolProvider` | `createMcpToolProvider` |
| Tool providers | Individual tools |
| Separate package | Integrated into agents |

## Documentation

- [Tool Migration Guide](https://robota.io/migration/tools)
- [Tool Documentation](https://robota.io/docs/tools)
- [API Reference](https://robota.io/api/agents/tools)

## Support

This package will no longer receive updates. Please use `@robota-sdk/agents` instead.

## License

MIT