@dexto/core 1.5.8 → 1.6.1

package/dist/tools/types.d.ts

@@ -1,17 +1,84 @@
 import type { JSONSchema7 } from 'json-schema';
-import type { ZodSchema } from 'zod';
+import type { z, ZodTypeAny } from 'zod';
 import type { ToolDisplayData } from './display-types.js';
+import type { WorkspaceContext } from '../workspace/types.js';
 import type { ApprovalRequestDetails, ApprovalResponse } from '../approval/types.js';
+import type { ApprovalManager } from '../approval/manager.js';
+import type { DextoAgent } from '../agent/DextoAgent.js';
+import type { Cache } from '../storage/cache/types.js';
+import type { BlobStore } from '../storage/blob/types.js';
+import type { Database } from '../storage/database/types.js';
+import type { MCPManager } from '../mcp/manager.js';
+import type { PromptManager } from '../prompts/prompt-manager.js';
+import type { ResourceManager } from '../resources/manager.js';
+import type { SearchService } from '../search/search-service.js';
+import type { Logger } from '../logger/v2/types.js';
+/**
+ * Interface for forking execution to an isolated sub-agent context.
+ *
+ * Implemented by AgentSpawnerRuntime in `@dexto/agent-management` and surfaced to tools
+ * via {@link ToolExecutionContext.services}.
+ */
+export interface TaskForker {
+    fork(options: {
+        task: string;
+        instructions: string;
+        agentId?: string;
+        autoApprove?: boolean;
+        toolCallId?: string;
+        sessionId?: string;
+    }): Promise<{
+        success: boolean;
+        response?: string;
+        error?: string;
+    }>;
+}
+export type TaskForkOptions = Parameters<TaskForker['fork']>[0];
+export interface ToolServices {
+    approval: ApprovalManager;
+    search: SearchService;
+    resources: ResourceManager;
+    prompts: PromptManager;
+    mcp: MCPManager;
+    taskForker: TaskForker | null;
+}
 /**
  * Context passed to tool execution
  */
