---
sidebar_position: 4
title: Changelog
description: Release history and version notes for the Firetell Node.js / TypeScript Server SDK (@firetell/firetell-node-sdk).
---

# Changelog

All notable changes to the [`@firetell/firetell-node-sdk`](https://www.npmjs.com/package/@firetell/firetell-node-sdk) package are documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

---

## [1.0.0] - 2026-11-19

### Added

- Initial release of `@firetell/firetell-node-sdk` (MIT license) for Node.js `>= 18.0.0` (ESM & CommonJS) and TypeScript.
- Server-to-server authentication via Workspace Domain and API Secret Key (`Authorization: ApiKey <secretKey>`).
- Full coverage of 20 Firetell Workspace API resources:
  - `workspace`, `agents`, `teams`, `calls`, `messages`, `recordings`, `transcriptions`
  - `voiceAgents` (including `voiceAgents.tools`), `knowledgeBases` (including `knowledgeBases.documents`)
  - `phoneNumbers`, `sipAccounts`, `extensions`, `audios`, `webhooks`, `contacts`, `addressBooks`, `callFlows`, `invoices`, `auditLogs`, `creditTransactions`
- Zero runtime dependencies using native Node.js `fetch`, `FormData`, `Blob`, and `node:crypto`.
- Typed error hierarchy (`FiretellError`, `FiretellValidationError`, `FiretellAuthenticationError`, `FiretellRateLimitError`, etc.) with automatic retries on `429` / `5xx` / transient network errors.
- HMAC-SHA256 webhook signature verification helpers (`verifyWebhookSignature` and `constructWebhookEvent`).
