> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TypeScript Toolset

> Build connected agents with StackOne's TypeScript AI SDK & Toolset

Build AI agents that connect to Salesforce, Workday, Slack, Gmail, HubSpot, and 200+ other business systems. The TypeScript SDK integrates with OpenAI Functions and Vercel AI SDK, giving your agents the ability to read employee data, post messages, manage files, and more.

<Tip>
  **Not sure if the AI Toolset (SDK) is right for you?** Check out our [Agent Protocols Guide](/guides/calling-stackone-actions) to understand when to use AI Toolset (SDK) vs MCP vs A2A.
</Tip>

## Why StackOne?

<CardGroup cols={2}>
  <Card title="200+ Providers" icon="plug">Connect to Salesforce, Workday, Slack, Gmail, and more through one SDK</Card>
  <Card title="Multi-Tenant" icon="users">Built-in customer isolation with `account_id` for each connection</Card>
  <Card title="AI-Native" icon="robot">Tools designed for LLM function calling and agent frameworks</Card>
  <Card title="Consistent Data" icon="database">Normalized schemas: no provider-specific parsing needed</Card>
</CardGroup>

## How It Works

<Frame>
  <img src="https://mintcdn.com/stackone-60/wxt0YMtfLgBtb0Lo/images/agents/architecture-diagram.svg?fit=max&auto=format&n=wxt0YMtfLgBtb0Lo&q=85&s=254358a83f3c214f7ab4f4749cc632e7" alt="StackOne Architecture" width="800" height="320" data-path="images/agents/architecture-diagram.svg" />
</Frame>

Your agent connects to StackOne, which handles authentication and data normalization for 200+ SaaS providers like Salesforce, Workday, Slack, and more.

| Component          | Description                                                                |
| ------------------ | -------------------------------------------------------------------------- |
| **Your Agent**     | Built with LangChain, CrewAI, OpenAI, Vercel AI, or any framework          |
| **StackOne**       | AI Integration Gateway: handles auth, transforms data, manages connections |
| **SaaS Providers** | Salesforce, Workday, Greenhouse, Slack, Gmail, HubSpot, and 200+ more      |

## Key Concepts

* **Initialize a ToolSet**: Create a `StackOneToolSet` instance to access tools for providers like Workday, Greenhouse, Slack, and more
* **Filter Tools**: Use provider glob patterns like `workday_*`, `slack_*`, or `salesforce_*` to get specific tool sets
* **Execute Tools**: Call provider APIs through StackOne tool interfaces: list employees, send messages, create tickets
* **Multi-Tenant**: Each tool execution requires an `accountId` to identify which customer's account to access

## TypeScript Framework Integrations

<CardGroup cols={2}>
  <Card title="OpenAI Integration" href="/agents/typescript/frameworks/openai-integration" icon="https://mintcdn.com/stackone-60/zRAvvofCYLmP9UF6/images/agents/openai-logo.svg?fit=max&auto=format&n=zRAvvofCYLmP9UF6&q=85&s=a38c135695435b960bc6b40052de4ad0" width="16" height="16" data-path="images/agents/openai-logo.svg">
    Build agents with OpenAI Functions
  </Card>

  <Card title="Vercel AI SDK" href="/agents/typescript/frameworks/vercel-ai-sdk" icon="https://mintcdn.com/stackone-60/Sj5Uq6vhX_QV0uhL/images/agents/vercel-logo.svg?fit=max&auto=format&n=Sj5Uq6vhX_QV0uhL&q=85&s=5b45db3b36ee27b056e5e0baa82ca2da" width="58" height="50" data-path="images/agents/vercel-logo.svg">
    Use with Vercel's AI SDK for streaming and tool calls
  </Card>
</CardGroup>

## TypeScript Core Features

<CardGroup cols={2}>
  <Card title="Tool Filtering" href="/agents/typescript/tool-filtering" icon="filter">
    Advanced glob pattern filtering for tool selection
  </Card>

  <Card title="Tool Search" href="/agents/typescript/tool-search" icon="magnifying-glass">
    Discover tools using natural language queries
  </Card>

  <Card title="Installation" href="/agents/typescript/installation" icon="download">
    Set up the TypeScript SDK
  </Card>

  <Card title="Basic Usage" href="/agents/typescript/basic-usage" icon="play">
    Core concepts and fundamental usage patterns
  </Card>
</CardGroup>

## TypeScript-Specific Features

* **Type Safety**: Full TypeScript support with comprehensive type definitions
* **Framework Support**: Native integrations with OpenAI, Vercel AI SDK, and more
* **File Handling**: Built-in support for file uploads and transformations

## Next Steps

1. [Build your first OpenAI agent](/agents/typescript/frameworks/openai-integration)
2. [Learn about tool filtering](/agents/typescript/tool-filtering)
3. [Explore Tool Search](/agents/typescript/tool-search)

## Resources

* **[GitHub Repository](https://github.com/StackOneHQ/stackone-ai-node)**: Complete source code and examples
* **[Examples](https://github.com/StackOneHQ/stackone-ai-node/tree/main/examples)**: OpenAI integration, semantic search, and file uploads
* **[Issues](https://github.com/StackOneHQ/stackone-ai-node/issues)**: Report bugs or request features
* **[NPM Package](https://www.npmjs.com/package/@stackone/ai)**: Package details and version history