@dexto/agent-management 1.5.3 → 1.5.5

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

@@ -5,9 +5,10 @@
  * This layer runs before agent initialization and injects explicit paths
  * into the configuration, eliminating the need for core services to resolve paths themselves.
  *
- * Also discovers command prompts from:
- * - Local: <projectRoot>/commands/ (in dev mode or dexto-project context)
- * - Global: ~/.dexto/commands/
+ * Also discovers command prompts from (in priority order):
+ * - Local: <projectRoot>/commands/ (dexto-source dev mode or dexto-project only)
+ * - Local: <cwd>/.dexto/commands/, <cwd>/.claude/commands/, <cwd>/.cursor/commands/
+ * - Global: ~/.dexto/commands/, ~/.claude/commands/, ~/.cursor/commands/
  *
  * Core services now require explicit paths - this enrichment layer provides them.
  */

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;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/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;CAClD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE,wBAAwB,GAAG,OAAY,GACjD,WAAW,CAoKb"}
+{"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;AAK/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;CAClD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE,wBAAwB,GAAG,OAAY,GACjD,WAAW,CAoKb"}

package/dist/config/discover-prompts.cjs

@@ -39,6 +39,19 @@ var import_fs = require("fs");
 function discoverCommandPrompts() {
   const prompts = [];
   const seenFiles = /* @__PURE__ */ new Set();
+  const homeDir = process.env.HOME || process.env.USERPROFILE || "";
+  const cwd = process.cwd();
+  const scanAndAdd = (dir) => {
+    if (!(0, import_fs.existsSync)(dir)) return;
+    const files = scanCommandsDirectory(dir);
+    for (const file of files) {
+      const basename = path.basename(file).toLowerCase();
+      if (!seenFiles.has(basename)) {
+        seenFiles.add(basename);
+        prompts.push({ type: "file", file });
+      }
+    }
+  };
   const context = (0, import_execution_context.getExecutionContext)();
   let localCommandsDir = null;
   switch (context) {
@@ -62,26 +75,18 @@ function discoverCommandPrompts() {
     case "global-cli":
       break;
   }
-  const globalCommandsDir = (0, import_path.getDextoGlobalPath)("commands");
-  if (localCommandsDir && (0, import_fs.existsSync)(localCommandsDir)) {
-    const files = scanCommandsDirectory(localCommandsDir);
-    for (const file of files) {
-      const basename = path.basename(file).toLowerCase();
-      if (!seenFiles.has(basename)) {
-        seenFiles.add(basename);
-        prompts.push({ type: "file", file });
-      }
-    }
+  if (localCommandsDir) {
+    scanAndAdd(localCommandsDir);
   }
-  if ((0, import_fs.existsSync)(globalCommandsDir)) {
-    const files = scanCommandsDirectory(globalCommandsDir);
-    for (const file of files) {
-      const basename = path.basename(file).toLowerCase();
-      if (!seenFiles.has(basename)) {
-        seenFiles.add(basename);
-        prompts.push({ type: "file", file });
-      }
-    }
+  scanAndAdd(path.join(cwd, ".dexto", "commands"));
+  scanAndAdd(path.join(cwd, ".claude", "commands"));
+  scanAndAdd(path.join(cwd, ".cursor", "commands"));
+  scanAndAdd((0, import_path.getDextoGlobalPath)("commands"));
+  if (homeDir) {
+    scanAndAdd(path.join(homeDir, ".claude", "commands"));
+  }
+  if (homeDir) {
+    scanAndAdd(path.join(homeDir, ".cursor", "commands"));
   }
   return prompts;
 }

package/dist/config/discover-prompts.d.ts

@@ -15,12 +15,20 @@ export interface FilePromptEntry {
 /**
  * Discovers command prompts from commands/ directories.
  *
- * Discovery locations based on execution context:
- * - dexto-source (dev mode): <sourceRoot>/commands/
- * - dexto-project: <projectRoot>/commands/
- * - global-cli: skip local (use global only)
+ * Discovery locations (in priority order):
  *
- * Global commands (~/.dexto/commands/) are always included.
+ * Local commands (project-specific):
+ * 1. <projectRoot>/commands/ (dexto-source dev mode or dexto-project only)
+ * 2. <cwd>/.dexto/commands/
+ * 3. <cwd>/.claude/commands/ (Claude Code compatibility)
+ * 4. <cwd>/.cursor/commands/ (Cursor compatibility)
+ *
+ * Global commands (user-wide):
+ * 5. ~/.dexto/commands/
+ * 6. ~/.claude/commands/ (Claude Code compatibility)
+ * 7. ~/.cursor/commands/ (Cursor compatibility)
+ *
+ * Files with the same basename are deduplicated (first found wins).
  *
  * @returns Array of file prompt entries for discovered .md files
  */

package/dist/config/discover-prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discover-prompts.d.ts","sourceRoot":"","sources":["../../src/config/discover-prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,IAAI,eAAe,EAAE,CA8D1D;AAiCD;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,GAAG,IAAI,CA0B5D"}
+{"version":3,"file":"discover-prompts.d.ts","sourceRoot":"","sources":["../../src/config/discover-prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,IAAI,eAAe,EAAE,CAkF1D;AAiCD;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,GAAG,IAAI,CA0B5D"}

package/dist/config/discover-prompts.js

@@ -9,6 +9,19 @@ import { existsSync, readdirSync } from "fs";
 function discoverCommandPrompts() {
   const prompts = [];
   const seenFiles = /* @__PURE__ */ new Set();
+  const homeDir = process.env.HOME || process.env.USERPROFILE || "";
+  const cwd = process.cwd();
+  const scanAndAdd = (dir) => {
+    if (!existsSync(dir)) return;
+    const files = scanCommandsDirectory(dir);
+    for (const file of files) {
+      const basename = path.basename(file).toLowerCase();
+      if (!seenFiles.has(basename)) {
+        seenFiles.add(basename);
+        prompts.push({ type: "file", file });
+      }
+    }
+  };
   const context = getExecutionContext();
   let localCommandsDir = null;
   switch (context) {
@@ -32,26 +45,18 @@ function discoverCommandPrompts() {
     case "global-cli":
       break;
   }
-  const globalCommandsDir = getDextoGlobalPath("commands");
-  if (localCommandsDir && existsSync(localCommandsDir)) {
-    const files = scanCommandsDirectory(localCommandsDir);
-    for (const file of files) {
-      const basename = path.basename(file).toLowerCase();
-      if (!seenFiles.has(basename)) {
-        seenFiles.add(basename);
-        prompts.push({ type: "file", file });
-      }
-    }
+  if (localCommandsDir) {
+    scanAndAdd(localCommandsDir);
   }
-  if (existsSync(globalCommandsDir)) {
-    const files = scanCommandsDirectory(globalCommandsDir);
-    for (const file of files) {
-      const basename = path.basename(file).toLowerCase();
-      if (!seenFiles.has(basename)) {
-        seenFiles.add(basename);
-        prompts.push({ type: "file", file });
-      }
-    }
+  scanAndAdd(path.join(cwd, ".dexto", "commands"));
+  scanAndAdd(path.join(cwd, ".claude", "commands"));
+  scanAndAdd(path.join(cwd, ".cursor", "commands"));
+  scanAndAdd(getDextoGlobalPath("commands"));
+  if (homeDir) {
+    scanAndAdd(path.join(homeDir, ".claude", "commands"));
+  }
+  if (homeDir) {
+    scanAndAdd(path.join(homeDir, ".cursor", "commands"));
   }
   return prompts;
 }

package/dist/preferences/index.cjs

@@ -25,6 +25,7 @@ __export(preferences_exports, {
   PreferenceErrorCode: () => import_errors.PreferenceErrorCode,
   PreferenceLLMSchema: () => import_schemas.PreferenceLLMSchema,
   PreferenceSetupSchema: () => import_schemas.PreferenceSetupSchema,
+  PreferenceSoundsSchema: () => import_schemas.PreferenceSoundsSchema,
   createInitialPreferences: () => import_loader.createInitialPreferences,
   getGlobalPreferencesPath: () => import_loader.getGlobalPreferencesPath,
   globalPreferencesExist: () => import_loader.globalPreferencesExist,
@@ -46,6 +47,7 @@ var import_errors = require("./errors.js");
   PreferenceErrorCode,
   PreferenceLLMSchema,
   PreferenceSetupSchema,
+  PreferenceSoundsSchema,
   createInitialPreferences,
   getGlobalPreferencesPath,
   globalPreferencesExist,

package/dist/preferences/index.d.ts

@@ -1,5 +1,5 @@
-export type { GlobalPreferences, PreferenceLLM, PreferenceDefaults, PreferenceSetup, } from './schemas.js';
-export { GlobalPreferencesSchema, PreferenceLLMSchema, PreferenceDefaultsSchema, PreferenceSetupSchema, } from './schemas.js';
+export type { GlobalPreferences, PreferenceLLM, PreferenceDefaults, PreferenceSetup, PreferenceSounds, } from './schemas.js';
+export { GlobalPreferencesSchema, PreferenceLLMSchema, PreferenceDefaultsSchema, PreferenceSetupSchema, PreferenceSoundsSchema, } from './schemas.js';
 export { PREFERENCES_FILE } from './constants.js';
 export { loadGlobalPreferences, saveGlobalPreferences, globalPreferencesExist, getGlobalPreferencesPath, createInitialPreferences, updateGlobalPreferences, type CreatePreferencesOptions, } from './loader.js';
 export { PreferenceError, PreferenceErrorCode } from './errors.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/preferences/index.ts"],"names":[],"mappings":"AAEA,YAAY,EACR,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,eAAe,GAClB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACH,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,GACxB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EACH,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,KAAK,wBAAwB,GAChC,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/preferences/index.ts"],"names":[],"mappings":"AAEA,YAAY,EACR,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,gBAAgB,GACnB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACH,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,GACzB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EACH,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,KAAK,wBAAwB,GAChC,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/preferences/index.js

@@ -2,7 +2,8 @@ import {
   GlobalPreferencesSchema,
   PreferenceLLMSchema,
   PreferenceDefaultsSchema,
-  PreferenceSetupSchema
+  PreferenceSetupSchema,
+  PreferenceSoundsSchema
 } from "./schemas.js";
 import { PREFERENCES_FILE } from "./constants.js";
 import {
@@ -22,6 +23,7 @@ export {
   PreferenceErrorCode,
   PreferenceLLMSchema,
   PreferenceSetupSchema,
+  PreferenceSoundsSchema,
   createInitialPreferences,
   getGlobalPreferencesPath,
   globalPreferencesExist,

package/dist/preferences/loader.cjs

@@ -59,6 +59,17 @@ async function loadGlobalPreferences() {
     );
   }
 }
+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.
+
+`;
 async function saveGlobalPreferences(preferences) {
   const preferencesPath = (0, import_path.getDextoGlobalPath)(import_constants.PREFERENCES_FILE);
   const validation = import_schemas.GlobalPreferencesSchema.safeParse(preferences);
@@ -74,7 +85,7 @@ async function saveGlobalPreferences(preferences) {
       lineWidth: 100,
       minContentWidth: 20
     });
-    await import_fs2.promises.writeFile(preferencesPath, yamlContent, "utf-8");
+    await import_fs2.promises.writeFile(preferencesPath, PREFERENCES_FILE_HEADER + yamlContent, "utf-8");
     import_core.logger.debug(
       `\u2713 Saved global preferences ${JSON.stringify(preferences)} to: ${preferencesPath}`
     );
@@ -92,49 +103,35 @@ function globalPreferencesExist() {
 function getGlobalPreferencesPath() {
   return (0, import_path.getDextoGlobalPath)(import_constants.PREFERENCES_FILE);
 }
-function createInitialPreferences(providerOrOptions, model, apiKeyVar, defaultAgent = "coding-agent") {
-  if (typeof providerOrOptions === "object") {
-    const opts = providerOrOptions;
-    const llmConfig = {
-      provider: opts.provider,
-      model: opts.model
-    };
-    if (opts.apiKeyVar) {
-      llmConfig.apiKey = `$${opts.apiKeyVar}`;
-    }
-    if (opts.baseURL) {
-      llmConfig.baseURL = opts.baseURL;
-    }
-    if (opts.reasoningEffort) {
-      llmConfig.reasoningEffort = opts.reasoningEffort;
-    }
-    return {
-      llm: llmConfig,
-      defaults: {
-        defaultAgent: opts.defaultAgent || "coding-agent",
-        defaultMode: opts.defaultMode || "web"
-      },
-      setup: {
-        completed: opts.setupCompleted ?? true,
-        apiKeyPending: opts.apiKeyPending ?? false,
-        baseURLPending: opts.baseURLPending ?? false
-      }
-    };
+function createInitialPreferences(options) {
+  const llmConfig = {
+    provider: options.provider,
+    model: options.model
+  };
+  if (options.apiKeyVar) {
+    llmConfig.apiKey = "$" + options.apiKeyVar;
+  }
+  if (options.baseURL) {
+    llmConfig.baseURL = options.baseURL;
+  }
+  if (options.reasoningEffort) {
+    llmConfig.reasoningEffort = options.reasoningEffort;
   }
   return {
-    llm: {
-      provider: providerOrOptions,
-      model,
-      apiKey: `$${apiKeyVar}`
-    },
+    llm: llmConfig,
     defaults: {
-      defaultAgent,
-      defaultMode: "web"
+      defaultAgent: options.defaultAgent || "coding-agent",
+      defaultMode: options.defaultMode || "web"
     },
     setup: {
-      completed: true,
-      apiKeyPending: false,
-      baseURLPending: false
+      completed: options.setupCompleted ?? true,
+      apiKeyPending: options.apiKeyPending ?? false,
+      baseURLPending: options.baseURLPending ?? false
+    },
+    sounds: {
+      enabled: options.sounds?.enabled ?? true,
+      onApprovalRequired: options.sounds?.onApprovalRequired ?? true,
+      onTaskComplete: options.sounds?.onTaskComplete ?? true
     }
   };
 }
@@ -145,9 +142,10 @@ async function updateGlobalPreferences(updates) {
     ...updates,
     // LLM section requires complete replacement (high coherence - provider/model/apiKey must match)
     llm: updates.llm || existing.llm,
-    // Defaults and setup sections allow partial updates (low coherence - independent fields)
+    // Defaults, setup, and sounds sections allow partial updates (low coherence - independent fields)
     defaults: updates.defaults ? { ...existing.defaults, ...updates.defaults } : existing.defaults,
-    setup: updates.setup ? { ...existing.setup, ...updates.setup } : existing.setup
+    setup: updates.setup ? { ...existing.setup, ...updates.setup } : existing.setup,
+    sounds: updates.sounds ? { ...existing.sounds, ...updates.sounds } : existing.sounds
   };
   const validation = import_schemas.GlobalPreferencesSchema.safeParse(merged);
   if (!validation.success) {

package/dist/preferences/loader.d.ts

@@ -41,17 +41,18 @@ export interface CreatePreferencesOptions {
     apiKeyPending?: boolean;
     /** Whether baseURL setup was skipped and needs to be configured later */
     baseURLPending?: boolean;
+    /** Sound notification preferences */
+    sounds?: {
+        enabled?: boolean;
+        onApprovalRequired?: boolean;
+        onTaskComplete?: boolean;
+    };
 }
 /**
  * Create initial preferences from setup data
  * @param options Configuration options for preferences
  */
 export declare function createInitialPreferences(options: CreatePreferencesOptions): GlobalPreferences;
-/**
- * Create initial preferences from setup data (legacy signature)
- * @deprecated Use options object instead
- */
-export declare function createInitialPreferences(provider: LLMProvider, model: string, apiKeyVar: string, defaultAgent?: string): GlobalPreferences;
 /**
  * Updates type that allows partial nested objects
  */
@@ -59,6 +60,7 @@ export type GlobalPreferencesUpdates = {
     llm?: GlobalPreferences['llm'];
     defaults?: Partial<GlobalPreferences['defaults']>;
     setup?: Partial<GlobalPreferences['setup']>;
+    sounds?: Partial<GlobalPreferences['sounds']>;
 };
 /**
  * Update specific preference sections

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;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;CAC5B;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAAC;AAE/F;;;GAGG;AACH,wBAAgB,wBAAwB,CACpC,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACtB,iBAAiB,CAAC;AAgErB;;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;CAC/C,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CACzC,OAAO,EAAE,wBAAwB,GAClC,OAAO,CAAC,iBAAiB,CAAC,CA2B5B"}
+{"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"}

package/dist/preferences/loader.js

@@ -31,6 +31,17 @@ async function loadGlobalPreferences() {
     );
   }
 }
+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.
+
+`;
 async function saveGlobalPreferences(preferences) {
   const preferencesPath = getDextoGlobalPath(PREFERENCES_FILE);
   const validation = GlobalPreferencesSchema.safeParse(preferences);
@@ -46,7 +57,7 @@ async function saveGlobalPreferences(preferences) {
       lineWidth: 100,
       minContentWidth: 20
     });
-    await fs.writeFile(preferencesPath, yamlContent, "utf-8");
+    await fs.writeFile(preferencesPath, PREFERENCES_FILE_HEADER + yamlContent, "utf-8");
     logger.debug(
       `\u2713 Saved global preferences ${JSON.stringify(preferences)} to: ${preferencesPath}`
     );
@@ -64,49 +75,35 @@ function globalPreferencesExist() {
 function getGlobalPreferencesPath() {
   return getDextoGlobalPath(PREFERENCES_FILE);
 }
-function createInitialPreferences(providerOrOptions, model, apiKeyVar, defaultAgent = "coding-agent") {
-  if (typeof providerOrOptions === "object") {
-    const opts = providerOrOptions;
-    const llmConfig = {
-      provider: opts.provider,
-      model: opts.model
-    };
-    if (opts.apiKeyVar) {
-      llmConfig.apiKey = `$${opts.apiKeyVar}`;
-    }
-    if (opts.baseURL) {
-      llmConfig.baseURL = opts.baseURL;
-    }
-    if (opts.reasoningEffort) {
-      llmConfig.reasoningEffort = opts.reasoningEffort;
-    }
-    return {
-      llm: llmConfig,
-      defaults: {
-        defaultAgent: opts.defaultAgent || "coding-agent",
-        defaultMode: opts.defaultMode || "web"
-      },
-      setup: {
-        completed: opts.setupCompleted ?? true,
-        apiKeyPending: opts.apiKeyPending ?? false,
-        baseURLPending: opts.baseURLPending ?? false
-      }
-    };
+function createInitialPreferences(options) {
+  const llmConfig = {
+    provider: options.provider,
+    model: options.model
+  };
+  if (options.apiKeyVar) {
+    llmConfig.apiKey = "$" + options.apiKeyVar;
+  }
+  if (options.baseURL) {
+    llmConfig.baseURL = options.baseURL;
+  }
+  if (options.reasoningEffort) {
+    llmConfig.reasoningEffort = options.reasoningEffort;
   }
   return {
-    llm: {
-      provider: providerOrOptions,
-      model,
-      apiKey: `$${apiKeyVar}`
-    },
+    llm: llmConfig,
     defaults: {
-      defaultAgent,
-      defaultMode: "web"
+      defaultAgent: options.defaultAgent || "coding-agent",
+      defaultMode: options.defaultMode || "web"
     },
     setup: {
-      completed: true,
-      apiKeyPending: false,
-      baseURLPending: false
+      completed: options.setupCompleted ?? true,
+      apiKeyPending: options.apiKeyPending ?? false,
+      baseURLPending: options.baseURLPending ?? false
+    },
+    sounds: {
+      enabled: options.sounds?.enabled ?? true,
+      onApprovalRequired: options.sounds?.onApprovalRequired ?? true,
+      onTaskComplete: options.sounds?.onTaskComplete ?? true
     }
   };
 }
@@ -117,9 +114,10 @@ async function updateGlobalPreferences(updates) {
     ...updates,
     // LLM section requires complete replacement (high coherence - provider/model/apiKey must match)
     llm: updates.llm || existing.llm,
-    // Defaults and setup sections allow partial updates (low coherence - independent fields)
+    // Defaults, setup, and sounds sections allow partial updates (low coherence - independent fields)
     defaults: updates.defaults ? { ...existing.defaults, ...updates.defaults } : existing.defaults,
-    setup: updates.setup ? { ...existing.setup, ...updates.setup } : existing.setup
+    setup: updates.setup ? { ...existing.setup, ...updates.setup } : existing.setup,
+    sounds: updates.sounds ? { ...existing.sounds, ...updates.sounds } : existing.sounds
   };
   const validation = GlobalPreferencesSchema.safeParse(merged);
   if (!validation.success) {

package/dist/preferences/schemas.cjs

@@ -21,7 +21,8 @@ __export(schemas_exports, {
   GlobalPreferencesSchema: () => GlobalPreferencesSchema,
   PreferenceDefaultsSchema: () => PreferenceDefaultsSchema,
   PreferenceLLMSchema: () => PreferenceLLMSchema,
-  PreferenceSetupSchema: () => PreferenceSetupSchema
+  PreferenceSetupSchema: () => PreferenceSetupSchema,
+  PreferenceSoundsSchema: () => PreferenceSoundsSchema
 });
 module.exports = __toCommonJS(schemas_exports);
 var import_zod = require("zod");
@@ -80,11 +81,21 @@ const PreferenceSetupSchema = import_zod.z.object({
   apiKeyPending: import_zod.z.boolean().default(false).describe("Whether API key setup was skipped and needs to be configured later"),
   baseURLPending: import_zod.z.boolean().default(false).describe("Whether baseURL setup was skipped and needs to be configured later")
 }).strict();
+const PreferenceSoundsSchema = import_zod.z.object({
+  enabled: import_zod.z.boolean().default(true).describe("Enable sound notifications (default: true)"),
+  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)")
+}).strict();
 const GlobalPreferencesSchema = import_zod.z.object({
   llm: PreferenceLLMSchema.describe("LLM configuration preferences"),
   defaults: PreferenceDefaultsSchema.describe("Default behavior preferences (required)"),
   setup: PreferenceSetupSchema.default({ completed: false }).describe(
     "Setup completion tracking"
+  ),
+  sounds: PreferenceSoundsSchema.default({}).describe(
+    "Sound notification preferences (defaults applied for legacy preferences)"
   )
 }).strict();
 // Annotate the CommonJS export names for ESM import in node:
@@ -92,5 +103,6 @@ const GlobalPreferencesSchema = import_zod.z.object({
   GlobalPreferencesSchema,
   PreferenceDefaultsSchema,
   PreferenceLLMSchema,
-  PreferenceSetupSchema
+  PreferenceSetupSchema,
+  PreferenceSoundsSchema
 });

package/dist/preferences/schemas.d.ts

@@ -53,6 +53,19 @@ export declare const PreferenceSetupSchema: z.ZodObject<{
     apiKeyPending?: boolean | undefined;
     baseURLPending?: boolean | undefined;
 }>;
+export declare const PreferenceSoundsSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    onApprovalRequired: z.ZodDefault<z.ZodBoolean>;
+    onTaskComplete: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    enabled: boolean;
+    onApprovalRequired: boolean;
+    onTaskComplete: boolean;
+}, {
+    enabled?: boolean | undefined;
+    onApprovalRequired?: boolean | undefined;
+    onTaskComplete?: boolean | 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"]>;
@@ -108,6 +121,19 @@ export declare const GlobalPreferencesSchema: z.ZodObject<{
         apiKeyPending?: boolean | undefined;
         baseURLPending?: boolean | undefined;
     }>>;
+    sounds: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        onApprovalRequired: z.ZodDefault<z.ZodBoolean>;
+        onTaskComplete: z.ZodDefault<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        enabled: boolean;
+        onApprovalRequired: boolean;
+        onTaskComplete: boolean;
+    }, {
+        enabled?: boolean | undefined;
+        onApprovalRequired?: boolean | undefined;
+        onTaskComplete?: boolean | undefined;
+    }>>;
 }, "strict", z.ZodTypeAny, {
     llm: {
         provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
@@ -125,6 +151,11 @@ export declare const GlobalPreferencesSchema: z.ZodObject<{
         apiKeyPending: boolean;
         baseURLPending: boolean;
     };
+    sounds: {
+        enabled: boolean;
+        onApprovalRequired: boolean;
+        onTaskComplete: boolean;
+    };
 }, {
     llm: {
         provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
@@ -142,9 +173,15 @@ export declare const GlobalPreferencesSchema: z.ZodObject<{
         apiKeyPending?: boolean | undefined;
         baseURLPending?: boolean | undefined;
     } | undefined;
+    sounds?: {
+        enabled?: boolean | undefined;
+        onApprovalRequired?: boolean | undefined;
+        onTaskComplete?: boolean | undefined;
+    } | undefined;
 }>;
 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 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,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUvB,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,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,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"}

package/dist/preferences/schemas.js

@@ -60,16 +60,27 @@ const PreferenceSetupSchema = z.object({
   apiKeyPending: z.boolean().default(false).describe("Whether API key setup was skipped and needs to be configured later"),
   baseURLPending: z.boolean().default(false).describe("Whether baseURL setup was skipped and needs to be configured later")
 }).strict();
+const PreferenceSoundsSchema = z.object({
+  enabled: z.boolean().default(true).describe("Enable sound notifications (default: true)"),
+  onApprovalRequired: z.boolean().default(true).describe(
+    "Play sound when tool approval is required (default: true when sounds enabled)"
+  ),
+  onTaskComplete: z.boolean().default(true).describe("Play sound when agent task completes (default: true when sounds enabled)")
+}).strict();
 const GlobalPreferencesSchema = z.object({
   llm: PreferenceLLMSchema.describe("LLM configuration preferences"),
   defaults: PreferenceDefaultsSchema.describe("Default behavior preferences (required)"),
   setup: PreferenceSetupSchema.default({ completed: false }).describe(
     "Setup completion tracking"
+  ),
+  sounds: PreferenceSoundsSchema.default({}).describe(
+    "Sound notification preferences (defaults applied for legacy preferences)"
   )
 }).strict();
 export {
   GlobalPreferencesSchema,
   PreferenceDefaultsSchema,
   PreferenceLLMSchema,
-  PreferenceSetupSchema
+  PreferenceSetupSchema,
+  PreferenceSoundsSchema
 };

package/dist/tool-provider/runtime-service.cjs

@@ -110,7 +110,7 @@ class RuntimeService {
   }
   /**
    * Set up progress event emission for a sub-agent.
-   * Subscribes to llm:tool-call events and emits service:event with progress data.
+   * Subscribes to llm:tool-call and llm:response events and emits service:event with progress data.
    *
    * @returns Cleanup function to unsubscribe from events
    */
@@ -126,8 +126,26 @@ class RuntimeService {
       `[Progress] Setting up progress tracking for sub-agent ${subAgentHandle.agentId} (toolCallId: ${toolCallId}, sessionId: ${sessionId})`
     );
     let toolCount = 0;
+    const tokenUsage = { input: 0, output: 0, total: 0 };
+    let currentTool = "";
     const subAgentBus = subAgentHandle.agent.agentEventBus;
     const parentBus = this.parentAgent.agentEventBus;
+    const emitProgress = (tool, args) => {
+      parentBus.emit("service:event", {
+        service: "agent-spawner",
+        event: "progress",
+        toolCallId,
+        sessionId,
+        data: {
+          task: input.task,
+          agentId: input.agentId ?? "default",
+          toolsCalled: toolCount,
+          currentTool: tool,
+          currentArgs: args,
+          tokenUsage: { ...tokenUsage }
+        }
+      });
+    };
     const toolCallHandler = (event) => {
       toolCount++;
       let displayToolName = event.toolName;
@@ -141,26 +159,28 @@ class RuntimeService {
           displayToolName = parts.slice(2).join("--");
         }
       }
+      currentTool = displayToolName;
       this.logger.debug(
         `[Progress] Sub-agent tool call #${toolCount}: ${displayToolName} (toolCallId: ${toolCallId})`
       );
-      parentBus.emit("service:event", {
-        service: "agent-spawner",
-        event: "progress",
-        toolCallId,
-        sessionId,
-        data: {
-          task: input.task,
-          agentId: input.agentId ?? "default",
-          toolsCalled: toolCount,
-          currentTool: displayToolName,
-          currentArgs: event.args
-        }
-      });
+      emitProgress(displayToolName, event.args);
+    };
+    const responseHandler = (event) => {
+      if (event.tokenUsage) {
+        tokenUsage.input = event.tokenUsage.inputTokens ?? 0;
+        tokenUsage.output += event.tokenUsage.outputTokens ?? 0;
+        tokenUsage.total = tokenUsage.input + tokenUsage.output;
+        this.logger.debug(
+          `[Progress] Sub-agent tokens: input=${tokenUsage.input}, cumOutput=${tokenUsage.output}, total=${tokenUsage.total}`
+        );
+        emitProgress(currentTool || "processing");
+      }
     };
     subAgentBus.on("llm:tool-call", toolCallHandler);
+    subAgentBus.on("llm:response", responseHandler);
     return () => {
       subAgentBus.off("llm:tool-call", toolCallHandler);
+      subAgentBus.off("llm:response", responseHandler);
     };
   }
   /**

package/dist/tool-provider/runtime-service.d.ts

@@ -53,7 +53,7 @@ export declare class RuntimeService {
     }): Promise<SpawnAgentOutput>;
     /**
      * Set up progress event emission for a sub-agent.
-     * Subscribes to llm:tool-call events and emits service:event with progress data.
+     * Subscribes to llm:tool-call and llm:response events and emits service:event with progress data.
      *
      * @returns Cleanup function to unsubscribe from events
      */

package/dist/tool-provider/runtime-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-service.d.ts","sourceRoot":"","sources":["../../src/tool-provider/runtime-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC;AAKzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,qBAAa,cAAc;IACvB,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,MAAM,CAAe;gBAEjB,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,YAAY;IAuBrF;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;;;;;;;;;;;;OAaG;IACG,eAAe,CAAC,KAAK,EAAE;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA8C7B;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAqE7B;;OAEG;YACW,oBAAoB;IAgKlC;;;;;;OAMG;YACW,mBAAmB;IAuEjC;;;OAGG;IACH,kBAAkB,IAAI,kBAAkB,EAAE;IAoB1C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAIjC"}
+{"version":3,"file":"runtime-service.d.ts","sourceRoot":"","sources":["../../src/tool-provider/runtime-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC;AAKzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,qBAAa,cAAc;IACvB,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,MAAM,CAAe;gBAEjB,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,YAAY;IAuBrF;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;;;;;;;;;;;;OAaG;IACG,eAAe,CAAC,KAAK,EAAE;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA8C7B;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAiH7B;;OAEG;YACW,oBAAoB;IAgKlC;;;;;;OAMG;YACW,mBAAmB;IAuEjC;;;OAGG;IACH,kBAAkB,IAAI,kBAAkB,EAAE;IAoB1C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAIjC"}

package/dist/tool-provider/runtime-service.js

@@ -87,7 +87,7 @@ class RuntimeService {
   }
   /**
    * Set up progress event emission for a sub-agent.
-   * Subscribes to llm:tool-call events and emits service:event with progress data.
+   * Subscribes to llm:tool-call and llm:response events and emits service:event with progress data.
    *
    * @returns Cleanup function to unsubscribe from events
    */
@@ -103,8 +103,26 @@ class RuntimeService {
       `[Progress] Setting up progress tracking for sub-agent ${subAgentHandle.agentId} (toolCallId: ${toolCallId}, sessionId: ${sessionId})`
     );
     let toolCount = 0;
+    const tokenUsage = { input: 0, output: 0, total: 0 };
+    let currentTool = "";
     const subAgentBus = subAgentHandle.agent.agentEventBus;
     const parentBus = this.parentAgent.agentEventBus;
+    const emitProgress = (tool, args) => {
+      parentBus.emit("service:event", {
+        service: "agent-spawner",
+        event: "progress",
+        toolCallId,
+        sessionId,
+        data: {
+          task: input.task,
+          agentId: input.agentId ?? "default",
+          toolsCalled: toolCount,
+          currentTool: tool,
+          currentArgs: args,
+          tokenUsage: { ...tokenUsage }
+        }
+      });
+    };
     const toolCallHandler = (event) => {
       toolCount++;
       let displayToolName = event.toolName;
@@ -118,26 +136,28 @@ class RuntimeService {
           displayToolName = parts.slice(2).join("--");
         }
       }
+      currentTool = displayToolName;
       this.logger.debug(
         `[Progress] Sub-agent tool call #${toolCount}: ${displayToolName} (toolCallId: ${toolCallId})`
       );
-      parentBus.emit("service:event", {
-        service: "agent-spawner",
-        event: "progress",
-        toolCallId,
-        sessionId,
-        data: {
-          task: input.task,
-          agentId: input.agentId ?? "default",
-          toolsCalled: toolCount,
-          currentTool: displayToolName,
-          currentArgs: event.args
-        }
-      });
+      emitProgress(displayToolName, event.args);
+    };
+    const responseHandler = (event) => {
+      if (event.tokenUsage) {
+        tokenUsage.input = event.tokenUsage.inputTokens ?? 0;
+        tokenUsage.output += event.tokenUsage.outputTokens ?? 0;
+        tokenUsage.total = tokenUsage.input + tokenUsage.output;
+        this.logger.debug(
+          `[Progress] Sub-agent tokens: input=${tokenUsage.input}, cumOutput=${tokenUsage.output}, total=${tokenUsage.total}`
+        );
+        emitProgress(currentTool || "processing");
+      }
     };
     subAgentBus.on("llm:tool-call", toolCallHandler);
+    subAgentBus.on("llm:response", responseHandler);
     return () => {
       subAgentBus.off("llm:tool-call", toolCallHandler);
+      subAgentBus.off("llm:response", responseHandler);
     };
   }
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dexto/agent-management",
-  "version": "1.5.3",
+  "version": "1.5.5",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -16,7 +16,7 @@
   "dependencies": {
     "yaml": "^2.7.1",
     "zod": "^3.25.0",
-    "@dexto/core": "1.5.3"
+    "@dexto/core": "1.5.5"
   },
   "devDependencies": {
     "@types/node": "^22.13.5"