@dexto/agent-management 1.5.7 → 1.5.8

package/dist/config/config-enrichment.cjs

@@ -182,7 +182,8 @@ function enrichAgentConfig(config, configPath, options = {}) {
       enriched.prompts.push(promptEntry);
     }
   }
-  const instructionFile = (0, import_discover_prompts.discoverAgentInstructionFile)();
+  const shouldDiscoverAgentInstructions = config.agentFile?.discoverInCwd !== void 0 ? config.agentFile.discoverInCwd : true;
+  const instructionFile = shouldDiscoverAgentInstructions ? (0, import_discover_prompts.discoverAgentInstructionFile)() : null;
   if (instructionFile) {
     const fileContributor = {
       id: "discovered-instructions",

package/dist/config/config-enrichment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-enrichment.d.ts","sourceRoot":"","sources":["../../src/config/config-enrichment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAU/C,OAAO,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAE7F;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAoC9E;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,mGAAmG;IACnG,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/C,uFAAuF;IACvF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE,wBAAwB,GAAG,OAAY,GACjD,WAAW,CA4Pb"}
+{"version":3,"file":"config-enrichment.d.ts","sourceRoot":"","sources":["../../src/config/config-enrichment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAU/C,OAAO,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAE7F;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAoC9E;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,mGAAmG;IACnG,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/C,uFAAuF;IACvF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE,wBAAwB,GAAG,OAAY,GACjD,WAAW,CAgQb"}

package/dist/config/config-enrichment.js

@@ -150,7 +150,8 @@ function enrichAgentConfig(config, configPath, options = {}) {
       enriched.prompts.push(promptEntry);
     }
   }
-  const instructionFile = discoverAgentInstructionFile();
+  const shouldDiscoverAgentInstructions = config.agentFile?.discoverInCwd !== void 0 ? config.agentFile.discoverInCwd : true;
+  const instructionFile = shouldDiscoverAgentInstructions ? discoverAgentInstructionFile() : null;
   if (instructionFile) {
     const fileContributor = {
       id: "discovered-instructions",

package/dist/index.cjs

@@ -42,6 +42,7 @@ __export(index_exports, {
   addMarketplace: () => import_plugins.addMarketplace,
   addPromptToAgentConfig: () => import_config.addPromptToAgentConfig,
   addToDownloadQueue: () => import_models.addToDownloadQueue,
+  agentPreferencesExist: () => import_loader2.agentPreferencesExist,
   canUseDextoProvider: () => import_dexto_auth.canUseDextoProvider,
   copyDirectory: () => import_path.copyDirectory,
   createInitialPreferences: () => import_loader.createInitialPreferences,
@@ -62,6 +63,7 @@ __export(index_exports, {
   formatSize: () => import_models.formatSize,
   getActiveModel: () => import_models.getActiveModel,
   getActiveModelId: () => import_models.getActiveModelId,
+  getAgentPreferencesPath: () => import_loader2.getAgentPreferencesPath,
   getAgentRegistry: () => import_registry.getAgentRegistry,
   getAllInstalledModels: () => import_models.getAllInstalledModels,
   getCustomModel: () => import_custom_models.getCustomModel,
@@ -106,6 +108,7 @@ __export(index_exports, {
   listModelDirectories: () => import_models.listModelDirectories,
   listProviderKeyStatus: () => import_api_key_store.listProviderKeyStatus,
   loadAgentConfig: () => import_config.loadAgentConfig,
+  loadAgentPreferences: () => import_loader2.loadAgentPreferences,
   loadBundledRegistryAgents: () => import_registry.loadBundledRegistryAgents,
   loadClaudeCodePlugin: () => import_plugins.loadClaudeCodePlugin,
   loadCustomModels: () => import_custom_models.loadCustomModels,
@@ -123,6 +126,7 @@ __export(index_exports, {
   resolveAgentPath: () => import_resolver.resolveAgentPath,
   resolveApiKeyForProvider: () => import_api_key_resolver.resolveApiKeyForProvider,
   resolveBundledScript: () => import_path.resolveBundledScript,
+  saveAgentPreferences: () => import_loader2.saveAgentPreferences,
   saveCustomModel: () => import_custom_models.saveCustomModel,
   saveDextoInstalledPlugins: () => import_plugins.saveDextoInstalledPlugins,
   saveGlobalPreferences: () => import_loader.saveGlobalPreferences,
@@ -134,6 +138,7 @@ __export(index_exports, {
   uninstallAgent: () => import_installation.uninstallAgent,
   uninstallPlugin: () => import_plugins.uninstallPlugin,
   updateAgentConfigFile: () => import_config.updateAgentConfigFile,
+  updateAgentPreferences: () => import_loader2.updateAgentPreferences,
   updateDefaultAgentPreference: () => import_resolver.updateDefaultAgentPreference,
   updateEnvFile: () => import_env_file.updateEnvFile,
   updateGlobalPreferences: () => import_loader.updateGlobalPreferences,
@@ -152,6 +157,7 @@ var import_types = require("./registry/types.js");
 var import_errors = require("./registry/errors.js");
 var import_error_codes = require("./registry/error-codes.js");
 var import_loader = require("./preferences/loader.js");
+var import_loader2 = require("./preferences/loader.js");
 var import_errors2 = require("./preferences/errors.js");
 var import_resolver = require("./resolver.js");
 var import_writer = require("./writer.js");
@@ -197,6 +203,7 @@ var import_plugins = require("./plugins/index.js");
   addMarketplace,
   addPromptToAgentConfig,
   addToDownloadQueue,
+  agentPreferencesExist,
   canUseDextoProvider,
   copyDirectory,
   createInitialPreferences,
@@ -217,6 +224,7 @@ var import_plugins = require("./plugins/index.js");
   formatSize,
   getActiveModel,
   getActiveModelId,
+  getAgentPreferencesPath,
   getAgentRegistry,
   getAllInstalledModels,
   getCustomModel,
@@ -261,6 +269,7 @@ var import_plugins = require("./plugins/index.js");
   listModelDirectories,
   listProviderKeyStatus,
   loadAgentConfig,
+  loadAgentPreferences,
   loadBundledRegistryAgents,
   loadClaudeCodePlugin,
   loadCustomModels,
@@ -278,6 +287,7 @@ var import_plugins = require("./plugins/index.js");
   resolveAgentPath,
   resolveApiKeyForProvider,
   resolveBundledScript,
+  saveAgentPreferences,
   saveCustomModel,
   saveDextoInstalledPlugins,
   saveGlobalPreferences,
@@ -289,6 +299,7 @@ var import_plugins = require("./plugins/index.js");
   uninstallAgent,
   uninstallPlugin,
   updateAgentConfigFile,
+  updateAgentPreferences,
   updateDefaultAgentPreference,
   updateEnvFile,
   updateGlobalPreferences,

package/dist/index.d.ts

@@ -4,7 +4,8 @@ export { deriveDisplayName } from './registry/types.js';
 export { RegistryError } from './registry/errors.js';
 export { RegistryErrorCode } from './registry/error-codes.js';
 export { loadGlobalPreferences, saveGlobalPreferences, globalPreferencesExist, getGlobalPreferencesPath, createInitialPreferences, updateGlobalPreferences, type GlobalPreferencesUpdates, type CreatePreferencesOptions, } from './preferences/loader.js';
-export type { GlobalPreferences } from './preferences/schemas.js';
+export type { GlobalPreferences, AgentPreferences } from './preferences/schemas.js';
+export { loadAgentPreferences, saveAgentPreferences, updateAgentPreferences, agentPreferencesExist, getAgentPreferencesPath, } from './preferences/loader.js';
 export { PreferenceError, PreferenceErrorCode } from './preferences/errors.js';
 export { resolveAgentPath, updateDefaultAgentPreference } from './resolver.js';
 export { writeConfigFile, writeLLMPreferences, writePreferencesToAgent, type LLMOverrides, } from './writer.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -10,6 +10,13 @@ import {
   createInitialPreferences,
   updateGlobalPreferences
 } from "./preferences/loader.js";
+import {
+  loadAgentPreferences,
+  saveAgentPreferences,
+  updateAgentPreferences,
+  agentPreferencesExist,
+  getAgentPreferencesPath
+} from "./preferences/loader.js";
 import { PreferenceError, PreferenceErrorCode } from "./preferences/errors.js";
 import { resolveAgentPath, updateDefaultAgentPreference } from "./resolver.js";
 import {
@@ -171,6 +178,7 @@ export {
   addMarketplace,
   addPromptToAgentConfig,
   addToDownloadQueue,
+  agentPreferencesExist,
   canUseDextoProvider,
   copyDirectory,
   createInitialPreferences,
@@ -191,6 +199,7 @@ export {
   formatSize,
   getActiveModel,
   getActiveModelId,
+  getAgentPreferencesPath,
   getAgentRegistry,
   getAllInstalledModels,
   getCustomModel,
@@ -235,6 +244,7 @@ export {
   listModelDirectories,
   listProviderKeyStatus,
   loadAgentConfig,
+  loadAgentPreferences,
   loadBundledRegistryAgents,
   loadClaudeCodePlugin,
   loadCustomModels,
@@ -252,6 +262,7 @@ export {
   resolveAgentPath,
   resolveApiKeyForProvider,
   resolveBundledScript,
+  saveAgentPreferences,
   saveCustomModel,
   saveDextoInstalledPlugins,
   saveGlobalPreferences,
@@ -263,6 +274,7 @@ export {
   uninstallAgent,
   uninstallPlugin,
   updateAgentConfigFile,
+  updateAgentPreferences,
   updateDefaultAgentPreference,
   updateEnvFile,
   updateGlobalPreferences,

package/dist/models/custom-models.cjs

@@ -50,7 +50,7 @@ const CUSTOM_MODEL_PROVIDERS = [
   "ollama",
   "local",
   "vertex",
-  "dexto"
+  "dexto-nova"
 ];
 const CustomModelSchema = import_zod.z.object({
   name: import_zod.z.string().min(1),

package/dist/models/custom-models.d.ts

@@ -6,7 +6,7 @@
  */
 import { z } from 'zod';
 /** Providers that support custom models */
-export declare const CUSTOM_MODEL_PROVIDERS: readonly ["openai-compatible", "openrouter", "litellm", "glama", "bedrock", "ollama", "local", "vertex", "dexto"];
+export declare const CUSTOM_MODEL_PROVIDERS: readonly ["openai-compatible", "openrouter", "litellm", "glama", "bedrock", "ollama", "local", "vertex", "dexto-nova"];
 export type CustomModelProvider = (typeof CUSTOM_MODEL_PROVIDERS)[number];
 /**
  * Schema for a saved custom model configuration.
@@ -18,7 +18,7 @@ export type CustomModelProvider = (typeof CUSTOM_MODEL_PROVIDERS)[number];
  * - ollama: optional baseURL (defaults to http://localhost:11434)
  * - local: no baseURL, uses local GGUF files via node-llama-cpp
  * - vertex: no baseURL, uses Google Cloud ADC
- * - dexto: OpenRouter gateway using Dexto credits, requires auth login, uses OpenRouter model IDs
+ * - dexto-nova: OpenRouter gateway using Dexto credits, requires auth login, uses OpenRouter model IDs
  *
  * TODO: For hosted deployments, API keys should be stored in a secure
  * key management service (e.g., AWS Secrets Manager, HashiCorp Vault)
@@ -27,7 +27,7 @@ export type CustomModelProvider = (typeof CUSTOM_MODEL_PROVIDERS)[number];
  */
 export declare const CustomModelSchema: z.ZodEffects<z.ZodObject<{
     name: z.ZodString;
-    provider: z.ZodDefault<z.ZodEnum<["openai-compatible", "openrouter", "litellm", "glama", "bedrock", "ollama", "local", "vertex", "dexto"]>>;
+    provider: z.ZodDefault<z.ZodEnum<["openai-compatible", "openrouter", "litellm", "glama", "bedrock", "ollama", "local", "vertex", "dexto-nova"]>>;
     baseURL: z.ZodOptional<z.ZodString>;
     displayName: z.ZodOptional<z.ZodString>;
     maxInputTokens: z.ZodOptional<z.ZodNumber>;
@@ -37,7 +37,7 @@ export declare const CustomModelSchema: z.ZodEffects<z.ZodObject<{
     reasoningEffort: z.ZodOptional<z.ZodEnum<["none", "minimal", "low", "medium", "high", "xhigh"]>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
-    provider: "dexto" | "openai-compatible" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
+    provider: "openai-compatible" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | "dexto-nova";
     apiKey?: string | undefined;
     baseURL?: string | undefined;
     reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
@@ -47,7 +47,7 @@ export declare const CustomModelSchema: z.ZodEffects<z.ZodObject<{
     maxOutputTokens?: number | undefined;
 }, {
     name: string;
-    provider?: "dexto" | "openai-compatible" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | undefined;
+    provider?: "openai-compatible" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | "dexto-nova" | undefined;
     apiKey?: string | undefined;
     baseURL?: string | undefined;
     reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
@@ -57,7 +57,7 @@ export declare const CustomModelSchema: z.ZodEffects<z.ZodObject<{
     maxOutputTokens?: number | undefined;
 }>, {
     name: string;
-    provider: "dexto" | "openai-compatible" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
+    provider: "openai-compatible" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | "dexto-nova";
     apiKey?: string | undefined;
     baseURL?: string | undefined;
     reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;
@@ -67,7 +67,7 @@ export declare const CustomModelSchema: z.ZodEffects<z.ZodObject<{
     maxOutputTokens?: number | undefined;
 }, {
     name: string;
-    provider?: "dexto" | "openai-compatible" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | undefined;
+    provider?: "openai-compatible" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama" | "dexto-nova" | undefined;
     apiKey?: string | undefined;
     baseURL?: string | undefined;
     reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | undefined;

package/dist/models/custom-models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"custom-models.d.ts","sourceRoot":"","sources":["../../src/models/custom-models.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,2CAA2C;AAC3C,eAAO,MAAM,sBAAsB,mHAUzB,CAAC;AACX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8CxB,CAAC;AAEP,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAO7D;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAmB/D;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBvE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUtE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAG9E"}
+{"version":3,"file":"custom-models.d.ts","sourceRoot":"","sources":["../../src/models/custom-models.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,2CAA2C;AAC3C,eAAO,MAAM,sBAAsB,wHAUzB,CAAC;AACX,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8CxB,CAAC;AAEP,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAO7D;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAmB/D;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBvE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUtE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAG9E"}

package/dist/models/custom-models.js

@@ -11,7 +11,7 @@ const CUSTOM_MODEL_PROVIDERS = [
   "ollama",
   "local",
   "vertex",
-  "dexto"
+  "dexto-nova"
 ];
 const CustomModelSchema = z.object({
   name: z.string().min(1),

package/dist/plugins/discover-skills.cjs

@@ -68,8 +68,10 @@ function discoverStandaloneSkills(projectPath) {
     } catch {
     }
   };
+  scanSkillsDir(path.join(cwd, ".agents", "skills"), "project");
   scanSkillsDir(path.join(cwd, ".dexto", "skills"), "project");
   if (homeDir) {
+    scanSkillsDir(path.join(homeDir, ".agents", "skills"), "user");
     scanSkillsDir(path.join(homeDir, ".dexto", "skills"), "user");
   }
   return skills;
@@ -78,7 +80,9 @@ function getSkillSearchPaths() {
   const homeDir = process.env.HOME || process.env.USERPROFILE || "";
   const cwd = process.cwd();
   return [
+    path.join(cwd, ".agents", "skills"),
     path.join(cwd, ".dexto", "skills"),
+    homeDir ? path.join(homeDir, ".agents", "skills") : "",
     homeDir ? path.join(homeDir, ".dexto", "skills") : ""
   ].filter(Boolean);
 }

package/dist/plugins/discover-skills.d.ts

@@ -1,10 +1,11 @@
 /**
  * Standalone Skill Discovery
  *
- * Discovers standalone skills from ~/.dexto/skills/ directory.
+ * Discovers standalone skills from ~/.agents/skills/ and ~/.dexto/skills/ directories.
  * These are different from plugin skills - they're just directories containing a SKILL.md file.
  *
  * Structure:
+ * ~/.agents/skills/
  * ~/.dexto/skills/
  * └── skill-name/
  *     ├── SKILL.md          (required - the skill prompt)
@@ -29,8 +30,10 @@ export interface DiscoveredSkill {
  * Discovers standalone skills from standard locations.
  *
  * Search Locations:
- * 1. <cwd>/.dexto/skills/*    (project)
- * 2. ~/.dexto/skills/*        (user)
+ * 1. <cwd>/.agents/skills/*   (project)
+ * 2. <cwd>/.dexto/skills/*    (project)
+ * 3. ~/.agents/skills/*       (user)
+ * 4. ~/.dexto/skills/*        (user)
  *
  * @param projectPath Optional project path (defaults to cwd)
  * @returns Array of discovered skills

package/dist/plugins/discover-skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discover-skills.d.ts","sourceRoot":"","sources":["../../src/plugins/discover-skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE,CA4DhF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAQ9C"}
+{"version":3,"file":"discover-skills.d.ts","sourceRoot":"","sources":["../../src/plugins/discover-skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE,CAgEhF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAU9C"}

package/dist/plugins/discover-skills.js

@@ -34,8 +34,10 @@ function discoverStandaloneSkills(projectPath) {
     } catch {
     }
   };
+  scanSkillsDir(path.join(cwd, ".agents", "skills"), "project");
   scanSkillsDir(path.join(cwd, ".dexto", "skills"), "project");
   if (homeDir) {
+    scanSkillsDir(path.join(homeDir, ".agents", "skills"), "user");
     scanSkillsDir(path.join(homeDir, ".dexto", "skills"), "user");
   }
   return skills;
@@ -44,7 +46,9 @@ function getSkillSearchPaths() {
   const homeDir = process.env.HOME || process.env.USERPROFILE || "";
   const cwd = process.cwd();
   return [
+    path.join(cwd, ".agents", "skills"),
     path.join(cwd, ".dexto", "skills"),
+    homeDir ? path.join(homeDir, ".agents", "skills") : "",
     homeDir ? path.join(homeDir, ".dexto", "skills") : ""
   ].filter(Boolean);
 }

package/dist/preferences/errors.cjs

@@ -66,6 +66,17 @@ class PreferenceError {
     }));
     return new import_core.DextoValidationError(issues);
   }
+  static invalidAgentId(agentId) {
+    return new import_core.DextoValidationError([
+      {
+        code: import_error_codes.PreferenceErrorCode.INVALID_PREFERENCE_VALUE,
+        message: `agentId is invalid: ${agentId}`,
+        scope: "preference",
+        type: import_core.ErrorType.USER,
+        severity: "error"
+      }
+    ]);
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/preferences/errors.d.ts

@@ -14,5 +14,6 @@ export declare class PreferenceError {
         cause: string;
     }>;
     static validationFailed(zodError: ZodError): DextoValidationError;
+    static invalidAgentId(agentId: string): DextoValidationError;
 }
 //# sourceMappingURL=errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/preferences/errors.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAa,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAC;AAGpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,qBAAa,eAAe;IACxB,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM;;;IAW3C,MAAM,CAAC,aAAa,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;IAW3D,MAAM,CAAC,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;IAW5D,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ;CAW7C"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/preferences/errors.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAa,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAC;AAGpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,qBAAa,eAAe;IACxB,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM;;;IAW3C,MAAM,CAAC,aAAa,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;IAW3D,MAAM,CAAC,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;IAW5D,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ;IAY1C,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM;CAWxC"}

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