@dexto/agent-management 1.6.0 → 1.6.2

package/dist/agent-creation.cjs

@@ -81,11 +81,12 @@ async function createDextoAgentFromConfig(options) {
   }
   const validatedConfig = import_agent_config.AgentConfigSchema.parse(enrichedConfig);
   const services = await (0, import_agent_config.resolveServicesFromConfig)(validatedConfig, image);
+  const mergedOverrides = overrides ? { ...overrides } : void 0;
   return new import_core.DextoAgent(
     (0, import_agent_config.toDextoAgentOptions)({
       config: validatedConfig,
       services,
-      overrides
+      overrides: mergedOverrides
     })
   );
 }

package/dist/agent-creation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-creation.d.ts","sourceRoot":"","sources":["../src/agent-creation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,qBAAqB,CAAC;AASnE,OAAO,EAAE,UAAU,EAAU,KAAK,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAqB,KAAK,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAGrF,KAAK,iCAAiC,GAAG;IACrC,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,aAAa,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;IACrD,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,YAAY,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACtC,SAAS,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;CACrD,CAAC;AA0DF,wBAAsB,0BAA0B,CAC5C,OAAO,EAAE,iCAAiC,GAC3C,OAAO,CAAC,UAAU,CAAC,CAmCrB"}
+{"version":3,"file":"agent-creation.d.ts","sourceRoot":"","sources":["../src/agent-creation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,qBAAqB,CAAC;AASnE,OAAO,EAAE,UAAU,EAAU,KAAK,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAqB,KAAK,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAGrF,KAAK,iCAAiC,GAAG;IACrC,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,aAAa,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;IACrD,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,YAAY,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACtC,SAAS,CAAC,EAAE,yBAAyB,GAAG,SAAS,CAAC;CACrD,CAAC;AA0DF,wBAAsB,0BAA0B,CAC5C,OAAO,EAAE,iCAAiC,GAC3C,OAAO,CAAC,UAAU,CAAC,CAsCrB"}

package/dist/agent-creation.js

@@ -65,11 +65,12 @@ async function createDextoAgentFromConfig(options) {
   }
   const validatedConfig = AgentConfigSchema.parse(enrichedConfig);
   const services = await resolveServicesFromConfig(validatedConfig, image);
+  const mergedOverrides = overrides ? { ...overrides } : void 0;
   return new DextoAgent(
     toDextoAgentOptions({
       config: validatedConfig,
       services,
-      overrides
+      overrides: mergedOverrides
     })
   );
 }

package/dist/config/config-enrichment.cjs

@@ -64,7 +64,8 @@ function enrichAgentConfig(config, configPath, options = {}) {
     isInteractiveCli = false,
     logLevel = "error",
     skipPluginDiscovery = false,
-    bundledPlugins = []
+    bundledPlugins = [],
+    forceStoragePaths = false
   } = opts;
   const agentId = deriveAgentId(config, configPath);
   const dbPath = (0, import_path.getDextoPath)("database", `${agentId}.db`);
@@ -94,15 +95,19 @@ function enrichAgentConfig(config, configPath, options = {}) {
       ...config.storage
     };
     if (config.storage.database?.type === "sqlite") {
+      const databasePath = typeof config.storage.database.path === "string" ? config.storage.database.path : void 0;
+      const shouldOverride = !databasePath || forceStoragePaths && !path.isAbsolute(databasePath);
       enriched.storage.database = {
         ...config.storage.database,
-        path: config.storage.database.path || dbPath
+        path: shouldOverride ? dbPath : databasePath
       };
     }
     if (config.storage.blob?.type === "local") {
+      const blobStorePath = typeof config.storage.blob.storePath === "string" ? config.storage.blob.storePath : void 0;
+      const shouldOverride = !blobStorePath || forceStoragePaths && !path.isAbsolute(blobStorePath);
       enriched.storage.blob = {
         ...config.storage.blob,
-        storePath: config.storage.blob.storePath || blobPath
+        storePath: shouldOverride ? blobPath : blobStorePath
       };
     }
   }

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

