@vtstech/pi-api 1.0.4 → 1.0.6

package/README.md

@@ -0,0 +1,46 @@
+# @vtstech/pi-api
+
+API Mode Switcher extension for the [Pi Coding Agent](https://github.com/badlogic/pi-mono).
+
+Runtime switching of API modes, base URLs, thinking settings, and compat flags in `models.json`. Supports all 10 Pi API modes.
+
+## Install
+
+```bash
+pi install "npm:@vtstech/pi-api"
+```
+
+## Commands
+
+```
+/api                   Show current provider config (mode, URL, compat flags)
+/api mode <mode>       Switch API mode (partial match supported)
+/api url <url>         Switch base URL
+/api think on|off|auto Toggle thinking for all models in provider
+/api compat <key>      View compat flags
+/api compat <key> <val> Set compat flag
+/api modes             List all 10 supported API modes
+/api providers         List all configured providers
+/api reload            Hint to run /reload
+```
+
+## Supported API Modes
+
+`anthropic-messages` · `openai-completions` · `openai-responses` · `azure-openai-responses` · `openai-codex-responses` · `mistral-conversations` · `google-generative-ai` · `google-gemini-cli` · `google-vertex` · `bedrock-converse-stream`
+
+## Features
+
+- Partial mode matching — `/api mode openai-r` matches `openai-responses`
+- Auto-detect local provider — targets the first `localhost`/`ollama` provider by default
+- Batch thinking toggle — set `reasoning: true/false` across all models at once
+- Compat flag management — get/set `supportsDeveloperRole`, `thinkingFormat`, `maxTokensField`, etc.
+- Tab-completion for sub-commands
+
+## Links
+
+- [Full Documentation](https://github.com/VTSTech/pi-coding-agent#api-mode-switcher-apits)
+- [Changelog](https://github.com/VTSTech/pi-coding-agent/blob/main/CHANGELOG.md)
+
+## License
+
+MIT — [VTSTech](https://www.vts-tech.org)

package/api.js

@@ -1,6 +1,9 @@
 // .build-npm/api/api.temp.ts
+import * as fs from "node:fs";
+import * as path from "node:path";
+import os from "node:os";
 import { section, ok, info, warn } from "@vtstech/pi-shared/format";
-import { readModelsJson, writeModelsJson, getOllamaBaseUrl } from "@vtstech/pi-shared/ollama";
+import { readModelsJson, writeModelsJson, getOllamaBaseUrl, BUILTIN_PROVIDERS } from "@vtstech/pi-shared/ollama";
 var API_MODES = {
   "anthropic-messages": "Anthropic Claude API and compatibles",
   "openai-completions": "OpenAI Chat Completions API and compatibles",
@@ -35,6 +38,21 @@ var COMPAT_FLAGS = {
     values: ["qwen", "deepseek", "default"]
   }
 };
+var SETTINGS_PATH = path.join(os.homedir(), ".pi", "agent", "settings.json");
+function readSettings() {
+  try {
+    if (fs.existsSync(SETTINGS_PATH)) {
+      return JSON.parse(fs.readFileSync(SETTINGS_PATH, "utf-8"));
+    }
+  } catch {
+  }
+  return {};
+}
+function writeSettings(data) {
+  const dir = path.dirname(SETTINGS_PATH);
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+  fs.writeFileSync(SETTINGS_PATH, JSON.stringify(data, null, 2) + "\n", "utf-8");
+}
 function getLocalProvider(config) {
   for (const [name, provider] of Object.entries(config.providers)) {
     const url = provider.baseUrl || "";
@@ -53,7 +71,7 @@ function resolveProvider(config, explicit) {
 }
 function api_temp_default(pi) {
   const branding = [
-    `  \u26A1 Pi API Mode Switcher v1.0.3`,
+    `  \u26A1 Pi API Mode Switcher v1.0.6`,
     `  Written by VTSTech`,
     `  GitHub: https://github.com/VTSTech`,
     `  Website: www.vts-tech.org`
@@ -65,31 +83,34 @@ function api_temp_default(pi) {
       const sub = parts[0]?.toLowerCase() || "";
       const rest = parts.slice(1).join(" ");
       const config = readModelsJson();
-      const provider = resolveProvider(config);
-      if (!provider) {
-        ctx.ui.notify("No providers found in models.json", "error");
-        return;
+      if (sub !== "provider" && sub !== "providers") {
+        const provider = resolveProvider(config);
+        if (!provider) {
+          ctx.ui.notify("No providers found in models.json", "error");
+          return;
+        }
+        switch (sub) {
+          case "":
+          case "show":
+            return showConfig(provider);
+          case "mode":
+            return setMode(ctx, provider.name, rest);
+          case "url":
+            return setUrl(ctx, provider.name, rest);
+          case "think":
+            return setThink(ctx, provider.name, rest);
+          case "compat":
+            return handleCompat(ctx, provider.name, rest);
+          case "reload":
+            return reloadConfig(ctx);
+          case "modes":
+            return listModes();
+          default:
+            ctx.ui.notify(`Unknown sub-command: "${sub}". Use: mode, url, think, compat, reload, modes, provider, providers`, "error");
+        }
       }
-      switch (sub) {
-        case "":
-        case "show":
-          return showConfig(provider);
-        case "mode":
-          return setMode(ctx, provider.name, rest);
-        case "url":
-          return setUrl(ctx, provider.name, rest);
-        case "think":
-          return setThink(ctx, provider.name, rest);
-        case "compat":
-          return handleCompat(ctx, provider.name, rest);
-        case "reload":
-          return reloadConfig(ctx);
-        case "modes":
-          return listModes();
-        case "providers":
-          return listProviders(config);
-        default:
-          ctx.ui.notify(`Unknown sub-command: "${sub}". Use: mode, url, think, compat, reload, modes, providers`, "error");
+      if (sub === "provider" || sub === "providers") {
+        return handleProvider(ctx, config, rest);
       }
     }
   });
@@ -355,22 +376,135 @@ function api_temp_default(pi) {
       display: { type: "content", content: lines.join("\n") }
     });
   }
-  function listProviders(config) {
-    const lines = [branding];
-    lines.push(section("PROVIDERS"));
-    for (const [name, provider] of Object.entries(config.providers)) {
-      const modelCount = provider.models?.length || 0;
-      const url = provider.baseUrl || "(no URL)";
-      const api = provider.api || "(no mode)";
-      const isLocal = url.includes("localhost") || url.includes("127.0.0.1") || name === "ollama";
-      lines.push(info(`  ${name}${isLocal ? " (local)" : ""}`));
-      lines.push(info(`    API: ${api}  |  URL: ${url}  |  Models: ${modelCount}`));
+  function handleProvider(ctx, config, arg) {
+    const parts = arg.trim().split(/\s+/);
+    const sub = parts[0]?.toLowerCase() || "";
+    const rest = parts.slice(1).join(" ");
+    const providerNames = Object.keys(config.providers);
+    if (!sub || sub === "show" || sub === "list") {
+      const settings = readSettings();
+      const defaultProvider = settings.defaultProvider || "(not set)";
+      const defaultModel = settings.defaultModel || "(not set)";
+      const lines = [branding];
+      lines.push(section("DEFAULT PROVIDER"));
+      lines.push(ok(`Provider: ${defaultProvider}`));
+      lines.push(info(`Model: ${defaultModel}`));
+      lines.push(info(`Source: ${SETTINGS_PATH}`));
+      lines.push(section("CONFIGURED PROVIDERS"));
+      if (providerNames.length === 0) {
+        lines.push(info("  (none \u2014 add providers to models.json)"));
+      } else {
+        for (const [name, provider] of Object.entries(config.providers)) {
+          const p = provider;
+          const modelCount = p.models?.length || 0;
+          const url = p.baseUrl || "(no URL)";
+          const api = p.api || "(no mode)";
+          const isDefault = name === defaultProvider;
+          const isLocal = url.includes("localhost") || url.includes("127.0.0.1") || url.includes("0.0.0.0") || name === "ollama";
+          const marker = isDefault ? ok(" \u25C0 default") : "";
+          const tag = isLocal ? " (local)" : " (cloud)";
+          lines.push(info(`  ${name}${tag}${marker}`));
+          lines.push(info(`    API: ${api}  |  URL: ${url}  |  Models: ${modelCount}`));
+          if (modelCount > 0) {
+            const first = p.models[0].id;
+            lines.push(info(`    First model: ${first}${modelCount > 1 ? ` (+${modelCount - 1} more)` : ""}`));
+          }
+        }
+      }
+      const unconfigured = Object.entries(BUILTIN_PROVIDERS).filter(
+        ([name]) => !providerNames.includes(name)
+      );
+      if (unconfigured.length > 0) {
+        lines.push(section("AVAILABLE PROVIDERS"));
+        lines.push(info("  (not in models.json \u2014 configure with API key env var)"));
+        for (const [name, info2] of unconfigured) {
+          const hasKey = !!process.env[info2.envKey];
+          const status = hasKey ? ok("API key set") : info("no API key");
+          lines.push(info(`  ${name.padEnd(14)} ${info2.api.padEnd(26)} ${status}`));
+          lines.push(info(`    URL: ${info2.baseUrl}`));
+          lines.push(info(`    Env:  ${info2.envKey}`));
+        }
+      }
+      lines.push("");
+      lines.push(info("Usage: /api provider set <name>  \u2014  set default provider"));
+      lines.push(info("       /api provider list         \u2014  show all providers"));
+      pi.sendMessage({
+        customType: "api-provider",
+        content: lines.join("\n"),
+        display: { type: "content", content: lines.join("\n") }
+      });
+      return;
     }
-    pi.sendMessage({
-      customType: "api-providers",
-      content: lines.join("\n"),
-      display: { type: "content", content: lines.join("\n") }
-    });
+    if (sub === "set" || sub === "change" || sub === "switch") {
+      const targetName = rest;
+      if (!targetName) {
+        const lines2 = [branding];
+        lines2.push(section("SET DEFAULT PROVIDER"));
+        lines2.push(info("Usage: /api provider set <name>"));
+        lines2.push(info(""));
+        lines2.push(info("Configured providers:"));
+        for (const name of providerNames) {
+          const p = config.providers[name];
+          const isLocal = (p.baseUrl || "").includes("localhost") || (p.baseUrl || "").includes("127.0.0.1") || name === "ollama";
+          lines2.push(info(`  ${name}${isLocal ? " (local)" : " (cloud)"}`));
+        }
+        const builtins = Object.keys(BUILTIN_PROVIDERS).filter((n) => !providerNames.includes(n));
+        if (builtins.length > 0) {
+          lines2.push(info("Built-in providers:"));
+          for (const name of builtins) {
+            lines2.push(info(`  ${name} (built-in)`));
+          }
+        }
+        pi.sendMessage({
+          customType: "api-provider-set",
+          content: lines2.join("\n"),
+          display: { type: "content", content: lines2.join("\n") }
+        });
+        ctx.ui.notify("Specify a provider name: /api provider set <name>", "info");
+        return;
+      }
+      const isBuiltin = targetName in BUILTIN_PROVIDERS;
+      if (!config.providers[targetName] && !isBuiltin) {
+        const allNames = [...providerNames, ...Object.keys(BUILTIN_PROVIDERS).filter((n) => !providerNames.includes(n))];
+        ctx.ui.notify(`Provider "${targetName}" not found. Available: ${allNames.join(", ")}`, "error");
+        return;
+      }
+      const settings = readSettings();
+      const oldProvider = settings.defaultProvider || "(not set)";
+      const oldModel = settings.defaultModel || "(not set)";
+      settings.defaultProvider = targetName;
+      const targetModels = config.providers[targetName]?.models || [];
+      if (targetModels.length > 0) {
+        settings.defaultModel = targetModels[0].id;
+      } else if (isBuiltin) {
+        settings.defaultModel = "(Pi default)";
+      }
+      writeSettings(settings);
+      const lines = [branding];
+      lines.push(section("DEFAULT PROVIDER CHANGED"));
+      lines.push(ok(`New provider: ${targetName}`));
+      lines.push(info(`Old provider: ${oldProvider}`));
+      lines.push(info(`Old model: ${oldModel}`));
+      if (targetModels.length > 0) {
+        lines.push(ok(`Auto-set model: ${targetModels[0].id}`));
+        lines.push(info(`Available models: ${targetModels.map((m) => m.id).join(", ")}`));
+      } else if (isBuiltin) {
+        lines.push(info(`Built-in provider \u2014 Pi will use its default model`));
+        lines.push(info(`Ensure ${BUILTIN_PROVIDERS[targetName].envKey} is set`));
+      }
+      lines.push(warn("Run /reload to apply changes in Pi"));
+      pi.sendMessage({
+        customType: "api-provider-changed",
+        content: lines.join("\n"),
+        display: { type: "content", content: lines.join("\n") }
+      });
+      ctx.ui.notify(`Default provider set to ${targetName}`, "success");
+      return;
+    }
+    if (providerNames.includes(sub) || sub in BUILTIN_PROVIDERS) {
+      return handleProvider(ctx, config, `set ${sub}`);
+    }
+    ctx.ui.notify(`Unknown sub-command: "${sub}". Use: show, set, list, or a provider name`, "error");
   }
   pi.registerCompletion?.("api", {
     getCompletions: () => {
@@ -381,10 +515,64 @@ function api_temp_default(pi) {
         { value: "compat", label: "compat", description: "View/set compat flags" },
         { value: "reload", label: "reload", description: "Reload models.json" },
         { value: "modes", label: "modes", description: "List all supported API modes" },
-        { value: "providers", label: "providers", description: "List all configured providers" }
+        { value: "provider", label: "provider", description: "Show, set, or list all providers" }
       ];
     }
   });
+  pi.registerCompletion?.("api", {
+    getCompletions: () => [],
+    getArgumentCompletions: (args) => {
+      const sub = args[0]?.toLowerCase() || "";
+      if (sub === "provider" && args.length >= 2) {
+        const action = args[1]?.toLowerCase() || "";
+        if (["set", "change", "switch"].includes(action) && args.length === 3) {
+          const config = readModelsJson();
+          const items = [];
+          for (const name of Object.keys(config.providers)) {
+            items.push({ value: name, label: name, description: `Set ${name} as default provider` });
+          }
+          for (const name of Object.keys(BUILTIN_PROVIDERS)) {
+            if (!config.providers[name]) {
+              items.push({ value: name, label: name, description: `Set ${name} (built-in)` });
+            }
+          }
+          return items;
+        }
+        if (args.length === 2) {
+          const config = readModelsJson();
+          const items = [
+            { value: "set", label: "set", description: "Set default provider" },
+            { value: "list", label: "list", description: "Show all providers" },
+            { value: "show", label: "show", description: "Show current provider" }
+          ];
+          for (const name of Object.keys(config.providers)) {
+            items.push({ value: name, label: name, description: `Switch to ${name}` });
+          }
+          for (const name of Object.keys(BUILTIN_PROVIDERS)) {
+            if (!config.providers[name]) {
+              items.push({ value: name, label: name, description: `Switch to ${name} (built-in)` });
+            }
+          }
+          return items;
+        }
+      }
+      if (sub === "mode" && args.length === 2) {
+        return Object.keys(API_MODES).map((mode) => ({
+          value: mode,
+          label: mode,
+          description: API_MODES[mode]
+        }));
+      }
+      if (sub === "think" && args.length === 2) {
+        return [
+          { value: "on", label: "on", description: "Enable thinking for all models" },
+          { value: "off", label: "off", description: "Disable thinking for all models" },
+          { value: "auto", label: "auto", description: "Auto-detect thinking from model name" }
+        ];
+      }
+      return [];
+    }
+  });
 }
 export {
   api_temp_default as default

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@vtstech/pi-api",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "API Mode Switcher extension for Pi Coding Agent",
   "main": "api.js",
-  "keywords": ["pi-package", "pi-extensions"],
+  "keywords": ["pi-extensions"],
   "license": "MIT",
   "access": "public",
   "type": "module",
@@ -14,7 +14,7 @@
     "url": "https://github.com/VTSTech/pi-coding-agent"
   },
   "dependencies": {
-    "@vtstech/pi-shared": "1.0.4"
+    "@vtstech/pi-shared": "1.0.6"
   },
   "peerDependencies": {
     "@mariozechner/pi-coding-agent": ">=0.66"