Troubleshooting

Troubleshooting

Meta models do not appear

1. Confirm the package is installed:

   pi update npm:pi-meta-oauth
   pi --list-models meta

2. Run /login meta again if authorization has expired or the provider cannot refresh its key.

3. Check whether Pi's enabledModels setting excludes meta/*.

4. Retry without a restrictive model filter.

Never include credentials or authorization responses in an issue report.

Login or key minting fails

• Complete every step on Meta's device-authorization page.
• If Meta presents an account-setup URL, complete that setup and retry /login meta.
• Confirm the system clock and network connection are working.
• A stale or incomplete credential should be replaced by signing in again rather than edited manually.

Tool search appears to do nothing

supportsToolSearch is a provider capability, not a new command. It has an effect only when an installed Pi extension dynamically activates previously inactive tools. Existing built-in tools remain active normally.

Voice shortcut does nothing

• Voice requires macOS.
• Run /voice-on and then /voice to inspect status.
• Grant microphone access when macOS prompts.
• Ensure another application is not preventing microphone capture.

Voice cannot connect

Check in this order:

1. Confirm general network connectivity.
2. Determine whether Meta's internal ASR endpoint still resolves.
3. Compare the handshake shape with a current Muse Code build.
4. Confirm the configured ASR model is still accepted.

The endpoint and model can be overridden with PI_META_VOICE_ASR_ENDPOINT and PI_META_VOICE_ASR_MODEL. The ASR endpoint must normally use wss://.

Development checks

From a source checkout:

bun run typecheck
bun test

The tests validate provider mapping, OAuth behavior, tool-search metadata, voice helpers, and packaged macOS resources. They do not contact the live Meta ASR endpoint.

If the problem remains, open a GitHub issue with the Pi version, package version, platform, reproduction steps, and sanitized error text.