omnius 1.0.874 → 1.0.875

package/docs/DISCOVERY.json

@@ -22201,8 +22201,8 @@
           "description": "Show or manage the local API daemon"
         },
         {
-          "signature": "/daemon <start|stop|restart|takeover>",
-          "description": "Control the local API daemon"
+          "signature": "/daemon <status|diagnostics|start|stop|restart|takeover>",
+          "description": "Inspect startup diagnostics or control the local API daemon"
         }
       ],
       "subcommands": [],
@@ -22747,7 +22747,7 @@
       "id": "command.endpoint",
       "kind": "command",
       "title": "/endpoint",
-      "summary": "Show current endpoint",
+      "summary": "Select an endpoint or provider",
       "aliases": [
         "/endpoint",
         "endpoint",
@@ -22783,11 +22783,11 @@
       "signatures": [
         {
           "signature": "/endpoint",
-          "description": "Show current endpoint"
+          "description": "Select an endpoint or provider"
         },
         {
-          "signature": "/endpoint <url>",
-          "description": "Set backend URL (auto-detects type)"
+          "signature": "/endpoint <provider|alias|url>",
+          "description": "Set a provider name, alias, or backend URL"
         },
         {
           "signature": "/endpoint <url> --auth <t>",
@@ -24625,6 +24625,75 @@
         "Allowing an autonomous agent to invoke it without an explicit user action"
       ]
     },
+    {
+      "id": "command.mesh",
+      "kind": "command",
+      "title": "/mesh",
+      "summary": "Inspect trusted inference mesh routing and public identity",
+      "aliases": [
+        "/mesh",
+        "mesh"
+      ],
+      "keywords": [
+        "command",
+        "network",
+        "mesh"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "user",
+        "coding-agent",
+        "integrator"
+      ],
+      "interfaces": [
+        {
+          "type": "tui",
+          "target": "/mesh"
+        },
+        {
+          "type": "rest",
+          "target": "/v1/commands/mesh"
+        },
+        {
+          "type": "gateway-command",
+          "target": "/mesh"
+        },
+        {
+          "type": "agent-tool-command",
+          "target": "/mesh"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/tui/command-registry.ts",
+          "relation": "registry"
+        }
+      ],
+      "signatures": [
+        {
+          "signature": "/mesh [status|identity]",
+          "description": "Inspect trusted inference mesh routing and public identity"
+        }
+      ],
+      "subcommands": [],
+      "implementation_status": "implemented",
+      "surfaces": {
+        "tui": true,
+        "rest": true,
+        "gateway": true,
+        "agentTool": true
+      },
+      "safety": {
+        "userOnly": false,
+        "destructive": false,
+        "networked": false,
+        "secretBearing": false,
+        "profileGated": false
+      },
+      "avoid_when": []
+    },
     {
       "id": "command.metabolize",
       "kind": "command",
@@ -31305,6 +31374,38 @@
         }
       ]
     },
+    {
+      "id": "guide.guides-endpoint-requirements",
+      "kind": "guide",
+      "title": "Endpoint names and requirements",
+      "summary": "Checked against official provider documentation on 2026-10-17. This is a configuration matrix, not a claim of account access or successful inference. Provider models and access policies can change; use the authenticated model picker for your account. Selecting an endpoint must not silently choose a paid model.",
+      "keywords": [
+        "guides",
+        "endpoint",
+        "requirements",
+        "md"
+      ],
+      "maturity": "stable",
+      "audiences": [
+        "user",
+        "integrator",
+        "coding-agent"
+      ],
+      "layer": "documentation",
+      "interfaces": [
+        {
+          "type": "file",
+          "target": "docs/guides/endpoint-requirements.md"
+        }
+      ],
+      "references": [
+        {
+          "type": "documentation",
+          "target": "docs/guides/endpoint-requirements.md",
+          "relation": "canonical-artifact"
+        }
+      ]
+    },
     {
       "id": "guide.guides-long-horizon-feature-workflow",
       "kind": "guide",
@@ -31499,6 +31600,39 @@
         }
       ]
     },
