@agentxm/client-core 0.6.0 → 0.6.2

package/dist/src/unstable/telemetry/client.js

@@ -70,7 +70,15 @@ export const makeTelemetryClient = (options) => Effect.gen(function* () {
     const reportError = (error) => {
         const now = new Date().toISOString();
         const payload = {
-            errors: [{ message: error.message, name: error.name }],
+            errors: [
+                {
+                    message: error.message,
+                    name: error.name,
+                    ...(error.details !== undefined && error.details.length > 0
+                        ? { details: error.details }
+                        : {}),
+                },
+            ],
             level: error.level,
             handled: error.handled,
             tags: {

package/dist/src/unstable/telemetry/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../src/unstable/telemetry/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../src/unstable/telemetry/client.ts"],"names":[],"mappings":"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"}

package/dist/src/unstable/utils/build-zip-archive.d.ts

@@ -1,19 +1,20 @@
 /**
  * Build a deterministic zip archive of a directory.
  *
- * Uses node:child_process and node:fs directly because this operation
- * requires the system `zip` and `find` commands for deterministic archives.
- * This is an intentional escape hatch from @effect/platform.
+ * Uses fflate (pure JS) so publish works on platforms without a system
+ * `zip` binary (notably Windows). Entries are walked via the platform
+ * FileSystem service, sorted by relative path, and stamped with a fixed
+ * mtime so the byte output is reproducible.
  *
  * @experimental This API is unstable and may change without notice.
  */
 import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
 /**
  * Build a zip archive of a directory.
  * Files are stored at the root of the zip (no enclosing directory).
- *
- * Copies the source directory to a temporary location before normalizing
- * timestamps, so the original directory is never mutated.
+ * Directory entries are not emitted.
  */
-export declare const buildZipArchive: (dir: string, errorCode: string) => Effect.Effect<Uint8Array<ArrayBuffer>, import("../app-error/app-error.ts").AppError, never>;
+export declare const buildZipArchive: (dir: string) => Effect.Effect<Uint8Array<ArrayBufferLike>, import("../app-error/app-error.ts").AppError, FileSystem.FileSystem | Path.Path>;
 //# sourceMappingURL=build-zip-archive.d.ts.map

package/dist/src/unstable/utils/build-zip-archive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-zip-archive.d.ts","sourceRoot":"","sources":["../../../../src/unstable/utils/build-zip-archive.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAwBxC;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,EAAE,WAAW,MAAM,gGAwC1D,CAAC"}
+{"version":3,"file":"build-zip-archive.d.ts","sourceRoot":"","sources":["../../../../src/unstable/utils/build-zip-archive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAOpC;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,gIA8DvC,CAAC"}

package/dist/src/unstable/utils/build-zip-archive.js

@@ -1,69 +1,59 @@
 /**
  * Build a deterministic zip archive of a directory.
  *
- * Uses node:child_process and node:fs directly because this operation
- * requires the system `zip` and `find` commands for deterministic archives.
- * This is an intentional escape hatch from @effect/platform.
+ * Uses fflate (pure JS) so publish works on platforms without a system
+ * `zip` binary (notably Windows). Entries are walked via the platform
+ * FileSystem service, sorted by relative path, and stamped with a fixed
+ * mtime so the byte output is reproducible.
  *
  * @experimental This API is unstable and may change without notice.
  */
 import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import { zipSync } from "fflate";
 import { makeAppError } from "../app-error/index.js";
-/**
- * Check that a required system binary exists on PATH.
- */
-const requireBinary = (name, _errorCode) => Effect.tryPromise({
-    try: async () => {
-        const { execFileSync } = await import("node:child_process");
-        execFileSync("which", [name], { stdio: "pipe" });
-    },
-    catch: () => makeAppError({
-        code: "internal",
-        message: `Required system command "${name}" not found`,
-        breadcrumbs: [
-            {
-                description: `Install "${name}" and ensure it is available on your PATH.`,
-            },
-        ],
-    }),
-});
+const DETERMINISTIC_MTIME = new Date("2020-01-01T00:00:00Z");
+const READ_CONCURRENCY = 16;
 /**
  * Build a zip archive of a directory.
  * Files are stored at the root of the zip (no enclosing directory).
- *
- * Copies the source directory to a temporary location before normalizing
- * timestamps, so the original directory is never mutated.
+ * Directory entries are not emitted.
  */
-export const buildZipArchive = (dir, errorCode) => Effect.gen(function* () {
-    yield* requireBinary("find", errorCode);
-    yield* requireBinary("zip", errorCode);
-    return yield* Effect.tryPromise({
-        try: async () => {
-            const { execFileSync } = await import("node:child_process");
-            const { readFile, mkdtemp, rm, cp } = await import("node:fs/promises");
-            const { tmpdir } = await import("node:os");
-            const p = await import("node:path");
-            const tmpDir = await mkdtemp(p.join(tmpdir(), "axm-publish-"));
-            const copyDir = p.join(tmpDir, "content");
-            const archivePath = p.join(tmpDir, "archive.zip");
-            // Copy source to temp directory to avoid mutating original timestamps
-            await cp(dir, copyDir, { recursive: true });
-            // Create deterministic zip (strip extra attributes, normalize timestamps)
-            // -X strips extra file attributes, -D disables directory entries
-            // find + touch normalizes file timestamps for reproducible archives
-            execFileSync("find", [copyDir, "-exec", "touch", "-t", "202001010000.00", "{}", "+"]);
-            execFileSync("zip", ["-r", "-q", "-X", "-D", archivePath, "."], {
-                cwd: copyDir,
-                stdio: "pipe",
-            });
-            const bytes = await readFile(archivePath);
-            await rm(tmpDir, { recursive: true, force: true });
-            return new Uint8Array(bytes);
-        },
-        catch: (e) => makeAppError({
+export const buildZipArchive = (dir) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const files = yield* Effect.gen(function* () {
+        const rawEntries = yield* fs.readDirectory(dir, { recursive: true });
+        const toZipPath = path.sep === "/" ? (s) => s : (s) => s.split(path.sep).join("/");
+        const candidates = yield* Effect.forEach(rawEntries, (relRaw) => Effect.gen(function* () {
+            const abs = path.join(dir, relRaw);
+            const info = yield* fs.stat(abs);
+            return { rel: toZipPath(relRaw), abs, isFile: info.type === "File" };
+        }), { concurrency: READ_CONCURRENCY });
+        const onlyFiles = candidates.filter((c) => c.isFile);
+        onlyFiles.sort((a, b) => (a.rel < b.rel ? -1 : a.rel > b.rel ? 1 : 0));
+        return onlyFiles;
+    }).pipe(Effect.mapError((cause) => makeAppError({
+        code: "internal",
+        message: "Failed to read source directory for zip archive",
+        cause,
+    })));
+    const contents = yield* Effect.forEach(files, ({ rel, abs }) => fs.readFile(abs).pipe(Effect.map((bytes) => [rel, bytes])), { concurrency: READ_CONCURRENCY }).pipe(Effect.mapError((cause) => makeAppError({
+        code: "internal",
+        message: "Failed to read file for zip archive",
+        cause,
+    })));
+    const zippable = {};
+    for (const [rel, bytes] of contents) {
+        zippable[rel] = [bytes, { mtime: DETERMINISTIC_MTIME }];
+    }
+    return yield* Effect.try({
+        try: () => zipSync(zippable, { mtime: DETERMINISTIC_MTIME }),
+        catch: (cause) => makeAppError({
             code: "internal",
             message: "Failed to build zip archive",
-            cause: e,
+            cause,
         }),
     });
 });

package/dist/src/unstable/utils/build-zip-archive.js.map

@@ -1 +1 @@
-{"version":3,"file":"build-zip-archive.js","sourceRoot":"","sources":["../../../../src/unstable/utils/build-zip-archive.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"build-zip-archive.js","sourceRoot":"","sources":["../../../../src/unstable/utils/build-zip-archive.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentxm/client-core",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Core library for the axm agent extension manager. Unstable and unsupported — use the axm.sh CLI.",
   "type": "module",
   "license": "MIT",
@@ -198,23 +198,26 @@
   },
   "dependencies": {
     "@effect/platform-node": "4.0.0-beta.64",
+    "@napi-rs/keyring": "^1.3.0",
     "effect": "4.0.0-beta.64",
     "fflate": "^0.8.2",
     "gray-matter": "^4.0.3",
     "jsonc-parser": "^3.3.1",
     "packageurl-js": "^2.0.1",
     "semver": "^7.8.0",
+    "proper-lockfile": "^4.1.2",
     "simple-git": "^3.36.0"
   },
   "devDependencies": {
     "@effect/openapi-generator": "4.0.0-beta.64",
     "@effect/vitest": "4.0.0-beta.64",
     "@types/bun": "^1.3.13",
+    "@types/proper-lockfile": "^4.1.4",
     "@types/semver": "^7.5.8",
     "swagger2openapi": "^7.0.8",
     "typescript": "^5.9.3",
     "vitest": "^4.1.5",
     "yaml": "^2.8.4",
-    "@agentxm/client-utils": "^0.6.0"
+    "@agentxm/client-utils": "^0.6.2"
   }
 }

package/site-content/__generated__/schemas/settings.schema.json

@@ -87,7 +87,7 @@
       "required": ["name", "type", "url"],
       "additionalProperties": false,
       "title": "GitHub Source Host",
-      "description": "GitHub host available by its `name` alias in entry source strings."
+      "description": "A GitHub source host."
     },
     "GitLabSourceHostConfig": {
       "type": "object",
@@ -99,7 +99,7 @@
       "required": ["name", "type", "url"],
       "additionalProperties": false,
       "title": "GitLab Source Host",
-      "description": "GitLab host available by its `name` alias in entry source strings."
+      "description": "A GitLab source host."
     },
     "BitbucketSourceHostConfig": {
       "type": "object",
@@ -111,7 +111,7 @@
       "required": ["name", "type", "url"],
       "additionalProperties": false,
       "title": "Bitbucket Source Host",
-      "description": "Bitbucket host available by its `name` alias in entry source strings."
+      "description": "A Bitbucket source host."
     },
     "AzureReposSourceHostConfig": {
       "type": "object",
@@ -123,7 +123,7 @@
       "required": ["name", "type", "url"],
       "additionalProperties": false,
       "title": "Azure Repos Source Host",
-      "description": "Azure Repos host available by its `name` alias in entry source strings."
+      "description": "An Azure Repos source host."
     },
     "RegistrySourceHostConfig": {
       "type": "object",
@@ -135,7 +135,7 @@
       "required": ["name", "type", "location"],
       "additionalProperties": false,
       "title": "Registry Source Host",
-      "description": "Registry source available by its `name` alias in entry source strings."
+      "description": "A package registry source host."
     },
     "SourceHostConfig": {
       "anyOf": [
@@ -146,7 +146,7 @@
         { "$ref": "#/definitions/RegistrySourceHostConfig" }
       ],
       "title": "Source Host Config",
-      "description": "Where extensions are fetched from — GitHub, GitLab, Bitbucket, Azure Repos, or a package registry."
+      "description": "A source host configuration: GitHub, GitLab, Bitbucket, Azure Repos, or a package registry."
     },
     "SkillEntry": {
       "anyOf": [
@@ -170,23 +170,23 @@
             },
             "enabled": {
               "type": "boolean",
-              "description": "Whether this entry is enabled. Defaults to true when omitted.",
+              "description": "Set to false to disable this entry. Omit otherwise — true is the default and should not be written explicitly.",
               "default": true
             },
             "authored": {
               "type": "boolean",
-              "description": "Whether this entry was authored locally. Defaults to false when omitted.",
+              "description": "Set to true to mark this entry as authored locally in this workspace. Omit otherwise — false is the default and should not be written explicitly.",
               "default": false
             }
           },
           "required": ["source"],
           "additionalProperties": false,
           "title": "Skill Entry Object",
-          "description": "A skill with source, enabled, and authored settings."
+          "description": "A skill entry with source and optional enabled/authored flags."
         }
       ],
       "title": "Skill Entry",
-      "description": "Skill source string or object. Source accepts FQN + optional version, source-scheme refs, and local paths.",
+      "description": "A skill entry: a source string, or an object with source plus optional flags.",
       "examples": [
         "@acme/skills/code-review@^1.0.0",
         { "source": "github:acme/agent-extensions", "enabled": false }
@@ -195,7 +195,7 @@
     "SkillsMap": {
       "type": "object",
       "title": "Skills Map",
-      "description": "Your installed skills, keyed by name.",
+      "description": "A map of skill names to skill entries.",
       "propertyNames": { "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$" },
       "additionalProperties": { "$ref": "#/definitions/SkillEntry" }
     },
@@ -235,23 +235,23 @@
             },
             "enabled": {
               "type": "boolean",
-              "description": "Whether this entry is enabled. Defaults to true when omitted.",
+              "description": "Set to false to disable this entry. Omit otherwise — true is the default and should not be written explicitly.",
               "default": true
             },
             "authored": {
               "type": "boolean",
-              "description": "Whether this entry was authored locally. Defaults to false when omitted.",
+              "description": "Set to true to mark this entry as authored locally in this workspace. Omit otherwise — false is the default and should not be written explicitly.",
               "default": false
             }
           },
           "required": ["source"],
           "additionalProperties": false,
           "title": "Command Entry Object",
-          "description": "A command with source, enabled, and authored settings."
+          "description": "A command entry with source and optional enabled/authored flags."
         }
       ],
       "title": "Command Entry",
-      "description": "Command source string or object. Source accepts FQN + optional version, source-scheme refs, and local paths.",
+      "description": "A command entry: a source string, or an object with source plus optional flags.",
       "examples": [
         "@acme/commands/code-review@^1.0.0",
         { "source": "github:acme/agent-extensions", "enabled": false }
@@ -260,7 +260,7 @@
     "CommandsMap": {
       "type": "object",
       "title": "Commands Map",
-      "description": "Your installed commands, keyed by name.",
+      "description": "A map of command names to command entries.",
       "propertyNames": { "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$" },
       "additionalProperties": { "$ref": "#/definitions/CommandEntry" }
     },
@@ -300,23 +300,23 @@
             },
             "enabled": {
               "type": "boolean",
-              "description": "Whether this entry is enabled. Defaults to true when omitted.",
+              "description": "Set to false to disable this entry. Omit otherwise — true is the default and should not be written explicitly.",
               "default": true
             },
             "authored": {
               "type": "boolean",
-              "description": "Whether this entry was authored locally. Defaults to false when omitted.",
+              "description": "Set to true to mark this entry as authored locally in this workspace. Omit otherwise — false is the default and should not be written explicitly.",
               "default": false
             }
           },
           "required": ["source"],
           "additionalProperties": false,
           "title": "Subagent Entry Object",
-          "description": "A subagent with source, enabled, and authored settings."
+          "description": "A subagent entry with source and optional enabled/authored flags."
         }
       ],
       "title": "Subagent Entry",
-      "description": "Subagent source string or object. Source accepts FQN + optional version, source-scheme refs, and local paths.",
+      "description": "A subagent entry: a source string, or an object with source plus optional flags.",
       "examples": [
         "@acme/subagents/reviewer@^1.0.0",
         { "source": "github:acme/agent-extensions", "enabled": false }
@@ -325,7 +325,7 @@
     "SubagentsMap": {
       "type": "object",
       "title": "Subagents Map",
-      "description": "Your installed subagents, keyed by name.",
+      "description": "A map of subagent names to subagent entries.",
       "propertyNames": { "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$" },
       "additionalProperties": { "$ref": "#/definitions/SubagentEntry" }
     },
@@ -365,18 +365,18 @@
             },
             "authored": {
               "type": "boolean",
-              "description": "Whether this entry was authored locally. Defaults to false when omitted.",
+              "description": "Set to true to mark this entry as authored locally in this workspace. Omit otherwise — false is the default and should not be written explicitly.",
               "default": false
             }
           },
           "required": ["source"],
           "additionalProperties": false,
           "title": "Pack Entry Object",
