Tools SDK

import { RunTools } from '@runtools/sdk';

const rt = new RunTools({ apiKey: process.env.RUNTOOLS_API_KEY });

// List installed tools
const tools = await rt.tools.list();

// List marketplace tools
const marketplace = await rt.marketplace.list();

// Filter by category
const emailTools = await rt.marketplace.list({ 
  category: 'communication' 
});

// Search
const results = await rt.marketplace.search('send notification');

// Install from marketplace
await rt.tools.install('gmail');
await rt.tools.install('slack');
await rt.tools.install('github');
await rt.tools.install('discord');
await rt.tools.install('google-calendar');
await rt.tools.install('google-sheets');
await rt.tools.install('outlook');
await rt.tools.install('x-twitter');
await rt.tools.install('linkedin');
await rt.tools.install('telegram');

// Check if installed
const isInstalled = await rt.tools.isInstalled('gmail');

// Manual credentials
await rt.tools.configure('github', {
  token: process.env.GITHUB_TOKEN,
});

// OAuth flow (opens browser, connects account)
await rt.tools.configureOAuth('gmail');
await rt.tools.configureOAuth('slack');
await rt.tools.configureOAuth('google-calendar');

// Send email via Gmail
const result = await rt.tools.execute('gmail', {
  action: 'send_email',
  params: {
    to: 'user@example.com',
    subject: 'Hello from RunTools',
    body: 'This email was sent via the Tools API!',
  },
});

// Post to Slack
await rt.tools.execute('slack', {
  action: 'post_message',
  params: {
    channel: '#general',
    text: 'Hello from RunTools!',
  },
});

// Create GitHub issue
await rt.tools.execute('github', {
  action: 'create_issue',
  params: {
    repo: 'myorg/myrepo',
    title: 'Bug report',
    body: 'Description of the bug...',
  },
});

await rt.tools.uninstall('gmail');

import type {
  Tool,
  ToolConfig,
  ToolExecuteResult,
  MarketplaceTool,
} from '@runtools/sdk';