+    {
+      "id": "guide.guides-sponsored-inference-mesh",
+      "kind": "guide",
+      "title": "Sponsored inference mesh",
+      "summary": "Omnius can route generation to explicitly trusted sponsors. A sponsor enables specific models, capacity and quotas; other trusted Omnius instances can use that capacity for their main agents, delegates and helpers through the same configured inference endpoint. Tools execute at the requesting instance. The sponsor runs generation only and does not receive a ",
+      "keywords": [
+        "guides",
+        "sponsored",
+        "inference",
+        "mesh",
+        "md"
+      ],
+      "maturity": "stable",
+      "audiences": [
+        "user",
+        "integrator",
+        "coding-agent"
+      ],
+      "layer": "documentation",
+      "interfaces": [
+        {
+          "type": "file",
+          "target": "docs/guides/sponsored-inference-mesh.md"
+        }
+      ],
+      "references": [
+        {
+          "type": "documentation",
+          "target": "docs/guides/sponsored-inference-mesh.md",
+          "relation": "canonical-artifact"
+        }
+      ]
+    },
     {
       "id": "guide.guides-system-tray",
       "kind": "guide",
@@ -34788,6 +34922,111 @@
         }
       ]
     },
+    {
+      "id": "guide.work-orders-evidence-endpoint-completion-verification-20261017",
+      "kind": "guide",
+      "title": "Endpoint Completion Verification 20261017",
+      "summary": "Bundled Omnius documentation artifact: docs/work-orders/evidence/endpoint-completion-verification-20261017.json.",
+      "keywords": [
+        "work",
+        "orders",
+        "evidence",
+        "endpoint",
+        "completion",
+        "verification",
+        "20261017",
+        "json"
+      ],
+      "maturity": "internal",
+      "audiences": [
+        "maintainer",
+        "large-context-agent"
+      ],
+      "layer": "documentation",
+      "interfaces": [
+        {
+          "type": "file",
+          "target": "docs/work-orders/evidence/endpoint-completion-verification-20261017.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "documentation",
+          "target": "docs/work-orders/evidence/endpoint-completion-verification-20261017.json",
+          "relation": "canonical-artifact"
+        }
+      ]
+    },
+    {
+      "id": "guide.work-orders-evidence-endpoint-source-verification-20261017",
+      "kind": "guide",
+      "title": "Endpoint Source Verification 20261017",
+      "summary": "Bundled Omnius documentation artifact: docs/work-orders/evidence/endpoint-source-verification-20261017.json.",
+      "keywords": [
+        "work",
+        "orders",
+        "evidence",
+        "endpoint",
+        "source",
+        "verification",
+        "20261017",
+        "json"
+      ],
+      "maturity": "internal",
+      "audiences": [
+        "maintainer",
+        "large-context-agent"
+      ],
+      "layer": "documentation",
+      "interfaces": [
+        {
+          "type": "file",
+          "target": "docs/work-orders/evidence/endpoint-source-verification-20261017.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "documentation",
+          "target": "docs/work-orders/evidence/endpoint-source-verification-20261017.json",
+          "relation": "canonical-artifact"
+        }
+      ]
+    },
+    {
+      "id": "guide.work-orders-evidence-expanded-variant-repair-20261017",
+      "kind": "guide",
+      "title": "Expanded Variant Repair 20261017",
+      "summary": "Bundled Omnius documentation artifact: docs/work-orders/evidence/expanded-variant-repair-20261017.json.",
+      "keywords": [
+        "work",
+        "orders",
+        "evidence",
+        "expanded",
+        "variant",
+        "repair",
+        "20261017",
+        "json"
+      ],
+      "maturity": "internal",
+      "audiences": [
+        "maintainer",
+        "large-context-agent"
+      ],
+      "layer": "documentation",
+      "interfaces": [
+        {
+          "type": "file",
+          "target": "docs/work-orders/evidence/expanded-variant-repair-20261017.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "documentation",
+          "target": "docs/work-orders/evidence/expanded-variant-repair-20261017.json",
+          "relation": "canonical-artifact"
+        }
+      ]
+    },
     {
       "id": "guide.work-orders-evidence-fallback-contract-cooldown-before-20261013",
       "kind": "guide",
@@ -38875,6 +39114,76 @@
         }
       ]
     },
