dexto 1.5.8 → 1.6.1

package/dist/cli/ink-cli/utils/index.d.ts

@@ -5,5 +5,5 @@ export { type AutocompleteType, detectAutocompleteType, extractSlashQuery, extra
 export { getCommandOverlay, getCommandOverlayForSelect, isInteractiveCommand, } from './commandOverlays.js';
 export { createUserMessage, createSystemMessage, createErrorMessage, createToolMessage, createStreamingMessage, convertHistoryToUIMessages, getStartupInfo, } from './messageFormatting.js';
 export { generateMessageId } from './idGenerator.js';
-export { playNotificationSound, SoundNotificationService, initializeSoundService, getSoundService, type SoundType, type SoundConfig, } from './soundNotification.js';
+export { playNotificationSound, SoundNotificationService, type SoundType, type SoundConfig, } from './soundNotification.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/cli/ink-cli/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/ink-cli/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACH,KAAK,gBAAgB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,GACpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACH,iBAAiB,EACjB,0BAA0B,EAC1B,oBAAoB,GACvB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACH,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,0BAA0B,EAC1B,cAAc,GACjB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,EACH,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,eAAe,EACf,KAAK,SAAS,EACd,KAAK,WAAW,GACnB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/ink-cli/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACH,KAAK,gBAAgB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,GACpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACH,iBAAiB,EACjB,0BAA0B,EAC1B,oBAAoB,GACvB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACH,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,0BAA0B,EAC1B,cAAc,GACjB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,EACH,qBAAqB,EACrB,wBAAwB,EACxB,KAAK,SAAS,EACd,KAAK,WAAW,GACnB,MAAM,wBAAwB,CAAC"}

package/dist/cli/ink-cli/utils/index.js

@@ -10,4 +10,4 @@ export { createUserMessage, createSystemMessage, createErrorMessage, createToolM
 // ID generation
 export { generateMessageId } from './idGenerator.js';
 // Sound notifications
-export { playNotificationSound, SoundNotificationService, initializeSoundService, getSoundService, } from './soundNotification.js';
+export { playNotificationSound, SoundNotificationService, } from './soundNotification.js';

package/dist/cli/ink-cli/utils/messageFormatting.d.ts

@@ -2,8 +2,10 @@
  * Message formatting utilities
  * Helpers for creating and formatting messages
  */
-import type { DextoAgent, InternalMessage } from '@dexto/core';
+import type { DextoAgent, InternalMessage, ToolPresentationSnapshotV1 } from '@dexto/core';
 import type { Message } from '../state/types.js';
+export declare function normalizeToolName(toolName: string): string;
+export declare function shouldHideTool(toolName: string | undefined): boolean;
 /**
  * Formats a skill invocation message for clean display.
  * Converts verbose <skill-invocation> blocks to clean /skill-name format.
@@ -45,7 +47,7 @@ export declare function centerTruncatePath(filePath: string, maxWidth: number):
 export declare function getToolDisplayName(toolName: string): string;
 /**
  * Gets the tool type badge for display.
- * Returns: 'internal', MCP server name, or 'custom'
+ * Returns: 'local' or MCP server name.
  */
 export declare function getToolTypeBadge(toolName: string): string;
 /**
@@ -67,26 +69,15 @@ export interface FormattedToolHeader {
  *
  * Handles special cases like spawn_agent (uses agentId as display name).
  *
- * @param toolName - Raw tool name (may include prefixes like "custom--")
+ * @param toolName - Tool name (local tool id or `mcp--...`)
  * @param args - Tool arguments object
  * @returns Formatted header components and full string
  */
-export declare function formatToolHeader(toolName: string, args?: Record<string, unknown>): FormattedToolHeader;
-/**
- * Formats tool arguments for display.
- * Format: ToolName(primary_arg) or ToolName(primary_arg, key: value)
- *
- * Uses tool-specific config to determine which args to show.
- * - File paths: converted to relative paths, center-truncated if needed
- * - Commands/URLs: shown in full (never truncated)
- * - Other args: truncated at 40 chars
- */
-export declare function formatToolArgsForDisplay(toolName: string, args: Record<string, unknown>): string;
-/**
- * Formats tool arguments for display (compact preview).
- * @deprecated Use formatToolArgsForDisplay instead
- */
-export declare function formatToolArgsPreview(args: Record<string, unknown>, maxLength?: number): string;
+export declare function formatToolHeader(options: {
+    toolName: string;
+    args: Record<string, unknown>;
+    presentationSnapshot?: ToolPresentationSnapshotV1;
+}): FormattedToolHeader;
 /**
  * Creates a user message
  */

package/dist/cli/ink-cli/utils/messageFormatting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messageFormatting.d.ts","sourceRoot":"","sources":["../../../../src/cli/ink-cli/utils/messageFormatting.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAyB,MAAM,aAAa,CAAC;AAEtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAyBjD;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAYpE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,CAmB1F;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAChC,YAAY,EAAE,MAAM,EACpB,QAAQ,GAAE,MAAW,EACrB,GAAG,GAAE,MAAsB,GAC5B,MAAM,CAWR;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiC7E;AAyGD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA6B3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA8BzD;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,aAAa,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,mBAAmB,CA+CrB;AA8BD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CA0EhG;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,SAAS,GAAE,MAAW,GACvB,MAAM,CAeR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAO1D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CASvF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAO5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAQjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAO3D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAQhD;AAgBD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAkC9D;AA+CD;;GAEG;AACH,wBAAgB,0BAA0B,CACtC,OAAO,EAAE,eAAe,EAAE,EAC1B,SAAS,EAAE,MAAM,GAClB,OAAO,EAAE,CA2GX;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;;;;;;;;GAmB/E"}
+{"version":3,"file":"messageFormatting.d.ts","sourceRoot":"","sources":["../../../../src/cli/ink-cli/utils/messageFormatting.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACR,UAAU,EACV,eAAe,EAGf,0BAA0B,EAC7B,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAIjD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO1D;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAMpE;AAiBD;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAYpE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,CAmB1F;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAChC,YAAY,EAAE,MAAM,EACpB,QAAQ,GAAE,MAAW,EACrB,GAAG,GAAE,MAAsB,GAC5B,MAAM,CAWR;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiC7E;AAgBD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWzD;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,aAAa,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;CACrD,GAAG,mBAAmB,CAuBtB;AAqBD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAO1D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CASvF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAO5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAQjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAO3D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAQhD;AAgBD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAkC9D;AA+CD;;GAEG;AACH,wBAAgB,0BAA0B,CACtC,OAAO,EAAE,eAAe,EAAE,EAC1B,SAAS,EAAE,MAAM,GAClB,OAAO,EAAE,CAgHX;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;;;;;;;;GAmB/E"}

package/dist/cli/ink-cli/utils/messageFormatting.js

@@ -6,12 +6,20 @@ import path from 'path';
 import os from 'os';
 import { isTextPart, isAssistantMessage, isToolMessage } from '@dexto/core';
 const HIDDEN_TOOL_NAMES = new Set(['wait_for']);
-const normalizeToolName = (toolName) => {
-    const stripped = toolName.replace(/^(?:internal--|internal__|custom--|custom__)/, '');
-    const delimiterSplit = stripped.split(/[:.]/);
-    return delimiterSplit[delimiterSplit.length - 1] ?? stripped;
-};
-const shouldHideTool = (toolName) => HIDDEN_TOOL_NAMES.has(normalizeToolName(toolName));
+export function normalizeToolName(toolName) {
+    if (toolName.startsWith('mcp--')) {
+        const trimmed = toolName.substring('mcp--'.length);
+        const parts = trimmed.split('--');
+        return parts.length >= 2 ? parts.slice(1).join('--') : trimmed;
+    }
+    return toolName;
+}
+export function shouldHideTool(toolName) {
+    if (!toolName) {
+        return false;
+    }
+    return HIDDEN_TOOL_NAMES.has(normalizeToolName(toolName));
+}
 const backgroundCompletionRegex = /<background-task-completion>[\s\S]*?<\/background-task-completion>/g;
 const stripBackgroundCompletion = (text) => text.replace(backgroundCompletionRegex, '').replace('<background-task-completion>', '').trim();
 import { generateMessageId } from './idGenerator.js';
@@ -123,75 +131,10 @@ export function centerTruncatePath(filePath, maxWidth) {
     // Filename itself is too long, end-truncate it
     return filename.slice(0, maxWidth - 1) + '…';
 }
-/**
- * Per-tool display configurations.
- * Each tool specifies exactly which arguments to show and how.
- */
-const TOOL_CONFIGS = {
-    // File tools - show file_path as primary
-    read_file: { displayName: 'Read', argsToShow: ['file_path'], primaryArg: 'file_path' },
-    write_file: { displayName: 'Write', argsToShow: ['file_path'], primaryArg: 'file_path' },
-    edit_file: { displayName: 'Update', argsToShow: ['file_path'], primaryArg: 'file_path' },
-    // Search tools - show pattern as primary, path as secondary
-    glob_files: {
-        displayName: 'Find files',
-        argsToShow: ['pattern', 'path'],
-        primaryArg: 'pattern',
-    },
-    grep_content: {
-        displayName: 'Search files',
-        argsToShow: ['pattern', 'path'],
-        primaryArg: 'pattern',
-    },
-    // Bash - show command only, skip description
-    bash_exec: { displayName: 'Bash', argsToShow: ['command'], primaryArg: 'command' },
-    bash_output: {
-        displayName: 'BashOutput',
-        argsToShow: ['process_id'],
-        primaryArg: 'process_id',
-    },
-    kill_process: { displayName: 'Kill', argsToShow: ['process_id'], primaryArg: 'process_id' },
-    // User interaction
-    ask_user: { displayName: 'Ask', argsToShow: ['question'], primaryArg: 'question' },
-    // Agent spawning - handled specially in formatToolHeader for dynamic agentId
-    spawn_agent: { displayName: 'Agent', argsToShow: ['task'], primaryArg: 'task' },
-    // Skill invocation - handled specially in formatToolHeader to show clean skill name
-    invoke_skill: { displayName: 'Skill', argsToShow: ['skill'], primaryArg: 'skill' },
-    plan_create: { displayName: 'Plan', argsToShow: [] },
-    plan_read: { displayName: 'Plan', argsToShow: [] },
-    plan_update: { displayName: 'Plan', argsToShow: [] },
-    plan_review: { displayName: 'Plan', argsToShow: [] },
-    wait_for: { displayName: 'Wait', argsToShow: ['taskId', 'taskIds', 'mode'] },
-    check_task: { displayName: 'CheckTask', argsToShow: ['taskId'] },
-    list_tasks: { displayName: 'ListTasks', argsToShow: ['status', 'type'] },
-    todo_write: { displayName: 'UpdateTasks', argsToShow: [] },
-};
-/**
- * Gets the display config for a tool.
- * Handles internal-- prefix by stripping it before lookup.
- */
-function getToolConfig(toolName) {
-    // Try direct lookup first
-    if (TOOL_CONFIGS[toolName]) {
-        return TOOL_CONFIGS[toolName];
-    }
-    // Strip internal-- prefix and try again
-    if (toolName.startsWith('internal--')) {
-        const baseName = toolName.replace('internal--', '');
-        return TOOL_CONFIGS[baseName];
-    }
-    // Strip "custom--" prefix and try again
-    if (toolName.startsWith('custom--')) {
-        const baseName = toolName.replace('custom--', '');
-        return TOOL_CONFIGS[baseName];
-    }
-    return undefined;
-}
 /**
  * Gets a user-friendly display name for a tool.
- * Returns the friendly name if known, otherwise returns the original name
- * with any "internal--" prefix stripped.
- * MCP tools keep their server prefix for clarity (e.g., "mcp_server__tool").
+ * Returns the friendly name if known, otherwise returns a title-cased version.
+ * MCP tools keep their server prefix for clarity (e.g., "mcp--filesystem--read_file").
  */
 function toTitleCase(name) {
     return name
@@ -202,19 +145,7 @@ function toTitleCase(name) {
         .join(' ');
 }
 export function getToolDisplayName(toolName) {
-    const config = getToolConfig(toolName);
-    if (config) {
-        return config.displayName;
-    }
-    // Strip "internal--" prefix for unknown internal tools
-    if (toolName.startsWith('internal--')) {
-        return toTitleCase(toolName.replace('internal--', ''));
-    }
-    // Strip "custom--" prefix for custom tools
-    if (toolName.startsWith('custom--')) {
-        return toTitleCase(toolName.replace('custom--', ''));
-    }
-    // MCP tools: strip mcp-- or mcp__ prefix and server name for clean display
+    // MCP tools: strip `mcp--` prefix and server name for clean display
     if (toolName.startsWith('mcp--')) {
         const parts = toolName.split('--');
         if (parts.length >= 3) {
@@ -222,24 +153,13 @@ export function getToolDisplayName(toolName) {
         }
         return toTitleCase(toolName.substring(5));
     }
-    if (toolName.startsWith('mcp__')) {
-        const parts = toolName.substring(5).split('__');
-        if (parts.length >= 2) {
-            return toTitleCase(parts.slice(1).join('__'));
-        }
-        return toTitleCase(toolName.substring(5));
-    }
     return toTitleCase(toolName);
 }
 /**
  * Gets the tool type badge for display.
- * Returns: 'internal', MCP server name, or 'custom'
+ * Returns: 'local' or MCP server name.
  */
 export function getToolTypeBadge(toolName) {
-    // Internal tools
-    if (toolName.startsWith('internal--') || toolName.startsWith('internal__')) {
-        return 'internal';
-    }
     // MCP tools with server name
     if (toolName.startsWith('mcp--')) {
         const parts = toolName.split('--');
@@ -248,19 +168,7 @@ export function getToolTypeBadge(toolName) {
         }
         return 'MCP';
     }
-    if (toolName.startsWith('mcp__')) {
-        const parts = toolName.substring(5).split('__');
-        if (parts.length >= 2 && parts[0]) {
-            return `MCP: ${parts[0]}`; // Format: 'MCP: servername'
-        }
-        return 'MCP';
-    }
-    // Custom tools
-    if (toolName.startsWith('custom--')) {
-        return 'custom';
-    }
-    // Unknown - likely custom
-    return 'custom';
+    return 'local';
 }
 /**
  * Formats a tool call header for consistent display across CLI.
@@ -268,38 +176,16 @@ export function getToolTypeBadge(toolName) {
  *
  * Handles special cases like spawn_agent (uses agentId as display name).
  *
- * @param toolName - Raw tool name (may include prefixes like "custom--")
+ * @param toolName - Tool name (local tool id or `mcp--...`)
  * @param args - Tool arguments object
  * @returns Formatted header components and full string
  */
-export function formatToolHeader(toolName, args = {}) {
-    let displayName = getToolDisplayName(toolName);
-    const argsFormatted = formatToolArgsForDisplay(toolName, args);
+export function formatToolHeader(options) {
+    const { toolName, args, presentationSnapshot } = options;
+    const snapshotHeader = presentationSnapshot?.header;
+    const displayName = snapshotHeader?.title ?? getToolDisplayName(toolName);
+    const argsFormatted = snapshotHeader?.argsText ?? formatArgsFallback(args);
     const badge = getToolTypeBadge(toolName);
-    // Normalize tool name to handle all prefixes (internal--, custom--)
-    const normalizedToolName = toolName.replace(/^(?:internal--|custom--)/, '');
-    // Special handling for spawn_agent: use agentId as display name
-    const isSpawnAgent = normalizedToolName === 'spawn_agent';
-    if (isSpawnAgent && args.agentId) {
-        const agentId = String(args.agentId);
-        const agentLabel = agentId.replace(/-agent$/, '');
-        displayName = agentLabel.charAt(0).toUpperCase() + agentLabel.slice(1);
-    }
-    // Special handling for invoke_skill: show skill as /skill-name
-    const isInvokeSkill = normalizedToolName === 'invoke_skill';
-    if (isInvokeSkill && args.skill) {
-        const skillName = String(args.skill);
-        // Extract display name from skill identifier (e.g., "config:test-fork" -> "test-fork")
-        const colonIndex = skillName.indexOf(':');
-        const displaySkillName = colonIndex >= 0 ? skillName.slice(colonIndex + 1) : skillName;
-        // Override args display to show clean slash command format
-        return {
-            displayName: 'Skill',
-            argsFormatted: `/${displaySkillName}`,
-            badge,
-            header: `Skill(/${displaySkillName})`,
-        };
-    }
     // Only show badge for MCP tools (external tools worth distinguishing)
     const isMcpTool = badge.startsWith('MCP');
     const badgeSuffix = isMcpTool ? ` [${badge}]` : '';
@@ -315,129 +201,20 @@ export function formatToolHeader(toolName, args = {}) {
     };
 }
 /**
- * Fallback primary argument names for unknown tools.
- * Used when we don't have a specific config for a tool.
+ * Simple fallback for formatting tool args when no snapshot is provided.
+ * Used for MCP tools that don't implement tool header snapshots.
  */
-const FALLBACK_PRIMARY_ARGS = new Set([
-    'file_path',
-    'path',
-    'pattern',
-    'command',
-    'query',
-    'question',
-    'url',
-]);
-/**
- * Arguments that are file paths and should use relative path formatting.
- * These get converted to relative paths and center-truncated if needed.
- */
-const PATH_ARGS = new Set(['file_path', 'path']);
-/**
- * Arguments that should never be truncated (urls, task descriptions, etc.)
- * These provide important context that users need to see in full.
- * Note: 'command' is handled specially - single-line commands are not truncated,
- * but multi-line commands (heredocs) are truncated to first line only.
- */
-const NEVER_TRUNCATE_ARGS = new Set(['url', 'task', 'pattern', 'question']);
-/**
- * Formats tool arguments for display.
- * Format: ToolName(primary_arg) or ToolName(primary_arg, key: value)
- *
- * Uses tool-specific config to determine which args to show.
- * - File paths: converted to relative paths, center-truncated if needed
- * - Commands/URLs: shown in full (never truncated)
- * - Other args: truncated at 40 chars
- */
-export function formatToolArgsForDisplay(toolName, args) {
-    const entries = Object.entries(args);
-    if (entries.length === 0)
-        return '';
-    const config = getToolConfig(toolName);
-    const parts = [];
-    /**
-     * Format a single argument value for display
-     */
-    const formatArgValue = (argName, value) => {
-        const strValue = typeof value === 'string' ? value : JSON.stringify(value);
-        // File paths: use relative path (no truncation)
-        if (PATH_ARGS.has(argName)) {
-            return makeRelativePath(strValue);
-        }
-        // Commands: show single-line in full, truncate multi-line (heredocs) to first line
-        if (argName === 'command') {
-            const newlineIndex = strValue.indexOf('\n');
-            if (newlineIndex === -1) {
-                // Single-line command: show in full (useful for complex pipes)
-                return strValue;
-            }
-            // Multi-line command (heredoc): show first line only
-            return strValue.slice(0, newlineIndex) + '...';
-        }
-        // URLs: never truncate
-        if (NEVER_TRUNCATE_ARGS.has(argName)) {
-            return strValue;
-        }
-        // Other args: simple truncation
-        return strValue.length > 40 ? strValue.slice(0, 37) + '...' : strValue;
-    };
-    if (config) {
-        // Use tool-specific config
-        for (const argName of config.argsToShow) {
-            if (!(argName in args))
-                continue;
-            if (argName === 'description')
-                continue; // Skip description field
-            if (parts.length >= 3)
-                break;
-            const formattedValue = formatArgValue(argName, args[argName]);
-            if (argName === config.primaryArg) {
-                // Primary arg without key name
-                parts.unshift(formattedValue);
-            }
-            else {
-                // Secondary args with key name
-                parts.push(`${argName}: ${formattedValue}`);
-            }
-        }
-    }
-    else {
-        // Fallback for unknown tools (MCP, etc.)
-        for (const [key, value] of entries) {
-            if (key === 'description')
-                continue; // Skip description field
-            if (parts.length >= 3)
-                break;
-            const formattedValue = formatArgValue(key, value);
-            if (FALLBACK_PRIMARY_ARGS.has(key) || PATH_ARGS.has(key)) {
-                // Primary arg without key name
-                parts.unshift(formattedValue);
-            }
-            else {
-                // Other args with key name
-                parts.push(`${key}: ${formattedValue}`);
-            }
-        }
-    }
-    return parts.join(', ');
-}
-/**
- * Formats tool arguments for display (compact preview).
- * @deprecated Use formatToolArgsForDisplay instead
- */
-export function formatToolArgsPreview(args, maxLength = 60) {
-    const entries = Object.entries(args);
-    if (entries.length === 0)
-        return '';
-    // Show key parameters in a compact format
-    const preview = entries
-        .slice(0, 3) // Max 3 params
-        .map(([key, value]) => {
-        const strValue = typeof value === 'string' ? value : JSON.stringify(value);
-        const truncated = strValue.length > 30 ? strValue.slice(0, 27) + '...' : strValue;
-        return `${key}: "${truncated}"`;
+function formatArgsFallback(args) {
+    const entries = Object.entries(args)
+        .filter(([k]) => !['__meta', 'description'].includes(k))
+        .slice(0, 4);
+    const str = entries
+        .map(([k, v]) => {
+        const val = typeof v === 'string' ? v : JSON.stringify(v);
+        return val.length > 50 ? `${k}=${val.slice(0, 47)}...` : `${k}=${val}`;
     })
         .join(', ');
-    return preview.length > maxLength ? preview.slice(0, maxLength - 3) + '...' : preview;
+    return str.length > 150 ? str.slice(0, 147) + '...' : str;
 }
 /**
  * Creates a user message
@@ -607,13 +384,17 @@ export function convertHistoryToUIMessages(history, sessionId) {
             // Look up the original tool call to get args
             const toolCall = toolCallMap.get(msg.toolCallId);
             // Format tool name
-            const displayName = getToolDisplayName(msg.name);
+            const displayName = msg.presentationSnapshot?.header?.title ?? getToolDisplayName(msg.name);
             // Format args if we have them
             let toolContent = displayName;
-            if (toolCall) {
+            const snapshotArgsText = msg.presentationSnapshot?.header?.argsText;
+            if (typeof snapshotArgsText === 'string' && snapshotArgsText.length > 0) {
+                toolContent = `${displayName}(${snapshotArgsText})`;
+            }
+            if (!snapshotArgsText && toolCall) {
                 try {
                     const args = JSON.parse(toolCall.function.arguments || '{}');
-                    const argsFormatted = formatToolArgsForDisplay(msg.name, args);
+                    const argsFormatted = formatArgsFallback(args);
                     if (argsFormatted) {
                         toolContent = `${displayName}(${argsFormatted})`;
                     }

package/dist/cli/ink-cli/utils/overlayPresentation.d.ts

@@ -0,0 +1,19 @@
+import type { OverlayType } from '../state/types.js';
+import type { ApprovalRequest } from '../components/ApprovalPrompt.js';
+export type OverlayPresentation = 'none' | 'inline' | 'focus';
+/**
+ * Determine how an overlay/approval should be presented in the CLI.
+ *
+ * - `inline`: small overlays that keep the main input visible (e.g. autocomplete)
+ * - `focus`: overlays/approvals that should take focus and hide UI chrome (input + footer)
+ */
+export declare function getOverlayPresentation(activeOverlay: OverlayType, approval: ApprovalRequest | null): OverlayPresentation;
+export declare function shouldHideCliChrome(activeOverlay: OverlayType, approval: ApprovalRequest | null): boolean;
+/**
+ * Hide "always-on" chrome (status bar, panels, footer) whenever any overlay is visible.
+ *
+ * This keeps inline overlays (like slash/resource autocomplete) from competing for scarce
+ * terminal rows, and reduces flicker by keeping the total rendered height stable.
+ */
+export declare function shouldHideStatusChrome(activeOverlay: OverlayType, approval: ApprovalRequest | null): boolean;
+//# sourceMappingURL=overlayPresentation.d.ts.map

package/dist/cli/ink-cli/utils/overlayPresentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlayPresentation.d.ts","sourceRoot":"","sources":["../../../../src/cli/ink-cli/utils/overlayPresentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAO9D;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAClC,aAAa,EAAE,WAAW,EAC1B,QAAQ,EAAE,eAAe,GAAG,IAAI,GACjC,mBAAmB,CAMrB;AAED,wBAAgB,mBAAmB,CAC/B,aAAa,EAAE,WAAW,EAC1B,QAAQ,EAAE,eAAe,GAAG,IAAI,GACjC,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAClC,aAAa,EAAE,WAAW,EAC1B,QAAQ,EAAE,eAAe,GAAG,IAAI,GACjC,OAAO,CAGT"}

package/dist/cli/ink-cli/utils/overlayPresentation.js

@@ -0,0 +1,33 @@
+const INLINE_OVERLAYS = new Set([
+    'slash-autocomplete',
+    'resource-autocomplete',
+]);
+/**
+ * Determine how an overlay/approval should be presented in the CLI.
+ *
+ * - `inline`: small overlays that keep the main input visible (e.g. autocomplete)
+ * - `focus`: overlays/approvals that should take focus and hide UI chrome (input + footer)
+ */
+export function getOverlayPresentation(activeOverlay, approval) {
+    if (approval)
+        return 'focus';
+    if (activeOverlay === 'none')
+        return 'none';
+    if (INLINE_OVERLAYS.has(activeOverlay))
+        return 'inline';
+    return 'focus';
+}
+export function shouldHideCliChrome(activeOverlay, approval) {
+    return getOverlayPresentation(activeOverlay, approval) === 'focus';
+}
+/**
+ * Hide "always-on" chrome (status bar, panels, footer) whenever any overlay is visible.
+ *
+ * This keeps inline overlays (like slash/resource autocomplete) from competing for scarce
+ * terminal rows, and reduces flicker by keeping the total rendered height stable.
+ */
+export function shouldHideStatusChrome(activeOverlay, approval) {
+    if (approval)
+        return true;
+    return activeOverlay !== 'none';
+}

package/dist/cli/ink-cli/utils/overlaySizing.d.ts

@@ -0,0 +1,19 @@
+export interface ListViewportSizingOptions {
+    /** Total terminal rows. */
+    rows: number;
+    /** Maximum number of rows/items to ever render for the list. */
+    hardCap: number;
+    /**
+     * Rows to keep free for surrounding UI/chrome.
+     * Claude Code commonly uses ~6 rows of slack to avoid Ink hitting the clear+redraw path.
+     */
+    reservedRows?: number;
+    /** Minimum rows/items to render when possible. */
+    minVisibleItems?: number;
+}
+/**
+ * Compute a safe "max visible items" count for list UIs so we don't render content that
+ * approaches/exceeds the terminal height (which can cause Ink to clear + redraw, i.e. flicker).
+ */
+export declare function getMaxVisibleItemsForTerminalRows({ rows, hardCap, reservedRows, minVisibleItems, }: ListViewportSizingOptions): number;
+//# sourceMappingURL=overlaySizing.d.ts.map

package/dist/cli/ink-cli/utils/overlaySizing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlaySizing.d.ts","sourceRoot":"","sources":["../../../../src/cli/ink-cli/utils/overlaySizing.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,yBAAyB;IACtC,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAAC,EAC9C,IAAI,EACJ,OAAO,EACP,YAAgB,EAChB,eAAmB,GACtB,EAAE,yBAAyB,GAAG,MAAM,CAOpC"}

package/dist/cli/ink-cli/utils/overlaySizing.js

@@ -0,0 +1,11 @@
+/**
+ * Compute a safe "max visible items" count for list UIs so we don't render content that
+ * approaches/exceeds the terminal height (which can cause Ink to clear + redraw, i.e. flicker).
+ */
+export function getMaxVisibleItemsForTerminalRows({ rows, hardCap, reservedRows = 6, minVisibleItems = 1, }) {
+    const available = Math.max(0, rows - reservedRows);
+    if (available <= 0) {
+        return 1;
+    }
+    return Math.max(minVisibleItems, Math.min(hardCap, available));
+}

package/dist/cli/ink-cli/utils/soundNotification.d.ts

@@ -4,13 +4,17 @@
  * Plays system sounds for CLI notifications like approval requests and task completion.
  * Uses platform-specific commands with fallback to terminal bell.
  *
- * Sound files should be placed in ~/.dexto/sounds/ or use system defaults.
+ * Sound files should be placed in the Dexto sounds directory (typically ~/.dexto/sounds/).
+ * In dexto source + DEXTO_DEV_MODE=true, this uses <repo>/.dexto/sounds/ for isolated dev.
  */
-export type SoundType = 'approval' | 'complete';
+export type SoundType = 'startup' | 'approval' | 'complete';
+export declare const CUSTOM_SOUND_EXTENSIONS: readonly [".wav", ".mp3", ".ogg", ".oga", ".aiff", ".m4a"];
+export declare function getDefaultSoundSpec(soundType: SoundType): string | null;
+export declare function playSoundFile(soundPath: string): void;
 /**
  * Play a notification sound
  *
- * @param soundType - Type of sound to play ('approval' or 'complete')
+ * @param soundType - Type of sound to play ('startup', 'approval', or 'complete')
  *
  * @example
  * ```typescript
@@ -19,9 +23,12 @@ export type SoundType = 'approval' | 'complete';
  *
  * // Play task complete sound
  * playNotificationSound('complete');
+ *
+ * // Play startup sound
+ * playNotificationSound('startup');
  * ```
  */
-export declare function playNotificationSound(soundType: SoundType): void;
+export declare function playNotificationSound(soundType: SoundType, config?: SoundConfig): void;
 /**
  * Sound configuration interface
  *
@@ -30,8 +37,12 @@ export declare function playNotificationSound(soundType: SoundType): void;
  */
 export interface SoundConfig {
     enabled: boolean;
+    onStartup: boolean;
+    startupSoundFile?: string | undefined;
     onApprovalRequired: boolean;
+    approvalSoundFile?: string | undefined;
     onTaskComplete: boolean;
+    completeSoundFile?: string | undefined;
 }
 /**
  * Sound notification service that respects configuration
@@ -50,6 +61,10 @@ export declare class SoundNotificationService {
      * Get current configuration
      */
     getConfig(): SoundConfig;
+    /**
+     * Play CLI startup sound if enabled
+     */
+    playStartupSound(): void;
     /**
      * Play approval required sound if enabled
      */
@@ -59,13 +74,4 @@ export declare class SoundNotificationService {
      */
     playCompleteSound(): void;
 }
-/**
- * Get the global sound notification service
- * @returns The global service, or null if not initialized
- */
-export declare function getSoundService(): SoundNotificationService | null;
-/**
- * Initialize the global sound service with configuration
- */
-export declare function initializeSoundService(config: SoundConfig): SoundNotificationService;
 //# sourceMappingURL=soundNotification.d.ts.map

package/dist/cli/ink-cli/utils/soundNotification.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"soundNotification.d.ts","sourceRoot":"","sources":["../../../../src/cli/ink-cli/utils/soundNotification.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAqGhD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAiChE;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;GAKG;AACH,qBAAa,wBAAwB;IACjC,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,EAAE,WAAW;IAI/B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAI7C;;OAEG;IACH,SAAS,IAAI,WAAW;IAIxB;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAMzB;;OAEG;IACH,iBAAiB,IAAI,IAAI;CAK5B;AAQD;;;GAGG;AACH,wBAAgB,eAAe,IAAI,wBAAwB,GAAG,IAAI,CAEjE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,wBAAwB,CAGpF"}
+{"version":3,"file":"soundNotification.d.ts","sourceRoot":"","sources":["../../../../src/cli/ink-cli/utils/soundNotification.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAE5D,eAAO,MAAM,uBAAuB,4DAA6D,CAAC;AAsDlG,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAOvE;AA2ED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAErD;AA4BD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAQtF;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED;;;;;GAKG;AACH,qBAAa,wBAAwB;IACjC,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,EAAE,WAAW;IAI/B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAI7C;;OAEG;IACH,SAAS,IAAI,WAAW;IAIxB;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAMxB;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAMzB;;OAEG;IACH,iBAAiB,IAAI,IAAI;CAK5B"}