fengming 0.3.10 → 0.3.12

package/docs/plugins/plugin-inventory.md

@@ -1,189 +0,0 @@
----
-summary: "Generated inventory of FengMing plugins shipped in core, published externally, or kept source-only"
-read_when:
-  - You are deciding whether a plugin ships in the core npm package or installs separately
-  - You are updating bundled plugin package metadata or release automation
-  - You need the canonical internal vs external plugin list
-title: "Plugin inventory"
----
-
-# Plugin inventory
-
-This page is generated from `extensions/*/package.json`, `fengming.plugin.json`,
-and the root npm package `files` exclusions. Regenerate it with:
-
-```bash
-pnpm plugins:inventory:gen
-```
-
-## Definitions
-
-- **Core npm package:** built into the `fengming` npm package and available without a separate plugin install.
-- **Official external package:** FengMing-maintained plugin omitted from the core npm package, kept in this official inventory, and installed on demand through ClawHub and/or npm.
-- **Source checkout only:** repo-local plugin omitted from published npm artifacts and not advertised as an installable package.
-
-Source checkouts are different from npm installs: after `pnpm install`, bundled
-plugins load from `extensions/<id>` so local edits and package-local workspace
-dependencies are available.
-
-## Install a plugin
-
-Use the **Distribution** column to decide whether install is needed. Plugins that
-say `included in FengMing` are already present in the core package. Official
-external packages need one install, then a Gateway restart.
-
-For example, Discord is an official external package:
-
-```bash
-fengming plugins install @fengming/discord
-fengming gateway restart
-fengming plugins inspect discord --runtime --json
-```
-
-During the launch cutover, ordinary bare package specs still install from npm.
-Use `clawhub:@fengming/discord` or `npm:@fengming/discord` when you need an
-explicit source. After install, follow the plugin's setup doc, such as
-[Discord](/channels/discord), to add credentials and channel config. See
-[Manage plugins](/plugins/manage-plugins) for update, uninstall, and publishing
-commands.
-
-## Core npm package
-
-| Plugin                                                            | Description                                                                                                                                                          | Distribution                                                         | Surface                                                                                                                                                                                                                                                          |
-| ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [admin-http-rpc](/plugins/reference/admin-http-rpc)               | FengMing admin HTTP RPC endpoint.                                                                                                                                    | `@fengming/admin-http-rpc`<br />included in FengMing                 | contracts: gatewayMethodDispatch                                                                                                                                                                                                                                 |
-| [alibaba](/plugins/reference/alibaba)                             | Adds video generation provider support.                                                                                                                              | `@fengming/alibaba-provider`<br />included in FengMing               | contracts: videoGenerationProviders                                                                                                                                                                                                                              |
-| [anthropic](/plugins/reference/anthropic)                         | Adds Anthropic model provider support to FengMing.                                                                                                                   | `@fengming/anthropic-provider`<br />included in FengMing             | providers: anthropic; contracts: mediaUnderstandingProviders                                                                                                                                                                                                     |
-| [arcee](/plugins/reference/arcee)                                 | Adds Arcee model provider support to FengMing.                                                                                                                       | `@fengming/arcee-provider`<br />included in FengMing                 | providers: arcee                                                                                                                                                                                                                                                 |
-| [azure-speech](/plugins/reference/azure-speech)                   | Azure AI Speech text-to-speech (MP3, native Ogg/Opus voice notes, PCM telephony).                                                                                    | `@fengming/azure-speech`<br />included in FengMing                   | contracts: speechProviders                                                                                                                                                                                                                                       |
-| [bonjour](/plugins/reference/bonjour)                             | Advertise the local FengMing gateway over Bonjour/mDNS.                                                                                                              | `@fengming/bonjour`<br />included in FengMing                        | plugin                                                                                                                                                                                                                                                           |
-| [browser](/plugins/reference/browser)                             | Adds agent-callable tools.                                                                                                                                           | `@fengming/browser-plugin`<br />included in FengMing                 | contracts: tools; skills                                                                                                                                                                                                                                         |
-| [byteplus](/plugins/reference/byteplus)                           | Adds BytePlus, BytePlus Plan model provider support to FengMing.                                                                                                     | `@fengming/byteplus-provider`<br />included in FengMing              | providers: byteplus, byteplus-plan; contracts: videoGenerationProviders                                                                                                                                                                                          |
-| [canvas](/plugins/reference/canvas)                               | Experimental Canvas control and A2UI rendering surfaces for paired nodes.                                                                                            | `@fengming/canvas-plugin`<br />included in FengMing                  | contracts: tools                                                                                                                                                                                                                                                 |
-| [cerebras](/plugins/reference/cerebras)                           | Adds Cerebras model provider support to FengMing.                                                                                                                    | `@fengming/cerebras-provider`<br />included in FengMing              | providers: cerebras                                                                                                                                                                                                                                              |
-| [chutes](/plugins/reference/chutes)                               | Adds Chutes model provider support to FengMing.                                                                                                                      | `@fengming/chutes-provider`<br />included in FengMing                | providers: chutes                                                                                                                                                                                                                                                |
-| [clickclack](/plugins/reference/clickclack)                       | Adds the Clickclack channel surface for sending and receiving FengMing messages.                                                                                     | `@fengming/clickclack`<br />included in FengMing                     | channels: clickclack                                                                                                                                                                                                                                             |
-| [cloudflare-ai-gateway](/plugins/reference/cloudflare-ai-gateway) | Adds Cloudflare AI Gateway model provider support to FengMing.                                                                                                       | `@fengming/cloudflare-ai-gateway-provider`<br />included in FengMing | providers: cloudflare-ai-gateway                                                                                                                                                                                                                                 |
-| [codex-supervisor](/plugins/reference/codex-supervisor)           | Supervise Codex app-server sessions from FengMing.                                                                                                                   | `@fengming/codex-supervisor`<br />included in FengMing               | contracts: tools                                                                                                                                                                                                                                                 |
-| [comfy](/plugins/reference/comfy)                                 | Adds ComfyUI model provider support to FengMing.                                                                                                                     | `@fengming/comfy-provider`<br />included in FengMing                 | providers: comfy; contracts: imageGenerationProviders, musicGenerationProviders, videoGenerationProviders                                                                                                                                                        |
-| [copilot-proxy](/plugins/reference/copilot-proxy)                 | Adds Copilot Proxy model provider support to FengMing.                                                                                                               | `@fengming/copilot-proxy`<br />included in FengMing                  | providers: copilot-proxy                                                                                                                                                                                                                                         |
-| [deepgram](/plugins/reference/deepgram)                           | Adds media understanding provider support. Adds realtime transcription provider support.                                                                             | `@fengming/deepgram-provider`<br />included in FengMing              | contracts: mediaUnderstandingProviders, realtimeTranscriptionProviders                                                                                                                                                                                           |
-| [deepinfra](/plugins/reference/deepinfra)                         | Adds DeepInfra model provider support to FengMing.                                                                                                                   | `@fengming/deepinfra-provider`<br />included in FengMing             | providers: deepinfra; contracts: imageGenerationProviders, mediaUnderstandingProviders, memoryEmbeddingProviders, speechProviders, videoGenerationProviders                                                                                                      |
-| [deepseek](/plugins/reference/deepseek)                           | Adds DeepSeek model provider support to FengMing.                                                                                                                    | `@fengming/deepseek-provider`<br />included in FengMing              | providers: deepseek                                                                                                                                                                                                                                              |
-| [document-extract](/plugins/reference/document-extract)           | Extract text and fallback page images from local document attachments.                                                                                               | `@fengming/document-extract-plugin`<br />included in FengMing        | contracts: documentExtractors                                                                                                                                                                                                                                    |
-| [duckduckgo](/plugins/reference/duckduckgo)                       | Adds web search provider support.                                                                                                                                    | `@fengming/duckduckgo-plugin`<br />included in FengMing              | contracts: webSearchProviders                                                                                                                                                                                                                                    |
-| [elevenlabs](/plugins/reference/elevenlabs)                       | Adds media understanding provider support. Adds realtime transcription provider support. Adds text-to-speech provider support.                                       | `@fengming/elevenlabs-speech`<br />included in FengMing              | contracts: mediaUnderstandingProviders, realtimeTranscriptionProviders, speechProviders                                                                                                                                                                          |
-| [exa](/plugins/reference/exa)                                     | Adds web search provider support.                                                                                                                                    | `@fengming/exa-plugin`<br />included in FengMing                     | contracts: webSearchProviders                                                                                                                                                                                                                                    |
-| [fal](/plugins/reference/fal)                                     | Adds fal model provider support to FengMing.                                                                                                                         | `@fengming/fal-provider`<br />included in FengMing                   | providers: fal; contracts: imageGenerationProviders, musicGenerationProviders, videoGenerationProviders                                                                                                                                                          |
-| [file-transfer](/plugins/reference/file-transfer)                 | Fetch, list, and write files on paired nodes via dedicated node commands. Bypasses bash stdout truncation by using base64 over node.invoke for binaries up to 16 MB. | `@fengming/file-transfer`<br />included in FengMing                  | contracts: tools                                                                                                                                                                                                                                                 |
-| [firecrawl](/plugins/reference/firecrawl)                         | Adds agent-callable tools. Adds web fetch provider support. Adds web search provider support.                                                                        | `@fengming/firecrawl-plugin`<br />included in FengMing               | contracts: tools, webFetchProviders, webSearchProviders                                                                                                                                                                                                          |
-| [fireworks](/plugins/reference/fireworks)                         | Adds Fireworks model provider support to FengMing.                                                                                                                   | `@fengming/fireworks-provider`<br />included in FengMing             | providers: fireworks                                                                                                                                                                                                                                             |
-| [github-copilot](/plugins/reference/github-copilot)               | Adds GitHub Copilot model provider support to FengMing.                                                                                                              | `@fengming/github-copilot-provider`<br />included in FengMing        | providers: github-copilot; contracts: memoryEmbeddingProviders                                                                                                                                                                                                   |
-| [gmi](/plugins/reference/gmi)                                     | Adds Gmi, Gmi Cloud, Gmicloud model provider support to FengMing.                                                                                                    | `@fengming/gmi-provider`<br />included in FengMing                   | providers: gmi, gmi-cloud, gmicloud                                                                                                                                                                                                                              |
-| [google](/plugins/reference/google)                               | Adds Google, Google Gemini CLI, Google Vertex model provider support to FengMing.                                                                                    | `@fengming/google-plugin`<br />included in FengMing                  | providers: google, google-gemini-cli, google-vertex; contracts: imageGenerationProviders, mediaUnderstandingProviders, memoryEmbeddingProviders, musicGenerationProviders, realtimeVoiceProviders, speechProviders, videoGenerationProviders, webSearchProviders |
-| [gradium](/plugins/reference/gradium)                             | Adds text-to-speech provider support.                                                                                                                                | `@fengming/gradium-speech`<br />included in FengMing                 | contracts: speechProviders                                                                                                                                                                                                                                       |
-| [groq](/plugins/reference/groq)                                   | Adds Groq model provider support to FengMing.                                                                                                                        | `@fengming/groq-provider`<br />included in FengMing                  | providers: groq; contracts: mediaUnderstandingProviders                                                                                                                                                                                                          |
-| [huggingface](/plugins/reference/huggingface)                     | Adds Hugging Face model provider support to FengMing.                                                                                                                | `@fengming/huggingface-provider`<br />included in FengMing           | providers: huggingface                                                                                                                                                                                                                                           |
-| [imessage](/plugins/reference/imessage)                           | Adds the iMessage channel surface for sending and receiving FengMing messages.                                                                                       | `@fengming/imessage`<br />included in FengMing                       | channels: imessage                                                                                                                                                                                                                                               |
-| [inworld](/plugins/reference/inworld)                             | Inworld streaming text-to-speech (MP3, OGG_OPUS, PCM telephony).                                                                                                     | `@fengming/inworld-speech`<br />included in FengMing                 | contracts: speechProviders                                                                                                                                                                                                                                       |
-| [irc](/plugins/reference/irc)                                     | Adds the IRC channel surface for sending and receiving FengMing messages.                                                                                            | `@fengming/irc`<br />included in FengMing                            | channels: irc                                                                                                                                                                                                                                                    |
-| [kilocode](/plugins/reference/kilocode)                           | Adds Kilocode model provider support to FengMing.                                                                                                                    | `@fengming/kilocode-provider`<br />included in FengMing              | providers: kilocode                                                                                                                                                                                                                                              |
-| [kimi](/plugins/reference/kimi)                                   | Adds Kimi, Kimi Coding model provider support to FengMing.                                                                                                           | `@fengming/kimi-provider`<br />included in FengMing                  | providers: kimi, kimi-coding                                                                                                                                                                                                                                     |
-| [litellm](/plugins/reference/litellm)                             | Adds LiteLLM model provider support to FengMing.                                                                                                                     | `@fengming/litellm-provider`<br />included in FengMing               | providers: litellm; contracts: imageGenerationProviders                                                                                                                                                                                                          |
-| [llm-task](/plugins/reference/llm-task)                           | Generic JSON-only LLM tool for structured tasks callable from workflows.                                                                                             | `@fengming/llm-task`<br />included in FengMing                       | contracts: tools                                                                                                                                                                                                                                                 |
-| [lmstudio](/plugins/reference/lmstudio)                           | Adds LM Studio model provider support to FengMing.                                                                                                                   | `@fengming/lmstudio-provider`<br />included in FengMing              | providers: lmstudio; contracts: memoryEmbeddingProviders                                                                                                                                                                                                         |
-| [mattermost](/plugins/reference/mattermost)                       | Adds the Mattermost channel surface for sending and receiving FengMing messages.                                                                                     | `@fengming/mattermost`<br />included in FengMing                     | channels: mattermost                                                                                                                                                                                                                                             |
-| [memory-core](/plugins/reference/memory-core)                     | Adds memory embedding provider support. Adds agent-callable tools.                                                                                                   | `@fengming/memory-core`<br />included in FengMing                    | contracts: memoryEmbeddingProviders, tools                                                                                                                                                                                                                       |
-| [memory-wiki](/plugins/reference/memory-wiki)                     | Persistent wiki compiler and Obsidian-friendly knowledge vault for FengMing.                                                                                         | `@fengming/memory-wiki`<br />included in FengMing                    | contracts: tools; skills                                                                                                                                                                                                                                         |
-| [microsoft](/plugins/reference/microsoft)                         | Adds text-to-speech provider support.                                                                                                                                | `@fengming/microsoft-speech`<br />included in FengMing               | contracts: speechProviders                                                                                                                                                                                                                                       |
-| [microsoft-foundry](/plugins/reference/microsoft-foundry)         | Adds Microsoft Foundry model provider support to FengMing.                                                                                                           | `@fengming/microsoft-foundry`<br />included in FengMing              | providers: microsoft-foundry                                                                                                                                                                                                                                     |
-| [migrate-claude](/plugins/reference/migrate-claude)               | Imports Claude Code and Claude Desktop instructions, MCP servers, skills, and safe configuration into FengMing.                                                      | `@fengming/migrate-claude`<br />included in FengMing                 | contracts: migrationProviders                                                                                                                                                                                                                                    |
-| [migrate-hermes](/plugins/reference/migrate-hermes)               | Imports Hermes configuration, memories, skills, and supported credentials into FengMing.                                                                             | `@fengming/migrate-hermes`<br />included in FengMing                 | contracts: migrationProviders                                                                                                                                                                                                                                    |
-| [minimax](/plugins/reference/minimax)                             | Adds MiniMax, MiniMax Portal model provider support to FengMing.                                                                                                     | `@fengming/minimax-provider`<br />included in FengMing               | providers: minimax, minimax-portal; contracts: imageGenerationProviders, mediaUnderstandingProviders, musicGenerationProviders, speechProviders, videoGenerationProviders, webSearchProviders                                                                    |
-| [mistral](/plugins/reference/mistral)                             | Adds Mistral model provider support to FengMing.                                                                                                                     | `@fengming/mistral-provider`<br />included in FengMing               | providers: mistral; contracts: mediaUnderstandingProviders, memoryEmbeddingProviders, realtimeTranscriptionProviders                                                                                                                                             |
-| [moonshot](/plugins/reference/moonshot)                           | Adds Moonshot model provider support to FengMing.                                                                                                                    | `@fengming/moonshot-provider`<br />included in FengMing              | providers: moonshot; contracts: mediaUnderstandingProviders, webSearchProviders                                                                                                                                                                                  |
-| [novita](/plugins/reference/novita)                               | Adds Novita, Novita AI, Novitaai model provider support to FengMing.                                                                                                 | `@fengming/novita-provider`<br />included in FengMing                | providers: novita, novita-ai, novitaai                                                                                                                                                                                                                           |
-| [nvidia](/plugins/reference/nvidia)                               | Adds NVIDIA model provider support to FengMing.                                                                                                                      | `@fengming/nvidia-provider`<br />included in FengMing                | providers: nvidia                                                                                                                                                                                                                                                |
-| [oc-path](/plugins/reference/oc-path)                             | Adds the fengming path CLI for oc:// workspace file addressing.                                                                                                      | `@fengming/oc-path`<br />included in FengMing                        | plugin                                                                                                                                                                                                                                                           |
-| [ollama](/plugins/reference/ollama)                               | Adds Ollama, Ollama Cloud model provider support to FengMing.                                                                                                        | `@fengming/ollama-provider`<br />included in FengMing                | providers: ollama, ollama-cloud; contracts: memoryEmbeddingProviders, webSearchProviders                                                                                                                                                                         |
-| [open-prose](/plugins/reference/open-prose)                       | OpenProse VM skill pack with a /prose slash command.                                                                                                                 | `@fengming/open-prose`<br />included in FengMing                     | skills                                                                                                                                                                                                                                                           |
-| [openai](/plugins/reference/openai)                               | Adds OpenAI model provider support to FengMing, including ChatGPT/Codex OAuth.                                                                                       | `@fengming/openai-provider`<br />included in FengMing                | providers: openai; contracts: imageGenerationProviders, mediaUnderstandingProviders, memoryEmbeddingProviders, realtimeTranscriptionProviders, realtimeVoiceProviders, speechProviders, videoGenerationProviders                                                 |
-| [opencode](/plugins/reference/opencode)                           | Adds OpenCode model provider support to FengMing.                                                                                                                    | `@fengming/opencode-provider`<br />included in FengMing              | providers: opencode; contracts: mediaUnderstandingProviders                                                                                                                                                                                                      |
-| [opencode-go](/plugins/reference/opencode-go)                     | Adds OpenCode Go model provider support to FengMing.                                                                                                                 | `@fengming/opencode-go-provider`<br />included in FengMing           | providers: opencode-go; contracts: mediaUnderstandingProviders                                                                                                                                                                                                   |
-| [openrouter](/plugins/reference/openrouter)                       | Adds OpenRouter model provider support to FengMing.                                                                                                                  | `@fengming/openrouter-provider`<br />included in FengMing            | providers: openrouter; contracts: imageGenerationProviders, mediaUnderstandingProviders, musicGenerationProviders, speechProviders, videoGenerationProviders                                                                                                     |
-| [perplexity](/plugins/reference/perplexity)                       | Adds web search provider support.                                                                                                                                    | `@fengming/perplexity-plugin`<br />included in FengMing              | contracts: webSearchProviders                                                                                                                                                                                                                                    |
-| [policy](/plugins/reference/policy)                               | Adds policy-backed doctor checks for workspace conformance.                                                                                                          | `@fengming/policy`<br />included in FengMing                         | plugin                                                                                                                                                                                                                                                           |
-| [qianfan](/plugins/reference/qianfan)                             | Adds Qianfan model provider support to FengMing.                                                                                                                     | `@fengming/qianfan-provider`<br />included in FengMing               | providers: qianfan                                                                                                                                                                                                                                               |
-| [qwen](/plugins/reference/qwen)                                   | Adds Qwen, Qwen Cloud, Model Studio, DashScope, Qwen Oauth, Qwen Portal, Qwen CLI model provider support to FengMing.                                                | `@fengming/qwen-provider`<br />included in FengMing                  | providers: qwen, qwencloud, modelstudio, dashscope, qwen-oauth, qwen-portal, qwen-cli; contracts: mediaUnderstandingProviders, videoGenerationProviders                                                                                                          |
-| [runway](/plugins/reference/runway)                               | Adds video generation provider support.                                                                                                                              | `@fengming/runway-provider`<br />included in FengMing                | contracts: videoGenerationProviders                                                                                                                                                                                                                              |
-| [searxng](/plugins/reference/searxng)                             | Adds web search provider support.                                                                                                                                    | `@fengming/searxng-plugin`<br />included in FengMing                 | contracts: webSearchProviders                                                                                                                                                                                                                                    |
-| [senseaudio](/plugins/reference/senseaudio)                       | Adds media understanding provider support.                                                                                                                           | `@fengming/senseaudio-provider`<br />included in FengMing            | contracts: mediaUnderstandingProviders                                                                                                                                                                                                                           |
-| [sglang](/plugins/reference/sglang)                               | Adds SGLang model provider support to FengMing.                                                                                                                      | `@fengming/sglang-provider`<br />included in FengMing                | providers: sglang                                                                                                                                                                                                                                                |
-| [signal](/plugins/reference/signal)                               | Adds the Signal channel surface for sending and receiving FengMing messages.                                                                                         | `@fengming/signal`<br />included in FengMing                         | channels: signal                                                                                                                                                                                                                                                 |
-| [skill-workshop](/plugins/reference/skill-workshop)               | Captures repeatable workflows as workspace skills, with pending review, safe writes, and skill prompt refresh.                                                       | `@fengming/skill-workshop`<br />included in FengMing                 | contracts: tools                                                                                                                                                                                                                                                 |
-| [stepfun](/plugins/reference/stepfun)                             | Adds StepFun, StepFun Plan model provider support to FengMing.                                                                                                       | `@fengming/stepfun-provider`<br />included in FengMing               | providers: stepfun, stepfun-plan                                                                                                                                                                                                                                 |
-| [synthetic](/plugins/reference/synthetic)                         | Adds Synthetic model provider support to FengMing.                                                                                                                   | `@fengming/synthetic-provider`<br />included in FengMing             | providers: synthetic                                                                                                                                                                                                                                             |
-| [tavily](/plugins/reference/tavily)                               | Adds agent-callable tools. Adds web search provider support.                                                                                                         | `@fengming/tavily-plugin`<br />included in FengMing                  | contracts: tools, webSearchProviders; skills                                                                                                                                                                                                                     |
-| [telegram](/plugins/reference/telegram)                           | Adds the Telegram channel surface for sending and receiving FengMing messages.                                                                                       | `@fengming/telegram`<br />included in FengMing                       | channels: telegram                                                                                                                                                                                                                                               |
-| [tencent](/plugins/reference/tencent)                             | Adds Tencent TokenHub model provider support to FengMing.                                                                                                            | `@fengming/tencent-provider`<br />included in FengMing               | providers: tencent-tokenhub                                                                                                                                                                                                                                      |
-| [together](/plugins/reference/together)                           | Adds Together model provider support to FengMing.                                                                                                                    | `@fengming/together-provider`<br />included in FengMing              | providers: together; contracts: videoGenerationProviders                                                                                                                                                                                                         |
-| [tts-local-cli](/plugins/reference/tts-local-cli)                 | Adds text-to-speech provider support.                                                                                                                                | `@fengming/tts-local-cli`<br />included in FengMing                  | contracts: speechProviders                                                                                                                                                                                                                                       |
-| [venice](/plugins/reference/venice)                               | Adds Venice model provider support to FengMing.                                                                                                                      | `@fengming/venice-provider`<br />included in FengMing                | providers: venice                                                                                                                                                                                                                                                |
-| [vercel-ai-gateway](/plugins/reference/vercel-ai-gateway)         | Adds Vercel AI Gateway model provider support to FengMing.                                                                                                           | `@fengming/vercel-ai-gateway-provider`<br />included in FengMing     | providers: vercel-ai-gateway                                                                                                                                                                                                                                     |
-| [vllm](/plugins/reference/vllm)                                   | Adds vLLM model provider support to FengMing.                                                                                                                        | `@fengming/vllm-provider`<br />included in FengMing                  | providers: vllm                                                                                                                                                                                                                                                  |
-| [volcengine](/plugins/reference/volcengine)                       | Adds Volcengine, Volcengine Plan model provider support to FengMing.                                                                                                 | `@fengming/volcengine-provider`<br />included in FengMing            | providers: volcengine, volcengine-plan; contracts: speechProviders                                                                                                                                                                                               |
-| [voyage](/plugins/reference/voyage)                               | Adds memory embedding provider support.                                                                                                                              | `@fengming/voyage-provider`<br />included in FengMing                | contracts: memoryEmbeddingProviders                                                                                                                                                                                                                              |
-| [vydra](/plugins/reference/vydra)                                 | Adds Vydra model provider support to FengMing.                                                                                                                       | `@fengming/vydra-provider`<br />included in FengMing                 | providers: vydra; contracts: imageGenerationProviders, speechProviders, videoGenerationProviders                                                                                                                                                                 |
-| [web-readability](/plugins/reference/web-readability)             | Extract readable article content from local HTML web fetch responses.                                                                                                | `@fengming/web-readability-plugin`<br />included in FengMing         | contracts: webContentExtractors                                                                                                                                                                                                                                  |
-| [webhooks](/plugins/reference/webhooks)                           | Authenticated inbound webhooks that bind external automation to FengMing TaskFlows.                                                                                  | `@fengming/webhooks`<br />included in FengMing                       | plugin                                                                                                                                                                                                                                                           |
-| [workboard](/plugins/reference/workboard)                         | Dashboard workboard for agent-owned issues and sessions.                                                                                                             | `@fengming/workboard`<br />included in FengMing                      | contracts: tools                                                                                                                                                                                                                                                 |
-| [xai](/plugins/reference/xai)                                     | Adds xAI model provider support to FengMing.                                                                                                                         | `@fengming/xai-plugin`<br />included in FengMing                     | providers: xai; contracts: imageGenerationProviders, mediaUnderstandingProviders, realtimeTranscriptionProviders, speechProviders, tools, videoGenerationProviders, webSearchProviders                                                                           |
-| [xiaomi](/plugins/reference/xiaomi)                               | Adds Xiaomi MiMo pay-as-you-go and Token Plan provider support to FengMing.                                                                                          | `@fengming/xiaomi-provider`<br />included in FengMing                | providers: xiaomi, xiaomi-token-plan; contracts: speechProviders                                                                                                                                                                                                 |
-| [zai](/plugins/reference/zai)                                     | Adds Z.AI model provider support to FengMing.                                                                                                                        | `@fengming/zai-provider`<br />included in FengMing                   | providers: zai; contracts: mediaUnderstandingProviders                                                                                                                                                                                                           |
-
-## Official external packages
-
-| Plugin                                                              | Description                                                                                                     | Distribution                                                                                     | Surface                                                                      |
-| ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------- |
-| [acpx](/plugins/reference/acpx)                                     | FengMing ACP runtime backend with plugin-owned session and transport management.                                | `@fengming/acpx`<br />npm; ClawHub                                                               | skills                                                                       |
-| [amazon-bedrock](/plugins/reference/amazon-bedrock)                 | FengMing Amazon Bedrock provider plugin with model discovery, embeddings, and guardrail support.                | `@fengming/amazon-bedrock-provider`<br />npm; ClawHub                                            | providers: amazon-bedrock; contracts: memoryEmbeddingProviders               |
-| [amazon-bedrock-mantle](/plugins/reference/amazon-bedrock-mantle)   | FengMing Amazon Bedrock Mantle provider plugin for OpenAI-compatible model routing.                             | `@fengming/amazon-bedrock-mantle-provider`<br />npm; ClawHub                                     | providers: amazon-bedrock-mantle                                             |
-| [anthropic-vertex](/plugins/reference/anthropic-vertex)             | FengMing Anthropic Vertex provider plugin for Claude models on Google Vertex AI.                                | `@fengming/anthropic-vertex-provider`<br />npm; ClawHub                                          | providers: anthropic-vertex                                                  |
-| [brave](/plugins/reference/brave)                                   | FengMing Brave Search provider plugin for web search.                                                           | `@fengming/brave-plugin`<br />npm; ClawHub                                                       | contracts: webSearchProviders                                                |
-| [codex](/plugins/reference/codex)                                   | FengMing Codex app-server harness and model provider plugin with a Codex-managed GPT catalog.                   | `@fengming/codex`<br />npm; ClawHub                                                              | providers: codex; contracts: mediaUnderstandingProviders, migrationProviders |
-| [copilot](/plugins/reference/copilot)                               | Registers the GitHub Copilot agent runtime.                                                                     | `@fengming/copilot`<br />npm; ClawHub: `clawhub:@fengming/copilot`                               | plugin                                                                       |
-| [diagnostics-otel](/plugins/reference/diagnostics-otel)             | FengMing diagnostics OpenTelemetry exporter for metrics and traces.                                             | `@fengming/diagnostics-otel`<br />npm; ClawHub: `clawhub:@fengming/diagnostics-otel`             | plugin                                                                       |
-| [diagnostics-prometheus](/plugins/reference/diagnostics-prometheus) | FengMing diagnostics Prometheus exporter for runtime metrics.                                                   | `@fengming/diagnostics-prometheus`<br />npm; ClawHub: `clawhub:@fengming/diagnostics-prometheus` | plugin                                                                       |
-| [diffs](/plugins/reference/diffs)                                   | FengMing read-only diff viewer plugin and file renderer for agents.                                             | `@fengming/diffs`<br />npm; ClawHub                                                              | contracts: tools; skills                                                     |
-| [diffs-language-pack](/plugins/reference/diffs-language-pack)       | Adds syntax highlighting for languages outside the default diffs viewer set.                                    | `@fengming/diffs-language-pack`<br />npm; ClawHub: `clawhub:@fengming/diffs-language-pack`       | plugin                                                                       |
-| [discord](/plugins/reference/discord)                               | FengMing Discord channel plugin for channels, DMs, commands, and app events.                                    | `@fengming/discord`<br />npm; ClawHub                                                            | channels: discord; contracts: transcriptSourceProviders                      |
-| [feishu](/plugins/reference/feishu)                                 | FengMing Feishu/Lark channel plugin for chats and workplace tools (community maintained by @m1heng).            | `@fengming/feishu`<br />npm; ClawHub                                                             | channels: feishu; contracts: tools; skills                                   |
-| [google-meet](/plugins/reference/google-meet)                       | FengMing Google Meet participant plugin for joining calls through Chrome or Twilio transports.                  | `@fengming/google-meet`<br />npm; ClawHub                                                        | contracts: tools                                                             |
-| [googlechat](/plugins/reference/googlechat)                         | FengMing Google Chat channel plugin for spaces and direct messages.                                             | `@fengming/googlechat`<br />npm; ClawHub                                                         | channels: googlechat                                                         |
-| [line](/plugins/reference/line)                                     | FengMing LINE channel plugin for LINE Bot API chats.                                                            | `@fengming/line`<br />npm; ClawHub                                                               | channels: line                                                               |
-| [lobster](/plugins/reference/lobster)                               | Lobster workflow tool plugin for typed pipelines and resumable approvals.                                       | `@fengming/lobster`<br />npm; ClawHub                                                            | contracts: tools                                                             |
-| [matrix](/plugins/reference/matrix)                                 | FengMing Matrix channel plugin for rooms and direct messages.                                                   | `@fengming/matrix`<br />ClawHub: `clawhub:@fengming/matrix`; npm                                 | channels: matrix                                                             |
-| [memory-lancedb](/plugins/reference/memory-lancedb)                 | FengMing LanceDB-backed long-term memory plugin with auto-recall, auto-capture, and vector search.              | `@fengming/memory-lancedb`<br />npm; ClawHub                                                     | contracts: tools                                                             |
-| [msteams](/plugins/reference/msteams)                               | FengMing Microsoft Teams channel plugin for bot conversations.                                                  | `@fengming/msteams`<br />npm; ClawHub                                                            | channels: msteams                                                            |
-| [nextcloud-talk](/plugins/reference/nextcloud-talk)                 | FengMing Nextcloud Talk channel plugin for conversations.                                                       | `@fengming/nextcloud-talk`<br />npm; ClawHub                                                     | channels: nextcloud-talk                                                     |
-| [nostr](/plugins/reference/nostr)                                   | FengMing Nostr channel plugin for NIP-04 encrypted direct messages.                                             | `@fengming/nostr`<br />npm; ClawHub                                                              | channels: nostr                                                              |
-| [openshell](/plugins/reference/openshell)                           | FengMing sandbox backend for the NVIDIA OpenShell CLI with mirrored local workspaces and SSH command execution. | `@fengming/openshell-sandbox`<br />npm; ClawHub                                                  | plugin                                                                       |
-| [pixverse](/plugins/reference/pixverse)                             | FengMing PixVerse video generation provider plugin.                                                             | `@fengming/pixverse-provider`<br />npm; ClawHub: `clawhub:@fengming/pixverse-provider`           | contracts: videoGenerationProviders                                          |
-| [qqbot](/plugins/reference/qqbot)                                   | FengMing QQ Bot channel plugin for group and direct-message workflows.                                          | `@fengming/qqbot`<br />npm; ClawHub                                                              | channels: qqbot; contracts: tools; skills                                    |
-| [slack](/plugins/reference/slack)                                   | FengMing Slack channel plugin for channels, DMs, commands, and app events.                                      | `@fengming/slack`<br />npm; ClawHub                                                              | channels: slack                                                              |
-| [synology-chat](/plugins/reference/synology-chat)                   | Synology Chat channel plugin for FengMing channels and direct messages.                                         | `@fengming/synology-chat`<br />npm; ClawHub                                                      | channels: synology-chat                                                      |
-| [tlon](/plugins/reference/tlon)                                     | FengMing Tlon/Urbit channel plugin for chat workflows.                                                          | `@fengming/tlon`<br />npm; ClawHub                                                               | channels: tlon; skills                                                       |
-| [tokenjuice](/plugins/reference/tokenjuice)                         | Compacts exec and bash tool results with tokenjuice reducers.                                                   | `@fengming/tokenjuice`<br />npm; ClawHub: `clawhub:@fengming/tokenjuice`                         | contracts: agentToolResultMiddleware                                         |
-| [twitch](/plugins/reference/twitch)                                 | FengMing Twitch channel plugin for chat and moderation workflows.                                               | `@fengming/twitch`<br />npm; ClawHub                                                             | channels: twitch                                                             |
-| [voice-call](/plugins/reference/voice-call)                         | FengMing voice-call plugin for Twilio, Telnyx, and Plivo phone calls.                                           | `@fengming/voice-call`<br />npm; ClawHub                                                         | contracts: tools                                                             |
-| [whatsapp](/plugins/reference/whatsapp)                             | FengMing WhatsApp channel plugin for WhatsApp Web chats.                                                        | `@fengming/whatsapp`<br />ClawHub: `clawhub:@fengming/whatsapp`; npm                             | channels: whatsapp                                                           |
-| [zalo](/plugins/reference/zalo)                                     | FengMing Zalo channel plugin for bot and webhook chats.                                                         | `@fengming/zalo`<br />npm; ClawHub                                                               | channels: zalo                                                               |
-| [zalouser](/plugins/reference/zalouser)                             | FengMing Zalo Personal Account plugin via native zca-js integration.                                            | `@fengming/zalouser`<br />npm; ClawHub                                                           | channels: zalouser; contracts: tools                                         |
-
-## Source checkout only
-
-| Plugin                                      | Description                                                              | Distribution                                     | Surface              |
-| ------------------------------------------- | ------------------------------------------------------------------------ | ------------------------------------------------ | -------------------- |
-| [qa-channel](/plugins/reference/qa-channel) | Adds the QA Channel surface for sending and receiving FengMing messages. | `@fengming/qa-channel`<br />source checkout only | channels: qa-channel |
-| [qa-lab](/plugins/reference/qa-lab)         | FengMing QA lab plugin with private debugger UI and scenario runner.     | `@fengming/qa-lab`<br />source checkout only     | plugin               |
-| [qa-matrix](/plugins/reference/qa-matrix)   | Matrix QA transport runner and substrate.                                | `@fengming/qa-matrix`<br />source checkout only  | plugin               |