-export interface ToolExecutionContext {
+export interface ToolExecutionContextBase {
     /** Session ID if available */
     sessionId?: string | undefined;
+    /** Workspace ID if available */
+    workspaceId?: string | undefined;
+    /** Workspace context if available */
+    workspace?: WorkspaceContext | undefined;
     /** Abort signal for cancellation support */
     abortSignal?: AbortSignal | undefined;
     /** Unique tool call ID for tracking parallel tool calls */
     toolCallId?: string | undefined;
+    /**
+     * Logger scoped to the tool execution.
+     */
+    logger: Logger;
+}
+export interface ToolExecutionContext extends ToolExecutionContextBase {
+    /**
+     * Runtime agent reference (DI refactor: provided by ToolManager on each execute()).
+     */
+    agent?: DextoAgent | undefined;
+    /**
+     * Concrete storage backends (DI-first).
+     */
+    storage?: {
+        blob: BlobStore;
+        database: Database;
+        cache: Cache;
+    } | undefined;
+    /**
+     * Runtime services available to tools. These are injected at execution time (not factory time)
+     * to avoid init ordering cycles.
+     */
+    services?: ToolServices | undefined;
 }
 /**
  * Result of tool execution, including approval metadata
@@ -19,71 +86,181 @@ export interface ToolExecutionContext {
 export interface ToolExecutionResult {
     /** The actual result data from tool execution */
     result: unknown;
+    /** 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';
 }
 /**
- * Internal tool interface - for tools implemented within Dexto
+ * 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 interface InternalTool {
+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;
     /** Human-readable description of what the tool does */
     description: string;
     /** Zod schema defining the input parameters */
-    inputSchema: ZodSchema;
+    inputSchema: TSchema;
     /** The actual function that executes the tool - input is validated by Zod before execution */
-    execute: (input: unknown, context?: ToolExecutionContext) => Promise<unknown> | unknown;
+    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.
+     */
+    approval?: ToolApproval<TSchema> | undefined;
+    /**
+     * Optional grouped UI/presentation-related behavior.
+     */
+    presentation?: ToolPresentation<TSchema> | undefined;
+    /**
+     * Optional aliases for this tool id.
+     *
+     * Used to support external prompt/skill ecosystems that refer to tools by short names
+     * (e.g. Claude Code "bash", "read", "grep" in allowed-tools). Aliases are resolved
+     * 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 rich preview used in approval prompts.
+     *
+     * 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
+     */
+    preview?(input: z.output<TSchema>, context: ToolExecutionContext): Promise<ToolDisplayData | null> | ToolDisplayData | null;
+    /**
+     * Describe the one-line tool call header for timelines and approval prompts.
+     *
+     * CLI example:
+     * - Tool message header line: `Read(src/app.ts)`
+     * - Here: header.title = "Read", header.argsText = "src/app.ts"
      */
-    generatePreview?: (input: unknown, context?: ToolExecutionContext) => Promise<ToolDisplayData | null>;
+    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 args 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 (args) => {
-     *   const filePath = (args 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?: (args: unknown) => 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) => 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
@@ -94,6 +271,7 @@ export interface ToolSet {
         name?: string;
         description?: string;
         parameters: JSONSchema7;
+        _meta?: Record<string, unknown>;
     };
 }
 /**
@@ -101,7 +279,7 @@ export interface ToolSet {
  */
 export interface ToolResult {
     success: boolean;
-    data?: any;
+    data?: unknown;
     error?: string;
 }
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,4CAA4C;IAC5C,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,iDAAiD;IACjD,MAAM,EAAE,OAAO,CAAC;IAChB,gEAAgE;IAChE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oEAAoE;IACpE,cAAc,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;CAC5C;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IAEX,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IAEpB,+CAA+C;IAC/C,WAAW,EAAE,SAAS,CAAC;IAEvB,8FAA8F;IAC9F,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAExF;;;;OAIG;IACH,eAAe,CAAC,EAAE,CACd,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,oBAAoB,KAC7B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAErC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,mBAAmB,CAAC,EAAE,CAClB,IAAI,EAAE,OAAO,KACZ,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,GAAG,sBAAsB,GAAG,IAAI,CAAC;IAE5E;;;;;;;;;;;;;;;OAeG;IACH,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;CAC5D;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,WAAW,CAAC;KAC3B,CAAC;CACL;AAMD;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/E"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"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"}

package/dist/utils/error-conversion.d.ts

@@ -2,12 +2,12 @@
  * Utility functions for converting various error types to proper Error instances
  * with meaningful messages instead of "[object Object]"
  */
-import type { IDextoLogger } from '../logger/v2/types.js';
+import type { Logger } from '../logger/v2/types.js';
 /**
  * Converts any error value to an Error instance with a meaningful message
  *
  * @param error - The error value to convert (can be Error, object, string, etc.)
  * @returns Error instance with extracted or serialized message
  */
-export declare function toError(error: unknown, logger: IDextoLogger): Error;
+export declare function toError(error: unknown, logger: Logger): Error;
 //# sourceMappingURL=error-conversion.d.ts.map

package/dist/utils/error-conversion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-conversion.d.ts","sourceRoot":"","sources":["../../src/utils/error-conversion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,KAAK,CAkEnE"}
+{"version":3,"file":"error-conversion.d.ts","sourceRoot":"","sources":["../../src/utils/error-conversion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAkE7D"}

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

@@ -1,4 +1,4 @@
-import type { IDextoLogger } from '../logger/v2/types.js';
+import type { Logger } from '../logger/v2/types.js';
 /**
  * Standard path resolver for logs/db/config/anything in dexto projects
  * Context-aware with dev mode support:
@@ -13,8 +13,11 @@ import type { IDextoLogger } 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/...)
@@ -50,5 +53,5 @@ export declare function ensureDextoGlobalDirectory(): Promise<void>;
  * @param logger Optional logger instance for logging
  * @returns Absolute path to .env file for saving
  */
-export declare function getDextoEnvPath(startPath?: string, logger?: IDextoLogger): string;
+export declare function getDextoEnvPath(startPath?: string, logger?: Logger): string;
 //# sourceMappingURL=path.d.ts.map

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,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;;;;;;;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,YAAY,GAAG,MAAM,CAkChG"}
+{"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/dist/utils/result.cjs

@@ -31,7 +31,7 @@ __export(result_exports, {
 });
 module.exports = __toCommonJS(result_exports);
 var import_zod = require("zod");
-var import_types = require("../errors/types.cjs");
+var import_types = require("../errors/types.js");
 const NonEmptyTrimmed = import_zod.z.string().transform((s) => s.trim()).refine((s) => s.length > 0, { message: "Required" });
 function isValidUrl(s) {
   try {

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

@@ -1 +1 @@
-{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/utils/result.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,KAAK,EAAkB,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAGnE,4CAA4C;AAC5C,eAAO,MAAM,eAAe,yEAG6B,CAAC;AAa1D,eAAO,MAAM,WAAW,kIAKT,CAAC;AAGhB,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,8CAUpE,CAAC;AAGP,eAAO,MAAM,yBAAyB,GAAI,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,4EAG5E,CAAC;AAGP,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,4EAWlE,CAAC;AAEN;;;;;GAKG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,IAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;CAAE,GACzC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;CAAE,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,EAAE,GAAI,CAAC,EAAE,CAAC,GAAG,OAAO,EAAE,MAAM,CAAC,EAAE,SAAQ,KAAK,CAAC,CAAC,CAAC,EAAO,KAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAI/E,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,OAAO,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,KAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAG3E,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,WAE9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE;;;EAKhD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,OAAO,EACnC,GAAG,EAAE,QAAQ,EACb,QAAQ,GAAE,OAAO,GAAG,SAAmB,GACxC,KAAK,CAAC,CAAC,CAAC,EAAE,CA8CZ"}
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/utils/result.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,KAAK,QAAQ,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,KAAK,EAAkB,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAGhE,4CAA4C;AAC5C,eAAO,MAAM,eAAe,yEAG6B,CAAC;AAa1D,eAAO,MAAM,WAAW,kIAKT,CAAC;AAGhB,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,8CAUpE,CAAC;AAGP,eAAO,MAAM,yBAAyB,GAAI,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,4EAG5E,CAAC;AAGP,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,4EAWlE,CAAC;AAEN;;;;;GAKG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,IAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;CAAE,GACzC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;CAAE,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,EAAE,GAAI,CAAC,EAAE,CAAC,GAAG,OAAO,EAAE,MAAM,CAAC,EAAE,SAAQ,KAAK,CAAC,CAAC,CAAC,EAAO,KAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAI/E,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,OAAO,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,KAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAG3E,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,WAE9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE;;;EAKhD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,OAAO,EACnC,GAAG,EAAE,QAAQ,EACb,QAAQ,GAAE,OAAO,GAAG,SAAmB,GACxC,KAAK,CAAC,CAAC,CAAC,EAAE,CA8CZ"}

package/dist/utils/schema.cjs

@@ -24,16 +24,20 @@ module.exports = __toCommonJS(schema_exports);
 var import_zod_to_json_schema = require("zod-to-json-schema");
 function convertZodSchemaToJsonSchema(zodSchema, logger) {
   try {
-    return (0, import_zod_to_json_schema.zodToJsonSchema)(zodSchema);
+    const converted = (0, import_zod_to_json_schema.zodToJsonSchema)(zodSchema);
+    if (converted && typeof converted === "object") {
+      return converted;
+    }
+    logger.warn("Failed to convert Zod schema to JSON Schema: conversion returned non-object");
   } catch (error) {
     logger.warn(
       `Failed to convert Zod schema to JSON Schema: ${error instanceof Error ? error.message : String(error)}`
     );
-    return {
-      type: "object",
-      properties: {}
-    };
   }
+  return {
+    type: "object",
+    properties: {}
+  };
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/utils/schema.d.ts

@@ -1,4 +1,6 @@
-import type { IDextoLogger } from '../logger/v2/types.js';
+import type { JSONSchema7 } from 'json-schema';
+import type { ZodSchema } from 'zod';
+import type { Logger } from '../logger/v2/types.js';
 /**
  * Convert Zod schema to JSON Schema format for tool parameters
  *
@@ -8,5 +10,5 @@ import type { IDextoLogger } from '../logger/v2/types.js';
  * Zod v4 has native toJsonSchema() support - migrate when upgrading to Zod v4.
  * See: https://github.com/StefanTerdell/zod-to-json-schema
  */
-export declare function convertZodSchemaToJsonSchema(zodSchema: any, logger: IDextoLogger): any;
+export declare function convertZodSchemaToJsonSchema(zodSchema: ZodSchema, logger: Logger): JSONSchema7;
 //# sourceMappingURL=schema.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/utils/schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,GAAG,GAAG,CActF"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/utils/schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAoB9F"}

package/dist/utils/schema.js

@@ -2,16 +2,20 @@ import "../chunk-PTJYTZNU.js";
 import { zodToJsonSchema } from "zod-to-json-schema";
 function convertZodSchemaToJsonSchema(zodSchema, logger) {
   try {
-    return zodToJsonSchema(zodSchema);
+    const converted = zodToJsonSchema(zodSchema);
+    if (converted && typeof converted === "object") {
+      return converted;
+    }
+    logger.warn("Failed to convert Zod schema to JSON Schema: conversion returned non-object");
   } catch (error) {
     logger.warn(
       `Failed to convert Zod schema to JSON Schema: ${error instanceof Error ? error.message : String(error)}`
     );
-    return {
-      type: "object",
-      properties: {}
-    };
   }
+  return {
+    type: "object",
+    properties: {}
+  };
 }
 export {
   convertZodSchemaToJsonSchema