-          "description": "A pack with source and authored settings. Pack entries do not support `enabled` yet."
+          "description": "A pack entry with source and optional authored flag."
         }
       ],
       "title": "Pack Entry",
-      "description": "Pack source string or object. Source accepts FQN + optional version, source-scheme refs, and local paths. Pack entries do not support `enabled` yet.",
+      "description": "A pack entry: a source string, or an object with source plus optional authored flag.",
       "examples": [
         "@acme/packs/typescript@^1.0.0",
         { "source": "github:acme/agent-extensions", "authored": true }
@@ -385,7 +385,7 @@
     "PacksMap": {
       "type": "object",
       "title": "Packs Map",
-      "description": "Your installed packs, keyed by name.",
+      "description": "A map of pack names to pack entries.",
       "propertyNames": { "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$" },
       "additionalProperties": { "$ref": "#/definitions/PackEntry" }
     },
@@ -425,18 +425,18 @@
             },
             "authored": {
               "type": "boolean",
-              "description": "Whether this entry was authored locally. Defaults to false when omitted.",
+              "description": "Set to true to mark this entry as authored locally in this workspace. Omit otherwise — false is the default and should not be written explicitly.",
               "default": false
             }
           },
           "required": ["source"],
           "additionalProperties": false,
           "title": "MCP Server Entry Object",
