@openbkn/bkn-sdk 0.1.1-alpha.8 → 0.1.1

package/dist/{chunk-DTU5DGJW.js → chunk-NC6DZ2AU.js}

@@ -9,12 +9,15 @@ var HttpError = class extends Error {
   status;
   statusText;
   body;
-  constructor(status2, statusText, body) {
+  /** Optional next-step guidance, overriding the status default (e.g. AppKey re-issue). */
+  hint;
+  constructor(status2, statusText, body, hint) {
     super(`HTTP ${status2} ${statusText}`);
     this.name = "HttpError";
     this.status = status2;
     this.statusText = statusText;
     this.body = body;
+    this.hint = hint;
   }
 };
 var InputError = class extends Error {
@@ -35,7 +38,8 @@ function formatError(err) {
   if (err instanceof HttpError) {
     const serverMsg = serverError(err.body);
     if (err.status === 401) {
-      return `Not authorized (HTTP 401)${serverMsg ? `: ${serverMsg}` : ""}. Run \`openbkn auth login\` and retry.`;
+      const next = err.hint ?? "Run `openbkn auth login` and retry.";
+      return `Not authorized (HTTP 401)${serverMsg ? `: ${serverMsg}` : ""}. ${next}`;
     }
     if (err.status === 403) {
       return `Forbidden (HTTP 403)${serverMsg ? `: ${serverMsg}` : " \u2014 admin privileges required"}.`;
@@ -74,6 +78,23 @@ function truncate(s, n) {
 
 // src/auth/oauth.ts
 import { spawn } from "child_process";
+
+// src/api/tls.ts
+import { Agent, fetch as undiciFetch } from "undici";
+var insecureAgent;
+function insecureDispatcher() {
+  insecureAgent ??= new Agent({ connect: { rejectUnauthorized: false } });
+  return insecureAgent;
+}
+function tlsFetch(insecure, url, init) {
+  if (!insecure) return fetch(url, init);
+  return undiciFetch(url, {
+    ...init,
+    dispatcher: insecureDispatcher()
+  });
+}
+
+// src/auth/oauth.ts
 function normalizeBaseUrl(value) {
   return value.replace(/\/+$/, "");
 }
@@ -114,22 +135,9 @@ function mergeCookies(existing, res) {
   for (const sc of setCookies) add(sc.split(";")[0]?.trim() ?? "");
   return [...map.entries()].map(([k, v]) => `${k}=${v}`).join("; ");
 }
-async function fetchAuthStatus(baseUrl) {
-  try {
-    const res = await fetch(`${normalizeBaseUrl(baseUrl)}/install-status.json`, {
-      headers: { Accept: "application/json" }
-    });
-    if (!res.ok) return null;
-    const j = await res.json();
-    if (!j.auth) return null;
-    return { enabled: Boolean(j.auth.enabled), stack: j.auth.stack };
-  } catch {
-    return null;
-  }
-}
-async function refreshAccessToken(baseUrl, refreshToken, clientId = "openbkn-sdk") {
+async function refreshAccessToken(baseUrl, refreshToken, clientId = "openbkn-sdk", insecure) {
   const base = normalizeBaseUrl(baseUrl);
-  const res = await fetch(`${base}/oauth2/token`, {
+  const res = await tlsFetch(insecure, `${base}/oauth2/token`, {
     method: "POST",
     headers: {
       "Content-Type": "application/x-www-form-urlencoded",
@@ -159,10 +167,10 @@ var form = (body) => ({
   },
   body: new URLSearchParams(body).toString()
 });
-async function requestDeviceCode(base, clientId, scope, audience) {
+async function requestDeviceCode(base, clientId, scope, audience, insecure) {
   const params = { client_id: clientId, scope };
   if (audience) params.audience = audience;
-  const res = await fetch(`${base}/oauth2/device/auth`, form(params));
+  const res = await tlsFetch(insecure, `${base}/oauth2/device/auth`, form(params));
   if (!res.ok) {
     throw new Error(`Device auth failed (${res.status}): ${await res.text() || res.statusText}`);
   }
@@ -174,12 +182,13 @@ async function requestDeviceCode(base, clientId, scope, audience) {
   }
   return da;
 }
-async function pollDeviceToken(base, deviceCode, clientId, intervalMs, windowMs) {
+async function pollDeviceToken(base, deviceCode, clientId, intervalMs, windowMs, insecure) {
   let interval = intervalMs;
   const deadline = Date.now() + windowMs;
   while (Date.now() < deadline) {
     await new Promise((r) => setTimeout(r, interval));
-    const tokRes = await fetch(
+    const tokRes = await tlsFetch(
+      insecure,
       `${base}/oauth2/token`,
       form({ grant_type: DEVICE_GRANT, device_code: deviceCode, client_id: clientId })
     );
@@ -205,14 +214,27 @@ async function pollDeviceToken(base, deviceCode, clientId, intervalMs, windowMs)
 async function deviceLogin(baseUrl, opts = {}) {
   const base = normalizeBaseUrl(baseUrl);
   const clientId = opts.clientId ?? DEFAULT_DEVICE_CLIENT_ID;
-  const da = await requestDeviceCode(base, clientId, opts.scope ?? DEVICE_SCOPE, opts.audience);
+  const da = await requestDeviceCode(
+    base,
+    clientId,
+    opts.scope ?? DEVICE_SCOPE,
+    opts.audience,
+    opts.insecure
+  );
   opts.onPrompt?.({
     userCode: da.user_code,
     verificationUri: onBaseHost(base, da.verification_uri),
     verificationUriComplete: da.verification_uri_complete ? onBaseHost(base, da.verification_uri_complete) : void 0
   });
   const windowMs = Math.min(opts.timeoutMs ?? Number.POSITIVE_INFINITY, da.expires_in * 1e3);
-  return pollDeviceToken(base, da.device_code, clientId, (da.interval ?? 5) * 1e3, windowMs);
+  return pollDeviceToken(
+    base,
+    da.device_code,
+    clientId,
+    (da.interval ?? 5) * 1e3,
+    windowMs,
+    opts.insecure
+  );
 }
 function onBaseHost(base, uri) {
   try {
@@ -226,10 +248,16 @@ function onBaseHost(base, uri) {
 async function credentialDeviceLogin(baseUrl, username, password, opts = {}) {
   const base = normalizeBaseUrl(baseUrl);
   const clientId = opts.clientId ?? DEFAULT_DEVICE_CLIENT_ID;
-  const da = await requestDeviceCode(base, clientId, opts.scope ?? DEVICE_SCOPE, opts.audience);
+  const da = await requestDeviceCode(
+    base,
+    clientId,
+    opts.scope ?? DEVICE_SCOPE,
+    opts.audience,
+    opts.insecure
+  );
   let jar = "";
   const hop = async (url, init) => {
-    const r = await fetch(url, {
+    const r = await tlsFetch(opts.insecure, url, {
       method: init?.method ?? "GET",
       headers: { Cookie: jar, Accept: "text/html,*/*;q=0.8", ...init?.headers ?? {} },
       body: init?.body,
@@ -267,38 +295,40 @@ async function credentialDeviceLogin(baseUrl, username, password, opts = {}) {
     loc = r.headers.get("location");
   }
   const windowMs = Math.min(opts.timeoutMs ?? Number.POSITIVE_INFINITY, da.expires_in * 1e3);
-  return pollDeviceToken(base, da.device_code, clientId, (da.interval ?? 5) * 1e3, windowMs);
+  return pollDeviceToken(
+    base,
+    da.device_code,
+    clientId,
+    (da.interval ?? 5) * 1e3,
+    windowMs,
+    opts.insecure
+  );
 }
 
 // src/api/headers.ts
 function buildHeaders(ctx, extra) {
   return {
-    // No token = a no-auth platform (no bkn-safe); send no Authorization.
-    ...ctx.token ? { authorization: `Bearer ${ctx.token}`, token: ctx.token } : {},
+    authorization: `Bearer ${ctx.token}`,
     "x-business-domain": ctx.businessDomain,
     ...extra
   };
 }
 
-// src/api/tls.ts
-function applyTls(ctx) {
-  if (ctx.insecure && process.env.NODE_TLS_REJECT_UNAUTHORIZED !== "0") {
-    process.env.NODE_TLS_REJECT_UNAUTHORIZED = "0";
-  }
-}
-
 // src/api/http.ts
 var DEFAULT_TIMEOUT_MS = 3e4;
 async function request(ctx, path, init = {}) {
   const url = new URL(path.startsWith("http") ? path : `${ctx.baseUrl}${path}`);
   for (const [k, v] of Object.entries(init.query ?? {})) {
-    if (v !== void 0) url.searchParams.set(k, String(v));
+    if (Array.isArray(v)) {
+      for (const item of v) url.searchParams.append(k, String(item));
+    } else if (v !== void 0) {
+      url.searchParams.set(k, String(v));
+    }
   }
-  applyTls(ctx);
   const hasBody = init.body !== void 0;
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), init.timeoutMs ?? DEFAULT_TIMEOUT_MS);
-  const send = () => fetch(url, {
+  const send = () => tlsFetch(ctx.insecure, url, {
     method: init.method ?? (hasBody ? "POST" : "GET"),
     headers: buildHeaders(ctx, {
       ...hasBody ? { "content-type": "application/json" } : {},
@@ -313,16 +343,27 @@ async function request(ctx, path, init = {}) {
       res = await send();
     }
     const text = await res.text();
-    if (!res.ok) throw new HttpError(res.status, res.statusText, text);
+    if (!res.ok) throw new HttpError(res.status, res.statusText, text, hintFor(ctx, res.status));
     return text ? JSON.parse(text) : void 0;
   } finally {
     clearTimeout(timer);
   }
 }
+function hintFor(ctx, status2) {
+  if (status2 === 401 && ctx.token.startsWith("bak_")) {
+    return "AppKey invalid / expired / revoked / owner disabled \u2014 re-issue with `openbkn appkey create` (or `appkey regenerate <id>`). Do not auto-retry.";
+  }
+  return void 0;
+}
 async function tryRefresh(ctx) {
   if (!ctx.refresh) return false;
   try {
-    const t = await refreshAccessToken(ctx.baseUrl, ctx.refresh.refreshToken, ctx.refresh.clientId);
+    const t = await refreshAccessToken(
+      ctx.baseUrl,
+      ctx.refresh.refreshToken,
+      ctx.refresh.clientId,
+      ctx.insecure
+    );
     ctx.token = t.accessToken;
     if (t.refreshToken) ctx.refresh.refreshToken = t.refreshToken;
     ctx.refresh.persist(t);
@@ -367,6 +408,7 @@ function isExpired(claims, nowMs = Date.now()) {
 
 // src/config/store.ts
 var PROFILE_RE = /^[A-Za-z0-9_-]{1,64}$/;
+var USER_ID_RE = /^[A-Za-z0-9._@-]{1,128}$/;
 var IS_WIN = process.platform === "win32";
 function configDir() {
   return process.env.BKN_CONFIG_DIR ?? join(homedir(), ".bkn");
@@ -393,7 +435,14 @@ function userDir(baseUrl, userId) {
   return join(platformDir(baseUrl), "users", userId);
 }
 function userIdFromToken(token) {
-  return decodeJwt(token.idToken ?? "")?.sub ?? decodeJwt(token.accessToken)?.sub ?? "default";
+  const sub = decodeJwt(token.idToken ?? "")?.sub ?? decodeJwt(token.accessToken)?.sub;
+  if (sub === void 0) return "default";
+  if (typeof sub !== "string" || !USER_ID_RE.test(sub) || sub === "." || sub === "..") {
+    throw new Error(
+      `Token subject '${String(sub)}' is not a usable user id (expected 1-128 chars from [A-Za-z0-9._@-]). Refusing to store this token.`
+    );
+  }
+  return sub;
 }
 function readState() {
   return readJson(statePath()) ?? {};
@@ -418,10 +467,10 @@ function readToken(baseUrl, userId = activeUserId(baseUrl)) {
   if (!userId) return void 0;
   return readJson(join(userDir(baseUrl, userId), "token.json")) ?? void 0;
 }
-function writeToken(baseUrl, token) {
+function writeToken(baseUrl, token, opts = {}) {
   const userId = userIdFromToken(token);
   writeJson(join(userDir(baseUrl, userId), "token.json"), token, 384);
-  setActiveUser(baseUrl, userId);
+  if (opts.setActive !== false) setActiveUser(baseUrl, userId);
   return userId;
 }
 function deleteToken(baseUrl, userId = activeUserId(baseUrl)) {
@@ -460,6 +509,14 @@ function listPlatforms() {
   }
   return out;
 }
+function findUserId(baseUrl, userOrName) {
+  const users = listPlatforms().find((p) => p.baseUrl === baseUrl)?.users ?? [];
+  const match = users.find((u) => u.userId === userOrName) ?? users.find((u) => (u.username ?? u.displayName) === userOrName);
+  return match?.userId ?? null;
+}
+function usersOfPlatform(baseUrl) {
+  return listPlatforms().find((p) => p.baseUrl === baseUrl)?.users ?? [];
+}
 function decodeKey(key) {
   try {
     const b64 = key.replace(/-/g, "+").replace(/_/g, "/");
@@ -485,6 +542,14 @@ function writeJson(path, value, mode = 384) {
 }
 
 // src/config/resolve.ts
+function resolveUserId(baseUrl, userOrName) {
+  const id = findUserId(baseUrl, userOrName);
+  if (id) return id;
+  const known = usersOfPlatform(baseUrl).map((u) => u.username ?? u.userId).join(", ");
+  throw new InputError(
+    `No saved user '${userOrName}' on ${baseUrl}. Saved: ${known || "(none)"}. See \`openbkn auth users ${baseUrl}\`.`
+  );
+}
 function resolveContext(opts = {}) {
   const baseUrl = opts.baseUrl ?? process.env.BKN_BASE_URL ?? activePlatform();
   if (!baseUrl) {
@@ -493,22 +558,29 @@ function resolveContext(opts = {}) {
     );
   }
   const normalized = baseUrl.replace(/\/+$/, "");
-  const stored = readToken(normalized);
+  const user = opts.user ?? process.env.BKN_USER;
+  const stored = user ? readToken(normalized, resolveUserId(normalized, user)) : readToken(normalized);
   const explicit = opts.token ?? process.env.BKN_TOKEN;
   const token = explicit ?? stored?.accessToken ?? "";
-  if (!token && !stored?.noAuth) {
+  if (!token) {
     throw new InputError("No access token. Set BKN_TOKEN or run `openbkn auth login`.");
   }
   const insecure = opts.insecure ?? stored?.tlsInsecure ?? false;
   const refresh = !explicit && stored?.refreshToken ? {
     refreshToken: stored.refreshToken,
     persist: (t) => {
-      writeToken(normalized, {
-        ...stored,
-        accessToken: t.accessToken,
-        refreshToken: t.refreshToken ?? stored.refreshToken,
-        idToken: t.idToken ?? stored.idToken
-      });
+      writeToken(
+        normalized,
+        {
+          ...stored,
+          accessToken: t.accessToken,
+          refreshToken: t.refreshToken ?? stored.refreshToken,
+          idToken: t.idToken ?? stored.idToken
+        },
+        // `--user` picks an identity for this command only; a refresh
+        // must not promote it to the default for the next one.
+        { setActive: !user }
+      );
     }
   } : void 0;
   return {
@@ -571,6 +643,13 @@ async function setUserPasswordSafe(ctx, userId, password) {
   });
   return { ok: true };
 }
+async function changePasswordSafe(ctx, account, oldPassword, newPassword) {
+  await request(ctx, "/api/safe/v1/auth/change-password", {
+    method: "POST",
+    body: { account, old_password: oldPassword, new_password: newPassword }
+  });
+  return { ok: true };
+}
 function getUserRolesSafe(ctx, userId) {
   return request(ctx, `${ADMIN}/role-bindings`, { query: { accessor_id: userId } });
 }
@@ -684,6 +763,43 @@ async function setRolePermissionSafe(ctx, roleId, grant, perm) {
   });
   return { ok: true };
 }
+function getLicenseSafe(ctx) {
+  return request(ctx, `${ADMIN}/license`);
+}
+async function importLicenseSafe(ctx, licenseText, opts = {}) {
+  const text = licenseText.trim();
+  if (!text) throw new InputError("license text is empty");
+  try {
+    return await request(ctx, `${ADMIN}/license/${opts.receipt ? "receipt" : "import"}`, {
+      method: "POST",
+      body: { license: text }
+    });
+  } catch (err) {
+    if (err instanceof HttpError) {
+      const stored = storedImport(err.body);
+      if (stored) return stored;
+    }
+    throw err;
+  }
+}
+function storedImport(body) {
+  try {
+    const parsed = JSON.parse(body);
+    if (parsed && parsed.stored === true) return parsed;
+  } catch {
+  }
+  return null;
+}
+function activateLicenseSafe(ctx) {
+  return request(ctx, `${ADMIN}/license/activate`, { method: "POST" });
+}
+async function removeLicenseSafe(ctx) {
+  await request(ctx, `${ADMIN}/license`, { method: "DELETE" });
+  return { ok: true };
+}
+function getLicenseFingerprintSafe(ctx) {
+  return request(ctx, `${ADMIN}/license/fingerprint`);
+}
 
 // src/resources/admin.ts
 var DEFAULT_NEW_USER_PASSWORD = "openbkn";
@@ -744,10 +860,25 @@ function admin(ctx) {
     roleUpdate: (roleId, input) => updateRoleSafe(ctx, roleId, input),
     roleDelete: (roleId) => deleteRoleSafe(ctx, roleId),
     rolePermission: (roleId, grant, resourceType, resourceId, operations) => setRolePermissionSafe(ctx, roleId, grant, { resourceType, resourceId, operations }),
-    auditList: (_opts) => notOnSafe("audit list")
+    auditList: (_opts) => notOnSafe("audit list"),
+    // ── license (cluster license hub; weak judgements — display/ops only) ──
+    licenseGet: () => getLicenseSafe(ctx),
+    licenseImport: (licenseText, opts) => importLicenseSafe(ctx, licenseText, opts),
+    licenseActivate: () => activateLicenseSafe(ctx),
+    licenseRemove: () => removeLicenseSafe(ctx),
+    licenseFingerprint: () => getLicenseFingerprintSafe(ctx)
   };
 }
 
+// src/api/auth-fetch.ts
+async function authFetch(ctx, send) {
+  let res = await send();
+  if (res.status === 401 && ctx.refresh && await tryRefresh(ctx)) {
+    res = await send();
+  }
+  return res;
+}
+
 // src/api/agent-chat.ts
 var FACTORY = "/api/agent-factory";
 async function fetchAgentInfo(ctx, agentId, version = "v0") {
@@ -807,7 +938,6 @@ function extractText(result) {
   return "";
 }
 async function sendChat(ctx, info, query, opts = {}) {
-  applyTls(ctx);
   const body = {
     agent_id: info.id,
     agent_key: info.key,
@@ -816,16 +946,19 @@ async function sendChat(ctx, info, query, opts = {}) {
     stream: Boolean(opts.stream)
   };
   if (opts.conversationId) body.conversation_id = opts.conversationId;
-  const res = await fetch(`${ctx.baseUrl}${FACTORY}/v1/app/${info.key}/chat/completion`, {
-    method: "POST",
-    headers: {
-      ...buildHeaders(ctx),
-      "content-type": "application/json",
-      accept: opts.stream ? "text/event-stream" : "application/json",
-      "x-language": "zh-CN"
-    },
-    body: JSON.stringify(body)
-  });
+  const res = await authFetch(
+    ctx,
+    () => tlsFetch(ctx.insecure, `${ctx.baseUrl}${FACTORY}/v1/app/${info.key}/chat/completion`, {
+      method: "POST",
+      headers: {
+        ...buildHeaders(ctx),
+        "content-type": "application/json",
+        accept: opts.stream ? "text/event-stream" : "application/json",
+        "x-language": "zh-CN"
+      },
+      body: JSON.stringify(body)
+    })
+  );
   if (!res.ok) throw new HttpError(res.status, res.statusText, await res.text());
   const contentType = res.headers.get("content-type") ?? "";
   if (opts.stream && contentType.includes("text/event-stream")) {
@@ -1017,6 +1150,9 @@ function nextId() {
 function mcpUrl(ctx) {
   return `${ctx.baseUrl}${MCP_PATH}`;
 }
+function mcpInfo(ctx) {
+  return request(ctx, `${MCP_PATH}/info`);
+}
 function headers(ctx, knId, sessionId) {
   const h = {
     "content-type": "application/json",
@@ -1038,12 +1174,14 @@ function parseBody(text) {
   }
 }
 async function post(ctx, knId, sessionId, body) {
-  applyTls(ctx);
-  const res = await fetch(mcpUrl(ctx), {
-    method: "POST",
-    headers: headers(ctx, knId, sessionId),
-    body: JSON.stringify(body)
-  });
+  const res = await authFetch(
+    ctx,
+    () => tlsFetch(ctx.insecure, mcpUrl(ctx), {
+      method: "POST",
+      headers: headers(ctx, knId, sessionId),
+      body: JSON.stringify(body)
+    })
+  );
   const text = await res.text();
   if (!res.ok) throw new HttpError(res.status, res.statusText, text);
   return { res, text };
@@ -1120,6 +1258,17 @@ function findSkills(ctx, knId, objectTypeId, topK) {
   if (topK !== void 0) args.top_k = topK;
   return callTool(ctx, knId, "find_skills", args);
 }
+function getKnDetail(ctx, knId, detailLevel) {
+  const args = { response_format: "json" };
+  if (detailLevel) args.detail_level = detailLevel;
+  return callTool(ctx, knId, "get_kn_detail", args);
+}
+function getObjectTypes(ctx, knId, ids) {
+  return callTool(ctx, knId, "get_object_types", { ids, response_format: "json" });
+}
+function getRelationTypes(ctx, knId, ids) {
+  return callTool(ctx, knId, "get_relation_types", { ids, response_format: "json" });
+}
 function listTools(ctx, knId) {
   return callMethod(ctx, knId, "tools/list");
 }
@@ -1154,8 +1303,16 @@ function context(ctx) {
     searchSchema: (knId, query, opts) => searchSchema(ctx, knId, query, opts),
     queryObjectInstance: (knId, args) => queryObjectInstance(ctx, knId, args),
     findSkills: (knId, objectTypeId, topK) => findSkills(ctx, knId, objectTypeId, topK),
+    // Progressive schema disclosure: skeleton first (summary), then drill down.
+    knDetail: (knId, detailLevel) => getKnDetail(ctx, knId, detailLevel),
+    objectTypes: (knId, ids) => getObjectTypes(ctx, knId, ids),
+    relationTypes: (knId, ids) => getRelationTypes(ctx, knId, ids),
+    info: () => mcpInfo(ctx),
     tools: (knId) => listTools(ctx, knId),
     toolCall: (knId, name, args) => callTool(ctx, knId, name, args),
+    // Generic MCP method passthrough — covers methods not yet wrapped, so the
+    // surface doesn't have to grow every time the server adds one.
+    callMethod: (knId, method, params) => callMethod(ctx, knId, method, params),
     queryInstanceSubgraph: (knId, args) => queryInstanceSubgraph(ctx, knId, args),
     logicProperties: (knId, args) => getLogicProperties(ctx, knId, args),
     actionInfo: (knId, args) => getActionInfo(ctx, knId, args),
@@ -1475,7 +1632,16 @@ function listResources2(ctx, opts = {}) {
       catalog_id: opts.datasourceId || void 0,
       name: opts.name || void 0,
       category: opts.category || void 0,
-      limit: opts.limit && opts.limit > 0 ? opts.limit : void 0
+      status: opts.status || void 0,
+      database: opts.database || void 0,
+      limit: opts.limit && opts.limit > 0 ? opts.limit : void 0,
+      offset: opts.offset,
+      sort: opts.sort,
+      direction: opts.direction,
+      include_extensions: opts.includeExtensions === void 0 ? void 0 : String(opts.includeExtensions),
+      include_extension_keys: opts.includeExtensionKeys || void 0,
+      extension_key: opts.extensionPairs?.map((p) => p.key),
+      extension_value: opts.extensionPairs?.map((p) => p.value)
     }
   });
 }
@@ -1485,18 +1651,103 @@ function getResource(ctx, id) {
 function createResourceRaw(ctx, body) {
   return request(ctx, BASE3, { method: "POST", body });
 }
-function createResource(ctx, opts) {
+function updateResourceRaw(ctx, id, body) {
+  return request(ctx, `${BASE3}/${encodeURIComponent(id)}`, { method: "PUT", body });
+}
+async function updateResource(ctx, id, patch) {
+  const current = firstResource(await getResource(ctx, id));
+  return updateResourceRaw(ctx, id, resourceUpdateBody(id, current, patch));
+}
+async function configureResourceIndex(ctx, id, opts) {
+  const current = firstResource(await getResource(ctx, id));
+  const schema = (current.schema_definition ?? []).map((prop) => ({ ...prop }));
+  const indexConfig = {
+    ...current.index_config ?? {},
+    ...opts.buildKeyFields?.length ? { build_key_fields: opts.buildKeyFields } : {},
+    ...opts.embeddingModel ? { default_embedding_model: opts.embeddingModel } : {},
+    ...opts.fulltextAnalyzer ? { default_fulltext_analyzer: opts.fulltextAnalyzer } : {}
+  };
+  for (const field of opts.embeddingFields ?? []) {
+    ensureFeature(
+      schema,
+      field,
+      "vector",
+      opts.embeddingModel ? { embedding_model: opts.embeddingModel } : void 0
+    );
+  }
+  for (const field of opts.fulltextFields ?? []) {
+    ensureFeature(
+      schema,
+      field,
+      "fulltext",
+      opts.fulltextAnalyzer ? { analyzer: opts.fulltextAnalyzer } : void 0
+    );
+  }
+  return updateResourceRaw(
+    ctx,
+    id,
+    resourceUpdateBody(id, current, { schemaDefinition: schema, indexConfig })
+  );
+}
+function resourceUpdateBody(id, current, patch) {
   const body = {
-    name: opts.name,
-    catalog_id: opts.catalogId,
-    category: "table",
-    source_identifier: opts.sourceIdentifier
+    id,
+    name: patch.name ?? current.name,
+    catalog_id: patch.catalogId ?? current.catalog_id,
+    tags: patch.tags ?? current.tags ?? [],
+    description: patch.description ?? current.description ?? "",
+    category: patch.category ?? current.category,
+    status: patch.status ?? current.status,
+    database: patch.database ?? current.database,
+    source_identifier: patch.sourceIdentifier ?? current.source_identifier,
+    source_metadata: patch.sourceMetadata ?? current.source_metadata,
+    schema_definition: patch.schemaDefinition ?? current.schema_definition,
+    index_config: patch.indexConfig === void 0 ? current.index_config : patch.indexConfig,
+    logic_definition: patch.logicDefinition ?? current.logic_definition
   };
-  if (opts.fields && opts.fields.length > 0) body.schema_definition = opts.fields;
-  return request(ctx, BASE3, { method: "POST", body });
+  if (patch.extensions !== void 0 || current.extensions !== void 0) {
+    body.extensions = patch.extensions ?? current.extensions;
+  }
+  return body;
+}
+function ensureFeature(schema, field, featureType, config) {
+  const prop = schema.find((p) => p.name === field);
+  if (!prop) throw new Error(`resource field '${field}' not found in schema_definition`);
+  const features = [...prop.features ?? []];
+  const existing = features.find(
+    (f) => f.feature_type === featureType && (f.ref_property || field) === field
+  );
+  if (existing) {
+    existing.ref_property = existing.ref_property || field;
+    existing.config = { ...existing.config ?? {}, ...config ?? {} };
+  } else {
+    features.push({
+      name: `${field}_${featureType}`,
+      feature_type: featureType,
+      ref_property: field,
+      is_default: false,
+      is_native: false,
+      ...config ? { config } : {}
+    });
+  }
+  prop.features = features;
+}
+function firstResource(result) {
+  if (result && typeof result === "object") {
+    const o = result;
+    if (Array.isArray(o.entries)) return o.entries[0] ?? {};
+    return o;
+  }
+  return {};
 }
-function deleteResource(ctx, id) {
-  return request(ctx, `${BASE3}/${encodeURIComponent(id)}`, { method: "DELETE" });
+function deleteResource(ctx, id, opts = {}) {
+  const ids = Array.isArray(id) ? id : [id];
+  return request(ctx, `${BASE3}/${ids.map(encodeURIComponent).join(",")}`, {
+    method: "DELETE",
+    query: {
+      ignore_missing: opts.ignoreMissing === void 0 ? void 0 : String(opts.ignoreMissing)
+    }
+  });
 }
 async function findResource(ctx, name, opts = {}) {
   const result = await listResources2(ctx, { name, datasourceId: opts.datasourceId });
@@ -2718,7 +2969,6 @@ function knPath(knId, path) {
   return `${BASE4}/${encodeURIComponent(knId)}/${path}`;
 }
 async function uploadBkn(ctx, tarBuffer, opts = {}) {
-  applyTls(ctx);
   const url = new URL(`${ctx.baseUrl}${BKNS}`);
   url.searchParams.set("branch", opts.branch ?? "main");
   const form2 = new FormData();
@@ -2727,16 +2977,21 @@ async function uploadBkn(ctx, tarBuffer, opts = {}) {
     new Blob([new Uint8Array(tarBuffer)], { type: "application/octet-stream" }),
     "bkn.tar"
   );
-  const res = await fetch(url, { method: "POST", headers: buildHeaders(ctx), body: form2 });
+  const res = await authFetch(
+    ctx,
+    () => tlsFetch(ctx.insecure, url, { method: "POST", headers: buildHeaders(ctx), body: form2 })
+  );
   const text = await res.text();
   if (!res.ok) throw new HttpError(res.status, res.statusText, text);
   return text ? JSON.parse(text) : void 0;
 }
 async function downloadBkn(ctx, knId, opts = {}) {
-  applyTls(ctx);
   const url = new URL(`${ctx.baseUrl}${BKNS}/${encodeURIComponent(knId)}`);
   url.searchParams.set("branch", opts.branch ?? "main");
-  const res = await fetch(url, { method: "GET", headers: buildHeaders(ctx) });
+  const res = await authFetch(
+    ctx,
+    () => tlsFetch(ctx.insecure, url, { method: "GET", headers: buildHeaders(ctx) })
+  );
   if (!res.ok) throw new HttpError(res.status, res.statusText, await res.text());
   return Buffer.from(await res.arrayBuffer());
 }
@@ -2825,10 +3080,7 @@ var BuildMode = z.enum(["batch", "streaming"]);
 var CreateBuildTaskRequest = z.object({
   resource_id: z.string().min(1),
   mode: BuildMode,
-  embedding_fields: z.array(z.string()).optional(),
-  build_key_fields: z.array(z.string()).optional(),
-  embedding_model: z.string().optional(),
-  model_dimensions: z.number().int().positive().optional()
+  execute_type: z.enum(["incremental", "full"]).optional()
 });
 var BuildTask = z.object({
   id: z.string(),
@@ -2839,31 +3091,83 @@ var BuildTask = z.object({
   total_count: z.number().optional(),
   synced_count: z.number().optional(),
   vectorized_count: z.number().optional(),
-  embedding_fields: z.string().optional(),
-  build_key_fields: z.string().optional(),
-  embedding_model: z.string().optional(),
-  model_dimensions: z.number().optional()
+  index_config: z.unknown().optional(),
+  catalog_id: z.string().optional(),
+  index_health: z.object({
+    embedding: z.string(),
+    fulltext: z.string(),
+    usable: z.boolean()
+  }).passthrough().optional()
 }).passthrough();
 async function createBuildTask(ctx, req) {
   const p = CreateBuildTaskRequest.parse(req);
   const body = {
     resource_id: p.resource_id,
     mode: p.mode,
-    ...p.embedding_fields?.length ? { embedding_fields: p.embedding_fields.join(",") } : {},
-    ...p.build_key_fields?.length ? { build_key_fields: p.build_key_fields.join(",") } : {},
-    ...p.embedding_model ? { embedding_model: p.embedding_model } : {},
-    ...p.model_dimensions ? { model_dimensions: p.model_dimensions } : {}
+    ...p.execute_type ? { execute_type: p.execute_type } : {}
   };
   const res = await request(ctx, `${VEGA_BASE}/build-tasks`, { method: "POST", body });
   return BuildTask.parse(res);
 }
+function listBuildTasks(ctx, opts = {}) {
+  return request(ctx, `${VEGA_BASE}/build-tasks`, {
+    query: {
+      limit: opts.limit,
+      offset: opts.offset,
+      resource_id: opts.resourceId || void 0,
+      catalog_id: opts.catalogId || void 0,
+      status: Array.isArray(opts.status) ? opts.status.join(",") : opts.status || void 0,
+      active: opts.active === void 0 ? void 0 : String(opts.active),
+      mode: opts.mode,
+      order_by: opts.orderBy,
+      order: opts.order
+    }
+  });
+}
 async function getBuildTask(ctx, taskId) {
   const res = await request(ctx, `${VEGA_BASE}/build-tasks/${encodeURIComponent(taskId)}`);
   return BuildTask.parse(res);
 }
+function deleteBuildTasks(ctx, ids, opts = {}) {
+  return request(ctx, `${VEGA_BASE}/build-tasks/${ids.map(encodeURIComponent).join(",")}`, {
+    method: "DELETE",
+    query: {
+      ignore_missing: opts.ignoreMissing === void 0 ? void 0 : String(opts.ignoreMissing),
+      delete_active_index: opts.deleteActiveIndex === void 0 ? void 0 : String(opts.deleteActiveIndex)
+    }
+  });
+}
+function startBuildTask(ctx, taskId, opts = {}) {
+  return request(ctx, `${VEGA_BASE}/build-tasks/${encodeURIComponent(taskId)}/start`, {
+    method: "POST",
+    body: opts.reset === void 0 ? {} : { reset: opts.reset }
+  });
+}
+function stopBuildTask(ctx, taskId) {
+  return request(ctx, `${VEGA_BASE}/build-tasks/${encodeURIComponent(taskId)}/stop`, {
+    method: "POST"
+  });
+}
+function runSql(ctx, body) {
+  return request(ctx, `${VEGA_BASE}/resources/query`, { method: "POST", body });
+}
 async function listCatalogs(ctx, opts = {}) {
   return request(ctx, `${VEGA_BASE}/catalogs`, {
-    query: { limit: opts.limit, offset: opts.offset }
+    query: {
+      limit: opts.limit,
+      offset: opts.offset,
+      name: opts.name || void 0,
+      tag: opts.tag || void 0,
+      type: opts.type || void 0,
+      enabled: opts.enabled === void 0 ? void 0 : String(opts.enabled),
+      health_check_status: opts.healthCheckStatus || void 0,
+      include_extensions: opts.includeExtensions === void 0 ? void 0 : String(opts.includeExtensions),
+      include_extension_keys: opts.includeExtensionKeys || void 0,
+      extension_key: opts.extensionPairs?.map((p) => p.key),
+      extension_value: opts.extensionPairs?.map((p) => p.value),
+      sort: opts.sort,
+      direction: opts.direction
+    }
   });
 }
 function getCatalog(ctx, id) {
@@ -2873,18 +3177,49 @@ function createCatalog(ctx, req) {
   return request(ctx, `${VEGA_BASE}/catalogs`, {
     method: "POST",
     body: {
+      ...req.id ? { id: req.id } : {},
       name: req.name,
       connector_type: req.connectorType,
       connector_config: req.connectorConfig,
       ...req.tags ? { tags: req.tags } : {},
       ...req.description ? { description: req.description } : {},
-      ...req.enabled !== void 0 ? { enabled: req.enabled } : {}
+      ...req.enabled !== void 0 ? { enabled: req.enabled } : {},
+      ...req.internal !== void 0 ? { internal: req.internal } : {},
+      ...req.extensions ? { extensions: req.extensions } : {}
+    }
+  });
+}
+function updateCatalog(ctx, id, req) {
+  return request(ctx, `${VEGA_BASE}/catalogs/${encodeURIComponent(id)}`, {
+    method: "PUT",
+    body: {
+      ...req.id ? { id: req.id } : {},
+      ...req.name ? { name: req.name } : {},
+      ...req.connectorType ? { connector_type: req.connectorType } : {},
+      ...req.connectorConfig !== void 0 ? { connector_config: req.connectorConfig } : {},
+      ...req.tags ? { tags: req.tags } : {},
+      ...req.description !== void 0 ? { description: req.description } : {},
+      ...req.enabled !== void 0 ? { enabled: req.enabled } : {},
+      ...req.extensions ? { extensions: req.extensions } : {}
     }
   });
 }
 function enableCatalog(ctx, id) {
   return request(ctx, `${VEGA_BASE}/catalogs/${encodeURIComponent(id)}/enable`, { method: "POST" });
 }
+function disableCatalog(ctx, id) {
+  return request(ctx, `${VEGA_BASE}/catalogs/${encodeURIComponent(id)}/disable`, {
+    method: "POST"
+  });
+}
+function deleteCatalog(ctx, id) {
+  return request(ctx, `${VEGA_BASE}/catalogs/${encodeURIComponent(id)}`, { method: "DELETE" });
+}
+function testCatalogConnection(ctx, id) {
+  return request(ctx, `${VEGA_BASE}/catalogs/${encodeURIComponent(id)}/test-connection`, {
+    method: "POST"
+  });
+}
 function discoverCatalog(ctx, id, wait = true) {
   return request(ctx, `${VEGA_BASE}/catalogs/${encodeURIComponent(id)}/discover`, {
     method: "POST",
@@ -3354,7 +3689,7 @@ async function createFromCatalog(ctx, opts) {
     }
     tablePk[t.name] = res.pk;
   }
-  log(`Creating resources for ${targets.length} table(s)...`);
+  log(`Resolving discovered resources for ${targets.length} table(s)...`);
   const viewMap = {};
   for (const t of targets) {
     const found = asArray(
@@ -3364,13 +3699,9 @@ async function createFromCatalog(ctx, opts) {
     if (existingId) {
       viewMap[t.name] = existingId;
     } else {
-      const created = await createResource(ctx, {
-        name: t.name,
-        catalogId: opts.catalogId,
-        sourceIdentifier: t.name,
-        fields: t.columns.map((c) => ({ name: c.name, type: c.type }))
-      });
-      viewMap[t.name] = String(created.id ?? "");
+      throw new Error(
+        `Table '${t.name}' has no discovered Vega resource. Run catalog discover and retry.`
+      );
     }
   }
   const knCreated = await createKnowledgeNetwork(ctx, { name: opts.name });
@@ -3402,12 +3733,14 @@ async function createFromCatalog(ctx, opts) {
       log("Submitting build tasks...");
       for (const t of targets) {
         const embedding = opts.embeddingFields?.[t.name];
+        await configureResourceIndex(ctx, viewMap[t.name], {
+          buildKeyFields: [tablePk[t.name]],
+          ...embedding && embedding.length > 0 ? { embeddingFields: embedding } : {},
+          ...opts.embeddingModel ? { embeddingModel: opts.embeddingModel } : {}
+        });
         const task = await createBuildTask(ctx, {
           resource_id: viewMap[t.name],
-          mode: "batch",
-          build_key_fields: [tablePk[t.name]],
-          ...embedding && embedding.length > 0 ? { embedding_fields: embedding } : {},
-          ...opts.embeddingModel ? { embedding_model: opts.embeddingModel } : {}
+          mode: "batch"
         });
         builds.push({ table: t.name, taskId: String(task.id ?? "") });
       }
@@ -3585,12 +3918,19 @@ function kn(ctx) {
       const targets = collectIndexTargets(dir);
       const buildTasks = [];
       for (const t of targets) {
+        if (!t.buildKey) {
+          throw new Error(
+            `Object type '${t.objectType}' declares a vector index but no build key; batch Vega builds require resource index_config.build_key_fields.`
+          );
+        }
+        await configureResourceIndex(ctx, t.resourceId, {
+          buildKeyFields: [t.buildKey],
+          embeddingFields: t.embeddingFields,
+          ...t.embeddingModel ?? opts.embeddingModel ? { embeddingModel: t.embeddingModel ?? opts.embeddingModel } : {}
+        });
         const task = await createBuildTask(ctx, {
           resource_id: t.resourceId,
-          mode: "batch",
-          embedding_fields: t.embeddingFields,
-          ...t.buildKey ? { build_key_fields: [t.buildKey] } : {},
-          ...t.embeddingModel ?? opts.embeddingModel ? { embedding_model: t.embeddingModel ?? opts.embeddingModel } : {}
+          mode: "batch"
         });
         buildTasks.push({
           objectType: t.objectType,
@@ -3645,16 +3985,18 @@ function deltaContent(chunk) {
   return typeof c === "string" ? c : "";
 }
 async function chatCompletionsStream(ctx, model, messages, onDelta) {
-  applyTls(ctx);
-  const res = await fetch(`${ctx.baseUrl}${API}/chat/completions`, {
-    method: "POST",
-    headers: {
-      ...buildHeaders(ctx),
-      "content-type": "application/json",
-      accept: "text/event-stream"
-    },
-    body: JSON.stringify({ model, messages, stream: true })
-  });
+  const res = await authFetch(
+    ctx,
+    () => tlsFetch(ctx.insecure, `${ctx.baseUrl}${API}/chat/completions`, {
+      method: "POST",
+      headers: {
+        ...buildHeaders(ctx),
+        "content-type": "application/json",
+        accept: "text/event-stream"
+      },
+      body: JSON.stringify({ model, messages, stream: true })
+    })
+  );
   if (!res.ok) throw new HttpError(res.status, res.statusText, await res.text());
   const reader = res.body?.getReader();
   if (!reader) throw new Error("No response body for stream");
@@ -3704,6 +4046,23 @@ function deleteModels(ctx, kind, modelIds) {
 function testModel(ctx, kind, body) {
   return request(ctx, `${MANAGER}/${kind}/test`, { method: "POST", body });
 }
+function setDefaultLlm(ctx, modelId, isDefault = true) {
+  return request(ctx, `${MANAGER}/llm/default/edit`, {
+    method: "POST",
+    body: { model_id: modelId, default: isDefault }
+  });
+}
+function setDefaultSmallModel(ctx, modelId, isDefault = true) {
+  return request(ctx, `${MANAGER}/small-model/set-default`, {
+    method: "POST",
+    body: { model_id: modelId, default: isDefault }
+  });
+}
+function getDefaultSmallModel(ctx, modelType = "embedding") {
+  return request(ctx, `${MANAGER}/small-model/get_default`, {
+    query: { model_type: modelType }
+  });
+}
 function rerank(ctx, model, query, documents) {
   return request(ctx, `${API}/small-model/reranker`, {
     method: "POST",
@@ -3722,7 +4081,9 @@ function models(ctx) {
       add: (body) => addModel(ctx, "llm", body),
       edit: (body) => editModel(ctx, "llm", body),
       delete: (modelIds) => deleteModels(ctx, "llm", modelIds),
-      test: (body) => testModel(ctx, "llm", body)
+      test: (body) => testModel(ctx, "llm", body),
+      /** Set (or clear) the system default LLM. */
+      setDefault: (modelId, isDefault = true) => setDefaultLlm(ctx, modelId, isDefault)
     },
     small: {
       list: (opts) => listSmallModels(ctx, opts),
@@ -3732,7 +4093,11 @@ function models(ctx) {
       add: (body) => addModel(ctx, "small-model", body),
       edit: (body) => editModel(ctx, "small-model", body),
       delete: (modelIds) => deleteModels(ctx, "small-model", modelIds),
-      test: (body) => testModel(ctx, "small-model", body)
+      test: (body) => testModel(ctx, "small-model", body),
+      /** Set (or clear) the system default small model (type inferred from the model). */
+      setDefault: (modelId, isDefault = true) => setDefaultSmallModel(ctx, modelId, isDefault),
+      /** Get the system default small model for a type (default "embedding"). */
+      getDefault: (modelType) => getDefaultSmallModel(ctx, modelType)
     }
   };
 }
@@ -3743,6 +4108,8 @@ function resources(ctx) {
     list: (opts) => listResources2(ctx, opts),
     get: (id) => getResource(ctx, id),
     delete: (id) => deleteResource(ctx, id),
+    update: (id, patch) => updateResource(ctx, id, patch),
+    configureIndex: (id, opts) => configureResourceIndex(ctx, id, opts),
     find: (name, opts) => findResource(ctx, name, opts),
     query: (id, opts) => queryResource(ctx, id, opts)
   };
@@ -3755,40 +4122,46 @@ import { basename as basename2, dirname as dirname3, resolve as resolve5 } from
 // src/api/skills.ts
 var BASE5 = "/api/agent-operator-integration/v1";
 async function registerSkillZip(ctx, bytes, opts = {}) {
-  applyTls(ctx);
   const form2 = new FormData();
   form2.set("file_type", "zip");
   form2.set("file", new Blob([bytes]), opts.filename ?? "skill.zip");
   if (opts.source) form2.set("source", opts.source);
   if (opts.extendInfo) form2.set("extend_info", JSON.stringify(opts.extendInfo));
-  const res = await fetch(`${ctx.baseUrl}${BASE5}/skills`, {
-    method: "POST",
-    headers: buildHeaders(ctx),
-    body: form2
-  });
+  const res = await authFetch(
+    ctx,
+    () => tlsFetch(ctx.insecure, `${ctx.baseUrl}${BASE5}/skills`, {
+      method: "POST",
+      headers: buildHeaders(ctx),
+      body: form2
+    })
+  );
   const text = await res.text();
   if (!res.ok) throw new HttpError(res.status, res.statusText, text);
   return text ? JSON.parse(text) : void 0;
 }
 async function updateSkillPackageZip(ctx, skillId, bytes, filename = "skill.zip") {
-  applyTls(ctx);
   const form2 = new FormData();
   form2.set("file_type", "zip");
   form2.set("file", new Blob([bytes]), filename);
-  const res = await fetch(`${ctx.baseUrl}${BASE5}/skills/${encodeURIComponent(skillId)}/package`, {
-    method: "PUT",
-    headers: buildHeaders(ctx),
-    body: form2
-  });
+  const res = await authFetch(
+    ctx,
+    () => tlsFetch(ctx.insecure, `${ctx.baseUrl}${BASE5}/skills/${encodeURIComponent(skillId)}/package`, {
+      method: "PUT",
+      headers: buildHeaders(ctx),
+      body: form2
+    })
+  );
   const text = await res.text();
   if (!res.ok) throw new HttpError(res.status, res.statusText, text);
   return text ? JSON.parse(text) : void 0;
 }
 async function downloadSkill(ctx, skillId) {
-  applyTls(ctx);
-  const res = await fetch(`${ctx.baseUrl}${BASE5}/skills/${encodeURIComponent(skillId)}/download`, {
-    headers: buildHeaders(ctx)
-  });
+  const res = await authFetch(
+    ctx,
+    () => tlsFetch(ctx.insecure, `${ctx.baseUrl}${BASE5}/skills/${encodeURIComponent(skillId)}/download`, {
+      headers: buildHeaders(ctx)
+    })
+  );
   if (!res.ok) throw new HttpError(res.status, res.statusText, await res.text());
   return new Uint8Array(await res.arrayBuffer());
 }
@@ -3941,40 +4314,49 @@ import { basename as basename3 } from "path";
 var PATH = "/api/agent-operator-integration/v1/tool-box";
 var IMPEX = "/api/agent-operator-integration/v1/impex";
 async function exportConfig(ctx, id, type = "toolbox") {
-  applyTls(ctx);
-  const res = await fetch(
-    `${ctx.baseUrl}${IMPEX}/export/${encodeURIComponent(type)}/${encodeURIComponent(id)}`,
-    { headers: buildHeaders(ctx) }
+  const res = await authFetch(
+    ctx,
+    () => tlsFetch(
+      ctx.insecure,
+      `${ctx.baseUrl}${IMPEX}/export/${encodeURIComponent(type)}/${encodeURIComponent(id)}`,
+      {
+        headers: buildHeaders(ctx)
+      }
+    )
   );
   const buf = new Uint8Array(await res.arrayBuffer());
   if (!res.ok) throw new HttpError(res.status, res.statusText, new TextDecoder().decode(buf));
   return buf;
 }
 async function importConfig(ctx, filePath, type = "toolbox") {
-  applyTls(ctx);
   const buf = await readFile2(filePath);
   const form2 = new FormData();
   form2.append("data", new Blob([new Uint8Array(buf)]), basename3(filePath));
-  const res = await fetch(`${ctx.baseUrl}${IMPEX}/import/${encodeURIComponent(type)}`, {
-    method: "POST",
-    headers: buildHeaders(ctx),
-    body: form2
-  });
+  const res = await authFetch(
+    ctx,
+    () => tlsFetch(ctx.insecure, `${ctx.baseUrl}${IMPEX}/import/${encodeURIComponent(type)}`, {
+      method: "POST",
+      headers: buildHeaders(ctx),
+      body: form2
+    })
+  );
   const text = await res.text();
   if (!res.ok) throw new HttpError(res.status, res.statusText, text);
   return text ? JSON.parse(text) : text;
 }
 async function uploadTool(ctx, boxId, filePath, metadataType = "openapi") {
-  applyTls(ctx);
   const buf = await readFile2(filePath);
   const form2 = new FormData();
   form2.append("metadata_type", metadataType);
   form2.append("data", new Blob([new Uint8Array(buf)]), basename3(filePath));
-  const res = await fetch(`${ctx.baseUrl}${PATH}/${encodeURIComponent(boxId)}/tool`, {
-    method: "POST",
-    headers: buildHeaders(ctx),
-    body: form2
-  });
+  const res = await authFetch(
+    ctx,
+    () => tlsFetch(ctx.insecure, `${ctx.baseUrl}${PATH}/${encodeURIComponent(boxId)}/tool`, {
+      method: "POST",
+      headers: buildHeaders(ctx),
+      body: form2
+    })
+  );
   const text = await res.text();
   if (!res.ok) throw new HttpError(res.status, res.statusText, text);
   return text ? JSON.parse(text) : text;
@@ -4138,7 +4520,7 @@ async function getSpansByConversation(ctx, conversationId, opts = {}) {
   return (spans.hits?.hits ?? []).map((h) => h._source ?? {});
 }
 
-// src/trace-ai/claude-judge.ts
+// src/bkn-trace/claude-judge.ts
 import { spawn as spawn2, spawnSync as spawnSync2 } from "child_process";
 var ClaudeJudgeError = class extends Error {
   constructor(message, reason) {
@@ -4220,7 +4602,7 @@ async function judgeJson(prompt, opts = {}) {
   return JSON.parse(extractJsonObject(text));
 }
 
-// src/trace-ai/diagnose.ts
+// src/bkn-trace/diagnose.ts
 var KIND_MAP = {
   chat: "llm",
   text_completion: "llm",
@@ -4614,7 +4996,7 @@ function renderReportMarkdown(r) {
   return lines.join("\n");
 }
 
-// src/trace-ai/eval-set.ts
+// src/bkn-trace/eval-set.ts
 function hashId(s) {
   let h = 5381;
   for (let i = 0; i < s.length; i++) h = h * 33 ^ s.charCodeAt(i);
@@ -4878,19 +5260,29 @@ function vega(ctx) {
     catalogs: (opts) => listCatalogs(ctx, opts),
     getCatalog: (id) => getCatalog(ctx, id),
     createCatalog: (req) => createCatalog(ctx, req),
+    updateCatalog: (id, req) => updateCatalog(ctx, id, req),
     enableCatalog: (id) => enableCatalog(ctx, id),
+    disableCatalog: (id) => disableCatalog(ctx, id),
+    deleteCatalog: (id) => deleteCatalog(ctx, id),
+    testCatalogConnection: (id) => testCatalogConnection(ctx, id),
     discoverCatalog: (id, wait = false) => discoverCatalog(ctx, id, wait),
     catalogResources: (id, category) => listCatalogResources(ctx, id, category),
     catalogHealth: (ids) => catalogHealthStatus(ctx, ids),
     connectorTypes: () => listConnectorTypes(ctx),
     connectorType: (type) => getConnectorType(ctx, type),
+    /** Run SQL / OpenSearch DSL directly against a data source. */
+    sql: (body) => runSql(ctx, body),
     /** Build a resource's index. With `wait`, polls until terminal. */
     build: async (req, opts = {}) => {
       const task = await createBuildTask(ctx, req);
       if (!opts.wait) return task;
       return pollBuildTask(ctx, task.id, opts.timeoutMs ?? 3e5, opts.intervalMs ?? 2e3);
     },
-    buildStatus: (taskId) => getBuildTask(ctx, taskId)
+    buildStatus: (taskId) => getBuildTask(ctx, taskId),
+    buildTasks: (opts) => listBuildTasks(ctx, opts),
+    deleteBuildTasks: (ids, opts) => deleteBuildTasks(ctx, ids, opts),
+    startBuildTask: (taskId, opts) => startBuildTask(ctx, taskId, opts),
+    stopBuildTask: (taskId) => stopBuildTask(ctx, taskId)
   };
 }
 async function pollBuildTask(ctx, taskId, timeoutMs, intervalMs) {
@@ -4926,7 +5318,6 @@ function resolveUrl(ctx, path) {
   return path.startsWith("http") ? path : `${ctx.baseUrl}${path.startsWith("/") ? "" : "/"}${path}`;
 }
 async function rawCall(ctx, path, opts = {}) {
-  applyTls(ctx);
   const url = resolveUrl(ctx, path);
   const extra = {};
   for (const h of opts.header ?? []) {
@@ -4952,18 +5343,69 @@ async function rawCall(ctx, path, opts = {}) {
 `);
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), opts.timeoutMs ?? 3e4);
-  const send = () => fetch(url, { method, headers: headersFor(), body, signal: controller.signal });
   try {
-    let res = await send();
-    if (res.status === 401 && ctx.refresh && await tryRefresh(ctx)) {
-      res = await send();
-    }
+    const res = await authFetch(
+      ctx,
+      () => tlsFetch(ctx.insecure, url, {
+        method,
+        headers: headersFor(),
+        body,
+        signal: controller.signal
+      })
+    );
     return { status: res.status, statusText: res.statusText, body: await res.text() };
   } finally {
     clearTimeout(timer);
   }
 }
 
+// src/api/app-keys.ts
+var ME = "/api/safe/v1/me/api-keys";
+var ADMIN2 = "/api/safe/v1/admin/api-keys";
+function listMyApiKeys(ctx) {
+  return request(ctx, ME);
+}
+function createMyApiKey(ctx, input) {
+  return request(ctx, ME, {
+    method: "POST",
+    body: {
+      name: input.name,
+      ...input.expiresAt ? { expires_at: input.expiresAt } : {},
+      ...input.neverExpire ? { never_expire: true } : {}
+    }
+  });
+}
+async function revokeMyApiKey(ctx, id) {
+  await request(ctx, `${ME}/${encodeURIComponent(id)}`, { method: "DELETE" });
+}
+function regenerateMyApiKey(ctx, id) {
+  return request(ctx, `${ME}/${encodeURIComponent(id)}/regenerate`, { method: "POST" });
+}
+function listApiKeysAdmin(ctx, ownerId) {
+  return request(ctx, ADMIN2, { query: { owner_id: ownerId || void 0 } });
+}
+async function revokeApiKeyAdmin(ctx, id) {
+  await request(ctx, `${ADMIN2}/${encodeURIComponent(id)}`, { method: "DELETE" });
+}
+
+// src/resources/app-keys.ts
+function appKeys(ctx) {
+  return {
+    /** List the caller's own keys (no secrets). */
+    list: () => listMyApiKeys(ctx),
+    /** Issue a key — the result's `key` is the plaintext, shown only once. */
+    create: (input) => createMyApiKey(ctx, input),
+    /** Revoke one of the caller's keys (immediate). */
+    revoke: (id) => revokeMyApiKey(ctx, id),
+    /** Rotate a key in place — new plaintext (shown once); old secret dies now. */
+    regenerate: (id) => regenerateMyApiKey(ctx, id),
+    /** Admin: list all keys, or one owner's (adds `owner_user_id`). */
+    adminList: (ownerId) => listApiKeysAdmin(ctx, ownerId),
+    /** Admin: revoke any key. */
+    adminRevoke: (id) => revokeApiKeyAdmin(ctx, id)
+  };
+}
+
 // src/client.ts
 function createClient(opts = {}) {
   const ctx = resolveContext(opts);
@@ -4979,6 +5421,7 @@ function createClient(opts = {}) {
     toolboxes: toolboxes(ctx),
     trace: trace(ctx),
     admin: admin(ctx),
+    appKeys: appKeys(ctx),
     vega: vega(ctx),
     call: (path, callOpts) => rawCall(ctx, path, callOpts)
   };
@@ -4987,7 +5430,6 @@ function createClient(opts = {}) {
 // src/resources/auth.ts
 var auth_exports = {};
 __export(auth_exports, {
-  attachNoAuth: () => attachNoAuth,
   attachToken: () => attachToken,
   currentToken: () => currentToken,
   currentTokenFresh: () => currentTokenFresh,
@@ -5025,7 +5467,8 @@ function attachToken(baseUrl, accessToken, opts = {}) {
     accessToken,
     refreshToken: opts.refreshToken,
     idToken: opts.idToken,
-    tlsInsecure: opts.insecure,
+    // Remember `-k` so a self-signed platform needn't repeat it every command.
+    tlsInsecure: opts.insecure ? true : void 0,
     // Prefer the account the user typed (-u); device tokens carry no username.
     username: opts.username ?? decodeJwt(opts.idToken ?? accessToken)?.preferred_username
   };
@@ -5033,33 +5476,40 @@ function attachToken(baseUrl, accessToken, opts = {}) {
   setActivePlatform(url);
   return { baseUrl: url, userId, username: usernameOf(token) };
 }
-function attachNoAuth(baseUrl, opts = {}) {
-  const url = normalize(baseUrl);
-  writeToken(url, { baseUrl: url, accessToken: "", noAuth: true, tlsInsecure: opts.insecure });
-  setActivePlatform(url);
-  return { baseUrl: url, noAuth: true };
+function targetUser(baseUrl, userOrName) {
+  if (!userOrName) return activeUserId(baseUrl);
+  const id = findUserId(baseUrl, userOrName);
+  if (!id) {
+    const known = usersOfPlatform(baseUrl).map((u) => u.username ?? u.userId).join(", ");
+    throw new InputError(
+      `No saved user '${userOrName}' on ${baseUrl}. Saved: ${known || "(none)"}.`
+    );
+  }
+  return id;
 }
-function status() {
+function status(opts = {}) {
   const baseUrl = activePlatform();
   if (!baseUrl) return { hasToken: false };
-  const token = readToken(baseUrl);
+  const userId = targetUser(baseUrl, opts.user);
+  const token = readToken(baseUrl, userId);
   return {
     baseUrl,
-    userId: activeUserId(baseUrl),
+    userId,
     hasToken: token !== void 0,
     username: usernameOf(token),
     expired: token ? isExpired(decodeJwt(token.accessToken)) : void 0
   };
 }
-function currentToken() {
+function currentToken(opts = {}) {
   const baseUrl = activePlatform();
-  const token = baseUrl ? readToken(baseUrl) : void 0;
+  const token = baseUrl ? readToken(baseUrl, targetUser(baseUrl, opts.user)) : void 0;
   if (!token) throw new InputError("Not logged in. Run `openbkn auth login <url> --token <t>`.");
   return token.accessToken;
 }
-async function currentTokenFresh() {
+async function currentTokenFresh(opts = {}) {
   const baseUrl = activePlatform();
-  const token = baseUrl ? readToken(baseUrl) : void 0;
+  const userId = baseUrl ? targetUser(baseUrl, opts.user) : void 0;
+  const token = baseUrl ? readToken(baseUrl, userId) : void 0;
   if (!baseUrl || !token) {
     throw new InputError("Not logged in. Run `openbkn auth login <url> --token <t>`.");
   }
@@ -5068,22 +5518,27 @@ async function currentTokenFresh() {
   const needsRefresh = decodable ? isExpired(claims) : true;
   if (token.refreshToken && needsRefresh) {
     try {
-      const t = await refreshAccessToken(baseUrl, token.refreshToken);
-      writeToken(baseUrl, {
-        ...token,
-        accessToken: t.accessToken,
-        refreshToken: t.refreshToken ?? token.refreshToken,
-        idToken: t.idToken ?? token.idToken
-      });
+      const t = await refreshAccessToken(baseUrl, token.refreshToken, void 0, opts.insecure);
+      writeToken(
+        baseUrl,
+        {
+          ...token,
+          accessToken: t.accessToken,
+          refreshToken: t.refreshToken ?? token.refreshToken,
+          idToken: t.idToken ?? token.idToken
+        },
+        { setActive: !opts.user }
+      );
       return t.accessToken;
     } catch {
     }
   }
   return token.accessToken;
 }
-function whoami() {
+function whoami(opts = {}) {
   const baseUrl = activePlatform();
-  const token = baseUrl ? readToken(baseUrl) : void 0;
+  const userId = baseUrl ? targetUser(baseUrl, opts.user) : void 0;
+  const token = baseUrl ? readToken(baseUrl, userId) : void 0;
   const claims = decodeJwt(token?.idToken ?? "") ?? decodeJwt(token?.accessToken ?? "");
   if (!claims) {
     throw new InputError(
@@ -5093,7 +5548,7 @@ function whoami() {
   return {
     ...claims,
     baseUrl: baseUrl ?? void 0,
-    userId: baseUrl ? activeUserId(baseUrl) : void 0,
+    userId,
     username: usernameOf(token)
   };
 }
@@ -5157,7 +5612,6 @@ export {
   formatError,
   isHeadless,
   openBrowser,
-  fetchAuthStatus,
   deviceLogin,
   credentialDeviceLogin,
   request,
@@ -5172,6 +5626,7 @@ export {
   writePlatformConfig,
   resolveContext,
   getUserSafe,
+  changePasswordSafe,
   admin,
   agents,
   context,
@@ -5188,7 +5643,6 @@ export {
   vega,
   createClient,
   attachToken,
-  attachNoAuth,
   status,
   currentToken,
   currentTokenFresh,
@@ -5201,4 +5655,4 @@ export {
   exportCreds,
   auth_exports
 };
-//# sourceMappingURL=chunk-DTU5DGJW.js.map
+//# sourceMappingURL=chunk-NC6DZ2AU.js.map