@@ -35,6 +35,12 @@ export interface EnrichAgentConfigOptions {
      * user/project plugins.
      */
     bundledPlugins?: string[];
+    /**
+     * When true, normalize relative storage paths (database/blob) to per-agent
+     * locations.
+     * Useful when configs may be loaded from varying working directories.
+     */
+    forceStoragePaths?: boolean;
 }
 /**
  * Enriches agent configuration with per-agent file paths and discovered commands.

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,qBAAqB,CAAC;AAUvD,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,CA2Ob"}
+{"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,qBAAqB,CAAC;AAUvD,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;IAC1B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE,wBAAwB,GAAG,OAAY,GACjD,WAAW,CAwPb"}

package/dist/config/config-enrichment.js

@@ -32,7 +32,8 @@ function enrichAgentConfig(config, configPath, options = {}) {
     isInteractiveCli = false,
     logLevel = "error",
     skipPluginDiscovery = false,
-    bundledPlugins = []
+    bundledPlugins = [],
+    forceStoragePaths = false
   } = opts;
   const agentId = deriveAgentId(config, configPath);
   const dbPath = getDextoPath("database", `${agentId}.db`);
@@ -62,15 +63,19 @@ function enrichAgentConfig(config, configPath, options = {}) {
       ...config.storage
     };
     if (config.storage.database?.type === "sqlite") {
+      const databasePath = typeof config.storage.database.path === "string" ? config.storage.database.path : void 0;
+      const shouldOverride = !databasePath || forceStoragePaths && !path.isAbsolute(databasePath);
       enriched.storage.database = {
         ...config.storage.database,
-        path: config.storage.database.path || dbPath
+        path: shouldOverride ? dbPath : databasePath
       };
     }
     if (config.storage.blob?.type === "local") {
+      const blobStorePath = typeof config.storage.blob.storePath === "string" ? config.storage.blob.storePath : void 0;
+      const shouldOverride = !blobStorePath || forceStoragePaths && !path.isAbsolute(blobStorePath);
       enriched.storage.blob = {
         ...config.storage.blob,
-        storePath: config.storage.blob.storePath || blobPath
+        storePath: shouldOverride ? blobPath : blobStorePath
       };
     }
   }

package/dist/index.cjs

@@ -193,6 +193,7 @@ var import_custom_models = require("./models/custom-models.js");
 var import_models = require("./models/index.js");
 __reExport(index_exports, require("./runtime/index.js"), module.exports);
 __reExport(index_exports, require("./tool-factories/agent-spawner/index.js"), module.exports);
+__reExport(index_exports, require("./tool-factories/creator-tools/index.js"), module.exports);
 var import_plugins = require("./plugins/index.js");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -342,5 +343,6 @@ var import_plugins = require("./plugins/index.js");
   writeLLMPreferences,
   writePreferencesToAgent,
   ...require("./runtime/index.js"),
-  ...require("./tool-factories/agent-spawner/index.js")
+  ...require("./tool-factories/agent-spawner/index.js"),
+  ...require("./tool-factories/creator-tools/index.js")
 });

package/dist/index.d.ts

@@ -27,5 +27,6 @@ export { loadCustomModels, saveCustomModel, deleteCustomModel, getCustomModel, g
 export { getModelsDirectory, getModelFilePath, getModelDirectory, getModelStatePath, getModelTempDirectory, ensureModelsDirectory, ensureModelDirectory, modelFileExists, getModelFileSize, deleteModelDirectory, listModelDirectories, getModelsDiskUsage, formatSize, type ModelSource, type InstalledModel, type ModelState, loadModelState, saveModelState, addInstalledModel, removeInstalledModel, getInstalledModel, getAllInstalledModels, isModelInstalled, updateModelLastUsed, setActiveModel, getActiveModelId, getActiveModel, addToDownloadQueue, removeFromDownloadQueue, getDownloadQueue, syncStateWithFilesystem, getTotalInstalledSize, getInstalledModelCount, registerManualModel, } from './models/index.js';
 export * from './runtime/index.js';
 export * from './tool-factories/agent-spawner/index.js';
+export * from './tool-factories/creator-tools/index.js';
 export { discoverClaudeCodePlugins, getPluginSearchPaths, loadClaudeCodePlugin, validatePluginDirectory, tryLoadManifest, listInstalledPlugins, getDextoInstalledPluginsPath, installPluginFromPath, loadDextoInstalledPlugins, saveDextoInstalledPlugins, isPluginInstalled, uninstallPlugin, PluginManifestSchema, PluginMCPConfigSchema, PluginErrorCode, PluginError, DEFAULT_MARKETPLACES, addMarketplace, removeMarketplace, updateMarketplace, listMarketplaces, listAllMarketplacePlugins, installPluginFromMarketplace, getUninstalledDefaults, isDefaultMarketplace, MarketplaceErrorCode, MarketplaceError, type PluginManifest, type DiscoveredPlugin, type PluginCommand, type PluginMCPConfig, type LoadedPlugin, type PluginInstallScope, type InstalledPluginEntry, type InstalledPluginsFile, type ListedPlugin, type PluginValidationResult, type PluginInstallResult, type PluginUninstallResult, type ValidatedPluginManifest, type ValidatedPluginMCPConfig, type InstallPluginOptions, type UninstallPluginOptions, type MarketplaceEntry, type MarketplacePlugin, type MarketplaceAddResult, type MarketplaceUpdateResult, type MarketplaceInstallResult, } from './plugins/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -141,6 +141,7 @@ import {
 } from "./models/index.js";
 export * from "./runtime/index.js";
 export * from "./tool-factories/agent-spawner/index.js";
+export * from "./tool-factories/creator-tools/index.js";
 import {
   discoverClaudeCodePlugins,
   getPluginSearchPaths,

package/dist/models/custom-models.cjs

@@ -65,9 +65,10 @@ const CustomModelSchema = import_zod.z.object({
   // File path for local GGUF models. Required when provider is 'local'.
   // Stores the absolute path to the .gguf file on disk.
   filePath: import_zod.z.string().optional(),
-  // OpenAI reasoning effort level for reasoning-capable models (o1, o3, codex, gpt-5.x).
-  // Controls how many reasoning tokens the model generates before producing a response.
-  reasoningEffort: import_zod.z.enum(["none", "minimal", "low", "medium", "high", "xhigh"]).optional()
+  reasoning: import_zod.z.object({
+    variant: import_zod.z.string().trim().min(1),
+    budgetTokens: import_zod.z.number().int().positive().optional()
+  }).strict().optional()
 }).superRefine((data, ctx) => {
   if ((data.provider === "openai-compatible" || data.provider === "litellm") && !data.baseURL) {
     ctx.addIssue({

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

@@ -34,13 +34,25 @@ export declare const CustomModelSchema: z.ZodEffects<z.ZodObject<{
     maxOutputTokens: z.ZodOptional<z.ZodNumber>;
     apiKey: z.ZodOptional<z.ZodString>;
     filePath: z.ZodOptional<z.ZodString>;
-    reasoningEffort: z.ZodOptional<z.ZodEnum<["none", "minimal", "low", "medium", "high", "xhigh"]>>;
+    reasoning: z.ZodOptional<z.ZodObject<{
+        variant: z.ZodString;
+        budgetTokens: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        variant: string;
+        budgetTokens?: number | undefined;
+    }, {
+        variant: string;
+        budgetTokens?: number | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     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;
+    reasoning?: {
+        variant: string;
+        budgetTokens?: number | undefined;
+    } | undefined;
     filePath?: string | undefined;
     displayName?: string | undefined;
     maxInputTokens?: number | undefined;
@@ -50,7 +62,10 @@ export declare const CustomModelSchema: z.ZodEffects<z.ZodObject<{
     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;
+    reasoning?: {
+        variant: string;
+        budgetTokens?: number | undefined;
+    } | undefined;
     filePath?: string | undefined;
     displayName?: string | undefined;
     maxInputTokens?: number | undefined;
@@ -60,7 +75,10 @@ export declare const CustomModelSchema: z.ZodEffects<z.ZodObject<{
     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;
+    reasoning?: {
+        variant: string;
+        budgetTokens?: number | undefined;
+    } | undefined;
     filePath?: string | undefined;
     displayName?: string | undefined;
     maxInputTokens?: number | undefined;
@@ -70,7 +88,10 @@ export declare const CustomModelSchema: z.ZodEffects<z.ZodObject<{
     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;
+    reasoning?: {
+        variant: string;
+        budgetTokens?: number | undefined;
+    } | undefined;
     filePath?: string | undefined;
     displayName?: string | undefined;
     maxInputTokens?: number | 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,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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkDxB,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

@@ -26,9 +26,10 @@ const CustomModelSchema = z.object({
   // File path for local GGUF models. Required when provider is 'local'.
   // Stores the absolute path to the .gguf file on disk.
   filePath: z.string().optional(),
-  // OpenAI reasoning effort level for reasoning-capable models (o1, o3, codex, gpt-5.x).
-  // Controls how many reasoning tokens the model generates before producing a response.
-  reasoningEffort: z.enum(["none", "minimal", "low", "medium", "high", "xhigh"]).optional()
+  reasoning: z.object({
+    variant: z.string().trim().min(1),
+    budgetTokens: z.number().int().positive().optional()
+  }).strict().optional()
 }).superRefine((data, ctx) => {
   if ((data.provider === "openai-compatible" || data.provider === "litellm") && !data.baseURL) {
     ctx.addIssue({

package/dist/preferences/loader.cjs

@@ -79,11 +79,22 @@ const PREFERENCES_FILE_HEADER = `# Dexto Global Preferences
 # Documentation: https://dexto.dev/docs/configuration/preferences
 #
 # Sound Notifications:
-#   Dexto plays sounds for approval requests and task completion.
-#   To customize sounds, place audio files in ~/.dexto/sounds/:
-#     - approval.wav (or .mp3, .ogg, .aiff, .m4a) - played when tool approval is needed
-#     - complete.wav (or .mp3, .ogg, .aiff, .m4a) - played when agent finishes a task
-#   Set sounds.enabled: false to disable all sounds.
+#   Dexto plays sounds for CLI startup, approval requests, and task completion.
+#   Configure which events play sounds:
+#     sounds.enabled: true|false
+#     sounds.onStartup: true|false
+#     sounds.onApprovalRequired: true|false
+#     sounds.onTaskComplete: true|false
+#
+#   Select sound files (paths are relative to ~/.dexto/sounds):
+#     sounds.startupSoundFile: builtins/startup.wav
+#     sounds.approvalSoundFile: builtins/coin.wav
+#     sounds.completeSoundFile: builtins/success.wav
+#
+#   Tip: Use the /sounds overlay to preview and pick sounds.
+#
+#   To use custom sounds, copy files into ~/.dexto/sounds/ (subfolders ok) and set the *SoundFile
+#   keys to a relative path. Supported audio formats vary by OS (Windows reliably supports .wav).
 
 `;
 const AGENT_PREFERENCES_FILE_HEADER = `# Dexto Agent Preferences
@@ -222,8 +233,8 @@ function createInitialPreferences(options) {
   if (options.baseURL) {
     llmConfig.baseURL = options.baseURL;
   }
-  if (options.reasoningEffort) {
-    llmConfig.reasoningEffort = options.reasoningEffort;
+  if (options.reasoning) {
+    llmConfig.reasoning = options.reasoning;
   }
   return {
     llm: llmConfig,
@@ -238,8 +249,12 @@ function createInitialPreferences(options) {
     },
     sounds: {
       enabled: options.sounds?.enabled ?? true,
+      onStartup: options.sounds?.onStartup ?? false,
+      ...options.sounds?.startupSoundFile ? { startupSoundFile: options.sounds.startupSoundFile } : {},
       onApprovalRequired: options.sounds?.onApprovalRequired ?? true,
-      onTaskComplete: options.sounds?.onTaskComplete ?? true
+      ...options.sounds?.approvalSoundFile ? { approvalSoundFile: options.sounds.approvalSoundFile } : {},
+      onTaskComplete: options.sounds?.onTaskComplete ?? true,
+      ...options.sounds?.completeSoundFile ? { completeSoundFile: options.sounds.completeSoundFile } : {}
     }
   };
 }

package/dist/preferences/loader.d.ts

@@ -1,4 +1,4 @@
-import type { LLMProvider } from '@dexto/core';
+import type { LLMProvider, LLMReasoningConfig } from '@dexto/core';
 import { type AgentPreferences, type GlobalPreferences } from './schemas.js';
 /**
  * Load global preferences from ~/.dexto/preferences.yml
@@ -54,8 +54,8 @@ export interface CreatePreferencesOptions {
     defaultAgent?: string;
     defaultMode?: 'cli' | 'web' | 'server' | 'discord' | 'telegram' | 'mcp';
     baseURL?: string;
-    /** Reasoning effort for OpenAI reasoning models (o1, o3, codex, gpt-5.x) */
-    reasoningEffort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
+    /** Reasoning configuration (tuning only; display is controlled separately). */
+    reasoning?: LLMReasoningConfig;
     setupCompleted?: boolean;
     /** Whether API key setup was skipped and needs to be configured later */
     apiKeyPending?: boolean;