-          "description": "An MCP server with source and authored settings. MCP entries do not support `enabled` yet."
+          "description": "An MCP server entry with source and optional authored flag."
         }
       ],
       "title": "MCP Server Entry",
-      "description": "MCP server source string or object. Source accepts FQN + optional version, source-scheme refs, and local paths. MCP entries do not support `enabled` yet.",
+      "description": "An MCP server entry: a source string, or an object with source plus optional authored flag.",
       "examples": [
         "@acme/mcp-servers/context@^1.0.0",
         { "source": "github:acme/agent-extensions", "authored": true }
@@ -445,7 +445,7 @@
     "McpServersMap": {
       "type": "object",
       "title": "MCP Servers Map",
-      "description": "Your installed MCP servers, keyed by name.",
+      "description": "A map of MCP server names to MCP server entries.",
       "propertyNames": { "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$" },
       "additionalProperties": { "$ref": "#/definitions/McpServerEntry" }
     },
@@ -508,7 +508,7 @@
         },
         "skills": {
           "anyOf": [{ "$ref": "#/definitions/SkillsMap" }],
-          "description": "Desired skills keyed by workspace skill name."
+          "description": "Your installed skills, keyed by workspace skill name. Prefer plain source strings; use the object form only to set `enabled: false` or `authored: true`, and never write `enabled: true` or `authored: false` explicitly."
         },
         "skillsConfig": {
           "anyOf": [{ "$ref": "#/definitions/SkillsConfig" }],
@@ -516,7 +516,7 @@
         },
         "commands": {
           "anyOf": [{ "$ref": "#/definitions/CommandsMap" }],
-          "description": "Desired commands keyed by workspace command name."
+          "description": "Your installed commands, keyed by workspace command name. Prefer plain source strings; use the object form only to set `enabled: false` or `authored: true`, and never write `enabled: true` or `authored: false` explicitly."
         },
         "commandsConfig": {
           "anyOf": [{ "$ref": "#/definitions/CommandsConfig" }],
@@ -524,7 +524,7 @@
         },
         "subagents": {
           "anyOf": [{ "$ref": "#/definitions/SubagentsMap" }],
-          "description": "Desired subagents keyed by workspace subagent name."
+          "description": "Your installed subagents, keyed by workspace subagent name. Prefer plain source strings; use the object form only to set `enabled: false` or `authored: true`, and never write `enabled: true` or `authored: false` explicitly."
         },
         "subagentsConfig": {
           "anyOf": [{ "$ref": "#/definitions/SubagentsConfig" }],
@@ -532,7 +532,7 @@
         },
         "packs": {
           "anyOf": [{ "$ref": "#/definitions/PacksMap" }],
-          "description": "Desired packs keyed by workspace pack name."
+          "description": "Your installed packs, keyed by workspace pack name. Prefer plain source strings; use the object form only to set `authored: true`, and never write `authored: false` explicitly. Pack entries do not support `enabled` yet."
         },
         "packsConfig": {
           "anyOf": [{ "$ref": "#/definitions/PacksConfig" }],
@@ -540,7 +540,7 @@
         },
         "mcpServers": {
           "anyOf": [{ "$ref": "#/definitions/McpServersMap" }],
-          "description": "Desired MCP servers keyed by workspace MCP server name."
+          "description": "Your installed MCP servers, keyed by workspace MCP server name. Prefer plain source strings; use the object form only to set `authored: true`, and never write `authored: false` explicitly. MCP server entries do not support `enabled` yet."
         },
         "mcpServersConfig": {
           "anyOf": [{ "$ref": "#/definitions/McpServersConfig" }],
@@ -559,11 +559,8 @@
           "telemetry": "errors",
           "agents": ["claude-code", "codex"],
           "skills": {
-            "code-review": {
-              "source": "@acme/skills/code-review@^1.0.0",
-              "enabled": true,
-              "authored": false
-            }
+            "code-review": "@acme/skills/code-review@^1.0.0",
+            "legacy-rules": { "source": "@acme/skills/legacy-rules@^1.0.0", "enabled": false }
           },
           "skillsConfig": { "ignore": ["local-*"] },
           "lint": { "rules": { "workspace/settings-schema-valid": "error" } }

package/site-content/docs/quickstart.md

@@ -138,7 +138,10 @@ After installing axm through any method, you need to authenticate.
 axm auth login
 ```
 
-Opens a browser for OAuth device code authorization. Grant access when prompted.
+Opens a browser for AgentXM.ai authorization. Grant access when prompted.
+On desktop systems this uses a local loopback callback with PKCE. In SSH, CI,
+Codespaces, or `--device-code` mode, AXM displays a five-minute device code and
+opens the static verification page.
 
 Verify authentication:
 

package/site-content/install.md

@@ -275,9 +275,10 @@ local token so subsequent `axm` commands can reach the registry.
 Offer both paths and let the user pick:
 
 - **Interactive (recommended):** ask the user to run `axm login` in their
-  terminal. Tell them this opens a browser for a one-time OAuth device
-  flow; AXM can't run it on their behalf because the browser step requires
-  them to be present.
+  terminal. Tell them this opens a browser for a one-time AgentXM.ai
+  authorization flow; AXM can't run it on their behalf because the browser step
+  requires them to be present. In SSH, CI, Codespaces, or `--device-code` mode,
+  AXM falls back to a five-minute device-code flow.
 - **Non-interactive:** ask the user to export `AXM_TOKEN` in the
   environment where AXM will run. Explain that `AXM_TOKEN` is a
   pre-generated credential that skips the browser step; you must not