+    {
+      "id": "guide.work-orders-evidence-mesh-source-verification-20261017",
+      "kind": "guide",
+      "title": "Mesh Source Verification 20261017",
+      "summary": "Bundled Omnius documentation artifact: docs/work-orders/evidence/mesh-source-verification-20261017.json.",
+      "keywords": [
+        "work",
+        "orders",
+        "evidence",
+        "mesh",
+        "source",
+        "verification",
+        "20261017",
+        "json"
+      ],
+      "maturity": "internal",
+      "audiences": [
+        "maintainer",
+        "large-context-agent"
+      ],
+      "layer": "documentation",
+      "interfaces": [
+        {
+          "type": "file",
+          "target": "docs/work-orders/evidence/mesh-source-verification-20261017.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "documentation",
+          "target": "docs/work-orders/evidence/mesh-source-verification-20261017.json",
+          "relation": "canonical-artifact"
+        }
+      ]
+    },
+    {
+      "id": "guide.work-orders-evidence-mesh-transport-verification-20261017",
+      "kind": "guide",
+      "title": "Mesh Transport Verification 20261017",
+      "summary": "Bundled Omnius documentation artifact: docs/work-orders/evidence/mesh-transport-verification-20261017.json.",
+      "keywords": [
+        "work",
+        "orders",
+        "evidence",
+        "mesh",
+        "transport",
+        "verification",
+        "20261017",
+        "json"
+      ],
+      "maturity": "internal",
+      "audiences": [
+        "maintainer",
+        "large-context-agent"
+      ],
+      "layer": "documentation",
+      "interfaces": [
+        {
+          "type": "file",
+          "target": "docs/work-orders/evidence/mesh-transport-verification-20261017.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "documentation",
+          "target": "docs/work-orders/evidence/mesh-transport-verification-20261017.json",
+          "relation": "canonical-artifact"
+        }
+      ]
+    },
     {
       "id": "guide.work-orders-evidence-native-completion-presentation-verification-20261016",
       "kind": "guide",
@@ -40100,6 +40409,41 @@
         }
       ]
     },
+    {
+      "id": "guide.work-orders-evidence-opencode-endpoint-regression-20261017",
+      "kind": "guide",
+      "title": "Opencode Endpoint Regression 20261017",
+      "summary": "Bundled Omnius documentation artifact: docs/work-orders/evidence/opencode-endpoint-regression-20261017.json.",
+      "keywords": [
+        "work",
+        "orders",
+        "evidence",
+        "opencode",
+        "endpoint",
+        "regression",
+        "20261017",
+        "json"
+      ],
+      "maturity": "internal",
+      "audiences": [
+        "maintainer",
+        "large-context-agent"
+      ],
+      "layer": "documentation",
+      "interfaces": [
+        {
+          "type": "file",
+          "target": "docs/work-orders/evidence/opencode-endpoint-regression-20261017.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "documentation",
+          "target": "docs/work-orders/evidence/opencode-endpoint-regression-20261017.json",
+          "relation": "canonical-artifact"
+        }
+      ]
+    },
     {
       "id": "guide.work-orders-evidence-opencode-installed-production-stream-live-20261012",
       "kind": "guide",
@@ -41154,6 +41498,42 @@
         }
       ]
     },
+    {
+      "id": "guide.work-orders-evidence-sticky-catalog-candidate-release-20261017",
+      "kind": "guide",
+      "title": "Sticky Catalog Candidate Release 20261017",
+      "summary": "Bundled Omnius documentation artifact: docs/work-orders/evidence/sticky-catalog-candidate-release-20261017.json.",
+      "keywords": [
+        "work",
+        "orders",
+        "evidence",
+        "sticky",
+        "catalog",
+        "candidate",
+        "release",
+        "20261017",
+        "json"
+      ],
+      "maturity": "internal",
+      "audiences": [
+        "maintainer",
+        "large-context-agent"
+      ],
+      "layer": "documentation",
+      "interfaces": [
+        {
+          "type": "file",
+          "target": "docs/work-orders/evidence/sticky-catalog-candidate-release-20261017.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "documentation",
+          "target": "docs/work-orders/evidence/sticky-catalog-candidate-release-20261017.json",
+          "relation": "canonical-artifact"
+        }
+      ]
+    },
     {
       "id": "guide.work-orders-evidence-task-observability-state-verification-20261017",
       "kind": "guide",
@@ -50416,7 +50796,7 @@
       },
       "paths": {
         "chat": "/inference/openai/v1/chat/completions",
-        "models": "/inference/openai/v1/models"
+        "models": "/inference/v1/models"
       }
     },
     {
@@ -50862,6 +51242,44 @@
         "operation.hardware-preflight"
       ]
     },