@@ -64,8 +64,12 @@ export interface CreatePreferencesOptions {
     /** Sound notification preferences */
     sounds?: {
         enabled?: boolean;
+        onStartup?: boolean;
+        startupSoundFile?: string;
         onApprovalRequired?: boolean;
+        approvalSoundFile?: string;
         onTaskComplete?: boolean;
+        completeSoundFile?: string;
     };
 }
 /**

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/preferences/loader.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAGH,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACzB,MAAM,cAAc,CAAC;AAItB;;;;;GAKG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CA+BxE;AAsCD;;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,+EAA+E;IAC/E,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,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,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;CACL;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAgD7F;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

@@ -39,11 +39,22 @@ const PREFERENCES_FILE_HEADER = `# Dexto Global Preferences
 # Documentation: https://dexto.dev/docs/configuration/preferences
 #
 # Sound Notifications:
-#   Dexto plays sounds for approval requests and task completion.
-#   To customize sounds, place audio files in ~/.dexto/sounds/:
-#     - approval.wav (or .mp3, .ogg, .aiff, .m4a) - played when tool approval is needed
-#     - complete.wav (or .mp3, .ogg, .aiff, .m4a) - played when agent finishes a task
-#   Set sounds.enabled: false to disable all sounds.
+#   Dexto plays sounds for CLI startup, approval requests, and task completion.
+#   Configure which events play sounds:
+#     sounds.enabled: true|false
+#     sounds.onStartup: true|false
+#     sounds.onApprovalRequired: true|false
+#     sounds.onTaskComplete: true|false
+#
+#   Select sound files (paths are relative to ~/.dexto/sounds):
+#     sounds.startupSoundFile: builtins/startup.wav
+#     sounds.approvalSoundFile: builtins/coin.wav
+#     sounds.completeSoundFile: builtins/success.wav
+#
+#   Tip: Use the /sounds overlay to preview and pick sounds.
+#
+#   To use custom sounds, copy files into ~/.dexto/sounds/ (subfolders ok) and set the *SoundFile
+#   keys to a relative path. Supported audio formats vary by OS (Windows reliably supports .wav).
 
 `;
 const AGENT_PREFERENCES_FILE_HEADER = `# Dexto Agent Preferences
@@ -182,8 +193,8 @@ function createInitialPreferences(options) {
   if (options.baseURL) {
     llmConfig.baseURL = options.baseURL;
   }
-  if (options.reasoningEffort) {
-    llmConfig.reasoningEffort = options.reasoningEffort;
+  if (options.reasoning) {
+    llmConfig.reasoning = options.reasoning;
   }
   return {
     llm: llmConfig,
@@ -198,8 +209,12 @@ function createInitialPreferences(options) {
     },
     sounds: {
       enabled: options.sounds?.enabled ?? true,
+      onStartup: options.sounds?.onStartup ?? false,
+      ...options.sounds?.startupSoundFile ? { startupSoundFile: options.sounds.startupSoundFile } : {},
       onApprovalRequired: options.sounds?.onApprovalRequired ?? true,
-      onTaskComplete: options.sounds?.onTaskComplete ?? true
+      ...options.sounds?.approvalSoundFile ? { approvalSoundFile: options.sounds.approvalSoundFile } : {},
+      onTaskComplete: options.sounds?.onTaskComplete ?? true,
+      ...options.sounds?.completeSoundFile ? { completeSoundFile: options.sounds.completeSoundFile } : {}
     }
   };
 }

package/dist/preferences/schemas.cjs

@@ -29,13 +29,10 @@ __export(schemas_exports, {
 module.exports = __toCommonJS(schemas_exports);
 var import_zod = require("zod");
 var import_core = require("@dexto/core");
-var import_core2 = require("@dexto/core");
-var import_core3 = require("@dexto/core");
 var import_error_codes = require("./error-codes.js");
-var import_core4 = require("@dexto/core");
 const PreferenceLLMSchema = import_zod.z.object({
-  provider: import_zod.z.enum(import_core2.LLM_PROVIDERS).describe("LLM provider (openai, anthropic, google, etc.)"),
-  model: import_core3.NonEmptyTrimmed.describe("Model name for the provider"),
+  provider: import_zod.z.enum(import_core.LLM_PROVIDERS).describe("LLM provider (openai, anthropic, google, etc.)"),
+  model: import_core.NonEmptyTrimmed.describe("Model name for the provider"),
   apiKey: import_zod.z.string().regex(
     /^\$[A-Z_][A-Z0-9_]*$/,
     "Must be environment variable reference (e.g., $OPENAI_API_KEY)"
@@ -43,9 +40,14 @@ const PreferenceLLMSchema = import_zod.z.object({
     "Environment variable reference for API key (optional for local providers like Ollama)"
   ),
   baseURL: import_zod.z.string().url("Must be a valid URL (e.g., http://localhost:11434/v1)").optional().describe("Custom base URL for providers that support it (openai-compatible, litellm)"),
-  reasoningEffort: import_zod.z.enum(["none", "minimal", "low", "medium", "high", "xhigh"]).optional().describe(
-    "Reasoning effort level for OpenAI reasoning models (o1, o3, codex, gpt-5.x). Auto-detected if not set."
-  )
+  reasoning: import_zod.z.object({
+    variant: import_zod.z.string().trim().min(1).describe(
+      "Reasoning variant. Use a model/provider-native variant from the active reasoning profile."
+    ),
+    budgetTokens: import_zod.z.number().int().positive().optional().describe(
+      "Advanced escape hatch for budget-based providers (e.g., Anthropic/Gemini/Bedrock/OpenRouter)."
+    )
+  }).strict().optional().describe("Reasoning configuration (tuning only; display is controlled separately).")
 }).strict().superRefine((data, ctx) => {
   const skipModelValidation = (0, import_core.acceptsAnyModel)(data.provider) || (0, import_core.supportsCustomModels)(data.provider);
   if (!skipModelValidation && !(0, import_core.isValidProviderModel)(data.provider, data.model)) {
@@ -57,7 +59,7 @@ const PreferenceLLMSchema = import_zod.z.object({
       params: {
         code: import_error_codes.PreferenceErrorCode.MODEL_INCOMPATIBLE,
         scope: "preference",
-        type: import_core4.ErrorType.USER
+        type: import_core.ErrorType.USER
       }
     });
   }
@@ -69,10 +71,39 @@ const PreferenceLLMSchema = import_zod.z.object({
       params: {
         code: import_error_codes.PreferenceErrorCode.INVALID_PREFERENCE_VALUE,
         scope: "preference",
-        type: import_core4.ErrorType.USER
+        type: import_core.ErrorType.USER
       }
     });
   }
+  if (data.reasoning) {
+    const profile = (0, import_core.getReasoningProfile)(data.provider, data.model);
+    const variant = data.reasoning.variant;
+    const budgetTokens = data.reasoning.budgetTokens;
+    if (!(0, import_core.supportsReasoningVariant)(profile, variant)) {
+      ctx.addIssue({
+        code: import_zod.z.ZodIssueCode.custom,
+        path: ["reasoning", "variant"],
+        message: `Reasoning variant '${variant}' is not supported for provider '${data.provider}' model '${data.model}'. Supported: ${profile.variants.map((entry) => entry.id).join(", ")}`,
+        params: {
+          code: import_error_codes.PreferenceErrorCode.INVALID_PREFERENCE_VALUE,
+          scope: "preference",
+          type: import_core.ErrorType.USER
+        }
+      });
+    }
+    if (typeof budgetTokens === "number" && !profile.supportsBudgetTokens) {
+      ctx.addIssue({
+        code: import_zod.z.ZodIssueCode.custom,
+        path: ["reasoning", "budgetTokens"],
+        message: `Reasoning budgetTokens are not supported for provider '${data.provider}' model '${data.model}'. Remove reasoning.budgetTokens to use provider defaults.`,
+        params: {
+          code: import_error_codes.PreferenceErrorCode.INVALID_PREFERENCE_VALUE,
+          scope: "preference",
+          type: import_core.ErrorType.USER
+        }
+      });
+    }
+  }
 });
 const PreferenceDefaultsSchema = import_zod.z.object({
   defaultAgent: import_zod.z.string().min(1).describe("Default agent name for global CLI usage (required)"),
@@ -85,13 +116,17 @@ const PreferenceSetupSchema = import_zod.z.object({
 }).strict();
 const PreferenceSoundsSchema = import_zod.z.object({
   enabled: import_zod.z.boolean().default(true).describe("Enable sound notifications (default: true)"),
+  onStartup: import_zod.z.boolean().default(false).describe("Play sound when the interactive CLI starts (default: false)"),
+  startupSoundFile: import_zod.z.string().min(1).optional().describe("Startup sound file path relative to ~/.dexto/sounds (optional)"),
   onApprovalRequired: import_zod.z.boolean().default(true).describe(
     "Play sound when tool approval is required (default: true when sounds enabled)"
   ),
-  onTaskComplete: import_zod.z.boolean().default(true).describe("Play sound when agent task completes (default: true when sounds enabled)")
+  approvalSoundFile: import_zod.z.string().min(1).optional().describe("Approval sound file path relative to ~/.dexto/sounds (optional)"),
+  onTaskComplete: import_zod.z.boolean().default(true).describe("Play sound when agent task completes (default: true when sounds enabled)"),
+  completeSoundFile: import_zod.z.string().min(1).optional().describe("Completion sound file path relative to ~/.dexto/sounds (optional)")
 }).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)")
+  disabled: import_zod.z.array(import_core.NonEmptyTrimmed).default([]).describe("Tool names disabled for this agent (default: none)")
 }).strict();
 const AgentPreferencesSchema = import_zod.z.object({
   tools: AgentToolPreferencesSchema.default({ disabled: [] }).describe(