@dexto/agent-management 1.2.5

package/dist/config/error-codes.js

@@ -0,0 +1,15 @@
+var ConfigErrorCode = /* @__PURE__ */ ((ConfigErrorCode2) => {
+  ConfigErrorCode2["FILE_NOT_FOUND"] = "config_file_not_found";
+  ConfigErrorCode2["FILE_READ_ERROR"] = "config_file_read_error";
+  ConfigErrorCode2["FILE_WRITE_ERROR"] = "config_file_write_error";
+  ConfigErrorCode2["PARSE_ERROR"] = "config_parse_error";
+  ConfigErrorCode2["NO_PROJECT_DEFAULT"] = "config_no_project_default";
+  ConfigErrorCode2["NO_GLOBAL_PREFERENCES"] = "config_no_global_preferences";
+  ConfigErrorCode2["SETUP_INCOMPLETE"] = "config_setup_incomplete";
+  ConfigErrorCode2["BUNDLED_NOT_FOUND"] = "config_bundled_not_found";
+  ConfigErrorCode2["UNKNOWN_CONTEXT"] = "config_unknown_context";
+  return ConfigErrorCode2;
+})(ConfigErrorCode || {});
+export {
+  ConfigErrorCode
+};

package/dist/config/errors.cjs

@@ -0,0 +1,125 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var errors_exports = {};
+__export(errors_exports, {
+  ConfigError: () => ConfigError
+});
+module.exports = __toCommonJS(errors_exports);
+var import_core = require("@dexto/core");
+var import_error_codes = require("./error-codes.js");
+class ConfigError {
+  // File operation errors
+  static fileNotFound(configPath) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.ConfigErrorCode.FILE_NOT_FOUND,
+      import_core.ErrorScope.CONFIG,
+      import_core.ErrorType.USER,
+      `Configuration file not found: ${configPath}`,
+      { configPath },
+      "Ensure the configuration file exists at the specified path"
+    );
+  }
+  static fileReadError(configPath, cause) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.ConfigErrorCode.FILE_READ_ERROR,
+      import_core.ErrorScope.CONFIG,
+      import_core.ErrorType.SYSTEM,
+      `Failed to read configuration file: ${cause}`,
+      { configPath, cause },
+      "Check file permissions and ensure the file is not corrupted"
+    );
+  }
+  static fileWriteError(configPath, cause) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.ConfigErrorCode.FILE_WRITE_ERROR,
+      import_core.ErrorScope.CONFIG,
+      import_core.ErrorType.SYSTEM,
+      `Failed to write configuration file '${configPath}': ${cause}`,
+      { configPath, cause },
+      "Check file permissions and available disk space"
+    );
+  }
+  // Parsing errors
+  static parseError(configPath, cause) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.ConfigErrorCode.PARSE_ERROR,
+      import_core.ErrorScope.CONFIG,
+      import_core.ErrorType.USER,
+      `Failed to parse configuration file: ${cause}`,
+      { configPath, cause },
+      "Ensure the configuration file contains valid YAML syntax"
+    );
+  }
+  // Resolution errors
+  static noProjectDefault(projectPath) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.ConfigErrorCode.NO_PROJECT_DEFAULT,
+      import_core.ErrorScope.CONFIG,
+      import_core.ErrorType.USER,
+      `No project default-agent.yml found and no global preferences configured.
+Either create default-agent.yml in your project root (${projectPath}) or run \`dexto setup\` to configure preferences.`,
+      { projectPath },
+      "Run `dexto setup` or create a project-specific agent config"
+    );
+  }
+  static noGlobalPreferences() {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.ConfigErrorCode.NO_GLOBAL_PREFERENCES,
+      import_core.ErrorScope.CONFIG,
+      import_core.ErrorType.USER,
+      `No global preferences found. Run \`dexto setup\` to get started.`,
+      {},
+      "Run `dexto setup` to configure your AI preferences"
+    );
+  }
+  static setupIncomplete() {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.ConfigErrorCode.SETUP_INCOMPLETE,
+      import_core.ErrorScope.CONFIG,
+      import_core.ErrorType.USER,
+      `Global preferences setup is incomplete. Run \`dexto setup\` to complete.`,
+      {},
+      "Run `dexto setup` to complete your configuration"
+    );
+  }
+  static bundledNotFound(bundledPath) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.ConfigErrorCode.BUNDLED_NOT_FOUND,
+      import_core.ErrorScope.CONFIG,
+      import_core.ErrorType.NOT_FOUND,
+      `Bundled default agent not found: ${bundledPath}. Run npm run build first.`,
+      { path: bundledPath },
+      "Run `npm run build` to build the bundled agents"
+    );
+  }
+  static unknownContext(context) {
+    return new import_core.DextoRuntimeError(
+      import_error_codes.ConfigErrorCode.UNKNOWN_CONTEXT,
+      import_core.ErrorScope.CONFIG,
+      import_core.ErrorType.SYSTEM,
+      `Unknown execution context: ${context}`,
+      { context },
+      "This is an internal error - please report it"
+    );
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ConfigError
+});

package/dist/config/errors.d.ts

@@ -0,0 +1,34 @@
+import { DextoRuntimeError } from '@dexto/core';
+/**
+ * Config runtime error factory methods
+ * Creates properly typed errors for configuration operations
+ */
+export declare class ConfigError {
+    static fileNotFound(configPath: string): DextoRuntimeError<{
+        configPath: string;
+    }>;
+    static fileReadError(configPath: string, cause: string): DextoRuntimeError<{
+        configPath: string;
+        cause: string;
+    }>;
+    static fileWriteError(configPath: string, cause: string): DextoRuntimeError<{
+        configPath: string;
+        cause: string;
+    }>;
+    static parseError(configPath: string, cause: string): DextoRuntimeError<{
+        configPath: string;
+        cause: string;
+    }>;
+    static noProjectDefault(projectPath: string): DextoRuntimeError<{
+        projectPath: string;
+    }>;
+    static noGlobalPreferences(): DextoRuntimeError<{}>;
+    static setupIncomplete(): DextoRuntimeError<{}>;
+    static bundledNotFound(bundledPath: string): DextoRuntimeError<{
+        path: string;
+    }>;
+    static unknownContext(context: string): DextoRuntimeError<{
+        context: string;
+    }>;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/config/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/config/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAyB,MAAM,aAAa,CAAC;AAGvE;;;GAGG;AACH,qBAAa,WAAW;IAEpB,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM;;;IAWtC,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;IAWtD,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;IAYvD,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;IAYnD,MAAM,CAAC,gBAAgB,CAAC,WAAW,EAAE,MAAM;;;IAW3C,MAAM,CAAC,mBAAmB;IAW1B,MAAM,CAAC,eAAe;IAWtB,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM;;;IAW1C,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM;;;CAUxC"}

package/dist/config/errors.js

@@ -0,0 +1,101 @@
+import { DextoRuntimeError, ErrorScope, ErrorType } from "@dexto/core";
+import { ConfigErrorCode } from "./error-codes.js";
+class ConfigError {
+  // File operation errors
+  static fileNotFound(configPath) {
+    return new DextoRuntimeError(
+      ConfigErrorCode.FILE_NOT_FOUND,
+      ErrorScope.CONFIG,
+      ErrorType.USER,
+      `Configuration file not found: ${configPath}`,
+      { configPath },
+      "Ensure the configuration file exists at the specified path"
+    );
+  }
+  static fileReadError(configPath, cause) {
+    return new DextoRuntimeError(
+      ConfigErrorCode.FILE_READ_ERROR,
+      ErrorScope.CONFIG,
+      ErrorType.SYSTEM,
+      `Failed to read configuration file: ${cause}`,
+      { configPath, cause },
+      "Check file permissions and ensure the file is not corrupted"
+    );
+  }
+  static fileWriteError(configPath, cause) {
+    return new DextoRuntimeError(
+      ConfigErrorCode.FILE_WRITE_ERROR,
+      ErrorScope.CONFIG,
+      ErrorType.SYSTEM,
+      `Failed to write configuration file '${configPath}': ${cause}`,
+      { configPath, cause },
+      "Check file permissions and available disk space"
+    );
+  }
+  // Parsing errors
+  static parseError(configPath, cause) {
+    return new DextoRuntimeError(
+      ConfigErrorCode.PARSE_ERROR,
+      ErrorScope.CONFIG,
+      ErrorType.USER,
+      `Failed to parse configuration file: ${cause}`,
+      { configPath, cause },
+      "Ensure the configuration file contains valid YAML syntax"
+    );
+  }
+  // Resolution errors
+  static noProjectDefault(projectPath) {
+    return new DextoRuntimeError(
+      ConfigErrorCode.NO_PROJECT_DEFAULT,
+      ErrorScope.CONFIG,
+      ErrorType.USER,
+      `No project default-agent.yml found and no global preferences configured.
+Either create default-agent.yml in your project root (${projectPath}) or run \`dexto setup\` to configure preferences.`,
+      { projectPath },
+      "Run `dexto setup` or create a project-specific agent config"
+    );
+  }
+  static noGlobalPreferences() {
+    return new DextoRuntimeError(
+      ConfigErrorCode.NO_GLOBAL_PREFERENCES,
+      ErrorScope.CONFIG,
+      ErrorType.USER,
+      `No global preferences found. Run \`dexto setup\` to get started.`,
+      {},
+      "Run `dexto setup` to configure your AI preferences"
+    );
+  }
+  static setupIncomplete() {
+    return new DextoRuntimeError(
+      ConfigErrorCode.SETUP_INCOMPLETE,
+      ErrorScope.CONFIG,
+      ErrorType.USER,
+      `Global preferences setup is incomplete. Run \`dexto setup\` to complete.`,
+      {},
+      "Run `dexto setup` to complete your configuration"
+    );
+  }
+  static bundledNotFound(bundledPath) {
+    return new DextoRuntimeError(
+      ConfigErrorCode.BUNDLED_NOT_FOUND,
+      ErrorScope.CONFIG,
+      ErrorType.NOT_FOUND,
+      `Bundled default agent not found: ${bundledPath}. Run npm run build first.`,
+      { path: bundledPath },
+      "Run `npm run build` to build the bundled agents"
+    );
+  }
+  static unknownContext(context) {
+    return new DextoRuntimeError(
+      ConfigErrorCode.UNKNOWN_CONTEXT,
+      ErrorScope.CONFIG,
+      ErrorType.SYSTEM,
+      `Unknown execution context: ${context}`,
+      { context },
+      "This is an internal error - please report it"
+    );
+  }
+}
+export {
+  ConfigError
+};

package/dist/config/index.cjs

@@ -0,0 +1,44 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var config_exports = {};
+__export(config_exports, {
+  ConfigError: () => import_errors.ConfigError,
+  ConfigErrorCode: () => import_error_codes.ConfigErrorCode,
+  deriveAgentId: () => import_config_enrichment.deriveAgentId,
+  enrichAgentConfig: () => import_config_enrichment.enrichAgentConfig,
+  loadAgentConfig: () => import_loader.loadAgentConfig,
+  reloadAgentConfigFromFile: () => import_config_manager.reloadAgentConfigFromFile,
+  updateAgentConfigFile: () => import_config_manager.updateAgentConfigFile
+});
+module.exports = __toCommonJS(config_exports);
+var import_config_manager = require("./config-manager.js");
+var import_loader = require("./loader.js");
+var import_config_enrichment = require("./config-enrichment.js");
+var import_errors = require("./errors.js");
+var import_error_codes = require("./error-codes.js");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ConfigError,
+  ConfigErrorCode,
+  deriveAgentId,
+  enrichAgentConfig,
+  loadAgentConfig,
+  reloadAgentConfigFromFile,
+  updateAgentConfigFile
+});

package/dist/config/index.d.ts

@@ -0,0 +1,6 @@
+export { updateAgentConfigFile, reloadAgentConfigFromFile } from './config-manager.js';
+export { loadAgentConfig } from './loader.js';
+export { enrichAgentConfig, deriveAgentId } from './config-enrichment.js';
+export { ConfigError } from './errors.js';
+export { ConfigErrorCode } from './error-codes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,14 @@
+import { updateAgentConfigFile, reloadAgentConfigFromFile } from "./config-manager.js";
+import { loadAgentConfig } from "./loader.js";
+import { enrichAgentConfig, deriveAgentId } from "./config-enrichment.js";
+import { ConfigError } from "./errors.js";
+import { ConfigErrorCode } from "./error-codes.js";
+export {
+  ConfigError,
+  ConfigErrorCode,
+  deriveAgentId,
+  enrichAgentConfig,
+  loadAgentConfig,
+  reloadAgentConfigFromFile,
+  updateAgentConfigFile
+};

package/dist/config/loader.cjs

@@ -0,0 +1,118 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var loader_exports = {};
+__export(loader_exports, {
+  loadAgentConfig: () => loadAgentConfig
+});
+module.exports = __toCommonJS(loader_exports);
+var import_fs = require("fs");
+var import_path = __toESM(require("path"), 1);
+var import_yaml = require("yaml");
+var import_errors = require("./errors.js");
+function expandTemplateVars(config, agentDir) {
+  const result = JSON.parse(JSON.stringify(config));
+  function walk(obj) {
+    if (typeof obj === "string") {
+      return expandString(obj, agentDir);
+    }
+    if (Array.isArray(obj)) {
+      return obj.map(walk);
+    }
+    if (obj !== null && typeof obj === "object") {
+      const result2 = {};
+      for (const [key, value] of Object.entries(obj)) {
+        result2[key] = walk(value);
+      }
+      return result2;
+    }
+    return obj;
+  }
+  return walk(result);
+}
+function expandString(str, agentDir) {
+  const result = str.replace(/\${{\s*dexto\.agent_dir\s*}}/g, agentDir);
+  if (result !== str) {
+    validateExpandedPath(str, result, agentDir);
+  }
+  return result;
+}
+function validateExpandedPath(original, expanded, agentDir) {
+  const resolved = import_path.default.resolve(expanded);
+  const agentRoot = import_path.default.resolve(agentDir);
+  const relative = import_path.default.relative(agentRoot, resolved);
+  if (relative.startsWith("..") || import_path.default.isAbsolute(relative)) {
+    throw new Error(
+      `Security: Template expansion attempted to escape agent directory.
+Original: ${original}
+Expanded: ${expanded}
+Agent root: ${agentRoot}`
+    );
+  }
+}
+async function loadAgentConfig(configPath, logger) {
+  const absolutePath = import_path.default.resolve(configPath);
+  try {
+    await import_fs.promises.access(absolutePath);
+  } catch (_error) {
+    throw import_errors.ConfigError.fileNotFound(absolutePath);
+  }
+  let fileContent;
+  try {
+    fileContent = await import_fs.promises.readFile(absolutePath, "utf-8");
+  } catch (error) {
+    throw import_errors.ConfigError.fileReadError(
+      absolutePath,
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+  let config;
+  try {
+    config = (0, import_yaml.parse)(fileContent);
+  } catch (error) {
+    throw import_errors.ConfigError.parseError(
+      absolutePath,
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+  try {
+    const agentDir = import_path.default.dirname(absolutePath);
+    config = expandTemplateVars(config, agentDir);
+    logger?.debug(`Expanded template variables for agent in: ${agentDir}`);
+  } catch (error) {
+    throw import_errors.ConfigError.parseError(
+      absolutePath,
+      `Template expansion failed: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+  return config;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  loadAgentConfig
+});

package/dist/config/loader.d.ts

@@ -0,0 +1,18 @@
+import type { AgentConfig } from '@dexto/core';
+import type { IDextoLogger } from '@dexto/core';
+/**
+ * Asynchronously loads and processes an agent configuration file.
+ * This function handles file reading, YAML parsing, and template variable expansion.
+ * Environment variable expansion is handled by the Zod schema during validation.
+ *
+ * Note: Path resolution should be done before calling this function using resolveConfigPath().
+ *
+ * @param configPath - Path to the configuration file (absolute or relative)
+ * @param logger - logger instance for logging
+ * @returns A Promise that resolves to the parsed `AgentConfig` object with template variables expanded
+ * @throws {ConfigError} with FILE_NOT_FOUND if the configuration file does not exist
+ * @throws {ConfigError} with FILE_READ_ERROR if file read fails (e.g., permissions issues)
+ * @throws {ConfigError} with PARSE_ERROR if the content is not valid YAML or template expansion fails
+ */
+export declare function loadAgentConfig(configPath: string, logger?: IDextoLogger): Promise<AgentConfig>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAgEhD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CACjC,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,WAAW,CAAC,CAuDtB"}

package/dist/config/loader.js

@@ -0,0 +1,84 @@
+import { promises as fs } from "fs";
+import path from "path";
+import { parse as parseYaml } from "yaml";
+import { ConfigError } from "./errors.js";
+function expandTemplateVars(config, agentDir) {
+  const result = JSON.parse(JSON.stringify(config));
+  function walk(obj) {
+    if (typeof obj === "string") {
+      return expandString(obj, agentDir);
+    }
+    if (Array.isArray(obj)) {
+      return obj.map(walk);
+    }
+    if (obj !== null && typeof obj === "object") {
+      const result2 = {};
+      for (const [key, value] of Object.entries(obj)) {
+        result2[key] = walk(value);
+      }
+      return result2;
+    }
+    return obj;
+  }
+  return walk(result);
+}
+function expandString(str, agentDir) {
+  const result = str.replace(/\${{\s*dexto\.agent_dir\s*}}/g, agentDir);
+  if (result !== str) {
+    validateExpandedPath(str, result, agentDir);
+  }
+  return result;
+}
+function validateExpandedPath(original, expanded, agentDir) {
+  const resolved = path.resolve(expanded);
+  const agentRoot = path.resolve(agentDir);
+  const relative = path.relative(agentRoot, resolved);
+  if (relative.startsWith("..") || path.isAbsolute(relative)) {
+    throw new Error(
+      `Security: Template expansion attempted to escape agent directory.
+Original: ${original}
+Expanded: ${expanded}
+Agent root: ${agentRoot}`
+    );
+  }
+}
+async function loadAgentConfig(configPath, logger) {
+  const absolutePath = path.resolve(configPath);
+  try {
+    await fs.access(absolutePath);
+  } catch (_error) {
+    throw ConfigError.fileNotFound(absolutePath);
+  }
+  let fileContent;
+  try {
+    fileContent = await fs.readFile(absolutePath, "utf-8");
+  } catch (error) {
+    throw ConfigError.fileReadError(
+      absolutePath,
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+  let config;
+  try {
+    config = parseYaml(fileContent);
+  } catch (error) {
+    throw ConfigError.parseError(
+      absolutePath,
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+  try {
+    const agentDir = path.dirname(absolutePath);
+    config = expandTemplateVars(config, agentDir);
+    logger?.debug(`Expanded template variables for agent in: ${agentDir}`);
+  } catch (error) {
+    throw ConfigError.parseError(
+      absolutePath,
+      `Template expansion failed: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+  return config;
+}
+export {
+  loadAgentConfig
+};