pi-zengate-models 1.0.1 → 1.0.2

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [1.0.2] - 2026-11-04
+
+- Read `baseUrl` and `apiKey` from the `opencode2api` provider in
+  `<agent-dir>/models.json` when the environment and `zengate.json` are empty.
+  A machine the gateway sync already prepared needs no second copy, and the
+  session warning stops for those machines.
+- Name all three sources in that warning.
+- Pin the install lines to `1.0.2`.
+
+## [Unreleased]
+
+- Add `scripts/setup.ps1` and `scripts/setup.sh`. They ask for the gateway URL
+  and key, write `<agent-dir>/zengate.json` without a BOM, and move a stale
+  `models.json` that holds only the static provider.
+- Document the text-editor route for a machine without an agent.
+
 ## [1.0.1] - 2026-11-04
 
 - Remove the built-in gateway URL. Every machine sets `OPENCODE2API_BASE_URL`

package/README.md

@@ -22,16 +22,19 @@ This package ships no endpoint and no key. Each machine supplies both.
 ## Install
 
 ```bash
-pi install npm:pi-zengate-models
+pi install npm:pi-zengate-models@1.0.2
 ```
 
 From git, or from a local checkout:
 
 ```bash
-pi install git:github.com/ham-zax/pi-zengate@v1.0.1
+pi install git:github.com/ham-zax/pi-zengate@v1.0.2
 pi install /path/to/pi-zengate
 ```
 
+Pin the npm version. An older `0.0.0-stage` publish still holds the `latest` tag
+until it is removed, and that version has no extension.
+
 ## Configure
 
 Every machine needs its own gateway URL and key. Set them in the environment:
@@ -53,8 +56,35 @@ or in `<agent-dir>/zengate.json`, which avoids environment variables:
 ```
 
 `<agent-dir>` is `~/.pi/agent` by default, or `PI_CODING_AGENT_DIR` when set.
-The environment wins over the file. Without a URL the extension registers no
-provider and shows one warning per session.
+The extension also reads `providers.opencode2api.baseUrl` and `.apiKey` from
+`<agent-dir>/models.json`, so a machine the gateway sync prepared needs no second
+copy. Precedence is environment, then `zengate.json`, then `models.json`. Without
+any URL the extension registers no provider and warns once per session.
+
+## Setup helpers
+
+The fastest manual way is a text editor. On Windows:
+
+```powershell
+notepad "$env:USERPROFILE\.pi\agent\zengate.json"
+```
+
+Paste the two fields, save, restart Pi. On Linux, macOS or WSL create
+`~/.pi/agent/zengate.json` the same way.
+
+Two scripts ask for the URL and the key and then write the file, so neither
+script contains a secret:
+
+```powershell
+iex (irm "<raw URL of scripts/setup.ps1>")          # Windows
+```
+
+```bash
+curl -fsSL "<raw URL of scripts/setup.sh>" | bash    # Linux, macOS, WSL
+```
+
+Both scripts write the file with mode `0600` and print the model count. A
+`models.json` that holds only `opencode2api` moves to `models.json.disabled`.
 
 ## Verify
 

package/extensions/zengate-models.ts

@@ -147,6 +147,10 @@ export function configPath(): string {
   return join(agentDir(), "zengate.json");
 }
 
+export function modelsConfigPath(): string {
+  return join(agentDir(), "models.json");
+}
+
 export function cachePath(): string {
   return join(agentDir(), "cache", "zengate-models.json");
 }
@@ -165,25 +169,49 @@ function normalizeBaseUrl(value: string): string {
 }
 
 /**
- * Settings precedence: environment, then <agent-dir>/zengate.json.
- * The config file lets a machine skip environment variables. This package ships
- * no endpoint: every machine supplies its own.
+ * A machine prepared by the gateway sync already holds the endpoint and the key
+ * in models.json. Read them so the client needs no second copy of either.
+ */
+function gatewayFromModelsConfig(): { baseUrl?: string; apiKey?: string } {
+  const file = readJson(modelsConfigPath()) ?? {};
+  const providers = file.providers;
+  const provider =
+    providers && typeof providers === "object"
+      ? (providers as Record<string, unknown>)[PROVIDER_ID]
+      : undefined;
+  if (!provider || typeof provider !== "object") return {};
+  const record = provider as Record<string, unknown>;
+  const baseUrl =
+    typeof record.baseUrl === "string" && record.baseUrl.trim() ? record.baseUrl : undefined;
+  const apiKey =
+    typeof record.apiKey === "string" && record.apiKey.trim() ? record.apiKey.trim() : undefined;
+  return { baseUrl, apiKey };
+}
+
+/**
+ * Settings precedence: environment, then <agent-dir>/zengate.json, then the
+ * `opencode2api` provider in <agent-dir>/models.json. The last source means a
+ * machine the gateway sync already prepared needs no extra file. This package
+ * ships no endpoint: every machine supplies its own.
  */
 export function readSettings(): { baseUrl?: string; apiKey?: string; keySource: string } {
   const file = readJson(configPath()) ?? {};
   const fileBase = typeof file.baseUrl === "string" && file.baseUrl.trim() ? file.baseUrl : undefined;
   const fileKey = typeof file.apiKey === "string" && file.apiKey.trim() ? file.apiKey.trim() : undefined;
+  const synced = gatewayFromModelsConfig();
   const envBase = process.env[BASE_URL_ENV];
   const envKey = process.env[KEY_ENV]?.trim();
-  const base = envBase || fileBase;
+  const base = envBase || fileBase || synced.baseUrl;
   return {
     baseUrl: base ? normalizeBaseUrl(base) : undefined,
-    apiKey: envKey || fileKey,
-    keySource: envKey ? KEY_ENV : fileKey ? "zengate.json" : "none",
+    apiKey: envKey || fileKey || synced.apiKey,
+    keySource: envKey ? KEY_ENV : fileKey ? "zengate.json" : synced.apiKey ? "models.json" : "none",
   };
 }
 
-const configureHint = (): string => `Set ${BASE_URL_ENV} or baseUrl in ${configPath()} to your gateway /v1 URL.`;
+const configureHint = (): string =>
+  `No gateway endpoint found. Set ${BASE_URL_ENV}, baseUrl in ${configPath()}, ` +
+  `or providers.${PROVIDER_ID}.baseUrl in ${modelsConfigPath()}.`;
 
 export default async function (pi: ExtensionAPI) {
   const settings = readSettings();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-zengate-models",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Pi provider extension that discovers free models and their metadata from an OpenAI-compatible gateway catalog, with a local cache and no scheduler.",
   "keywords": [
     "pi-package",