nodmix 2026.5.25

package/docs/plugins/reference.md

@@ -0,0 +1,138 @@
+---
+summary: "Generated index of Nodmix plugin reference pages"
+read_when:
+  - You need a reference page for a specific Nodmix plugin
+  - You are auditing plugin docs coverage
+title: "Plugin reference"
+---
+
+# Plugin reference
+
+This page is generated from `extensions/*/package.json` and
+`nodmix.plugin.json`. Regenerate it with:
+
+```bash
+pnpm plugins:inventory:gen
+```
+
+| Plugin                                                              | Description                                                                                                                                                          | Distribution                                                                                     | Surface                                                                                                                                                                                                                                                          |
+| ------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [acpx](/plugins/reference/acpx)                                     | Embedded ACP runtime backend with plugin-owned session and transport management.                                                                                     | `@nodmix/acpx`<br />npm; ClawHub                                                               | skills                                                                                                                                                                                                                                                           |
+| [admin-http-rpc](/plugins/reference/admin-http-rpc)                 | Nodmix admin HTTP RPC endpoint.                                                                                                                                    | `@nodmix/admin-http-rpc`<br />included in Nodmix                                             | contracts: gatewayMethodDispatch                                                                                                                                                                                                                                 |
+| [alibaba](/plugins/reference/alibaba)                               | Adds video generation provider support.                                                                                                                              | `@nodmix/alibaba-provider`<br />included in Nodmix                                           | contracts: videoGenerationProviders                                                                                                                                                                                                                              |
+| [amazon-bedrock](/plugins/reference/amazon-bedrock)                 | Adds Amazon Bedrock model provider support to Nodmix.                                                                                                              | `@nodmix/amazon-bedrock-provider`<br />npm; ClawHub                                            | providers: amazon-bedrock; contracts: memoryEmbeddingProviders                                                                                                                                                                                                   |
+| [amazon-bedrock-mantle](/plugins/reference/amazon-bedrock-mantle)   | Adds Amazon Bedrock Mantle model provider support to Nodmix.                                                                                                       | `@nodmix/amazon-bedrock-mantle-provider`<br />npm; ClawHub                                     | providers: amazon-bedrock-mantle                                                                                                                                                                                                                                 |
+| [anthropic](/plugins/reference/anthropic)                           | Adds Anthropic model provider support to Nodmix.                                                                                                                   | `@nodmix/anthropic-provider`<br />included in Nodmix                                         | providers: anthropic; contracts: mediaUnderstandingProviders                                                                                                                                                                                                     |
+| [anthropic-vertex](/plugins/reference/anthropic-vertex)             | Adds Anthropic Vertex model provider support to Nodmix.                                                                                                            | `@nodmix/anthropic-vertex-provider`<br />npm; ClawHub                                          | providers: anthropic-vertex                                                                                                                                                                                                                                      |
+| [arcee](/plugins/reference/arcee)                                   | Adds Arcee model provider support to Nodmix.                                                                                                                       | `@nodmix/arcee-provider`<br />included in Nodmix                                             | providers: arcee                                                                                                                                                                                                                                                 |
+| [azure-speech](/plugins/reference/azure-speech)                     | Azure AI Speech text-to-speech (MP3, native Ogg/Opus voice notes, PCM telephony).                                                                                    | `@nodmix/azure-speech`<br />included in Nodmix                                               | contracts: speechProviders                                                                                                                                                                                                                                       |
+| [bonjour](/plugins/reference/bonjour)                               | Advertise the local Nodmix gateway over Bonjour/mDNS.                                                                                                              | `@nodmix/bonjour`<br />included in Nodmix                                                    | plugin                                                                                                                                                                                                                                                           |
+| [brave](/plugins/reference/brave)                                   | Adds web search provider support.                                                                                                                                    | `@nodmix/brave-plugin`<br />npm; ClawHub                                                       | contracts: webSearchProviders                                                                                                                                                                                                                                    |
+| [browser](/plugins/reference/browser)                               | Adds agent-callable tools.                                                                                                                                           | `@nodmix/browser-plugin`<br />included in Nodmix                                             | contracts: tools; skills                                                                                                                                                                                                                                         |
+| [byteplus](/plugins/reference/byteplus)                             | Adds BytePlus, BytePlus Plan model provider support to Nodmix.                                                                                                     | `@nodmix/byteplus-provider`<br />included in Nodmix                                          | providers: byteplus, byteplus-plan; contracts: videoGenerationProviders                                                                                                                                                                                          |
+| [canvas](/plugins/reference/canvas)                                 | Experimental Canvas control and A2UI rendering surfaces for paired nodes.                                                                                            | `@nodmix/canvas-plugin`<br />included in Nodmix                                              | contracts: tools                                                                                                                                                                                                                                                 |
+| [cerebras](/plugins/reference/cerebras)                             | Adds Cerebras model provider support to Nodmix.                                                                                                                    | `@nodmix/cerebras-provider`<br />included in Nodmix                                          | providers: cerebras                                                                                                                                                                                                                                              |
+| [chutes](/plugins/reference/chutes)                                 | Adds Chutes model provider support to Nodmix.                                                                                                                      | `@nodmix/chutes-provider`<br />included in Nodmix                                            | providers: chutes                                                                                                                                                                                                                                                |
+| [clickclack](/plugins/reference/clickclack)                         | Adds the Clickclack channel surface for sending and receiving Nodmix messages.                                                                                     | `@nodmix/clickclack`<br />included in Nodmix                                                 | channels: clickclack                                                                                                                                                                                                                                             |
+| [cloudflare-ai-gateway](/plugins/reference/cloudflare-ai-gateway)   | Adds Cloudflare AI Gateway model provider support to Nodmix.                                                                                                       | `@nodmix/cloudflare-ai-gateway-provider`<br />included in Nodmix                             | providers: cloudflare-ai-gateway                                                                                                                                                                                                                                 |
+| [codex](/plugins/reference/codex)                                   | Codex app-server harness and Codex-managed GPT model catalog.                                                                                                        | `@nodmix/codex`<br />npm; ClawHub                                                              | providers: codex; contracts: mediaUnderstandingProviders, migrationProviders                                                                                                                                                                                     |
+| [comfy](/plugins/reference/comfy)                                   | Adds ComfyUI model provider support to Nodmix.                                                                                                                     | `@nodmix/comfy-provider`<br />included in Nodmix                                             | providers: comfy; contracts: imageGenerationProviders, musicGenerationProviders, videoGenerationProviders                                                                                                                                                        |
+| [copilot-proxy](/plugins/reference/copilot-proxy)                   | Adds Copilot Proxy model provider support to Nodmix.                                                                                                               | `@nodmix/copilot-proxy`<br />included in Nodmix                                              | providers: copilot-proxy                                                                                                                                                                                                                                         |
+| [deepgram](/plugins/reference/deepgram)                             | Adds media understanding provider support. Adds realtime transcription provider support.                                                                             | `@nodmix/deepgram-provider`<br />included in Nodmix                                          | contracts: mediaUnderstandingProviders, realtimeTranscriptionProviders                                                                                                                                                                                           |
+| [deepinfra](/plugins/reference/deepinfra)                           | Adds DeepInfra model provider support to Nodmix.                                                                                                                   | `@nodmix/deepinfra-provider`<br />included in Nodmix                                         | providers: deepinfra; contracts: imageGenerationProviders, mediaUnderstandingProviders, memoryEmbeddingProviders, speechProviders, videoGenerationProviders                                                                                                      |
+| [deepseek](/plugins/reference/deepseek)                             | Adds DeepSeek model provider support to Nodmix.                                                                                                                    | `@nodmix/deepseek-provider`<br />included in Nodmix                                          | providers: deepseek                                                                                                                                                                                                                                              |
+| [diagnostics-otel](/plugins/reference/diagnostics-otel)             | Nodmix diagnostics OpenTelemetry exporter.                                                                                                                         | `@nodmix/diagnostics-otel`<br />npm; ClawHub: `clawhub:@nodmix/diagnostics-otel`             | plugin                                                                                                                                                                                                                                                           |
+| [diagnostics-prometheus](/plugins/reference/diagnostics-prometheus) | Nodmix diagnostics Prometheus exporter.                                                                                                                            | `@nodmix/diagnostics-prometheus`<br />npm; ClawHub: `clawhub:@nodmix/diagnostics-prometheus` | plugin                                                                                                                                                                                                                                                           |
+| [diffs](/plugins/reference/diffs)                                   | Read-only diff viewer and file renderer for agents.                                                                                                                  | `@nodmix/diffs`<br />npm; ClawHub                                                              | contracts: tools; skills                                                                                                                                                                                                                                         |
+| [discord](/plugins/reference/discord)                               | Adds the Discord channel surface for sending and receiving Nodmix messages.                                                                                        | `@nodmix/discord`<br />npm; ClawHub                                                            | channels: discord                                                                                                                                                                                                                                                |
+| [document-extract](/plugins/reference/document-extract)             | Extract text and fallback page images from local document attachments.                                                                                               | `@nodmix/document-extract-plugin`<br />included in Nodmix                                    | contracts: documentExtractors                                                                                                                                                                                                                                    |
+| [duckduckgo](/plugins/reference/duckduckgo)                         | Adds web search provider support.                                                                                                                                    | `@nodmix/duckduckgo-plugin`<br />included in Nodmix                                          | contracts: webSearchProviders                                                                                                                                                                                                                                    |
+| [elevenlabs](/plugins/reference/elevenlabs)                         | Adds media understanding provider support. Adds realtime transcription provider support. Adds text-to-speech provider support.                                       | `@nodmix/elevenlabs-speech`<br />included in Nodmix                                          | contracts: mediaUnderstandingProviders, realtimeTranscriptionProviders, speechProviders                                                                                                                                                                          |
+| [exa](/plugins/reference/exa)                                       | Adds web search provider support.                                                                                                                                    | `@nodmix/exa-plugin`<br />included in Nodmix                                                 | contracts: webSearchProviders                                                                                                                                                                                                                                    |
+| [fal](/plugins/reference/fal)                                       | Adds fal model provider support to Nodmix.                                                                                                                         | `@nodmix/fal-provider`<br />included in Nodmix                                               | providers: fal; contracts: imageGenerationProviders, musicGenerationProviders, videoGenerationProviders                                                                                                                                                          |
+| [feishu](/plugins/reference/feishu)                                 | Adds the Feishu channel surface for sending and receiving Nodmix messages.                                                                                         | `@nodmix/feishu`<br />npm; ClawHub                                                             | channels: feishu; contracts: tools; skills                                                                                                                                                                                                                       |
+| [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. | `@nodmix/file-transfer`<br />included in Nodmix                                              | contracts: tools                                                                                                                                                                                                                                                 |
+| [firecrawl](/plugins/reference/firecrawl)                           | Adds agent-callable tools. Adds web fetch provider support. Adds web search provider support.                                                                        | `@nodmix/firecrawl-plugin`<br />included in Nodmix                                           | contracts: tools, webFetchProviders, webSearchProviders                                                                                                                                                                                                          |
+| [fireworks](/plugins/reference/fireworks)                           | Adds Fireworks model provider support to Nodmix.                                                                                                                   | `@nodmix/fireworks-provider`<br />included in Nodmix                                         | providers: fireworks                                                                                                                                                                                                                                             |
+| [github-copilot](/plugins/reference/github-copilot)                 | Adds GitHub Copilot model provider support to Nodmix.                                                                                                              | `@nodmix/github-copilot-provider`<br />included in Nodmix                                    | providers: github-copilot; contracts: memoryEmbeddingProviders                                                                                                                                                                                                   |
+| [google](/plugins/reference/google)                                 | Adds Google, Google Gemini CLI, Google Vertex model provider support to Nodmix.                                                                                    | `@nodmix/google-plugin`<br />included in Nodmix                                              | providers: google, google-gemini-cli, google-vertex; contracts: imageGenerationProviders, mediaUnderstandingProviders, memoryEmbeddingProviders, musicGenerationProviders, realtimeVoiceProviders, speechProviders, videoGenerationProviders, webSearchProviders |
+| [google-meet](/plugins/reference/google-meet)                       | Join Google Meet calls through Chrome or Twilio transports.                                                                                                          | `@nodmix/google-meet`<br />npm; ClawHub                                                        | contracts: tools                                                                                                                                                                                                                                                 |
+| [googlechat](/plugins/reference/googlechat)                         | Adds the Google Chat channel surface for sending and receiving Nodmix messages.                                                                                    | `@nodmix/googlechat`<br />npm; ClawHub                                                         | channels: googlechat                                                                                                                                                                                                                                             |
+| [gradium](/plugins/reference/gradium)                               | Adds text-to-speech provider support.                                                                                                                                | `@nodmix/gradium-speech`<br />included in Nodmix                                             | contracts: speechProviders                                                                                                                                                                                                                                       |
+| [groq](/plugins/reference/groq)                                     | Adds Groq model provider support to Nodmix.                                                                                                                        | `@nodmix/groq-provider`<br />included in Nodmix                                              | providers: groq; contracts: mediaUnderstandingProviders                                                                                                                                                                                                          |
+| [huggingface](/plugins/reference/huggingface)                       | Adds Hugging Face model provider support to Nodmix.                                                                                                                | `@nodmix/huggingface-provider`<br />included in Nodmix                                       | providers: huggingface                                                                                                                                                                                                                                           |
+| [imessage](/plugins/reference/imessage)                             | Adds the iMessage channel surface for sending and receiving Nodmix messages.                                                                                       | `@nodmix/imessage`<br />included in Nodmix                                                   | channels: imessage                                                                                                                                                                                                                                               |
+| [inworld](/plugins/reference/inworld)                               | Inworld streaming text-to-speech (MP3, OGG_OPUS, PCM telephony).                                                                                                     | `@nodmix/inworld-speech`<br />included in Nodmix                                             | contracts: speechProviders                                                                                                                                                                                                                                       |
+| [irc](/plugins/reference/irc)                                       | Adds the IRC channel surface for sending and receiving Nodmix messages.                                                                                            | `@nodmix/irc`<br />included in Nodmix                                                        | channels: irc                                                                                                                                                                                                                                                    |
+| [kilocode](/plugins/reference/kilocode)                             | Adds Kilocode model provider support to Nodmix.                                                                                                                    | `@nodmix/kilocode-provider`<br />included in Nodmix                                          | providers: kilocode                                                                                                                                                                                                                                              |
+| [kimi](/plugins/reference/kimi)                                     | Adds Kimi, Kimi Coding model provider support to Nodmix.                                                                                                           | `@nodmix/kimi-provider`<br />included in Nodmix                                              | providers: kimi, kimi-coding                                                                                                                                                                                                                                     |
+| [line](/plugins/reference/line)                                     | Adds the LINE channel surface for sending and receiving Nodmix messages.                                                                                           | `@nodmix/line`<br />npm; ClawHub                                                               | channels: line                                                                                                                                                                                                                                                   |
+| [litellm](/plugins/reference/litellm)                               | Adds LiteLLM model provider support to Nodmix.                                                                                                                     | `@nodmix/litellm-provider`<br />included in Nodmix                                           | providers: litellm; contracts: imageGenerationProviders                                                                                                                                                                                                          |
+| [llm-task](/plugins/reference/llm-task)                             | Generic JSON-only LLM tool for structured tasks callable from workflows.                                                                                             | `@nodmix/llm-task`<br />included in Nodmix                                                   | contracts: tools                                                                                                                                                                                                                                                 |
+| [lmstudio](/plugins/reference/lmstudio)                             | Adds LM Studio model provider support to Nodmix.                                                                                                                   | `@nodmix/lmstudio-provider`<br />included in Nodmix                                          | providers: lmstudio; contracts: memoryEmbeddingProviders                                                                                                                                                                                                         |
+| [lobster](/plugins/reference/lobster)                               | Typed workflow tool with resumable approvals.                                                                                                                        | `@nodmix/lobster`<br />npm; ClawHub                                                            | contracts: tools                                                                                                                                                                                                                                                 |
+| [matrix](/plugins/reference/matrix)                                 | Adds the Matrix channel surface for sending and receiving Nodmix messages.                                                                                         | `@nodmix/matrix`<br />ClawHub: `clawhub:@nodmix/matrix`; npm                                 | channels: matrix                                                                                                                                                                                                                                                 |
+| [mattermost](/plugins/reference/mattermost)                         | Adds the Mattermost channel surface for sending and receiving Nodmix messages.                                                                                     | `@nodmix/mattermost`<br />included in Nodmix                                                 | channels: mattermost                                                                                                                                                                                                                                             |
+| [memory-core](/plugins/reference/memory-core)                       | Adds memory embedding provider support. Adds agent-callable tools.                                                                                                   | `@nodmix/memory-core`<br />included in Nodmix                                                | contracts: memoryEmbeddingProviders, tools                                                                                                                                                                                                                       |
+| [memory-lancedb](/plugins/reference/memory-lancedb)                 | Adds agent-callable tools.                                                                                                                                           | `@nodmix/memory-lancedb`<br />npm; ClawHub                                                     | contracts: tools                                                                                                                                                                                                                                                 |
+| [memory-wiki](/plugins/reference/memory-wiki)                       | Persistent wiki compiler and Obsidian-friendly knowledge vault for Nodmix.                                                                                         | `@nodmix/memory-wiki`<br />included in Nodmix                                                | contracts: tools; skills                                                                                                                                                                                                                                         |
+| [microsoft](/plugins/reference/microsoft)                           | Adds text-to-speech provider support.                                                                                                                                | `@nodmix/microsoft-speech`<br />included in Nodmix                                           | contracts: speechProviders                                                                                                                                                                                                                                       |
+| [microsoft-foundry](/plugins/reference/microsoft-foundry)           | Adds Microsoft Foundry model provider support to Nodmix.                                                                                                           | `@nodmix/microsoft-foundry`<br />included in Nodmix                                          | providers: microsoft-foundry                                                                                                                                                                                                                                     |
+| [migrate-claude](/plugins/reference/migrate-claude)                 | Imports Claude Code and Claude Desktop instructions, MCP servers, skills, and safe configuration into Nodmix.                                                      | `@nodmix/migrate-claude`<br />included in Nodmix                                             | contracts: migrationProviders                                                                                                                                                                                                                                    |
+| [migrate-hermes](/plugins/reference/migrate-hermes)                 | Imports Hermes configuration, memories, skills, and supported credentials into Nodmix.                                                                             | `@nodmix/migrate-hermes`<br />included in Nodmix                                             | contracts: migrationProviders                                                                                                                                                                                                                                    |
+| [minimax](/plugins/reference/minimax)                               | Adds MiniMax, MiniMax Portal model provider support to Nodmix.                                                                                                     | `@nodmix/minimax-provider`<br />included in Nodmix                                           | providers: minimax, minimax-portal; contracts: imageGenerationProviders, mediaUnderstandingProviders, musicGenerationProviders, speechProviders, videoGenerationProviders, webSearchProviders                                                                    |
+| [mistral](/plugins/reference/mistral)                               | Adds Mistral model provider support to Nodmix.                                                                                                                     | `@nodmix/mistral-provider`<br />included in Nodmix                                           | providers: mistral; contracts: mediaUnderstandingProviders, memoryEmbeddingProviders, realtimeTranscriptionProviders                                                                                                                                             |
+| [moonshot](/plugins/reference/moonshot)                             | Adds Moonshot model provider support to Nodmix.                                                                                                                    | `@nodmix/moonshot-provider`<br />included in Nodmix                                          | providers: moonshot; contracts: mediaUnderstandingProviders, webSearchProviders                                                                                                                                                                                  |
+| [msteams](/plugins/reference/msteams)                               | Adds the Microsoft Teams channel surface for sending and receiving Nodmix messages.                                                                                | `@nodmix/msteams`<br />npm; ClawHub                                                            | channels: msteams                                                                                                                                                                                                                                                |
+| [nextcloud-talk](/plugins/reference/nextcloud-talk)                 | Adds the Nextcloud Talk channel surface for sending and receiving Nodmix messages.                                                                                 | `@nodmix/nextcloud-talk`<br />npm; ClawHub                                                     | channels: nextcloud-talk                                                                                                                                                                                                                                         |
+| [nostr](/plugins/reference/nostr)                                   | Adds the Nostr channel surface for sending and receiving Nodmix messages.                                                                                          | `@nodmix/nostr`<br />npm; ClawHub                                                              | channels: nostr                                                                                                                                                                                                                                                  |
+| [nvidia](/plugins/reference/nvidia)                                 | Adds NVIDIA model provider support to Nodmix.                                                                                                                      | `@nodmix/nvidia-provider`<br />included in Nodmix                                            | providers: nvidia                                                                                                                                                                                                                                                |
+| [oc-path](/plugins/reference/oc-path)                               | Adds the nodmix path CLI for oc:// workspace file addressing.                                                                                                      | `@nodmix/oc-path`<br />included in Nodmix                                                    | plugin                                                                                                                                                                                                                                                           |
+| [ollama](/plugins/reference/ollama)                                 | Adds Ollama model provider support to Nodmix.                                                                                                                      | `@nodmix/ollama-provider`<br />included in Nodmix                                            | providers: ollama; contracts: memoryEmbeddingProviders, webSearchProviders                                                                                                                                                                                       |
+| [open-prose](/plugins/reference/open-prose)                         | OpenProse VM skill pack with a /prose slash command.                                                                                                                 | `@nodmix/open-prose`<br />included in Nodmix                                                 | skills                                                                                                                                                                                                                                                           |
+| [openai](/plugins/reference/openai)                                 | Adds OpenAI, OpenAI Codex model provider support to Nodmix.                                                                                                        | `@nodmix/openai-provider`<br />included in Nodmix                                            | providers: openai, openai-codex; contracts: imageGenerationProviders, mediaUnderstandingProviders, memoryEmbeddingProviders, realtimeTranscriptionProviders, realtimeVoiceProviders, speechProviders, videoGenerationProviders                                   |
+| [opencode](/plugins/reference/opencode)                             | Adds OpenCode model provider support to Nodmix.                                                                                                                    | `@nodmix/opencode-provider`<br />included in Nodmix                                          | providers: opencode; contracts: mediaUnderstandingProviders                                                                                                                                                                                                      |
+| [opencode-go](/plugins/reference/opencode-go)                       | Adds OpenCode Go model provider support to Nodmix.                                                                                                                 | `@nodmix/opencode-go-provider`<br />included in Nodmix                                       | providers: opencode-go; contracts: mediaUnderstandingProviders                                                                                                                                                                                                   |
+| [openrouter](/plugins/reference/openrouter)                         | Adds OpenRouter model provider support to Nodmix.                                                                                                                  | `@nodmix/openrouter-provider`<br />included in Nodmix                                        | providers: openrouter; contracts: imageGenerationProviders, mediaUnderstandingProviders, musicGenerationProviders, speechProviders, videoGenerationProviders                                                                                                     |
+| [openshell](/plugins/reference/openshell)                           | Sandbox backend powered by OpenShell with mirrored local workspaces and SSH-based command execution.                                                                 | `@nodmix/openshell-sandbox`<br />npm; ClawHub                                                  | plugin                                                                                                                                                                                                                                                           |
+| [perplexity](/plugins/reference/perplexity)                         | Adds web search provider support.                                                                                                                                    | `@nodmix/perplexity-plugin`<br />included in Nodmix                                          | contracts: webSearchProviders                                                                                                                                                                                                                                    |
+| [policy](/plugins/reference/policy)                                 | Adds policy-backed doctor checks for workspace conformance.                                                                                                          | `@nodmix/policy`<br />included in Nodmix                                                     | plugin                                                                                                                                                                                                                                                           |
+| [qa-channel](/plugins/reference/qa-channel)                         | Adds the QA Channel surface for sending and receiving Nodmix messages.                                                                                             | `@nodmix/qa-channel`<br />source checkout only                                                 | channels: qa-channel                                                                                                                                                                                                                                             |
+| [qa-lab](/plugins/reference/qa-lab)                                 | Nodmix QA lab plugin with private debugger UI and scenario runner.                                                                                                 | `@nodmix/qa-lab`<br />source checkout only                                                     | plugin                                                                                                                                                                                                                                                           |
+| [qa-matrix](/plugins/reference/qa-matrix)                           | Matrix QA transport runner and substrate.                                                                                                                            | `@nodmix/qa-matrix`<br />source checkout only                                                  | plugin                                                                                                                                                                                                                                                           |
+| [qianfan](/plugins/reference/qianfan)                               | Adds Qianfan model provider support to Nodmix.                                                                                                                     | `@nodmix/qianfan-provider`<br />included in Nodmix                                           | providers: qianfan                                                                                                                                                                                                                                               |
+| [qqbot](/plugins/reference/qqbot)                                   | Adds the QQ Bot channel surface for sending and receiving Nodmix messages.                                                                                         | `@nodmix/qqbot`<br />npm; ClawHub                                                              | channels: qqbot; contracts: tools; skills                                                                                                                                                                                                                        |
+| [qwen](/plugins/reference/qwen)                                     | Adds Qwen, Qwen Cloud, Model Studio, DashScope model provider support to Nodmix.                                                                                   | `@nodmix/qwen-provider`<br />included in Nodmix                                              | providers: qwen, qwencloud, modelstudio, dashscope; contracts: mediaUnderstandingProviders, videoGenerationProviders                                                                                                                                             |
+| [runway](/plugins/reference/runway)                                 | Adds video generation provider support.                                                                                                                              | `@nodmix/runway-provider`<br />included in Nodmix                                            | contracts: videoGenerationProviders                                                                                                                                                                                                                              |
+| [searxng](/plugins/reference/searxng)                               | Adds web search provider support.                                                                                                                                    | `@nodmix/searxng-plugin`<br />included in Nodmix                                             | contracts: webSearchProviders                                                                                                                                                                                                                                    |
+| [senseaudio](/plugins/reference/senseaudio)                         | Adds media understanding provider support.                                                                                                                           | `@nodmix/senseaudio-provider`<br />included in Nodmix                                        | contracts: mediaUnderstandingProviders                                                                                                                                                                                                                           |
+| [sglang](/plugins/reference/sglang)                                 | Adds SGLang model provider support to Nodmix.                                                                                                                      | `@nodmix/sglang-provider`<br />included in Nodmix                                            | providers: sglang                                                                                                                                                                                                                                                |
+| [signal](/plugins/reference/signal)                                 | Adds the Signal channel surface for sending and receiving Nodmix messages.                                                                                         | `@nodmix/signal`<br />included in Nodmix                                                     | channels: signal                                                                                                                                                                                                                                                 |
+| [skill-workshop](/plugins/reference/skill-workshop)                 | Captures repeatable workflows as workspace skills, with pending review, safe writes, and skill prompt refresh.                                                       | `@nodmix/skill-workshop`<br />included in Nodmix                                             | contracts: tools                                                                                                                                                                                                                                                 |
+| [slack](/plugins/reference/slack)                                   | Adds the Slack channel surface for sending and receiving Nodmix messages.                                                                                          | `@nodmix/slack`<br />npm; ClawHub                                                              | channels: slack                                                                                                                                                                                                                                                  |
+| [stepfun](/plugins/reference/stepfun)                               | Adds StepFun, StepFun Plan model provider support to Nodmix.                                                                                                       | `@nodmix/stepfun-provider`<br />included in Nodmix                                           | providers: stepfun, stepfun-plan                                                                                                                                                                                                                                 |
+| [synology-chat](/plugins/reference/synology-chat)                   | Adds the Synology Chat channel surface for sending and receiving Nodmix messages.                                                                                  | `@nodmix/synology-chat`<br />npm; ClawHub                                                      | channels: synology-chat                                                                                                                                                                                                                                          |
+| [synthetic](/plugins/reference/synthetic)                           | Adds Synthetic model provider support to Nodmix.                                                                                                                   | `@nodmix/synthetic-provider`<br />included in Nodmix                                         | providers: synthetic                                                                                                                                                                                                                                             |
+| [tavily](/plugins/reference/tavily)                                 | Adds agent-callable tools. Adds web search provider support.                                                                                                         | `@nodmix/tavily-plugin`<br />included in Nodmix                                              | contracts: tools, webSearchProviders; skills                                                                                                                                                                                                                     |
+| [telegram](/plugins/reference/telegram)                             | Adds the Telegram channel surface for sending and receiving Nodmix messages.                                                                                       | `@nodmix/telegram`<br />included in Nodmix                                                   | channels: telegram                                                                                                                                                                                                                                               |
+| [tencent](/plugins/reference/tencent)                               | Adds Tencent TokenHub model provider support to Nodmix.                                                                                                            | `@nodmix/tencent-provider`<br />included in Nodmix                                           | providers: tencent-tokenhub                                                                                                                                                                                                                                      |
+| [tlon](/plugins/reference/tlon)                                     | Adds the Tlon channel surface for sending and receiving Nodmix messages.                                                                                           | `@nodmix/tlon`<br />npm; ClawHub                                                               | channels: tlon; contracts: tools; skills                                                                                                                                                                                                                         |
+| [together](/plugins/reference/together)                             | Adds Together model provider support to Nodmix.                                                                                                                    | `@nodmix/together-provider`<br />included in Nodmix                                          | providers: together; contracts: videoGenerationProviders                                                                                                                                                                                                         |
+| [tokenjuice](/plugins/reference/tokenjuice)                         | Compacts exec and bash tool results with tokenjuice reducers.                                                                                                        | `@nodmix/tokenjuice`<br />included in Nodmix                                                 | contracts: agentToolResultMiddleware                                                                                                                                                                                                                             |
+| [tts-local-cli](/plugins/reference/tts-local-cli)                   | Adds text-to-speech provider support.                                                                                                                                | `@nodmix/tts-local-cli`<br />included in Nodmix                                              | contracts: speechProviders                                                                                                                                                                                                                                       |
+| [twitch](/plugins/reference/twitch)                                 | Adds the Twitch channel surface for sending and receiving Nodmix messages.                                                                                         | `@nodmix/twitch`<br />npm; ClawHub                                                             | channels: twitch                                                                                                                                                                                                                                                 |
+| [venice](/plugins/reference/venice)                                 | Adds Venice model provider support to Nodmix.                                                                                                                      | `@nodmix/venice-provider`<br />included in Nodmix                                            | providers: venice                                                                                                                                                                                                                                                |
+| [vercel-ai-gateway](/plugins/reference/vercel-ai-gateway)           | Adds Vercel AI Gateway model provider support to Nodmix.                                                                                                           | `@nodmix/vercel-ai-gateway-provider`<br />included in Nodmix                                 | providers: vercel-ai-gateway                                                                                                                                                                                                                                     |
+| [vllm](/plugins/reference/vllm)                                     | Adds vLLM model provider support to Nodmix.                                                                                                                        | `@nodmix/vllm-provider`<br />included in Nodmix                                              | providers: vllm                                                                                                                                                                                                                                                  |
+| [voice-call](/plugins/reference/voice-call)                         | Adds agent-callable tools.                                                                                                                                           | `@nodmix/voice-call`<br />npm; ClawHub                                                         | contracts: tools                                                                                                                                                                                                                                                 |
+| [volcengine](/plugins/reference/volcengine)                         | Adds Volcengine, Volcengine Plan model provider support to Nodmix.                                                                                                 | `@nodmix/volcengine-provider`<br />included in Nodmix                                        | providers: volcengine, volcengine-plan; contracts: speechProviders                                                                                                                                                                                               |
+| [voyage](/plugins/reference/voyage)                                 | Adds memory embedding provider support.                                                                                                                              | `@nodmix/voyage-provider`<br />included in Nodmix                                            | contracts: memoryEmbeddingProviders                                                                                                                                                                                                                              |
+| [vydra](/plugins/reference/vydra)                                   | Adds Vydra model provider support to Nodmix.                                                                                                                       | `@nodmix/vydra-provider`<br />included in Nodmix                                             | providers: vydra; contracts: imageGenerationProviders, speechProviders, videoGenerationProviders                                                                                                                                                                 |
+| [web-readability](/plugins/reference/web-readability)               | Extract readable article content from local HTML web fetch responses.                                                                                                | `@nodmix/web-readability-plugin`<br />included in Nodmix                                     | contracts: webContentExtractors                                                                                                                                                                                                                                  |
+| [webhooks](/plugins/reference/webhooks)                             | Authenticated inbound webhooks that bind external automation to Nodmix TaskFlows.                                                                                  | `@nodmix/webhooks`<br />included in Nodmix                                                   | plugin                                                                                                                                                                                                                                                           |
+| [whatsapp](/plugins/reference/whatsapp)                             | Adds the WhatsApp channel surface for sending and receiving Nodmix messages.                                                                                       | `@nodmix/whatsapp`<br />ClawHub: `clawhub:@nodmix/whatsapp`; npm                             | channels: whatsapp                                                                                                                                                                                                                                               |
+| [xai](/plugins/reference/xai)                                       | Adds xAI model provider support to Nodmix.                                                                                                                         | `@nodmix/xai-plugin`<br />included in Nodmix                                                 | providers: xai; contracts: imageGenerationProviders, mediaUnderstandingProviders, realtimeTranscriptionProviders, speechProviders, tools, videoGenerationProviders, webSearchProviders                                                                           |
+| [xiaomi](/plugins/reference/xiaomi)                                 | Adds Xiaomi model provider support to Nodmix.                                                                                                                      | `@nodmix/xiaomi-provider`<br />included in Nodmix                                            | providers: xiaomi; contracts: speechProviders                                                                                                                                                                                                                    |
+| [zai](/plugins/reference/zai)                                       | Adds Z.AI model provider support to Nodmix.                                                                                                                        | `@nodmix/zai-provider`<br />included in Nodmix                                               | providers: zai; contracts: mediaUnderstandingProviders                                                                                                                                                                                                           |
+| [zalo](/plugins/reference/zalo)                                     | Adds the Zalo channel surface for sending and receiving Nodmix messages.                                                                                           | `@nodmix/zalo`<br />npm; ClawHub                                                               | channels: zalo                                                                                                                                                                                                                                                   |
+| [zalouser](/plugins/reference/zalouser)                             | Adds the Zalo Personal channel surface for sending and receiving Nodmix messages.                                                                                  | `@nodmix/zalouser`<br />npm; ClawHub                                                           | channels: zalouser; contracts: tools                                                                                                                                                                                                                             |

package/docs/plugins/sdk-agent-harness.md

@@ -0,0 +1,339 @@
+---
+summary: "Experimental SDK surface for plugins that replace the low level embedded agent executor"
+title: "Agent harness plugins"
+sidebarTitle: "Agent Harness"
+read_when:
+  - You are changing the embedded agent runtime or harness registry
+  - You are registering an agent harness from a bundled or trusted plugin
+  - You need to understand how the Codex plugin relates to model providers
+---
+
+An **agent harness** is the low level executor for one prepared Nodmix agent
+turn. It is not a model provider, not a channel, and not a tool registry.
+For the user-facing mental model, see [Agent runtimes](/concepts/agent-runtimes).
+
+Use this surface only for bundled or trusted native plugins. The contract is
+still experimental because the parameter types intentionally mirror the current
+embedded runner.
+
+## When to use a harness
+
+Register an agent harness when a model family has its own native session
+runtime and the normal Nodmix provider transport is the wrong abstraction.
+
+Examples:
+
+- a native coding-agent server that owns threads and compaction
+- a local CLI or daemon that must stream native plan/reasoning/tool events
+- a model runtime that needs its own resume id in addition to the Nodmix
+  session transcript
+
+Do **not** register a harness just to add a new LLM API. For normal HTTP or
+WebSocket model APIs, build a [provider plugin](/plugins/sdk-provider-plugins).
+
+## What core still owns
+
+Before a harness is selected, Nodmix has already resolved:
+
+- provider and model
+- runtime auth state
+- thinking level and context budget
+- the Nodmix transcript/session file
+- workspace, sandbox, and tool policy
+- channel reply callbacks and streaming callbacks
+- model fallback and live model switching policy
+
+That split is intentional. A harness runs a prepared attempt; it does not pick
+providers, replace channel delivery, or silently switch models.
+
+The prepared attempt also includes `params.runtimePlan`, an Nodmix-owned
+policy bundle for runtime decisions that must stay shared across PI and native
+harnesses:
+
+- `runtimePlan.tools.normalize(...)` and
+  `runtimePlan.tools.logDiagnostics(...)` for provider-aware tool schema policy
+- `runtimePlan.transcript.resolvePolicy(...)` for transcript sanitization and
+  tool-call repair policy
+- `runtimePlan.delivery.isSilentPayload(...)` for shared `NO_REPLY` and media
+  delivery suppression
+- `runtimePlan.outcome.classifyRunResult(...)` for model fallback classification
+- `runtimePlan.observability` for resolved provider/model/harness metadata
+
+Harnesses may use the plan for decisions that need to match PI behavior, but
+should still treat it as host-owned attempt state. Do not mutate it or use it to
+switch providers/models inside a turn.
+
+## Register a harness
+
+**Import:** `nodmix/plugin-sdk/agent-harness`
+
+```typescript
+import type { AgentHarness } from "nodmix/plugin-sdk/agent-harness";
+import { definePluginEntry } from "nodmix/plugin-sdk/plugin-entry";
+
+const myHarness: AgentHarness = {
+  id: "my-harness",
+  label: "My native agent harness",
+
+  supports(ctx) {
+    return ctx.provider === "my-provider"
+      ? { supported: true, priority: 100 }
+      : { supported: false };
+  },
+
+  async runAttempt(params) {
+    // Start or resume your native thread.
+    // Use params.prompt, params.tools, params.images, params.onPartialReply,
+    // params.onAgentEvent, and the other prepared attempt fields.
+    return await runMyNativeTurn(params);
+  },
+};
+
+export default definePluginEntry({
+  id: "my-native-agent",
+  name: "My Native Agent",
+  description: "Runs selected models through a native agent daemon.",
+  register(api) {
+    api.registerAgentHarness(myHarness);
+  },
+});
+```
+
+## Selection policy
+
+Nodmix chooses a harness after provider/model resolution:
+
+1. Model-scoped runtime policy wins.
+2. Provider-scoped runtime policy comes next.
+3. `auto` asks registered harnesses if they support the resolved
+   provider/model.
+4. If no registered harness matches, Nodmix uses PI unless PI fallback is
+   disabled.
+
+Plugin harness failures surface as run failures. In `auto` mode, PI fallback is
+only used when no registered plugin harness supports the resolved
+provider/model. Once a plugin harness has claimed a run, Nodmix does not
+replay that same turn through PI because that can change auth/runtime semantics
+or duplicate side effects.
+
+Whole-session and whole-agent runtime pins are ignored by selection. That
+includes stale session `agentHarnessId` values, `agents.defaults.agentRuntime`,
+`agents.list[].agentRuntime`, and `NODMIX_AGENT_RUNTIME`. `/status` shows the
+effective runtime selected from the provider/model route.
+If the selected harness is surprising, enable `agents/harness` debug logging and
+inspect the gateway's structured `agent harness selected` record. It includes
+the selected harness id, selection reason, runtime/fallback policy, and, in
+`auto` mode, each plugin candidate's support result.
+
+The bundled Codex plugin registers `codex` as its harness id. Core treats that
+as an ordinary plugin harness id; Codex-specific aliases belong in the plugin
+or operator config, not in the shared runtime selector.
+
+## Provider plus harness pairing
+
+Most harnesses should also register a provider. The provider makes model refs,
+auth status, model metadata, and `/model` selection visible to the rest of
+Nodmix. The harness then claims that provider in `supports(...)`.
+
+The bundled Codex plugin follows this pattern:
+
+- preferred user model refs: `openai/gpt-5.5`
+- compatibility refs: legacy `codex/gpt-*` refs remain accepted, but new
+  configs should not use them as normal provider/model refs
+- harness id: `codex`
+- auth: synthetic provider availability, because the Codex harness owns the
+  native Codex login/session
+- app-server request: Nodmix sends the bare model id to Codex and lets the
+  harness talk to the native app-server protocol
+
+The Codex plugin is additive. Plain `openai/gpt-*` agent refs on the official
+OpenAI provider select the Codex harness by default. Older `codex/gpt-*` refs
+still select the Codex provider and harness for compatibility.
+
+For operator setup, model prefix examples, and Codex-only configs, see
+[Codex Harness](/plugins/codex-harness).
+
+Nodmix requires Codex app-server `0.125.0` or newer. The Codex plugin checks
+the app-server initialize handshake and blocks older or unversioned servers so
+Nodmix only runs against the protocol surface it has been tested with. The
+`0.125.0` floor includes the native MCP hook payload support that landed in
+Codex `0.124.0`, while pinning Nodmix to the newer tested stable line.
+
+### Tool-result middleware
+
+Bundled plugins can attach runtime-neutral tool-result middleware through
+`api.registerAgentToolResultMiddleware(...)` when their manifest declares the
+targeted runtime ids in `contracts.agentToolResultMiddleware`. This trusted
+seam is for async tool-result transforms that must run before PI or Codex feeds
+tool output back into the model.
+
+Legacy bundled plugins can still use
+`api.registerCodexAppServerExtensionFactory(...)` for Codex app-server-only
+middleware, but new result transforms should use the runtime-neutral API.
+The Pi-only `api.registerEmbeddedExtensionFactory(...)` hook has been removed;
+Pi tool-result transforms must use runtime-neutral middleware.
+
+### Terminal outcome classification
+
+Native harnesses that own their own protocol projection can use
+`classifyAgentHarnessTerminalOutcome(...)` from
+`nodmix/plugin-sdk/agent-harness-runtime` when a completed turn produced no
+visible assistant text. The helper returns `empty`, `reasoning-only`, or
+`planning-only` so Nodmix's fallback policy can decide whether to retry on a
+different model. It intentionally leaves prompt errors, in-flight turns, and
+intentional silent replies such as `NO_REPLY` unclassified.
+
+### Native Codex harness mode
+
+The bundled `codex` harness is the native Codex mode for embedded Nodmix
+agent turns. Enable the bundled `codex` plugin first, and include `codex` in
+`plugins.allow` if your config uses a restrictive allowlist. Native app-server
+configs should use `openai/gpt-*`; OpenAI agent turns select the Codex harness
+by default. Legacy `openai-codex/*` routes should be repaired with
+`nodmix doctor --fix`, and legacy `codex/*` model refs remain compatibility
+aliases for the native harness.
+
+When this mode runs, Codex owns the native thread id, resume behavior,
+compaction, and app-server execution. Nodmix still owns the chat channel,
+visible transcript mirror, tool policy, approvals, media delivery, and session
+selection. Use provider/model `agentRuntime.id: "codex"` when you need to prove
+that only the Codex app-server path can claim the run. Explicit plugin runtimes
+fail closed; Codex app-server selection failures and runtime failures are not
+retried through PI.
+
+## Runtime strictness
+
+By default, Nodmix uses `auto` provider/model runtime policy: registered
+plugin harnesses can claim a provider/model pair, and PI handles the turn when
+none match. OpenAI agent refs on the official OpenAI provider default to Codex.
+Use an explicit provider/model plugin runtime such as
+`agentRuntime.id: "codex"` when missing harness selection should fail instead
+of routing through PI. Selected plugin harness failures always fail hard. This
+does not block an explicit provider/model `agentRuntime.id: "pi"`.
+
+For Codex-only embedded runs:
+
+```json
+{
+  "models": {
+    "providers": {
+      "openai": {
+        "agentRuntime": {
+          "id": "codex"
+        }
+      }
+    }
+  },
+  "agents": {
+    "defaults": {
+      "model": "openai/gpt-5.5"
+    }
+  }
+}
+```
+
+If you want a CLI backend for one canonical model, put the runtime on that
+model entry:
+
+```json
+{
+  "agents": {
+    "defaults": {
+      "model": "anthropic/claude-opus-4-7",
+      "models": {
+        "anthropic/claude-opus-4-7": {
+          "agentRuntime": {
+            "id": "claude-cli"
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+Per-agent overrides use the same model-scoped shape:
+
+```json
+{
+  "agents": {
+    "list": [
+      {
+        "id": "codex-only",
+        "model": "openai/gpt-5.5",
+        "models": {
+          "openai/gpt-5.5": {
+            "agentRuntime": { "id": "codex" }
+          }
+        }
+      }
+    ]
+  }
+}
+```
+
+Legacy whole-agent runtime examples like this are ignored:
+
+```json
+{
+  "agents": {
+    "defaults": {
+      "agentRuntime": {
+        "id": "codex"
+      }
+    }
+  }
+}
+```
+
+With an explicit plugin runtime, a session fails early when the requested
+harness is not registered, does not support the resolved provider/model, or
+fails before producing turn side effects. That is intentional for Codex-only
+deployments and for live tests that must prove the Codex app-server path is
+actually in use.
+
+This setting only controls the embedded agent harness. It does not disable
+image, video, music, TTS, PDF, or other provider-specific model routing.
+
+## Native sessions and transcript mirror
+
+A harness may keep a native session id, thread id, or daemon-side resume token.
+Keep that binding explicitly associated with the Nodmix session, and keep
+mirroring user-visible assistant/tool output into the Nodmix transcript.
+
+The Nodmix transcript remains the compatibility layer for:
+
+- channel-visible session history
+- transcript search and indexing
+- switching back to the built-in PI harness on a later turn
+- generic `/new`, `/reset`, and session deletion behavior
+
+If your harness stores a sidecar binding, implement `reset(...)` so Nodmix can
+clear it when the owning Nodmix session is reset.
+
+## Tool and media results
+
+Core constructs the Nodmix tool list and passes it into the prepared attempt.
+When a harness executes a dynamic tool call, return the tool result back through
+the harness result shape instead of sending channel media yourself.
+
+This keeps text, image, video, music, TTS, approval, and messaging-tool outputs
+on the same delivery path as PI-backed runs.
+
+## Current limitations
+
+- The public import path is generic, but some attempt/result type aliases still
+  carry `Pi` names for compatibility.
+- Third-party harness installation is experimental. Prefer provider plugins
+  until you need a native session runtime.
+- Harness switching is supported across turns. Do not switch harnesses in the
+  middle of a turn after native tools, approvals, assistant text, or message
+  sends have started.
+
+## Related
+
+- [SDK Overview](/plugins/sdk-overview)
+- [Runtime Helpers](/plugins/sdk-runtime)
+- [Provider Plugins](/plugins/sdk-provider-plugins)
+- [Codex Harness](/plugins/codex-harness)
+- [Model Providers](/concepts/model-providers)