npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@framers/agentos-ext-voice-plivo

v0.2.3

Published

Plivo voice call provider for AgentOS — outbound/inbound calls via Plivo Voice API

Readme

Plivo voice calls

This pack gives an agent a phone call management tool and registers a voice call provider. It uses the plivo SDK for outbound calls, in-call speech and hangup, and parses Plivo webhooks into AgentOS call events.

Installation

npm install @framers/agentos-ext-voice-plivo

Peer dependency: @framers/agentos, at the minimum version declared by this package.

Usage

import { AgentOS } from '@framers/agentos';

const agentos = await AgentOS.create({
  extensionManifest: {
    packs: [
      {
        package: '@framers/agentos-ext-voice-plivo',
        options: {
          authId: process.env.PLIVO_AUTH_ID,
          authToken: process.env.PLIVO_AUTH_TOKEN,
          fromNumber: process.env.PLIVO_FROM_NUMBER ?? process.env.PLIVO_PHONE_NUMBER,
        },
      },
    ],
  },
});

Supply options.callManager to use a host-owned manager. Otherwise the example creates an exposed pack-owned manager.

Configuration

Credentials resolve from a nonempty direct option, then options.secrets, then the selected environment variable, then the fixed fallbacks in the order shown. The manifest requires plivo.authId and plivo.authToken; the factory also requires a caller number.

| Option | Secret id | Environment variable | Required | Default | | --- | --- | --- | --- | --- | | authId | plivo.authId | Name selected by authIdEnv (default PLIVO_AUTH_ID), then PLIVO_AUTH_ID | Yes | None | | authToken | plivo.authToken | Name selected by authTokenEnv (default PLIVO_AUTH_TOKEN), then PLIVO_AUTH_TOKEN | Yes | None | | fromNumber | plivo.fromNumber | Name selected by fromNumberEnv (default PLIVO_FROM_NUMBER), then PLIVO_FROM_NUMBER, then PLIVO_PHONE_NUMBER | Yes | None | | authIdEnv | None | None | No | PLIVO_AUTH_ID | | authTokenEnv | None | None | No | PLIVO_AUTH_TOKEN | | fromNumberEnv | None | None | No | PLIVO_FROM_NUMBER | | secrets | plivo.authId, plivo.authToken, plivo.fromNumber | None | No | Unset | | callManager | None | None | No | Exposed pack-owned manager | | priority | None | None | No | 50 | | logger (context field) | None | None | No | Unset | | No option, webhook verification | None | NODE_ENV, then PLIVO_SKIP_SIGNATURE | No | Unset |

When signature headers are missing, NODE_ENV equal to development or PLIVO_SKIP_SIGNATURE equal to true allows the webhook. These variables do not bypass a signature mismatch when headers are present.

Tools

| Tool | What it does | | --- | --- | | plivoVoiceCall | Makes outbound calls, plays speech into calls, hangs up calls, queries call status and lists active calls. |

Parameters for plivoVoiceCall:

| Parameter | Type | Required | Description | | --- | --- | --- | --- | | action | string, enum: call, speak, hangup, status, list | Yes | The voice call action to perform. | | toNumber | string | No | E.164 phone number to call (required for "call" action). | | callId | string | No | Call ID (required for "speak", "hangup", "status" actions). | | message | string | No | Text to speak. For "call" in notify mode, this is the message. For "speak", this is played into the active call. | | mode | string, enum: notify, conversation | No | Call mode (default: "conversation"). "notify" speaks a message and hangs up. |

The schema requires action. The tool's validation and execution also require toNumber for call, callId for speak, hangup and status, and message for speak.

Notes

The package requires Node >=22. Plivo authentication credentials and an E.164 caller number are needed. Missing required settings cause the factory to throw an error naming the option, secret and primary environment variable.

Construction registers the provider on the selected manager. Activation initializes the SDK client. Deactivation disposes only the original pack-owned manager and clears the service client reference.

The tool has side effects: it places calls, speaks into active calls and terminates calls. Its default call mode is conversation. The service's default speech voice is Polly.Joanna. Notify XML speaks a message then hangs up. Conversation XML uses speech input, sets GetInput's executionTimeout to 30, and redirects to the webhook URL. The provider generates answer XML during call initiation but does not store or serve it. The hosting application must expose a public answer endpoint that returns the XML. The answer URL appends callId and mode query parameters and uses POST.

Webhook parsing accepts a pre-parsed body, JSON or form-encoded data. A payload without CallUUID produces no call events. Speech produces a final transcript; call statuses and hangup causes map to call state events. Digits is declared but is not emitted as an event. Verification uses HMAC with sha256 over the request URL plus nonce, authenticated with the resolved token.

Host call manager binding

The existing options.callManager is now exposed through the returned pack's binding.manager. The registered call tool uses that binding. binding.setManager(next) registers the provider on the replacement and changes subsequent tool operations; the host must drain or transfer active calls before doing so. Binding replacement does not migrate call state.

The voice-provider descriptor remains the raw Plivo provider and carries a read-only binding property for registry consumers. With no injected manager, construction creates an accessible pack-owned manager and places no call. Deactivation disposes only that original owned manager. Injected and replacement managers remain host-owned.

This binding does not change the pack's legacy answer XML, callback identities or signature behavior. Select the core carrier profile explicitly for durable carrier guarantees. The declared core peer floor is required for the binding API.

Releases

New versions are published from framerslab/agentos-extensions by GitHub Actions through npm trusted publishing, with a provenance statement.

License

Apache-2.0