integrations/vapi/v0.1.0

firecrawl/pdf-inspectorintegrations/vapi/v0.1.0Sep 21, 2026by het0814

Upgrading?

AI Summary

First release of memanto-vapi, a webhook service that provides voice agents with memory capabilities between calls, supporting per-caller memory scopes and automated lesson extraction.

Key Highlights

  • First release of the Vapi memory integration with support for shared and caller-scoped memory.
  • Includes mid-call tools (`memanto_recall` and `memanto_remember`) for real-time memory access.
  • Automated lesson extraction from call summaries after each conversation.
  • Comprehensive test suite covering authentication, timeouts, and malformed payloads.

New Features

  • Memory injection at call start via `{{memanto_context}}` variable.
  • Caller-scoped memory using HMAC salted phone numbers or customer IDs.
  • Background processing for post-call learning with retry logic.

Full Release Notes

# Release Notes for memanto-vapi v0.1.0

First release of `memanto-vapi`: a single webhook that gives a Vapi voice agent memory between calls. The agent gets your organization's knowledge and the lessons it learned on earlier calls, with optional per-caller memory.

## New Featuresper-caller memory.

## New Features
- **Memory at call start** (`memanto_vapi/memory.py`)
  - Replies to `assistant-request` with `{{memanto_context}}`, filled from recent and relevant memories.
  - Lookup is capped at 3s (Vapi allows 7.5s); if it times out or fails, the call starts without memory.
- **Mid-call tools** (`memanto_vapi/tools.py`)
  - `memanto_recall` and `memanto_remember` function tools. `memanto-vapi tools --server-url …` prints the JSON to create them with Vapi's `POST /tool`.
- **Learning after each call**
  - On `end-of-call-report`, lessons are pulled from the conversation (mistakes, corrections, better answers, business facts) using Vapi's summary and success evaluation. This runs in the background after the webhook replies.
  - A Vapi retry of the same report is skipped (`retained-<call id>` tag).
- **Two scopes** (`MEMANTO_VAPI_SCOPE`)
  - `shared` (default): one memory for the whole assistant, with no caller details stored.
  - `caller`: adds memory private to each caller, tagged with a salted HMAC of their phone number or `customer.externalId`. Raw numbers are never stored, and the server decides whose memory a call can read or write.
- **Server and CLI** (`memanto_vapi/webhook.py`)
  - `memanto-vapi serve`, or `create_router` to mount the webhook in your own FastAPI app.
  - Requests are authenticated with a bearer secret (legacy `X-Vapi-Secret` also accepted).
  - `build_assistant_overrides()` covers outbound, web and chat calls.

## Tests
- 36 tests covering both scopes, caller isolation, auth, timeouts, retries and malformed payloads. Payloads follow Vapi's OpenAPI schema.

## Install
pip install memanto-vapi  requires `memanto>=0.2.21`.

Related Repositories