{"_id":"@belarabyai/a2abase","_rev":"2-40777670be5706b5050511684bb986d8","name":"@belarabyai/a2abase","dist-tags":{"latest":"1.0.3"},"versions":{"1.0.2":{"name":"@belarabyai/a2abase","version":"1.0.2","keywords":["baseai","ai","sdk","typescript","javascript","agent","llm"],"author":{"name":"BelArabyAI"},"license":"MIT","_id":"@belarabyai/a2abase@1.0.2","maintainers":[{"name":"belarabyai","email":"mk@belaraby.com"}],"homepage":"https://github.com/A2ABaseAI/sdks","bugs":{"url":"https://github.com/A2ABaseAI/sdks/issues"},"dist":{"shasum":"edc4c46f7260c715ddf17455e88e011943c17471","tarball":"https://registry.npmjs.org/@belarabyai/a2abase/-/a2abase-1.0.2.tgz","fileCount":68,"integrity":"sha512-U2OSOOdU4Sd5AcoZagDji0SJ9lckxOxJFsmL5yOLybzsQVwX9H2KlejJdNLikvsPesjuqVi2GZtmeH+90gmtyA==","signatures":[{"sig":"MEUCIQDPl2k81nSosmUxNIfgpnsyyeNDsMX7+aHwaLEgYKqewQIgXxEVs4K+y/H9W0pdXczA9j+wrNuaZ6IzOewFmOA7lK8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":154776},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"2f7317e355837821f23474dc7154dda5e80672b1","scripts":{"test":"jest","build":"tsc","test:e2e":"jest tests/e2e.test.ts","test:coverage":"jest --coverage","prepublishOnly":"npm run build"},"support":"https://discord.gg/qAncfHmYUm","_npmUser":{"name":"belarabyai","email":"mk@belaraby.com"},"repository":{"url":"git+https://github.com/A2ABaseAI/sdks.git","type":"git","directory":"typescript"},"_npmVersion":"11.6.0","description":"A2ABase SDK for TypeScript/JavaScript","directories":{},"_nodeVersion":"24.8.0","dependencies":{"undici":"^6.0.0"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","ts-jest":"^29.4.5","typescript":"^5.0.0","@types/jest":"^29.5.14","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/a2abase_1.0.2_1763344291928_0.8044210722769165","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@belarabyai/a2abase","version":"1.0.3","description":"A2ABase SDK for TypeScript/JavaScript","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc","test":"jest","test:coverage":"jest --coverage","test:e2e":"jest tests/e2e.test.ts","prepublishOnly":"npm run build"},"keywords":["baseai","ai","sdk","typescript","javascript","agent","llm"],"author":{"name":"BelArabyAI"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/A2ABaseAI/sdks.git","directory":"typescript"},"homepage":"https://github.com/A2ABaseAI/sdks","bugs":{"url":"https://github.com/A2ABaseAI/sdks/issues"},"support":"https://discord.gg/qAncfHmYUm","engines":{"node":">=18.0.0"},"dependencies":{"undici":"^6.0.0"},"devDependencies":{"@types/jest":"^29.5.14","@types/node":"^20.0.0","jest":"^29.7.0","ts-jest":"^29.4.5","typescript":"^5.0.0"},"_id":"@belarabyai/a2abase@1.0.3","gitHead":"2f7317e355837821f23474dc7154dda5e80672b1","_nodeVersion":"24.8.0","_npmVersion":"11.6.0","dist":{"integrity":"sha512-qWQSaV5TsIXO9pJWMj4243prVwhXbmKXaFQbn6ntvm0m4B5aieIh6zP6W6vrVnFJpqEyGGRSrSQRujzivkPquw==","shasum":"98d7eceef1f88c072e7e4bbe284beca14a444dd3","tarball":"https://registry.npmjs.org/@belarabyai/a2abase/-/a2abase-1.0.3.tgz","fileCount":68,"unpackedSize":159777,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIBYN2ItHIwA8nkSjwna/+8yUsGzr/9dW9oG7s0q75i0NAiA65B38T6cJdLeblCKEnKjz/9Wy+BK/B1SprJiDE3SSxQ=="}]},"_npmUser":{"name":"belarabyai","email":"mk@belaraby.com"},"directories":{},"maintainers":[{"name":"belarabyai","email":"mk@belaraby.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/a2abase_1.0.3_1763344812759_0.18672489240628365"},"_hasShrinkwrap":false}},"time":{"created":"2025-11-17T01:51:31.716Z","modified":"2025-11-17T02:00:13.156Z","1.0.2":"2025-11-17T01:51:32.120Z","1.0.3":"2025-11-17T02:00:12.954Z"},"bugs":{"url":"https://github.com/A2ABaseAI/sdks/issues"},"author":{"name":"BelArabyAI"},"license":"MIT","homepage":"https://github.com/A2ABaseAI/sdks","keywords":["baseai","ai","sdk","typescript","javascript","agent","llm"],"repository":{"type":"git","url":"git+https://github.com/A2ABaseAI/sdks.git","directory":"typescript"},"description":"A2ABase SDK for TypeScript/JavaScript","maintainers":[{"name":"belarabyai","email":"mk@belaraby.com"}],"readme":"# A2ABaseAI TypeScript/JavaScript SDK\n\n
\n \n
\n\n
\n One import: tools, auth, sandboxes and deployment included.\n
\n\n
\n \n \n \n \n
\n\n---\n\n> A2ABaseAI TypeScript/JavaScript SDK for building and shipping production grade AI agents. \n> One line gives you access to 50+ tools, 300+ integrations, and all major LLMs through a single unified platform.\n\nA2ABaseAI SDK handles authentication, tool execution, sandboxes, and integrations so you can stay focused on agent logic. \nBring your own tool subscriptions or use ours. Migrate between providers without touching your agent code.\n\n## 🔍 What is A2ABaseAI SDK?\n\n```typescript\nimport { A2ABaseTool } from '@belarabyai/a2abase';\n\n// Hundreds of ready to use integration and tools for agents\nconst tool = A2ABaseTool.*;\n```\n\n- One import gives your agents access to a large tool catalog \n- One API key unlocks better rates with the providers you already use \n- Ship faster with batteries included workflows, sandboxes, and deployments \n\n## 🔑 Get your API key\n\n1. Sign up at **[A2ABaseAI Dashboard](https://a2abase.ai/settings/api-keys)**\n2. Create an API key\n3. Set it locally\n\n```bash\nexport BASEAI_API_KEY=\"pk_xxx:sk_xxx\"\n```\n\n**Install**: `npm install @belarabyai/a2abase`\n\nYou are ready to build.\n\n### Core capabilities\n\n- Agent and workflow management \n- Tool orchestration and execution \n- Secure sandboxes for code, shells, and browsers \n- Long term knowledge and document storage \n- Deep integration library through MCP \n\nThe SDK exposes high level concepts: `A2ABase` (main client), `Agent`, `Thread`, `Run`, and `A2ABaseTool`.\n\n## 📊 Tool categories at a glance\n\n| Category | Examples | Primary use cases |\n| ---------------------- | -------------------------------------------------- | -------------------------------------------|\n| File and workspace | Files, Upload, Knowledge Base | Code, docs, configs, retrieval |\n| Development | Shell, Web Dev, Deploy, Expose | Build and ship apps from inside agents |\n| Web and browser | Browser, Advanced Browser, Web Search, Image Search| Scraping, research, end to end automation |\n| Content creation | Docs, Sheets, Presentations, Design | Reports, decks, dashboards, creative work |\n| AI and vision | Vision, Image Edit | Screenshot analysis, visual agents |\n| Data and integrations | Data Providers, MCP integrations | Connect SaaS, CRMs, clouds, and databases |\n| Search | People Search, Company Search | Prospecting and enrichment |\n| System automation | Computer Automation | GUI and desktop control |\n\nFor the complete tool reference see the SDK specific docs.\n\n## ✅ The A2ABaseAI solution\n\n**One SDK. One API key. Everything wired together.**\n\n- ✅ 50+ built in tools \n Web search, browser control, files, web dev, docs, sheets, presentations, vision, images, and more \n- ✅ 300+ MCP integrations \n Connect Gmail, Slack, GitHub, Notion, CRMs, databases, cloud, and hundreds of services \n- ✅ All major LLMs behind one interface \n Swap models and providers without touching your agent code \n- ✅ Secure, isolated sandboxes \n Run code, shells, browsers, and tools in contained environments \n- ✅ Pay as you go \n Only pay for what runs. No platform lock in, no per seat fees \n- ✅ Type safe SDK \n Full IntelliSense and autocomplete in TypeScript \n\nNo More:\n- ❌ Juggling 10+ API keys and accounts \n- ❌ Gluing together multiple SDKs and libraries \n- ❌ Hunting for the right tools and benchmarking them \n- ❌ Writing fragile one off integrations \n- ❌ Owning all auth and security yourself \n- ❌ Paying for a pile of separate subscriptions \n\n**Install one SDK, call one client, ship a working agent in minutes.**\n\n## 🚀 Quick start\n\n```typescript\nimport { A2ABase } from '@belarabyai/a2abase';\nimport { A2ABaseTool } from '@belarabyai/a2abase';\n\nasync function main() {\n const apiKey = process.env.BASEAI_API_KEY;\n if (!apiKey) {\n throw new Error('Please set BASEAI_API_KEY environment variable');\n }\n\n const client = new A2ABase({\n apiKey,\n apiUrl: 'https://a2abase.ai/api',\n });\n\n const thread = await client.Thread.create();\n const agent = await client.Agent.create({\n name: 'My Assistant',\n systemPrompt: 'You are a helpful AI assistant.',\n a2abaseTools: [A2ABaseTool.WEB_SEARCH_TOOL],\n });\n\n const run = await agent.run('Hello, how are you?', thread);\n const stream = await run.getStream();\n\n for await (const chunk of stream) {\n process.stdout.write(chunk);\n }\n}\n\nmain();\n```\n\n## 🛠 Tooling overview\n\nThe SDK exposes a unified tool enum (`A2ABaseTool`) that covers the full tool catalog.\n\nInstead of configuring dozens of separate tools, you enable categories and get a coherent surface:\n\n### File and workspace\n\n- File operations: create, read, edit, rewrite, delete \n- Upload files into the sandbox workspace \n- Knowledge base with semantic search, sync, and long term memory \n\nTypical uses: codegen, configuration files, document workflows, retrieval for agents.\n\n### Development and deployment\n\n- Shell tools in isolated environments \n- Web dev tools for React, Next.js, Vite, and shadcn based apps \n- Deployment helpers and port exposure for preview links \n\nTypical uses: build agents that scaffold apps, run migrations, deploy small services.\n\n### Web and browser automation\n\n- Standard web search and scraping \n- Browser automation with full DOM control \n- Multi tab flows, form filling, scrolling, screenshots \n\nTypical uses: research agents, competitor intelligence, test runners, web workflows.\n\n### Content and productivity\n\n- Docs, sheets, and presentations \n- Design and image editing tools \n- Presentation outlines and structured content planning \n\nTypical uses: report writers, slide generators, internal tooling, marketing assistants.\n\n### AI and vision\n\n- Vision tools for screenshots and document images \n- Image generation and editing \n\nTypical uses: UI review, PDF parsing, creative image agents.\n\n### Data and integrations\n\nThrough data provider tools and MCP you can connect to:\n\n- Productivity: Gmail, Calendar, Slack, Notion, Linear, Asana, Jira, Trello \n- Dev and cloud: GitHub, GitLab, Bitbucket, Docker Hub, AWS, GCP, Azure \n- CRM and sales: Salesforce, HubSpot, Pipedrive, Zoho, Intercom \n- Data and storage: Google Sheets, Drive, Dropbox, MongoDB, Postgres, MySQL \n- Marketing and social: X, LinkedIn, Facebook, Instagram, Mailchimp, SendGrid \n- Commerce and payments: Shopify, Stripe, PayPal, WooCommerce, Square \n\nPlug in via Composio MCP servers or your own MCP endpoints. \nA2ABaseAI manages auth, credentials, and routing for you.\n\n### Search and automation\n\n- People search and company search for lead gen and enrichment \n- Computer and desktop automation for full system level workflows \n\n## 📚 Examples\n\nThe SDK ships with real world examples in `./example/`.\n\nRun examples:\n\n```bash\n# TypeScript\nnpm install\nnpm run build\nnode dist/example/.js\n```\n\n## 📖 Documentation\n\n- [TypeScript SDK docs](./README.md) \n- [GitHub Repository](https://github.com/A2ABaseAI/sdks) \n\n## 💬 Support\n\n- Discord: https://discord.gg/qAncfHmYUm \n\nBug reports and feature requests are welcome through GitHub issues.\n\n## 🤝 Contributing\n\nContributions are welcome.\n\n- Open an issue to discuss larger changes \n- Submit pull requests for bug fixes or new examples \n- Follow the style and lint rules for the SDK \n\n## 📄 License\n\nReleased under the **MIT License**. \nSee `LICENSE` for full details.\n","readmeFilename":"README.md"}
![\"A2ABaseAI\"](\"https://a2abase.ai/belarabyai-symbol.svg\")
\n![\"npm\"](\"https://img.shields.io/npm/v/@belarabyai/a2abase?label=TypeScript%20SDK\")
![\"API](\"https://img.shields.io/badge/API-Key%20Dashboard-blue\"){kind=icon}
![\"Open](\"https://img.shields.io/badge/status-open%20source-success\"){kind=icon}
![\"MIT](\"https://img.shields.io/badge/license-MIT-lightgrey\"){kind=icon}