@dexto/core 1.6.0 → 1.6.1

package/dist/tools/types.d.ts

@@ -86,24 +86,113 @@ export interface ToolExecutionContext extends ToolExecutionContextBase {
 export interface ToolExecutionResult {
     /** The actual result data from tool execution */
     result: unknown;
-    /** Optional display name for the tool (UI convenience) */
-    toolDisplayName?: string;
+    /** Optional UI-agnostic presentation snapshot for this call/result */
+    presentationSnapshot?: ToolPresentationSnapshotV1;
     /** Whether this tool required user approval before execution */
     requireApproval?: boolean;
     /** The approval status (only present if requireApproval is true) */
     approvalStatus?: 'approved' | 'rejected';
 }
+/**
+ * UI-agnostic, runtime-computed presentation snapshot for tool calls/approvals/results.
+ *
+ * This is intended to decouple UIs (CLI/WebUI) from tool-specific heuristics (toolName parsing,
+ * hardcoded argument omission, etc.). It must remain:
+ * - JSON-serializable (plain objects/arrays/strings/numbers/booleans/null)
+ * - Optional everywhere (UIs MUST fall back to generic defaults when absent)
+ * - Forward-compatible (UIs MUST ignore unknown fields)
+ *
+ * SECURITY: Do not include secrets (tokens, full file contents, credentials). Prefer previews via
+ * {@link ToolDisplayData} for large content and rely on UIs to render those previews.
+ */
+export type ToolPresentationSnapshotV1 = {
+    version: 1;
+    /** Optional source information (prevents UIs from parsing tool ids like `mcp--server--tool`). */
+    source?: {
+        type: 'local' | 'mcp';
+        mcpServerName?: string;
+    };
+    /** Optional one-line identity of the call (used for headers/timelines). */
+    header?: {
+        title?: string;
+        /**
+         * Pre-formatted one-line call detail shown in parentheses.
+         * Example: `Read(/path/to/file.ts)` where argsText is `/path/to/file.ts`.
+         */
+        argsText?: string;
+    };
+    /** Compact semantic tags. Use sparingly to avoid UI noise. */
+    chips?: Array<{
+        kind: 'neutral' | 'info' | 'warning' | 'danger' | 'success';
+        text: string;
+    }>;
+    /** Human-facing argument presentation. Prefer `display` over leaking raw values. */
+    args?: {
+        summary?: Array<{
+            label: string;
+            display: string;
+            kind?: 'path' | 'command' | 'url' | 'text' | 'json';
+            sensitive?: boolean;
+        }>;
+        groups?: Array<{
+            id: string;
+            label: string;
+            collapsedByDefault?: boolean;
+            items: Array<{
+                label: string;
+                display: string;
+                kind?: 'path' | 'command' | 'url' | 'text' | 'json';
+                sensitive?: boolean;
+            }>;
+        }>;
+    };
+    /** Optional capabilities that UIs may use to enable modes without toolName branching. */
+    capabilities?: string[];
+    /** Optional approval UX hints. If absent, UIs use their existing generic approval flows. */
+    approval?: {
+        actions?: Array<{
+            id: string;
+            label: string;
+            kind?: 'primary' | 'secondary' | 'danger';
+            responseData?: Record<string, unknown>;
+            uiEffects?: UiEffect[];
+        } | {
+            id: string;
+            label: string;
+            kind?: 'danger';
+            denyWithFeedback?: {
+                placeholder?: string;
+                messageTemplate?: string;
+            };
+        }>;
+    };
+    /** Optional post-result presentation and UI effects. */
+    result?: {
+        summaryText?: string;
+        uiEffects?: UiEffect[];
+    };
+};
+/**
+ * Optional, UI-local side effects driven by tool approvals/results.
+ *
+ * UIs MAY ignore these. They are intended to replace toolName-based UI logic (plan mode, accept
+ * edits mode, etc.) with declarative data.
+ */
+export type UiEffect = {
+    type: 'setFlag';
+    flag: 'autoApproveEdits' | 'planModeActive' | 'planModeInitialized';
+    value: boolean;
+} | {
+    type: 'toast';
+    kind: 'info' | 'warning' | 'success' | 'error';
+    message: string;
+};
 /**
  * Tool interface - for tools implemented within Dexto
  */
 export interface Tool<TSchema extends ZodTypeAny = ZodTypeAny> {
     /** Unique identifier for the tool */
     id: string;
-    /**
-     * Short, user-facing name for this tool (UI convenience).
-     * Defaults to a title-cased version of {@link id} when omitted.
-     */
-    displayName?: string | undefined;
     /** Human-readable description of what the tool does */
     description: string;
     /** Zod schema defining the input parameters */
@@ -111,11 +200,13 @@ export interface Tool<TSchema extends ZodTypeAny = ZodTypeAny> {
     /** The actual function that executes the tool - input is validated by Zod before execution */
     execute(input: z.output<TSchema>, context: ToolExecutionContext): Promise<unknown> | unknown;
     /**
-     * Optional preview generator for approval UI.
-     * Called before requesting user approval to generate display data (e.g., diff preview).
-     * Returns null if no preview is available.
+     * Optional grouped approval-related behavior.
      */
-    generatePreview?(input: z.output<TSchema>, context: ToolExecutionContext): Promise<ToolDisplayData | null>;
+    approval?: ToolApproval<TSchema> | undefined;
+    /**
+     * Optional grouped UI/presentation-related behavior.
+     */
+    presentation?: ToolPresentation<TSchema> | undefined;
     /**
      * Optional aliases for this tool id.
      *
@@ -124,64 +215,52 @@ export interface Tool<TSchema extends ZodTypeAny = ZodTypeAny> {
      * by {@link ToolManager} when applying session auto-approve lists.
      */
     aliases?: string[] | undefined;
+}
+export interface ToolApproval<TSchema extends ZodTypeAny = ZodTypeAny> {
+    override?(input: z.output<TSchema>, context: ToolExecutionContext): Promise<ApprovalRequestDetails | null> | ApprovalRequestDetails | null;
+    onGranted?(response: ApprovalResponse, context: ToolExecutionContext, approvalRequest: ApprovalRequestDetails): Promise<void> | void;
+    patternKey?(input: z.output<TSchema>): string | null;
+    suggestPatterns?(input: z.output<TSchema>): string[];
+}
+export interface ToolPresentation<TSchema extends ZodTypeAny = ZodTypeAny> {
     /**
-     * Optional pattern key generator for approval memory.
-     *
-     * If provided, ToolManager will:
-     * - Skip confirmation when the pattern key is covered by previously approved patterns.
-     * - Offer suggested patterns (if {@link suggestApprovalPatterns} is provided) in the approval UI.
+     * Optional rich preview used in approval prompts.
      *
-     * Return null to disable pattern approvals for the given input (e.g. dangerous commands).
+     * CLI example:
+     * - `edit_file` / `write_file`: shows a diff preview
+     * - `bash_exec`: shows a shell command preview
+     * - `plan_review`: shows the plan as a file preview
      */
-    getApprovalPatternKey?(input: z.output<TSchema>): string | null;
+    preview?(input: z.output<TSchema>, context: ToolExecutionContext): Promise<ToolDisplayData | null> | ToolDisplayData | null;
     /**
-     * Optional pattern suggestions for the approval UI.
+     * Describe the one-line tool call header for timelines and approval prompts.
      *
-     * Returned patterns are shown as quick "remember pattern" options.
+     * CLI example:
+     * - Tool message header line: `Read(src/app.ts)`
+     * - Here: header.title = "Read", header.argsText = "src/app.ts"
      */
-    suggestApprovalPatterns?(input: z.output<TSchema>): string[];
+    describeHeader?(input: z.output<TSchema>, context: ToolExecutionContext): Promise<ToolPresentationSnapshotV1['header'] | null> | ToolPresentationSnapshotV1['header'] | null;
     /**
-     * Optional custom approval override.
-     * If present and returns non-null, this approval request is used instead of
-     * the default tool confirmation. Allows tools to request specialized approval
-     * flows (e.g., directory access approval for file tools).
+     * Describe structured argument presentation for this tool call.
      *
-     * @param input The validated input arguments for the tool
-     * @returns ApprovalRequestDetails for custom approval, or null to use default tool confirmation
+     * Not currently rendered by the Ink CLI, but intended for future "expanded transcript"
+     * views (e.g. Ctrl+O to inspect call details) and WebUI.
      *
-     * @example
-     * ```typescript
-     * // File tool requesting directory access approval for external paths
-     * getApprovalOverride: async (input) => {
-     *   const filePath = (input as {file_path: string}).file_path;
-     *   if (!await isPathWithinAllowed(filePath)) {
-     *     return {
-     *       type: ApprovalType.DIRECTORY_ACCESS,
-     *       metadata: { path: filePath, operation: 'read', ... }
-     *     };
-     *   }
-     *   return null; // Use default tool confirmation
-     * }
-     * ```
+     * Example (expanded details):
+     * - label: "method", display: "POST"
+     * - label: "timeout", display: "30s"
      */
-    getApprovalOverride?(input: z.output<TSchema>, context: ToolExecutionContext): Promise<ApprovalRequestDetails | null> | ApprovalRequestDetails | null;
+    describeArgs?(input: z.output<TSchema>, context: ToolExecutionContext): Promise<ToolPresentationSnapshotV1['args'] | null> | ToolPresentationSnapshotV1['args'] | null;
     /**
-     * Optional callback invoked when custom approval is granted.
-     * Allows tools to handle approval responses (e.g., remember approved directories).
-     * Only called when getApprovalOverride returned non-null and approval was granted.
+     * Describe a short post-execution summary.
      *
-     * @param response The approval response from ApprovalManager
+     * CLI example:
+     * - Tool result preview line (when supported): "Wrote 3 files" or "Request failed: 401"
      *
-     * @example
-     * ```typescript
-     * onApprovalGranted: (response) => {
-     *   if (response.data?.rememberDirectory) {
-     *     directoryApproval.addApproved(parentDir, 'session');
-     *   }
-     * }
-     * ```
+     * Note: This does not change the tool's actual returned data; it only affects optional
+     * presentation metadata.
      */
-    onApprovalGranted?(response: ApprovalResponse, context: ToolExecutionContext, approvalRequest: ApprovalRequestDetails): void;
+    describeResult?(result: unknown, input: z.output<TSchema>, context: ToolExecutionContext): Promise<ToolPresentationSnapshotV1['result'] | null> | ToolPresentationSnapshotV1['result'] | null;
 }
 /**
  * Standard tool set interface - used by AI/LLM services

package/dist/tools/types.d.ts.map

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

package/dist/utils/path.cjs

@@ -79,6 +79,15 @@ function getDextoPath(type, filename, startPath) {
   return filename ? path.join(basePath, filename) : basePath;
 }
 function getDextoGlobalPath(type, filename) {
+  const isDevMode = process.env.DEXTO_DEV_MODE === "true";
+  if (isDevMode && (0, import_execution_context.getExecutionContext)() === "dexto-source") {
+    const sourceRoot = (0, import_execution_context.findDextoSourceRoot)();
+    if (!sourceRoot) {
+      throw new Error("Not in dexto source context");
+    }
+    const devBasePath = path.join(sourceRoot, ".dexto", type);
+    return filename ? path.join(devBasePath, filename) : devBasePath;
+  }
   const basePath = path.join((0, import_os.homedir)(), ".dexto", type);
   return filename ? path.join(basePath, filename) : basePath;
 }
@@ -108,7 +117,7 @@ function findPackageRoot(startPath = process.cwd()) {
   });
 }
 async function ensureDextoGlobalDirectory() {
-  const dextoDir = path.join((0, import_os.homedir)(), ".dexto");
+  const dextoDir = getDextoGlobalPath("");
   try {
     await import_fs2.promises.mkdir(dextoDir, { recursive: true });
   } catch (error) {

package/dist/utils/path.d.ts

@@ -13,8 +13,11 @@ import type { Logger } from '../logger/v2/types.js';
  */
 export declare function getDextoPath(type: string, filename?: string, startPath?: string): string;
 /**
- * Global path resolver that ALWAYS returns paths in the user's home directory
- * Used for agent registry and other global-only resources that should not be project-relative
+ * Global path resolver for user-global resources that should not be project-relative.
+ *
+ * Dev mode support:
+ * - dexto-source + DEXTO_DEV_MODE=true: Use repo-local `.dexto` (isolated testing)
+ * - otherwise: Use global `~/.dexto` (user experience)
  * @param type Path type (agents, cache, etc.)
  * @param filename Optional filename to append
  * @returns Absolute path to the global location (~/.dexto/...)

package/dist/utils/path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAuCxF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAI1E;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAe5E;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAW3C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAKhF;AAMD;;GAEG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC,CAUhE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,SAAS,GAAE,MAAsB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAkC1F"}
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAuCxF;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAc1E;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAe5E;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAW3C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAKhF;AAMD;;GAEG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC,CAUhE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,SAAS,GAAE,MAAsB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAkC1F"}

package/dist/utils/path.js

@@ -45,6 +45,15 @@ function getDextoPath(type, filename, startPath) {
   return filename ? path.join(basePath, filename) : basePath;
 }
 function getDextoGlobalPath(type, filename) {
+  const isDevMode = process.env.DEXTO_DEV_MODE === "true";
+  if (isDevMode && getExecutionContext() === "dexto-source") {
+    const sourceRoot = findDextoSourceRoot();
+    if (!sourceRoot) {
+      throw new Error("Not in dexto source context");
+    }
+    const devBasePath = path.join(sourceRoot, ".dexto", type);
+    return filename ? path.join(devBasePath, filename) : devBasePath;
+  }
   const basePath = path.join(homedir(), ".dexto", type);
   return filename ? path.join(basePath, filename) : basePath;
 }
@@ -74,7 +83,7 @@ function findPackageRoot(startPath = process.cwd()) {
   });
 }
 async function ensureDextoGlobalDirectory() {
-  const dextoDir = path.join(homedir(), ".dexto");
+  const dextoDir = getDextoGlobalPath("");
   try {
     await fs.mkdir(dextoDir, { recursive: true });
   } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dexto/core",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -123,7 +123,7 @@
   },
   "sideEffects": false,
   "scripts": {
-    "build": "cross-env NODE_OPTIONS='--max-old-space-size=4096' tsup && cross-env NODE_OPTIONS='--max-old-space-size=4096' tsc -b tsconfig.json --force --emitDeclarationOnly",
+    "build": "cross-env NODE_OPTIONS='--max-old-space-size=4096' tsup && node ../../scripts/clean-tsbuildinfo.mjs && cross-env NODE_OPTIONS='--max-old-space-size=4096' tsc -b tsconfig.json --emitDeclarationOnly",
     "dev": "tsup --watch",
     "typecheck": "tsc -p tsconfig.typecheck.json --noEmit",
     "lint": "eslint . --ext .ts"