docs: document global provider policy and extension registration rejection

2026-07-22 09:36:32 +02:00
parent fb4ceb5d04
commit 242911331a
3 changed files with 18 additions and 0 deletions
@@ -162,6 +162,13 @@
                prompt files as supported by Pi. Reload the browser page separately for newly discovered or changed
                PI WEB browser plugins. A routine session daemon restart is not required.
              </p>
+              <p>
+                One exception applies to Pi package extensions: PI WEB supports only globally configured providers
+                (Pi built-ins, environment credentials, and the agent directory's <code>models.json</code>). If an
+                extension calls <code>pi.registerProvider</code>, PI WEB ignores the registration and warns in the
+                session; everything else the extension registers keeps working. Configure such providers globally in
+                the agent directory's <code>models.json</code> instead.
+              </p>
            </section>

            <section id="ask-ai">