SDKs Overview - BeforeQuery

All SDKs authenticate with client keys and default to the public API at https://api.agents.beforequery.com. Every package accepts a baseUrl override — use http://localhost:8280 when developing against a local API server.

@beforequery/sdk

Core TypeScript SDK — streaming chat, search, feedback. Browsers, React Native, Node.js 18+.

@beforequery/react

<BeforeQueryChat /> component and the headless useBeforeQueryChat hook.

@beforequery/widget

Embeddable Ask AI launcher/modal, hosted at widget.beforequery.com, plus the form deflector.

@beforequery/agents

Agent SDK — runAgent, defineAgent graphs, MCP and A2A clients, self-hosted runtime.

Install

npm install @beforequery/sdk        # core client
npm install @beforequery/react      # + React components (peer: @beforequery/sdk)
npm install @beforequery/widget     # widget as a package (or use the hosted script tag)
npm install @beforequery/agents     # agent platform

Credentials at a glance

Environment	Credential	Option
Browser / mobile	Public key `bq_pk_…`	`clientKey`
Server (Node.js)	`bq_ci_…` + `bq_cs_…`	`clientId` + `clientSecret`

Never ship clientId/clientSecret in browser or mobile code. The SDKs emit a console.warn if secret credentials are detected in a browser environment.

@beforequery/sdk

@beforequery/react

@beforequery/widget

@beforequery/agents

​Install

​Credentials at a glance

Install

Credentials at a glance