@dexto/agent-management 1.6.20 → 1.6.22

package/dist/AgentFactory.cjs

@@ -72,7 +72,17 @@ const AgentFactory = {
    * Install a custom agent from local path
    */
   async installCustomAgent(agentId, sourcePath, metadata, options) {
-    return (0, import_installation.installCustomAgent)(agentId, sourcePath, metadata, options);
+    if (options?.agentsDir) {
+      throw new Error(
+        "Custom agentsDir overrides are not supported by AgentFactory.installCustomAgent"
+      );
+    }
+    return (0, import_registry.getAgentRegistry)().installCustomAgentFromPath(agentId, sourcePath, {
+      name: metadata.name,
+      description: metadata.description,
+      author: metadata.author || "Custom",
+      tags: metadata.tags ?? []
+    });
   },
   /**
    * Uninstall an agent
@@ -80,7 +90,7 @@ const AgentFactory = {
    * @param _force - Deprecated: force parameter is kept for backward compatibility but has no effect
    */
   async uninstallAgent(agentId, _force) {
-    return (0, import_installation.uninstallAgent)(agentId);
+    return (0, import_registry.getAgentRegistry)().uninstallAgent(agentId, _force);
   },
   /**
    * Create an agent from an inline configuration object

package/dist/AgentFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentFactory.d.ts","sourceRoot":"","sources":["../src/AgentFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIrE,OAAO,EAIH,KAAK,cAAc,EACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,6CAA6C;IAC7C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6CAA6C;IAC7C,8BAA8B,CAAC,EAAE,MAAM,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC;CAC9E;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;IACrB;;;OAGG;yBACwB,iBAAiB;;;;;;;;;;;;;;;;;;IAyC5C;;OAEG;0BACyB,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9E;;OAEG;gCAEU,MAAM,cACH,MAAM,YACR,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC,YAC/D,cAAc,GACzB,OAAO,CAAC,MAAM,CAAC;IAIlB;;;;OAIG;4BAC2B,MAAM,WAAW,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;wBACuB,WAAW,YAAY,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;CAoB5F,CAAC"}
+{"version":3,"file":"AgentFactory.d.ts","sourceRoot":"","sources":["../src/AgentFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIrE,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,6CAA6C;IAC7C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6CAA6C;IAC7C,8BAA8B,CAAC,EAAE,MAAM,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,cAAc,CAAC,GAAG,SAAS,CAAC;CAC9E;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;IACrB;;;OAGG;yBACwB,iBAAiB;;;;;;;;;;;;;;;;;;IAyC5C;;OAEG;0BACyB,MAAM,YAAY,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9E;;OAEG;gCAEU,MAAM,cACH,MAAM,YACR,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC,YAC/D,cAAc,GACzB,OAAO,CAAC,MAAM,CAAC;IAelB;;;;OAIG;4BAC2B,MAAM,WAAW,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;wBACuB,WAAW,YAAY,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;CAoB5F,CAAC"}

package/dist/AgentFactory.js

@@ -1,12 +1,8 @@
 import { promises as fs } from "fs";
 import { getDextoGlobalPath } from "./utils/path.js";
 import { deriveDisplayName } from "./registry/types.js";
-import { loadBundledRegistryAgents } from "./registry/registry.js";
-import {
-  installBundledAgent,
-  installCustomAgent,
-  uninstallAgent
-} from "./installation.js";
+import { getAgentRegistry, loadBundledRegistryAgents } from "./registry/registry.js";
+import { installBundledAgent } from "./installation.js";
 import { createDextoAgentFromConfig } from "./agent-creation.js";
 const AgentFactory = {
   /**
@@ -53,7 +49,17 @@ const AgentFactory = {
    * Install a custom agent from local path
    */
   async installCustomAgent(agentId, sourcePath, metadata, options) {
-    return installCustomAgent(agentId, sourcePath, metadata, options);
+    if (options?.agentsDir) {
+      throw new Error(
+        "Custom agentsDir overrides are not supported by AgentFactory.installCustomAgent"
+      );
+    }
+    return getAgentRegistry().installCustomAgentFromPath(agentId, sourcePath, {
+      name: metadata.name,
+      description: metadata.description,
+      author: metadata.author || "Custom",
+      tags: metadata.tags ?? []
+    });
   },
   /**
    * Uninstall an agent
@@ -61,7 +67,7 @@ const AgentFactory = {
    * @param _force - Deprecated: force parameter is kept for backward compatibility but has no effect
    */
   async uninstallAgent(agentId, _force) {
-    return uninstallAgent(agentId);
+    return getAgentRegistry().uninstallAgent(agentId, _force);
   },
   /**
    * Create an agent from an inline configuration object

package/dist/preferences/loader.cjs

@@ -240,7 +240,7 @@ function createInitialPreferences(options) {
     llm: llmConfig,
     defaults: {
       defaultAgent: options.defaultAgent || "coding-agent",
-      defaultMode: options.defaultMode || "web"
+      defaultMode: options.defaultMode || "cli"
     },
     setup: {
       completed: options.setupCompleted ?? true,

package/dist/preferences/loader.js

@@ -200,7 +200,7 @@ function createInitialPreferences(options) {
     llm: llmConfig,
     defaults: {
       defaultAgent: options.defaultAgent || "coding-agent",
-      defaultMode: options.defaultMode || "web"
+      defaultMode: options.defaultMode || "cli"
     },
     setup: {
       completed: options.setupCompleted ?? true,

package/dist/project-registry.cjs

@@ -133,6 +133,34 @@ const PROJECT_REGISTRY_RELATIVE_PATHS = [
   import_path.default.join("agents", "registry.json"),
   import_path.default.join("agents", "agent-registry.json")
 ];
+function isBundledAgentRegistryShape(parsed) {
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    return false;
+  }
+  const candidate = parsed;
+  return typeof candidate.version === "string" && candidate.agents !== null && typeof candidate.agents === "object" && !Array.isArray(candidate.agents);
+}
+async function shouldIgnoreProjectRegistryCandidate(registryPath) {
+  if (import_path.default.basename(registryPath) !== "agent-registry.json") {
+    return false;
+  }
+  try {
+    const content = await import_fs2.promises.readFile(registryPath, "utf-8");
+    return isBundledAgentRegistryShape(JSON.parse(content));
+  } catch {
+    return false;
+  }
+}
+function shouldIgnoreProjectRegistryCandidateSync(registryPath) {
+  if (import_path.default.basename(registryPath) !== "agent-registry.json") {
+    return false;
+  }
+  try {
+    return isBundledAgentRegistryShape(JSON.parse((0, import_fs.readFileSync)(registryPath, "utf-8")));
+  } catch {
+    return false;
+  }
+}
 function getProjectRegistryPath(projectRoot) {
   return import_path.default.join(projectRoot, "agents", "registry.json");
 }
@@ -145,6 +173,9 @@ async function findProjectRegistryPath(projectRoot) {
   for (const registryPath of getProjectRegistryCandidatePaths(projectRoot)) {
     try {
       if ((await import_fs2.promises.stat(registryPath)).isFile()) {
+        if (await shouldIgnoreProjectRegistryCandidate(registryPath)) {
+          continue;
+        }
         return registryPath;
       }
     } catch (error) {
@@ -160,6 +191,9 @@ function findProjectRegistryPathSync(projectRoot) {
   for (const registryPath of getProjectRegistryCandidatePaths(projectRoot)) {
     try {
       if ((0, import_fs.existsSync)(registryPath) && (0, import_fs.statSync)(registryPath).isFile()) {
+        if (shouldIgnoreProjectRegistryCandidateSync(registryPath)) {
+          continue;
+        }
         return registryPath;
       }
     } catch (error) {

package/dist/project-registry.d.ts.map

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

package/dist/project-registry.js

@@ -83,6 +83,34 @@ const PROJECT_REGISTRY_RELATIVE_PATHS = [
   path.join("agents", "registry.json"),
   path.join("agents", "agent-registry.json")
 ];
+function isBundledAgentRegistryShape(parsed) {
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    return false;
+  }
+  const candidate = parsed;
+  return typeof candidate.version === "string" && candidate.agents !== null && typeof candidate.agents === "object" && !Array.isArray(candidate.agents);
+}
+async function shouldIgnoreProjectRegistryCandidate(registryPath) {
+  if (path.basename(registryPath) !== "agent-registry.json") {
+    return false;
+  }
+  try {
+    const content = await fs.readFile(registryPath, "utf-8");
+    return isBundledAgentRegistryShape(JSON.parse(content));
+  } catch {
+    return false;
+  }
+}
+function shouldIgnoreProjectRegistryCandidateSync(registryPath) {
+  if (path.basename(registryPath) !== "agent-registry.json") {
+    return false;
+  }
+  try {
+    return isBundledAgentRegistryShape(JSON.parse(readFileSync(registryPath, "utf-8")));
+  } catch {
+    return false;
+  }
+}
 function getProjectRegistryPath(projectRoot) {
   return path.join(projectRoot, "agents", "registry.json");
 }
@@ -95,6 +123,9 @@ async function findProjectRegistryPath(projectRoot) {
   for (const registryPath of getProjectRegistryCandidatePaths(projectRoot)) {
     try {
       if ((await fs.stat(registryPath)).isFile()) {
+        if (await shouldIgnoreProjectRegistryCandidate(registryPath)) {
+          continue;
+        }
         return registryPath;
       }
     } catch (error) {
@@ -110,6 +141,9 @@ function findProjectRegistryPathSync(projectRoot) {
   for (const registryPath of getProjectRegistryCandidatePaths(projectRoot)) {
     try {
       if (existsSync(registryPath) && statSync(registryPath).isFile()) {
+        if (shouldIgnoreProjectRegistryCandidateSync(registryPath)) {
+          continue;
+        }
         return registryPath;
       }
     } catch (error) {

package/dist/resolver.cjs

@@ -187,27 +187,33 @@ async function resolveDefaultAgentForDextoProject(autoInstall = true) {
     }
   }
   import_core.logger.debug(`No project-local coding-agent found in ${projectRoot}`);
-  if (!(0, import_loader.globalPreferencesExist)()) {
-    throw import_config.ConfigError.noProjectDefault(projectRoot);
-  }
-  const preferences = await (0, import_loader.loadGlobalPreferences)();
-  if (!preferences.setup.completed) {
-    throw import_config.ConfigError.setupIncomplete();
+  if ((0, import_loader.globalPreferencesExist)()) {
+    try {
+      const preferences = await (0, import_loader.loadGlobalPreferences)();
+      if (preferences.setup.completed && preferences.defaults.defaultAgent) {
+        const preferredAgentName = preferences.defaults.defaultAgent;
+        return await resolveAgentByName(preferredAgentName, autoInstall);
+      }
+    } catch (error) {
+      import_core.logger.debug(`Could not load global preferences for project fallback: ${error}`);
+    }
   }
-  const preferredAgentName = preferences.defaults.defaultAgent;
-  return await resolveAgentByName(preferredAgentName, autoInstall);
+  return await resolveAgentByName("coding-agent", autoInstall);
 }
 async function resolveDefaultAgentForGlobalCLI(autoInstall = true) {
   import_core.logger.debug("Resolving default agent for global CLI context");
-  if (!(0, import_loader.globalPreferencesExist)()) {
-    throw import_config.ConfigError.noGlobalPreferences();
-  }
-  const preferences = await (0, import_loader.loadGlobalPreferences)();
-  if (!preferences.setup.completed) {
-    throw import_config.ConfigError.setupIncomplete();
+  if ((0, import_loader.globalPreferencesExist)()) {
+    try {
+      const preferences = await (0, import_loader.loadGlobalPreferences)();
+      if (preferences.setup.completed && preferences.defaults.defaultAgent) {
+        const preferredAgentName = preferences.defaults.defaultAgent;
+        return await resolveAgentByName(preferredAgentName, autoInstall);
+      }
+    } catch (error) {
+      import_core.logger.debug(`Could not load global preferences for CLI fallback: ${error}`);
+    }
   }
-  const preferredAgentName = preferences.defaults.defaultAgent;
-  return await resolveAgentByName(preferredAgentName, autoInstall);
+  return await resolveAgentByName("coding-agent", autoInstall);
 }
 async function updateDefaultAgentPreference(agentName) {
   const agentsDir = (0, import_path2.getDextoGlobalPath)("agents");

package/dist/resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAwCA;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAClC,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,GAAE,OAAc,GAC5B,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAuND;;;;GAIG;AACH,wBAAsB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BnF"}
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAwCA;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAClC,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,GAAE,OAAc,GAC5B,OAAO,CAAC,MAAM,CAAC,CAuBjB;AA0ND;;;;GAIG;AACH,wBAAsB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BnF"}

package/dist/resolver.js

@@ -160,27 +160,33 @@ async function resolveDefaultAgentForDextoProject(autoInstall = true) {
     }
   }
   logger.debug(`No project-local coding-agent found in ${projectRoot}`);
-  if (!globalPreferencesExist()) {
-    throw ConfigError.noProjectDefault(projectRoot);
-  }
-  const preferences = await loadGlobalPreferences();
-  if (!preferences.setup.completed) {
-    throw ConfigError.setupIncomplete();
+  if (globalPreferencesExist()) {
+    try {
+      const preferences = await loadGlobalPreferences();
+      if (preferences.setup.completed && preferences.defaults.defaultAgent) {
+        const preferredAgentName = preferences.defaults.defaultAgent;
+        return await resolveAgentByName(preferredAgentName, autoInstall);
+      }
+    } catch (error) {
+      logger.debug(`Could not load global preferences for project fallback: ${error}`);
+    }
   }
-  const preferredAgentName = preferences.defaults.defaultAgent;
-  return await resolveAgentByName(preferredAgentName, autoInstall);
+  return await resolveAgentByName("coding-agent", autoInstall);
 }
 async function resolveDefaultAgentForGlobalCLI(autoInstall = true) {
   logger.debug("Resolving default agent for global CLI context");
-  if (!globalPreferencesExist()) {
-    throw ConfigError.noGlobalPreferences();
-  }
-  const preferences = await loadGlobalPreferences();
-  if (!preferences.setup.completed) {
-    throw ConfigError.setupIncomplete();
+  if (globalPreferencesExist()) {
+    try {
+      const preferences = await loadGlobalPreferences();
+      if (preferences.setup.completed && preferences.defaults.defaultAgent) {
+        const preferredAgentName = preferences.defaults.defaultAgent;
+        return await resolveAgentByName(preferredAgentName, autoInstall);
+      }
+    } catch (error) {
+      logger.debug(`Could not load global preferences for CLI fallback: ${error}`);
+    }
   }
-  const preferredAgentName = preferences.defaults.defaultAgent;
-  return await resolveAgentByName(preferredAgentName, autoInstall);
+  return await resolveAgentByName("coding-agent", autoInstall);
 }
 async function updateDefaultAgentPreference(agentName) {
   const agentsDir = getDextoGlobalPath("agents");

package/dist/utils/dexto-auth.cjs

@@ -28,45 +28,53 @@ var import_zod = require("zod");
 var import_core = require("@dexto/core");
 const AUTH_CONFIG_FILE = "auth.json";
 const AuthConfigSchema = import_zod.z.object({
-  token: import_zod.z.string().min(1),
+  token: import_zod.z.string().min(1).optional(),
+  refreshToken: import_zod.z.string().optional(),
   expiresAt: import_zod.z.number().optional(),
-  dextoApiKey: import_zod.z.string().optional()
+  createdAt: import_zod.z.number().optional(),
+  dextoApiKey: import_zod.z.string().optional(),
+  dextoKeyId: import_zod.z.string().optional(),
+  dextoApiKeySource: import_zod.z.enum(["provisioned", "user-supplied"]).optional()
+}).refine((data) => data.token || data.dextoApiKey, {
+  message: "Either token or dextoApiKey is required"
 });
-async function isDextoAuthenticated() {
+async function loadAuthConfig() {
   const authPath = (0, import_core.getDextoGlobalPath)("", AUTH_CONFIG_FILE);
   if (!(0, import_fs.existsSync)(authPath)) {
-    return false;
+    return null;
   }
   try {
     const content = await import_fs.promises.readFile(authPath, "utf-8");
     const config = JSON.parse(content);
     const validated = AuthConfigSchema.safeParse(config);
     if (!validated.success) {
-      return false;
+      return null;
     }
-    if (validated.data.expiresAt && validated.data.expiresAt < Date.now()) {
-      return false;
+    const auth = validated.data;
+    if (auth.expiresAt && auth.expiresAt < Date.now()) {
+      if (!auth.refreshToken && !auth.dextoApiKey) {
+        return null;
+      }
     }
-    return true;
+    return auth;
   } catch {
-    return false;
+    return null;
   }
 }
+async function isDextoAuthenticated() {
+  return await loadAuthConfig() !== null;
+}
 async function getDextoApiKeyFromAuth() {
-  if (process.env.DEXTO_API_KEY) {
-    return process.env.DEXTO_API_KEY;
-  }
-  const authPath = (0, import_core.getDextoGlobalPath)("", AUTH_CONFIG_FILE);
-  if (!(0, import_fs.existsSync)(authPath)) {
-    return null;
+  const auth = await loadAuthConfig();
+  if (auth?.dextoApiKey?.trim()) {
+    const apiKey = auth.dextoApiKey.trim();
+    process.env.DEXTO_API_KEY = apiKey;
+    return apiKey;
   }
-  try {
-    const content = await import_fs.promises.readFile(authPath, "utf-8");
-    const config = JSON.parse(content);
-    return config.dextoApiKey || null;
-  } catch {
-    return null;
+  if (process.env.DEXTO_API_KEY?.trim()) {
+    return process.env.DEXTO_API_KEY;
   }
+  return null;
 }
 async function canUseDextoProvider() {
   const authenticated = await isDextoAuthenticated();

package/dist/utils/dexto-auth.d.ts

@@ -6,7 +6,7 @@
  */
 /**
  * Check if user is authenticated with Dexto.
- * Returns true if auth.json exists with valid (non-expired) token.
+ * Returns true when auth.json contains usable Dexto auth state.
  */
 export declare function isDextoAuthenticated(): Promise<boolean>;
 /**
@@ -16,7 +16,7 @@ export declare function getDextoApiKeyFromAuth(): Promise<string | null>;
 /**
  * Check if user can use Dexto provider.
  * Requires BOTH:
- * 1. User is authenticated (valid auth token)
+ * 1. User has usable Dexto auth state (token, refresh-backed login, or stored API key)
  * 2. Has DEXTO_API_KEY (from auth config or environment)
  */
 export declare function canUseDextoProvider(): Promise<boolean>;

package/dist/utils/dexto-auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dexto-auth.d.ts","sourceRoot":"","sources":["../../src/utils/dexto-auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH;;;GAGG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC,CAyB7D;AAED;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoBrE;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC,CAQ5D"}
+{"version":3,"file":"dexto-auth.d.ts","sourceRoot":"","sources":["../../src/utils/dexto-auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4DH;;;GAGG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC,CAE7D;AAED;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAarE;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC,CAQ5D"}

package/dist/utils/dexto-auth.js

@@ -3,45 +3,53 @@ import { z } from "zod";
 import { getDextoGlobalPath } from "@dexto/core";
 const AUTH_CONFIG_FILE = "auth.json";
 const AuthConfigSchema = z.object({
-  token: z.string().min(1),
+  token: z.string().min(1).optional(),
+  refreshToken: z.string().optional(),
   expiresAt: z.number().optional(),
-  dextoApiKey: z.string().optional()
+  createdAt: z.number().optional(),
+  dextoApiKey: z.string().optional(),
+  dextoKeyId: z.string().optional(),
+  dextoApiKeySource: z.enum(["provisioned", "user-supplied"]).optional()
+}).refine((data) => data.token || data.dextoApiKey, {
+  message: "Either token or dextoApiKey is required"
 });
-async function isDextoAuthenticated() {
+async function loadAuthConfig() {
   const authPath = getDextoGlobalPath("", AUTH_CONFIG_FILE);
   if (!existsSync(authPath)) {
-    return false;
+    return null;
   }
   try {
     const content = await fs.readFile(authPath, "utf-8");
     const config = JSON.parse(content);
     const validated = AuthConfigSchema.safeParse(config);
     if (!validated.success) {
-      return false;
+      return null;
     }
-    if (validated.data.expiresAt && validated.data.expiresAt < Date.now()) {
-      return false;
+    const auth = validated.data;
+    if (auth.expiresAt && auth.expiresAt < Date.now()) {
+      if (!auth.refreshToken && !auth.dextoApiKey) {
+        return null;
+      }
     }
-    return true;
+    return auth;
   } catch {
-    return false;
+    return null;
   }
 }
+async function isDextoAuthenticated() {
+  return await loadAuthConfig() !== null;
+}
 async function getDextoApiKeyFromAuth() {
-  if (process.env.DEXTO_API_KEY) {
-    return process.env.DEXTO_API_KEY;
-  }
-  const authPath = getDextoGlobalPath("", AUTH_CONFIG_FILE);
-  if (!existsSync(authPath)) {
-    return null;
+  const auth = await loadAuthConfig();
+  if (auth?.dextoApiKey?.trim()) {
+    const apiKey = auth.dextoApiKey.trim();
+    process.env.DEXTO_API_KEY = apiKey;
+    return apiKey;
   }
-  try {
-    const content = await fs.readFile(authPath, "utf-8");
-    const config = JSON.parse(content);
-    return config.dextoApiKey || null;
-  } catch {
-    return null;
+  if (process.env.DEXTO_API_KEY?.trim()) {
+    return process.env.DEXTO_API_KEY;
   }
+  return null;
 }
 async function canUseDextoProvider() {
   const authenticated = await isDextoAuthenticated();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dexto/agent-management",
-  "version": "1.6.20",
+  "version": "1.6.22",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -17,10 +17,10 @@
   "dependencies": {
     "yaml": "^2.8.3",
     "zod": "^3.25.0",
-    "@dexto/agent-config": "1.6.20",
-    "@dexto/core": "1.6.20",
-    "@dexto/orchestration": "1.6.20",
-    "@dexto/tools-builtins": "1.6.20"
+    "@dexto/agent-config": "1.6.22",
+    "@dexto/core": "1.6.22",
+    "@dexto/orchestration": "1.6.22",
+    "@dexto/tools-builtins": "1.6.22"
   },
   "devDependencies": {
     "@types/node": "^22.13.5"