+    {
+      "id": "provider.mesh",
+      "kind": "provider",
+      "title": "Sponsored inference mesh",
+      "summary": "Sponsored inference mesh inference through openai-chat.",
+      "aliases": [],
+      "keywords": [
+        "provider",
+        "inference",
+        "api key",
+        "openai-chat"
+      ],
+      "interfaces": [
+        {
+          "type": "provider-protocol",
+          "target": "openai-chat"
+        },
+        {
+          "type": "endpoint",
+          "target": "http://127.0.0.1:11436/v1"
+        }
+      ],
+      "capabilities": [
+        "chat",
+        "streaming",
+        "models",
+        "tools",
+        "structured-output"
+      ],
+      "auth": {
+        "strategy": "bearer",
+        "required": true
+      },
+      "paths": {
+        "chat": "/v1/chat/completions",
+        "models": "/v1/models"
+      }
+    },
     {
       "id": "provider.mistral",
       "kind": "provider",
@@ -51193,7 +51611,7 @@
         },
         {
           "type": "endpoint",
-          "target": "https://api.together.xyz/v1"
+          "target": "https://api.together.ai/v1"
         }
       ],
       "capabilities": [

package/docs/DISCOVERY.md

@@ -316,7 +316,7 @@ Daemon equivalents are `GET /v1/discovery/bootstrap`, `GET /v1/discovery?q=<inte
 | `command.docs` | Open the documentation overview | Print the human-readable Omnius documentation and discovery entrypoints. |
 | `command.dream` | /dream | Start dream mode - creative idle exploration (writes to .omnius/dreams/) |
 | `command.emojis` | /emojis | Toggle emoji rendering in TUI messages |
-| `command.endpoint` | /endpoint | Show current endpoint |
+| `command.endpoint` | /endpoint | Select an endpoint or provider |
 | `command.evaluate` | /evaluate | Evaluate last completed task (LLM quality scoring) |
 | `command.expose` | /expose | Expose local inference via libp2p (default) |
 | `command.fallback` | /fallback | Show remote inference fallback mode |
@@ -340,6 +340,7 @@ Daemon equivalents are `GET /v1/discovery/bootstrap`, `GET /v1/discovery?q=<inte
 | `command.livechat` | /livechat | Alias for /live chat, used by the top live button |
 | `command.mcp` | /mcp | Show MCP server/tool status and controls |
 | `command.memory` | /memory | Open the interactive memory pixel map and provenance trace |
+| `command.mesh` | /mesh | Inspect trusted inference mesh routing and public identity |
 | `command.metabolize` | /metabolize | Run memory maintenance: import deferred memory, prune episodes, compact graph stores |
 | `command.metrics` | /metrics | Show runtime metrics: tokens, context window, throughput, and tool usage |
 | `command.model` | /model | Select from available models |
@@ -461,12 +462,14 @@ Daemon equivalents are `GET /v1/discovery/bootstrap`, `GET /v1/discovery?q=<inte
 | `guide.guides-agent-integration` | Agent And Service Integration | An integration should discover Omnius at runtime instead of encoding a partial provider or tool list. |
 | `guide.guides-bring-your-own-inference` | Bring Your Own Inference | Omnius routes local and hosted models through an explicit provider descriptor. The descriptor determines the wire protocol, URL paths, authentication headers, and supported operations. It is the source of truth used by setup, model discovery, TUI runs, REST chat, summaries, voice, Telegram, sponsors, and endpoint probes. |
 | `guide.guides-dashboard` | Web Dashboard | The Omnius daemon serves a zero-build, self-contained dashboard from the same origin as the REST API. Start it with omnius serve, then open http://127.0.0.1:11435/. The interface uses Omnius's compact NOCLIP-derived style kit and shared responsive observability-card grids; the route registry in packages/cli/src/api/web-ui.ts is the source of truth for pages  |
+| `guide.guides-endpoint-requirements` | Endpoint names and requirements | Checked against official provider documentation on 2026-10-17. This is a configuration matrix, not a claim of account access or successful inference. Provider models and access policies can change; use the authenticated model picker for your account. Selecting an endpoint must not silently choose a paid model. |
 | `guide.guides-long-horizon-feature-workflow` | Long-horizon feature work | Implementation, acceptance cases and delivery records are tracked in WO-01. |
 | `guide.guides-media-generation` | Media Generation | Omnius exposes media generation through TUI commands, tools, Telegram creative workflows, and sponsor media endpoints. |
 | `guide.guides-osint-research` | Categorized OSINT research | Omnius ships a local, searchable snapshot of the OSINT4ALL Start.me page. It uses the same compact discovery pattern as AIWG skills: |
 | `guide.guides-pdf-collections` | Large PDF collections | Ask Omnius to process the collection in ordinary language, specifying the result you need: search, ordering, original-page manipulation, summary, or extraction. For example: “Review every supplied PDF, extract each recorded duration with its source page, order the documents by the invoice date, and deliver the complete results.” A field's meaning, units, mis |
 | `guide.guides-realtime` | Realtime Conversations | Realtime mode is for short, natural, back-and-forth spoken conversation behind ASR and TTS. |
 | `guide.guides-sponsor-and-cohere` | Sponsor And COHERE Mesh | Sponsor and COHERE let Omnius share inference capacity across peers. Sponsor mode is explicit provider/consumer sharing. COHERE is a distributed cognitive inference mesh. |
+| `guide.guides-sponsored-inference-mesh` | Sponsored inference mesh | Omnius can route generation to explicitly trusted sponsors. A sponsor enables specific models, capacity and quotas; other trusted Omnius instances can use that capacity for their main agents, delegates and helpers through the same configured inference endpoint. Tools execute at the requesting instance. The sponsor runs generation only and does not receive a  |
 | `guide.guides-system-tray` | System Tray Indicator | Omnius ships a native per-login tray indicator for Linux, macOS, and Windows on x64 hosts. It is separate from the REST daemon: closing the indicator never stops the daemon, and the daemon remains usable in headless sessions. |
 | `guide.guides-telegram` | Telegram Bridge | The Telegram bridge is a scoped public ingress and egress layer. It supports admin DMs, admin group mode, public group mode, media intake, generated artifact return, scoped memory, and persona documents. |
 | `guide.guides-tools-and-web-search` | Tools And Web Search | Omnius has two related tool surfaces: |
@@ -566,6 +569,9 @@ Daemon equivalents are `GET /v1/discovery/bootstrap`, `GET /v1/discovery?q=<inte
 | `guide.work-orders-evidence-dashboard-browser-reconstruction-20261016` | Dashboard Browser Reconstruction 20261016 | Bundled Omnius documentation artifact: docs/work-orders/evidence/dashboard-browser-reconstruction-20261016.json. |
 | `guide.work-orders-evidence-dashboard-media-management-20261016` | Dashboard Media Management 20261016 | Bundled Omnius documentation artifact: docs/work-orders/evidence/dashboard-media-management-20261016.json. |
 | `guide.work-orders-evidence-desktop-indicator-registration-20261016` | Desktop Indicator Registration 20261016 | Bundled Omnius documentation artifact: docs/work-orders/evidence/desktop-indicator-registration-20261016.json. |
+| `guide.work-orders-evidence-endpoint-completion-verification-20261017` | Endpoint Completion Verification 20261017 | Bundled Omnius documentation artifact: docs/work-orders/evidence/endpoint-completion-verification-20261017.json. |
+| `guide.work-orders-evidence-endpoint-source-verification-20261017` | Endpoint Source Verification 20261017 | Bundled Omnius documentation artifact: docs/work-orders/evidence/endpoint-source-verification-20261017.json. |
+| `guide.work-orders-evidence-expanded-variant-repair-20261017` | Expanded Variant Repair 20261017 | Bundled Omnius documentation artifact: docs/work-orders/evidence/expanded-variant-repair-20261017.json. |
 | `guide.work-orders-evidence-fallback-contract-cooldown-before-20261013` | Fallback Contract Cooldown Before 20261013 | Bundled Omnius documentation artifact: docs/work-orders/evidence/fallback-contract-cooldown-before-20261013.json. |
 | `guide.work-orders-evidence-fallback-model-benchmarks-20261012` | Fallback Model Benchmarks 20261012 | Bundled Omnius documentation artifact: docs/work-orders/evidence/fallback-model-benchmarks-20261012.json. |
 | `guide.work-orders-evidence-fallback-quality-installed-20261012` | Fallback Quality Installed 20261012 | Bundled Omnius documentation artifact: docs/work-orders/evidence/fallback-quality-installed-20261012.json. |
@@ -678,6 +684,8 @@ Daemon equivalents are `GET /v1/discovery/bootstrap`, `GET /v1/discovery?q=<inte
 | `guide.work-orders-evidence-kilo-production-compatibility-20261012` | Kilo Production Compatibility 20261012 | Bundled Omnius documentation artifact: docs/work-orders/evidence/kilo-production-compatibility-20261012.json. |
 | `guide.work-orders-evidence-local-admission-provider-regression-20261014` | Local Admission Provider Regression 20261014 | Bundled Omnius documentation artifact: docs/work-orders/evidence/local-admission-provider-regression-20261014.json. |
 | `guide.work-orders-evidence-local-recovery-production-routes-20261014` | Local Recovery Production Routes 20261014 | Bundled Omnius documentation artifact: docs/work-orders/evidence/local-recovery-production-routes-20261014.json. |
+| `guide.work-orders-evidence-mesh-source-verification-20261017` | Mesh Source Verification 20261017 | Bundled Omnius documentation artifact: docs/work-orders/evidence/mesh-source-verification-20261017.json. |
+| `guide.work-orders-evidence-mesh-transport-verification-20261017` | Mesh Transport Verification 20261017 | Bundled Omnius documentation artifact: docs/work-orders/evidence/mesh-transport-verification-20261017.json. |
 | `guide.work-orders-evidence-native-completion-presentation-verification-20261016` | Native Completion Presentation Verification 20261016 | Bundled Omnius documentation artifact: docs/work-orders/evidence/native-completion-presentation-verification-20261016.json. |
 | `guide.work-orders-evidence-native-conversation-prompt-audit-20261012` | Native Conversation Prompt Audit 20261012 | Bundled Omnius documentation artifact: docs/work-orders/evidence/native-conversation-prompt-audit-20261012.json. |
 | `guide.work-orders-evidence-native-goal-contract-probe-20261012` | Native Goal Contract Probe 20261012 | Bundled Omnius documentation artifact: docs/work-orders/evidence/native-goal-contract-probe-20261012.json. |
@@ -712,6 +720,7 @@ Daemon equivalents are `GET /v1/discovery/bootstrap`, `GET /v1/discovery?q=<inte
 | `guide.work-orders-evidence-omni-analysis-phone-model-20261017` | Omni Analysis Phone Model 20261017 | Bundled Omnius documentation artifact: docs/work-orders/evidence/omni-analysis-phone-model-20261017.png. |
 | `guide.work-orders-evidence-opencode-all-free-audit-20261012` | Opencode All Free Audit 20261012 | Bundled Omnius documentation artifact: docs/work-orders/evidence/opencode-all-free-audit-20261012.json. |
 | `guide.work-orders-evidence-opencode-all-free-installed-verification-20261012` | Opencode All Free Installed Verification 20261012 | Bundled Omnius documentation artifact: docs/work-orders/evidence/opencode-all-free-installed-verification-20261012.json. |
+| `guide.work-orders-evidence-opencode-endpoint-regression-20261017` | Opencode Endpoint Regression 20261017 | Bundled Omnius documentation artifact: docs/work-orders/evidence/opencode-endpoint-regression-20261017.json. |
 | `guide.work-orders-evidence-opencode-installed-production-stream-live-20261012` | Opencode Installed Production Stream Live 20261012 | Bundled Omnius documentation artifact: docs/work-orders/evidence/opencode-installed-production-stream-live-20261012.json. |
 | `guide.work-orders-evidence-opencode-production-cascade-live-20261012` | Opencode Production Cascade Live 20261012 | Bundled Omnius documentation artifact: docs/work-orders/evidence/opencode-production-cascade-live-20261012.json. |
 | `guide.work-orders-evidence-opencode-production-compatibility-20261012` | Opencode Production Compatibility 20261012 | Bundled Omnius documentation artifact: docs/work-orders/evidence/opencode-production-compatibility-20261012.json. |
@@ -741,6 +750,7 @@ Daemon equivalents are `GET /v1/discovery/bootstrap`, `GET /v1/discovery?q=<inte
 | `guide.work-orders-evidence-session-transcript-light-320-session-image` | Session Transcript Light 320 Session Image | Bundled Omnius documentation artifact: docs/work-orders/evidence/session-transcript-light-320-session-image.png. |
 | `guide.work-orders-evidence-session-transcript-light-320-session-working` | Session Transcript Light 320 Session Working | Bundled Omnius documentation artifact: docs/work-orders/evidence/session-transcript-light-320-session-working.png. |
 | `guide.work-orders-evidence-source-hierarchy-installed-20261013` | Source Hierarchy Installed 20261013 | Bundled Omnius documentation artifact: docs/work-orders/evidence/source-hierarchy-installed-20261013.json. |
+| `guide.work-orders-evidence-sticky-catalog-candidate-release-20261017` | Sticky Catalog Candidate Release 20261017 | Bundled Omnius documentation artifact: docs/work-orders/evidence/sticky-catalog-candidate-release-20261017.json. |
 | `guide.work-orders-evidence-task-observability-state-verification-20261017` | Task Observability State Verification 20261017 | Bundled Omnius documentation artifact: docs/work-orders/evidence/task-observability-state-verification-20261017.json. |
 | `guide.work-orders-evidence-telegram-all-free-live-20261013` | Telegram All Free Live 20261013 | Bundled Omnius documentation artifact: docs/work-orders/evidence/telegram-all-free-live-20261013.json. |
 | `guide.work-orders-evidence-telegram-completion-review-live-20261013` | Telegram Completion Review Live 20261013 | Bundled Omnius documentation artifact: docs/work-orders/evidence/telegram-completion-review-live-20261013.json. |
@@ -1010,6 +1020,7 @@ Daemon equivalents are `GET /v1/discovery/bootstrap`, `GET /v1/discovery?q=<inte
 | `provider.groq` | Groq | Groq hosted inference through its OpenAI-compatible API. |
 | `provider.hyperbolic` | Hyperbolic | Hyperbolic hosted models through an OpenAI-compatible API. |
 | `provider.lmstudio` | LM Studio | A local OpenAI-compatible LM Studio server, normally on port 1234. |
+| `provider.mesh` | Sponsored inference mesh | Sponsored inference mesh inference through openai-chat. |
 | `provider.mistral` | Mistral AI | Mistral hosted models through an OpenAI-compatible API. |
 | `provider.nvidia` | NVIDIA NIM | NVIDIA-hosted NIM models through an OpenAI-compatible API. |
 | `provider.ollama` | Ollama | Local Ollama inference using native Ollama model, chat, generate, and embeddings paths. |

package/docs/guides/endpoint-requirements.md

@@ -0,0 +1,33 @@
+# Endpoint names and requirements
+
+Checked against official provider documentation on 2026-10-17. This is a configuration matrix, not a claim of account access or successful inference. Provider models and access policies can change; use the authenticated model picker for your account. Selecting an endpoint must not silently choose a paid model.
+
+Type `/endpoint` to inspect choices or `/endpoint <name>` for a registered provider. Names and aliases are case-insensitive. An existing configured endpoint for the same provider retains its custom URL/port and exact-scope credentials. Switching providers clears the old credential/key pool; required missing keys use the existing secret input. Explicit URLs and custom protocol configuration remain available.
+
+For example, use `/endpoint ollama`, `/endpoint openai`, `/endpoint claude` or `/endpoint gemini`. Type a prefix such as `/endpoint cl` and choose a suggestion with Tab or the pointer; completion fills the input without connecting. Enter applies the command. Add `--local` to save an endpoint only for the current project. Required keys are entered through the secret prompt, rather than placed in the command history.
+
+| Name / aliases | Default base URL | Protocol and credential requirement | Official source |
+| --- | --- | --- | --- |
+| `ollama` | `http://127.0.0.1:11434` | Native Ollama. Local API has no default authentication; an authenticated proxy may require its own token. Server and selected model must exist. Cloud models have separate Ollama sign-in/key requirements. | [Authentication](https://docs.ollama.com/api/authentication) |
+| `lmstudio`, `lm-studio` | `http://127.0.0.1:1234/v1` | OpenAI-compatible local server; start its server and select a model. Send a bearer token when server authentication is enabled. | [Compatibility](https://lmstudio.ai/docs/developer/openai-compat), [authentication](https://lmstudio.ai/docs/developer/core/authentication) |
+| `vllm`, `v-llm` | `http://127.0.0.1:8000/v1` | OpenAI-compatible serving endpoint. Use the server's bearer key if configured; exact model, chat template and tool parser depend on that deployment. Setup does not start a CUDA service. | [Server](https://docs.vllm.ai/en/latest/serving/online_serving/openai_compatible_server/), [server flags](https://docs.vllm.ai/en/latest/cli/serve/) |
+| `openai` | `https://api.openai.com/v1` | OpenAI Chat Completions; your API bearer credential and authorized model. Organization/project selection can require additional account-scoping headers. | [API authentication](https://developers.openai.com/api/reference/overview), [chat API](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create) |
+| `anthropic`, `claude` | `https://api.anthropic.com/v1` | Anthropic Messages; `x-api-key` plus `anthropic-version: 2023-06-01`. This preset uses workspace-bound API keys; multi-workspace keys require an additional workspace header and are not implied by entering a key alone. | [API overview](https://platform.claude.com/docs/en/api/overview) |
+| `gemini`, `google`, `google-ai` | `https://generativelanguage.googleapis.com/v1beta/openai` | Gemini's OpenAI-compatible API, with your Gemini API key as bearer credential; not its distinct native request schema. | [OpenAI compatibility](https://ai.google.dev/gemini-api/docs/openai) |
+| `openrouter` | `https://openrouter.ai/api/v1` | OpenAI-compatible bearer API key. Referral/title headers are optional. Account credit/limits and selected model pricing remain authoritative. | [Authentication](https://openrouter.ai/docs/api_reference/authentication) |
+| `groq` | `https://api.groq.com/openai/v1` | OpenAI-compatible API with your Groq API key. Provider compatibility and model capabilities still apply. | [Compatibility](https://console.groq.com/docs/openai) |
+| `deepinfra` | `https://api.deepinfra.com/v1/openai` | OpenAI-compatible API with your DeepInfra token and an exact catalog model. | [Chat API](https://docs.deepinfra.com/chat/overview) |
+| `fireworks`, `fireworks-ai` | `https://api.fireworks.ai/inference/v1` | OpenAI-compatible API with bearer API key and accessible model/deployment. | [Chat endpoint](https://docs.fireworks.ai/api-reference/post-chatcompletions), [authentication](https://docs.fireworks.ai/api-reference/introduction) |
+| `together`, `together-ai` | `https://api.together.ai/v1` | OpenAI-compatible API with your Together API key. Recognize previously saved `api.together.xyz` URLs without silently replacing an explicit configured endpoint. | [Compatibility](https://docs.together.ai/docs/inference/openai-compatibility) |
+| `chutes`, `chutes-ai` | `https://llm.chutes.ai/v1` | OpenAI-compatible API with bearer Chutes key. Use concrete catalog model IDs; saved routing aliases need account-side configuration. | [Agent connection requirements](https://chutes.ai/agents/connect) |
+| `mistral`, `mistral-ai` | `https://api.mistral.ai/v1` | OpenAI-compatible chat API and your Mistral bearer API key; account mode, model access and rate limits apply. | [API key setup](https://docs.mistral.ai/getting-started/quickstarts/studio/activate-and-generate-api-key) |
+| `cerebras` | `https://api.cerebras.ai/v1` | OpenAI-compatible API with your Cerebras key. Shared inference uses exact model IDs; dedicated inference can use an endpoint ID. | [Compatibility](https://inference-docs.cerebras.ai/resources/openai) |
+| `sambanova`, `samba-nova` | `https://api.sambanova.ai/v1` | SambaCloud OpenAI-compatible bearer API key. Dedicated endpoints may use a different base URL; legacy SambaStudio APIs have different requirements and are not this preset. | [Official integration](https://docs.sambanova.ai/docs/en/integrations/vscode) |
+| `nvidia`, `nvidia-nim`, `nim` | `https://integrate.api.nvidia.com/v1` | NVIDIA hosted OpenAI-compatible chat API and bearer NVIDIA API key with model access/credit. Self-hosted NIM endpoints are explicitly configured URLs. | [Hosted chat reference](https://docs.api.nvidia.com/nim/reference/stepfun-ai-step-5-preview-infer) |
+| `builtin-free` | `https://opencode.ai/inference/openai/v1` | Published public access remains subject to provider permission. Discovery is separately pinned to `/inference/v1/models`. Current independent Omnius and genuine OpenCode controls returned403; catalog membership does not establish usable generation. | [Inference API](https://opencode.ai/v2/docs/console/api/inference/) |
+| `mesh` | Configured loopback gateway; default `http://127.0.0.1:11436/v1` | Omnius OpenAI-compatible sponsored inference. On explicit selection, read the enabled owner-private default mesh configuration and its gateway token. Existing explicitly configured mesh URLs retain their own credential scope. The gateway must already be running; endpoint selection starts no service. | [Setup and trust boundaries](sponsored-inference-mesh.md) |
+| `hyperbolic` | Retired serverless preset | Official documentation says the old inference API and playground are retired, and old requests fail even with valid keys. Do not offer this as a working shortcut. Operator-hosted replacement servers use an explicit custom URL/protocol. | [Retirement notice](https://www.hyperbolic.ai/docs/faq/inference-models) |
+
+Custom endpoints require a URL and an explicit supported protocol when detection is ambiguous: `ollama`, `openai-chat`, or `anthropic-messages`. A local server's optional bearer authentication is not a reason to discard a supplied credential. No API key is inferred from a different provider, and endpoint discovery does not perform generation, model downloads or hardware deployment.
+
+The standard presets cover the auth forms above. They do not claim every provider's OAuth, federation, multi-workspace, tenant or administrative API is implemented. Configure a supported scoped API credential or an explicitly authorized compatible gateway for those deployments.