Skip to content

docs(skills): use typed plivo sip commands in the SIP trunking skill - #96

Open
Ayush Anand Plivo (ayush-git-plivo) wants to merge 1 commit into
mainfrom
skills/sip-typed-commands
Open

Ayush Anand Plivo (ayush-git-plivo) wants to merge 1 commit into
mainfrom
skills/sip-typed-commands

Conversation

@ayush-git-plivo

Copy link
Copy Markdown

Summary

The bundled sip-trunking skill still told agents "The CLI has no trunk commands", "no plivo sip ..." and "no numbers update --trunk-id", and routed every step through raw plivo api POST /Zentrunk/... calls (35 of them). All of that shipped in v1.1.0. An agent following the skill avoided the commands that validate input locally and read passwords from stdin only.

Changes

  • Readiness check, stages 2 to 5, go-live, debugging and the Zentrunk object reference now use plivo sip trunks|uris|credentials|ip-acl|calls and numbers update --trunk-id.
  • Credentials use --password-stdin (printf '%s' "$SIP_PASSWORD" | plivo sip credentials create ...), matching the CLI.
  • plivo api stays only for call Insights (no typed command yet) and as a labelled fallback; the per-platform request bodies are kept for fields no flag covers.
  • plivo sip calls diagnose replaces the note that voice calls diagnose might not accept trunk calls, including its server-side limitation.
  • Adds xAI Voice Agents (inbound only, sip.voice.x.ai;transport=tls), which now has a Plivo SIP trunking guide; the skill previously said Plivo had no xAI guide.
  • Points to plivo skill install voice-xml|audio-streaming|cli instead of npx skills add for the other skills.
  • CHANGELOG: new Unreleased entry.

Breaking change?

  • Yes
  • No. Skill content only; no command, flag or output changes.

Testing

  • go build ./...
  • go test ./... -race
  • gofmt -l . is clean
  • Help snapshots regenerated: not needed, the command tree is unchanged
  • Command reference regenerated: not needed, no commands or flags changed
  • Every plivo sip command named in the skill was checked against its v1.1.2 --help usage line (not the exit code, since unknown subcommands currently exit 0 on --help), and every flag the skill uses appears in the matching command's help.

Follow-up for the docs: once this ships, the SIP "Build with an AI coding agent" page can say the skill uses the plivo sip commands (plivo-dev/docs#173 covers the login note only).

🤖 Generated with Claude Code

The bundled sip-trunking skill still said "The CLI has no trunk commands",
"no `plivo sip ...`" and "no `numbers update --trunk-id`", and sent every
trunk, URI, credential and IP list step through raw `plivo api` calls. All
of that shipped in v1.1.0, so an agent following the skill avoided the
commands that validate input locally and read passwords from stdin only.

- Readiness check, stages 2 to 5, go-live, debugging and the object
  reference now use `plivo sip trunks|uris|credentials|ip-acl|calls` and
  `numbers update --trunk-id`.
- `plivo api` stays for call Insights (no typed command yet) and as a
  labelled fallback, with the request bodies kept for fields no flag covers.
- `sip calls diagnose` replaces the note that `voice calls diagnose` might
  not accept trunk calls, including its server-side limitation.
- Adds xAI Voice Agents (inbound only, `sip.voice.x.ai;transport=tls`),
  which now has a Plivo SIP trunking guide.
- Points to `plivo skill install voice-xml|audio-streaming|cli` instead of
  `npx skills add` for the other skills.

Every `plivo sip` command and flag named in the skill was checked against
the v1.1.2 help output.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant