@dexto/agent-management 1.5.6 → 1.5.8

package/dist/preferences/errors.js

@@ -42,6 +42,17 @@ class PreferenceError {
     }));
     return new DextoValidationError(issues);
   }
+  static invalidAgentId(agentId) {
+    return new DextoValidationError([
+      {
+        code: PreferenceErrorCode.INVALID_PREFERENCE_VALUE,
+        message: `agentId is invalid: ${agentId}`,
+        scope: "preference",
+        type: ErrorType.USER,
+        severity: "error"
+      }
+    ]);
+  }
 }
 export {
   PreferenceError,

package/dist/preferences/loader.cjs

@@ -1,7 +1,9 @@
 "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)
@@ -15,28 +17,42 @@ var __copyProps = (to, from, except, desc) => {
   }
   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, {
+  agentPreferencesExist: () => agentPreferencesExist,
   createInitialPreferences: () => createInitialPreferences,
+  getAgentPreferencesPath: () => getAgentPreferencesPath,
   getGlobalPreferencesPath: () => getGlobalPreferencesPath,
   globalPreferencesExist: () => globalPreferencesExist,
+  loadAgentPreferences: () => loadAgentPreferences,
   loadGlobalPreferences: () => loadGlobalPreferences,
+  saveAgentPreferences: () => saveAgentPreferences,
   saveGlobalPreferences: () => saveGlobalPreferences,
+  updateAgentPreferences: () => updateAgentPreferences,
   updateGlobalPreferences: () => updateGlobalPreferences
 });
 module.exports = __toCommonJS(loader_exports);
 var import_fs = require("fs");
 var import_fs2 = require("fs");
 var import_yaml = require("yaml");