package/docs/plugins/plugin-permission-requests.md

@@ -1,193 +0,0 @@
----
-summary: "Ask users to approve plugin tool calls and plugin-owned permission prompts"
-title: "Plugin permission requests"
-sidebarTitle: "Permission requests"
-read_when:
-  - You need a plugin hook or tool to ask before a side effect runs
-  - You need to configure where plugin approval prompts are delivered
-  - You are deciding between optional tools, exec approvals, and plugin approvals
----
-
-Plugin permission requests let plugin code pause a tool call or plugin-owned
-operation until a user approves or denies it. They use the Gateway
-`plugin.approval.*` flow and the same approval UI surfaces that handle chat
-approval buttons and `/approve` commands.
-
-Use plugin permission requests for plugin/app permissions. They do not replace
-host exec approvals, optional tool allowlists, or Codex's native permission
-review.
-
-## Choose the right gate
-
-Pick the gate that matches the decision point you need:
-
-| Gate                             | Use it when                                                              | What it controls                                                                                                  |
-| -------------------------------- | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- |
-| Optional tools                   | A tool should not be visible to the model until the user opts in.        | Tool exposure through `tools.allow`.                                                                              |
-| Plugin permission requests       | A plugin hook or plugin-owned operation must ask before one action runs. | Runtime approval through `plugin.approval.*`.                                                                     |
-| Exec approvals                   | A host command or shell-like tool needs operator approval.               | Host exec policy and durable exec allowlists.                                                                     |
-| Codex native permission requests | Codex asks before native shell, file, MCP, or app-server actions.        | Codex app-server or native hook approval handling, routed through plugin approvals when FengMing owns the prompt. |
-| MCP approval elicitations        | A Codex MCP server requests approval for a tool call.                    | MCP approval responses bridged through FengMing plugin approvals.                                                 |
-
-Optional tools are a discovery-time gate. Plugin permission requests are a
-per-call gate. Use both when a sensitive tool should require explicit opt-in
-before the model can see it and approval before the action runs.
-
-## Request approval before a tool call
-
-Most plugin-authored prompts should start in a `before_tool_call` hook. The hook
-runs after the model selects a tool and before FengMing executes it:
-
-```typescript
-import { definePluginEntry } from "fengming/plugin-sdk/plugin-entry";
-
-export default definePluginEntry({
-  id: "deploy-policy",
-  name: "Deploy Policy",
-  register(api) {
-    api.on("before_tool_call", async (event) => {
-      if (event.toolName !== "deploy_service") {
-        return;
-      }
-
-      const environment =
-        typeof event.params.environment === "string" ? event.params.environment : "unknown";
-
-      return {
-        requireApproval: {
-          title: "Deploy service",
-          description: `Deploy service to ${environment}.`,
-          severity: environment === "production" ? "critical" : "warning",
-          allowedDecisions:
-            environment === "production"
-              ? ["allow-once", "deny"]
-              : ["allow-once", "allow-always", "deny"],
-          timeoutMs: 120_000,
-          timeoutBehavior: "deny",
-          onResolution(decision) {
-            console.log(`deploy approval resolved: ${decision}`);
-          },
-        },
-      };
-    });
-  },
-});
-```
-
-Write prompt text for the person who will approve the action:
-
-- Keep `title` short and action-focused. The Gateway accepts up to 80
-  characters.
-- Keep `description` specific and bounded. The Gateway accepts up to 256
-  characters.
-- Include the action, target, and risk. Do not include secrets, tokens, or
-  private payloads that should not appear in chat approval surfaces.
-- Use `severity: "critical"` only for actions where the wrong decision could
-  cause production damage or data loss.
-- Use `allowedDecisions: ["allow-once", "deny"]` when persistent trust is
-  unsafe for that action.
-
-## Decision behavior
-
-FengMing creates a pending approval with a `plugin:` ID, delivers it to the
-available approval surfaces, and waits for a decision.
-
-| Decision          | Result                                                                    |
-| ----------------- | ------------------------------------------------------------------------- |
-| `allow-once`      | The current call continues.                                               |
-| `allow-always`    | The current call continues and the decision is passed to the plugin.      |
-| `deny`            | The call is blocked with a denied tool result.                            |
-| Timeout           | The call is blocked unless `timeoutBehavior` is `"allow"`.                |
-| Cancellation      | The call is blocked when the run is aborted.                              |
-| No approval route | The call is blocked because no connected approval surface can resolve it. |
-
-`allow-always` is only durable when the requesting plugin or runtime implements
-that persistence. For ordinary `before_tool_call.requireApproval` hooks,
-FengMing treats `allow-once` and `allow-always` as approval decisions for the
-current call and passes the resolved value to `onResolution`. If your plugin
-offers `allow-always`, document and implement exactly what future calls it
-trusts.
-
-If the hook also returns `params`, FengMing applies those parameter changes only
-after the approval succeeds. A lower-priority hook can still block after a
-higher-priority hook requested approval.
-
-`allowedDecisions` limits the buttons and commands shown to the user. The
-Gateway rejects a resolve attempt for any decision the request did not offer.
-
-## Route approval prompts
-
-Approval prompts can resolve in local UI surfaces or in chat channels that
-support approval handling. To forward plugin approval prompts to explicit chat
-targets, configure `approvals.plugin`:
-
-```json5
-{
-  approvals: {
-    plugin: {
-      enabled: true,
-      mode: "targets",
-      agentFilter: ["main"],
-      targets: [{ channel: "slack", to: "U12345678" }],
-    },
-  },
-}
-```
-
-`approvals.plugin` is independent from `approvals.exec`. Enabling exec approval
-forwarding does not route plugin approval prompts, and enabling plugin approval
-forwarding does not change host exec policy.
-
-When a prompt includes manual approval text, resolve it with one of the offered
-decisions:
-
-```text
-/approve <id> allow-once
-/approve <id> allow-always
-/approve <id> deny
-```
-
-See [Advanced exec approvals](/tools/exec-approvals-advanced#plugin-approval-forwarding)
-for the full forwarding model, same-chat approval behavior, native channel
-delivery, and channel-specific approver rules.
-
-## Codex native permissions
-
-Codex native permission prompts can also travel through plugin approvals, but
-they have different ownership than plugin-authored hooks.
-
-- Codex app-server approval requests route through FengMing after Codex review.
-- The native hook `permission_request` relay can ask through
-  `plugin.approval.request` when that relay is enabled.
-- MCP tool approval elicitations route through plugin approvals when Codex marks
-  `_meta.codex_approval_kind` as `"mcp_tool_call"`.
-
-See [Codex harness runtime](/plugins/codex-harness-runtime#native-permissions-and-mcp-elicitations)
-for the Codex-specific behavior and fallback rules.
-
-## Troubleshooting
-
-**The tool says plugin approvals are unavailable.** No approval UI or configured
-approval route accepted the request. Connect an approval-capable client, use a
-channel that supports same-chat `/approve`, or configure `approvals.plugin`.
-
-**`allow-always` appears but the next call prompts again.** The generic plugin
-approval flow does not automatically persist trust for arbitrary hooks. Persist
-plugin-owned trust in your plugin after `onResolution("allow-always")`, or
-offer only `allow-once` and `deny`.
-
-**`/approve` rejects the decision.** The request restricted
-`allowedDecisions`. Use one of the decisions printed in the prompt.
-
-**A Slack, Discord, Telegram, or Matrix prompt routes differently from exec
-approvals.** Plugin approvals and exec approvals use separate config and may use
-different authorization checks. Verify `approvals.plugin` and the channel's
-plugin approval support instead of only checking `approvals.exec`.
-
-## Related
-
-- [Plugin hooks](/plugins/hooks#tool-call-policy)
-- [Building plugins](/plugins/building-plugins#registering-agent-tools)
-- [Advanced exec approvals](/tools/exec-approvals-advanced#plugin-approval-forwarding)
-- [Gateway protocol](/gateway/protocol)
-- [Codex harness runtime](/plugins/codex-harness-runtime#native-permissions-and-mcp-elicitations)

package/docs/plugins/reference/acpx.md

@@ -1,23 +0,0 @@
----
-summary: "FengMing ACP runtime backend with plugin-owned session and transport management."
-read_when:
-  - You are installing, configuring, or auditing the acpx plugin
-title: "ACPx plugin"
----
-
-# ACPx plugin
-
-FengMing ACP runtime backend with plugin-owned session and transport management.
-
-## Distribution
-
-- Package: `@fengming/acpx`
-- Install route: npm; ClawHub
-
-## Surface
-
-skills
-
-## Related docs
-
-- [acpx](/tools/acp-agents-setup)

package/docs/plugins/reference/admin-http-rpc.md

@@ -1,23 +0,0 @@
----
-summary: "FengMing admin HTTP RPC endpoint."
-read_when:
-  - You are installing, configuring, or auditing the admin-http-rpc plugin
-title: "Admin Http Rpc plugin"
----
-
-# Admin Http Rpc plugin
-
-FengMing admin HTTP RPC endpoint.
-
-## Distribution
-
-- Package: `@fengming/admin-http-rpc`
-- Install route: included in FengMing
-
-## Surface
-
-contracts: gatewayMethodDispatch
-
-## Related docs
-
-- [admin-http-rpc](/plugins/admin-http-rpc)

package/docs/plugins/reference/alibaba.md

@@ -1,23 +0,0 @@
----
-summary: "Adds video generation provider support."
-read_when:
-  - You are installing, configuring, or auditing the alibaba plugin
-title: "Alibaba plugin"
----
-
-# Alibaba plugin
-
-Adds video generation provider support.
-
-## Distribution
-
-- Package: `@fengming/alibaba-provider`
-- Install route: included in FengMing
-
-## Surface
-
-contracts: videoGenerationProviders
-
-## Related docs
-
-- [alibaba](/providers/alibaba)

package/docs/plugins/reference/amazon-bedrock-mantle.md

@@ -1,23 +0,0 @@
----
-summary: "FengMing Amazon Bedrock Mantle provider plugin for OpenAI-compatible model routing."
-read_when:
-  - You are installing, configuring, or auditing the amazon-bedrock-mantle plugin
-title: "Amazon Bedrock Mantle plugin"
----
-
-# Amazon Bedrock Mantle plugin
-
-FengMing Amazon Bedrock Mantle provider plugin for OpenAI-compatible model routing.
-
-## Distribution
-
-- Package: `@fengming/amazon-bedrock-mantle-provider`
-- Install route: npm; ClawHub
-
-## Surface
-
-providers: amazon-bedrock-mantle
-
-## Related docs
-
-- [amazon-bedrock-mantle](/providers/bedrock-mantle)

package/docs/plugins/reference/amazon-bedrock.md

@@ -1,23 +0,0 @@
----
-summary: "FengMing Amazon Bedrock provider plugin with model discovery, embeddings, and guardrail support."
-read_when:
-  - You are installing, configuring, or auditing the amazon-bedrock plugin
-title: "Amazon Bedrock plugin"
----
-
-# Amazon Bedrock plugin
-
-FengMing Amazon Bedrock provider plugin with model discovery, embeddings, and guardrail support.
-
-## Distribution
-
-- Package: `@fengming/amazon-bedrock-provider`
-- Install route: npm; ClawHub
-
-## Surface
-
-providers: amazon-bedrock; contracts: memoryEmbeddingProviders
-
-## Related docs
-
-- [amazon-bedrock](/providers/bedrock)