A2ABaseAI TypeScript/JavaScript SDK

A2ABaseAI TypeScript/JavaScript SDK for building and shipping production grade AI agents.
One line gives you access to 50+ tools, 300+ integrations, and all major LLMs through a single unified platform.

A2ABaseAI SDK handles authentication, tool execution, sandboxes, and integrations so you can stay focused on agent logic.
Bring your own tool subscriptions or use ours. Migrate between providers without touching your agent code.

🔍 What is A2ABaseAI SDK?

import { A2ABaseTool } from '@belarabyai/a2abase';

// Hundreds of ready to use integration and tools for agents
const tool = A2ABaseTool.*;

• One import gives your agents access to a large tool catalog
• One API key unlocks better rates with the providers you already use
• Ship faster with batteries included workflows, sandboxes, and deployments

🔑 Get your API key

1. Sign up at A2ABaseAI Dashboard
2. Create an API key
3. Set it locally

export BASEAI_API_KEY="pk_xxx:sk_xxx"

Install: npm install @belarabyai/a2abase

You are ready to build.

Core capabilities

• Agent and workflow management
• Tool orchestration and execution
• Secure sandboxes for code, shells, and browsers
• Long term knowledge and document storage
• Deep integration library through MCP

The SDK exposes high level concepts: A2ABase (main client), Agent, Thread, Run, and A2ABaseTool.

📊 Tool categories at a glance

| Category | Examples | Primary use cases | | ---------------------- | -------------------------------------------------- | -------------------------------------------| | File and workspace | Files, Upload, Knowledge Base | Code, docs, configs, retrieval | | Development | Shell, Web Dev, Deploy, Expose | Build and ship apps from inside agents | | Web and browser | Browser, Advanced Browser, Web Search, Image Search| Scraping, research, end to end automation | | Content creation | Docs, Sheets, Presentations, Design | Reports, decks, dashboards, creative work | | AI and vision | Vision, Image Edit | Screenshot analysis, visual agents | | Data and integrations | Data Providers, MCP integrations | Connect SaaS, CRMs, clouds, and databases | | Search | People Search, Company Search | Prospecting and enrichment | | System automation | Computer Automation | GUI and desktop control |

For the complete tool reference see the SDK specific docs.

✅ The A2ABaseAI solution

One SDK. One API key. Everything wired together.

• ✅ 50+ built in tools
  Web search, browser control, files, web dev, docs, sheets, presentations, vision, images, and more
• ✅ 300+ MCP integrations
  Connect Gmail, Slack, GitHub, Notion, CRMs, databases, cloud, and hundreds of services
• ✅ All major LLMs behind one interface
  Swap models and providers without touching your agent code
• ✅ Secure, isolated sandboxes
  Run code, shells, browsers, and tools in contained environments
• ✅ Pay as you go
  Only pay for what runs. No platform lock in, no per seat fees
• ✅ Type safe SDK
  Full IntelliSense and autocomplete in TypeScript

No More:

• ❌ Juggling 10+ API keys and accounts
• ❌ Gluing together multiple SDKs and libraries
• ❌ Hunting for the right tools and benchmarking them
• ❌ Writing fragile one off integrations
• ❌ Owning all auth and security yourself
• ❌ Paying for a pile of separate subscriptions

Install one SDK, call one client, ship a working agent in minutes.

🚀 Quick start

import { A2ABase } from '@belarabyai/a2abase';
import { A2ABaseTool } from '@belarabyai/a2abase';

async function main() {
  const apiKey = process.env.BASEAI_API_KEY;
  if (!apiKey) {
    throw new Error('Please set BASEAI_API_KEY environment variable');
  }

  const client = new A2ABase({
    apiKey,
    apiUrl: 'https://a2abase.ai/api',
  });

  const thread = await client.Thread.create();
  const agent = await client.Agent.create({
    name: 'My Assistant',
    systemPrompt: 'You are a helpful AI assistant.',
    a2abaseTools: [A2ABaseTool.WEB_SEARCH_TOOL],
  });

  const run = await agent.run('Hello, how are you?', thread);
  const stream = await run.getStream();

  for await (const chunk of stream) {
    process.stdout.write(chunk);
  }
}

main();

🛠 Tooling overview

The SDK exposes a unified tool enum (A2ABaseTool) that covers the full tool catalog.

Instead of configuring dozens of separate tools, you enable categories and get a coherent surface:

File and workspace

• File operations: create, read, edit, rewrite, delete
• Upload files into the sandbox workspace
• Knowledge base with semantic search, sync, and long term memory

Typical uses: codegen, configuration files, document workflows, retrieval for agents.

Development and deployment

• Shell tools in isolated environments
• Web dev tools for React, Next.js, Vite, and shadcn based apps
• Deployment helpers and port exposure for preview links

Typical uses: build agents that scaffold apps, run migrations, deploy small services.

Web and browser automation

• Standard web search and scraping
• Browser automation with full DOM control
• Multi tab flows, form filling, scrolling, screenshots

Typical uses: research agents, competitor intelligence, test runners, web workflows.

Content and productivity

• Docs, sheets, and presentations
• Design and image editing tools
• Presentation outlines and structured content planning

Typical uses: report writers, slide generators, internal tooling, marketing assistants.

AI and vision

• Vision tools for screenshots and document images
• Image generation and editing

Typical uses: UI review, PDF parsing, creative image agents.

Data and integrations

Through data provider tools and MCP you can connect to:

• Productivity: Gmail, Calendar, Slack, Notion, Linear, Asana, Jira, Trello
• Dev and cloud: GitHub, GitLab, Bitbucket, Docker Hub, AWS, GCP, Azure
• CRM and sales: Salesforce, HubSpot, Pipedrive, Zoho, Intercom
• Data and storage: Google Sheets, Drive, Dropbox, MongoDB, Postgres, MySQL
• Marketing and social: X, LinkedIn, Facebook, Instagram, Mailchimp, SendGrid
• Commerce and payments: Shopify, Stripe, PayPal, WooCommerce, Square

Plug in via Composio MCP servers or your own MCP endpoints.
A2ABaseAI manages auth, credentials, and routing for you.

Search and automation

• People search and company search for lead gen and enrichment
• Computer and desktop automation for full system level workflows

📚 Examples

The SDK ships with real world examples in ./example/.

Run examples:

# TypeScript
npm install
npm run build
node dist/example/<name>.js

📖 Documentation

• TypeScript SDK docs
• GitHub Repository

💬 Support

• Discord: https://discord.gg/qAncfHmYUm

Bug reports and feature requests are welcome through GitHub issues.

🤝 Contributing

Contributions are welcome.

• Open an issue to discuss larger changes
• Submit pull requests for bug fixes or new examples
• Follow the style and lint rules for the SDK

📄 License

Released under the MIT License.
See LICENSE for full details.