-var import_path = require("../utils/path.js");
+var import_path = __toESM(require("path"), 1);
+var import_path2 = require("../utils/path.js");
 var import_core = require("@dexto/core");
 var import_core2 = require("@dexto/core");
 var import_schemas = require("./schemas.js");
 var import_constants = require("./constants.js");
 var import_errors = require("./errors.js");
 async function loadGlobalPreferences() {
-  const preferencesPath = (0, import_path.getDextoGlobalPath)(import_constants.PREFERENCES_FILE);
+  const preferencesPath = (0, import_path2.getDextoGlobalPath)(import_constants.PREFERENCES_FILE);
   if (!(0, import_fs.existsSync)(preferencesPath)) {
     throw import_errors.PreferenceError.fileNotFound(preferencesPath);
   }
@@ -70,15 +86,107 @@ const PREFERENCES_FILE_HEADER = `# Dexto Global Preferences
 #   Set sounds.enabled: false to disable all sounds.
 
 `;
+const AGENT_PREFERENCES_FILE_HEADER = `# Dexto Agent Preferences
+# Stored per-agent to customize runtime behavior without changing base config.
+# Tool control:
+#   tools.disabled: list of tool names to exclude from LLM context.
+
+`;
+function getAgentPreferencesPath(agentId) {
+  if (!agentId || typeof agentId !== "string") {
+    throw import_errors.PreferenceError.invalidAgentId(String(agentId));
+  }
+  const trimmedId = agentId.trim();
+  if (!trimmedId) {
+    throw import_errors.PreferenceError.invalidAgentId(agentId);
+  }
+  const hasSeparators = trimmedId.includes("/") || trimmedId.includes("\\");
+  if (hasSeparators || trimmedId !== import_path.default.basename(trimmedId)) {
+    throw import_errors.PreferenceError.invalidAgentId(agentId);
+  }
+  const allowedPattern = /^[a-zA-Z0-9_-]+$/;
+  if (!allowedPattern.test(trimmedId)) {
+    throw import_errors.PreferenceError.invalidAgentId(agentId);
+  }
+  const filename = `${trimmedId}.preferences.yml`;
+  return (0, import_path2.getDextoGlobalPath)(import_path.default.join("agents", filename));
+}
+async function loadAgentPreferences(agentId) {
+  const preferencesPath = getAgentPreferencesPath(agentId);
+  if (!(0, import_fs.existsSync)(preferencesPath)) {
+    throw import_errors.PreferenceError.fileNotFound(preferencesPath);
+  }
+  try {
+    const fileContent = await import_fs2.promises.readFile(preferencesPath, "utf-8");
+    const rawPreferences = (0, import_yaml.parse)(fileContent);
+    const validation = import_schemas.AgentPreferencesSchema.safeParse(rawPreferences);
+    if (!validation.success) {
+      throw import_errors.PreferenceError.validationFailed(validation.error);
+    }
+    import_core.logger.debug(`Loaded agent preferences from: ${preferencesPath}`);
+    return validation.data;
+  } catch (error) {
+    if (error instanceof import_core2.DextoValidationError || error instanceof import_core2.DextoRuntimeError) {
+      throw error;
+    }
+    throw import_errors.PreferenceError.fileReadError(
+      preferencesPath,
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+}
+async function saveAgentPreferences(agentId, preferences) {
+  const preferencesPath = getAgentPreferencesPath(agentId);
+  const validation = import_schemas.AgentPreferencesSchema.safeParse(preferences);
+  if (!validation.success) {
+    throw import_errors.PreferenceError.validationFailed(validation.error);
+  }
+  try {
+    import_core.logger.debug(`Saving agent preferences to: ${preferencesPath}`);
+    await import_fs2.promises.mkdir(import_path.default.dirname(preferencesPath), { recursive: true });
+    const yamlContent = (0, import_yaml.stringify)(preferences, {
+      indent: 2,
+      lineWidth: 100,
+      minContentWidth: 20
+    });
+    await import_fs2.promises.writeFile(preferencesPath, AGENT_PREFERENCES_FILE_HEADER + yamlContent, "utf-8");
+    import_core.logger.debug(
+      `\u2713 Saved agent preferences ${JSON.stringify(preferences)} to: ${preferencesPath}`
+    );
+  } catch (error) {
+    throw import_errors.PreferenceError.fileWriteError(
+      preferencesPath,
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+}
+function agentPreferencesExist(agentId) {
+  const preferencesPath = getAgentPreferencesPath(agentId);
+  return (0, import_fs.existsSync)(preferencesPath);
+}
+async function updateAgentPreferences(agentId, updates) {
+  const existing = await loadAgentPreferences(agentId);
+  const merged = {
+    ...existing,
+    ...updates,
+    tools: updates.tools ? { ...existing.tools, ...updates.tools } : existing.tools
+  };
+  const validation = import_schemas.AgentPreferencesSchema.safeParse(merged);
+  if (!validation.success) {
+    throw import_errors.PreferenceError.validationFailed(validation.error);
+  }
+  await saveAgentPreferences(agentId, validation.data);
+  return validation.data;
+}
 async function saveGlobalPreferences(preferences) {
-  const preferencesPath = (0, import_path.getDextoGlobalPath)(import_constants.PREFERENCES_FILE);
+  const preferencesPath = (0, import_path2.getDextoGlobalPath)(import_constants.PREFERENCES_FILE);
   const validation = import_schemas.GlobalPreferencesSchema.safeParse(preferences);
   if (!validation.success) {
     throw import_errors.PreferenceError.validationFailed(validation.error);
   }
   try {
     import_core.logger.debug(`Saving global preferences to: ${preferencesPath}`);
-    const dextoDir = (0, import_path.getDextoGlobalPath)("");
+    const dextoDir = (0, import_path2.getDextoGlobalPath)("");
     await import_fs2.promises.mkdir(dextoDir, { recursive: true });
     const yamlContent = (0, import_yaml.stringify)(preferences, {
       indent: 2,
@@ -97,11 +205,11 @@ async function saveGlobalPreferences(preferences) {
   }
 }
 function globalPreferencesExist() {
-  const preferencesPath = (0, import_path.getDextoGlobalPath)(import_constants.PREFERENCES_FILE);
+  const preferencesPath = (0, import_path2.getDextoGlobalPath)(import_constants.PREFERENCES_FILE);
   return (0, import_fs.existsSync)(preferencesPath);
 }
 function getGlobalPreferencesPath() {
-  return (0, import_path.getDextoGlobalPath)(import_constants.PREFERENCES_FILE);
+  return (0, import_path2.getDextoGlobalPath)(import_constants.PREFERENCES_FILE);
 }
 function createInitialPreferences(options) {
   const llmConfig = {
@@ -156,10 +264,15 @@ async function updateGlobalPreferences(updates) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  agentPreferencesExist,
   createInitialPreferences,
+  getAgentPreferencesPath,
   getGlobalPreferencesPath,
   globalPreferencesExist,
+  loadAgentPreferences,
   loadGlobalPreferences,
+  saveAgentPreferences,
   saveGlobalPreferences,
+  updateAgentPreferences,
   updateGlobalPreferences
 });

package/dist/preferences/loader.d.ts

@@ -1,5 +1,5 @@
 import type { LLMProvider } from '@dexto/core';
-import { type GlobalPreferences } from './schemas.js';
+import { type AgentPreferences, type GlobalPreferences } from './schemas.js';
 /**
  * Load global preferences from ~/.dexto/preferences.yml
  * @returns Global preferences object
@@ -7,6 +7,26 @@ import { type GlobalPreferences } from './schemas.js';
  * @throws DextoValidationError if preferences are invalid
  */
 export declare function loadGlobalPreferences(): Promise<GlobalPreferences>;
+/**
+ * Resolve the agent preferences file path for an agent ID.
+ */
+export declare function getAgentPreferencesPath(agentId: string): string;
+/**
+ * Load agent preferences from ~/.dexto/agents/<agentId>.preferences.yml
+ */
+export declare function loadAgentPreferences(agentId: string): Promise<AgentPreferences>;
+/**
+ * Save agent preferences to ~/.dexto/agents/<agentId>.preferences.yml
+ */
+export declare function saveAgentPreferences(agentId: string, preferences: AgentPreferences): Promise<void>;
+/**
+ * Check if agent preferences exist (for first-time detection)
+ */
+export declare function agentPreferencesExist(agentId: string): boolean;
+/**
+ * Update agent preferences with partial updates
+ */
+export declare function updateAgentPreferences(agentId: string, updates: Partial<AgentPreferences>): Promise<AgentPreferences>;
 /**
  * Save global preferences to ~/.dexto/preferences.yml
  * @param preferences Validated preferences object

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

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/preferences/loader.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAI/E;;;;;GAKG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CA+BxE;AAiBD;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCzF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,yEAAyE;IACzE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yEAAyE;IACzE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qCAAqC;IACrC,MAAM,CAAC,EAAE;QACL,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;KAC5B,CAAC;CACL;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAsC7F;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACnC,GAAG,CAAC,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;CACjD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CACzC,OAAO,EAAE,wBAAwB,GAClC,OAAO,CAAC,iBAAiB,CAAC,CA4B5B"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/preferences/loader.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAGH,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACzB,MAAM,cAAc,CAAC;AAItB;;;;;GAKG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CA+BxE;AA2BD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsB/D;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4BrF;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACtC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,gBAAgB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG9D;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CACxC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACnC,OAAO,CAAC,gBAAgB,CAAC,CAgB3B;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCzF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,yEAAyE;IACzE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yEAAyE;IACzE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qCAAqC;IACrC,MAAM,CAAC,EAAE;QACL,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;KAC5B,CAAC;CACL;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAsC7F;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACnC,GAAG,CAAC,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;CACjD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CACzC,OAAO,EAAE,wBAAwB,GAClC,OAAO,CAAC,iBAAiB,CAAC,CA4B5B"}

package/dist/preferences/loader.js

@@ -1,10 +1,14 @@
 import { existsSync } from "fs";
 import { promises as fs } from "fs";
 import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import path from "path";
 import { getDextoGlobalPath } from "../utils/path.js";
 import { logger } from "@dexto/core";
 import { DextoValidationError, DextoRuntimeError } from "@dexto/core";
-import { GlobalPreferencesSchema } from "./schemas.js";
+import {
+  AgentPreferencesSchema,
+  GlobalPreferencesSchema
+} from "./schemas.js";
 import { PREFERENCES_FILE } from "./constants.js";
 import { PreferenceError } from "./errors.js";
 async function loadGlobalPreferences() {
@@ -42,6 +46,98 @@ const PREFERENCES_FILE_HEADER = `# Dexto Global Preferences
 #   Set sounds.enabled: false to disable all sounds.
 
 `;
+const AGENT_PREFERENCES_FILE_HEADER = `# Dexto Agent Preferences
+# Stored per-agent to customize runtime behavior without changing base config.
+# Tool control:
+#   tools.disabled: list of tool names to exclude from LLM context.
+
+`;
+function getAgentPreferencesPath(agentId) {
+  if (!agentId || typeof agentId !== "string") {
+    throw PreferenceError.invalidAgentId(String(agentId));
+  }
+  const trimmedId = agentId.trim();
+  if (!trimmedId) {
+    throw PreferenceError.invalidAgentId(agentId);
+  }
+  const hasSeparators = trimmedId.includes("/") || trimmedId.includes("\\");
+  if (hasSeparators || trimmedId !== path.basename(trimmedId)) {
+    throw PreferenceError.invalidAgentId(agentId);
+  }
+  const allowedPattern = /^[a-zA-Z0-9_-]+$/;
+  if (!allowedPattern.test(trimmedId)) {
+    throw PreferenceError.invalidAgentId(agentId);
+  }
+  const filename = `${trimmedId}.preferences.yml`;
+  return getDextoGlobalPath(path.join("agents", filename));
+}
+async function loadAgentPreferences(agentId) {
+  const preferencesPath = getAgentPreferencesPath(agentId);
+  if (!existsSync(preferencesPath)) {
+    throw PreferenceError.fileNotFound(preferencesPath);
+  }
+  try {
+    const fileContent = await fs.readFile(preferencesPath, "utf-8");
+    const rawPreferences = parseYaml(fileContent);
+    const validation = AgentPreferencesSchema.safeParse(rawPreferences);
+    if (!validation.success) {
+      throw PreferenceError.validationFailed(validation.error);
+    }
+    logger.debug(`Loaded agent preferences from: ${preferencesPath}`);
+    return validation.data;
+  } catch (error) {
+    if (error instanceof DextoValidationError || error instanceof DextoRuntimeError) {
+      throw error;
+    }
+    throw PreferenceError.fileReadError(
+      preferencesPath,
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+}
+async function saveAgentPreferences(agentId, preferences) {
+  const preferencesPath = getAgentPreferencesPath(agentId);
+  const validation = AgentPreferencesSchema.safeParse(preferences);
+  if (!validation.success) {
+    throw PreferenceError.validationFailed(validation.error);
+  }
+  try {
+    logger.debug(`Saving agent preferences to: ${preferencesPath}`);
+    await fs.mkdir(path.dirname(preferencesPath), { recursive: true });
+    const yamlContent = stringifyYaml(preferences, {
+      indent: 2,
+      lineWidth: 100,
+      minContentWidth: 20
+    });
+    await fs.writeFile(preferencesPath, AGENT_PREFERENCES_FILE_HEADER + yamlContent, "utf-8");
+    logger.debug(
+      `\u2713 Saved agent preferences ${JSON.stringify(preferences)} to: ${preferencesPath}`
+    );
+  } catch (error) {
+    throw PreferenceError.fileWriteError(
+      preferencesPath,
+      error instanceof Error ? error.message : String(error)
+    );
+  }
+}
+function agentPreferencesExist(agentId) {
+  const preferencesPath = getAgentPreferencesPath(agentId);
+  return existsSync(preferencesPath);
+}
+async function updateAgentPreferences(agentId, updates) {
+  const existing = await loadAgentPreferences(agentId);
+  const merged = {
+    ...existing,
+    ...updates,
+    tools: updates.tools ? { ...existing.tools, ...updates.tools } : existing.tools
+  };
+  const validation = AgentPreferencesSchema.safeParse(merged);
+  if (!validation.success) {
+    throw PreferenceError.validationFailed(validation.error);
+  }
+  await saveAgentPreferences(agentId, validation.data);
+  return validation.data;
+}
 async function saveGlobalPreferences(preferences) {
   const preferencesPath = getDextoGlobalPath(PREFERENCES_FILE);
   const validation = GlobalPreferencesSchema.safeParse(preferences);
@@ -127,10 +223,15 @@ async function updateGlobalPreferences(updates) {
   return validation.data;
 }
 export {
+  agentPreferencesExist,
   createInitialPreferences,
+  getAgentPreferencesPath,
   getGlobalPreferencesPath,
   globalPreferencesExist,
+  loadAgentPreferences,
   loadGlobalPreferences,
+  saveAgentPreferences,
   saveGlobalPreferences,
+  updateAgentPreferences,
   updateGlobalPreferences
 };

package/dist/preferences/schemas.cjs

@@ -18,6 +18,8 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var schemas_exports = {};
 __export(schemas_exports, {
+  AgentPreferencesSchema: () => AgentPreferencesSchema,
+  AgentToolPreferencesSchema: () => AgentToolPreferencesSchema,
   GlobalPreferencesSchema: () => GlobalPreferencesSchema,
   PreferenceDefaultsSchema: () => PreferenceDefaultsSchema,
   PreferenceLLMSchema: () => PreferenceLLMSchema,
@@ -88,6 +90,14 @@ const PreferenceSoundsSchema = import_zod.z.object({
   ),
   onTaskComplete: import_zod.z.boolean().default(true).describe("Play sound when agent task completes (default: true when sounds enabled)")
 }).strict();
+const AgentToolPreferencesSchema = import_zod.z.object({
+  disabled: import_zod.z.array(import_core3.NonEmptyTrimmed).default([]).describe("Tool names disabled for this agent (default: none)")
+}).strict();
+const AgentPreferencesSchema = import_zod.z.object({
+  tools: AgentToolPreferencesSchema.default({ disabled: [] }).describe(
+    "Tool availability preferences"
+  )
+}).strict();
 const GlobalPreferencesSchema = import_zod.z.object({
   llm: PreferenceLLMSchema.describe("LLM configuration preferences"),
   defaults: PreferenceDefaultsSchema.describe("Default behavior preferences (required)"),
@@ -100,6 +110,8 @@ const GlobalPreferencesSchema = import_zod.z.object({
 }).strict();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AgentPreferencesSchema,
+  AgentToolPreferencesSchema,
   GlobalPreferencesSchema,
   PreferenceDefaultsSchema,
   PreferenceLLMSchema,

package/dist/preferences/schemas.d.ts

@@ -1,30 +1,30 @@
 import { z } from 'zod';
 export declare const PreferenceLLMSchema: z.ZodEffects<z.ZodObject<{
-    provider: z.ZodEnum<["openai", "openai-compatible", "anthropic", "google", "groq", "xai", "cohere", "openrouter", "litellm", "glama", "vertex", "bedrock", "local", "ollama"]>;
+    provider: z.ZodEnum<["openai", "openai-compatible", "anthropic", "google", "groq", "xai", "cohere", "minimax", "glm", "openrouter", "litellm", "glama", "vertex", "bedrock", "local", "ollama", "dexto-nova"]>;
     model: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
     apiKey: z.ZodOptional<z.ZodString>;
     baseURL: z.ZodOptional<z.ZodString>;
     reasoningEffort: z.ZodOptional<z.ZodEnum<["none", "minimal", "low", "medium", "high", "xhigh"]>>;
 }, "strict", z.ZodTypeAny, {
-    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
+    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "minimax" | "glm" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | "dexto-nova";
     model: string;
     apiKey?: string | undefined;
     baseURL?: string | undefined;
     reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
 }, {
-    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
+    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "minimax" | "glm" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | "dexto-nova";
     model: string;
     apiKey?: string | undefined;
     baseURL?: string | undefined;
     reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
 }>, {
-    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
+    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "minimax" | "glm" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | "dexto-nova";
     model: string;
     apiKey?: string | undefined;
     baseURL?: string | undefined;
     reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
 }, {
-    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
+    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "minimax" | "glm" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | "dexto-nova";
     model: string;
     apiKey?: string | undefined;
     baseURL?: string | undefined;
@@ -66,33 +66,57 @@ export declare const PreferenceSoundsSchema: z.ZodObject<{
     onApprovalRequired?: boolean | undefined;
     onTaskComplete?: boolean | undefined;
 }>;
+export declare const AgentToolPreferencesSchema: z.ZodObject<{
+    disabled: z.ZodDefault<z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    disabled: string[];
+}, {
+    disabled?: string[] | undefined;
+}>;
+export declare const AgentPreferencesSchema: z.ZodObject<{
+    tools: z.ZodDefault<z.ZodObject<{
+        disabled: z.ZodDefault<z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        disabled: string[];
+    }, {
+        disabled?: string[] | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    tools: {
+        disabled: string[];
+    };
+}, {
+    tools?: {
+        disabled?: string[] | undefined;
+    } | undefined;
+}>;
 export declare const GlobalPreferencesSchema: z.ZodObject<{
     llm: z.ZodEffects<z.ZodObject<{
-        provider: z.ZodEnum<["openai", "openai-compatible", "anthropic", "google", "groq", "xai", "cohere", "openrouter", "litellm", "glama", "vertex", "bedrock", "local", "ollama"]>;
+        provider: z.ZodEnum<["openai", "openai-compatible", "anthropic", "google", "groq", "xai", "cohere", "minimax", "glm", "openrouter", "litellm", "glama", "vertex", "bedrock", "local", "ollama", "dexto-nova"]>;
         model: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
         apiKey: z.ZodOptional<z.ZodString>;
         baseURL: z.ZodOptional<z.ZodString>;
         reasoningEffort: z.ZodOptional<z.ZodEnum<["none", "minimal", "low", "medium", "high", "xhigh"]>>;
     }, "strict", z.ZodTypeAny, {
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "minimax" | "glm" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | "dexto-nova";
         model: string;
         apiKey?: string | undefined;
         baseURL?: string | undefined;
         reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
     }, {
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "minimax" | "glm" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | "dexto-nova";
         model: string;
         apiKey?: string | undefined;
         baseURL?: string | undefined;
         reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
     }>, {
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "minimax" | "glm" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | "dexto-nova";
         model: string;
         apiKey?: string | undefined;
         baseURL?: string | undefined;
         reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
     }, {
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "minimax" | "glm" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | "dexto-nova";
         model: string;
         apiKey?: string | undefined;
         baseURL?: string | undefined;
@@ -136,7 +160,7 @@ export declare const GlobalPreferencesSchema: z.ZodObject<{
     }>>;
 }, "strict", z.ZodTypeAny, {
     llm: {
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "minimax" | "glm" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | "dexto-nova";
         model: string;
         apiKey?: string | undefined;
         baseURL?: string | undefined;
@@ -158,7 +182,7 @@ export declare const GlobalPreferencesSchema: z.ZodObject<{
     };
 }, {
     llm: {
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "minimax" | "glm" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | "dexto-nova";
         model: string;
         apiKey?: string | undefined;
         baseURL?: string | undefined;
@@ -183,5 +207,7 @@ export type PreferenceLLM = z.output<typeof PreferenceLLMSchema>;
 export type PreferenceDefaults = z.output<typeof PreferenceDefaultsSchema>;
 export type PreferenceSetup = z.output<typeof PreferenceSetupSchema>;
 export type PreferenceSounds = z.output<typeof PreferenceSoundsSchema>;
+export type AgentToolPreferences = z.output<typeof AgentToolPreferencesSchema>;
+export type AgentPreferences = z.output<typeof AgentPreferencesSchema>;
 export type GlobalPreferences = z.output<typeof GlobalPreferencesSchema>;
 //# sourceMappingURL=schemas.d.ts.map

package/dist/preferences/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/preferences/schemas.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsE1B,CAAC;AAEP,eAAO,MAAM,wBAAwB;;;;;;;;;EAYxB,CAAC;AAEd,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAYrB,CAAC;AAEd,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EActB,CAAC;AAEd,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcvB,CAAC;AAGd,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACjE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC3E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACrE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACvE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/preferences/schemas.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsE1B,CAAC;AAEP,eAAO,MAAM,wBAAwB;;;;;;;;;EAYxB,CAAC;AAEd,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAYrB,CAAC;AAEd,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EActB,CAAC;AAEd,eAAO,MAAM,0BAA0B;;;;;;EAO1B,CAAC;AAEd,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;EAMtB,CAAC;AAEd,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcvB,CAAC;AAGd,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACjE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC3E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACrE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACvE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC/E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACvE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/preferences/schemas.js

@@ -67,6 +67,14 @@ const PreferenceSoundsSchema = z.object({
   ),
   onTaskComplete: z.boolean().default(true).describe("Play sound when agent task completes (default: true when sounds enabled)")
 }).strict();
+const AgentToolPreferencesSchema = z.object({
+  disabled: z.array(NonEmptyTrimmed).default([]).describe("Tool names disabled for this agent (default: none)")
+}).strict();
+const AgentPreferencesSchema = z.object({
+  tools: AgentToolPreferencesSchema.default({ disabled: [] }).describe(
+    "Tool availability preferences"
+  )
+}).strict();
 const GlobalPreferencesSchema = z.object({
   llm: PreferenceLLMSchema.describe("LLM configuration preferences"),
   defaults: PreferenceDefaultsSchema.describe("Default behavior preferences (required)"),
@@ -78,6 +86,8 @@ const GlobalPreferencesSchema = z.object({
   )
 }).strict();
 export {
+  AgentPreferencesSchema,
+  AgentToolPreferencesSchema,
   GlobalPreferencesSchema,
   PreferenceDefaultsSchema,
   PreferenceLLMSchema,

package/dist/runtime/AgentRuntime.cjs

@@ -59,8 +59,7 @@ class AgentRuntime {
         config.agentConfig,
         void 0,
         // No config path
-        false
-        // Not interactive CLI
+        { isInteractiveCli: false, skipPluginDiscovery: true }
       );
       enrichedConfig.agentId = agentId;
       const agent = new import_core.DextoAgent(enrichedConfig);

package/dist/runtime/AgentRuntime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentRuntime.d.ts","sourceRoot":"","sources":["../../src/runtime/AgentRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAc,KAAK,YAAY,EAAyB,MAAM,aAAa,CAAC;AAInF,OAAO,KAAK,EACR,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAA4B,KAAK,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,4BAA4B;IAC5B,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,sBAAsB;IACtB,MAAM,EAAE,YAAY,CAAC;CACxB;AAED,qBAAa,YAAY;IACrB,OAAO,CAAC,IAAI,CAAY;IACxB,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,MAAM,CAAe;gBAEjB,OAAO,EAAE,mBAAmB;IAYxC;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IA0E3D;;;;;;;OAOG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAoEvF;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIlD;;OAEG;IACH,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE;IAI/C;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsC/C;;OAEG;IACG,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IASlD;;OAEG;IACH,SAAS,IAAI,2BAA2B;IAIxC;;OAEG;IACH,QAAQ,IAAI;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE;CAaxE"}
+{"version":3,"file":"AgentRuntime.d.ts","sourceRoot":"","sources":["../../src/runtime/AgentRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAc,KAAK,YAAY,EAAyB,MAAM,aAAa,CAAC;AAInF,OAAO,KAAK,EACR,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAA4B,KAAK,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,4BAA4B;IAC5B,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,sBAAsB;IACtB,MAAM,EAAE,YAAY,CAAC;CACxB;AAED,qBAAa,YAAY;IACrB,OAAO,CAAC,IAAI,CAAY;IACxB,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,MAAM,CAAe;gBAEjB,OAAO,EAAE,mBAAmB;IAYxC;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IA2E3D;;;;;;;OAOG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAoEvF;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIlD;;OAEG;IACH,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE;IAI/C;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsC/C;;OAEG;IACG,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IASlD;;OAEG;IACH,SAAS,IAAI,2BAA2B;IAIxC;;OAEG;IACH,QAAQ,IAAI;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE;CAaxE"}

package/dist/runtime/AgentRuntime.js

@@ -36,8 +36,7 @@ class AgentRuntime {
         config.agentConfig,
         void 0,
         // No config path
-        false
-        // Not interactive CLI
+        { isInteractiveCli: false, skipPluginDiscovery: true }
       );
       enrichedConfig.agentId = agentId;
       const agent = new DextoAgent(enrichedConfig);