@mutagent/cli 0.1.380 → 0.1.382

package/dist/bin/cli.js

@@ -16680,12 +16680,14 @@ var init_config = __esm(() => {
 // src/lib/organization-scope.ts
 var exports_organization_scope = {};
 __export(exports_organization_scope, {
+  unreachableServerError: () => unreachableServerError,
   tenancyHeaders: () => tenancyHeaders,
   tenancyFailure: () => tenancyFailure,
   setWorkspaceFlag: () => setWorkspaceFlag,
   setOrgAssertion: () => setOrgAssertion,
   resolveKeyTenancy: () => resolveKeyTenancy,
   otherOrganizationHint: () => otherOrganizationHint,
+  orgMismatch: () => orgMismatch,
   noWorkspaceSelected: () => noWorkspaceSelected,
   matchesOrganization: () => matchesOrganization,
   looksLikeWorkspaceId: () => looksLikeWorkspaceId,
@@ -16694,6 +16696,7 @@ __export(exports_organization_scope, {
   fetchOrganizations: () => fetchOrganizations,
   fetchKeySelf: () => fetchKeySelf,
   envKeyHasNoSelection: () => envKeyHasNoSelection,
+  deadKeyError: () => deadKeyError,
   configTenancyHeaders: () => configTenancyHeaders,
   TenancyError: () => TenancyError,
   TENANCY_DENIED: () => TENANCY_DENIED
@@ -16731,11 +16734,13 @@ function parseBody(body) {
   } catch {}
   return {};
 }
+function deadKeyError() {
+  return new TenancyError("AUTH_EXPIRED", "Your CLI key expired or was revoked.", "Run: mutagent login", 2);
+}
 function tenancyFailure(status, body, ctx) {
   const parsed = parseBody(body);
-  if (status === 401) {
-    return new TenancyError("AUTH_EXPIRED", "Your CLI key expired or was revoked.", "Run: mutagent login", 2);
-  }
+  if (status === 401)
+    return deadKeyError();
   if (status === 403 && parsed.code === TENANCY_DENIED) {
     const shown = ctx.workspaceName ?? ctx.workspaceId ?? "workspace";
     if (ctx.workspaceOrigin === "selection") {
@@ -16763,9 +16768,16 @@ async function tenancyFetch(url, init) {
   try {
     return await fetch(url, init);
   } catch {
-    throw new MutagentError("REQUEST_FAILED", `Unable to connect to the Mutagent server at ${new URL(url).origin}.`, "Check your connection and the endpoint: mutagent config get endpoint");
+    throw unreachableServerError(url);
   }
 }
+function unreachableServerError(url) {
+  let origin = url;
+  try {
+    origin = new URL(url).origin;
+  } catch {}
+  return new MutagentError("REQUEST_FAILED", `Unable to connect to the Mutagent server at ${origin}.`, "Check your connection and the endpoint: mutagent config get endpoint");
+}
 async function fetchKeySelf(apiKey, endpoint, opts = {}) {
   const response = await tenancyFetch(`${endpoint}/api/api-keys/self`, {
     headers: { "x-api-key": apiKey, ...opts.headers }
@@ -16792,7 +16804,13 @@ async function fetchOrganizations(apiKey, endpoint) {
 function matchesOrganization(value2, org) {
   if (!org)
     return false;
-  return value2 === org.id || org.slug !== undefined && value2 === org.slug;
+  if (value2 === org.id || org.slug !== undefined && value2 === org.slug)
+    return true;
+  return org.name !== undefined && value2.toLowerCase() === org.name.toLowerCase();
+}
+function orgMismatch(value2, org) {
+  const shown = org.slug ? `${org.name} (${org.slug})` : org.name;
+  return new TenancyError("ORG_MISMATCH", `Your key is for ${shown}.`, `Run: mutagent login --org ${value2}`);
 }
 function otherOrganizationHint(wanted, keyOrg, orgs) {
   const others = orgs.filter((o) => o.id !== keyOrg?.id);
@@ -16842,7 +16860,7 @@ function enforceOrgAssertion(org) {
     throw new TenancyError("ORG_UNKNOWN", "This key's organization is unknown, so --org cannot be checked.", "Run: mutagent workspaces current");
   }
   if (!matchesOrganization(orgAssertion, org)) {
-    throw new TenancyError("ORG_MISMATCH", `Your key is for ${org.name}.`, `Run: mutagent login --org ${orgAssertion}`);
+    throw orgMismatch(orgAssertion, org);
   }
 }
 async function resolveKeyTenancy(apiKey, opts = {}) {
@@ -17165,6 +17183,9 @@ class SDKClientWrapper {
     });
   }
   handleError(error3) {
+    if (error3 instanceof Error && SDK_TRANSPORT_ERRORS.has(error3.name)) {
+      throw unreachableServerError(this.endpoint);
+    }
     if (error3 && typeof error3 === "object") {
       const err = error3;
       if (err.statusCode) {
@@ -17192,7 +17213,7 @@ class SDKClientWrapper {
     }
     if (error3 instanceof TypeError && typeof error3.message === "string") {
       if (error3.message.includes("fetch") || error3.message.includes("network") || error3.message.includes("ECONNREFUSED")) {
-        throw new MutagentError("NETWORK_ERROR", "Unable to connect to the Mutagent server", "Check your internet connection and verify the server URL with: mutagent config list");
+        throw unreachableServerError(this.endpoint);
       }
     }
     if (error3 instanceof Error) {
@@ -17210,15 +17231,20 @@ class SDKClientWrapper {
     } else if (optHeaders) {
       extraHeaders = optHeaders;
     }
-    const response = await fetch(`${this.endpoint}${path}`, {
-      ...options,
-      headers: {
-        "x-api-key": this.apiKey,
-        "Content-Type": "application/json",
-        ...this.tenancyHeaders(),
-        ...extraHeaders
-      }
-    });
+    let response;
+    try {
+      response = await fetch(`${this.endpoint}${path}`, {
+        ...options,
+        headers: {
+          "x-api-key": this.apiKey,
+          "Content-Type": "application/json",
+          ...this.tenancyHeaders(),
+          ...extraHeaders
+        }
+      });
+    } catch {
+      throw unreachableServerError(this.endpoint);
+    }
     if (!response.ok) {
       const error3 = await response.text();
       const tenancy = tenancyFailure(response.status, error3, this.tenancy);
@@ -17507,7 +17533,7 @@ async function validateApiKey(apiKey, endpoint) {
     return false;
   }
 }
-var sdkClient = null;
+var SDK_TRANSPORT_ERRORS, sdkClient = null;
 var init_sdk_client = __esm(() => {
   init_errors();
   init_config();
@@ -17516,6 +17542,7 @@ var init_sdk_client = __esm(() => {
   init_known_secrets();
   init_sdk_mappers();
   init_organization_scope();
+  SDK_TRANSPORT_ERRORS = new Set(["ConnectionError", "RequestTimeoutError", "RequestAbortedError", "UnexpectedClientError"]);
 });
 
 // src/lib/agent/sdk.ts
@@ -19263,7 +19290,7 @@ The CLI key from \`mutagent login\` works in every workspace you are a member of
 organization. Workspace precedence: --workspace, then MUTAGENT_WORKSPACE_ID, then the
 workspace chosen with \`workspaces use\`.
 To work in another organization: mutagent login --org <slug>
-Create or change workspaces in the dashboard: https://app.mutagent.io
+Create or change workspaces in the dashboard: ${getAppBaseUrl()}
     `);
   workspaces.command("list").description("List your workspaces in the key's organization (* = selected)").option("-l, --limit <n>", "Limit results", "50").option("-o, --offset <n>", "Offset for pagination").addHelpText("after", `
 Examples:
@@ -19507,7 +19534,7 @@ ${chalk7.dim("Another organization: sign in for it with mutagent login --org <id
         throw new MutagentError("ORG_UNKNOWN", "This key's organization is unknown.", "Run: mutagent workspaces current");
       }
       if (!matchesOrganization(value2, organization)) {
-        throw new TenancyError("ORG_MISMATCH", `Your key is for ${organization.name}.`, `Run: mutagent login --org ${value2}`);
+        throw orgMismatch(value2, organization);
       }
       if (isJson) {
         output.output({ success: true, organization });
@@ -24808,6 +24835,7 @@ init_errors();
 init_secure_file();
 init_errors();
 init_known_secrets();
+init_organization_scope();
 import { existsSync as existsSync12, readFileSync as readFileSync12, mkdirSync as mkdirSync5, rmSync as rmSync2 } from "fs";
 import { homedir as homedir6 } from "os";
 import { join as join20, dirname as dirname6 } from "path";
@@ -24888,9 +24916,8 @@ async function exchangeToken(input2, deps = {}) {
     const detail = error3 instanceof Error ? error3.message : String(error3);
     throw new MutagentError("SANDBOX_UNREACHABLE", `Could not reach the MutagenT API at ${input2.endpoint}: ${detail}`, "Check your connection, then verify the endpoint with: mutagent config list", 5);
   }
-  if (response.status === 401) {
-    throw new AuthenticationError("Your MutagenT API key was rejected. It may have been revoked or expired.", { suggestions: ["mutagent auth login --browser", "mutagent auth status"] });
-  }
+  if (response.status === 401)
+    throw deadKeyError();
   if (response.status === 403) {
     const detail = scrubKnown(messageFrom(await response.text().catch(() => "")));
     throw new MutagentError("SANDBOX_WORKSPACE_FORBIDDEN", detail !== "" ? detail : `Your API key is valid, but this account cannot use workspace "${input2.workspaceId}".`, `Pick a workspace you belong to: mutagent workspaces list, then mutagent workspaces use <name>`, 3);
@@ -29403,7 +29430,7 @@ var program = new Command18;
 program.name("mutagent").description(`Mutagent CLI - command-line client for the Mutagent platform
 
   Documentation: https://docs.mutagent.io/cli
-  Dashboard:     https://app.mutagent.io`).option("--json", "Output results as JSON (for AI agents)").option("--api-key <key>", "Mutagent API key").option("--endpoint <url>", "Mutagent server endpoint").option("--workspace <name|id>", "Workspace for this command only (beats MUTAGENT_WORKSPACE_ID and the selection)").option("--org <id|slug>", "Check that the key belongs to this organization; a mismatch exits 1 and sends nothing (with login: the organization to sign in to)").option("--non-interactive", "Disable interactive prompts (for CI/AI agents)").configureHelp({
+  Dashboard:     https://app.mutagent.io`).option("--json", "Output results as JSON (for AI agents)").option("--api-key <key>", "Mutagent API key").option("--endpoint <url>", "Mutagent server endpoint").option("--workspace <name|id>", "Workspace for this command only (beats MUTAGENT_WORKSPACE_ID and the selection)").option("--org <id|slug>", "Check that the key belongs to this organization (its id, slug or name); a mismatch exits 1 and sends nothing (with login: the organization to sign in to)").option("--non-interactive", "Disable interactive prompts (for CI/AI agents)").configureHelp({
   sortSubcommands: true,
   showGlobalOptions: true
 });
@@ -29546,4 +29573,4 @@ if (isAgentInvocation(rawArgs)) {
   program.parse(argvForCommander, { from: "user" });
 }
 
-//# debugId=005A5989779CDE4E64756E2164756E21
+//# debugId=22EA0CB4BCE602F064756E2164756E21

package/dist/index.js

@@ -605,12 +605,14 @@ var init_errors = __esm(() => {
 // src/lib/organization-scope.ts
 var exports_organization_scope = {};
 __export(exports_organization_scope, {
+  unreachableServerError: () => unreachableServerError,
   tenancyHeaders: () => tenancyHeaders,
   tenancyFailure: () => tenancyFailure,
   setWorkspaceFlag: () => setWorkspaceFlag,
   setOrgAssertion: () => setOrgAssertion,
   resolveKeyTenancy: () => resolveKeyTenancy,
   otherOrganizationHint: () => otherOrganizationHint,
+  orgMismatch: () => orgMismatch,
   noWorkspaceSelected: () => noWorkspaceSelected,
   matchesOrganization: () => matchesOrganization,
   looksLikeWorkspaceId: () => looksLikeWorkspaceId,
@@ -619,6 +621,7 @@ __export(exports_organization_scope, {
   fetchOrganizations: () => fetchOrganizations,
   fetchKeySelf: () => fetchKeySelf,
   envKeyHasNoSelection: () => envKeyHasNoSelection,
+  deadKeyError: () => deadKeyError,
   configTenancyHeaders: () => configTenancyHeaders,
   TenancyError: () => TenancyError,
   TENANCY_DENIED: () => TENANCY_DENIED
@@ -656,11 +659,13 @@ function parseBody(body) {
   } catch {}
   return {};
 }
+function deadKeyError() {
+  return new TenancyError("AUTH_EXPIRED", "Your CLI key expired or was revoked.", "Run: mutagent login", 2);
+}
 function tenancyFailure(status, body, ctx) {
   const parsed = parseBody(body);
-  if (status === 401) {
-    return new TenancyError("AUTH_EXPIRED", "Your CLI key expired or was revoked.", "Run: mutagent login", 2);
-  }
+  if (status === 401)
+    return deadKeyError();
   if (status === 403 && parsed.code === TENANCY_DENIED) {
     const shown = ctx.workspaceName ?? ctx.workspaceId ?? "workspace";
     if (ctx.workspaceOrigin === "selection") {
@@ -688,9 +693,16 @@ async function tenancyFetch(url, init) {
   try {
     return await fetch(url, init);
   } catch {
-    throw new MutagentError("REQUEST_FAILED", `Unable to connect to the Mutagent server at ${new URL(url).origin}.`, "Check your connection and the endpoint: mutagent config get endpoint");
+    throw unreachableServerError(url);
   }
 }
+function unreachableServerError(url) {
+  let origin = url;
+  try {
+    origin = new URL(url).origin;
+  } catch {}
+  return new MutagentError("REQUEST_FAILED", `Unable to connect to the Mutagent server at ${origin}.`, "Check your connection and the endpoint: mutagent config get endpoint");
+}
 async function fetchKeySelf(apiKey, endpoint, opts = {}) {
   const response = await tenancyFetch(`${endpoint}/api/api-keys/self`, {
     headers: { "x-api-key": apiKey, ...opts.headers }
@@ -717,7 +729,13 @@ async function fetchOrganizations(apiKey, endpoint) {
 function matchesOrganization(value, org) {
   if (!org)
     return false;
-  return value === org.id || org.slug !== undefined && value === org.slug;
+  if (value === org.id || org.slug !== undefined && value === org.slug)
+    return true;
+  return org.name !== undefined && value.toLowerCase() === org.name.toLowerCase();
+}
+function orgMismatch(value, org) {
+  const shown = org.slug ? `${org.name} (${org.slug})` : org.name;
+  return new TenancyError("ORG_MISMATCH", `Your key is for ${shown}.`, `Run: mutagent login --org ${value}`);
 }
 function otherOrganizationHint(wanted, keyOrg, orgs) {
   const others = orgs.filter((o) => o.id !== keyOrg?.id);
@@ -767,7 +785,7 @@ function enforceOrgAssertion(org) {
     throw new TenancyError("ORG_UNKNOWN", "This key's organization is unknown, so --org cannot be checked.", "Run: mutagent workspaces current");
   }
   if (!matchesOrganization(orgAssertion, org)) {
-    throw new TenancyError("ORG_MISMATCH", `Your key is for ${org.name}.`, `Run: mutagent login --org ${orgAssertion}`);
+    throw orgMismatch(orgAssertion, org);
   }
 }
 async function resolveKeyTenancy(apiKey, opts = {}) {
@@ -1090,6 +1108,9 @@ class SDKClientWrapper {
     });
   }
   handleError(error) {
+    if (error instanceof Error && SDK_TRANSPORT_ERRORS.has(error.name)) {
+      throw unreachableServerError(this.endpoint);
+    }
     if (error && typeof error === "object") {
       const err = error;
       if (err.statusCode) {
@@ -1117,7 +1138,7 @@ class SDKClientWrapper {
     }
     if (error instanceof TypeError && typeof error.message === "string") {
       if (error.message.includes("fetch") || error.message.includes("network") || error.message.includes("ECONNREFUSED")) {
-        throw new MutagentError("NETWORK_ERROR", "Unable to connect to the Mutagent server", "Check your internet connection and verify the server URL with: mutagent config list");
+        throw unreachableServerError(this.endpoint);
       }
     }
     if (error instanceof Error) {
@@ -1135,15 +1156,20 @@ class SDKClientWrapper {
     } else if (optHeaders) {
       extraHeaders = optHeaders;
     }
-    const response = await fetch(`${this.endpoint}${path}`, {
-      ...options,
-      headers: {
-        "x-api-key": this.apiKey,
-        "Content-Type": "application/json",
-        ...this.tenancyHeaders(),
-        ...extraHeaders
-      }
-    });
+    let response;
+    try {
+      response = await fetch(`${this.endpoint}${path}`, {
+        ...options,
+        headers: {
+          "x-api-key": this.apiKey,
+          "Content-Type": "application/json",
+          ...this.tenancyHeaders(),
+          ...extraHeaders
+        }
+      });
+    } catch {
+      throw unreachableServerError(this.endpoint);
+    }
     if (!response.ok) {
       const error = await response.text();
       const tenancy = tenancyFailure(response.status, error, this.tenancy);
@@ -1432,7 +1458,7 @@ async function validateApiKey(apiKey, endpoint) {
     return false;
   }
 }
-var sdkClient = null;
+var SDK_TRANSPORT_ERRORS, sdkClient = null;
 var init_sdk_client = __esm(() => {
   init_errors();
   init_config();
@@ -1441,6 +1467,7 @@ var init_sdk_client = __esm(() => {
   init_known_secrets();
   init_sdk_mappers();
   init_organization_scope();
+  SDK_TRANSPORT_ERRORS = new Set(["ConnectionError", "RequestTimeoutError", "RequestAbortedError", "UnexpectedClientError"]);
 });
 
 // src/index.ts
@@ -1664,4 +1691,4 @@ export {
   ApiError
 };
 
-//# debugId=E203EEB55C5F59D464756E2164756E21
+//# debugId=6C0EFE359421B56964756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutagent/cli",
-  "version": "0.1.380",
+  "version": "0.1.382",
   "description": "Bun-native CLI for the MutagenT AI platform - auth, provider config, and lifecycle-tool installer for AI-native workflows",
   "type": "module",
   "bin": {
@@ -42,7 +42,7 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^8.7.2",
-    "@mutagent/sdk": "0.6.14",
+    "@mutagent/sdk": "0.6.15",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "cosmiconfig": "^9.0.0",