@tiens.nguyen/gu-cli 1.0.719 → 1.0.722

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiens.nguyen/gu-cli",
-  "version": "1.0.719",
+  "version": "1.0.722",
   "description": "Gu CLI — the gu terminal plus the local worker that runs agent / OCR / PDF / embedding jobs on your Mac (Ollama / MLX / OpenAI-compatible).",
   "type": "module",
   "license": "MIT",
@@ -83,6 +83,8 @@
     "proxy-dispatcher.mjs",
     "model-doctor.mjs",
     "coding-key-prompt.mjs",
+    "server-keys.mjs",
+    "add-server.mjs",
     "powershell-alias.mjs",
     "install-path.mjs",
     "gonext_probe_agent.py",

package/server-keys.mjs

@@ -0,0 +1,97 @@
+/**
+ * A KEY BELONGS TO A SERVER URL, NOT TO A MODEL (task #245) — the terminal's decisions, pure.
+ *
+ * The rules the user set:
+ *   · a server URL owns its keys (many, named) and its models (at most MAX_MODELS_PER_SERVER);
+ *   · the first key chosen for a server becomes its DEFAULT for every later terminal / project;
+ *   · picking another key in a folder applies to that folder only, PER ROLE (coding/agent/embed);
+ *   · the switch picker loads the current server's keys only;
+ *   · deleting the first key entered for a server warns — its model list was loaded with it.
+ *
+ * The API owns resolution (resolveKeyForRole in api/src/app.ts); this module only decides what
+ * the terminal shows and asks, so /model, /agent-model and /embed-model cannot drift apart.
+ */
+
+/** The three roles, the folder-choice field each one's pick lives in, and how to say it. */
+export const KEY_ROLES = {
+  coding: { field: "codingKeyId", label: "coding model" },
+  agent: { field: "agentKeyId", label: "agent model" },
+  embed: { field: "embedKeyId", label: "embedding model" },
+};
+
+export function roleOf(role) {
+  return KEY_ROLES[role] ?? KEY_ROLES.coding;
+}
+
+/**
+ * The key a folder is actually on, as the API will resolve it — for the "(in use)" mark and the
+ * bar's tail. Mirrors resolveCodingApiKey: the folder's pick (one of THIS server's keys) → the
+ * server's default → its first key → any of its keys → a key tied to no server.
+ * `keys` is GET /coding-keys?backendId=… (this server's keys, then unbound ones).
+ */
+export function keyInUse(keys, backendId, folderKeyId = "") {
+  const list = Array.isArray(keys) ? keys : [];
+  const own = list.filter((k) => k && k.backendId === backendId);
+  const loose = list.filter((k) => k && !k.backendId);
+  return (
+    (folderKeyId && own.find((k) => k.id === folderKeyId)) ||
+    own.find((k) => k.default) ||
+    own.find((k) => k.first) ||
+    own[0] ||
+    loose[0] ||
+    null
+  );
+}
+
+/** What a picker row says about a key besides its name and tail. Order: most specific first. */
+export function keyTags(k, { folderKeyId = "", inUseId = "" } = {}) {
+  const tags = [];
+  if (k.id === folderKeyId) tags.push("this folder");
+  else if (k.id === inUseId) tags.push("in use");
+  if (k.default) tags.push("default");
+  if (k.first) tags.push("first key");
+  if (!k.backendId) tags.push("not tied to a server yet");
+  return tags;
+}
+
+/**
+ * After a key is picked: WHERE does the choice apply? The first key chosen for a server already
+ * became its default (the API stamps it), so this is only asked when the pick differs from the
+ * server's default. Returns the rows to offer, in order; `scope` is what each one means.
+ */
+export function scopeChoices({ host = "the server", role = "coding" } = {}) {
+  return [
+    { scope: "folder", label: `just this folder's ${roleOf(role).label}` },
+    { scope: "default", label: `make it the default for ${host} — every folder that has not picked its own` },
+  ];
+}
+
+/**
+ * The warnings before a key is deleted, from DELETE /coding-keys/:id?dryRun=1. Irreversible, so
+ * everything that changes is said first. The FIRST key gets its own line, as asked: "if later
+ * user delete that key we need to warn the user that it was the first key that user input for
+ * that server url".
+ */
+export function deleteWarnings(preview, { host = "this server", isFolderPick = false, roleLabel = "", lastOfServer = false } = {}) {
+  const lines = [];
+  // No preview (an older API, or it could not be reached) still gets the warnings the terminal
+  // can work out itself — this folder's pick, the server's last key.
+  preview = preview && typeof preview === "object" ? preview : {};
+  if (preview.wasFirst) {
+    lines.push(`This was the FIRST key you entered for ${host} — its model list was loaded with it.`);
+  }
+  if (preview.wasDefault) {
+    lines.push(`It is ${host}'s default key — folders without their own pick fall back to another key of ${host}, or none.`);
+  }
+  if (isFolderPick) {
+    lines.push(`This folder uses it${roleLabel ? ` for the ${roleLabel}` : ""} — it will fall back to ${host}'s default.`);
+  }
+  if (lastOfServer) {
+    lines.push(`It is the only key stored for ${host} — every model there will have none until you add another.`);
+  }
+  const others = Number(preview.folders ?? 0) - (isFolderPick ? 1 : 0);
+  if (others > 0) {
+    lines.push(`${others} other folder${others === 1 ? "" : "s"} picked it${Array.isArray(preview.roles) && preview.roles.length ? ` (${preview.roles.join(", ")})` : ""}.`);
+  }
+  return lines;
+}